@sapui5/ts-types 1.120.8 → 1.121.0

package/types/sap.ushell.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.8
+// For Library Version: 1.121.0
 
 declare namespace sap {
   /**
@@ -52,7 +52,7 @@ declare namespace sap {
      * @since 1.15.0
      * @deprecated (since 1.120)
      *
-     * @returns a promise that is resolved once the container is available
+     * @returns Resolves once the container is available.
      */
     function bootstrap(
       /**
@@ -66,19 +66,13 @@ declare namespace sap {
       mAdapterPackagesByPlatform?: Record<string, string>
     ): jQuery.Promise;
     /**
+     * Default namespace for Unified Shell services.
      * See:
-     * 	sap.ushell.Container.getServiceAsync()
+     * 	sap.ushell.Container.getServiceAsync
      *
      * @since 1.15.0
      */
     namespace services {
-      /**
-       * @since 1.62.0
-       * @deprecated
-       * @ui5-protected DO NOT USE IN APPLICATIONS (only for related classes in the framework)
-       */
-      export const ContentExtensionAdapterFactory: undefined;
-
       namespace Bookmark {
         /**
          * A content node may be: - a classic home page group - an unselectable node (space) or a selectable node
@@ -110,8 +104,7 @@ declare namespace sap {
 
       namespace BookmarkV2 {
         /**
-         * A content node may be: - a classic home page group - an unselectable node (space) or a selectable node
-         * (page) in spaces mode - or any other containers in the future
+         * A tree of content nodes.
          */
         type ContentNode = {
           /**
@@ -123,7 +116,7 @@ declare namespace sap {
            */
           label: string;
           /**
-           * Specifies the content node type. E.g: space, page, group, etc. See {@link sap.ushell.sap.ushell.services.BookmarkV2.ContentNodeType}
+           * Specifies the content node type. E.g: space, page, etc. See {@link sap.ushell.sap.ushell.services.BookmarkV2.ContentNodeType}
            */
           type: sap.ushell.ContentNodeType;
           /**
@@ -146,7 +139,10 @@ declare namespace sap {
          * @experimental (since 1.120.0)
          */
         class Footer {
-          constructor();
+          /**
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
+           */
+          protected constructor();
 
           /**
            * Destroys the footer.
@@ -164,7 +160,10 @@ declare namespace sap {
          * @experimental (since 1.120.0)
          */
         class Item {
-          constructor();
+          /**
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
+           */
+          protected constructor();
 
           /**
            * Destroys the item and it's related content.
@@ -179,51 +178,51 @@ declare namespace sap {
            *
            * @since 1.120.0
            *
-           * @returns this to allow method chaining.
+           * @returns Reference to `this` for method chaining.
            */
-          hideForAllApps(): sap.ushell.services.Extension.Item;
+          hideForAllApps(): this;
           /**
            * Hides the item for the current application. Note: The item will not be hidden if it was set visible for
            * all apps {@link #showForAllApps}
            *
            * @since 1.120.0
            *
-           * @returns this to allow method chaining.
+           * @returns Reference to `this` for method chaining.
            */
-          hideForCurrentApp(): sap.ushell.services.Extension.Item;
+          hideForCurrentApp(): this;
           /**
            * Hides the item for launchpad "home". Does not change the visibility of the item within applications.
            *
            * @since 1.120.0
            *
-           * @returns this to allow method chaining.
+           * @returns Reference to `this` for method chaining.
            */
-          hideOnHome(): sap.ushell.services.Extension.Item;
+          hideOnHome(): this;
           /**
            * Shows the item for all applications. Does not change the visibility of the item for the launchpad "home".
            *
            * @since 1.120.0
            *
-           * @returns this to allow method chaining.
+           * @returns Reference to `this` for method chaining.
            */
-          showForAllApps(): sap.ushell.services.Extension.Item;
+          showForAllApps(): this;
           /**
            * Shows the item for the current application. The item will be hidden after the user navigates away from
            * this application. The item will not be added again if the user navigates back to the application.
            *
            * @since 1.120.0
            *
-           * @returns this to allow method chaining.
+           * @returns Reference to `this` for method chaining.
            */
-          showForCurrentApp(): sap.ushell.services.Extension.Item;
+          showForCurrentApp(): this;
           /**
            * Shows the item for launchpad "home". Does not change the visibility of the item within applications.
            *
            * @since 1.120.0
            *
-           * @returns this to allow method chaining.
+           * @returns Reference to `this` for method chaining.
            */
-          showOnHome(): sap.ushell.services.Extension.Item;
+          showOnHome(): this;
         }
         /**
          * The side pane extension point is positioned next the launchpad content. To be instantiated by {@link sap.ushell.services.Extension}.
@@ -233,7 +232,10 @@ declare namespace sap {
          * @experimental (since 1.120.0)
          */
         class SidePane {
-          constructor();
+          /**
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
+           */
+          protected constructor();
 
           /**
            * Creates an item in the side pane.
@@ -263,34 +265,34 @@ declare namespace sap {
            *
            * @since 1.120.0
            *
-           * @returns this to allow method chaining.
+           * @returns Reference to `this` for method chaining.
            */
-          hideForAllApps(): sap.ushell.services.Extension.SidePane;
+          hideForAllApps(): this;
           /**
            * Hides the area for launchpad "home". Does not change the visibility of the area within applications.
            *
            * @since 1.120.0
            *
-           * @returns this to allow method chaining.
+           * @returns Reference to `this` for method chaining.
            */
-          hideOnHome(): sap.ushell.services.Extension.SidePane;
+          hideOnHome(): this;
           /**
            * Shows the side pane for all applications. Does not change the visibility of the side pane for the launchpad
            * "home".
            *
            * @since 1.120.0
            *
-           * @returns this to allow method chaining.
+           * @returns Reference to `this` for method chaining.
            */
-          showForAllApps(): sap.ushell.services.Extension.SidePane;
+          showForAllApps(): this;
           /**
            * Shows the side pane for launchpad "home". Does not change the visibility of the side pane within applications.
            *
            * @since 1.120.0
            *
-           * @returns this to allow method chaining.
+           * @returns Reference to `this` for method chaining.
            */
-          showOnHome(): sap.ushell.services.Extension.SidePane;
+          showOnHome(): this;
         }
         /**
          * The tool area extension point is positioned next the launchpad content. To be instantiated by {@link sap.ushell.services.Extension}.
@@ -300,7 +302,10 @@ declare namespace sap {
          * @experimental (since 1.120.0)
          */
         class ToolArea {
-          constructor();
+          /**
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
+           */
+          protected constructor();
 
           /**
            * Creates an item in the tool area.
@@ -321,34 +326,34 @@ declare namespace sap {
            *
            * @since 1.120.0
            *
-           * @returns this to allow method chaining.
+           * @returns Reference to `this` for method chaining.
            */
-          hideForAllApps(): sap.ushell.services.Extension.ToolArea;
+          hideForAllApps(): this;
           /**
            * Hides the tool area for launchpad "home". Does not change the visibility of the tool area within applications.
            *
            * @since 1.120.0
            *
-           * @returns this to allow method chaining.
+           * @returns Reference to `this` for method chaining.
            */
-          hideOnHome(): sap.ushell.services.Extension.ToolArea;
+          hideOnHome(): this;
           /**
            * Shows the tool area for all applications. Does not change the visibility of the tool area for the launchpad
            * "home".
            *
            * @since 1.120.0
            *
-           * @returns this to allow method chaining.
+           * @returns Reference to `this` for method chaining.
            */
-          showForAllApps(): sap.ushell.services.Extension.ToolArea;
+          showForAllApps(): this;
           /**
            * Shows the tool area for launchpad "home". Does not change the visibility of the tool area within applications.
            *
            * @since 1.120.0
            *
-           * @returns this to allow method chaining.
+           * @returns Reference to `this` for method chaining.
            */
-          showOnHome(): sap.ushell.services.Extension.ToolArea;
+          showOnHome(): this;
         }
       }
 
@@ -537,15 +542,17 @@ declare namespace sap {
         /**
          * The container is the anchor object of the unified shell personalization in container mode.
          *
+         * To be called by the personalization service getContainer method.
+         *
          * @since 1.22.0
          * @deprecated (since 1.120) - Please use {@link sap.ushell.services.PersonalizationV2.ContextContainer }
          * instead
          */
         class ContextContainer {
           /**
-           * To be called by the personalization service getContainer method.
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            */
-          constructor();
+          protected constructor();
 
           /**
            * Returns an array with all internal keys of direct items in the container.
@@ -555,7 +562,7 @@ declare namespace sap {
            *
            * @returns item keys
            */
-          _getInternalKeys(): any[];
+          _getInternalKeys(): string[];
           /**
            * clears the local copy data of this container
            *
@@ -591,9 +598,9 @@ declare namespace sap {
            *
            * @since 1.22.0
            *
-           * @returns promise
+           * @returns Resolves once the requests were flushed.
            */
-          flush(): object;
+          flush(): jQuery.Promise;
           /**
            * Returns an array with the keys of direct items in the container.
            *
@@ -601,7 +608,7 @@ declare namespace sap {
            *
            * @returns item keys
            */
-          getItemKeys(): any[];
+          getItemKeys(): string[];
           /**
            * Returns the value for a direct item from the container. (Value semantics, new copy is returned)
            *
@@ -651,9 +658,9 @@ declare namespace sap {
            *
            * @since 1.22.0
            *
-           * @returns Promise object
+           * @returns Resolves once the context container is loaded.
            */
-          load(): object;
+          load(): jQuery.Promise;
           /**
            * Attempts to save the current container data at the underlying storage asynchronously. The current state
            * is serialized.
@@ -662,22 +669,22 @@ declare namespace sap {
            * @deprecated (since 1.120.0) - Use {@link sap.ushell.services.Personalization.ContextContainer#saveDeferred }
            * instead
            *
-           * @returns Promise object
+           * @returns Resolves once the container is saved.
            *
            * If another save/load/delete operation is not completed, the operation may fail! (wait for the other promise).
            */
-          save(): object;
+          save(): jQuery.Promise;
           /**
            * Save the current container data at the underlying storage asynchronously at the earlies nDelayInMilliseconds
            * seconds before. The current state is serialized.
            *
            * @since 1.22.0
            *
-           * @returns Promise object
+           * @returns Resolves once the container is saved.
            *
            * The operation may wait for completion of another pending operation.
            */
-          saveDeferred(): object;
+          saveDeferred(): jQuery.Promise;
           /**
            * 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
@@ -700,27 +707,31 @@ declare namespace sap {
          * The personalization container is the anchor object of the unified shell personalization in container
          * mode.
          *
+         * To be called by the personalization service getPersonalizationContainer method.
+         *
          * @since 1.18.0
          * @deprecated (since 1.120) - Please use {@link sap.ushell.services.Personalization#getContainer} instead
          */
         class PersonalizationContainer {
           /**
-           * To be called by the personalization service getPersonalizationContainer method.
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            */
-          constructor();
+          protected constructor();
         }
         /**
          * The personalization variant contains personalization data. It is used in the personalization container
          * mode.
          *
+         * To be called by the personalization variant set.
+         *
          * @since 1.18.0
          * @deprecated (since 1.120) - Please use {@link sap.ushell.services.Personalization#getContainer} instead
          */
         class PersonalizationContainerVariant {
           /**
-           * To be called by the personalization variant set.
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            */
-          constructor();
+          protected constructor();
 
           /**
            * Checks if a specific item is contained in this variant.
@@ -753,7 +764,7 @@ declare namespace sap {
            *
            * @returns item keys
            */
-          getItemKeys(): any[];
+          getItemKeys(): string[];
           /**
            * Returns the value for an item in this variant.
            *
@@ -804,20 +815,16 @@ declare namespace sap {
          * The personalization variant set contains variants of personalization data. It is used in the personalization
          * container mode.
          *
+         * To be called by the personalization container.
+         *
          * @since 1.18.0
          * @deprecated (since 1.120) - Please use {@link sap.ushell.services.Personalization#getContainer} instead
          */
         class PersonalizationContainerVariantSet {
           /**
-           * To be called by the personalization container.
-           */
-          constructor();
-          /**
-           * Deletes a variant from the variant set. In case the variant does not exist nothing happens.
-           *
-           * @since 1.18.0
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            */
-          delVariant: undefined;
+          protected constructor();
 
           /**
            * Checks if a specific variant is contained in the variant set.
@@ -832,6 +839,17 @@ declare namespace sap {
              */
             sVariantKey: string
           ): boolean;
+          /**
+           * Deletes a variant from the variant set. In case the variant does not exist nothing happens.
+           *
+           * @since 1.18.0
+           */
+          delVariant(
+            /**
+             * variant key
+             */
+            sVariantKey: string
+          ): void;
           /**
            * Returns the current variant key.
            *
@@ -845,7 +863,7 @@ declare namespace sap {
            *
            * @since 1.18.0
            *
-           * @returns {@link sap.ushell.services.Personalization.PersonalizationContainerVariant}. In case the variant
+           * @returns {@link sap.ushell.services.Personalization.PersonalizationContainerVariant} In case the variant
            * set does not contain a variant with this key `undefined` is returned.
            */
           getVariant(
@@ -875,7 +893,7 @@ declare namespace sap {
            *
            * @returns variant keys
            */
-          getVariantKeys(): any[];
+          getVariantKeys(): string[];
           /**
            * Sets the current variant key.
            *
@@ -892,14 +910,47 @@ declare namespace sap {
          * The Unified Shell personalizer providing set get delete methods to access the persisted personalization
          * data in direct mode.
          *
+         * To be called by the personalization service getPersonalizer method.
+         *
          * @since 1.15.0
          * @deprecated (since 1.120) - Please use {@link sap.ushell.services.PersonalizationV2.Personalizer} instead
          */
         class Personalizer {
           /**
-           * To be called by the personalization service getPersonalizer method.
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            */
-          constructor();
+          protected constructor();
+
+          /**
+           * Deletes a personalization data value.
+           *
+           * @since 1.15.0
+           *
+           * @returns Resolves once the pers data was deleted or rejects with an error message.
+           */
+          delPersData(): jQuery.Promise;
+          /**
+           * Gets a personalization data value.
+           *
+           * @since 1.15.0
+           *
+           * @returns Resolves the personalization value. If there is no personalization data for the item, undefined
+           * is returned. Promise object fail function: param {string} sMessage Error message.
+           */
+          getPersData(): jQuery.Promise;
+          /**
+           * Sets a personalization data value.
+           *
+           * @since 1.15.0
+           *
+           * @returns Resolves once the pers data was stored or rejects with an error message.
+           */
+          setPersData(
+            /**
+             * JSON object containing the personalization value.
+             */
+            oValue: object
+          ): jQuery.Promise;
         }
         /**
          * The transient personalizer shall be used in container mode for table personalization. To be called by
@@ -916,14 +967,16 @@ declare namespace sap {
          * The personalization variant contains personalization data. It is used in the personalization container
          * mode.
          *
+         * To be instantiated via Personalization.VariantSet add / get Variant only
+         *
          * @since 1.22.0
          * @deprecated (since 1.120) - Please use {@link sap.ushell.services.PersonalizationV2.Variant} instead
          */
         class Variant {
           /**
-           * To be instantiated via Personalization.VariantSet add / get Variant only
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            */
-          constructor();
+          protected constructor();
 
           /**
            * Checks if a specific item is contained in this variant.
@@ -956,7 +1009,7 @@ declare namespace sap {
            *
            * @returns item keys
            */
-          getItemKeys(): any[];
+          getItemKeys(): string[];
           /**
            * Returns the value for an item in this variant.
            *
@@ -1019,21 +1072,21 @@ declare namespace sap {
         }
         /**
          * The personalization variant set contains variants of personalization data. It is used in the personalization
-         * container mode.
+         * container mode. A VariantSet is a class representing a collection of Variants (identified by a key and
+         * name) and a member variable indicating the "current variable"
+         *
+         * When manipulating the underlying data, additional constraints are enforced.
+         *
+         * To be called by the personalization container.
          *
          * @since 1.22.0
          * @deprecated (since 1.120) - Please use {@link sap.ushell.services.PersonalizationV2.VariantSet} instead
          */
         class VariantSet {
           /**
-           * A VariantSet is a class representing a collection of Variants (identified by a key and name) and a member
-           * variable indicating the "current variable"
-           *
-           * When manipulating the underlying data, additional constraints are enforced.
-           *
-           * To be called by the personalization container.
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            */
-          constructor();
+          protected constructor();
 
           /**
            * Creates a new variant in the variant set. In case a variant with this name is already existing an exception
@@ -1116,7 +1169,7 @@ declare namespace sap {
            *
            * @returns variant keys
            */
-          getVariantKeys(): any[];
+          getVariantKeys(): string[];
           /**
            * Sets the current variant key.
            *
@@ -1220,7 +1273,7 @@ declare namespace sap {
            *
            * @returns variant set keys
            */
-          getVariantSetKeys(): any[];
+          getVariantSetKeys(): string[];
         }
       }
 
@@ -1228,13 +1281,15 @@ declare namespace sap {
         /**
          * The container is the anchor object of the unified shell personalization in container mode.
          *
+         * To be called by the personalization service getContainer method.
+         *
          * @since 1.120.0
          */
         class ContextContainer {
           /**
-           * To be called by the personalization service getContainer method.
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            */
-          constructor();
+          protected constructor();
 
           /**
            * clears the local copy data of this container
@@ -1271,7 +1326,7 @@ declare namespace sap {
            *
            * @since 1.120.0
            *
-           * @returns promise
+           * @returns Resolves once the pending requests were flushed.
            */
           flushPendingRequests(): Promise<any>;
           /**
@@ -1319,8 +1374,8 @@ declare namespace sap {
            */
           load(): Promise<undefined>;
           /**
-           * * todo: jsdoc Save the current container data at the underlying storage asynchronously at the earlies
-           * nDelayInMilliseconds seconds before. The current state is serialized.
+           * Save the current container data at the underlying storage asynchronously at the earlies nDelayInMilliseconds
+           * seconds before. The current state is serialized.
            *
            * @since 1.120.0
            *
@@ -1351,13 +1406,15 @@ declare namespace sap {
          * The Unified Shell personalizer providing set get delete methods to access the persisted personalization
          * data in direct mode.
          *
+         * To be called by the personalization service getPersonalizer method.
+         *
          * @since 1.120.0
          */
         class Personalizer {
           /**
-           * To be called by the personalization service getPersonalizer method.
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            */
-          constructor();
+          protected constructor();
 
           /**
            * Deletes a personalization data value.
@@ -1396,7 +1453,10 @@ declare namespace sap {
          * @since 1.120.0
          */
         class TransientPersonalizer {
-          constructor();
+          /**
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
+           */
+          protected constructor();
 
           /**
            * Deletes a personalization data value.
@@ -1432,13 +1492,15 @@ declare namespace sap {
          * The personalization variant contains personalization data. It is used in the personalization container
          * mode.
          *
+         * To be instantiated via Personalization.VariantSet add / get Variant only
+         *
          * @since 1.120.0
          */
         class Variant {
           /**
-           * To be instantiated via PersonalizationV2.VariantSet add / get Variant only
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            */
-          constructor();
+          protected constructor();
 
           /**
            * Checks if a specific item is contained in this variant.
@@ -1533,20 +1595,19 @@ declare namespace sap {
           ): void;
         }
         /**
+         * A VariantSet is a class representing a collection of Variants (identified by a key and name) and a member
+         * variable indicating the "current variable"
+         *
+         * When manipulating the underlying data, additional constraints are enforced.
+         *
          * The personalization variant set contains variants of personalization data. It is used in the personalization
          * container mode.
          *
+         * To be called by the personalization container
+         *
          * @since 1.120.0
          */
         class VariantSet {
-          /**
-           * A VariantSet is a class representing a collection of Variants (identified by a key and name) and a member
-           * variable indicating the "current variable"
-           *
-           * When manipulating the underlying data, additional constraints are enforced.
-           *
-           * To be called by the personalization container.
-           */
           constructor();
 
           /**
@@ -1651,18 +1712,17 @@ declare namespace sap {
          * ```
          *
          *
+         * VariantSetAdapter amends ContextContainer with functionality to
+         *
+         * Example: An application has two types of variants. Variant type 1 contains filter values for a query,
+         * which are stored in item 1 of the variant, and personalization data for a table, which are stored in
+         * item 2 of the variant. Variant type 2 contains a setting (item 3) that is independent of the filtering
+         * and the table settings. It might be used for a different screen than the variants of type 1. In this
+         * example you would have 2 variant sets, one for each variant type.
+         *
          * @since 1.120.0
          */
         class VariantSetAdapter {
-          /**
-           * VariantSetAdapter amends ContextContainer with functionality to
-           *
-           * Example: An application has two types of variants. Variant type 1 contains filter values for a query,
-           * which are stored in item 1 of the variant, and personalization data for a table, which are stored in
-           * item 2 of the variant. Variant type 2 contains a setting (item 3) that is independent of the filtering
-           * and the table settings. It might be used for a different screen than the variants of type 1. In this
-           * example you would have 2 variant sets, one for each variant type.
-           */
           constructor(
             /**
              * Context
@@ -1774,18 +1834,12 @@ declare namespace sap {
           shared?: boolean;
         };
       }
-
       /**
-       * The unified shell's AppConfiguration service.
+       * The unified shell's AppConfiguration service as a singleton object.
        *
        * @since 1.15.0
        */
-      class AppConfiguration {
-        /**
-         * The Unified Shell App configuration service as a singleton object.
-         */
-        constructor();
-
+      interface AppConfiguration {
         /**
          * Sets the application screen size to full width
          *
@@ -1799,16 +1853,74 @@ declare namespace sap {
           bValue: boolean
         ): void;
       }
+
+      /**
+       * @since 1.62.0
+       * @deprecated
+       * @ui5-protected DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+       */
+      interface ContentExtensionAdapterFactory {
+        /**
+         * Constructs a new instance of the Content Extension Adapter Factory. An array of adapter configurations
+         * needs to be passed to it (one specific adapter for each extended content). The configuration can be passed
+         * explicitly as an array vConfig or coded in ContentExtensionAdapterConfig.
+         *
+         * Once instantiated, it generates a map of all the needed adapters and returns them (as a promise) with
+         * the method #getAdapterMap. Once the Promises resolve, the adapters are available in the map.
+         *
+         * IMPORTANT: aConfig.contentProviderName is the string any content would use to indicate the LaunchPage
+         * service which adapter needs to be used through a field "contentProvider" e.g. oGroup.contentProvider
+         *
+         * Currently, the configuration mocks the content through FeatureGroupConfig and uses the local adapter.
+         * This should be changed once a dedicated adapter for the extended content exists.
+         *
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         *
+         * @returns A promise that resolves to a map of content provider names to adapter instances Note that the
+         * map might contain undefined entries if the adapters are disabled.
+         */
+        getAdapters(
+          /**
+           * A configuration array for the different adapters of ContentExtensionAdapterFactory.
+           */
+          vConfigs: Array<{
+            /**
+             * The name of the adapter to find it in the service
+             */
+            contentProviderName: string;
+            /**
+             * The path to the adapter
+             */
+            adapter: string;
+            /**
+             * The path to the configuration flag for this adapter
+             */
+            config: string;
+            /**
+             * A system object for creating the system when instantiating the adapter
+             */
+            system: object;
+            /**
+             * A function that returns any needed configuration for the adapter
+             */
+            configHandler: Function;
+          }>
+        ): Promise<object>;
+      }
+
       /**
        * The Unified Shell's AppLifeCycle service.
        *
        * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("AppLifeCycle")`.
-       * For details, see {@link sap.ushell.services.Container#getServiceAsync}.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
        *
        * @since 1.38
        */
-      class AppLifeCycle {
-        constructor();
+      class AppLifeCycle extends sap.ushell.services.Service {
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
 
         /**
          * Attaches an event handler for the appLoaded event. This event handler will be triggered each time an
@@ -1850,9 +1962,6 @@ declare namespace sap {
          *
          * The function returns an object with following parameters:
          * 	 -  applicationType: “UI5|WDA|NWBC|URL|TR”
-         * 	 -  applicationFramework: when applicationType is "URL", this parameter indicates which application
-         *     framework is running inside the iframe - “UI5|WDA|GUI|CRM”. This attribute is for SAP internal usage
-         *     only.
          * 	 -  componentInstance: reference to component (only for applicationType "UI5").
          * 	 -  homePage: `true` when root intent (normally #Shell-home) or Appfinder (#Shell-appfinder) is currently
          *     displayed.
@@ -1891,13 +2000,16 @@ declare namespace sap {
        * The Unified Shell's bookmark service. Allows creating shortcuts on the user's home page.
        *
        * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("Bookmark")`.
-       * For details, see {@link sap.ushell.services.Container#getServiceAsync}.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
        *
        * @since 1.15.0
        * @deprecated (since 1.119) - Please use {@link sap.ushell.services.BookmarkV2} instead.
        */
-      class Bookmark {
-        constructor();
+      class Bookmark extends sap.ushell.services.Service {
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
 
         /**
          * Adds a bookmark tile to one of the user's classic home page groups or to multiple provided content nodes.
@@ -1907,8 +2019,8 @@ declare namespace sap {
          * @since 1.15.0
          * @deprecated (since 1.119) - Please use {@link sap.ushell.services.BookmarkV2#addBookmark} instead.
          *
-         * @returns A `jQuery.Promise` which resolves on success, but rejects with a reason-message on failure to
-         * add the bookmark to the specified or implied group. The promise gets resolved if personalization is disabled.
+         * @returns Resolves on success, but rejects with a reason-message on failure to add the bookmark to the
+         * specified or implied group. The promise gets resolved if personalization is disabled.
          */
         addBookmark(
           /**
@@ -2020,9 +2132,8 @@ declare namespace sap {
          * @since 1.21.2
          * @deprecated (since 1.112) - Please use {@link sap.ushell.services.BookmarkV2#addBookmark} instead.
          *
-         * @returns A `jQuery.Promise` which informs about success or failure of this asynchronous operation. In
-         * case of success, no further details are passed. In case of failure, an error message is passed. In launchpad
-         * spaces mode the promise gets rejected.
+         * @returns Resolves if successful. In case of failure, an error message is passed. In launchpad spaces
+         * mode the promise gets rejected.
          */
         addCatalogTileToGroup(
           /**
@@ -2057,8 +2168,7 @@ declare namespace sap {
          * @since 1.17.1
          * @deprecated (since 1.119) - Please use {@link sap.ushell.services.BookmarkV2#countBookmarks} instead.
          *
-         * @returns A `jQuery.Promise` which informs about success or failure of this asynchronous operation. In
-         * case of success, the count of existing bookmarks is provided (which might be zero). In case of failure,
+         * @returns Resolves the count of existing bookmarks is provided (which might be zero). In case of failure,
          * an error message is passed.
          */
         countBookmarks(
@@ -2080,8 +2190,7 @@ declare namespace sap {
          * @since 1.17.1
          * @deprecated (since 1.119) - Please use {@link sap.ushell.services.BookmarkV2#deleteBookmarks} instead.
          *
-         * @returns A `jQuery.Promise` which informs about success or failure of this asynchronous operation. In
-         * case of success, the number of deleted bookmarks is provided (which might be zero). In case of failure,
+         * @returns Resolves the number of deleted bookmarks is provided (which might be zero). In case of failure,
          * an error message is passed.
          */
         deleteBookmarks(
@@ -2127,8 +2236,7 @@ declare namespace sap {
          * @since 1.17.1
          * @deprecated (since 1.119) - Please use {@link sap.ushell.services.BookmarkV2#updateBookmarks} instead.
          *
-         * @returns A `jQuery.Promise` which informs about success or failure of this asynchronous operation. In
-         * case of success, the number of updated bookmarks is provided (which might be zero). In case of failure,
+         * @returns Resolves the number of updated bookmarks is provided (which might be zero). In case of failure,
          * an error message is passed.
          */
         updateBookmarks(
@@ -2206,22 +2314,25 @@ declare namespace sap {
        * The Unified Shell's bookmark service. Allows creating shortcuts on the user's home page.
        *
        * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("BookmarkV2")`.
-       * For details, see {@link sap.ushell.services.Container#getServiceAsync}.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
        *
        * @since 1.119.0
        */
-      class BookmarkV2 {
-        constructor();
+      class BookmarkV2 extends sap.ushell.services.Service {
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
 
         /**
-         * Adds a bookmark tile to one of the user's classic home page groups or to multiple provided content nodes.
+         * Adds a bookmark tile to the provided content nodes.
          * See:
          * 	sap.ushell.services.URLParsing#getShellHash
          *
          * @since 1.119.0
          *
          * @returns A `Promise` which resolves on success, but rejects with a reason-message on failure to add the
-         * bookmark to the specified or implied group. The promise gets resolved if personalization is disabled.
+         * bookmark to the specified or implied content node. The promise gets resolved if personalization is disabled.
          */
         addBookmark(
           /**
@@ -2313,16 +2424,14 @@ 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 content node or an array of content nodes (see {@link #getContentNodes}). If not provided, the
+           * bookmark will be added to the default page.
            */
           vContainer?:
-            | object
             | sap.ushell.services.BookmarkV2.ContentNode
             | sap.ushell.services.BookmarkV2.ContentNode[],
           /**
-           * The contentProviderId or undefined outside the cFLP
+           * **SAP internal usage only** The contentProviderId or undefined outside the cFLP.
            */
           sContentProviderId?: string
         ): Promise<any>;
@@ -2372,20 +2481,7 @@ declare namespace sap {
           sContentProviderId?: string
         ): Promise<any>;
         /**
-         * Returns available content nodes based on the current launchpad context. (Classic home page, spaces mode)
-         *
-         * A content node may be:
-         * 	 - a classic home page group
-         * 	 - an unselectable node (space) or a selectable node (page) in spaces mode
-         * 	 - or any other containers in the future
-         *
-         * 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 }
-         *
-         * 	 - isContainer: Specifies if a bookmark can be added
-         * 	 - children: Specifies sub-nodes
+         * Returns available content nodes.
          *
          * @since 1.119.0
          *
@@ -2484,26 +2580,70 @@ declare namespace sap {
        * and their value changes.
        *
        * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("Configuration")`.
-       * For details, see {@link sap.ushell.services.Container#getServiceAsync}.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
        *
        * @since 1.64.0
        */
-      class Configuration {
-        constructor();
+      class Configuration extends sap.ushell.services.Service {
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
+
+        /**
+         * Allows to attach to any value change of the sizeBehavior configuration for homepage parts (smaller tile
+         * size) which is needed to implement custom tiles reacting on this setting. The returned value can directly
+         * be used in {@link sap.m.GenericTile#sizeBehavior}.
+         *
+         * Once attached, `fnCallback` will be called once initially for the **current value** and afterwards every
+         * time the value changed.
+         *
+         * Please ensure to detach from the registry by calling `.detach` on the returned object e.g. in the destroy
+         * function of your component or controller! Make sure that you do not attach twice with the same function
+         * as otherwise a detach cannot be performed later!
+         *
+         * Example usage:
+         * ```javascript
+         *
+         * var oEventRegistry;
+         *
+         * // the callback that is called whenever the property changes
+         * var fnCallback = function (sSizeBehavior) {
+         *     // do something with sSizeBehavior like setting it on a
+         *     // sap.m.GenericTile via model and data binding!
+         * };
+         *
+         *
+         * // retrieve service via getServiceAsync API
+         * sap.ushell.Container.getServiceAsync("Configuration").then( function (oService) {
+         *     // keep the returned event registry in order to detach upon destroy of your context
+         *     oEventRegistry = oService.attachSizeBehaviorUpdate(fnCallback);
+         * });
+         *
+         * // detach later when your context is destroyed (e.g. destroy of the controller)
+         * oEventRegistry.detach();
+         * ```
+         *
+         *
+         *
+         * @returns detach handler - call detach() to detach from further updates
+         */
+        attachSizeBehaviorUpdate(
+          /**
+           * The function to be called once the property changes. It receives a parameter of type {@link sap.m.TileSizeBehavior}.
+           */
+          fnCallback: Function
+        ): {
+          detach: Function;
+        };
       }
       /**
        * The Unified Shell's CrossApplicationNavigation service. Allows navigating to "external" targets outside
        * of the currently running app (but still in scope of the current Fiori launchpad) or to create links to
        * such external targets.
        *
-       * To use the CrossApplicationNavigation service you can retrieve an instance via ushell's Container:
-       * ```javascript
-       *
-       * sap.ushell.Container.getServiceAsync("CrossApplicationNavigation").then(function (CrossApplicationNavigationService) {
-       *   // Use the CrossApplicationNavigation service
-       * });
-       * ```
-       *
+       * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("ClientSideTargetResolution")`.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
        *
        * The CrossApplicationNavigation service currently provides platform independent functionality.
        *
@@ -2555,8 +2695,11 @@ declare namespace sap {
        * @since 1.15.0
        * @deprecated (since 1.120) - Please use {@link sap.ushell.services.Navigation} instead
        */
-      class CrossApplicationNavigation {
-        constructor();
+      class CrossApplicationNavigation extends sap.ushell.services.Service {
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
 
         /**
          * Attempts to use the browser history to navigate to the previous app.
@@ -2577,7 +2720,7 @@ declare namespace sap {
          * it into a long url with all parameters expanded
          *
          *
-         * @returns promise the success handler of the resolve promise get an expanded shell hash as first argument
+         * @returns Resolves the expanded shell hash as first argument.
          */
         expandCompactHash(
           /**
@@ -2590,10 +2733,10 @@ declare namespace sap {
          *
          * @since 1.38.0
          *
-         * @returns A promise that resolves with an array of strings representing the semantic objects of the intents
-         * the current user can navigate to, or rejects with an error message. The returned array will not contain
-         * duplicates. NOTE: the caller should not rely on the specific order the semantic objects appear in
-         * the returned array.
+         * @returns Resolves with an array of strings representing the semantic objects of the intents the current
+         * user can navigate to, or rejects with an error message. The returned array will not contain duplicates.
+         * NOTE: the caller should not rely on the specific order the semantic objects appear in the returned
+         * array.
          */
         getDistinctSemanticObjects(): jQuery.Promise;
         /**
@@ -2602,8 +2745,7 @@ declare namespace sap {
          *
          * @since 1.38.0
          *
-         * @returns A promise that resolves with an array of link objects containing (at least) the following properties:
-         *
+         * @returns Resolves with an array of link objects containing (at least) the following properties:
          * ```javascript
          *
          *   {
@@ -2845,8 +2987,7 @@ declare namespace sap {
          *
          * @since 1.48
          *
-         * @returns When a relevant link object exists, it will return a promise that resolves to an object of the
-         * following form:
+         * @returns Resolves to an object of the following form when a relevant link object exists:
          * ```javascript
          *
          *   {
@@ -2868,7 +3009,7 @@ declare namespace sap {
            * @see sap.ushell.services.CrossApplicationNavigation#getSemanticObjectLinks for description.
            */
           mParameters?: object
-        ): jQuery.Deferred;
+        ): jQuery.Promise;
         /**
          * Resolves a given semantic object and business parameters to a list of links, taking into account the
          * form factor of the current device.
@@ -2876,8 +3017,7 @@ declare namespace sap {
          * @since 1.19.0
          * @deprecated (since 1.38) - Please use {@link #getLinks} instead.
          *
-         * @returns A `jQuery.Deferred` object's promise which is resolved with an array of link objects containing
-         * (at least) the following properties:
+         * @returns Resolves with an array of link objects containing (at least) the following properties:
          * ```javascript
          *
          *   {
@@ -3269,8 +3409,8 @@ declare namespace sap {
          * @deprecated (since 1.31) - Please use {@link #isNavigationSupported} instead. Note that this has a slightly
          * different response format.
          *
-         * @returns A `jQuery.Deferred` object's promise which is resolved with a map containing the intents from
-         * `aIntents` as keys. The map values are objects with a property `supported` of type `boolean`.
+         * @returns Resolves with a map containing the intents from `aIntents` as keys. The map values are objects
+         * with a property `supported` of type `boolean`.
          *  Example:
          * ```javascript
          *
@@ -3322,8 +3462,8 @@ declare namespace sap {
          *
          * @since 1.32
          *
-         * @returns Promise of a `jQuery.Deferred` object that resolves to an array of objects indicating whether
-         * the intent is supported or not. Each object has a property `supported` of type `boolean`.
+         * @returns Resolves to an array of objects indicating whether the intent is supported or not. Each object
+         * has a property `supported` of type `boolean`.
          *
          * Example:
          *
@@ -3432,7 +3572,7 @@ declare namespace sap {
          *
          * @ui5-protected Do not call from applications (only from related classes in the framework)
          *
-         * @returns A jQuery.Promise.
+         * @returns Resolves the intent.
          */
         resolveIntent(
           /**
@@ -3559,17 +3699,17 @@ declare namespace sap {
        * The Unified Shell's end user feedback service. This service is deprecated and does nothing. End user
        * feedback functionality is not part of the ushell library.
        *
+       * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("DarkModeSupport")`.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
+       *
        * @since 1.25.1
        * @deprecated (since 1.93)
        */
-      class EndUserFeedback {
+      class EndUserFeedback extends sap.ushell.services.Service {
         /**
-         * This method MUST be called by the Unified Shell's container only, others MUST call `sap.ushell.Container.getServiceAsync("EndUserFeedback").then(function
-         * (EndUserFeedback) {});`. Constructs a new instance of the end user feedback service.
-         * See:
-         * 	sap.ushell.services.Container#getServiceAsync
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
          */
-        constructor();
+        protected constructor();
 
         /**
          * @since 1.25.1
@@ -3584,9 +3724,9 @@ declare namespace sap {
          * @since 1.25.1
          * @deprecated (since 1.93)
          *
-         * @returns Rejected promise
+         * @returns Rejected promise.
          */
-        isEnabled(): object;
+        isEnabled(): Promise<any>;
         /**
          * Sends a feedback.
          *
@@ -3601,7 +3741,7 @@ declare namespace sap {
        * The Unified Shell's Extension service. Allows adding extensions on the user's home page.
        *
        * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("Extension")`.
-       * For details, see {@link sap.ushell.services.Container#getServiceAsync}.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
        *
        *
        *  All extension items and extension areas are instantiated as invisible. You have to call .show<...> to
@@ -3610,8 +3750,11 @@ declare namespace sap {
        * @since 1.120.0
        * @experimental (since 1.120.0) - Restriction: API calls might be ignored for apps running in an iframe
        */
-      class Extension {
-        constructor();
+      class Extension extends sap.ushell.services.Service {
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
 
         /**
          * Adds an entry to the user settings dialog box including the UI control that appears when the user clicks
@@ -3639,18 +3782,18 @@ declare namespace sap {
             /**
              * A string to be presented as the sub title of the entry OR a function which resolves the sub title.
              */
-            value: string | Function;
+            value: string | (() => Promise<string>);
             /**
              * A function that resolves the content which has to be a {@link sap.ui.core.Control}. A SAPUI5 view instance
              * can also be returned. The result will be displayed in the settings as content for this entry.
              */
-            content: Function;
+            content: () => Promise<sap.ui.core.Control>;
             /**
              * A callback which is called when the user clicks "save" in the user settings dialog. The function has
              * to return a native promise. If an error occurs, pass the error message via rejected promise. Errors are
              * displayed in the common log.
              */
-            onSave: Function;
+            onSave: () => Promise<any>;
             /**
              * A callback which is called when the user closes the user settings dialog without saving any changes.
              */
@@ -3777,6 +3920,9 @@ declare namespace sap {
       /**
        * A service for handling groups, tiles and catalogs.
        *
+       * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("Extension")`.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
+       *
        * The functions that return the main objects are getGroups, getGroupTitle, getCatalogs and getCatalogTiles.
        * Since the implementation (i.e. adapter) is platform specific, do not call or access properties and functions
        * of returned objects. Instead, use other functions of the LaunchPage service with the relevant object
@@ -3788,53 +3934,37 @@ declare namespace sap {
        * @since 1.15.0
        * @deprecated (since 1.99) - This service has been deprecated as it only works for the classic homepage.
        */
-      class LaunchPage {
+      class LaunchPage extends sap.ushell.services.Service {
         /**
-         * This method MUST be called by the Unified Shell's container only, others MUST call `sap.ushell.Container.getServiceAsync("LaunchPage").then(function
-         * (LaunchPage) {});`. Constructs a new instance of the page builder service.
-         * See:
-         * 	sap.ushell.services.Container#getServiceAsync
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
          */
-        constructor(
-          /**
-           * the page builder adapter for the logon system
-           */
-          oAdapter: object,
-          /**
-           * the interface provided by the container
-           */
-          oContainerInterface: object
-        );
+        protected constructor();
 
         /**
          * Adds a new group.
          *
-         * In case of success, the `done` function gets the new added group object. Intention: the page builder
-         * adds this group to the end of the home screen.
+         * Intention: the page builder adds this group to the end of the home screen.
          *
-         * In case of failure, the `fail` function returns the consistent (i.e. persisted) backend state of all
-         * groups.
+         * In case of failure it gets the consistent (i.e. persisted) backend state of all groups.
          *
          *
-         * @returns jQuery.promise object
+         * @returns Resolves once the group was added.
          */
         addGroup(
           /**
            * The title of the new group
            */
           sTitle: string
-        ): object;
+        ): jQuery.Promise;
         /**
          * Adds a new group at a specific location.
          *
-         * In case of success, the `done` function gets the new added group object. Intention: the page builder
-         * adds this group to the specific location on the home screen.
+         * Intention: the page builder adds this group to the specific location on the home screen.
          *
-         * In case of failure, the `fail` function returns the consistent (i.e. persisted) backend state of all
-         * groups.
+         * In case of error it gets the consistent (i.e. persisted) backend state of all groups.
          *
          *
-         * @returns jQuery.promise object
+         * @returns Resolves the group.
          */
         addGroupAt(
           /**
@@ -3845,18 +3975,17 @@ declare namespace sap {
            * the location of the new group
            */
           iIndex: int
-        ): object;
+        ): jQuery.Promise;
         /**
          * Adds a tile to a group.
          *
          * If no group is provided then the tile is added to the default group.
          *
-         * In case of success, the `done` function returns the new tile. Intention: the page builder by default
-         * puts this tile at the end of the default group. In case of failure, the `fail` function should return
-         * the consistent (i.e. persisted) backend state of the default group.
+         * Intention: the page builder by default puts this tile at the end of the default group. In case of failure
+         * it gets the consistent (i.e. persisted) backend state of the default group.
          *
          *
-         * @returns jQuery.promise object
+         * @returns Resolves once the tile was added.
          */
         addTile(
           /**
@@ -3867,7 +3996,7 @@ declare namespace sap {
            * The target group
            */
           oGroup?: object
-        ): object;
+        ): jQuery.Promise;
         /**
          * Returns the press handler for clicking on a tile.
          *
@@ -3931,11 +4060,23 @@ declare namespace sap {
          * you the same possibilities as attaching a `done` handler, but with the advantage of improved responsiveness.
          *
          *
-         * @returns `jQuery.Deferred` object's promise In case of success, an array of black-box catalog objects
-         * is provided (which might be empty). In case of failure, an error message is passed. Progress notifications
-         * are sent for each single catalog, providing a single black-box catalog object each time.
+         * @returns Resolves an array of black-box catalog objects is provided (which might be empty). In case of
+         * failure, an error message is passed. Progress notifications are sent for each single catalog, providing
+         * a single black-box catalog object each time.
          */
-        getCatalogs(): object;
+        getCatalogs(): jQuery.Promise;
+        /**
+         * Returns catalog tile's content provider ID.
+         *
+         *
+         * @returns Tile content provider ID
+         */
+        getCatalogTileContentProviderId(
+          /**
+           * The tile or the catalog tile
+           */
+          oTile: object
+        ): string;
         /**
          * Returns catalog tile's unique identifier. This function may be called for a catalog tile or (since 1.21.0)
          * for a group tile. In the latter case, the function returns the unique identifier of the catalog tile
@@ -3978,6 +4119,19 @@ declare namespace sap {
            */
           oCatalogTile: object
         ): string;
+        /**
+         * Returns the catalog tile info
+         *
+         * @since 1.67.0
+         *
+         * @returns The catalog tile info
+         */
+        getCatalogTilePreviewInfo(
+          /**
+           * The catalog tile
+           */
+          oCatalogTile: object
+        ): string;
         /**
          * Returns preview subtitle for a catalog tile.
          *
@@ -4006,18 +4160,17 @@ declare namespace sap {
           oCatalogTile: object
         ): string;
         /**
-         * Returns the tiles of a catalog. In case of success, the `done` function of the returned promise object
-         * gets an array of 'anonymous' tiles of the catalog.
+         * Returns the tiles of a catalog.
          *
          *
-         * @returns jQuery.promise object.
+         * @returns Resolve the catalog tiles.
          */
         getCatalogTiles(
           /**
            * The catalog
            */
           oCatalog: object
-        ): object;
+        ): jQuery.Promise;
         /**
          * Returns the size of a catalog tile as a string. For example: "1x1", "1x2"
          *
@@ -4070,11 +4223,10 @@ declare namespace sap {
           oCatalogTile: object
         ): string[];
         /**
-         * Returns the catalog tile info
+         * Returns the catalog tile's title
          *
-         * @since 1.67.0
          *
-         * @returns The catalog tile info
+         * @returns Tile title
          */
         getCatalogTileTitle(
           /**
@@ -4103,7 +4255,7 @@ declare namespace sap {
          * Returns the UI5 view or control of a catalog tile
          *
          *
-         * @returns jQuery.deferred.promise object that when resolved, returns the Catalog Tile View
+         * @returns Resolves the Catalog Tile View
          */
         getCatalogTileViewControl(
           /**
@@ -4114,7 +4266,7 @@ declare namespace sap {
            * SAP-internal: Whether the tile should be displayed in preview mode
            */
           bPreview?: boolean
-        ): object;
+        ): jQuery.Promise;
         /**
          * Returns the catalog's title
          *
@@ -4128,13 +4280,12 @@ declare namespace sap {
           oCatalog: object
         ): string;
         /**
-         * Returns the default group of the user. In case of success, the `done` function gets an 'anonymous' object
-         * representing the default group.
+         * Returns the default group of the user.
          *
          *
-         * @returns jQuery.promise object.
+         * @returns Resolves the default group.
          */
-        getDefaultGroup(): object;
+        getDefaultGroup(): jQuery.Promise;
         /**
          * Returns the unique identifier of the given group
          *
@@ -4148,14 +4299,14 @@ declare namespace sap {
           oGroup: object
         ): string;
         /**
-         * Returns the groups of the user. In case of success, the `done` function gets an array of 'anonymous'
-         * groups. The order of the array is the order in which the groups will be displayed to the user.
+         * Returns the groups of the user. The order of the array is the order in which the groups will be displayed
+         * to the user.
          *
          * @deprecated (since 1.99) - Alternative for use with {@link sap.ushell.services.Bookmark} is {@link sap.ushell.services.Bookmark#getContentNodes}
          *
          * @returns A promise that resolves to the list of groups
          */
-        getGroups(): Promise<object>;
+        getGroups(): jQuery.Promise<object>;
         /**
          * Returns an array of 'anonymous' tiles of a group. The order of the array is the order of tiles that will
          * be displayed to the user.
@@ -4258,18 +4409,17 @@ declare namespace sap {
           oTile: object
         ): string;
         /**
-         * Returns UI5 view or control of the tile. In case of success the `done` function should return UI5 view
-         * or control of the tile. In case of failure the `fail` function should return nothing.
+         * Returns UI5 view or control of the tile.
          *
          *
-         * @returns jQuery.promise object
+         * @returns Resolves the UI5 view or control of the tile.
          */
         getTileView(
           /**
            * The tile
            */
           oTile: object
-        ): object;
+        ): jQuery.Promise;
         /**
          * Returns whether the catalogs collection previously returned by `getCatalogs()` is still valid.
          *
@@ -4333,12 +4483,11 @@ declare namespace sap {
         /**
          * Moves a group to a new index (i.e. location).
          *
-         * In case of success, the `done` function is called without any value. Intention: the page builder already
-         * moved the page (visible to the user) and if successful - nothing needs to be done. In case of failure,
-         * the `fail` function returns the consistent (i.e. persisted) backend state of all groups.
+         * Intention: the page builder already moved the page (visible to the user) and if successful - nothing
+         * needs to be done. In case of failure it gets the consistent (i.e. persisted) backend state of all groups.
          *
          *
-         * @returns jQuery.promise object
+         * @returns Resolves once the group was moved.
          */
         moveGroup(
           /**
@@ -4349,20 +4498,19 @@ declare namespace sap {
            * The new index for the group
            */
           iNewIndex: int
-        ): object;
+        ): jQuery.Promise;
         /**
          * Moves a tile within a group or between different groups.
          *
-         * In case of success, the `done` function returns nothing. Intention: the page builder already moved the
-         * tile.
+         * Intention: the page builder already moved the tile.
          *
-         * In case of failure, the `fail` function returns the consistent (i.e. persisted) backend state of the
-         * source group and the target group. The result is in the following format {source:[{},{}], target:[{},{}]}.
+         * In case of failure it gets the consistent (i.e. persisted) backend state of the source group and the
+         * target group. The result is in the following format {source:[{},{}], target:[{},{}]}.
          *
          * The source and the target groups tiles are in the form of the @see sap.ushell.services.LaunchPage.getGroupTiles
          *
          *
-         * @returns jQuery.promise object
+         * @returns Resolves once the tile was moved.
          */
         moveTile(
           /**
@@ -4392,7 +4540,7 @@ declare namespace sap {
            * (added with 1.46) The new type of the tile
            */
           sNewTileType?: string
-        ): object;
+        ): jQuery.Promise;
         /**
          * Triggers a refresh action of a tile. Typically this action is related to the value presented in dynamic
          * tiles
@@ -4429,15 +4577,13 @@ declare namespace sap {
         /**
          * Removes a group.
          *
-         * In case of success, the `done` function is called without any value (i.e. input data). Intention: the
-         * page builder already removed the page (or hid it from the user) and if successful - nothing needs to
-         * be done.
+         * Intention: the page builder already removed the page (or hid it from the user) and if successful - nothing
+         * needs to be done.
          *
-         * In case of failure, the `fail` function returns the consistent (i.e. persisted) backend state of all
-         * groups.
+         * In case of failure it gets the consistent (i.e. persisted) backend state of all groups.
          *
          *
-         * @returns jQuery.promise object
+         * @returns Resolves once the group was removed.
          */
         removeGroup(
           /**
@@ -4448,18 +4594,16 @@ declare namespace sap {
            * The index of the group to be removed
            */
           iIndex: int
-        ): object;
+        ): jQuery.Promise;
         /**
          * Removes a tile from a group.
          *
-         * In case of success, the `done` function returns the new tile. Intention: the page builder has already
-         * 'hidden' (or removed) the tile.
+         * Intention: the page builder has already 'hidden' (or removed) the tile.
          *
-         * In case of failure, the `fail` function should return the consistent (i.e. persisted) backend state of
-         * the group.
+         * In case of failure it gets the consistent (i.e. persisted) backend state of the group.
          *
          *
-         * @returns jQuery.promise object
+         * @returns Resolves once the tile was removed.
          */
         removeTile(
           /**
@@ -4474,7 +4618,7 @@ declare namespace sap {
            * The tile index
            */
           iIndex: int
-        ): object;
+        ): jQuery.Promise;
         /**
          * Resets a group.
          *
@@ -4482,14 +4626,12 @@ declare namespace sap {
          * action means that the group is set back to the state defined by the administrator, and changes made by
          * the end user (e.g. adding tiles) are removed. A group can be reset multiple times.
          *
-         * In case of success, the `done` function gets the reset group object.
-         *
-         * In case of failure, or when the given group was created by the user (i.e. can't be reset)- `fail` handler
-         * is called, returning the consistent (i.e. persisted) backend state of all groups. The returned group
-         * object is the same as the one returned by @see sap.ushell.services.LaunchPage.getGroups
+         * In case of failure, or when the given group was created by the user (i.e. can't be reset)- it gets, the
+         * consistent (i.e. persisted) backend state of all groups. The returned group object is the same as the
+         * one returned by @see sap.ushell.services.LaunchPage.getGroups
          *
          *
-         * @returns jQuery.promise object
+         * @returns Resolves once the group was reset.
          */
         resetGroup(
           /**
@@ -4500,17 +4642,16 @@ declare namespace sap {
            * The index of the group to be reset
            */
           iIndex: int
-        ): object;
+        ): jQuery.Promise;
         /**
          * Sets the title of an existing group.
          *
-         * In case of success, the `done` function returns nothing. Intention: the page builder knows the new title,
-         * and if successful nothing needs to be done, as the title is already visible to the user. In case of failure,
-         * the `fail` function returns the consistent (i.e. persisted) backend state of the group title, in most
-         * cases the old title.
+         * Intention: the page builder knows the new title, and if successful nothing needs to be done, as the title
+         * is already visible to the user. In case of failure it gets the consistent (i.e. persisted) backend state
+         * of the group title, in most cases the old title.
          *
          *
-         * @returns jQuery.promise object
+         * @returns Resolves once the group title was set.
          */
         setGroupTitle(
           /**
@@ -4521,7 +4662,7 @@ declare namespace sap {
            * The new title of the group
            */
           sTitle: string
-        ): object;
+        ): jQuery.Promise;
         /**
          * Sets the tile's visibility state and notifies the tile about the change.
          */
@@ -4540,13 +4681,16 @@ declare namespace sap {
        * Message service.
        *
        * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("Message")`.
-       * For details, see {@link sap.ushell.services.Container#getServiceAsync}.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
        *
        * @since 1.16.0
        * @deprecated (since 1.120)
        */
-      class Message {
-        constructor();
+      class Message extends sap.ushell.services.Service {
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
 
         /**
          * Shows an confirmation dialog on the screen.
@@ -4650,7 +4794,7 @@ declare namespace sap {
        * running app (but still in scope of the current Fiori launchpad) or to create links to such external targets.
        *
        * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("Navigation")`.
-       * For details, see {@link sap.ushell.services.Container#getServiceAsync}.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
        *
        * The Navigation service currently provides platform independent functionality.
        *
@@ -4700,8 +4844,11 @@ declare namespace sap {
        *
        * @since 1.120.0
        */
-      class Navigation {
-        constructor();
+      class Navigation extends sap.ushell.services.Service {
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
 
         /**
          * Attempts to use the browser history to navigate to the previous app.
@@ -4866,6 +5013,9 @@ declare namespace sap {
          *
          *
          * @since 1.120.0
+         *
+         * @returns A promise that resolves to an array of objects indicating whether the intent is supported or
+         * not. Each object has a property `supported` of type `boolean`.
          */
         isNavigationSupported(
           /**
@@ -4876,7 +5026,11 @@ declare namespace sap {
            * The root component of the application.
            */
           oComponent?: sap.ui.core.Component
-        ): void;
+        ): Promise<
+          Array<{
+            supported: boolean;
+          }>
+        >;
         /**
          * 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.
@@ -4938,7 +5092,7 @@ declare namespace sap {
        * The Unified Shell's internal navigation target resolution service.
        *
        * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("NavTargetResolution")`.
-       * For details, see {@link sap.ushell.services.Container#getServiceAsync}.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
        *
        * Methods in this class deal with *internal* representations of the shell hash.
        *
@@ -4949,8 +5103,11 @@ declare namespace sap {
        * @since 1.15.0
        * @deprecated (since 1.120)
        */
-      class NavTargetResolution {
-        constructor();
+      class NavTargetResolution extends sap.ushell.services.Service {
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
 
         /**
          * expands a URL hash fragment
@@ -4960,7 +5117,7 @@ declare namespace sap {
          * This is an asynchronous operation.
          *
          *
-         * @returns A jQuery.Promise. Its `done()` function gets an expanded shell hash (in internal format)
+         * @returns Resolves expanded shell hash (in internal format).
          */
         expandCompactHash(
           /**
@@ -4968,7 +5125,7 @@ declare namespace sap {
            * given in `location.hash`)
            */
           sHashFragment: string
-        ): string;
+        ): jQuery.Promise;
         /**
          * 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.
@@ -4978,8 +5135,8 @@ declare namespace sap {
          *
          * @since 1.32
          *
-         * @returns A `jQuery.Deferred` object's promise which is resolved with an array (!) of objects representing
-         * whether the intent is supported or not objects with a property `supported` of type `boolean`.
+         * @returns Resolves an array of objects representing whether the intent is supported or not objects with
+         * a property `supported` of type `boolean`.
          *  Example:
          *
          * aIntents: an array of parameterized (parsed) Intent objects, in the corresponding structure to arguments
@@ -5059,7 +5216,7 @@ declare namespace sap {
            *  or `{ target : { shellHash : "AnObject-action?A=B&c=e" } }`
            */
           aIntents: object[]
-        ): object;
+        ): jQuery.Promise;
         /**
          * Resolves the URL hash fragment.
          *
@@ -5083,7 +5240,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 Resolves 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
@@ -5106,7 +5263,7 @@ declare namespace sap {
            * given in `location.hash`)! Example: `#SemanticObject-action?P1=V1&P2=A%20B%20C`
            */
           sHashFragment: string
-        ): object;
+        ): jQuery.Promise;
         /**
          * Resolves a navigation target taking into account the sap-system
          *
@@ -5115,8 +5272,7 @@ declare namespace sap {
          *
          * @ui5-protected Do not call from applications (only from related classes in the framework)
          *
-         * @returns A jQuery.Promise. Its `done()` function gets an object. Typically it contains the following
-         * information:
+         * @returns Resolves an object. Typically it contains the following information:
          * ```javascript
          *
          *   {
@@ -5152,6 +5308,9 @@ declare namespace sap {
        * UShell service for fetching user notification data from the Notification center/service
        *  and exposing them to the Unified Shell and Fiori applications UI controls.
        *
+       * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("ClientSideTargetResolution")`.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
+       *
        * In order to get user notifications, Unified Shell notification service issues OData requests
        *  to the service defined by the configuration property `serviceUrl`,
        *  for example: "/sap/opu/odata4/iwngw/notification/default/iwngw/notification_srv/0001"
@@ -5175,8 +5334,11 @@ declare namespace sap {
        * @since 1.32.0
        * @deprecated (since 1.119) - Please use {@link sap.ushell.services.NotificationsV2} instead.
        */
-      class Notifications {
-        constructor();
+      class Notifications extends sap.ushell.services.Service {
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
 
         /**
          * Launches dismiss notification call.
@@ -5184,7 +5346,7 @@ declare namespace sap {
          *
          * @since 1.34
          *
-         * @returns Promise object that on success resolves to undefined or it is rejected with a message object
+         * @returns Resolves to undefined or it is rejected with a message object
          */
         dismissNotification(
           /**
@@ -5216,7 +5378,7 @@ declare namespace sap {
          *
          * @since 1.38
          *
-         * @returns Promise object that - on success - returns all notification items
+         * @returns Resolves all notification items
          */
         getNotificationsByTypeWithGroupHeaders(): jQuery.Promise;
         /**
@@ -5233,7 +5395,7 @@ declare namespace sap {
          *
          * @since 1.44
          *
-         * @returns Promise object that - on success - returns all group headers
+         * @returns Resolves all group headers
          */
         getNotificationsGroupHeaders(): jQuery.Promise;
         /**
@@ -5242,7 +5404,7 @@ declare namespace sap {
          *
          * @since 1.32
          *
-         * @returns Promise object that on success - returns the number of unread notifications of the user
+         * @returns Resolves the number of unread notifications of the user
          */
         getUnseenNotificationsCount(): jQuery.Promise;
         /**
@@ -5289,7 +5451,7 @@ declare namespace sap {
          *
          * @since 1.34
          *
-         * @returns Promise object that on success resolves to undefined or it is rejected with a message object
+         * @returns Resolves to undefined or it is rejected with a message object
          */
         markRead(
           /**
@@ -5333,7 +5495,7 @@ declare namespace sap {
        *  and exposing them to the Unified Shell and Fiori applications UI controls.
        *
        * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("NotificationsV2")`.
-       * For details, see {@link sap.ushell.services.Container#getServiceAsync}.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
        *
        * In order to get user notifications, Unified Shell notification service issues OData requests
        *  to the service defined by the configuration property `serviceUrl`,
@@ -5357,8 +5519,11 @@ declare namespace sap {
        *
        * @since 1.119
        */
-      class NotificationsV2 {
-        constructor();
+      class NotificationsV2 extends sap.ushell.services.Service {
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
 
         /**
          * Launches dismiss notification call.
@@ -5472,7 +5637,7 @@ declare namespace sap {
          *  the main use-case is when the user navigated to the notification center and sees all the pending notifications.
          *
          *
-         * @returns Promise taht resolves when operation is finished
+         * @returns Promise that resolves when operation is finished
          */
         notificationsSeen(): Promise<any>;
         /**
@@ -5495,17 +5660,20 @@ declare namespace sap {
         ): void;
       }
       /**
-       * This method MUST be called by the Unified Shell's container only, others MUST call `sap.ushell.Container.getServiceAsync("Personalization").then(function
-       * (Personalization) {});`. Constructs a new instance of the personalization service.
-       *
        * The Unified Shell's personalization service, which provides a personalizer object that handles all personalization
        * operations.
        *
+       * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("ClientSideTargetResolution")`.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
+       *
        * @since 1.15.0
        * @deprecated (since 1.120) - Please use {@link sap.ushell.services.PersonalizationV2} instead
        */
-      class Personalization {
-        constructor();
+      class Personalization extends sap.ushell.services.Service {
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
 
         /**
          * Factory method to obtain an empty Data Context object. When data present in a prior context is not relevant
@@ -5521,11 +5689,10 @@ declare namespace sap {
          *
          * @since 1.22.0
          *
-         * @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
-         * containing items.
+         * @returns Resolves 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 containing items.
          */
         createEmptyContainer(
           /**
@@ -5545,7 +5712,7 @@ declare namespace sap {
            * the application.
            */
           oComponent: sap.ui.core.Component
-        ): object;
+        ): jQuery.Promise;
         /**
          * Asynchronously starts a deletion request for the given container identified by sContainerKey. Can be
          * called without having ever called getContainer with the corresponding key
@@ -5558,7 +5725,7 @@ declare namespace sap {
          *
          * @since 1.22.0
          *
-         * @returns promise for the deletion operation
+         * @returns Resolves once the container was deleted.
          */
         delContainer(
           /**
@@ -5569,7 +5736,7 @@ declare namespace sap {
            * scope object
            */
           oScope: object
-        ): object;
+        ): jQuery.Promise;
         /**
          * Asynchronously starts a deletion request for the given container identified by sContainerKey. Can be
          * called without having ever created a personalization container.
@@ -5583,14 +5750,14 @@ declare namespace sap {
          * @since 1.18.0
          * @deprecated (since 1.22) - Please use {@link #delContainer} instead.
          *
-         * @returns promise for the deletion operation
+         * @returns Resolves once the container was deleted.
          */
         delPersonalizationContainer(
           /**
            * identifies the container
            */
           sContainerKey: string
-        ): object;
+        ): jQuery.Promise;
         /**
          * 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.
@@ -5646,8 +5813,8 @@ declare namespace sap {
          * namespaces per validity).
          *
          * In general, mixing different validity models for a given container key is not supported. Fast chaining
-         * of different methods may source arbitrary persistence layers. The validity of the resulting object in
-         * the done function of a promise is the last get validity.
+         * of different methods may source arbitrary persistence layers. The validity of the resolved object is
+         * the last get validity.
          *
          * The validity associated with the last getContainer or createEmptyContainer determines the current validity
          * of the container and the validity used during the next save operation.
@@ -5658,10 +5825,9 @@ declare namespace sap {
          *
          * @since 1.22.0
          *
-         * @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.
+         * @returns Resolves 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.
          */
         getContainer(
           /**
@@ -5683,7 +5849,7 @@ declare namespace sap {
            * the application.
            */
           oComponent: sap.ui.core.Component
-        ): object;
+        ): jQuery.Promise;
         /**
          * Returns a generated key. This key is suitably random, but it is susceptible to brute force attacks. Storages
          * based on the generated key must not be used for sensitive data.
@@ -5736,18 +5902,17 @@ declare namespace sap {
          * @since 1.18.0
          * @deprecated (since 1.21) - Please use {@link #getContainer} instead.
          *
-         * @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
-         * containing items.
+         * @returns Resolves 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 containing items.
          */
         getPersonalizationContainer(
           /**
            * identifies the container
            */
           sContainerKey: string
-        ): object;
+        ): jQuery.Promise;
         /**
          * 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.
@@ -5759,8 +5924,8 @@ declare namespace sap {
          *
          * @since 1.15.0
          *
-         * @returns {@link sap.ushell.services.Personalizer} which provides generic read and write access to the
-         * currently logged on user's personalization settings.
+         * @returns A Personalizer which provides generic read and write access to the currently logged on user's
+         * personalization settings.
          */
         getPersonalizer(
           /**
@@ -5785,7 +5950,7 @@ declare namespace sap {
            * with the application.
            */
           oComponent?: sap.ui.core.Component
-        ): object;
+        ): /* was: sap.ushell.services.Personalizer */ any;
         /**
          * 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
@@ -5794,26 +5959,25 @@ declare namespace sap {
          *
          * @since 1.18.0
          *
-         * @returns {@link sap.ushell.services.TransientPersonalizer} which provides asynchronous read and write
-         * access to a transient personalization data storage.
+         * @returns A TransientPersonalizer which provides asynchronous read and write access to a transient personalization
+         * data storage.
          */
-        getTransientPersonalizer(): object;
+        getTransientPersonalizer(): /* was: sap.ushell.services.TransientPersonalizer */ any;
       }
       /**
        * The Unified Shell's personalization service. Provides a personalizer object that handles all personalization
        * operations.
        *
        * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("PersonalizationV2")`.
-       * For details, see {@link sap.ushell.services.Container#getServiceAsync}.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
        *
        * @since 1.120.0
        */
-      class PersonalizationV2 {
-        constructor();
+      class PersonalizationV2 extends sap.ushell.services.Service {
         /**
-         * @since 1.120.0
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
          */
-        static constants: undefined;
+        protected constructor();
 
         /**
          * Factory method to obtain an empty Data Context object. When data present in a prior context is not relevant
@@ -5861,7 +6025,7 @@ declare namespace sap {
          *
          * @since 1.120.0
          *
-         * @returns promise for the deletion operation
+         * @returns Resolves once the container was deleted.
          */
         deleteContainer(
           /**
@@ -5928,8 +6092,8 @@ declare namespace sap {
          * namespaces per validity).
          *
          * In general, mixing different validity models for a given container key is not supported. Fast chaining
-         * of different methods may source arbitrary persistence layers. The validity of the resulting object in
-         * the done function of a promise is the last get validity.
+         * of different methods may source arbitrary persistence layers. The validity of the resolved object is
+         * the last get validity.
          *
          * The validity associated with the last getContainer or createEmptyContainer determines the current validity
          * of the container and the validity used during the next save operation.
@@ -6010,16 +6174,27 @@ declare namespace sap {
          */
         getTransientPersonalizer(): Promise<sap.ushell.services.PersonalizationV2.TransientPersonalizer>;
       }
+      /**
+       * Abstract base class for ushell services. For details, see {@link sap.ushell.Container#getServiceAsync}.
+       *
+       * @since 1.121.0
+       */
+      abstract class Service {
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
+      }
       /**
        * The Unified Shell's internal navigation service (platform independent).
        *
        * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("ShellNavigation")`.
-       * For details, see {@link sap.ushell.services.Container#getServiceAsync}.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
        *
        * This interface is for consumption by shell renderers/containers only
        *
        * It is not for direct usage by applications, see inner app navigation : UI5 interfaces (hashChanger, Router)
-       * cross app navigation : @see CrossApplicationNavigation
+       * cross app navigation : @see sap.ushell.services.CrossApplicationNavigation
        *
        * Usage:
        *
@@ -6058,7 +6233,10 @@ declare namespace sap {
        * @deprecated (since 1.120)
        */
       class ShellNavigation {
-        constructor();
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
 
         /**
          * compact the parameter object, if required a number of parameters will be removed, instead a corresponding
@@ -6121,14 +6299,14 @@ declare namespace sap {
          * part, if exist sOldAppSpecificPart, // The old app hash part, if exist
          *
          *
-         * @returns this
+         * @returns Reference to `this` for method chaining.
          */
         init(
           /**
            * The callback method for hash changes
            */
           fnShellCallback: Function
-        ): object;
+        ): this;
         /**
          * Rewrite the hash fragment identifier without triggering any navigation at
          *
@@ -6149,56 +6327,143 @@ declare namespace sap {
          * This method should not be used externally. It's reserved uniquely for internal shell consumption and
          * its signature or result might change at any time.
          *
-         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        resetHistoryEntryReplaced(): void;
+        /**
+         * Returns true if the history entry was replaced immediately after the last navigation. To be useful, this
+         * method should be called immediately after the hash enters the URL but before the target application is
+         * finally navigated to.
+         *
+         * This method should not be used externally. It's reserved uniquely for internal shell consumption and
+         * its signature or result might change at any time.
+         *
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         *
+         * @returns Whether `hasher#replaceHash` was called after the last navigation.
+         */
+        wasHistoryEntryReplaced(): boolean;
+      }
+      /**
+       * Constructs an instance of SmartNavigation.  The constructed service provides an enhancement on {@link CrossApplicationNavigation#getLinks }
+       * and {@link CrossApplicationNavigation#toExternal}. In order for an application to leverage this enhancement,
+       * it is pertinent that the application uses {@link SmartNavigation#toExternal} for navigation. Hence the
+       * caller can subsequently use {@link SmartNavigation#getLinks} with the outcome that it sorts the resulting
+       * list in the order of frequency of attempted navigation from the application to respective links.
+       *  Attempted in the previous paragraph is emphasized due to the fact that a click on the link
+       * will cause an increment of the frequency count, regardless of whether or not the navigation was successful.
+       *
+       *
+       * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("ClientSideTargetResolution")`.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
+       *
+       * @since 1.44.0
+       * @deprecated (since 1.112) - This service has been deprecated. Please use the CrossApplicationNavigation
+       * service instead.
+       */
+      class SmartNavigation extends sap.ushell.services.Service {
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
+
+        /**
+         * Resolves the given semantic object (or action) and business parameters to a list of links available to
+         * the user, sorted according their relevance to the calling application.
+         *
+         * The relevance of link is defined by the frequency with which a navigation activity from the calling application
+         * to that link occurs.
+         *
+         * Internally, this method delegates to {@link sap.ushell.services.CrossApplicationNavigation#getLinks }
+         * and then sorts the resulting list accordingly.
+         * See:
+         * 	sap.ushell.services.CrossApplicationNavigation#getLinks
+         *
+         * @since 1.44.0
+         *
+         * @returns Resolves with an array of link objects sorted according to their relevance to the calling application.
+         */
+        getLinks(): jQuery.Promise;
+        /**
+         * Completely delegates to {@link sap.ushell.services.CrossApplicationNavigation#getPrimaryIntent}, and
+         * either may be used in place of the other with exactly the same outcome.
+         * See:
+         * 	sap.ushell.services.CrossApplicationNavigation#getPrimaryIntent
+         *
+         * @since 1.48.0
+         */
+        getPrimaryIntent(): void;
+        /**
+         * Completely delegates to {@link sap.ushell.services.CrossApplicationNavigation#hrefForExternal}, and may
+         * be used in place of the other with exactly the same outcome.
+         * See:
+         * 	sap.ushell.services.CrossApplicationNavigation#hrefForExternal
+         *
+         * @since 1.46.0
+         * @deprecated (since 1.94) - Please use {@link #hrefForExternalAsync} instead.
+         */
+        hrefForExternal(): void;
+        /**
+         * Completely delegates to {@link sap.ushell.services.CrossApplicationNavigation#hrefForExternalAsync},
+         * and may be used in place of the other with exactly the same outcome.
+         * See:
+         * 	sap.ushell.services.CrossApplicationNavigation#hrefForExternalAsync
+         *
+         * @since 1.94.0
+         *
+         * @returns A promise that is resolved to a string that can be put into an href attribute of an HTML anchor.
+         * The returned string will always start with a hash character.
          */
-        resetHistoryEntryReplaced(): void;
+        hrefForExternalAsync(): Promise<string>;
         /**
-         * Returns true if the history entry was replaced immediately after the last navigation. To be useful, this
-         * method should be called immediately after the hash enters the URL but before the target application is
-         * finally navigated to.
+         * Usage of this method in place of {@link sap.ushell.services.CrossApplicationNavigation#toExternal} drives
+         * the smartness of the results returned by {@link sap.ushell.services.SmartNavigation#getLinks}.
+         * See:
+         * 	sap.ushell.services.CrossApplicationNavigation#toExternal
          *
-         * This method should not be used externally. It's reserved uniquely for internal shell consumption and
-         * its signature or result might change at any time.
+         * @since 1.44.0
+         */
+        toExternal(): void;
+        /**
+         * Tracks a navigation to a valid intent if provided via arguments but does not perform the navigation itself.
+         * If no valid intent was provided tracking will be prevented. The intent has to consist of SemanticObject
+         * and Action. It may be passed as complete shellHash (presidence) or as individual parts Additional parameters
+         * will not be part of the tracking and ignored This Method can be used to track a click if the actual navigation
+         * was triggered via clicking a link on the UI.
          *
-         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         * @since 1.46.0
          *
-         * @returns Whether `hasher#replaceHash` was called after the last navigation.
-         */
-        wasHistoryEntryReplaced(): boolean;
-      }
-      /**
-       * @since 1.44.0
-       * @deprecated (since 1.112) - This service has been deprecated. Please use the CrossApplicationNavigation
-       * service instead.
-       */
-      class SmartNavigation {
-        /**
-         * Constructs an instance of SmartNavigation.
-         *
-         *  The constructed service provides an enhancement on {@link CrossApplicationNavigation#getLinks} and
-         * {@link CrossApplicationNavigation#toExternal}. In order for an application to leverage this enhancement,
-         * it is pertinent that the application uses {@link SmartNavigation#toExternal} for navigation. Hence the
-         * caller can subsequently use {@link SmartNavigation#getLinks} with the outcome that it sorts the resulting
-         * list in the order of frequency of attempted navigation from the application to respective links.
-         *  Attempted in the previous paragraph is emphasized due to the fact that a click on the link
-         * will cause an increment of the frequency count, regardless of whether or not the navigation was successful.
-         *  Note that an instance of this service should only be obtained via `sap.ushell.services.Container#getServiceAsync("SmartNavigation").then(function
-         * (SmartNavigation) {});`
-         * See:
-         * 	sap.ushell.services.Container#getServiceAsync
+         * @returns Resolves once the navigation was tracked.
          */
-        constructor();
+        trackNavigation(
+          /**
+           * The navigation target as object, for example: `{ target: { shellHash: 'SaleOrder-display' } }` or
+           * ```javascript
+           *
+           *   {
+           *     target: {
+           *       semanticObject: 'SalesOrder',
+           *       action: 'action'
+           *     }
+           *   }
+           * ```
+           */
+          oArgs: object
+        ): jQuery.Promise;
       }
       /**
        * The Unified Shell's SupportTicket service.
        *
        * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("SupportTicket")`.
-       * For details, see {@link sap.ushell.services.Container#getServiceAsync}.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
        *
        * @since 1.19.1
        */
-      class SupportTicket {
-        constructor();
+      class SupportTicket extends sap.ushell.services.Service {
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
 
         /**
          * Creates a Support Ticket. Forwards the given data (JSON object) to the associated adapter.
@@ -6240,7 +6505,7 @@ declare namespace sap {
        * The Unified Shell's internal URL parsing service (platform independent).
        *
        * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("URLParsing")`.
-       * For details, see {@link sap.ushell.services.Container#getServiceAsync}.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
        *
        * Methods in this class allow to break down a shell compliant hash into it's respective parts (SemanticObject,Action,Context,
        * Parameters, appSpecificHash) or (ShellPart,appSpecificHash) respectively or construct a hash from its
@@ -6259,8 +6524,11 @@ declare namespace sap {
        *
        * @since 1.15.0
        */
-      class URLParsing {
-        constructor();
+      class URLParsing extends sap.ushell.services.Service {
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
 
         /**
          * Note: deprecated, please use `sap.ui.model.odata.ODataUtils.setOrigin(sServiceUrl, { alias : sSystem
@@ -6512,8 +6780,13 @@ declare namespace sap {
         ): object;
       }
       /**
-       * A UShell service for tracking business flows and user actions. The UsageAnalytics service exposes API
-       * for logging custom events and setting custom field values in the logged events.
+       * A UShell service for tracking business flows and user actions.
+       *
+       * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("ClientSideTargetResolution")`.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
+       *
+       * The UsageAnalytics service exposes API for logging custom events and setting custom field values in the
+       * logged events.
        *  The data is sent via http and recorded on a server, whose URL is defined by the `baseUrl` service configuration
        * property.
        *  The service configuration must also include the site ID from the `pubToken` attribute.
@@ -6537,8 +6810,11 @@ declare namespace sap {
        * @deprecated (since 1.120.0) - The corresponding cloud service "SAP Web Analytics" has been retired, therefore
        * this client-side service API cannot be used any longer.
        */
-      class UsageAnalytics {
-        constructor();
+      class UsageAnalytics extends sap.ushell.services.Service {
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
 
         /**
          * Sets up to 6 customer attributes of logged events according to the given object attributes.
@@ -6606,12 +6882,15 @@ declare namespace sap {
        * The Unified Shell's user information service. Allows retrieving information about the logged-in user.
        *
        * **Note:** To retrieve a valid instance of this service, it is necessary to call `sap.ushell.Container.getServiceAsync("UserInfo")`.
-       * For details, see {@link sap.ushell.services.Container#getServiceAsync}.
+       * For details, see {@link sap.ushell.Container#getServiceAsync}.
        *
        * @since 1.16.3
        */
-      class UserInfo {
-        constructor();
+      class UserInfo extends sap.ushell.services.Service {
+        /**
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        protected constructor();
 
         /**
          * Returns the email address of the user.
@@ -6653,6 +6932,15 @@ declare namespace sap {
          * @returns The user's last name.
          */
         getLastName(): string;
+        /**
+         * Returns an object representing data about the user: ID, first name, last name, full name, e-mail address.
+         *
+         * @since 1.71.0
+         *
+         * @returns object providing information about the logged-in user: ID, first name, last name, full name,
+         * e-mail address
+         */
+        getShellUserInfo(): Promise<any>;
       }
     }
 
@@ -6879,7 +7167,7 @@ declare namespace sap {
              * ID of the element which is the current target of the association {@link #getTileContent tileContent},
              * or `null`.
              */
-            getTileContent(): sap.ui.core.ID;
+            getTileContent(): sap.ui.core.ID | null;
             /**
              * Gets current value of property {@link #getWidth width}.
              *
@@ -7422,17 +7710,18 @@ declare namespace sap {
         interface $RendererSettings extends sap.ui.core.$UIComponentSettings {}
 
         /**
-         * The SAPUI5 component of SAP Fiori Launchpad renderer for the Unified Shell.
+         * The SAPUI5 component of SAP Fiori Launchpad renderer for the Unified Shell. This method MUST be called
+         * by the Unified Shell's container only, others MUST call `sap.ushell.Container.createRenderer("fiori2",
+         * true)`.
          *
          * @since 1.15.0
          * @deprecated (since 1.120.0) - Please use {@link sap.ushell.services.Extension} instead.
          */
         class Renderer extends sap.ui.core.UIComponent {
           /**
-           * This method MUST be called by the Unified Shell's container only, others MUST call `sap.ushell.Container.createRenderer("fiori2",
-           * true)`.
+           * @ui5-protected Do not call from applications (only from related classes in the framework)
            */
-          constructor();
+          protected constructor();
           /**
            * The launchpad states that can be passed as a parameter.
            *
@@ -7580,7 +7869,7 @@ declare namespace sap {
            * @since 1.48
            * @deprecated (since 1.52)
            *
-           * @returns jQuery.deferred.promise object that when resolved, returns the newly created control
+           * @returns Resolves with the newly created control
            */
           addFloatingButton(
             /**
@@ -7600,7 +7889,7 @@ declare namespace sap {
              * in which to add the control.
              */
             oParameters: object
-          ): object;
+          ): jQuery.Promise;
           /**
            * 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.
@@ -7875,7 +8164,7 @@ declare namespace sap {
            *
            * @since 1.48
            *
-           * @returns jQuery.Deferred.promise object that when resolved, returns the newly created control
+           * @returns Resolves with the newly created control
            */
           addShellSubHeader(
             /**
@@ -7933,7 +8222,7 @@ declare namespace sap {
            *
            * @since 1.48
            *
-           * @returns jQuery.Deferred.promise object that when resolved, returns the newly created control.
+           * @returns Resolves with the newly created control
            */
           addSidePaneContent(
             /**
@@ -8102,7 +8391,7 @@ declare namespace sap {
            *
            * @since 1.48
            *
-           * @returns jQuery.Deferred.promise object that when resolved, returns the newly created control
+           * @returns Resolves with the newly created control
            */
           addUserAction(
             /**
@@ -8175,14 +8464,14 @@ declare namespace sap {
                */
               title: string;
               /**
-               * A function to be called that returns a {jQuery.Deferred.promise} object which consists of a {sap.ui.core.Control }
+               * A function to be called that returns a {@link jQuery.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 }
+               * A function to be called which returns a {@link jQuery.Promise} object when the user clicks "save" in
+               * the User Preferences dialog box. If an error occurs, pass the error message via the {@link jQuery.Promise }
                * object. Errors are displayed in the log.
                */
               onSave: Function;
@@ -8197,7 +8486,7 @@ declare namespace sap {
               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 }
+             * A string to be presented as the value of the entry OR a function to be called which returns a {@link jQuery.Promise }
              * object.
              */
             value: string | Function
@@ -8573,7 +8862,7 @@ declare namespace sap {
            *
            * @since 1.48
            *
-           * @returns jQuery.deferred.promise object that when resolved, returns the newly created control
+           * @returns Resolves with the newly created control
            */
           setShellFooter(
             /**
@@ -8863,6 +9152,21 @@ declare namespace sap {
             | string
             | sap.ui.base.ManagedObject.PropertyBindingInfo;
 
+          /**
+           * Specifies the contentProviderLabel of the appBox.
+           */
+          contentProviderLabel?:
+            | string
+            | sap.ui.base.ManagedObject.PropertyBindingInfo;
+
+          /**
+           * Specifies the if the contentProviderLabel of the appBox is shown.
+           */
+          showContentProviderLabel?:
+            | boolean
+            | sap.ui.base.ManagedObject.PropertyBindingInfo
+            | `{${string}}`;
+
           /**
            * The pinButton aggregation that can contain the pin button.
            */
@@ -8884,14 +9188,12 @@ declare namespace sap {
         interface AppBox$PressEventParameters {}
 
         /**
-         * Add your documentation for the new ui/appfinder/AppBox
+         * Constructor for a new ui/appfinder/AppBox.
          *
          * @deprecated (since 1.120)
          */
         class AppBox extends sap.ui.core.Control {
           /**
-           * Constructor for a new ui/appfinder/AppBox.
-           *
            * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
            * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
            * of the syntax of the settings object.
@@ -8899,12 +9201,12 @@ declare namespace sap {
           constructor(
             /**
              * initial settings for the new control
+             *
+             * Add your documentation for the new ui/appfinder/AppBox
              */
             mSettings?: sap.ushell.ui.appfinder.$AppBoxSettings
           );
           /**
-           * Constructor for a new ui/appfinder/AppBox.
-           *
            * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
            * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
            * of the syntax of the settings object.
@@ -8916,6 +9218,8 @@ declare namespace sap {
             sId?: string,
             /**
              * initial settings for the new control
+             *
+             * Add your documentation for the new ui/appfinder/AppBox
              */
             mSettings?: sap.ushell.ui.appfinder.$AppBoxSettings
           );
@@ -9117,6 +9421,17 @@ declare namespace sap {
              */
             mParameters?: object
           ): this;
+          /**
+           * Gets current value of property {@link #getContentProviderLabel contentProviderLabel}.
+           *
+           * Specifies the contentProviderLabel of the appBox.
+           *
+           * Default value is `empty string`.
+           *
+           *
+           * @returns Value of property `contentProviderLabel`
+           */
+          getContentProviderLabel(): string;
           /**
            * Gets current value of property {@link #getIcon icon}.
            *
@@ -9141,6 +9456,17 @@ declare namespace sap {
            * The pinButton aggregation that can contain the pin button.
            */
           getPinButton(): sap.m.Button;
+          /**
+           * Gets current value of property {@link #getShowContentProviderLabel showContentProviderLabel}.
+           *
+           * Specifies the if the contentProviderLabel of the appBox is shown.
+           *
+           * Default value is `false`.
+           *
+           *
+           * @returns Value of property `showContentProviderLabel`
+           */
+          getShowContentProviderLabel(): boolean;
           /**
            * Gets current value of property {@link #getSubtitle subtitle}.
            *
@@ -9168,6 +9494,24 @@ declare namespace sap {
            * @returns Value of property `url`
            */
           getUrl(): string;
+          /**
+           * Sets a new value for property {@link #getContentProviderLabel contentProviderLabel}.
+           *
+           * Specifies the contentProviderLabel of the appBox.
+           *
+           * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+           *
+           * Default value is `empty string`.
+           *
+           *
+           * @returns Reference to `this` in order to allow method chaining
+           */
+          setContentProviderLabel(
+            /**
+             * New value for property `contentProviderLabel`
+             */
+            sContentProviderLabel?: string
+          ): this;
           /**
            * Sets a new value for property {@link #getIcon icon}.
            *
@@ -9212,6 +9556,24 @@ declare namespace sap {
              */
             oPinButton: sap.m.Button
           ): this;
+          /**
+           * Sets a new value for property {@link #getShowContentProviderLabel showContentProviderLabel}.
+           *
+           * Specifies the if the contentProviderLabel of the appBox is shown.
+           *
+           * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+           *
+           * Default value is `false`.
+           *
+           *
+           * @returns Reference to `this` in order to allow method chaining
+           */
+          setShowContentProviderLabel(
+            /**
+             * New value for property `showContentProviderLabel`
+             */
+            bShowContentProviderLabel?: boolean
+          ): this;
           /**
            * Sets a new value for property {@link #getSubtitle subtitle}.
            *
@@ -9956,10 +10318,11 @@ declare namespace sap {
 
         interface TileState$PressEventParameters {}
 
+        /**
+         * Constructor for a new ui/launchpad/ActionItem.
+         */
         class ActionItem extends sap.m.Button {
           /**
-           * Constructor for a new ui/launchpad/ActionItem.
-           *
            * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
            * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
            * of the syntax of the settings object.
@@ -9971,8 +10334,6 @@ declare namespace sap {
             mSettings?: sap.ushell.ui.launchpad.$ActionItemSettings
           );
           /**
-           * Constructor for a new ui/launchpad/ActionItem.
-           *
            * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
            * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
            * of the syntax of the settings object.
@@ -10201,12 +10562,12 @@ declare namespace sap {
           ): this;
         }
         /**
+         * Constructor for "sap.ushell.ui.launchpad.DashboardGroupsContainer".
+         *
          * @deprecated (since 1.120)
          */
         class DashboardGroupsContainer extends sap.ui.core.Control {
           /**
-           * Constructor for "sap.ushell.ui.launchpad.DashboardGroupsContainer".
-           *
            * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
            * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
            * of the syntax of the settings object.
@@ -10218,8 +10579,6 @@ declare namespace sap {
             mSettings?: sap.ushell.ui.launchpad.$DashboardGroupsContainerSettings
           );
           /**
-           * Constructor for "sap.ushell.ui.launchpad.DashboardGroupsContainer".
-           *
            * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
            * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
            * of the syntax of the settings object.
@@ -10471,13 +10830,13 @@ declare namespace sap {
           ): this;
         }
         /**
+         * Constructor for a new ui/launchpad/LinkTileWrapper. A link tile to be displayed in the tile container.
+         * This control acts as container for specialized tile implementations.
+         *
          * @deprecated (since 1.120)
          */
         class LinkTileWrapper extends sap.ui.core.Control {
           /**
-           * Constructor for a new ui/launchpad/LinkTileWrapper. A link tile to be displayed in the tile container.
-           * This control acts as container for specialized tile implementations.
-           *
            * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
            * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
            * of the syntax of the settings object.
@@ -10489,9 +10848,6 @@ declare namespace sap {
             mSettings?: sap.ushell.ui.launchpad.$LinkTileWrapperSettings
           );
           /**
-           * Constructor for a new ui/launchpad/LinkTileWrapper. A link tile to be displayed in the tile container.
-           * This control acts as container for specialized tile implementations.
-           *
            * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
            * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
            * of the syntax of the settings object.
@@ -11231,13 +11587,13 @@ declare namespace sap {
           ): this;
         }
         /**
+         * Constructor for a new ui/launchpad/TileState. The tile state control that displays loading indicator,
+         * while tile view is loading and failed status in case tile view is not available.
+         *
          * @deprecated (since 1.120)
          */
         class TileState extends sap.ui.core.Control {
           /**
-           * Constructor for a new ui/launchpad/TileState. The tile state control that displays loading indicator,
-           * while tile view is loading and failed status in case tile view is not available.
-           *
            * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
            * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
            * of the syntax of the settings object.
@@ -11249,9 +11605,6 @@ declare namespace sap {
             mSettings?: sap.ushell.ui.launchpad.$TileStateSettings
           );
           /**
-           * Constructor for a new ui/launchpad/TileState. The tile state control that displays loading indicator,
-           * while tile view is loading and failed status in case tile view is not available.
-           *
            * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
            * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
            * of the syntax of the settings object.
@@ -11398,6 +11751,41 @@ declare namespace sap {
             sState?: string
           ): this;
         }
+        /**
+         * Denotes display states of the viewport
+         *
+         * This enum is part of the 'sap/ushell/library' module export and must be accessed by the property 'ui.launchpad.ViewPortState'.
+         */
+        enum ViewPortState {
+          /**
+           * Indicates state, when only center content is in the viewport.
+           */
+          Center = "Center",
+          /**
+           * Indicates state, when the center content as well as a part from the left content is in the viewport.
+           */
+          CenterLeft = "CenterLeft",
+          /**
+           * Indicates state, when the center content as well as a part from the right content is in the viewport.
+           */
+          CenterRight = "CenterRight",
+          /**
+           * Indicates state, when only left content is in the viewport.
+           */
+          Left = "Left",
+          /**
+           * Indicates state, when the left content as well as a part from the center content is in the viewport.
+           */
+          LeftCenter = "LeftCenter",
+          /**
+           * Indicates state, when only right content is in the viewport.
+           */
+          Right = "Right",
+          /**
+           * Indicates state, when the right content as well as a part from the center content is in the viewport.
+           */
+          RightCenter = "RightCenter",
+        }
 
         type ActionItem$AfterRenderingEvent = sap.ui.base.Event<
           ActionItem$AfterRenderingEventParameters,
@@ -11903,15 +12291,14 @@ declare namespace sap {
 
       namespace tile {
         /**
-         * An applauncher tile for simple, static apps, displaying title, subtitle, an icon and additional information
+         * Constructor for a new ui/tile/StaticTile. An applauncher tile for simple, static apps, displaying title,
+         * subtitle, an icon and additional information
          *
          * @since 1.15.0
          * @deprecated (since 1.120)
          */
         class StaticTile /* was: sap.ushell.ui.tile.TileBase */ extends Object {
           /**
-           * Constructor for a new ui/tile/StaticTile.
-           *
            * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
            * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
            * of the syntax of the settings object.
@@ -11966,44 +12353,6 @@ declare namespace sap {
     }
 
     namespace ui5service {
-      /**
-       * @deprecated (since 1.70) - Support for this service has been discontinued.
-       */
-      interface UserStatus
-        extends /* was: sap.ui.core.service.Service */ Object {
-        /**
-         * Creates a new subclass of class sap.ushell.ui5service.UserStatus with name `sClassName` and enriches
-         * it with the information contained in `oClassInfo`.
-         *
-         * `oClassInfo` might contain the same kind of information as described in {@link sap.ui.core.service.Service.extend}.
-         *
-         *
-         * @returns Created class / constructor function
-         */
-        extend(
-          /**
-           * Name of the class being created
-           */
-          sClassName: string,
-          /**
-           * Object literal with information about the class
-           */
-          oClassInfo?: object,
-          /**
-           * Constructor function for the metadata object; if not given, it defaults to the metadata implementation
-           * used by this class
-           */
-          FNMetaImpl?: Function
-        ): Function;
-        /**
-         * Returns a metadata object for class sap.ushell.ui5service.UserStatus.
-         *
-         *
-         * @returns Metadata object describing this class
-         */
-        getMetadata(): sap.ui.base.Metadata;
-      }
-
       /**
        * The Unified Shell's ShellUIService service.
        *
@@ -12032,7 +12381,7 @@ declare namespace sap {
        *
        * // Component.js (the app root component)
        * ...
-       * this.getServiceAsync("ShellUIService").then( // promise is returned
+       * this.getService("ShellUIService").then( // promise is returned
        *    function (oService) {
        *       oService.setTitle("Application Title");
        *    },
@@ -12227,16 +12576,113 @@ declare namespace sap {
           sTitle?: string
         ): void;
       }
-    }
+      /**
+       * @deprecated (since 1.70) - Support for this service has been discontinued.
+       */
+      class UserStatus /* was: sap.ui.core.service.Service */ extends Object {
+        constructor();
 
+        /**
+         * Creates a new subclass of class sap.ushell.ui5service.UserStatus with name `sClassName` and enriches
+         * it with the information contained in `oClassInfo`.
+         *
+         * `oClassInfo` might contain the same kind of information as described in {@link sap.ui.core.service.Service.extend}.
+         *
+         *
+         * @returns Created class / constructor function
+         */
+        static extend<T extends Record<string, unknown>>(
+          /**
+           * Name of the class being created
+           */
+          sClassName: string,
+          /**
+           * Object literal with information about the class
+           */
+          oClassInfo?: sap.ClassInfo<T, sap.ushell.ui5service.UserStatus>,
+          /**
+           * Constructor function for the metadata object; if not given, it defaults to the metadata implementation
+           * used by this class
+           */
+          FNMetaImpl?: Function
+        ): Function;
+        /**
+         * Returns a metadata object for class sap.ushell.ui5service.UserStatus.
+         *
+         *
+         * @returns Metadata object describing this class
+         */
+        static getMetadata(): sap.ui.base.Metadata;
+        /**
+         * Attaches an event handler fnFunction to be called upon the 'statusChanged' event. Event is fired when
+         * the setStatus method is called.
+         *
+         * @since 1.46
+         * @deprecated (since 1.70)
+         */
+        attachStatusChanged(
+          /**
+           * The function to be called when the event occurs.
+           */
+          fnFunction?: Function
+        ): void;
+        /**
+         * Detaches an event handler from the 'statusChanged' event.
+         *
+         * @since 1.46
+         * @deprecated (since 1.70)
+         */
+        detachStatusChanged(
+          /**
+           * Event handler to be detached.
+           */
+          fnFunction: Function
+        ): void;
+        /**
+         * Enable the User Status service (online status)
+         *
+         * If the user has never agreed to share their online status, then the method will show the opt-in screen
+         * to the user. If the user already agreed to share their online status, the setStatus method will be called
+         * with the default online status that was set by the user. If the user already declined to share their
+         * online status, the setStatus method will be called with a null value.
+         *
+         * @since 1.46
+         * @deprecated (since 1.70)
+         */
+        setEnabled(
+          /**
+           * boolean.
+           */
+          bEnable: boolean
+        ): void;
+        /**
+         * Publish the user status. This method is used to publish the status to other components.
+         *
+         * The publication of the status by firing the 'statusChanged' event will happen when all the following
+         * apply: 1) the User Status service is enabled 2) the status is null or exists in the list of available
+         * statuses (sap.ushell.ui5service.UserStatus.prototype.AvailableStatus) 3) the user has agreed to share
+         * their online status
+         *
+         * @since 1.46
+         * @deprecated (since 1.70)
+         */
+        setStatus(
+          /**
+           * sap.ushell.ui5service.UserStatus.prototype.AvailableStatus
+           */
+          oNewStatus: object
+        ): void;
+      }
+    }
     /**
      * The Unified Shell's container. Manages renderers, services, and adapters. The container is designed to
      * be a singleton, therefore instead of creating an instance, access the central one via `sap.ushell.Container`.
+     * See:
+     * 	sap.ushell.bootstrap
      *
      * @since 1.15.0
      */
-    class Container {
-      constructor();
+    interface Container {
       /**
        * An enumeration for the application work protect mode state.
        *
@@ -12293,7 +12739,7 @@ declare namespace sap {
        * let all pending requests for the current realm fail. As a side-effect, it also calls `destroy` on the
        * logon frame provider.
        * See:
-       * 	sap.ushell.services.Container#setLogonFrameProvider
+       * 	sap.ushell.Container#setLogonFrameProvider
        *
        * @since 1.21.2
        * @deprecated (since 1.120)
@@ -12393,9 +12839,9 @@ declare namespace sap {
        * @since 1.21.1
        * @deprecated (since 1.120)
        *
-       * @returns A `jQuery.Deferred` object's promise receiving the dirty state (see {@link sap.ushell.Container.DirtyState}).
+       * @returns Resolves the dirty state (see {@link sap.ushell.Container.DirtyState}).
        */
-      getGlobalDirty(): jQuery.Deferred;
+      getGlobalDirty(): jQuery.Promise;
       /**
        * Gets a renderer instance for the given renderer name, that was created by the createRenderer method.
        *
@@ -12475,7 +12921,7 @@ declare namespace sap {
        *
        * @returns the service or, in asynchronous mode, a Promise that returns the service
        */
-      getService(
+      getService<ServiceType extends sap.ushell.services.Service>(
         /**
          * The service name, such as "Menu"
          */
@@ -12488,7 +12934,7 @@ declare namespace sap {
          * if true, the adapter is loaded asynchronously and a Promise is returned. (since 1.55.0)
          */
         bAsync?: boolean
-      ): object | Promise<object>;
+      ): ServiceType | Promise<ServiceType>;
       /**
        * Returns a Promise that resolves a service with the given name, creating it if necessary. Services are
        * singleton objects identified by their (resulting) name.
@@ -12547,7 +12993,7 @@ declare namespace sap {
        *
        * @returns a Promise that returns the requested service
        */
-      getServiceAsync(
+      getServiceAsync<ServiceType extends sap.ushell.services.Service>(
         /**
          * The service name, such as "Menu"
          */
@@ -12556,18 +13002,7 @@ declare namespace sap {
          * A parameter which is passed to the service constructor and every adapter constructor.
          */
         sParameter?: string
-      ): Promise<object>;
-      /**
-       * 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
-       * the alternate logout function using registerLogout function.
-       *
-       * @since 1.15.0
-       * @deprecated (since 1.120)
-       *
-       * @returns A `jQuery.promise` to be resolved when logout is finished, even when it fails.
-       */
-      logout(): jQuery.Deferred;
+      ): Promise<ServiceType>;
       /**
        * 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
@@ -12609,15 +13044,14 @@ declare namespace sap {
         bIsDirty?: boolean
       ): void;
     }
+
     /**
-     * A representation of a system
+     * A representation of a system Constructs a new system object representing a system used in the Unified
+     * Shell.
      *
      * @since 1.15.0
      */
     class System {
-      /**
-       * Constructs a new system object representing a system used in the Unified Shell.
-       */
       constructor(
         /**
          * An object containing the system data
@@ -12641,6 +13075,8 @@ declare namespace sap {
     }
     /**
      * Denotes the types of the content nodes.
+     *
+     * This enum is part of the 'sap/ushell/library' module export and must be accessed by the property 'ContentNodeType'.
      */
     enum ContentNodeType {
       /**
@@ -12660,6 +13096,8 @@ declare namespace sap {
     }
     /**
      * The state of a navigation operation
+     *
+     * This enum is part of the 'sap/ushell/library' module export and must be accessed by the property 'NavigationState'.
      */
     enum NavigationState {
       Finished = "Finished",
@@ -12669,6 +13107,8 @@ declare namespace sap {
   }
 
   interface IUI5DefineDependencyNames {
+    "sap/ushell/api/RTA": undefined;
+
     "sap/ushell/components/factsheet/controls/PictureTile": undefined;
 
     "sap/ushell/components/factsheet/controls/PictureViewer": undefined;
@@ -12707,6 +13147,8 @@ declare namespace sap {
 
     "sap/ushell/services/Configuration": undefined;
 
+    "sap/ushell/services/ContentExtensionAdapterFactory": undefined;
+
     "sap/ushell/services/CrossApplicationNavigation": undefined;
 
     "sap/ushell/services/EndUserFeedback": undefined;
@@ -12717,8 +13159,6 @@ declare namespace sap {
 
     "sap/ushell/services/Extension/Footer": undefined;
 
-    "sap/ushell/services/Extension/Header": undefined;
-
     "sap/ushell/services/Extension/Item": undefined;
 
     "sap/ushell/services/Extension/SidePane": undefined;
@@ -12789,6 +13229,8 @@ declare namespace sap {
 
     "sap/ushell/ui/launchpad/TileState": undefined;
 
+    "sap/ushell/ui/launchpad/VizInstanceBase": undefined;
+
     "sap/ushell/ui/shell/ToolAreaItem": undefined;
 
     "sap/ushell/ui/tile/StaticTile": undefined;