@sapui5/ts-types-esm 1.139.0 → 1.140.0

package/types/sap.m.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.139.0
+// For Library Version: 1.140.0
 
 declare module "sap/f/library" {
   export interface IShellBar {
@@ -10,6 +10,353 @@ declare module "sap/f/library" {
   }
 }
 
+declare module "sap/m/p13n/Engine" {
+  import Control from "sap/ui/core/Control";
+
+  import { FilterStateItem } from "sap/m/p13n/FilterController";
+
+  import Event from "sap/ui/base/Event";
+
+  import Metadata from "sap/ui/base/Metadata";
+
+  import Popup from "sap/m/p13n/Popup";
+
+  import MetadataHelper from "sap/m/p13n/MetadataHelper";
+
+  import SelectionController from "sap/m/p13n/SelectionController";
+
+  /**
+   * The personalization state change event.
+   *
+   * @since 1.140.0
+   */
+  export type Engine$StateChangeEvent = {
+    /**
+     * Control for which the state change event was fired.
+     */
+    control?: Control;
+    /**
+     * Changed (delta) state of the control. The keys of the object refer to the controller keys used in the
+     * `Engine` registration. The values can be an array of any of the following types:
+     * 	 - {@link module:sap/m/p13n/Engine$StateChangeEventSelectionState StateChangeEventSelectionState}
+     * 	 - {@link module:sap/m/p13n/Engine$StateChangeEventSortState StateChangeEventSortState}
+     * 	 - {@link module:sap/m/p13n/Engine$StateChangeEventGroupState StateChangeEventGroupState}
+     * 	 - {@link module:sap/m/p13n/Engine$StateChangeEventFilterState StateChangeEventFilterState}
+     * 	 - Custom controller state definitions
+     */
+    state?: Record<
+      string,
+      | Engine$StateChangeEventSelectionState[]
+      | Engine$StateChangeEventSortState[]
+      | Engine$StateChangeEventGroupState[]
+      | Engine$StateChangeEventFilterState[]
+      | any[]
+    >;
+  };
+
+  /**
+   * The state for changes of the `FilterController`. The keys of the object are the filter keys used in the
+   * `Engine` registration. The values are arrays of {@link sap.ui.mdc.condition.ConditionObject ConditionObject}.
+   *
+   * @since 1.140.0
+   */
+  export type Engine$StateChangeEventFilterState = Record<
+    string,
+    FilterStateItem[]
+  >;
+
+  /**
+   * The state for changes of the `GroupController`.
+   *
+   * @since 1.140.0
+   */
+  export type Engine$StateChangeEventGroupState = {
+    /**
+     * The key of the affected group order
+     */
+    key: string;
+    /**
+     * The position of the group order
+     */
+    index: number;
+  };
+
+  /**
+   * The state for changes of the `SelectionController`.
+   *
+   * @since 1.140.0
+   */
+  export type Engine$StateChangeEventSelectionState = {
+    /**
+     * The key of the item affected
+     */
+    key: string;
+  };
+
+  /**
+   * The state for changes of the `SortController`.
+   *
+   * @since 1.140.0
+   */
+  export type Engine$StateChangeEventSortState = {
+    /**
+     * The key of the affected sort order
+     */
+    key: string;
+    /**
+     * The position of the sort order
+     */
+    index: number;
+    /**
+     * Indicates whether the sort order is descending
+     */
+    descending: boolean;
+  };
+
+  /**
+   * The `Engine` entity offers personalization capabilities by registering a control instance for modification,
+   * such as:
+   *
+   *
+   * 	 - `sap.m.p13n.Popup` initialization
+   * 	 - Storing personalization states by choosing the desired persistence layer
+   * 	 - State appliance considering the persistence layer
+   *
+   * The Engine must be used whenever personalization should be enabled by taking a certain persistence layer
+   * into account. Available controller implementations for the registration process are:
+   *
+   *
+   * 	 - {@link sap.m.p13n.SelectionController SelectionController}: Used to define a list of selectable entries
+   *
+   * 	 - {@link sap.m.p13n.SortController SortController}: Used to define a list of sortable properties
+   * 	 - {@link sap.m.p13n.GroupController GroupController}: Used to define a list of groupable properties
+   *
+   *
+   * Can be used in combination with `sap.ui.fl.variants.VariantManagement` to persist a state in variants
+   * using `sap.ui.fl` capabilities.
+   *
+   * @since 1.104
+   */
+  export default class Engine
+    extends /* was: sap.m.p13n.modules.AdaptationProvider */ Object
+  {
+    /**
+     * See:
+     * 	{@link https://ui5.sap.com/#/topic/75c08fdebf784575947927e052712bab Personalization}
+     */
+    constructor();
+
+    /**
+     * Creates a new subclass of class sap.m.p13n.Engine 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.m.p13n.modules.AdaptationProvider.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, Engine>,
+      /**
+       * Constructor function for the metadata object; if not given, it defaults to the metadata implementation
+       * used by this class
+       */
+      FNMetaImpl?: Function
+    ): Function;
+    /**
+     * This method is the central point of access to the Engine Singleton.
+     *
+     *
+     * @returns The Engine instance
+     */
+    static getInstance(): Engine;
+    /**
+     * Returns a metadata object for class sap.m.p13n.Engine.
+     *
+     *
+     * @returns Metadata object describing this class
+     */
+    static getMetadata(): Metadata;
+    /**
+     * Applies a state to a control by passing an object that contains the registered controller key and an
+     * object matching the inner subcontroller logic.
+     *
+     *
+     * @returns A Promise resolving after the state has been applied
+     */
+    applyState(
+      /**
+       * The registered control instance
+       */
+      oControl: Control,
+      /**
+       * The state object
+       */
+      oState: State
+    ): Promise<State>;
+    /**
+     * Attaches an event handler to the `StateHandlerRegistry` class. The event handler is fired every time
+     * a user triggers a personalization change for a control instance during runtime.
+     *
+     *
+     * @returns Returns `this` to allow method chaining
+     */
+    attachStateChange(
+      /**
+       * The handler function to call when the event occurs
+       */
+      fnStateEventHandler: (p1: Engine$StateChangeEvent) => void,
+      /**
+       * The context object to call the event handler with (value of `this` in the event handler function).
+       */
+      oListener?: object
+    ): this;
+    /**
+     * Unregisters a registered control. By unregistering a control the control is removed from the `Engine`
+     * registry, and all instance-specific submodules, such as the registered controllers, are destroyed.
+     */
+    deregister(
+      /**
+       * The registered control instance
+       */
+      oControl: Control
+    ): void;
+    /**
+     * Removes a previously attached state change event handler from the `StateHandlerRegistry` class. The passed
+     * parameters must match those used for registration with {@link sap.m.p13n.Engine#attachStateChange} beforehand.
+     *
+     *
+     * @returns Returns `this` to allow method chaining
+     */
+    detachStateChange(
+      /**
+       * The handler function to detach from the event
+       */
+      fnStateEventHandler: (p1: Event) => void,
+      /**
+       * The context object to call the event handler with (value of `this` in the event handler function).
+       */
+      oListener?: object
+    ): this;
+
+    register(
+      /**
+       * The control instance to be registered for adaptation
+       */
+      oControl: Control,
+      /**
+       * The Engine registration configuration
+       */
+      oConfig: EngineRegistrationConfig
+    ): void;
+    /**
+     * This method can be used to trigger a reset to the provided control instance.
+     *
+     *
+     * @returns A Promise resolving once the reset is completed
+     */
+    reset(
+      /**
+       * The related control instance
+       */
+      oControl: Control,
+      /**
+       * The key for the affected configuration
+       */
+      aKeys: string
+    ): Promise<null>;
+    /**
+     * Retrieves the state for a given control instance after all necessary changes have been applied (e.g.
+     * modification handler appliance). After the returned `Promise` has been resolved, the returned state is
+     * in sync with the related state object of the control.
+     *
+     *
+     * @returns A Promise resolving in the current control state
+     */
+    retrieveState(
+      /**
+       * The control instance implementing IxState to retrieve the externalized state
+       */
+      oControl: Control
+    ): Promise<State>;
+    /**
+     * Opens the personalization dialog.
+     *
+     *
+     * @returns Promise resolving in the `sap.m.p13n.Popup` instance
+     */
+    show(
+      /**
+       * The control instance that is personalized
+       */
+      oControl: Control,
+      /**
+       * The affected panels that are added to the `sap.m.p13n.Popup`
+       */
+      vPanelKeys: string | string[],
+      /**
+       * The settings object for the personalization
+       */
+      mSettings: {
+        /**
+         * The title for the `sap.m.p13n.Popup` control
+         */
+        title?: string;
+        /**
+         * The source control to be used by the `sap.m.p13n.Popup` control (only necessary if the mode is set to
+         * `ResponsivePopover`)
+         */
+        source?: Control;
+        /**
+         * The mode is used by the `sap.m.p13n.Popup` control
+         */
+        mode?: object;
+        /**
+         * Height configuration for the related popup container
+         */
+        contentHeight?: object;
+        /**
+         * Width configuration for the related popup container
+         */
+        contentWidth?: object;
+      }
+    ): Promise<Popup>;
+  }
+  /**
+   * The central registration for personalization functionality. The registration is a precondition for using
+   * `Engine` functionality for a control instance. Once the control instance has been registered, it can
+   * be passed to the related `Engine` methods that always expect a control instance as parameter. Only registered
+   * control instances can be used for personalization through the `Engine`.
+   */
+  export type EngineRegistrationConfig = {
+    /**
+     * The `{@link sap.m.p13n.MetadataHelper MetadataHelper}` to provide metadata-specific information. It may
+     * be used to define more granular information for the selection of items.
+     */
+    helper: MetadataHelper;
+    /**
+     * A map of arbitrary keys that contain a controller instance as value. The key must be unique and needs
+     * to be provided for later access when using `Engine` functionality specific for one controller type.
+     */
+    controller: Record<string, SelectionController>;
+  };
+
+  export type State = {
+    /**
+     * A map of arbitrary keys that contain a controller instance as value. The key must be unique and needs
+     * to be provided for later access when using `Engine` functionality specific for one controller type.
+     */
+    controller: Record<string, Object[]>;
+  };
+}
+
 declare module "sap/m/library" {
   import Control from "sap/ui/core/Control";
 
@@ -2869,6 +3216,27 @@ declare module "sap/m/library" {
      */
     None = "None",
   }
+  /**
+   * Enumeration for different separators for two columns layout when Select is in read-only mode.
+   *
+   * This enum is part of the 'sap/m/library' module export and must be accessed by the property 'SelectTwoColumnSeparator'.
+   *
+   * @since 1.140
+   */
+  export enum SelectTwoColumnSeparator {
+    /**
+     * Will show bullet(·) as separator on two columns layout when Select is in read-only mode.
+     */
+    Bullet = "Bullet",
+    /**
+     * Will show N-dash(–) as separator on two columns layout when Select is in read-only mode.
+     */
+    Dash = "Dash",
+    /**
+     * Will show vertical line(|) as separator on two columns layout when Select is in read-only mode.
+     */
+    VerticalLine = "VerticalLine",
+  }
   /**
    * Enumeration for different Select types.
    *
@@ -8010,6 +8378,66 @@ declare module "sap/m/AvatarBadgeColor" {
      * Accent 9
      */
     Accent9 = "Accent9",
+    /**
+     * Indication 1
+     *
+     * @since 1.140.0
+     */
+    Indication1 = "Indication1",
+    /**
+     * Indication 10
+     *
+     * @since 1.140.0
+     */
+    Indication10 = "Indication10",
+    /**
+     * Indication 2
+     *
+     * @since 1.140.0
+     */
+    Indication2 = "Indication2",
+    /**
+     * Indication 3
+     *
+     * @since 1.140.0
+     */
+    Indication3 = "Indication3",
+    /**
+     * Indication 4
+     *
+     * @since 1.140.0
+     */
+    Indication4 = "Indication4",
+    /**
+     * Indication 5
+     *
+     * @since 1.140.0
+     */
+    Indication5 = "Indication5",
+    /**
+     * Indication 6
+     *
+     * @since 1.140.0
+     */
+    Indication6 = "Indication6",
+    /**
+     * Indication 7
+     *
+     * @since 1.140.0
+     */
+    Indication7 = "Indication7",
+    /**
+     * Indication 8
+     *
+     * @since 1.140.0
+     */
+    Indication8 = "Indication8",
+    /**
+     * Indication 9
+     *
+     * @since 1.140.0
+     */
+    Indication9 = "Indication9",
   }
   export default AvatarBadgeColor;
 }
@@ -51589,12 +52017,12 @@ declare module "sap/m/ListBase" {
      * for the `selected` property of the item is not used. It also needs to be turned off if the binding context
      * of the item does not always point to the same entry in the model, for example, if the order of the data
      * in the `JSONModel` is changed. **Note:** This feature leverages the built-in selection mechanism of the
-     * corresponding binding context when the OData V4 model is used. Therefore, all binding-relevant limitations
+     * corresponding binding context if the OData V4 model is used. Therefore, all binding-relevant limitations
      * apply in this context as well. For more details, see the {@link sap.ui.model.odata.v4.Context#setSelected setSelected},
      * the {@link sap.ui.model.odata.v4.ODataModel#bindList bindList}, and the {@link sap.ui.model.odata.v4.ODataMetaModel#requestValueListInfo requestValueListInfo }
-     * API documentation. Do not enable this feature when `$$SharedRequests` or `$$clearSelectionOnFilter` is
-     * active. **Note:** If this property is set to `false`, a possible binding context update of items (for
-     * example, filtering or sorting the list binding) would clear the selection of the items.
+     * API documentation. Do not enable this feature if `$$sharedRequest` or `$$clearSelectionOnFilter` is active.
+     * **Note:** If this property is set to `false`, a possible binding context update of items (for example,
+     * filtering or sorting the list binding) would clear the selection of the items.
      *
      * Default value is `true`.
      *
@@ -52292,12 +52720,12 @@ declare module "sap/m/ListBase" {
      * for the `selected` property of the item is not used. It also needs to be turned off if the binding context
      * of the item does not always point to the same entry in the model, for example, if the order of the data
      * in the `JSONModel` is changed. **Note:** This feature leverages the built-in selection mechanism of the
-     * corresponding binding context when the OData V4 model is used. Therefore, all binding-relevant limitations
+     * corresponding binding context if the OData V4 model is used. Therefore, all binding-relevant limitations
      * apply in this context as well. For more details, see the {@link sap.ui.model.odata.v4.Context#setSelected setSelected},
      * the {@link sap.ui.model.odata.v4.ODataModel#bindList bindList}, and the {@link sap.ui.model.odata.v4.ODataMetaModel#requestValueListInfo requestValueListInfo }
-     * API documentation. Do not enable this feature when `$$SharedRequests` or `$$clearSelectionOnFilter` is
-     * active. **Note:** If this property is set to `false`, a possible binding context update of items (for
-     * example, filtering or sorting the list binding) would clear the selection of the items.
+     * API documentation. Do not enable this feature if `$$sharedRequest` or `$$clearSelectionOnFilter` is active.
+     * **Note:** If this property is set to `false`, a possible binding context update of items (for example,
+     * filtering or sorting the list binding) would clear the selection of the items.
      *
      * When called with a value of `null` or `undefined`, the default value of the property will be restored.
      *
@@ -52669,12 +53097,12 @@ declare module "sap/m/ListBase" {
      * for the `selected` property of the item is not used. It also needs to be turned off if the binding context
      * of the item does not always point to the same entry in the model, for example, if the order of the data
      * in the `JSONModel` is changed. **Note:** This feature leverages the built-in selection mechanism of the
-     * corresponding binding context when the OData V4 model is used. Therefore, all binding-relevant limitations
+     * corresponding binding context if the OData V4 model is used. Therefore, all binding-relevant limitations
      * apply in this context as well. For more details, see the {@link sap.ui.model.odata.v4.Context#setSelected setSelected},
      * the {@link sap.ui.model.odata.v4.ODataModel#bindList bindList}, and the {@link sap.ui.model.odata.v4.ODataMetaModel#requestValueListInfo requestValueListInfo }
-     * API documentation. Do not enable this feature when `$$SharedRequests` or `$$clearSelectionOnFilter` is
-     * active. **Note:** If this property is set to `false`, a possible binding context update of items (for
-     * example, filtering or sorting the list binding) would clear the selection of the items.
+     * API documentation. Do not enable this feature if `$$sharedRequest` or `$$clearSelectionOnFilter` is active.
+     * **Note:** If this property is set to `false`, a possible binding context update of items (for example,
+     * filtering or sorting the list binding) would clear the selection of the items.
      *
      * @since 1.16.6
      */
@@ -62163,6 +62591,12 @@ declare module "sap/m/MessageView" {
        */
       mSettings?: $MessageViewSettings
     );
+    /**
+     * Defines whether the custom header of details page will be shown.
+     *
+     * @ui5-protected DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+     */
+    _bShowCustomHeader: boolean;
 
     /**
      * Creates a new subclass of class sap.m.MessageView with name `sClassName` and enriches it with the information
@@ -62470,6 +62904,55 @@ declare module "sap/m/MessageView" {
        */
       oListener?: object
     ): this;
+    /**
+     * Attaches event handler `fnFunction` to the {@link #event:onClose onClose} event of this `sap.m.MessageView`.
+     *
+     * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
+     * otherwise it will be bound to this `sap.m.MessageView` itself.
+     *
+     * Event fired when the close button in custom header is clicked.
+     *
+     * @ui5-protected Do not call from applications (only from related classes in the framework)
+     *
+     * @returns Reference to `this` in order to allow method chaining
+     */
+    attachOnClose(
+      /**
+       * An application-specific payload object that will be passed to the event handler along with the event
+       * object when firing the event
+       */
+      oData: object,
+      /**
+       * The function to be called when the event occurs
+       */
+      fnFunction: (p1: Event) => void,
+      /**
+       * Context object to call the event handler with. Defaults to this `sap.m.MessageView` itself
+       */
+      oListener?: object
+    ): this;
+    /**
+     * Attaches event handler `fnFunction` to the {@link #event:onClose onClose} event of this `sap.m.MessageView`.
+     *
+     * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
+     * otherwise it will be bound to this `sap.m.MessageView` itself.
+     *
+     * Event fired when the close button in custom header is clicked.
+     *
+     * @ui5-protected Do not call from applications (only from related classes in the framework)
+     *
+     * @returns Reference to `this` in order to allow method chaining
+     */
+    attachOnClose(
+      /**
+       * The function to be called when the event occurs
+       */
+      fnFunction: (p1: Event) => void,
+      /**
+       * Context object to call the event handler with. Defaults to this `sap.m.MessageView` itself
+       */
+      oListener?: object
+    ): this;
     /**
      * Attaches event handler `fnFunction` to the {@link #event:urlValidated urlValidated} event of this `sap.m.MessageView`.
      *
@@ -62625,6 +63108,25 @@ declare module "sap/m/MessageView" {
        */
       oListener?: object
     ): this;
+    /**
+     * Detaches event handler `fnFunction` from the {@link #event:onClose onClose} event of this `sap.m.MessageView`.
+     *
+     * The passed function and listener object must match the ones used for event registration.
+     *
+     * @ui5-protected Do not call from applications (only from related classes in the framework)
+     *
+     * @returns Reference to `this` in order to allow method chaining
+     */
+    detachOnClose(
+      /**
+       * The function to be called, when the event occurs
+       */
+      fnFunction: (p1: Event) => void,
+      /**
+       * Context object on which the given function had to be called
+       */
+      oListener?: object
+    ): this;
     /**
      * Detaches event handler `fnFunction` from the {@link #event:urlValidated urlValidated} event of this `sap.m.MessageView`.
      *
@@ -62710,6 +63212,19 @@ declare module "sap/m/MessageView" {
        */
       mParameters?: object
     ): this;
+    /**
+     * Fires event {@link #event:onClose onClose} to attached listeners.
+     *
+     * @ui5-protected Do not call from applications (only from related classes in the framework)
+     *
+     * @returns Reference to `this` in order to allow method chaining
+     */
+    fireOnClose(
+      /**
+       * Parameters to pass along with the event
+       */
+      mParameters?: object
+    ): this;
     /**
      * Fires event {@link #event:urlValidated urlValidated} to attached listeners.
      *
@@ -62743,6 +63258,15 @@ declare module "sap/m/MessageView" {
      * @returns Value of property `asyncURLHandler`
      */
     getAsyncURLHandler(): Function;
+    /**
+     * Returns the close button used in the header of the MessageView. The button is only visible on non-phone
+     * devices and triggers the `onClose` event when pressed.
+     *
+     * @ui5-protected Do not call from applications (only from related classes in the framework)
+     *
+     * @returns The close button instance.
+     */
+    getCloseBtn(): Button;
     /**
      * Gets current value of property {@link #getGroupItems groupItems}.
      *
@@ -62809,6 +63333,17 @@ declare module "sap/m/MessageView" {
        */
       iIndex: int
     ): this;
+    /**
+     * Inserts a title into the given title container of the MessageView's header.
+     *
+     * @ui5-protected Do not call from applications (only from related classes in the framework)
+     */
+    insertTitle(
+      /**
+       * The parent control where the title should be inserted.
+       */
+      oTitleParent: Control
+    ): void;
     /**
      * Navigates back to the list page
      */
@@ -62916,6 +63451,13 @@ declare module "sap/m/MessageView" {
        */
       bShowDetailsPageHeader?: boolean
     ): this;
+    /**
+     * Sets up the header for the MessageView's ListPage based on the current configuration. If `showCustomHeader`
+     * is enabled, a custom header and a sub-header are applied. Otherwise, a standard list header is used.
+     *
+     * @ui5-protected Do not call from applications (only from related classes in the framework)
+     */
+    setupCustomHeader(): void;
   }
   /**
    * Describes the settings that can be provided to the MessageView constructor.
@@ -62991,6 +63533,13 @@ declare module "sap/m/MessageView" {
      * @since 1.58
      */
     activeTitlePress?: (oEvent: MessageView$ActiveTitlePressEvent) => void;
+
+    /**
+     * Event fired when the close button in custom header is clicked.
+     *
+     * @ui5-protected DO NOT USE IN APPLICATIONS (only for related classes in the framework)
+     */
+    onClose?: (oEvent: Event) => void;
   }
 
   /**
@@ -63087,6 +63636,19 @@ declare module "sap/m/MessageView" {
     MessageView
   >;
 
+  /**
+   * Parameters of the MessageView#onClose event.
+   */
+  export interface MessageView$OnCloseEventParameters {}
+
+  /**
+   * Event object of the MessageView#onClose event.
+   */
+  export type MessageView$OnCloseEvent = Event<
+    MessageView$OnCloseEventParameters,
+    MessageView
+  >;
+
   /**
    * Parameters of the MessageView#urlValidated event.
    */
@@ -76114,263 +76676,6 @@ declare module "sap/m/p13n/BasePanel" {
   >;
 }
 
-declare module "sap/m/p13n/Engine" {
-  import Control from "sap/ui/core/Control";
-
-  import Event from "sap/ui/base/Event";
-
-  import Metadata from "sap/ui/base/Metadata";
-
-  import Popup from "sap/m/p13n/Popup";
-
-  import MetadataHelper from "sap/m/p13n/MetadataHelper";
-
-  import SelectionController from "sap/m/p13n/SelectionController";
-
-  /**
-   * The `Engine` entity offers personalization capabilities by registering a control instance for modification,
-   * such as:
-   *
-   *
-   * 	 - `sap.m.p13n.Popup` initialization
-   * 	 - Storing personalization states by choosing the desired persistence layer
-   * 	 - State appliance considering the persistence layer
-   *
-   * The Engine must be used whenever personalization should be enabled by taking a certain persistence layer
-   * into account. Available controller implementations for the registration process are:
-   *
-   *
-   * 	 - {@link sap.m.p13n.SelectionController SelectionController}: Used to define a list of selectable entries
-   *
-   * 	 - {@link sap.m.p13n.SortController SortController}: Used to define a list of sortable properties
-   * 	 - {@link sap.m.p13n.GroupController GroupController}: Used to define a list of groupable properties
-   *
-   *
-   * Can be used in combination with `sap.ui.fl.variants.VariantManagement` to persist a state in variants
-   * using `sap.ui.fl` capabilities.
-   *
-   * @since 1.104
-   */
-  export default class Engine
-    extends /* was: sap.m.p13n.modules.AdaptationProvider */ Object
-  {
-    /**
-     * See:
-     * 	{@link https://ui5.sap.com/#/topic/75c08fdebf784575947927e052712bab Personalization}
-     */
-    constructor();
-
-    /**
-     * Creates a new subclass of class sap.m.p13n.Engine 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.m.p13n.modules.AdaptationProvider.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, Engine>,
-      /**
-       * Constructor function for the metadata object; if not given, it defaults to the metadata implementation
-       * used by this class
-       */
-      FNMetaImpl?: Function
-    ): Function;
-    /**
-     * This method is the central point of access to the Engine Singleton.
-     *
-     *
-     * @returns The Engine instance
-     */
-    static getInstance(): Engine;
-    /**
-     * Returns a metadata object for class sap.m.p13n.Engine.
-     *
-     *
-     * @returns Metadata object describing this class
-     */
-    static getMetadata(): Metadata;
-    /**
-     * Applies a state to a control by passing an object that contains the registered controller key and an
-     * object matching the inner subcontroller logic.
-     *
-     *
-     * @returns A Promise resolving after the state has been applied
-     */
-    applyState(
-      /**
-       * The registered control instance
-       */
-      oControl: Control,
-      /**
-       * The state object
-       */
-      oState: State
-    ): Promise<State>;
-    /**
-     * Attaches an event handler to the `StateHandlerRegistry` class. The event handler is fired every time
-     * a user triggers a personalization change for a control instance during runtime.
-     *
-     *
-     * @returns Returns `this` to allow method chaining
-     */
-    attachStateChange(
-      /**
-       * The handler function to call when the event occurs
-       */
-      fnStateEventHandler: (p1: Event) => void,
-      /**
-       * The context object to call the event handler with (value of `this` in the event handler function).
-       */
-      oListener?: object
-    ): this;
-    /**
-     * Unregisters a registered control. By unregistering a control the control is removed from the `Engine`
-     * registry, and all instance-specific submodules, such as the registered controllers, are destroyed.
-     */
-    deregister(
-      /**
-       * The registered control instance
-       */
-      oControl: Control
-    ): void;
-    /**
-     * Removes a previously attached state change event handler from the `StateHandlerRegistry` class. The passed
-     * parameters must match those used for registration with {@link sap.m.p13n.Engine#attachStateChange} beforehand.
-     *
-     *
-     * @returns Returns `this` to allow method chaining
-     */
-    detachStateChange(
-      /**
-       * The handler function to detach from the event
-       */
-      fnStateEventHandler: (p1: Event) => void,
-      /**
-       * The context object to call the event handler with (value of `this` in the event handler function).
-       */
-      oListener?: object
-    ): this;
-
-    register(
-      /**
-       * The control instance to be registered for adaptation
-       */
-      oControl: Control,
-      /**
-       * The Engine registration configuration
-       */
-      oConfig: EngineRegistrationConfig
-    ): void;
-    /**
-     * This method can be used to trigger a reset to the provided control instance.
-     *
-     *
-     * @returns A Promise resolving once the reset is completed
-     */
-    reset(
-      /**
-       * The related control instance
-       */
-      oControl: Control,
-      /**
-       * The key for the affected configuration
-       */
-      aKeys: string
-    ): Promise<null>;
-    /**
-     * Retrieves the state for a given control instance after all necessary changes have been applied (e.g.
-     * modification handler appliance). After the returned `Promise` has been resolved, the returned state is
-     * in sync with the related state object of the control.
-     *
-     *
-     * @returns A Promise resolving in the current control state
-     */
-    retrieveState(
-      /**
-       * The control instance implementing IxState to retrieve the externalized state
-       */
-      oControl: Control
-    ): Promise<State>;
-    /**
-     * Opens the personalization dialog.
-     *
-     *
-     * @returns Promise resolving in the `sap.m.p13n.Popup` instance
-     */
-    show(
-      /**
-       * The control instance that is personalized
-       */
-      oControl: Control,
-      /**
-       * The affected panels that are added to the `sap.m.p13n.Popup`
-       */
-      vPanelKeys: string | string[],
-      /**
-       * The settings object for the personalization
-       */
-      mSettings: {
-        /**
-         * The title for the `sap.m.p13n.Popup` control
-         */
-        title?: string;
-        /**
-         * The source control to be used by the `sap.m.p13n.Popup` control (only necessary if the mode is set to
-         * `ResponsivePopover`)
-         */
-        source?: Control;
-        /**
-         * The mode is used by the `sap.m.p13n.Popup` control
-         */
-        mode?: object;
-        /**
-         * Height configuration for the related popup container
-         */
-        contentHeight?: object;
-        /**
-         * Width configuration for the related popup container
-         */
-        contentWidth?: object;
-      }
-    ): Promise<Popup>;
-  }
-  /**
-   * The central registration for personalization functionality. The registration is a precondition for using
-   * `Engine` functionality for a control instance. Once the control instance has been registered, it can
-   * be passed to the related `Engine` methods that always expect a control instance as parameter. Only registered
-   * control instances can be used for personalization through the `Engine`.
-   */
-  export type EngineRegistrationConfig = {
-    /**
-     * The `{@link sap.m.p13n.MetadataHelper MetadataHelper}` to provide metadata-specific information. It may
-     * be used to define more granular information for the selection of items.
-     */
-    helper: MetadataHelper;
-    /**
-     * A map of arbitrary keys that contain a controller instance as value. The key must be unique and needs
-     * to be provided for later access when using `Engine` functionality specific for one controller type.
-     */
-    controller: Record<string, SelectionController>;
-  };
-
-  export type State = {
-    /**
-     * A map of arbitrary keys that contain a controller instance as value. The key must be unique and needs
-     * to be provided for later access when using `Engine` functionality specific for one controller type.
-     */
-    controller: Record<string, Object[]>;
-  };
-}
-
 declare module "sap/m/p13n/FilterController" {
   import SelectionController from "sap/m/p13n/SelectionController";
 
@@ -95518,6 +95823,9 @@ declare module "sap/m/plugins/CopyProvider" {
      * This can be useful for maintaining the original structure of the data when it is pasted into a new location
      * (e.g. spreadsheets).
      *
+     * **Note:** Sparse copying must not be enabled in combination with `sap.ui.table.plugins.ODataV4MultiSelection`
+     * or the `sap.ui.mdc.Table` with the `sap.ui.mdc.odata.v4.TableDelegate`.
+     *
      * Default value is `false`.
      *
      *
@@ -95632,6 +95940,9 @@ declare module "sap/m/plugins/CopyProvider" {
      * This can be useful for maintaining the original structure of the data when it is pasted into a new location
      * (e.g. spreadsheets).
      *
+     * **Note:** Sparse copying must not be enabled in combination with `sap.ui.table.plugins.ODataV4MultiSelection`
+     * or the `sap.ui.mdc.Table` with the `sap.ui.mdc.odata.v4.TableDelegate`.
+     *
      * When called with a value of `null` or `undefined`, the default value of the property will be restored.
      *
      * Default value is `false`.
@@ -95804,6 +96115,9 @@ declare module "sap/m/plugins/CopyProvider" {
      *
      * This can be useful for maintaining the original structure of the data when it is pasted into a new location
      * (e.g. spreadsheets).
+     *
+     * **Note:** Sparse copying must not be enabled in combination with `sap.ui.table.plugins.ODataV4MultiSelection`
+     * or the `sap.ui.mdc.Table` with the `sap.ui.mdc.odata.v4.TableDelegate`.
      */
     copySparse?: boolean | PropertyBindingInfo | `{${string}}`;
 
@@ -108419,15 +108733,26 @@ declare module "sap/m/routing/Router" {
   import TargetHandler from "sap/m/routing/TargetHandler";
 
   /**
-   * SAPUI5 mobile `Router`. The difference to the {@link sap.ui.core.routing.Router} are the `level`, `transition`,
-   * and `transitionParameters` properties that you can specify in every Route or Target created by this router.
+   * The `sap.m.routing.Router` is a specialized extension of `{@link sap.ui.core.routing.Router}`, designed
+   * specifically for the following containers in the `sap.m` library: `sap.m.App`, `sap.m.SplitApp`, or `sap.m.NavContainer`.
+   *
+   * It provides additional target and route configuration options that are optimized for the containers,
+   * including support for animated transitions and navigation hierarchy levels.
+   *
+   * Compared to `{@link sap.ui.core.routing.Router}`, it adds support for additional Target properties:
+   *
+   * 	 - `level`: Defines the hierarchical level of the target view for proper history and back navigation
+   *     handling
+   * 	 - `transition`: Specifies the type of transition animation between views (e.g., `slide`, `fade`)
+   * 	 - `transitionParameters`: Custom parameters for transitions
+   *
+   * For constructor parameters, see `{@link sap.ui.core.routing.Router#constructor}`.
    *
    * @since 1.28.1
    */
   export default class Router extends Router1 {
     /**
-     * Constructor for a new `sap.m.routing.Router`. See `{@link sap.ui.core.routing.Router}` for the constructor
-     * arguments.
+     * Constructor for a new `sap.m.routing.Router`.
      */
     constructor(
       /**
@@ -112056,6 +112381,7 @@ declare module "sap/m/Select" {
     IToolbarInteractiveControl,
     SelectColumnRatio,
     OverflowToolbarConfig,
+    SelectTwoColumnSeparator,
     SelectType,
   } from "sap/m/library";
 
@@ -112794,6 +113120,18 @@ declare module "sap/m/Select" {
      * @returns Value of property `textDirection`
      */
     getTextDirection(): TextDirection;
+    /**
+     * Gets current value of property {@link #getTwoColumnSeparator twoColumnSeparator}.
+     *
+     * Defines the separator type for the two columns layout when Select is in read-only mode.
+     *
+     * Default value is `Dash`.
+     *
+     * @since 1.140
+     *
+     * @returns Value of property `twoColumnSeparator`
+     */
+    getTwoColumnSeparator(): SelectTwoColumnSeparator;
     /**
      * Gets current value of property {@link #getType type}.
      *
@@ -113282,6 +113620,27 @@ declare module "sap/m/Select" {
        */
       sTextDirection?: TextDirection | keyof typeof TextDirection
     ): this;
+    /**
+     * Sets a new value for property {@link #getTwoColumnSeparator twoColumnSeparator}.
+     *
+     * Defines the separator type for the two columns layout when Select is in read-only mode.
+     *
+     * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+     *
+     * Default value is `Dash`.
+     *
+     * @since 1.140
+     *
+     * @returns Reference to `this` in order to allow method chaining
+     */
+    setTwoColumnSeparator(
+      /**
+       * New value for property `twoColumnSeparator`
+       */
+      sTwoColumnSeparator?:
+        | SelectTwoColumnSeparator
+        | keyof typeof SelectTwoColumnSeparator
+    ): this;
     /**
      * Sets a new value for property {@link #getType type}.
      *
@@ -113566,6 +113925,16 @@ declare module "sap/m/Select" {
      */
     required?: boolean | PropertyBindingInfo | `{${string}}`;
 
+    /**
+     * Defines the separator type for the two columns layout when Select is in read-only mode.
+     *
+     * @since 1.140
+     */
+    twoColumnSeparator?:
+      | (SelectTwoColumnSeparator | keyof typeof SelectTwoColumnSeparator)
+      | PropertyBindingInfo
+      | `{${string}}`;
+
     /**
      * Defines the items contained within this control.
      *
@@ -169202,6 +169571,8 @@ declare module "sap/m/VariantManagement" {
     ): this;
     /**
      * Enables the programmatic selection of a variant.
+     *
+     * @since 1.121
      */
     setCurrentVariantKey(
       /**