@sapui5/ts-types 1.120.0 → 1.120.2

package/types/sap.ui.core.d.ts

@@ -280,7 +280,7 @@ declare namespace sap {
   }
 }
 
-// For Library Version: 1.120.0
+// For Library Version: 1.120.2
 
 declare module "sap/base/assert" {
   /**
@@ -490,6 +490,17 @@ declare module "sap/base/i18n/Formatting" {
      * @returns the mapping between custom currencies and its digits
      */
     getCustomCurrencies(): object;
+    /**
+     * @since 1.120
+     *
+     * Returns the currently set customizing data for Islamic calendar support.
+     *
+     * See: {@link module:sap/base/i18n/Formatting.CustomIslamicCalendarData}
+     *
+     * @returns Returns an array that contains the customizing data. Each element in the array has properties:
+     * dateFormat, islamicMonthStart, gregDate. For details, please see {@link #.setCustomIslamicCalendarData}
+     */
+    getCustomIslamicCalendarData(): CustomIslamicCalendarData[] | undefined;
     /**
      * @since 1.120
      *
@@ -517,15 +528,6 @@ declare module "sap/base/i18n/Formatting" {
      * @returns the format LanguageTag
      */
     getLanguageTag(): LanguageTag;
-    /**
-     * @since 1.120
-     *
-     * Returns the currently set customizing data for Islamic calendar support
-     *
-     * @returns Returns an array contains the customizing data. Each element in the array has properties: dateFormat,
-     * islamicMonthStart, gregDate. For details, please see {@link #setLegacyDateCalendarCustomizing}
-     */
-    getLegacyDateCalendarCustomizing(): object[] | undefined;
     /**
      * @since 1.120
      *
@@ -690,6 +692,20 @@ declare module "sap/base/i18n/Formatting" {
        */
       mCurrencies: object
     ): void;
+    /**
+     * @since 1.120
+     *
+     * Allows to specify the customizing data for Islamic calendar support
+     *
+     * See: {@link module:sap/base/i18n/Formatting.CustomIslamicCalendarData}
+     */
+    setCustomIslamicCalendarData(
+      /**
+       * Contains the customizing data for the support of Islamic calendar. One JSON object in the array represents
+       * one row of data from Table TISLCAL
+       */
+      aCustomCalendarData: CustomIslamicCalendarData[]
+    ): void;
     /**
      * @since 1.120
      *
@@ -741,30 +757,6 @@ declare module "sap/base/i18n/Formatting" {
        */
       vLanguageTag: string | LanguageTag | null
     ): void;
-    /**
-     * @since 1.120
-     *
-     * Allows to specify the customizing data for Islamic calendar support
-     */
-    setLegacyDateCalendarCustomizing(
-      /**
-       * contains the customizing data for the support of Islamic calendar.
-       */
-      aMappings: Array<{
-        /**
-         * The date format
-         */
-        dateFormat: string;
-        /**
-         * The Islamic date
-         */
-        islamicMonthStart: string;
-        /**
-         * The corresponding Gregorian date
-         */
-        gregDate: string;
-      }>
-    ): void;
     /**
      * @since 1.120
      *
@@ -839,6 +831,24 @@ declare module "sap/base/i18n/Formatting" {
   const Formatting: Formatting;
   export default Formatting;
 
+  /**
+   * Customizing data for the support of Islamic calendar. Represents one row of data from Table TISLCAL.
+   */
+  export type CustomIslamicCalendarData = {
+    /**
+     * The date format. Column DATFM in TISLCAL.
+     */
+    dateFormat: "A" | "B";
+    /**
+     * The Islamic date in format: 'yyyyMMdd'. Column ISLMONTHSTART in TISLCAL.
+     */
+    islamicMonthStart: string;
+    /**
+     * The corresponding Gregorian date format: 'yyyyMMdd'. Column GREGDATE in TISLCAL.
+     */
+    gregDate: string;
+  };
+
   /**
    * @since 1.120
    *
@@ -849,9 +859,9 @@ declare module "sap/base/i18n/Formatting" {
    *
    * 	 - {@link module:sap/base/i18n/Formatting.setLanguageTag Formatting.setLanguageTag}:
    * 	`languageTag`
-   * 	 - {@link module:sap/base/i18n/Formatting.setLegacyDateCalendarCustomizing Formatting.setLegacyDateCalendarCustomizing}:
+   * 	 - {@link module:sap/base/i18n/Formatting.setCustomIslamicCalendarData Formatting.setCustomIslamicCalendarData}:
    *
-   * 	`legacyDateCalendarCustomizing`
+   * 	`customIslamicCalendarData`
    * 	 - {@link module:sap/base/i18n/Formatting.setCalendarWeekNumbering Formatting.setCalendarWeekNumbering}:
    *
    * 	`calendarWeekNumbering`
@@ -1193,8 +1203,7 @@ declare module "sap/base/i18n/Localization" {
      * 	 - date and number data types that are used in property bindings or composite bindings in existing Elements,
      *     Controls, UIAreas or Components
      * 	 - ResourceModels currently assigned to the Core, a UIArea, Component, Element or Control
-     * 	 - Elements or Controls that implement the `onlocalizationChanged` hook (note the lowercase 'l' in onlocalizationChanged)
-     *
+     * 	 - Elements or Controls that implement the `onLocalizationChanged` hook
      *
      * It furthermore derives the RTL mode from the new language, if no explicit RTL mode has been set. If the
      * RTL mode changes, the following additional actions will be taken:
@@ -3584,6 +3593,118 @@ declare module "sap/ui/core/AnimationMode" {
   export default AnimationMode;
 }
 
+declare module "sap/ui/core/ComponentRegistry" {
+  /**
+   * @since 1.120
+   *
+   * Registry of all `Component`s that currently exist.
+   */
+  interface ComponentRegistry {
+    /**
+     * Number of existing components.
+     */
+    size: int;
+
+    /**
+     * Return an object with all instances of `sap.ui.core.Component`, keyed by their ID.
+     *
+     * Each call creates a new snapshot object. Depending on the size of the UI, this operation therefore might
+     * be expensive. Consider to use the `forEach` or `filter` method instead of executing similar operations
+     * on the returned object.
+     *
+     * **Note**: The returned object is created by a call to `Object.create(null)`, and therefore lacks all
+     * methods of `Object.prototype`, e.g. `toString` etc.
+     *
+     * @returns Object with all components, keyed by their ID
+     */
+    all(): Record<sap.ui.core.ID, sap.ui.core.Component>;
+    /**
+     * Returns an array with components for which the given `callback` returns a value that coerces to `true`.
+     *
+     * The expected signature of the callback is
+     * ```javascript
+     *
+     *    function callback(oComponent, sID)
+     * ```
+     *  where `oComponent` is the currently visited component instance and `sID` is the ID of that instance.
+     *
+     * If components are created or destroyed within the `callback`, then the behavior is not specified. Newly
+     * added objects might or might not be visited. When a component is destroyed during the filtering and was
+     * not visited yet, it might or might not be visited. As the behavior for such concurrent modifications
+     * is not specified, it may change in newer releases.
+     *
+     * If a `thisArg` is given, it will be provided as `this` context when calling `callback`. The `this` value
+     * that the implementation of `callback` sees, depends on the usual resolution mechanism. E.g. when `callback`
+     * was bound to some context object, that object wins over the given `thisArg`.
+     *
+     * This function returns an array with all components matching the given predicate. The order of the components
+     * in the array is not specified and might change between calls (over time and across different versions
+     * of UI5).
+     *
+     * @returns Array of components matching the predicate; order is undefined and might change in newer versions
+     * of UI5
+     */
+    filter(
+      /**
+       * predicate against which each Component is tested
+       */
+      callback: (p1: sap.ui.core.Component, p2: sap.ui.core.ID) => boolean,
+      /**
+       * context object to provide as `this` in each call of `callback`
+       */
+      thisArg?: Object
+    ): sap.ui.core.Component[];
+    /**
+     * Calls the given `callback` for each existing component.
+     *
+     * The expected signature of the callback is
+     * ```javascript
+     *
+     *    function callback(oComponent, sID)
+     * ```
+     *  where `oComponent` is the currently visited component instance and `sID` is the ID of that instance.
+     *
+     * The order in which the callback is called for components is not specified and might change between calls
+     * (over time and across different versions of UI5).
+     *
+     * If components are created or destroyed within the `callback`, then the behavior is not specified. Newly
+     * added objects might or might not be visited. When a component is destroyed during the filtering and was
+     * not visited yet, it might or might not be visited. As the behavior for such concurrent modifications
+     * is not specified, it may change in newer releases.
+     *
+     * If a `thisArg` is given, it will be provided as `this` context when calling `callback`. The `this` value
+     * that the implementation of `callback` sees, depends on the usual resolution mechanism. E.g. when `callback`
+     * was bound to some context object, that object wins over the given `thisArg`.
+     */
+    forEach(
+      /**
+       * Function to call for each Component
+       */
+      callback: (p1: sap.ui.core.Component, p2: sap.ui.core.ID) => void,
+      /**
+       * Context object to provide as `this` in each call of `callback`
+       */
+      thisArg?: Object
+    ): void;
+    /**
+     * Retrieves a Component by its ID.
+     *
+     * When the ID is `null` or `undefined` or when there's no Component with the given ID, then `undefined`
+     * is returned.
+     *
+     * @returns Component with the given ID or `undefined`
+     */
+    get(
+      /**
+       * ID of the Component to retrieve
+       */
+      id: sap.ui.core.ID
+    ): sap.ui.core.Component | undefined;
+  }
+  const ComponentRegistry: ComponentRegistry;
+  export default ComponentRegistry;
+}
+
 declare module "sap/ui/core/ComponentSupport" {
   /**
    * @since 1.58.0
@@ -4343,6 +4464,118 @@ declare module "sap/ui/core/date/UI5Date" {
   }
 }
 
+declare module "sap/ui/core/ElementRegistry" {
+  /**
+   * @since 1.120
+   *
+   * Registry of all `sap.ui.core.Element`s that currently exist.
+   */
+  interface ElementRegistry {
+    /**
+     * Number of existing elements.
+     */
+    size: int;
+
+    /**
+     * Return an object with all instances of `sap.ui.core.Element`, keyed by their ID.
+     *
+     * Each call creates a new snapshot object. Depending on the size of the UI, this operation therefore might
+     * be expensive. Consider to use the `forEach` or `filter` method instead of executing similar operations
+     * on the returned object.
+     *
+     * **Note**: The returned object is created by a call to `Object.create(null)`, and therefore lacks all
+     * methods of `Object.prototype`, e.g. `toString` etc.
+     *
+     * @returns Object with all elements, keyed by their ID
+     */
+    all(): Record<sap.ui.core.ID, sap.ui.core.Element>;
+    /**
+     * Returns an array with elements for which the given `callback` returns a value that coerces to `true`.
+     *
+     * The expected signature of the callback is
+     * ```javascript
+     *
+     *    function callback(oElement, sID)
+     * ```
+     *  where `oElement` is the currently visited element instance and `sID` is the ID of that instance.
+     *
+     * If elements are created or destroyed within the `callback`, then the behavior is not specified. Newly
+     * added objects might or might not be visited. When an element is destroyed during the filtering and was
+     * not visited yet, it might or might not be visited. As the behavior for such concurrent modifications
+     * is not specified, it may change in newer releases.
+     *
+     * If a `thisArg` is given, it will be provided as `this` context when calling `callback`. The `this` value
+     * that the implementation of `callback` sees, depends on the usual resolution mechanism. E.g. when `callback`
+     * was bound to some context object, that object wins over the given `thisArg`.
+     *
+     * This function returns an array with all elements matching the given predicate. The order of the elements
+     * in the array is not specified and might change between calls (over time and across different versions
+     * of UI5).
+     *
+     * @returns Array of elements matching the predicate; order is undefined and might change in newer versions
+     * of UI5
+     */
+    filter(
+      /**
+       * predicate against which each element is tested
+       */
+      callback: (p1: sap.ui.core.Element, p2: sap.ui.core.ID) => boolean,
+      /**
+       * context object to provide as `this` in each call of `callback`
+       */
+      thisArg?: Object
+    ): sap.ui.core.Element[];
+    /**
+     * Calls the given `callback` for each element.
+     *
+     * The expected signature of the callback is
+     * ```javascript
+     *
+     *    function callback(oElement, sID)
+     * ```
+     *  where `oElement` is the currently visited element instance and `sID` is the ID of that instance.
+     *
+     * The order in which the callback is called for elements is not specified and might change between calls
+     * (over time and across different versions of UI5).
+     *
+     * If elements are created or destroyed within the `callback`, then the behavior is not specified. Newly
+     * added objects might or might not be visited. When an element is destroyed during the filtering and was
+     * not visited yet, it might or might not be visited. As the behavior for such concurrent modifications
+     * is not specified, it may change in newer releases.
+     *
+     * If a `thisArg` is given, it will be provided as `this` context when calling `callback`. The `this` value
+     * that the implementation of `callback` sees, depends on the usual resolution mechanism. E.g. when `callback`
+     * was bound to some context object, that object wins over the given `thisArg`.
+     */
+    forEach(
+      /**
+       * Function to call for each element
+       */
+      callback: (p1: sap.ui.core.Element, p2: sap.ui.core.ID) => void,
+      /**
+       * Context object to provide as `this` in each call of `callback`
+       */
+      thisArg?: Object
+    ): void;
+    /**
+     * Retrieves an Element by its ID.
+     *
+     * When the ID is `null` or `undefined` or when there's no element with the given ID, then `undefined` is
+     * returned.
+     *
+     * @returns Element with the given ID or `undefined`
+     */
+    get(
+      /**
+       * ID of the element to retrieve
+       */
+      id: sap.ui.core.ID
+    ): sap.ui.core.Element | undefined;
+  }
+  const ElementRegistry: ElementRegistry;
+  export default ElementRegistry;
+}
+
 declare module "sap/ui/core/getCompatibilityVersion" {
   import Version from "sap/base/util/Version";
 
@@ -5261,14 +5494,15 @@ declare module "sap/ui/model/FilterProcessor" {
      * Groups filters according to their path and combines filters on the same path using "OR" and filters on
      * different paths using "AND", all multi-filters contained are ANDed.
      *
-     * @returns Single Filter containing all filters of the array combined or undefined
+     * @returns A single filter containing all filters of the array combined or `undefined` if no filters are
+     * given
      */
     groupFilters(
       /**
-       * the filters to be grouped
+       * The filters to be grouped
        */
-      aFilters: sap.ui.model.Filter[]
-    ): sap.ui.model.Filter;
+      aFilters?: sap.ui.model.Filter[]
+    ): sap.ui.model.Filter | undefined;
   }
   const FilterProcessor: FilterProcessor;
   export default FilterProcessor;
@@ -18031,7 +18265,7 @@ declare namespace sap {
               /**
                * The message type
                */
-              type?: sap.ui.core.MessageType;
+              type?: import("sap/ui/core/message/MessageType").default;
               /**
                * The message code
                */
@@ -18208,7 +18442,7 @@ declare namespace sap {
            *
            * @returns type
            */
-          getType(): sap.ui.core.MessageType;
+          getType(): import("sap/ui/core/message/MessageType").default;
           /**
            * Sets the additionaltext for the message or merge different additionaltext strings
            */
@@ -18330,7 +18564,7 @@ declare namespace sap {
             /**
              * The Message type
              */
-            sType: sap.ui.core.MessageType
+            sType: import("sap/ui/core/message/MessageType").default
           ): void;
         }
         /**
@@ -20305,6 +20539,8 @@ declare namespace sap {
             sId: string
           ): sap.ui.core.Element | undefined;
           /**
+           * @deprecated (since 1.120) - please call the corresponding View factory instead, e.g. {@link sap.ui.core.mvc.XMLView.create}
+           *
            * Creates a clone of this view.
            *
            * Overrides the clone method to avoid conflicts between generic cloning of the content aggregation and
@@ -21154,6 +21390,7 @@ declare namespace sap {
       namespace Component {
         /**
          * @since 1.67
+         * @deprecated (since 1.120) - Use {@link module:sap/ui/core/ComponentRegistry} instead.
          *
          * Registry of all `Component`s that currently exist.
          */
@@ -21382,12 +21619,18 @@ declare namespace sap {
           /**
            * @since 1.120
            *
-           * Returns the currently set customizing data for Islamic calendar support
+           * Returns the currently set customizing data for Islamic calendar support.
+           *
+           * See: {@link module:sap/base/i18n/Formatting.CustomIslamicCalendarData}
            *
-           * @returns Returns an array contains the customizing data. Each element in the array has properties: dateFormat,
-           * islamicMonthStart, gregDate. For details, please see {@link #setLegacyDateCalendarCustomizing}
+           * @returns Returns an array that contains the customizing data. Each element in the array has properties:
+           * dateFormat, islamicMonthStart, gregDate. For details, please see {@link #.setCustomIslamicCalendarData}
            */
-          getLegacyDateCalendarCustomizing(): object[] | undefined;
+          getLegacyDateCalendarCustomizing():
+            | Array<
+                import("sap/base/i18n/Formatting").CustomIslamicCalendarData
+              >
+            | undefined;
           /**
            * @since 1.120
            *
@@ -21507,25 +21750,17 @@ declare namespace sap {
            * @since 1.120
            *
            * Allows to specify the customizing data for Islamic calendar support
+           *
+           * See: {@link module:sap/base/i18n/Formatting.CustomIslamicCalendarData}
            */
           setLegacyDateCalendarCustomizing(
             /**
-             * contains the customizing data for the support of Islamic calendar.
+             * Contains the customizing data for the support of Islamic calendar. One JSON object in the array represents
+             * one row of data from Table TISLCAL
              */
-            aMappings: Array<{
-              /**
-               * The date format
-               */
-              dateFormat: string;
-              /**
-               * The Islamic date
-               */
-              islamicMonthStart: string;
-              /**
-               * The corresponding Gregorian date
-               */
-              gregDate: string;
-            }>
+            aCustomCalendarData: Array<
+              import("sap/base/i18n/Formatting").CustomIslamicCalendarData
+            >
           ): void;
           /**
            * Allows to specify one of the legacy ABAP date formats.
@@ -21750,6 +21985,7 @@ declare namespace sap {
         }
         /**
          * @since 1.67
+         * @deprecated (since 1.120) - Use {@link module:sap/ui/core/ElementRegistry} instead.
          *
          * Registry of all `sap.ui.core.Element`s that currently exist.
          */
@@ -21840,6 +22076,20 @@ declare namespace sap {
              */
             thisArg?: Object
           ): void;
+          /**
+           * Retrieves an Element by its ID.
+           *
+           * When the ID is `null` or `undefined` or when there's no element with the given ID, then `undefined` is
+           * returned.
+           *
+           * @returns Element with the given ID or `undefined`
+           */
+          get(
+            /**
+             * ID of the element to retrieve
+             */
+            id: sap.ui.core.ID
+          ): sap.ui.core.Element | undefined;
         }
 
         /**
@@ -25586,6 +25836,8 @@ declare namespace sap {
         }
 
         /**
+         * @deprecated (since 1.120)
+         *
          * A SearchProvider which uses the OpenSearch protocol (either JSON or XML).
          */
         class OpenSearchProvider extends sap.ui.core.search.SearchProvider {
@@ -25721,6 +25973,8 @@ declare namespace sap {
           ): void;
         }
         /**
+         * @deprecated (since 1.120)
+         *
          * Abstract base class for all SearchProviders which can be e.g. attached to a SearchField.
          *
          * Do not create instances of this class, but use a concrete subclass instead.
@@ -27342,16 +27596,21 @@ declare namespace sap {
       namespace UIArea {
         /**
          * @since 1.107
+         * @deprecated (since 1.120)
          *
          * Registry of all `sap.ui.core.Element`s that currently exist.
          */
         interface registry {
           /**
+           * @deprecated (since 1.120)
+           *
            * Number of existing UIAreas.
            */
           size: int;
 
           /**
+           * @deprecated (since 1.120)
+           *
            * Return an object with all instances of `sap.ui.core.UIArea`, keyed by their ID.
            *
            * Each call creates a new snapshot object. Depending on the size of the UI, this operation therefore might
@@ -27365,6 +27624,8 @@ declare namespace sap {
            */
           all(): Record<sap.ui.core.ID, sap.ui.core.UIArea>;
           /**
+           * @deprecated (since 1.120)
+           *
            * Returns an array with UIAreas for which the given `callback` returns a value that coerces to `true`.
            *
            * The expected signature of the callback is
@@ -27401,6 +27662,8 @@ declare namespace sap {
             thisArg?: Object
           ): sap.ui.core.UIArea[];
           /**
+           * @deprecated (since 1.120)
+           *
            * Calls the given `callback` for each UIArea.
            *
            * The expected signature of the callback is
@@ -27433,6 +27696,8 @@ declare namespace sap {
             thisArg?: Object
           ): void;
           /**
+           * @deprecated (since 1.120)
+           *
            * Retrieves an UIArea by its ID.
            *
            * When the ID is `null` or `undefined` or when there's no UIArea with the given ID, then `undefined` is
@@ -32282,8 +32547,7 @@ declare namespace sap {
          * 	 - date and number data types that are used in property bindings or composite bindings in existing Elements,
          *     Controls, UIAreas or Components
          * 	 - ResourceModels currently assigned to the Core, a UIArea, Component, Element or Control
-         * 	 - Elements or Controls that implement the `onlocalizationChanged` hook (note the lowercase 'l' in onlocalizationChanged)
-         *
+         * 	 - Elements or Controls that implement the `onLocalizationChanged` hook
          *
          * It furthermore derives the RTL mode from the new language, if no explicit RTL mode has been set. If the
          * RTL mode changes, the following additional actions will be taken:
@@ -35028,6 +35292,8 @@ declare namespace sap {
         ): Function;
         /**
          * @since 1.56.0
+         * @deprecated (since 1.120) - please use the static {@link sap.ui.core.Component.getComponentById getComponentById }
+         * instead.
          *
          * Returns an existing component instance, identified by its ID.
          *
@@ -35039,6 +35305,19 @@ declare namespace sap {
            */
           sId: string
         ): sap.ui.core.Component | undefined;
+        /**
+         * @since 1.120
+         *
+         * Returns an existing component instance, identified by its ID.
+         *
+         * @returns Component instance or `undefined` when no component with the given ID exists.
+         */
+        static getComponentById(
+          /**
+           * ID of the component.
+           */
+          sId: string
+        ): sap.ui.core.Component | undefined;
         /**
          * Returns the metadata for the Component class.
          *
@@ -37631,18 +37910,24 @@ declare namespace sap {
          */
         static getActiveElement(): sap.ui.core.Element | undefined;
         /**
-         * Retrieves an Element by its ID.
+         * @since 1.119
+         *
+         * Returns the registered element with the given ID, if any.
          *
-         * When the ID is `null` or `undefined` or when there's no element with the given ID, then `undefined` is
-         * returned.
+         * The ID must be the globally unique ID of an element, the same as returned by `oElement.getId()`.
+         *
+         * When the element has been created from a declarative source (e.g. XMLView), that source might have used
+         * a shorter, non-unique local ID. A search for such a local ID cannot be executed with this method. It
+         * can only be executed on the corresponding scope (e.g. on an XMLView instance), by using the {@link sap.ui.core.mvc.View#byId View#byId }
+         * method of that scope.
          *
          * @returns Element with the given ID or `undefined`
          */
         static getElementById(
           /**
-           * ID of the element to retrieve
+           * ID of the element to search for
            */
-          id: sap.ui.core.ID
+          sId: sap.ui.core.ID | null | undefined
         ): sap.ui.core.Element | undefined;
         /**
          * Returns a metadata object for class sap.ui.core.Element.
@@ -38388,12 +38673,19 @@ declare namespace sap {
           oDelegate: object
         ): this;
         /**
-         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         * @deprecated (since 1.70) - using this method is no longer recommended, but still works. Synchronous DOM
+         * updates via this method have several drawbacks: they only work when the control has been rendered before
+         * (no initial rendering possible), multiple state changes won't be combined automatically into a single
+         * re-rendering, they might cause additional layout trashing, standard invalidation might cause another
+         * async re-rendering.
          *
-         * This triggers immediate rerendering of its parent and thus of itself and its children.
+         * The recommended alternative is to rely on invalidation and standard re-rendering.
          *
          * As `sap.ui.core.Element` "bubbles up" the rerender, changes to child-`Elements` will also result in immediate
          * rerendering of the whole sub tree.
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         *
+         * This triggers immediate rerendering of its parent and thus of itself and its children.
          */
         rerender(): void;
         /**
@@ -41752,35 +42044,33 @@ declare namespace sap {
         /**
          * Get month names in width "narrow", "abbreviated" or "wide".
          *
-         * @returns array of month names (starting with January)
+         * @returns The array of month names
          */
         getMonths(
           /**
-           * the required width for the month names
+           * The required width for the month names
            */
-          sWidth: string,
+          sWidth: "narrow" | "abbreviated" | "wide",
           /**
-           * the type of calendar. If it's not set, it falls back to the calendar type either set in configuration
-           * or calculated from locale.
+           * The type of calendar; defaults to the calendar type either set in configuration or calculated from locale
            */
           sCalendarType?: sap.ui.core.CalendarType
-        ): any[];
+        ): string[];
         /**
          * Get standalone month names in width "narrow", "abbreviated" or "wide".
          *
-         * @returns array of month names (starting with January)
+         * @returns The array of standalone month names
          */
         getMonthsStandAlone(
           /**
-           * the required width for the month names
+           * The required width for the month names
            */
-          sWidth: string,
+          sWidth: "narrow" | "abbreviated" | "wide",
           /**
-           * the type of calendar. If it's not set, it falls back to the calendar type either set in configuration
-           * or calculated from locale.
+           * The type of calendar; defaults to the calendar type either set in configuration or calculated from locale
            */
           sCalendarType?: sap.ui.core.CalendarType
-        ): any[];
+        ): string[];
         /**
          * Get number symbol "decimal", "group", "plusSign", "minusSign", "percentSign".
          *
@@ -42386,6 +42676,8 @@ declare namespace sap {
         ): string;
       }
       /**
+       * @deprecated (since 1.120) - Please use {@link sap.ui.core.message.Message} instead.
+       *
        * This element is used to provide messages.
        *
        * Rendering must be done within the control that uses this kind of element. Its default level is none.
@@ -47241,6 +47533,8 @@ declare namespace sap {
         Polite = "Polite",
       }
       /**
+       * @deprecated (since 1.120) - Please use {@link sap.ui.core.message.MessageType} instead.
+       *
        * Specifies possible message types.
        */
       enum MessageType {
@@ -56799,9 +57093,11 @@ declare namespace sap {
                  */
                 inactive?: boolean;
                 /**
-                 * An array that specifies a set of properties or the entry
+                 * The initial values of the entry, or an array that specifies a list of property names to be initialized
+                 * with `undefined`; **Note:** Passing a list of property names is deprecated since 1.120; pass the initial
+                 * values as an object instead
                  */
-                properties?: any[] | object;
+                properties?: object | string[];
                 /**
                  * Whether to update all bindings after submitting this change operation, see {@link #setRefreshAfterChange};
                  * if given, this overrules the model-wide `refreshAfterChange` flag for this operation only; since 1.46
@@ -58504,8 +58800,7 @@ declare namespace sap {
             context?: sap.ui.model.odata.v4.Context;
 
             /**
-             * Whether the POST was successfully processed; in case of an error, the error is already reported to the
-             * {@link sap.ui.core.message.MessageManager}
+             * Whether the POST was successfully processed; in case of an error, the error is already reported to {@link sap.ui.core.Messaging}
              */
             success?: boolean;
           }
@@ -59512,14 +59807,13 @@ declare namespace sap {
             /**
              * @experimental (since 1.120.0)
              *
-             * Returns the parent node (in case of a recursive hierarchy, see {@link #setAggregation}, where `oAggregation.expandTo`
-             * must be equal to one).
-             * See:
-             * 	#requestParent
+             * Returns the parent node (in case of a recursive hierarchy; see {@link sap.ui.model.odata.v4.ODataListBinding#setAggregation})
+             * or `undefined` if the parent of this node hasn't been read yet; it can then be requested via {@link #requestParent}.
              *
-             * @returns The parent node, or `null` if this node is a root node and thus has no parent
+             * @returns The parent node, or `null` if this node is a root node and thus has no parent, or `undefined`
+             * if the parent node hasn't been read yet
              */
-            getParent(): sap.ui.model.odata.v4.Context | null;
+            getParent(): sap.ui.model.odata.v4.Context | null | undefined;
             /**
              * @since 1.39.0
              *
@@ -59578,7 +59872,7 @@ declare namespace sap {
               /**
                * Some node which may be a descendant
                */
-              oNode: sap.ui.model.odata.v4.Context
+              oNode?: sap.ui.model.odata.v4.Context
             ): boolean;
             /**
              * @since 1.105.0
@@ -59663,9 +59957,10 @@ declare namespace sap {
              * @experimental (since 1.119.0)
              *
              * Moves this node to the given parent (in case of a recursive hierarchy, see {@link sap.ui.model.odata.v4.ODataListBinding#setAggregation},
-             * where `oAggregation.expandTo` must be one). No other {@link sap.ui.model.odata.v4.ODataListBinding#create creation},
+             * where `oAggregation.expandTo` must be either one or at least `Number.MAX_SAFE_INTEGER`). No other {@link sap.ui.model.odata.v4.ODataListBinding#create creation},
              * {@link #delete deletion}, or move must be pending, and no other modification (including collapse of some
-             * ancestor node) must happen while this move is pending!
+             * ancestor node) must happen while this move is pending! Omitting a new parent turns this node into a root
+             * node (since 1.121.0).
              *
              * This context's {@link #getIndex index} may change and it becomes "created persisted", with {@link #isTransient }
              * returning `false` etc.
@@ -59677,11 +59972,11 @@ declare namespace sap {
               /**
                * A parameter object
                */
-              oParameters: {
+              oParameters?: {
                 /**
                  * The new parent's context
                  */
-                parent: sap.ui.model.odata.v4.Context;
+                parent?: sap.ui.model.odata.v4.Context;
               }
             ): Promise<void>;
             /**
@@ -59763,8 +60058,9 @@ declare namespace sap {
             /**
              * @experimental (since 1.120.0)
              *
-             * Requests the parent node (in case of a recursive hierarchy, see {@link #setAggregation}, where `oAggregation.expandTo`
-             * must be equal to one).
+             * Requests the parent node (in case of a recursive hierarchy; see {@link sap.ui.model.odata.v4.ODataListBinding#setAggregation}).
+             *
+             * Note: **DO NOT** call {@link #setKeepAlive} on the resulting context!
              * See:
              * 	#getParent
              *
@@ -60751,12 +61047,12 @@ declare namespace sap {
              * parent's navigation property, which is sent with the payload of the parent entity. Such a nested context
              * cannot be inactive.
              *
-             * **Note:** After a succesful creation of the main entity the context returned for a nested entity is no
-             * longer valid. Do not use the {@link sap.ui.model.odata.v4.Context#created created} promise of such a
-             * context! New contexts are created for the nested collection because it is not possible to reliably assign
-             * the response entities to those of the request, especially if the count differs. For this reason, the
-             * `created` promises of all nested contexts are always rejected with an instance of `Error`, even if the
-             * deep create succeeds. This error always has the property `canceled` with the value `true`.
+             * **Note:** After a successful creation of the main entity the context returned for a nested entity is
+             * no longer valid. Do not use the {@link sap.ui.model.odata.v4.Context#created created} promise of such
+             * a context! New contexts are created for the nested collection because it is not possible to reliably
+             * assign the response entities to those of the request, especially if the count differs. For this reason,
+             * the `created` promises of all nested contexts are always rejected with an instance of `Error`, even if
+             * the deep create succeeds. This error always has the property `canceled` with the value `true`.
              *
              * Since 1.118.0 deep create also supports single-valued navigation properties; no API call is required
              * in this case. Simply bind properties of the related entity relative to a transient context. An update
@@ -60966,9 +61262,9 @@ declare namespace sap {
                * back to the setter (@experimental as of version 1.111.0). They are retrieved from the pair of "Org.OData.Aggregation.V1.RecursiveHierarchy"
                * and "com.sap.vocabularies.Hierarchy.v1.RecursiveHierarchy" annotations at this binding's entity type,
                * identified via the `hierarchyQualifier` given to {@link #setAggregation}.
-               * 	 "$DistanceFromRootProperty" holds the path to the property which provides the raw value for "@$ui5.node.level"
+               * 	 "$DistanceFromRoot" holds the path to the property which provides the raw value for "@$ui5.node.level"
                * (minus one) and should be used only to interpret the response retrieved via {@link #getDownloadUrl}.
-               *  "$DrillStateProperty" holds the path to the property which provides the raw value for "@$ui5.node.isExpanded"
+               *  "$DrillState" holds the path to the property which provides the raw value for "@$ui5.node.isExpanded"
                * and should be used only to interpret the response retrieved via {@link #getDownloadUrl}.  "$NodeProperty"
                * holds the path to the property which provides the hierarchy node value. That property is always $select'ed
                * automatically and can be accessed as usual.
@@ -61078,11 +61374,10 @@ declare namespace sap {
              * @since 1.74.0
              *
              * Returns a URL by which the complete content of the list can be downloaded in JSON format. The request
-             * delivers all entities considering the binding's query options (such as filters or sorters).
-             *
-             * The returned URL does not specify `$skip` and `$top` and leaves it up to the server how many rows it
-             * delivers. Many servers tend to choose a small limit without `$skip` and `$top`, so it might be wise to
-             * add an appropriate value for `$top` at least.
+             * delivers all entities considering the binding's query options (such as filters or sorters). Returns `null`
+             * if the binding's filter is {@link sap.ui.filter.Filter.NONE}. The returned URL does not specify `$skip`
+             * and `$top` and leaves it up to the server how many rows it delivers. Many servers tend to choose a small
+             * limit without `$skip` and `$top`, so it might be wise to add an appropriate value for `$top` at least.
              *
              * Additionally, you must be aware of server-driven paging and be ready to send a follow-up request if the
              * response contains `@odata.nextlink`.
@@ -61090,9 +61385,9 @@ declare namespace sap {
              * The URL cannot be determined synchronously in all cases; use {@link #requestDownloadUrl} to allow for
              * asynchronous determination then.
              *
-             * @returns The download URL
+             * @returns The download URL or `null`
              */
-            getDownloadUrl(): string;
+            getDownloadUrl(): string | null;
             /**
              * @since 1.81.0
              *
@@ -61324,8 +61619,9 @@ declare namespace sap {
             /**
              * @since 1.74.0
              *
-             * Returns a URL by which the complete content of the list can be downloaded in JSON format. The request
-             * delivers all entities considering the binding's query options (such as filters or sorters).
+             * Resolves with a URL by which the complete content of the list can be downloaded in JSON format. The request
+             * delivers all entities considering the binding's query options (such as filters or sorters). Resolves
+             * with `null` if the binding's filter is {@link sap.ui.filter.Filter.NONE}.
              *
              * The returned URL does not specify `$skip` and `$top` and leaves it up to the server how many rows it
              * delivers. Many servers tend to choose a small limit without `$skip` and `$top`, so it might be wise to
@@ -61336,9 +61632,9 @@ declare namespace sap {
              * See:
              * 	#getDownloadUrl
              *
-             * @returns A promise that is resolved with the download URL
+             * @returns A promise that is resolved with the download URL or `null`
              */
-            requestDownloadUrl(): Promise<string>;
+            requestDownloadUrl(): Promise<string | null>;
             /**
              * @since 1.86.0
              * @ui5-protected Do not call from applications (only from related classes in the framework)
@@ -61350,6 +61646,9 @@ declare namespace sap {
              * The resulting filter does not consider application or control filters specified for this list binding
              * in its constructor or in its {@link #filter} method; add filters which you want to keep with the "and"
              * conjunction to the resulting filter before calling {@link #filter}.
+             *
+             * If there are only messages for transient entries, the method returns {@link sap.ui.model.Filter.NONE}.
+             * Take care not to combine this filter with other filters.
              * See:
              * 	sap.ui.model.ListBinding#requestFilterForMessages
              *
@@ -61442,8 +61741,8 @@ declare namespace sap {
                  * The number (as a positive integer) of different levels initially available without calling {@link sap.ui.model.odata.v4.Context#expand }
                  * (@experimental as of version 1.105.0; available for read-only hierarchies since 1.117.0), supported only
                  * if a `hierarchyQualifier` is given. Root nodes are on the first level. By default, only root nodes are
-                 * available; they are not yet expanded. Since 1.120.0, `Number.MAX_SAFE_INTEGER` can be used to expand
-                 * all levels.
+                 * available; they are not yet expanded. Since 1.120.0, `expandTo >= Number.MAX_SAFE_INTEGER` can be used
+                 * to expand all levels (`1E16` is recommended inside XML views for simplicity).
                  */
                 expandTo?: number;
                 /**
@@ -70228,8 +70527,8 @@ declare namespace sap {
           oListener?: object
         ): void;
         /**
-         * Removes all control messages for this binding from the MessageManager in addition to the standard clean-up
-         * tasks.
+         * Removes all control messages for this binding from {@link sap.ui.core.Messaging} in addition to the standard
+         * clean-up tasks.
          * See:
          * 	sap.ui.base.EventProvider#destroy
          */
@@ -71463,7 +71762,7 @@ declare namespace sap {
          *
          * @returns The array of all messages
          */
-        getAllMessages(): sap.ui.core.Message[];
+        getAllMessages(): sap.ui.core.message.Message[];
         /**
          * Returns the changes of the data state in a map that the control can use in the `refreshDataState` method.
          * The changed property's name is the key in the map. Each element in the map contains an object of below
@@ -71492,7 +71791,7 @@ declare namespace sap {
          *
          * @returns The array of control messages
          */
-        getControlMessages(): sap.ui.core.Message[];
+        getControlMessages(): sap.ui.core.message.Message[];
         /**
          * @ui5-protected Do not call from applications (only from related classes in the framework)
          *
@@ -71519,13 +71818,13 @@ declare namespace sap {
          *
          * @returns The array of all messages
          */
-        getMessages(): sap.ui.core.Message[];
+        getMessages(): sap.ui.core.message.Message[];
         /**
          * Returns the array of current state messages of the model.
          *
          * @returns The array of messages of the model
          */
-        getModelMessages(): sap.ui.core.Message[];
+        getModelMessages(): sap.ui.core.message.Message[];
         /**
          * Returns whether the data state is dirty in the UI control. A data state is dirty in the UI control if
          * the entered value did not yet pass the type validation.
@@ -71963,7 +72262,7 @@ declare namespace sap {
          *
          * @returns The array of all messages
          */
-        getAllMessages(): sap.ui.core.Message[];
+        getAllMessages(): sap.ui.core.message.Message[];
         /**
          * Returns the changes of the data state in a map that the control can use in the `refreshDataState` method.
          * The changed property's name is the key in the map. Each element in the map contains an object with the
@@ -71978,7 +72277,7 @@ declare namespace sap {
          *
          * @returns The array of control messages
          */
-        getControlMessages(): sap.ui.core.Message[];
+        getControlMessages(): sap.ui.core.message.Message[];
         /**
          * Returns the dirty value of a binding that was rejected by a type validation so that it could not be applied
          * to the model. If the value was not rejected it returns `undefined`. In this case the current model value
@@ -71993,13 +72292,13 @@ declare namespace sap {
          *
          * @returns The sorted array of all messages
          */
-        getMessages(): sap.ui.core.Message[];
+        getMessages(): sap.ui.core.message.Message[];
         /**
          * Returns the array of this data state's current model messages.
          *
          * @returns The array of messages of the model
          */
-        getModelMessages(): sap.ui.core.Message[];
+        getModelMessages(): sap.ui.core.message.Message[];
         /**
          * Returns the formatted original value of the data. The original value is the last confirmed value.
          *
@@ -72044,7 +72343,7 @@ declare namespace sap {
           /**
            * The control messages
            */
-          aMessages: sap.ui.core.Message[]
+          aMessages: sap.ui.core.message.Message[]
         ): this;
         /**
          * @ui5-protected Do not call from applications (only from related classes in the framework)
@@ -72081,7 +72380,7 @@ declare namespace sap {
           /**
            * The model messages for this data state.
            */
-          aMessages?: sap.ui.core.Message[]
+          aMessages?: sap.ui.core.message.Message[]
         ): this;
         /**
          * @ui5-protected Do not call from applications (only from related classes in the framework)
@@ -81945,6 +82244,8 @@ declare namespace sap {
 
     "sap/ui/core/ComponentMetadata": undefined;
 
+    "sap/ui/core/ComponentRegistry": undefined;
+
     "sap/ui/core/ComponentSupport": undefined;
 
     "sap/ui/core/Configuration": undefined;
@@ -81987,6 +82288,8 @@ declare namespace sap {
 
     "sap/ui/core/ElementMetadata": undefined;
 
+    "sap/ui/core/ElementRegistry": undefined;
+
     "sap/ui/core/EnabledPropagator": undefined;
 
     "sap/ui/core/EventBus": undefined;
@@ -82169,6 +82472,8 @@ declare namespace sap {
 
     "sap/ui/core/UIArea": undefined;
 
+    "sap/ui/core/UIAreaRegistry": undefined;
+
     "sap/ui/core/UIComponent": undefined;
 
     "sap/ui/core/util/Export": undefined;