@openui5/ts-types 1.130.0 → 1.131.0

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

@@ -279,7 +279,7 @@ declare namespace sap {
     "sap/ui/thirdparty/qunit-2": undefined;
   }
 }
-// For Library Version: 1.130.0
+// For Library Version: 1.131.0
 
 declare module "sap/base/assert" {
   /**
@@ -6657,7 +6657,7 @@ declare module "sap/ui/test/OpaBuilder" {
        * the Opa5 instance to call {@link sap.ui.test.Opa5#waitFor} on
        */
       oOpaInstance?: sap.ui.test.Opa5
-    ): /* was: sap.ui.test.Opa5.Chain */ any;
+    ): sap.ui.test.Opa5;
     /**
      * Sets the `fragmentId` parameter.
      *
@@ -18982,7 +18982,11 @@ declare namespace sap {
                */
               plusSign?: string;
               /**
-               * defines the numerical precision; the number of decimals is calculated dependent on the integer digits
+               * The maximum number of digits in the formatted representation of a number; if the `precision` is less
+               * than the overall length of the number, its fractional part is truncated through rounding. As the `precision`
+               * only affects the rounding of a number, its integer part can retain more digits than defined by this parameter.
+               * **Example:** With a `precision` of 2, `234.567` is formatted to `235`. **Note:** The formatted output
+               * may differ depending on locale.
                */
               precision?: int;
               /**
@@ -19137,7 +19141,12 @@ declare namespace sap {
                */
               plusSign?: string;
               /**
-               * defines the numerical precision; the number of decimals is calculated dependent on the integer digits
+               * **Note:** Only considered if the number format leads to a representation with decimal places, e.g. if
+               * the option `style: "short"` is set. The maximum number of digits in the formatted representation of a
+               * number; if the `precision` is less than the overall length of the number, its fractional part is truncated
+               * through rounding. As the `precision` only affects the rounding of a number, its integer part can retain
+               * more digits than defined by this parameter. **Example:** With a `precision` of 2 and `style: "short"`,
+               * `234567` is formatted to `"235K"`. **Note:** The formatted output may differ depending on locale.
                */
               precision?: int;
               /**
@@ -19290,7 +19299,11 @@ declare namespace sap {
                */
               plusSign?: string;
               /**
-               * defines the numerical precision; the number of decimals is calculated dependent on the integer digits
+               * The maximum number of digits in the formatted representation of a number; if the `precision` is less
+               * than the overall length of the number, its fractional part is truncated through rounding. As the `precision`
+               * only affects the rounding of a number, its integer part can retain more digits than defined by this parameter.
+               * **Example:** With a `precision` of 2, `234.567` is formatted to `"23,457%"`. **Note:** The formatted
+               * output may differ depending on locale.
                */
               precision?: int;
               /**
@@ -19442,7 +19455,11 @@ declare namespace sap {
                */
               plusSign?: string;
               /**
-               * defines the numerical precision; the number of decimals is calculated dependent on the integer digits
+               * The maximum number of digits in the formatted representation of a number; if the `precision` is less
+               * than the overall length of the number, its fractional part is truncated through rounding. As the `precision`
+               * only affects the rounding of a number, its integer part can retain more digits than defined by this parameter.
+               * **Example:** With a `precision` of 2, the parameters `"234.567", "mass-kilogram"` are formatted to `"235
+               * kg"`. **Note:** The formatted output may differ depending on locale.
                */
               precision?: int;
               /**
@@ -23675,7 +23692,7 @@ declare namespace sap {
          * 	 - the first week of the year.
          *
          * @since 1.108.0
-         * @deprecated (since 1.120) - Please use {@link module:sap/base/18n/date/CalendarWeekNumbering} instead.
+         * @deprecated (since 1.120) - Please use {@link module:sap/base/i18n/date/CalendarWeekNumbering} instead.
          */
         enum CalendarWeekNumbering {
           /**
@@ -32936,13 +32953,15 @@ declare namespace sap {
       }
 
       /**
-       * Marker interface for controls that can be used as content of `sap.ui.layout.form.SemanticFormElement`.
+       * Marker interface for controls that can be used as content of {@link sap.ui.layout.form.SemanticFormElement SemanticFormElement}.
        *
        * If the value-holding property of the control is not `valuetext`, the name of the value-holding
-       * property must be returned in the `getFormValueProperty` function.
+       * property must be returned in the {@link sap.ui.core.ISemanticFormContent.getFormValueProperty getFormValueProperty }
+       * function.
        *
        * If the value of the control needs some special output formatting (to show a description instead of a
-       * key), this formatted text needs to be returned in the `getFormFormattedValue` function.
+       * key), this formatted text needs to be returned in the {@link sap.ui.core.ISemanticFormContent.getFormFormattedValue getFormFormattedValue }
+       * function.
        *
        * @since 1.86.0
        */
@@ -32950,12 +32969,13 @@ declare namespace sap {
         __implements__sap_ui_core_ISemanticFormContent: boolean;
 
         /**
-         * Returns the formatted value of a control used in a `SemanticFormElement`.
+         * Returns the formatted value of a control used in a {@link sap.ui.layout.form.SemanticFormElement SemanticFormElement}.
          *
-         * In the `SemanticFormElement` element, the assigned fields are rendered in edit mode. In display mode,
-         * a text is rendered that concatenates the values of all assigned fields. In some cases the displayed text
-         * does not match the value of the field and needs some formatting. In other cases the control does not
-         * have a `value` property, so the `SemanticFormElement` element cannot determine the value.
+         * In the {@link sap.ui.layout.form.SemanticFormElement SemanticFormElement} element, the assigned fields
+         * are rendered in edit mode. In display mode, a text is rendered that concatenates the values of all assigned
+         * fields. In some cases the displayed text does not match the value of the field and needs some formatting.
+         * In other cases the control does not have a `value` property, so the {@link sap.ui.layout.form.SemanticFormElement SemanticFormElement }
+         * element cannot determine the value.
          *
          * This is an optional method. If not defined, the `value` property or the `text` property is used to determine
          * the value.
@@ -32966,15 +32986,16 @@ declare namespace sap {
          */
         getFormFormattedValue?(): string | Promise<string>;
         /**
-         * Returns the names of the properties of a control that might update the rendering in a `SemanticFormElement`.
+         * Returns the names of the properties of a control that might update the rendering in a {@link sap.ui.layout.form.SemanticFormElement SemanticFormElement}.
          *
-         * In the `SemanticFormElement` element, the assigned fields are rendered in edit mode. In display mode,
-         * depending on `getFormRenderAsControl`, either a text is rendered, which concatenates the values of all
-         * assigned fields, or the control is rendered. So if a property of the control changes that might lead
-         * to a different rendering (some controls have a special rendering in display mode), the `SemanticFormElement`
+         * In the {@link sap.ui.layout.form.SemanticFormElement SemanticFormElement} element, the assigned fields
+         * are rendered in edit mode. In display mode, depending on {@link sap.ui.core.ISemanticFormContent.getFormRenderAsControl getFormRenderAsControl},
+         * either a text is rendered, which concatenates the values of all assigned fields, or the control is rendered.
+         * So if a property of the control changes that might lead to a different rendering (some controls have
+         * a special rendering in display mode), the {@link sap.ui.layout.form.SemanticFormElement SemanticFormElement }
          * needs to check the rendering.
          *
-         * This is an optional method. If not defined, no check for updates (only for property defined in `getFormValueProperty`)
+         * This is an optional method. If not defined, no check for updates (only for property defined in {@link sap.ui.core.ISemanticFormContent.getFormValueProperty getFormValueProperty})
          * is done once the control has been assigned.
          *
          * @since 1.117.0
@@ -32983,8 +33004,8 @@ declare namespace sap {
          */
         getFormObservingProperties?(): string[];
         /**
-         * If set to `true`, the `SemanticFormElement` also renders the control in display mode, if the used `FormLayout`
-         * supports this.
+         * If set to `true`, the {@link sap.ui.layout.form.SemanticFormElement SemanticFormElement} also renders
+         * the control in display mode, if the used {@link sap.ui.layout.form.FormLayout FormLayout} supports this.
          *
          * This is an optional method. If not defined, just the text is rendered.
          *
@@ -32994,12 +33015,13 @@ declare namespace sap {
          */
         getFormRenderAsControl?(): string;
         /**
-         * Returns the name of the value-holding property of a control used in a `SemanticFormElement`.
+         * Returns the name of the value-holding property of a control used in a {@link sap.ui.layout.form.SemanticFormElement SemanticFormElement}.
          *
-         * In the `SemanticFormElement` element, the assigned fields are rendered in edit mode. In display mode,
-         * a text is rendered that concatenates the values of all assigned fields. So the concatenated text needs
-         * to be updated if the value of a control changes. If a control does not have a `value` property, the `SemanticFormElement`
-         * element needs to know the propery it has to listen for changes.
+         * In the {@link sap.ui.layout.form.SemanticFormElement SemanticFormElement} element, the assigned fields
+         * are rendered in edit mode. In display mode, a text is rendered that concatenates the values of all assigned
+         * fields. So the concatenated text needs to be updated if the value of a control changes. If a control
+         * does not have a `value` property, the {@link sap.ui.layout.form.SemanticFormElement SemanticFormElement }
+         * element needs to know the property it has to listen to for changes.
          *
          * This is an optional method. If not defined, the `value` property or the `text` property is used to determine
          * the value.
@@ -40478,6 +40500,27 @@ declare namespace sap {
            */
           FNMetaImpl?: Function
         ): Function;
+        /**
+         * Fires a "focusfail" event to handle focus redirection when the current element loses focus due to a state
+         * change (e.g., disabled, invisible, or destroyed). The event is propagated to the parent of the current
+         * element to manage the focus shift.
+         *
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         */
+        static fireFocusFail(
+          /**
+           * The mode of focus handling, determining whether the focus should be handled sync or async.
+           */
+          sFocusHandlingMode: string,
+          /**
+           * The parent element that will handle the "focusfail" event.
+           */
+          oParent: sap.ui.core.Element,
+          /**
+           * Optional DOM area to be skipped during focus redirection.
+           */
+          oSkipArea?: HTMLElement
+        ): void;
         /**
          * Returns the element currently in focus.
          *
@@ -40775,6 +40818,25 @@ declare namespace sap {
            */
           bSuppressInvalidate?: boolean
         ): void;
+        /**
+         * Destroys all child elements of a specified aggregation and handles focus management for elements that
+         * are currently focused. If the currently focused element belongs to the aggregation being destroyed, a
+         * "focusfail" event is triggered to shift the focus to a relevant element.
+         *
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         *
+         * @returns Returns `this` to allow method chaining
+         */
+        destroyAggregation(
+          /**
+           * The name of the aggregation
+           */
+          sAggregationName: string,
+          /**
+           * If true, this ManagedObject is not marked as changed
+           */
+          bSuppressInvalidate?: boolean
+        ): this;
         /**
          * Destroys all the customData in the aggregation {@link #getCustomData customData}.
          *
@@ -41214,8 +41276,8 @@ declare namespace sap {
         isFocusable(): boolean;
         /**
          * Handles the 'focusfail' event by attempting to find and focus on a tabbable element. The 'focusfail'
-         * event is triggered when the current element, which initially holds the focus, becomes disabled or invisible.
-         * The event is received by the parent of the element that failed to retain the focus.
+         * event is triggered when the current element, which initially holds the focus, becomes disabled, invisible,
+         * or destroyed. The event is received by the parent of the element that failed to retain the focus.
          *
          * @ui5-protected Do not call from applications (only from related classes in the framework)
          */
@@ -41245,6 +41307,50 @@ declare namespace sap {
            */
           oValue?: any
         ): any | this;
+        /**
+         * Removes an object from the aggregation named `sAggregationName` with cardinality 0..n and manages focus
+         * handling in case the removed object was focused. If the removed object held the focus, a "focusfail"
+         * event is triggered to proper focus redirection.
+         *
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         *
+         * @returns the removed object or `null`
+         */
+        removeAggregation(
+          /**
+           * the string identifying the aggregation that the given object should be removed from
+           */
+          sAggregationName: string,
+          /**
+           * the position or ID of the ManagedObject that should be removed or that ManagedObject itself; if `vObject`
+           * is invalid, a negative value or a value greater or equal than the current size of the aggregation, nothing
+           * is removed.
+           */
+          vObject: int | string | sap.ui.base.ManagedObject,
+          /**
+           * if true, this ManagedObject is not marked as changed
+           */
+          bSuppressInvalidate?: boolean
+        ): sap.ui.base.ManagedObject | null;
+        /**
+         * Removes all child elements of a specified aggregation and handles focus management for elements that
+         * are currently focused. If the currently focused element belongs to the aggregation being removed, a "focusfail"
+         * event is triggered to shift the focus to a relevant element.
+         *
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         *
+         * @returns An array of the removed elements (might be empty)
+         */
+        removeAllAggregation(
+          /**
+           * The name of the aggregation
+           */
+          sAggregationName: string,
+          /**
+           * If true, this ManagedObject is not marked as changed
+           */
+          bSuppressInvalidate?: boolean
+        ): sap.ui.base.ManagedObject[];
         /**
          * Removes all the controls from the aggregation {@link #getCustomData customData}.
          *
@@ -41343,6 +41449,29 @@ declare namespace sap {
          * @ui5-protected Do not call from applications (only from related classes in the framework)
          */
         rerender(): void;
+        /**
+         * Sets a new object in the named 0..1 aggregation of this ManagedObject and marks this ManagedObject as
+         * changed. Manages the focus handling if the current aggregation is removed (i.e., when the object is set
+         * to `null`). If the previous object in the aggregation was focused, a "focusfail" event is triggered.
+         *
+         * @ui5-protected Do not call from applications (only from related classes in the framework)
+         *
+         * @returns Returns `this` to allow method chaining
+         */
+        setAggregation(
+          /**
+           * name of an 0..1 aggregation
+           */
+          sAggregationName: string,
+          /**
+           * the managed object that is set as aggregated object
+           */
+          oObject: sap.ui.base.ManagedObject,
+          /**
+           * if true, this ManagedObject is not marked as changed
+           */
+          bSuppressInvalidate?: boolean
+        ): this;
         /**
          * Sets the associated {@link #getFieldHelpDisplay fieldHelpDisplay}.
          *
@@ -44410,7 +44539,9 @@ declare namespace sap {
           /**
            * The locale or language tag
            */
-          vLocale: sap.ui.core.Locale | /* was: sap.base.i18n.LanguageTag */ any
+          vLocale:
+            | sap.ui.core.Locale
+            | import("sap/base/i18n/LanguageTag").default
         ): sap.ui.core.LocaleData;
         /**
          * Returns a metadata object for class sap.ui.core.LocaleData.
@@ -51358,223 +51489,6 @@ declare namespace sap {
         TooltipBase
       >;
     }
-    /**
-     * Provides access to UI5 loader configuration.
-     *
-     * The configuration is used by {@link sap.ui.require} and {@link sap.ui.define}.
-     */
-    namespace loader {
-      /**
-       * Sets the configuration for the UI5 loader. The configuration can be updated multiple times. Later changes
-       * do not impact modules that have been loaded before.
-       *
-       * If no parameter is given, a partial copy of UI5 loader configuration in use is returned.
-       *
-       * The configuration options are aligned with the "Common Config" draft of the AMD spec (https://github.com/amdjs/amdjs-api/blob/master/CommonConfig.md).
-       *
-       * The following code shows an example of what a UI5 loader configuration might look like:
-       * ```javascript
-       *
-       *
-       *   sap.ui.loader.config({
-       *
-       *     // location from where to load all modules by default
-       *     baseUrl: '../../resources/',
-       *
-       *     paths: {
-       *       // load modules whose ID equals to or starts with 'my/module' from example.com
-       *       'my/module': 'https://example.com/resources/my/module'
-       *     },
-       *
-       *     map: {
-       *       // if any module requires 'sinon', load module 'sap/ui/thirdparty/sinon-4'
-       *       '*': {
-       *         'sinon': 'sap/ui/thirdparty/sinon-4'
-       *       },
-       *       // but if a module whose ID equals to or starts with 'app' requires 'sinon'
-       *       // then load a legacy version instead
-       *       "app": {
-       *         'sinon': 'sap/ui/legacy/sinon'
-       *       }
-       *     },
-       *
-       *     // define two bundles that consists of JS modules only
-       *     bundles: {
-       *       bundle1: ['module1', 'module2'],
-       *       bundle2: ['moduleX', 'moduleY']
-       *     },
-       *
-       *     // define a bundle that also contains non-JS resources
-       *     bundlesUI5: {
-       *       'all.js': ['Component.js', 'manifest.json',
-       *                  'App.controller.js', 'App.view.xml']
-       *     },
-       *
-       *     // activate real async loading and module definitions
-       *     async: true,
-       *
-       *     // provide dependency and export metadata for non-UI5 modules
-       *     shim: {
-       *       'sap/ui/thirdparty/blanket': {
-       *         amd: true,
-       *         exports: 'blanket'
-       *       }
-       *     }
-       *
-       *   });
-       *
-       * ```
-       *
-       *
-       * @since 1.56.0
-       *
-       * @returns UI5 loader configuration in use.
-       */
-      function config(
-        /**
-         * The provided configuration gets merged with the UI5 loader configuration in use. If `cfg` is omitted
-         * or `undefined`, a copy of the current configuration gets returned, containing at least the properties
-         * `amd` and `async`.
-         */
-        cfg?: {
-          /**
-           * Default location to load modules from. If none of the configured `paths` prefixes matches a module ID,
-           * the module will be loaded from the concatenation of the `baseUrl` and the module ID.
-           *
-           * If the `baseUrl` itself is a relative URL, it is evaluated relative to `document.baseURI`.
-           */
-          baseUrl?: string;
-          /**
-           * A map of resource locations keyed by a corresponding module ID prefix. When a module is to be loaded,
-           * the longest key in `paths` is searched that is a prefix of the module ID. The module will be loaded from
-           * the concatenation of the corresponding value in `paths` and the remainder of the module ID (after the
-           * prefix). If no entry in `paths` matches, then the module will be loaded from the `baseUrl`.
-           *
-           * The prefixes (keys) must not contain relative segments (./ or ../), a trailing slash will be removed,
-           * and only full name segment matches are considered a match (prefix 'sap/m' does not match a module ID
-           * 'sap/main').
-           *
-           * **Note**: In contrast to the "Common Config" of the AMD spec, the paths (values in the map) are interpreted
-           * relative to `document.baseURI`, not relative to `cfg.baseUrl`.
-           */
-          paths?: Record<string, string>;
-          /**
-           * A map of maps that defines how to map module IDs to other module IDs (inner maps) in the context of a
-           * specific set of modules (keys of outer map).
-           *
-           * Each key of the outer map represents a module ID prefix that describes the context for which its value
-           * (inner map) has to be used. The special key `*` describes the default context which applies for any module.
-           * Only the most specific matching context will be taken into account.
-           *
-           * Each inner map maps a module ID or module ID prefix to another module ID or module ID prefix. Again,
-           * only the most specific match is taken into account and only one mapping is evaluated (the evaluation
-           * of the mappings is not done recursively).
-           *
-           * Matches are always complete matches, a prefix 'a/b/c' does not match the module ID 'a/b/com'.
-           */
-          map?: Record<string, Record<string, string>>;
-          /**
-           * Defines additional metadata for modules for which the normal behavior of the AMD APIs is not sufficient.
-           *
-           * A typical example are scripts that don't use `define` or `sap.ui.define`, but export to a global name.
-           * With the `exports` property, one or more export names can be specified, and the loader can retrieve the
-           * exported value after executing the corresponding module. If such a module has dependencies, they can
-           * be specified in the `deps` array and are loaded and executed before executing the module.
-           *
-           * The `amd` flag of a shim is a ui5loader-specific extension of the standard AMD shims. If set, the ui5loader
-           * hides a currently active AMD loader before executing the module and restores it afterwards. Otherwise,
-           * it might miss the export of third party modules that check for an AMD loader and register with it instead
-           * of exporting to a global name. A future version of the ui5loader might ignore this flag when it acts
-           * as an AMD loader by itself.
-           *
-           * **Note:** The ui5loader does not support the `init` option described by the "Common Config" section of
-           * the AMD spec.
-           */
-          shim?: Record<
-            string,
-            {
-              amd: boolean;
-
-              deps: string[];
-
-              exports: string | string[];
-            }
-          >;
-          /**
-           * A map of arrays that each define the modules contained in a bundle.
-           *
-           * Each key of the map represents the module ID of a bundle file. The array value represents the set of
-           * JavaScript modules (their module IDs) that are contained in the bundle.
-           *
-           * When a module is required that has not been loaded yet, and for which a containing bundle is known, that
-           * bundle will be required first. Only then the original module will be required again and usually be taken
-           * from the just loaded bundle.
-           *
-           * A bundle will be loaded asynchronously only when the loader is in asynchronous mode and when the request
-           * for the contained module originates from an asynchronous API. In all other cases, the bundle has to be
-           * loaded synchronously to fulfill API contracts.
-           *
-           * **Note:** The loader only supports one containing bundle per module. If a module is declared to be part
-           * of multiple bundles, only the last one will be taken into account.
-           *
-           * This configuration option is basically provided to be compatible with requireJS or SystemJS configuration.
-           */
-          bundles?: Record<string, string[]>;
-          /**
-           * A map of arrays that each define the resources contained in a bundle.
-           *
-           * This is similar to `bundles`, but all strings are unified resource names including a file type extension,
-           * not only module IDs. This allows to represent more than just JavaScript modules.
-           *
-           * Each key of the map represents the resource name (in unified resource name syntax) of a bundle file.
-           * The array value represents the set of resources (also in unified resource name syntax) that are contained
-           * in the bundle. The array can contain JavaScript as well as other textual resource types (e.g. *.xml or
-           * *.json resources).
-           *
-           * When a module is required that has not been loaded yet, and for which a containing bundle is known, that
-           * bundle will be required first. Only then the original module will be required again and usually be taken
-           * from the just loaded bundle.
-           *
-           * A bundle will be loaded asynchronously only when the loader is in asynchronous mode and when the request
-           * for the contained module originates from an asynchronous API. In all other cases, the bundle has to be
-           * loaded synchronously to fulfill API contracts.
-           *
-           * **Note:** The loader only supports one containing bundle per module. If a module is declared to be part
-           * of multiple bundles, only the last one will be taken into account.
-           *
-           * **Note:** Although non-JS resources can be declared to be part of a bundle, only requests for JavaScript
-           * modules will currently trigger the loading of a bundle.
-           */
-          bundlesUI5?: Record<string, string[]>;
-          /**
-           * When set to true, `sap.ui.require` loads modules asynchronously via script tags and `sap.ui.define` executes
-           * asynchronously. To enable this feature, it is recommended to set the attribute `data-sap-ui-async="true"`
-           * on the application bootstrap tag.
-           *
-           * **Note:** Switching back from async to sync is not supported and trying to do so will throw an `Error`
-           */
-          async?: boolean;
-          /**
-           * When set to true, the ui5loader will overwrite the global properties `define` and `require` with its
-           * own implementations. Any previously active AMD loader will be remembered internally and can be restored
-           * by setting `amd` to false again.
-           *
-           * **Note:** Switching to the `amd` mode, the ui5loader will set `async` to true implicitly for activating
-           * asynchronous loading. Once the loading behaviour has been defined to be asynchronous, it can not be changed
-           * to synchronous behaviour again, also not via setting `amd` to false.
-           */
-          amd?: boolean;
-        }
-      ):
-        | {
-            amd: boolean;
-
-            async: boolean;
-
-            noConflict: boolean;
-          }
-        | undefined;
-    }
     /**
      * The SAPUI5 Data Binding API.
      *
@@ -53828,10 +53742,10 @@ declare namespace sap {
              */
             oContext: sap.ui.model.Context,
             /**
-             * Parameters, specifying the aggregation level for which contexts shall be fetched or (legacy signature
-             * variant) index of first child entry to return from the parent context (zero-based)
+             * Parameters, specifying the aggregation level for which contexts shall be fetched or the index of the
+             * first child entry to return from the parent contexts
              */
-            mParameters:
+            mParameters?:
               | {
                   /**
                    * Level number for oContext, because it might occur at multiple levels; context with group ID `"/"` has
@@ -53943,7 +53857,7 @@ declare namespace sap {
              * value can be set to define the parameter `startIndex` as described in this parameter list. In this case,
              * the function parameters `iLength`, `iNumberOfExpandedLevels` and `iThreshold` become mandatory.
              */
-            mParameters:
+            mParameters?:
               | {
                   /**
                    * Number of entries to return at and after the given start index; defaults to the model's size limit, see
@@ -59236,7 +59150,10 @@ declare namespace sap {
              *
              * @ui5-protected Do not call from applications (only from related classes in the framework)
              *
-             * @returns The array of already available contexts with the first entry containing the context for `iStartIndex`
+             * @returns The array of already available contexts with the first entry containing the context for `iStartIndex`.
+             * Since 1.131.0, the array has an additional property `bExpectMore`, which is `true` if the response is
+             * not complete, a {@link #event:change 'change'} event will follow, and a busy indicator should be switched
+             * on.
              */
             getContexts(
               /**
@@ -62446,6 +62363,33 @@ declare namespace sap {
             context?: boolean;
           }
 
+          /**
+           * Parameters of the ODataListBinding#separateReceived event.
+           *
+           * @experimental (since 1.131.0)
+           */
+          interface ODataListBinding$SeparateReceivedEventParameters {
+            /**
+             * The requested property name
+             */
+            property?: string;
+
+            /**
+             * The start index of the requested range
+             */
+            start?: number;
+
+            /**
+             * The length of the requested range
+             */
+            length?: number;
+
+            /**
+             * A UI5 message of type {@link module:sap/ui/core/message/MessageType MessageType.Error}
+             */
+            errorMessage?: sap.ui.core.message.Message;
+          }
+
           /**
            * Parameters of the ODataModel#dataReceived event.
            */
@@ -68041,6 +67985,16 @@ declare namespace sap {
             ODataListBinding
           >;
 
+          /**
+           * Event object of the ODataListBinding#separateReceived event.
+           *
+           * @experimental (since 1.131.0)
+           */
+          type ODataListBinding$SeparateReceivedEvent = sap.ui.base.Event<
+            ODataListBinding$SeparateReceivedEventParameters,
+            ODataListBinding
+          >;
+
           /**
            * Event object of the ODataModel#dataReceived event.
            */
@@ -75506,11 +75460,11 @@ declare namespace sap {
          */
         getCount(): number | undefined;
         /**
-         * Return node contexts for the tree
+         * Return node contexts for the tree.
          *
          * @ui5-protected Do not call from applications (only from related classes in the framework)
          *
-         * @returns the contexts array
+         * @returns the context's array
          */
         getNodeContexts(
           /**
@@ -75518,42 +75472,44 @@ declare namespace sap {
            */
           oContext: sap.ui.model.Context,
           /**
-           * the startIndex where to start the retrieval of contexts
+           * the index from which to start the retrieval of contexts
            */
-          iStartIndex: int,
+          iStartIndex?: int,
           /**
-           * determines how many contexts to retrieve beginning from the start index.
+           * determines how many contexts to retrieve, beginning from the start index. Defaults to the model's size
+           * limit; see {@link sap.ui.model.Model#setSizeLimit}.
            */
-          iLength: int
+          iLength?: int
         ): sap.ui.model.Context[];
         /**
-         * Return root contexts for the tree
+         * Return root contexts for the tree.
          *
          * @ui5-protected Do not call from applications (only from related classes in the framework)
          *
-         * @returns the contexts array
+         * @returns the context's array
          */
         getRootContexts(
           /**
-           * the startIndex where to start the retrieval of contexts
+           * the index from which to start the retrieval of contexts
            */
-          iStartIndex: int,
+          iStartIndex?: int,
           /**
-           * determines how many contexts to retrieve beginning from the start index.
+           * determines how many contexts to retrieve, beginning from the start index. Defaults to the model's size
+           * limit; see {@link sap.ui.model.Model#setSizeLimit}.
            */
-          iLength: int
-        ): object[];
+          iLength?: int
+        ): sap.ui.model.Context[];
         /**
          * Returns if the node has child nodes.
          *
          *
-         * @returns true if node has children
+         * @returns `true` if the node has children
          */
         hasChildren(
           /**
            * the context element of the node
            */
-          oContext: object
+          oContext: sap.ui.model.Context
         ): boolean;
         /**
          * Sorts the contexts of this ClientTreeBinding. The tree will be sorted level by level. So the nodes are
@@ -76677,7 +76633,8 @@ declare namespace sap {
          */
         constructor(
           /**
-           * Filter info object or a path or an array of filters
+           * Filter info object or a path or an array of filters; if a filter info object is given, the other constructor
+           * parameters are ignored
            */
           vFilterInfo:
             | {
@@ -78835,21 +78792,41 @@ declare namespace sap {
          */
         constructor(
           /**
-           * the binding path used for sorting
+           * The binding path used for sorting or the sorter info object; if a sorter info object is given, the other
+           * constructor parameters are ignored
            */
-          sPath: string,
+          vSorterInfo:
+            | string
+            | {
+                /**
+                 * See `fnComparator` parameter
+                 */
+                comparator?: Function;
+                /**
+                 * See `bDescending` parameter
+                 */
+                descending?: boolean;
+                /**
+                 * See `vGroup` parameter
+                 */
+                group?: boolean | Function;
+                /**
+                 * The binding path for this sorter
+                 */
+                path?: string;
+              },
           /**
-           * whether the sort order should be descending
+           * Whether the sort order is descending
            */
           bDescending?: boolean,
           /**
-           * configure grouping of the content, can either be true to enable grouping based on the raw model property
-           * value, or a function which calculates the group value out of the context (e.g. oContext.getProperty("date").getYear()
-           * for year grouping). The control needs to implement the grouping behaviour for the aggregation which you
-           * want to group. In case a function is provided it must either return a primitive type value as the group
-           * key or an object containing a "key" property and additional properties needed for group visualization.
-           * This object or the object with the primitive type return value as "key" property is passed to the `groupHeaderFactory`
-           * function that has been specified to create the group header for the control aggregation; see {@link sap.ui.base.ManagedObject#bindAggregation}.
+           * Configure grouping of the content, can either be `true` to enable grouping based on the raw model property
+           * value, or a function which calculates the group value out of the context (e.g. `oContext.getProperty("date").getYear()`
+           * for year grouping). The control needs to implement the grouping behaviour. In case a function is provided
+           * it must either return a primitive type value as the group key or an object containing a "key" property
+           * and additional properties needed for group visualization. This object or the object with the primitive
+           * type return value as "key" property is passed to the `groupHeaderFactory` function that has been specified
+           * to create the group header for the control aggregation; see {@link sap.ui.base.ManagedObject#bindAggregation}.
            * **Note:** Grouping via `vGroup=true` is only possible (and only makes sense) for the primary sort property.
            * A more complicated grouping is possible by providing a grouping function. The sort order needs to fit
            * to the grouping also in this case. See also {@link https://ui5.sap.com/#/topic/ec79a5d5918f4f7f9cbc2150e66778cc Sorting, Grouping, and Filtering for List Binding}.
@@ -78857,7 +78834,7 @@ declare namespace sap {
           vGroup?: boolean | Function,
           /**
            * A custom comparator function, which is used for client-side sorting instead of the default comparator
-           * method. Information about parameters and expected return values of such a method can be found in the
+           * method; information about parameters and expected return values of such a method can be found in the
            * {@link #.defaultComparator default comparator} documentation. **Note:** Custom comparator functions are
            * meant to be used on the client. Models that implement sorting in the backend usually don't support custom
            * comparator functions. Consult the documentation of the specific model implementation.
@@ -78942,6 +78919,22 @@ declare namespace sap {
          * @returns The group function
          */
         getGroupFunction(): Function;
+        /**
+         * Returns the binding path for this sorter; see the path parameter of {@link sap.ui.model.Sorter#constructor}.
+         *
+         * @since 1.131.0
+         *
+         * @returns The binding path
+         */
+        getPath(): string;
+        /**
+         * Whether to sort in descending order; see the descending parameter of {@link sap.ui.model.Sorter#constructor}.
+         *
+         * @since 1.131.0
+         *
+         * @returns Whether to sort in descending order
+         */
+        isDescending(): boolean;
       }
       /**
        * The `StaticBinding` allows to define static values within a {@link sap.ui.model.CompositeBinding}. It
@@ -79014,7 +79007,7 @@ declare namespace sap {
           /**
            * Context object for this binding (optional)
            */
-          oContext?: object,
+          oContext?: sap.ui.model.Context,
           /**
            * The filters to be used initially with type {@link sap.ui.model.FilterType.Application}; call {@link #filter }
            * to replace them
@@ -79023,7 +79016,7 @@ declare namespace sap {
           /**
            * Additional model specific parameters (optional)
            */
-          mParameters?: string,
+          mParameters?: object,
           /**
            * The sorters used initially; call {@link #sort} to replace them
            */
@@ -79115,7 +79108,7 @@ declare namespace sap {
           sFilterType?: sap.ui.model.FilterType
         ): void;
         /**
-         * Returns the number of child nodes of a specific context
+         * Returns the number of child nodes of a specific context.
          *
          *
          * @returns the number of children
@@ -79124,7 +79117,7 @@ declare namespace sap {
           /**
            * the context element of the node
            */
-          oContext: Object
+          oContext: sap.ui.model.Context
         ): int;
         /**
          * Returns the count of entries in the tree, or `undefined` if it is unknown. If the tree is filtered, the
@@ -79140,7 +79133,7 @@ declare namespace sap {
          */
         getCount(): number | undefined;
         /**
-         * Returns the current value of the bound target
+         * Returns the current value of the bound target.
          *
          *
          * @returns the array of child contexts for the given node
@@ -79151,41 +79144,43 @@ declare namespace sap {
            */
           oContext: sap.ui.model.Context,
           /**
-           * the startIndex where to start the retrieval of contexts
+           * the index from which to start the retrieval of contexts
            */
-          iStartIndex: int,
+          iStartIndex?: int,
           /**
-           * determines how many contexts to retrieve beginning from the start index.
+           * determines how many contexts to retrieve, beginning from the start index. Defaults to the model's size
+           * limit; see {@link sap.ui.model.Model#setSizeLimit}.
            */
-          iLength: int
+          iLength?: int
         ): sap.ui.model.Context[];
         /**
-         * Returns the current value of the bound target
+         * Returns the current value of the bound target.
          *
          *
          * @returns the array of child contexts for the root node
          */
         getRootContexts(
           /**
-           * the startIndex where to start the retrieval of contexts
+           * the index from which to start the retrieval of contexts
            */
-          iStartIndex: int,
+          iStartIndex?: int,
           /**
-           * determines how many contexts to retrieve beginning from the start index.
+           * determines how many contexts to retrieve, beginning from the start index. Defaults to the model's size
+           * limit; see {@link sap.ui.model.Model#setSizeLimit}.
            */
-          iLength: int
-        ): any[];
+          iLength?: int
+        ): sap.ui.model.Context[];
         /**
-         * Returns if the node has child nodes
+         * Returns `true` if the node has child nodes.
          *
          *
-         * @returns true if node has children
+         * @returns `true` if the node has children
          */
         hasChildren(
           /**
            * the context element of the node
            */
-          oContext: Object
+          oContext: sap.ui.model.Context
         ): boolean;
         /**
          * Sorts the tree according to the sorter definitions.