@openui5/ts-types 1.139.0 → 1.141.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.139.0
+// For Library Version: 1.141.0
 
 declare module "sap/base/assert" {
   /**
@@ -787,7 +787,7 @@ declare module "sap/base/i18n/Formatting" {
      */
     setLanguageTag(
       /**
-       * the new BCP47 compliant language tag; case doesn't matter and underscores can be used instead of dashes
+       * the new BCP47 compliant language tag; case doesn't matter and underscores can be used instead of hyphens
        * to separate components (compatibility with Java Locale IDs)
        */
       vLanguageTag: string | LanguageTag | null
@@ -1090,15 +1090,15 @@ declare module "sap/base/i18n/LanguageTag" {
     /**
      * Get the extension as a single string or `null`.
      *
-     * The extension always consists of a singleton character (not 'x'), a dash '-' and one or more extension
-     * token, each separated again with a dash.
+     * The extension always consists of a singleton character (not 'x'), a hyphen '-' and one or more extension
+     * token, each separated again with a hyphen.
      */
     extension: string | null;
 
     /**
      * Get the extensions as an array of tokens.
      *
-     * The leading singleton and the separating dashes are not part of the result. If there is no extensions
+     * The leading singleton and the separating hyphens are not part of the result. If there is no extensions
      * section in the language tag, an empty array is returned.
      */
     extensionSubtags: string[];
@@ -1130,14 +1130,14 @@ declare module "sap/base/i18n/LanguageTag" {
     /**
      * Get the variants as a single string or `null`.
      *
-     * Multiple variants are separated by a dash '-'.
+     * Multiple variants are separated by a hyphen '-'.
      */
     variant: string | null;
 
     /**
      * Get the variants as an array of individual variants.
      *
-     * The separating dashes are not part of the result. If there is no variant section in the language tag,
+     * The separating hyphens are not part of the result. If there is no variant section in the language tag,
      * an empty array is returned.
      */
     variantSubtags: string[];
@@ -1189,8 +1189,8 @@ declare module "sap/base/i18n/Localization" {
      * The value returned by config method in most cases corresponds to the exact value that has been configured
      * by the user or application or that has been determined from the user agent settings. It has not been
      * normalized, but has been validated against a relaxed version of {@link http://www.ietf.org/rfc/bcp/bcp47.txt BCP47},
-     * allowing underscores ('_') instead of the suggested dashes ('-') and not taking the case of letters into
-     * account.
+     * allowing underscores ('_') instead of the suggested hyphens ('-') and not taking the case of letters
+     * into account.
      *
      * The exceptions mentioned above affect languages that have been specified via the URL parameter `sap-language`.
      * That parameter by definition represents an SAP logon language code ('ABAP language'). Most but not all
@@ -1308,7 +1308,7 @@ declare module "sap/base/i18n/Localization" {
     setLanguage(
       /**
        * the new language as a BCP47 compliant language tag; case doesn't matter and underscores can be used instead
-       * of dashes to separate components (compatibility with Java Locale IDs)
+       * of hyphens to separate components (compatibility with Java Locale IDs)
        */
       sLanguage: string,
       /**
@@ -2355,7 +2355,7 @@ declare module "sap/base/security/encodeURL" {
   /**
    * Encode the string for inclusion into a URL parameter.
    *
-   * Unescaped characters: alphabetic, decimal digits, -_. (dash, underscore, point)
+   * Unescaped characters: alphabetic, decimal digits, -_. (hyphen, underscore, dot)
    *
    * @since 1.58
    *
@@ -2432,8 +2432,10 @@ declare module "sap/base/security/URLListValidator" {
        */
       port?: string,
       /**
-       * the path of the URL, path of the url, can be falsy to allow all paths. A wildcard asterisk can be set
-       * at the end, e.g. "/my-example*", "/my-news"
+       * the path of the URL, e.g. "/my-news". Can be falsy to allow all paths. A wildcard asterisk can be set
+       * at the end to ensure a path starts with the given string, e.g. "/my-example*". When using wildcards,
+       * make sure to only provide normalized URLs to the validate function in order to mitigate the risk of path
+       * traversal attacks.
        */
       path?: string
     ): void;
@@ -2451,11 +2453,14 @@ declare module "sap/base/security/URLListValidator" {
     /**
      * Validates a URL. Check if it's not a script or other security issue.
      *
-     * **Note**: It is strongly recommended to validate only absolute URLs. There's almost no case where checking
-     * only the path of a URL would allow to ensure its validity. For compatibility reasons, this API cannot
-     * automatically resolve URLs relative to `document.baseURI`, but callers should do so. In that case, and
-     * when the allow list is not empty, an entry for the origin of `document.baseURI` must be added to the
-     * allow list.
+     * **Note**: It is strongly recommended to validate only absolute, normalized URLs. There's almost no case
+     * where checking only the path of a URL would allow to ensure its validity. For compatibility reasons,
+     * this API does not normalize URLs and cannot automatically resolve URLs relative to `document.baseURI`,
+     * but callers should do so. In that case, and when the allow list is not empty, an entry for the origin
+     * of `document.baseURI` must be added to the allow list.
+     *
+     * Any measures to mitigate path traversal or similar attack vectors must be taken by the caller, e.g. by
+     * using the {@link https://developer.mozilla.org/docs/Web/API/URL URL} API to normalize the URL beforehand.
      *
      * Details: Splits the given URL into components and checks for allowed characters according to RFC 3986:
      *
@@ -3907,7 +3912,7 @@ declare module "sap/ui/core/ComponentSupport" {
    * instance of the {@link sap.ui.core.ComponentContainer ComponentContainer} in the JavaScript code.
    *
    * As HTML is case-insensitive, in order to define a property with upper-case characters, you have to "escape"
-   * them with a dash character, similar to CSS attributes. The following code gives an example:
+   * them with a hyphen character, similar to CSS attributes. The following code gives an example:
    *
    *
    * ```javascript
@@ -5383,6 +5388,10 @@ declare module "sap/ui/dom/includeStylesheet" {
    *
    * 	 - otherwise: no action
    *
+   * **Note:** `includeStylesheet` must not be used for UI5 library CSS. UI5 library CSS is managed by the
+   * UI5 theming lifecycle. Interfering with this lifecycle by manually including library CSS via `includeStylesheet`
+   * can lead to unexpected behavior and theming issues.
+   *
    * @since 1.58
    *
    * @returns When using the configuration object a `Promise` will be returned. The documentation for the
@@ -7226,8 +7235,6 @@ declare module "sap/ui/util/Mobile" {
      *     work in case there is already a meta tag with name 'viewport'.
      * 	 - statusBar: the iOS status bar color, "default", "black" or "black-translucent" (default: "default")
      *
-     * 	 - hideBrowser: whether the browser UI should be hidden as far as possible to make the app feel more
-     *     native (default: true)
      * 	 - preventScroll: whether native scrolling should be disabled in order to prevent the "rubber-band"
      *     effect where the whole window is moved (default: true)
      * 	 - preventPhoneNumberDetection: whether Safari Mobile should be prevented from transforming any numbers
@@ -7235,8 +7242,6 @@ declare module "sap/ui/util/Mobile" {
      *     break controls because Safari actually changes the DOM. This only affects all page content which is created
      *     after init() is called and only in case there is not already a meta tag with name 'format-detection'.
      *
-     * 	 - rootId: the ID of the root element that should be made fullscreen; only used when hideBrowser is
-     *     set (default: the document.body)
      * 	 - useFullScreenHeight: a boolean that defines whether the height of the html root element should be
      *     set to 100%, which is required for other elements to cover the full height (default: true) homeIcon:
      *     deprecated since 1.12, use sap/ui/util/Mobile.setIcons instead.
@@ -7254,10 +7259,6 @@ declare module "sap/ui/util/Mobile" {
          * the iOS status bar color, "default", "black" or "black-translucent"
          */
         statusBar?: string;
-        /**
-         * whether the browser UI should be hidden as far as possible to make the app feel more native
-         */
-        hideBrowser?: boolean;
         /**
          * whether native scrolling should be disabled in order to prevent the "rubber-band" effect where the whole
          * window is moved
@@ -7268,11 +7269,6 @@ declare module "sap/ui/util/Mobile" {
          * into clickable links
          */
         preventPhoneNumberDetection?: boolean;
-        /**
-         * the ID of the root element that should be made fullscreen; only used when hideBrowser is set. If not
-         * set, the body is used
-         */
-        rootId?: string;
         /**
          * whether the height of the html root element should be set to 100%, which is required for other elements
          * to cover the full height
@@ -24972,10 +24968,15 @@ declare namespace sap {
            */
           static getInstance(): sap.ui.core.routing.History;
           /**
-           * Determines what the navigation direction for a newly given hash would be It will say Unknown if there
-           * is a history foo - bar (current history) - foo If you now ask for the direction of the hash "foo" you
-           * get Unknown because it might be backwards or forwards. For hash replacements, the history stack will
-           * be replaced at this position for the history.
+           * Determines what the navigation direction for a newly given hash would be.
+           *
+           * Returns the direction as {@link sap.ui.core.routing.HistoryDirection} (for example: Forwards, Backwards,
+           * NewEntry). If no navigation has occurred yet, returns `undefined`. In cases where the direction cannot
+           * be determined (if the same hash appears in multiple places), returns {@link sap.ui.core.routing.HistoryDirection.Unknown}.
+           * For hash replacements, the history stack is updated at the current position.
+           *
+           * Example: It will say "Unknown" if there is a history "foo" - "bar" (current history) - "foo". If you
+           * now ask for the direction of the hash "foo" you get "Unknown" because it might be backwards or forwards.
            *
            *
            * @returns Direction for the given hash or `undefined`, if no navigation has taken place yet.
@@ -25321,7 +25322,23 @@ declare namespace sap {
 
         class Router extends sap.ui.base.EventProvider {
           /**
-           * Instantiates a router
+           * A Router is responsible for managing navigation within an application by interpreting and responding
+           * to changes in the URL hash. It enables applications to define routes, map them to Views/Components, and
+           * control their placement and transitions — all in a structured and declarative way.
+           *
+           * A router:
+           * 	 - Listens to hash changes and matches them to configured route patterns
+           * 	 - Instantiates Views/Components dynamically when a route is matched and caches them for better performance
+           *
+           * 	 - Places Views/Components into UI containers based on the defined targets and aggregations
+           * 	 - Maintains the browser history and consistent back/forward navigation behavior
+           * 	 - Fires events such as `routeMatched` and `routePatternMatched`, allowing developers to run logic when
+           *     routes change
+           * 	 - Handles unmatched routes through a special bypassed configuration for displaying "Not Found" View(s)
+           *     or fallbacks
+           *
+           * It can be used directly or via a {@link sap.ui.core.UIComponent UIComponent}'s metadata (manifest.json)
+           * to create scalable, maintainable, and testable navigation structures across complex applications.
            */
           constructor(
             /**
@@ -31952,6 +31969,18 @@ declare namespace sap {
               };
             }
 
+            namespace Event {
+              /**
+               * An object literal describing the mapping of an event of a class derived from `sap.ui.core.webc.WebComponent`.
+               */
+              type Mapping = {
+                /**
+                 * Defines the target of the mapping of the event to which name it will be mapped to.
+                 */
+                to?: string;
+              };
+            }
+
             namespace Property {
               /**
                * An object literal describing the mapping of a property of a class derived from `sap.ui.core.webc.WebComponent`.
@@ -32004,6 +32033,17 @@ declare namespace sap {
                   | sap.ui.core.webc.WebComponent.MetadataOptionsAssociationMapping;
               };
 
+            /**
+             * An object literal describing an event of a class derived from `sap.ui.core.webc.WebComponent`. See {@link sap.ui.core.webc.WebComponent.MetadataOptions MetadataOptions }
+             * for details on its usage.
+             */
+            type Event = sap.ui.base.ManagedObject.MetadataOptions.Event & {
+              /**
+               * Defines the mapping of the event.
+               */
+              mapping?: sap.ui.core.webc.WebComponent.MetadataOptionsEventMapping;
+            };
+
             /**
              * An object literal describing a property of a class derived from `sap.ui.core.webc.WebComponent`. See
              * {@link sap.ui.core.webc.WebComponent.MetadataOptions MetadataOptions} for details on its usage.
@@ -32058,6 +32098,14 @@ declare namespace sap {
               string,
               string | sap.ui.core.webc.WebComponent.MetadataOptions.Association
             >;
+            /**
+             * An object literal whose properties each define a new event of the ManagedObject subclass. See {@link sap.ui.base.ManagedObject.MetadataOptions.Event Event }
+             * for more details.
+             */
+            events?: Record<
+              string,
+              string | sap.ui.core.webc.WebComponent.MetadataOptions.Event
+            >;
             /**
              * Proxied public getters of the Web Component which are directly accessible on the wrapper Control.
              */
@@ -32068,15 +32116,12 @@ declare namespace sap {
             methods?: string[];
           };
 
-          /**
-           * HACK! This mapping omits the `no-unnecessary-qualifier` error or we need to extend the `tslint.json`!
-           */
           type MetadataOptionsAssociationMapping =
             sap.ui.core.webc.WebComponent.MetadataOptions.Association.Mapping;
 
-          /**
-           * HACK! This mapping omits the `no-unnecessary-qualifier` error or we need to extend the `tslint.json`!
-           */
+          type MetadataOptionsEventMapping =
+            sap.ui.core.webc.WebComponent.MetadataOptions.Event.Mapping;
+
           type MetadataOptionsPropertyMapping =
             sap.ui.core.webc.WebComponent.MetadataOptions.Property.Mapping;
         }
@@ -32190,6 +32235,18 @@ declare namespace sap {
            * @returns Metadata object describing this class
            */
           static getMetadata(): sap.ui.core.webc.WebComponentMetadata;
+          /**
+           * Sets the Web Components busy state
+           *
+           *
+           * @returns `this` to allow method chaining
+           */
+          setBusy(
+            /**
+             * The new busy state to be set
+             */
+            bBusy: boolean
+          ): this;
         }
         /**
          * @since 1.138.0
@@ -33317,7 +33374,7 @@ declare namespace sap {
 
         /**
          * Flag, whether to auto-prefix the ID of the nested Component or not. If this property is set to true the
-         * ID of the Component will be prefixed with the ID of the ComponentContainer followed by a single dash.
+         * ID of the Component will be prefixed with the ID of the ComponentContainer followed by a single hyphen.
          * This property can only be applied initially.
          */
         autoPrefixId?:
@@ -34789,8 +34846,8 @@ declare namespace sap {
          * The value returned by config method in most cases corresponds to the exact value that has been configured
          * by the user or application or that has been determined from the user agent settings. It has not been
          * normalized, but has been validated against a relaxed version of {@link http://www.ietf.org/rfc/bcp/bcp47.txt BCP47},
-         * allowing underscores ('_') instead of the suggested dashes ('-') and not taking the case of letters into
-         * account.
+         * allowing underscores ('_') instead of the suggested hyphens ('-') and not taking the case of letters
+         * into account.
          *
          * The exceptions mentioned above affect languages that have been specified via the URL parameter `sap-language`.
          * That parameter by definition represents an SAP logon language code ('ABAP language'). Most but not all
@@ -35059,7 +35116,7 @@ declare namespace sap {
         setFormatLocale(
           /**
            * the new format locale as a BCP47 compliant language tag; case doesn't matter and underscores can be used
-           * instead of dashes to separate components (compatibility with Java Locale IDs)
+           * instead of hyphens to separate components (compatibility with Java Locale IDs)
            */
           sFormatLocale: string | null
         ): this;
@@ -35116,7 +35173,7 @@ declare namespace sap {
         setLanguage(
           /**
            * the new language as a BCP47 compliant language tag; case doesn't matter and underscores can be used instead
-           * of dashes to separate components (compatibility with Java Locale IDs)
+           * of hyphens to separate components (compatibility with Java Locale IDs)
            */
           sLanguage: string,
           /**
@@ -38748,7 +38805,7 @@ declare namespace sap {
          * Gets current value of property {@link #getAutoPrefixId autoPrefixId}.
          *
          * Flag, whether to auto-prefix the ID of the nested Component or not. If this property is set to true the
-         * ID of the Component will be prefixed with the ID of the ComponentContainer followed by a single dash.
+         * ID of the Component will be prefixed with the ID of the ComponentContainer followed by a single hyphen.
          * This property can only be applied initially.
          *
          * Default value is `false`.
@@ -38901,7 +38958,7 @@ declare namespace sap {
          * Sets a new value for property {@link #getAutoPrefixId autoPrefixId}.
          *
          * Flag, whether to auto-prefix the ID of the nested Component or not. If this property is set to true the
-         * ID of the Component will be prefixed with the ID of the ComponentContainer followed by a single dash.
+         * ID of the Component will be prefixed with the ID of the ComponentContainer followed by a single hyphen.
          * This property can only be applied initially.
          *
          * When called with a value of `null` or `undefined`, the default value of the property will be restored.
@@ -40681,8 +40738,8 @@ declare namespace sap {
          * returned by {@link sap.ui.core.Element#getDomRef} is wrapped and returned.
          *
          * If an ID suffix is given, the ID of this Element is concatenated with the suffix (separated by a single
-         * dash) and the DOM node with that compound ID will be wrapped by jQuery. This matches the UI5 naming convention
-         * for named inner DOM nodes of a control.
+         * hyphen) and the DOM node with that compound ID will be wrapped by jQuery. This matches the UI5 naming
+         * convention for named inner DOM nodes of a control.
          *
          * @ui5-protected Do not call from applications (only from related classes in the framework)
          *
@@ -41116,7 +41173,7 @@ declare namespace sap {
          * their current state (e.g. an initial, not yet rendered control).
          *
          * If an ID suffix is given, the ID of this Element is concatenated with the suffix (separated by a single
-         * dash) and the DOM node with that compound ID will be returned. This matches the UI5 naming convention
+         * hyphen) and the DOM node with that compound ID will be returned. This matches the UI5 naming convention
          * for named inner DOM nodes of a control.
          *
          * @ui5-protected Do not call from applications (only from related classes in the framework)
@@ -44519,8 +44576,8 @@ declare namespace sap {
         /**
          * Get the locale extension as a single string or `null`.
          *
-         * The extension always consists of a singleton character (not 'x'), a dash '-' and one or more extension
-         * token, each separated again with a dash.
+         * The extension always consists of a singleton character (not 'x'), a hyphen '-' and one or more extension
+         * token, each separated again with a hyphen.
          *
          * Use {@link #getExtensions} to get the individual extension tokens as an array.
          *
@@ -44531,7 +44588,7 @@ declare namespace sap {
         /**
          * Get the locale extensions as an array of tokens.
          *
-         * The leading singleton and the separating dashes are not part of the result. If there is no extensions
+         * The leading singleton and the separating hyphens are not part of the result. If there is no extensions
          * section in the locale tag, an empty array is returned.
          *
          *
@@ -44558,7 +44615,7 @@ declare namespace sap {
         /**
          * Get the locale private use section as an array of tokens.
          *
-         * The leading singleton and the separating dashes are not part of the result. If there is no private use
+         * The leading singleton and the separating hyphens are not part of the result. If there is no private use
          * section in the locale tag, an empty array is returned.
          *
          *
@@ -44610,7 +44667,7 @@ declare namespace sap {
         /**
          * Get the locale variants as a single string or `null`.
          *
-         * Multiple variants are separated by a dash '-'.
+         * Multiple variants are separated by a hyphen '-'.
          *
          *
          * @returns the variant or `null`
@@ -44619,8 +44676,8 @@ declare namespace sap {
         /**
          * Get the locale variants as an array of individual variants.
          *
-         * The separating dashes are not part of the result. If there is no variant section in the locale tag, an
-         * empty array is returned.
+         * The separating hyphens are not part of the result. If there is no variant section in the locale tag,
+         * an empty array is returned.
          *
          *
          * @returns the individual variant sections
@@ -49770,11 +49827,21 @@ declare namespace sap {
         /**
          * Initializes the component instance after creation.
          *
-         * Applications must not call this hook method directly, it is called by the framework while the constructor
-         * of a Component is executed.
+         * The primary responsibility of this method is to create the root control of the component and manage its
+         * aggregation in the "rootControl" aggregation. This is performed internally by invoking the {@link sap.ui.core.UIComponent#createContent }
+         * method.
+         *
+         * Depending on the class metadata (e.g., if the "sap.ui.core.IAsyncContentCreation" interface is implemented),
+         * the root control may be created synchronously or asynchronously.
          *
-         * Subclasses of `UIComponent` should override this hook to implement any necessary initialization. **When
-         * overriding this function make sure to invoke the `init` function of the `UIComponent` as well!**
+         * Additionally, this method is responsible for creating the router and targets instances.
+         *
+         * **Note:** Applications must not call this hook method directly; it is invoked by the framework during
+         * the execution of the Component constructor.
+         *
+         * Subclasses of `UIComponent` should override this hook to implement any required initialization logic.
+         * **When overriding this method, ensure that you always invoke the `init` method of the `UIComponent` base
+         * class.**
          *
          * @ui5-protected Do not call from applications (only from related classes in the framework)
          */
@@ -51554,7 +51621,7 @@ declare namespace sap {
       /**
        * A string type representing an ID or a name.
        *
-       * Allowed is a sequence of characters (capital/lowercase), digits, underscores, dashes, points and/or colons.
+       * Allowed is a sequence of characters (capital/lowercase), digits, underscores, hyphens, dots and/or colons.
        * It may start with a character or underscore only.
        */
       type ID = string;
@@ -59279,8 +59346,8 @@ declare namespace sap {
                  */
                 usePreliminaryContext?: boolean;
                 /**
-                 * **Deprecated**, use `groupId` instead. Sets the batch group id to be used for requests originating from
-                 * the binding.
+                 * **Deprecated as of version 1.31.0**, use `groupId` instead. Sets the batch group id to be used for requests
+                 * originating from the binding.
                  */
                 batchGroupId?: string;
               }
@@ -59433,8 +59500,8 @@ declare namespace sap {
                  */
                 usePreliminaryContext?: boolean;
                 /**
-                 * **Deprecated**, use `groupId` instead. Sets the batch group id to be used for requests originating from
-                 * the binding.
+                 * **Deprecated as of version 1.31.0**, use `groupId` instead. Sets the batch group id to be used for requests
+                 * originating from the binding.
                  */
                 batchGroupId?: string;
                 /**
@@ -59928,8 +59995,8 @@ declare namespace sap {
                  */
                 refreshAfterChange?: boolean;
                 /**
-                 * Whether to sequentialize all requests, needed in case the service cannot handle parallel requests. **Deprecated**
-                 * as of version 1.128.0, the concept has been discarded.
+                 * Whether to sequentialize all requests, needed in case the service cannot handle parallel requests. **Deprecated
+                 * as of version 1.128.0**, the concept has been discarded.
                  */
                 sequentializeRequests?: boolean;
                 /**
@@ -59964,19 +60031,20 @@ declare namespace sap {
                  */
                 withCredentials?: boolean;
                 /**
-                 * **Deprecated** for security reasons. Use strong server side authentication instead. Password for the
-                 * service.
+                 * **Deprecated as of version 1.75.0** for security reasons. Use strong server side authentication instead.
+                 * Password for the service.
                  */
                 password?: string;
                 /**
-                 * **Deprecated** This parameter does not prevent creation of annotations from the metadata document in
-                 * this model's metamodel. Whether to skip the automated loading of annotations from the metadata document.
-                 * Loading annotations from metadata does not have any effects (except the lost performance by invoking
-                 * the parser) if there are no annotations inside the metadata document
+                 * **Deprecated as of version 1.112.0** This parameter does not prevent creation of annotations from the
+                 * metadata document in this model's metamodel. Whether to skip the automated loading of annotations from
+                 * the metadata document. Loading annotations from metadata does not have any effects (except the lost performance
+                 * by invoking the parser) if there are no annotations inside the metadata document
                  */
                 skipMetadataAnnotationParsing?: boolean;
                 /**
-                 * **Deprecated** for security reasons. Use strong server side authentication instead. UserID for the service.
+                 * **Deprecated as of version 1.75.0** for security reasons. Use strong server side authentication instead.
+                 * UserID for the service.
                  */
                 user?: string;
               }
@@ -60315,8 +60383,8 @@ declare namespace sap {
                  */
                 usePreliminaryContext?: boolean;
                 /**
-                 * **Deprecated**, use `groupId` instead. Sets the batch group id to be used for requests originating from
-                 * the binding.
+                 * **Deprecated as of version 1.31.0**, use `groupId` instead. Sets the batch group id to be used for requests
+                 * originating from the binding.
                  */
                 batchGroupId?: string;
               }
@@ -60402,14 +60470,14 @@ declare namespace sap {
                  */
                 usePreliminaryContext?: boolean;
                 /**
-                 * **Deprecated**, use `groupId` instead. Sets the batch group id to be used for requests originating from
-                 * the binding.
+                 * **Deprecated as of version 1.31.0**, use `groupId` instead. Sets the batch group id to be used for requests
+                 * originating from the binding.
                  */
                 batchGroupId?: string;
                 /**
-                 * Deprecated since 1.102.0, as {@link sap.ui.model.odata.OperationMode.Auto} is deprecated; the threshold
-                 * that defines how many entries should be fetched at least by the binding if `operationMode` is set to
-                 * `Auto`.
+                 * **Deprecated as of version 1.102.0**, as {@link sap.ui.model.odata.OperationMode.Auto} is deprecated;
+                 * the threshold that defines how many entries should be fetched at least by the binding if `operationMode`
+                 * is set to `Auto`.
                  */
                 threshold?: int;
               }
@@ -60468,27 +60536,22 @@ declare namespace sap {
              * of levels, with only a single initial OData request.
              *
              * For services without the `hierarchy-node-descendant-count-for` annotation, the `numberOfExpandedLevels`
-             * property is not supported and deprecated.
+             * property is not supported and deprecated since 1.44.5.
              *
-             * Operation Modes: For a full definition and explanation of all OData binding operation modes, see {@link sap.ui.model.odata.OperationMode}.
+             * The OData service must always return node collections which are sufficient to create a valid hierarchy
+             * on the client. This means that for each node in the response all parent nodes up to the hierarchy root
+             * must also be contained in the response. Note that this rule applies independent of any filters set for
+             * the binding.
              *
-             * OperationMode.Server: Filtering on the `ODataTreeBinding` is only supported with filters of type {@link sap.ui.model.FilterType.Application}.
-             * Be aware that this applies only to filters which do not prevent the creation of a hierarchy. So filtering
-             * on a property (e.g. a "Customer") is fine, as long as the application ensures that the responses from
-             * the back end are sufficient to create a valid hierarchy on the client. Subsequent paging requests for
-             * sibling and child nodes must also return responses, since the filters are sent with every request. Using
-             * control-defined filters (see {@link sap.ui.model.FilterType.Control}) via the {@link #filter} function
-             * is not supported for the operation mode `Server`.
+             * You must not define filters on tree annotation properties for this binding as this interferes with hierarchy
+             * filters defined by the binding itself.
              *
-             * OperationMode.Client and OperationMode.Auto: The ODataTreeBinding supports control-defined filters only
-             * in operation modes `Client` and `Auto`. With these operation modes, the filters and sorters are applied
-             * on the client, like for the {@link sap.ui.model.odata.v2.ODataListBinding}.
+             * Notes On Operation Modes: For a full definition and explanation of all OData binding operation modes,
+             * see {@link sap.ui.model.odata.OperationMode}.
              *
              * The operation modes `Client` and `Auto` are only supported for services which expose the hierarchy annotations
-             * mentioned above, but do **not** expose the `hierarchy-node-descendant-count-for` annotation. Services
-             * with hierarchy annotations including the `hierarchy-node-descendant-count-for` annotation, do **not**
-             * support the operation modes `Client` and `Auto`. **Note:** {@link sap.ui.model.odata.OperationMode.Auto }
-             * is deprecated since 1.102.0.
+             * mentioned above, but do **not** expose the `hierarchy-node-descendant-count-for` annotation. **Note:**
+             * {@link sap.ui.model.odata.OperationMode.Auto} is deprecated since 1.102.0.
              *
              * **Note:** OData tree bindings do neither support {@link sap.ui.model.Binding#suspend suspend} nor {@link sap.ui.model.Binding#resume resume}.
              * See:
@@ -60551,10 +60614,15 @@ declare namespace sap {
                    * property has to be an integer type
                    */
                   hierarchyNodeDescendantCountFor?: string;
+                  /**
+                   * The property name in the same type holding the preorder rank for the node; the type of the referenced
+                   * property has to be an integer type
+                   */
+                  hierarchyPreorderRankFor?: string;
                 };
                 /**
                  * The number of levels that are auto-expanded initially. Setting this property might lead to multiple back-end
-                 * requests. The auto-expand feature is **deprecated for services without the `hierarchy-node-descendant-count-for`
+                 * requests. The auto-expand feature is **deprecated as of Version 1.44.5 for services without the `hierarchy-node-descendant-count-for`
                  * annotation**
                  */
                 numberOfExpandedLevels?: number;
@@ -60570,7 +60638,6 @@ declare namespace sap {
                  * The operation mode for this binding; defaults to the model's default operation mode if not specified.
                  * {@link sap.ui.model.odata.OperationMode.Auto OperationMode.Auto} is only supported for services which
                  * expose the hierarchy annotations, yet do **NOT** expose the `hierarchy-node-descendant-count-for` annotation.
-                 * **Note:** {@link sap.ui.model.odata.OperationMode.Auto} is deprecated since 1.102.0.
                  */
                 operationMode?: sap.ui.model.odata.OperationMode;
                 /**
@@ -60580,13 +60647,9 @@ declare namespace sap {
                  */
                 threshold?: number;
                 /**
-                 * Deprecated since 1.102.0, as {@link sap.ui.model.odata.OperationMode.Auto} is deprecated; whether `$filter`
-                 * statements should be used for the `$count` / `$inlinecount` requests and for the data request if the
-                 * operation mode is {@link sap.ui.model.odata.OperationMode.Auto OperationMode.Auto}. Use this feature
-                 * only if your back end supports pre-filtering the tree and is capable of responding with a complete tree
-                 * hierarchy, including all inner nodes. To construct the hierarchy on the client, it is mandatory that
-                 * all filter matches include their complete parent chain up to the root level. If {@link sap.ui.model.odata.OperationMode.Client OperationMode.Client }
-                 * is used, the complete collection without filters is requested; filters are applied on the client side.
+                 * Whether `$filter` statements should be used for the `$count` / `$inlinecount` requests and for the data
+                 * request if the operation mode is {@link sap.ui.model.odata.OperationMode.Auto OperationMode.Auto} or
+                 * {@link sap.ui.model.odata.OperationMode.Client OperationMode.Client}
                  */
                 useServersideApplicationFilters?: boolean;
                 /**
@@ -60600,6 +60663,18 @@ declare namespace sap {
                  * or {@link sap.ui.model.odata.OperationMode.Auto OperationMode.Auto} is used.
                  */
                 treeState?: any;
+                /**
+                 * This parameter is experimental as of version 1.141.0.
+                 *
+                 * Whether the tree state is restored on hierarchy maintenance, such as adding, removing, or deleting a
+                 * node. This is only supported if the following conditions are met:
+                 * 	 - The binding has to use {@link sap.ui.model.odata.OperationMode.Server OperationMode.Server}
+                 * 	 - The `"hierarchy-node-descendant-count-for"` annotation must be present in the service metadata or
+                 *     provided via `treeAnnotationProperties.hierarchyNodeDescendantCountFor`
+                 * 	 - The `"hierarchy-preorder-rank-for"` annotation must be present in the service metadata or provided
+                 *     via `treeAnnotationProperties.hierarchyPreorderRankFor`
+                 */
+                restoreTreeStateAfterChange?: boolean;
                 /**
                  * Defines the count mode of this binding; if not specified, the default count mode of the binding's model
                  * is applied. The resulting count mode must not be {@link sap.ui.model.odata.CountMode.None}.
@@ -60611,16 +60686,16 @@ declare namespace sap {
                  */
                 usePreliminaryContext?: boolean;
                 /**
-                 * **Deprecated**, use `groupId` instead. Sets the batch group id to be used for requests originating from
-                 * this binding
+                 * **Deprecated as of version 1.31.0**, use `groupId` instead. Sets the batch group id to be used for requests
+                 * originating from this binding
                  */
                 batchGroupId?: string;
                 /**
                  * A map describing the navigation properties between entity sets, which is used for constructing and paging
                  * the tree. Keys in this object are entity names, whereas the values name the navigation properties.
                  *
-                 * **Deprecated: since 1.44** The use of navigation properties to build up the hierarchy structure is deprecated.
-                 * It is recommended to use the hierarchy annotations mentioned above instead.
+                 * **Deprecated as of version 1.44** The use of navigation properties to build up the hierarchy structure
+                 * is deprecated. It is recommended to use the hierarchy annotations mentioned above instead.
                  */
                 navigation?: object;
               },
@@ -60740,7 +60815,7 @@ declare namespace sap {
                  */
                 urlParameters?: Record<string, any>;
                 /**
-                 * **Deprecated - use `groupId` instead**
+                 * **Deprecated as of version 1.31.0**, use `groupId` instead
                  */
                 batchGroupId?: string;
               }
@@ -60803,7 +60878,7 @@ declare namespace sap {
                  */
                 headers?: Record<string, string>;
                 /**
-                 * Deprecated - use `groupId` instead
+                 * **Deprecated as of version 1.31.0**, use `groupId` instead
                  */
                 batchGroupId?: string;
                 /**
@@ -60943,7 +61018,7 @@ declare namespace sap {
                */
               mParameters: {
                 /**
-                 * Deprecated - use `groupId` instead
+                 * **Deprecated as of version 1.31.0**, use `groupId` instead
                  */
                 batchGroupId?: string;
                 /**
@@ -61576,9 +61651,9 @@ declare namespace sap {
                */
               oContext?: object,
               /**
-               * Deprecated, use {@link #getObject} function with 'select' and 'expand' parameters instead. Whether entities
-               * for navigation properties of this property which have been read via `$expand` are part of the return
-               * value.
+               * **Deprecated as of version 1.41.0**, use {@link #getObject} function with 'select' and 'expand' parameters
+               * instead. Whether entities for navigation properties of this property which have been read via `$expand`
+               * are part of the return value.
                */
               bIncludeExpandEntries?: boolean
             ): any;
@@ -61814,7 +61889,7 @@ declare namespace sap {
                  */
                 error?: Function;
                 /**
-                 * Deprecated - use `groupId` instead
+                 * **Deprecated as of version 1.31.0**, use `groupId` instead
                  */
                 batchGroupId?: string;
                 /**
@@ -61927,7 +62002,7 @@ declare namespace sap {
                  */
                 headers?: Record<string, string>;
                 /**
-                 * Deprecated - use `groupId` instead
+                 * **Deprecated as of version 1.31.0**, use `groupId` instead
                  */
                 batchGroupId?: string;
                 /**
@@ -62224,13 +62299,14 @@ declare namespace sap {
                  */
                 error?: Function;
                 /**
-                 * **Deprecated**, use `groupId` instead
+                 * **Deprecated as of version 1.31.0**, use `groupId` instead
                  */
                 batchGroupId?: string;
                 /**
-                 * **Deprecated** since 1.38.0; use the `defaultUpdateMethod` constructor parameter instead. If unset, the
-                 * update method is determined from the `defaultUpdateMethod` constructor parameter. If `true`, `sap.ui.model.odata.UpdateMethod.MERGE`
-                 * is used for update operations; if set to `false`, `sap.ui.model.odata.UpdateMethod.PUT` is used.
+                 * **Deprecated as of version 1.38.0**, use the `defaultUpdateMethod` constructor parameter instead. If
+                 * unset, the update method is determined from the `defaultUpdateMethod` constructor parameter. If `true`,
+                 * `sap.ui.model.odata.UpdateMethod.MERGE` is used for update operations; if set to `false`, `sap.ui.model.odata.UpdateMethod.PUT`
+                 * is used.
                  */
                 merge?: boolean;
               }
@@ -62289,7 +62365,7 @@ declare namespace sap {
                  */
                 headers?: Record<string, string>;
                 /**
-                 * Deprecated - use `groupId` instead
+                 * **Deprecated as of version 1.31.0**, use `groupId` instead
                  */
                 batchGroupId?: string;
                 /**
@@ -63100,7 +63176,7 @@ declare namespace sap {
              *
              * Annotations on an Operation or a Parameter: Since 1.71.0, for annotations on an operation or a parameter,
              * the binding parameter's name is stripped off any dynamic "14.5.12 Expression edm:Path" and "14.5.13 Expression
-             * edm:PropertyPath" where it might be used as a first segment. Since 1.76.0 this does not apply to annotations
+             * edm:PropertyPath" where it might be used as a first segment. Since 1.76.0, this does not apply to annotations
              * on a parameter. In the former case, we assume that the resulting data binding is relative to the parent
              * context of the operation binding, that is, to the context representing the binding parameter itself.
              * In the latter case, we assume that the resulting data binding is relative to the parameter context of
@@ -63423,7 +63499,7 @@ declare namespace sap {
              *
              * Annotations on an Operation or a Parameter: Since 1.71.0, for annotations on an operation or a parameter,
              * the binding parameter's name is stripped off any dynamic "14.5.12 Expression edm:Path" and "14.5.13 Expression
-             * edm:PropertyPath" where it might be used as a first segment. Since 1.76.0 this does not apply to annotations
+             * edm:PropertyPath" where it might be used as a first segment. Since 1.76.0, this does not apply to annotations
              * on a parameter. In the former case, we assume that the resulting data binding is relative to the parent
              * context of the operation binding, that is, to the context representing the binding parameter itself.
              * In the latter case, we assume that the resulting data binding is relative to the parameter context of
@@ -63538,6 +63614,11 @@ declare namespace sap {
                  * apply to annotations on a parameter (since 1.76.0).
                  */
                 overload?: object;
+                /**
+                 * Optional prefix to be added to each dynamic "14.5.12 Expression edm:Path" and "14.5.13 Expression edm:PropertyPath";
+                 * is either an empty string or a path ending with a "/" (since 1.141.0)
+                 */
+                prefix?: string;
               }
             ): string;
           }
@@ -63741,7 +63822,7 @@ declare namespace sap {
              * as a binding context. Exceptions hold for status APIs like {@link #isDeleted}, {@link #isKeepAlive},
              * {@link #hasPendingChanges}, {@link #resetChanges}, or {@link #isSelected} (returns `false` since 1.114.0).
              *
-             * Since 1.105 such a pending deletion is a pending change. It causes `hasPendingChanges` to return `true`
+             * Since 1.105, such a pending deletion is a pending change. It causes `hasPendingChanges` to return `true`
              * for the context, the binding containing it, and the model. The `resetChanges` method called on the context,
              * the binding, or the model cancels the deletion and restores the context.
              *
@@ -63785,7 +63866,7 @@ declare namespace sap {
                * binding is used, see {@link #getUpdateGroupId}. Since 1.81, if this context is transient (see {@link #isTransient}),
                * no group ID needs to be specified. Since 1.98.0, you can use `null` to prevent the DELETE request in
                * case of a kept-alive context that is not in the collection and of which you know that it does not exist
-               * on the server anymore (for example, a draft after activation). Since 1.108.0 the usage of a group ID
+               * on the server anymore (for example, a draft after activation). Since 1.108.0, the usage of a group ID
                * with {@link sap.ui.model.odata.v4.SubmitMode.API} is possible. Since 1.121.0, you can use the '$single'
                * group ID to send a DELETE request as fast as possible; it will be wrapped in a batch request as for a
                * '$auto' group.
@@ -64107,8 +64188,8 @@ declare namespace sap {
                */
               oParameters: {
                 /**
-                 * Whether the node should be copied instead of moved (@experimental as of version 1.135.0). The returned
-                 * promise resolves with the index for the copied node.
+                 * Whether the node should be copied instead of moved. The returned promise resolves with the index for
+                 * the copied node. Supported since 1.141.0.
                  */
                 copy?: boolean;
                 /**
@@ -64222,7 +64303,7 @@ declare namespace sap {
             requestParent(): Promise<sap.ui.model.odata.v4.Context | null>;
             /**
              * Returns a promise on the property value for the given path relative to this context. The path is expected
-             * to point to a structural property with primitive type. Since 1.81.1 it is possible to request more than
+             * to point to a structural property with primitive type. Since 1.81.1, it is possible to request more than
              * one property. Property values that are not cached yet are requested from the back end.
              * See:
              * 	sap.ui.model.odata.v4.ODataMetaModel#requestUI5Type
@@ -64321,7 +64402,7 @@ declare namespace sap {
                * (unless listed explicitly), for example `[{$PropertyPath : "*"}, {$NavigationPropertyPath : "EMPLOYEE_2_MANAGER"}]`
                * or `[{$PropertyPath : "EMPLOYEE_2_MANAGER/*"}]`.
                *
-               * Since 1.82.0 absolute paths are supported. Absolute paths must start with the entity container (example
+               * Since 1.82.0, absolute paths are supported. Absolute paths must start with the entity container (example
                * "/com.sap.gateway.default.iwbep.tea_busi.v0001.Container/TEAMS") of the service. All (navigation) properties
                * in the complete model matching such an absolute path are updated. Since 1.85.0, "14.4.11 Expression edm:String"
                * is accepted as well.
@@ -64402,7 +64483,7 @@ declare namespace sap {
             /**
              * Sets a new value for the property identified by the given path. The path is relative to this context
              * and is expected to point to a structural property with primitive type or, since 1.85.0, to an instance
-             * annotation. Since 1.122.0 the client-side annotation "@$ui5.context.isSelected" can be given as a path.
+             * annotation. Since 1.122.0, the client-side annotation "@$ui5.context.isSelected" can be given as a path.
              * Note: Writing to a client-side annotation never initiates a PATCH request, even if `sGroupId` is given.
              * Thus, reverting the value of this annotation cannot be done via {@link #resetChanges}.
              * See:
@@ -64854,11 +64935,12 @@ declare namespace sap {
              * messages will be related to the return value context only. Such a message can only be connected to a
              * corresponding control if the control's property bindings use the return value context as binding context.
              *
-             *  A return value context may also be provided if the parent context's path contains a maximum of one navigation
-             * property. In addition to the existing preconditions for a return value context, the metadata has to specify
-             * a partner attribute for the navigation property and the partner relationship has to be bi-directional.
-             * Also the navigation property binding has to be available in the entity set of the first segment in the
-             * parent context's path (@experimental as of version 1.119.0).
+             *  Since 1.141.0, a return value context may also be provided if the parent context's path contains a maximum
+             * of one navigation property. In addition to the existing preconditions for a return value context, the
+             * metadata has to specify a partner attribute for the navigation property and the partner relationship
+             * has to be bi-directional. Also a navigation property binding has to be available for the entity set of
+             * the first segment in the parent context's path. **Note:** Ensure your service implementation returns
+             * all selected key properties; otherwise, no return value context is provided.
              */
             invoke(
               /**
@@ -65022,7 +65104,7 @@ declare namespace sap {
              * requests. Call {@link #resume} to resume the binding. Before 1.53.0, this method was not supported and
              * threw an error. Since 1.97.0, pending changes are ignored if they relate to a {@link sap.ui.model.odata.v4.Context#isKeepAlive kept-alive }
              * context of this binding. Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isTransient transient} contexts
-             * of a {@link #getRootBinding root binding} do not count as pending changes. Since 1.108.0 {@link sap.ui.model.odata.v4.Context#delete deleted }
+             * of a {@link #getRootBinding root binding} do not count as pending changes. Since 1.108.0, {@link sap.ui.model.odata.v4.Context#delete deleted }
              * contexts do not count as pending changes.
              * See:
              * 	{@link https://ui5.sap.com/#/topic/b0f5c531e5034a27952cc748954cbe39 Suspend and Resume}
@@ -65291,12 +65373,15 @@ declare namespace sap {
              * set `bSkipRefresh` to `true`. To avoid errors you must skip this refresh when using {@link sap.ui.model.odata.v4.Context#requestSideEffects }
              * in the same $batch to refresh the complete collection containing the newly created entity.
              *
-             * Since 1.115.0 it is possible to create nested entities in a collection-valued navigation property together
+             * Since 1.115.0, it is possible to create nested entities in a collection-valued navigation property together
              * with the entity (so-called "deep create"), for example a list of items for an order. For this purpose,
              * bind the list relative to a transient context. Calling this method then adds a transient entity to the
              * parent's navigation property, which is sent with the payload of the parent entity. Such a nested context
              * cannot be inactive.
              *
+             * **Caution:** Only a single list must be bound to the same collection-valued navigation property relative
+             * to a transient context. Created data cannot be shared between list bindings.
+             *
              * **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
@@ -65304,7 +65389,7 @@ declare namespace sap {
              * 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
+             * 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
              * to the property adds it to the POST request of the parent entity, and by this the create becomes deep.
              *
@@ -65356,7 +65441,7 @@ declare namespace sap {
                */
               bSkipRefresh?: boolean,
               /**
-               * Whether the entity is inserted at the end of the list. Supported since 1.66.0. Since 1.99.0 the first
+               * Whether the entity is inserted at the end of the list. Supported since 1.66.0. Since 1.99.0, the first
                * insertion determines the overall position of created contexts within the binding's context list. Every
                * succeeding insertion is relative to the created contexts within this list.
                */
@@ -65712,7 +65797,7 @@ declare namespace sap {
             getHeaderContext(): sap.ui.model.odata.v4.Context | null;
             /**
              * Calls {@link sap.ui.model.odata.v4.Context#setKeepAlive} at the context for the given path and returns
-             * it. Since 1.100.0 the function always returns such a context. If none exists yet, it is created without
+             * it. Since 1.100.0, the function always returns such a context. If none exists yet, it is created without
              * data and a request for its entity is sent.
              * See:
              * 	sap.ui.model.odata.v4.ODataModel#getKeepAliveContext
@@ -66153,7 +66238,7 @@ declare namespace sap {
              * requests. Call {@link #resume} to resume the binding. Before 1.53.0, this method was not supported and
              * threw an error. Since 1.97.0, pending changes are ignored if they relate to a {@link sap.ui.model.odata.v4.Context#isKeepAlive kept-alive }
              * context of this binding. Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isTransient transient} contexts
-             * of a {@link #getRootBinding root binding} do not count as pending changes. Since 1.108.0 {@link sap.ui.model.odata.v4.Context#delete deleted }
+             * of a {@link #getRootBinding root binding} do not count as pending changes. Since 1.108.0, {@link sap.ui.model.odata.v4.Context#delete deleted }
              * contexts do not count as pending changes.
              * See:
              * 	{@link https://ui5.sap.com/#/topic/b0f5c531e5034a27952cc748954cbe39 Suspend and Resume}
@@ -66721,9 +66806,9 @@ declare namespace sap {
              * results either in a simple name like "EMPLOYEES" or maybe in a path like "some.other.EntityContainer/SomeEntitySet".
              *  The path must not continue after "@sapui.name".
              *
-             * If the current object is a string value, that string value is treated as a relative path and followed
-             * step-by-step before the next segment is processed. Except for this, a path must not continue if it comes
-             * across a non-object value. Such a string value can be a qualified name (example path "/$EntityContainer/..."),
+             * If the current object is a string value, that string value is treated as an absolute or relative path
+             * and followed step-by-step before the next segment is processed. Except for this, a path must not continue
+             * if it comes across a non-object value. Such a string value can be a qualified name (example path "/$EntityContainer/..."),
              * a simple identifier (example path "/TEAMS/$NavigationPropertyBinding/TEAM_2_EMPLOYEES/...") including
              * the special name "$ReturnType" (since 1.71.0), or even a path according to "14.5.12 Expression edm:Path"
              * etc. (example path "/TEAMS/@com.sap.vocabularies.UI.v1.LineItem/0/Value/$Path/...".
@@ -66785,6 +66870,10 @@ declare namespace sap {
              * way, "/acme.DefaultContainer/EMPLOYEES" addresses the "EMPLOYEES" child of the schema child named "acme.DefaultContainer".
              * This also works indirectly ("/$EntityContainer/EMPLOYEES") and implicitly ("/EMPLOYEES", see below).
              *
+             * Since 1.140.0, the special name "$count" can be used as the last segment instead of an OData simple identifier.
+             * For an entity set or a collection-valued (structural or navigation) property, it is treated as a property
+             * of type "Edm.Int64". Otherwise, it is invalid.
+             *
              * A segment which represents an OData simple identifier (or the special names "$ReturnType", since 1.71.0,
              * or "$Parameter", since 1.73.0) needs special preparations. The same applies to the empty segment after
              * a trailing slash.   If the current object has a "$Action", "$Function" or "$Type" property, it
@@ -66871,7 +66960,7 @@ declare namespace sap {
                 /**
                  * Scope for lookup of aliases for computed annotations (since 1.43.0) as a map from alias to a module (like
                  * `{AH : AnnotationHelper}`) or function (like `{format : AnnotationHelper.format}`); the alias must not
-                 * contain a dot. Since 1.120.3 looking up a computed annotation via its global name is **deprecated**;
+                 * contain a dot. Since 1.120.3, looking up a computed annotation via its global name is **deprecated**;
                  * always use this scope instead.
                  */
                 scope?: Record<string, object | Function>;
@@ -67822,8 +67911,8 @@ declare namespace sap {
              * Returns a context with the given path belonging to a matching list binding that has been marked with
              * `$$getKeepAliveContext` (see {@link #bindList}). If such a matching binding can be found, a context is
              * returned and kept alive (see {@link sap.ui.model.odata.v4.ODataListBinding#getKeepAliveContext}). Since
-             * 1.100.0 a temporary binding is used if no such binding could be found. If such a binding is created or
-             * resolved later, the context and its data are transferred to it, and the temporary binding is destroyed
+             * 1.100.0, a temporary binding is used if no such binding could be found. If such a binding is created
+             * or resolved later, the context and its data are transferred to it, and the temporary binding is destroyed
              * again.
              *
              * A `$$getKeepAliveContext` binding matches if its resolved binding path is the collection path of the
@@ -68067,6 +68156,28 @@ declare namespace sap {
                */
               sGroupId?: string
             ): void;
+            /**
+             * Sets the "odata.continue-on-error" preference for the **current** batch request associated with the given
+             * group ID. This method can be called early on, when the batch queue is still empty, or even synchronously
+             * after {@link #submitBatch} - just as long as the $batch request is not already being sent to the server.
+             * It needs to be called again for future batch requests with the same group ID. It is safe to call it multiple
+             * times for the same batch request.
+             *
+             * **Caution:** Make sure that no user input is lost due to a side-effects GET being applied even after
+             * a failed PATCH. It's safe to use this method if, for example, only actions are invoked or when {@link sap.ui.model.odata.v4.Context#setProperty }
+             * is used without `bRetry` for mass updates.
+             *
+             * @since 1.141.0
+             */
+            setContinueOnError(
+              /**
+               * A valid group ID as specified in {@link sap.ui.model.odata.v4.ODataModel}. Avoid '$auto' to control which
+               * requests are affected by this preference. Using a {@link module:sap/base/util/uid UID} may be one way
+               * to achieve this, but take care to replace hyphens with underscores: `"$auto." + uid().replaceAll("-",
+               * "_")`
+               */
+              sGroupId: string
+            ): void;
             /**
              * Method not supported
              *
@@ -68412,7 +68523,7 @@ declare namespace sap {
              * Sets the new current value and updates the cache. If the value cannot be accepted or cannot be updated
              * on the server, an error is logged to the console and added to the message manager as a technical message.
              * Unless preconditions fail synchronously, a {@link sap.ui.model.odata.v4.ODataModel#event:propertyChange 'propertyChange' }
-             * event is fired and provides a promise on the outcome of the asynchronous operation. Since 1.122.0 this
+             * event is fired and provides a promise on the outcome of the asynchronous operation. Since 1.122.0, this
              * method allows updates to the client-side annotation "@$ui5.context.isSelected". Note: Changing the value
              * of a client-side annotation never initiates a PATCH request, no matter which `sGroupId` is given. Thus,
              * it cannot be reverted via {@link #resetChanges}.
@@ -70733,12 +70844,13 @@ declare namespace sap {
                */
               async?: boolean;
               /**
-               * **Deprecated** for security reasons. Use strong server side authentication instead. UserID for the service.
+               * **Deprecated as of version 1.75.0** for security reasons. Use strong server side authentication instead.
+               * UserID for the service.
                */
               user?: string;
               /**
-               * **Deprecated** for security reasons. Use strong server side authentication instead. Password for the
-               * service.
+               * **Deprecated as of version 1.75.0** for security reasons. Use strong server side authentication instead.
+               * Password for the service.
                */
               password?: string;
               /**
@@ -74707,8 +74819,14 @@ declare namespace sap {
              */
             oFormatOptions?: {
               /**
-               * The number of decimals to be used for formatting the number part of the unit; defaults to **3** if none
-               * of the format options `maxFractionDigits`, `minFractionDigits` or `decimals` is given
+               * The number of decimals to be used for formatting the numerical value of the unit composite type; if none
+               * of the format options `maxFractionDigits`, `minFractionDigits` or `decimals` are given, the following
+               * defaults apply:
+               * 	 -  **0** if the numerical value is of an OData integer type, i.e. {@link sap.ui.model.odata.type.Int }
+               *     or {@link sap.ui.model.odata.type.Int64}
+               * 	 -  the **scale constraint of the numerical value's type** if this type is {@link sap.ui.model.odata.type.Decimal }
+               *     and the scale is not "variable"
+               * 	 -  **3** otherwise
                */
               decimals?: object;
               /**
@@ -74986,7 +75104,7 @@ declare namespace sap {
         async?: boolean;
 
         /**
-         * Additional information for the request (if available) **deprecated**
+         * **Deprecated as of version 1.38.0.**, additional information for the request (if available)
          */
         info?: string;
 
@@ -75041,7 +75159,7 @@ declare namespace sap {
         async?: boolean;
 
         /**
-         * Additional information for the request (if available) **deprecated**
+         * **Deprecated as of version 1.38.0.**, additional information for the request (if available)
          */
         info?: string;
 
@@ -82165,7 +82283,7 @@ declare namespace sap {
            *
            *
            * 	 - Trim spaces off the string on both sides. For example: `" hello "` becomes `"hello"`.
-           * 	 - Assume that dashes and underscores are analogs for a space. For example: `"sold-to party"` and `"sold
+           * 	 - Assume that hyphens and underscores are analogs for a space. For example: `"sold-to party"` and `"sold
            *     to party"` are equivalent, and would both convert to the camelCase `"soldToParty"`.
            * 	 - Trim multiple spaces between words. For example: `"hello____world"` becomes `"hello world"`.
            * 	 - Remove any characters that are not alphanumeric or whitespace. For example: `"(hello)"` becomes `"hello"`.