@openui5/ts-types 1.107.1 → 1.108.0

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

@@ -235,7 +235,7 @@ interface JQuery<TElement = HTMLElement> extends Iterable<TElement> {
   /**
    * Sets the text selection in the first element of the collection.
    *
-   * <b>Note</b>: This feature is only supported for input element’s type of text, search, url, tel and password.
+   * <b>Note</b>: This feature is only supported for input element's type of text, search, url, tel and password.
    */
   selectText(
     /**
@@ -264,7 +264,7 @@ interface JQuery<TElement = HTMLElement> extends Iterable<TElement> {
   ): jQuery;
 }
 
-// For Library Version: 1.107.1
+// For Library Version: 1.108.0
 
 declare module "sap/base/assert" {
   /**
@@ -966,6 +966,9 @@ declare module "sap/base/security/URLListValidator" {
      *
      * Note: Adding the first entry to the list of allowed entries will disallow all URLs but the ones matching
      * the newly added entry.
+     *
+     * **Note**: It is strongly recommended to set a path only in combination with an origin (never set a path
+     * alone). There's almost no case where checking only the path of a URL would allow to ensure its validity.
      */
     add(
       /**
@@ -1000,7 +1003,13 @@ declare module "sap/base/security/URLListValidator" {
     /**
      * Validates a URL. Check if it's not a script or other security issue.
      *
-     * Split URL into components and check for allowed characters according to RFC 3986:
+     * **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.
+     *
+     * Details: Splits the given URL into components and checks for allowed characters according to RFC 3986:
      *
      *
      * ```javascript
@@ -2273,6 +2282,50 @@ declare module "sap/ui/core/ComponentSupport" {
   export default ComponentSupport;
 }
 
+declare module "sap/ui/core/date/CalendarUtils" {
+  /**
+   * @SINCE 1.108.0
+   *
+   * Provides calendar-related utilities.
+   */
+  interface CalendarUtils {
+    /**
+     * @SINCE 1.108.0
+     *
+     * Resolves calendar week configuration.
+     *
+     * Returns an object with the following fields:
+     * 	 - `firstDayOfWeek`: specifies the first day of the week starting with `0` (which is Sunday)
+     * 	 - `minimalDaysInFirstWeek`: minimal days at the beginning of the year which define the first calendar
+     * 			week
+     *
+     * @returns The calendar week configuration, or `undefined for an invalid value of sap.ui.core.date.CalendarWeekNumbering`.
+     */
+    getWeekConfigurationValues(
+      /**
+       * The calendar week numbering; if omitted, `Default` is used.
+       */
+      sCalendarWeekNumbering?:
+        | sap.ui.core.date.CalendarWeekNumbering
+        | keyof typeof sap.ui.core.date.CalendarWeekNumbering,
+      /**
+       * The locale to use; if not provided, this falls back to the format locale from the Configuration; see
+       * {@link sap.ui.core.Configuration.FormatSettings#getFormatLocale}. Is only used when `sCalendarWeekNumbering`
+       * is set to `Default`.
+       */
+      oLocale?: sap.ui.core.Locale
+    ):
+      | {
+          firstDayOfWeek: int;
+
+          minimalDaysInFirstWeek: int;
+        }
+      | undefined;
+  }
+  const CalendarUtils: CalendarUtils;
+  export default CalendarUtils;
+}
+
 declare module "sap/ui/core/InvisibleRenderer" {
   /**
    * @SINCE 1.66.0
@@ -5801,7 +5854,11 @@ declare namespace sap {
       /**
        * Dependency (dependencies) to resolve
        */
-      vDependencies: string | string[],
+      vDependencies:
+        | string
+        | Array<
+            keyof IUI5DefineDependencyNames | (string & { IGNORE_ME?: never })
+          >,
       /**
        * Callback function to execute after resolving an array of dependencies
        */
@@ -6366,7 +6423,8 @@ declare namespace sap {
     ): sap.ui.core.mvc.XMLView;
     /**
      * @deprecated (since 1.15.1) - use a {@link sap.ui.core.Component} instead.
-     * @EXPERIMENTAL (since 1.11.1)
+     * @EXPERIMENTAL (since 1.11.1) - The Application concept is still under construction, so some implementation
+     * details can be changed in future.
      *
      * Provides a specialization of `sap.ui.core.Component` which represents a central application.
      */
@@ -6387,7 +6445,8 @@ declare namespace sap {
 
       /**
        * @deprecated (since 1.15.1) - The Component class is enhanced to take care about the Application code.
-       * @EXPERIMENTAL (since 1.11.1)
+       * @EXPERIMENTAL (since 1.11.1) - The Application class is still under construction, so some implementation
+       * details can be changed in future.
        *
        * Abstract application class. Extend this class to create a central application class.
        */
@@ -6569,7 +6628,8 @@ declare namespace sap {
       }
       /**
        * @deprecated (since 1.15.1) - The mock server code has been moved to sap.ui.core.util - see {@link sap.ui.core.util.MockServer}
-       * @EXPERIMENTAL (since 1.13.0)
+       * @EXPERIMENTAL (since 1.13.0) - The mock server is still under construction, so some implementation details
+       * can be changed in future.
        *
        * Class to mock a server.
        */
@@ -9229,14 +9289,14 @@ declare namespace sap {
          * 	 - string literals `"null"` or `"undefined"`  Omitting the model name (or using the value `undefined`)
          * 			is explicitly allowed and refers to the default model.
          *
-         * @returns oModel
+         * @returns oModel or undefined when there is no such model
          */
         getModel(
           /**
            * name of the model to be retrieved
            */
           sModelName?: string
-        ): sap.ui.model.Model;
+        ): sap.ui.model.Model | undefined;
         /**
          * Get the object binding object for a specific model.
          *
@@ -13074,6 +13134,11 @@ declare namespace sap {
              * Object which defines the format options
              */
             oFormatOptions?: {
+              /**
+               * @since 1.108.0 specifies the calendar week numbering. If specified, this overwrites `oFormatOptions.firstDayOfWeek`
+               * and `oFormatOptions.minimalDaysInFirstWeek`.
+               */
+              calendarWeekNumbering?: sap.ui.core.date.CalendarWeekNumbering;
               /**
                * @since 1.105.0 specifies the first day of the week starting with `0` (which is Sunday); if not defined,
                * the value taken from the locale is used
@@ -13106,7 +13171,7 @@ declare namespace sap {
               strictParsing?: boolean;
               /**
                * if true, the date is formatted relatively to todays date if it is within the given day range, e.g. "today",
-               * "yesterday", "in 5 days"
+               * "1 day ago", "in 5 days"
                */
               relative?: boolean;
               /**
@@ -13162,6 +13227,11 @@ declare namespace sap {
              * Object which defines the format options
              */
             oFormatOptions?: {
+              /**
+               * @since 1.108.0 specifies the calendar week numbering. If specified, this overwrites `oFormatOptions.firstDayOfWeek`
+               * and `oFormatOptions.minimalDaysInFirstWeek`.
+               */
+              calendarWeekNumbering?: sap.ui.core.date.CalendarWeekNumbering;
               /**
                * @since 1.105.0 specifies the first day of the week starting with `0` (which is Sunday); if not defined,
                * the value taken from the locale is used
@@ -13196,7 +13266,7 @@ declare namespace sap {
               strictParsing?: boolean;
               /**
                * if true, the date is formatted relatively to today's date if it is within the given day range, e.g. "today",
-               * "yesterday", "in 5 days"
+               * "1 day ago", "in 5 days"
                */
               relative?: boolean;
               /**
@@ -13254,6 +13324,11 @@ declare namespace sap {
              * An object which defines the format options
              */
             oFormatOptions?: {
+              /**
+               * @since 1.108.0 specifies the calendar week numbering. If specified, this overwrites `oFormatOptions.firstDayOfWeek`
+               * and `oFormatOptions.minimalDaysInFirstWeek`.
+               */
+              calendarWeekNumbering?: sap.ui.core.date.CalendarWeekNumbering;
               /**
                * @since 1.105.0 specifies the first day of the week starting with `0` (which is Sunday); if not defined,
                * the value taken from the locale is used
@@ -13303,7 +13378,7 @@ declare namespace sap {
               strictParsing?: boolean;
               /**
                * Whether the date is formatted relatively to today's date if it is within the given day range, e.g. "today",
-               * "yesterday", "in 5 days"
+               * "1 day ago", "in 5 days"
                */
               relative?: boolean;
               /**
@@ -13343,6 +13418,11 @@ declare namespace sap {
              * Object which defines the format options
              */
             oFormatOptions?: {
+              /**
+               * @since 1.108.0 specifies the calendar week numbering. If specified, this overwrites `oFormatOptions.firstDayOfWeek`
+               * and `oFormatOptions.minimalDaysInFirstWeek`.
+               */
+              calendarWeekNumbering?: sap.ui.core.date.CalendarWeekNumbering;
               /**
                * @since 1.105.0 specifies the first day of the week starting with `0` (which is Sunday); if not defined,
                * the value taken from the locale is used
@@ -13375,7 +13455,7 @@ declare namespace sap {
               strictParsing?: boolean;
               /**
                * if true, the date is formatted relatively to todays date if it is within the given day range, e.g. "today",
-               * "yesterday", "in 5 days"
+               * "1 day ago", "in 5 days"
                */
               relative?: boolean;
               /**
@@ -14793,7 +14873,7 @@ declare namespace sap {
            */
           getPersistent(): boolean;
           /**
-           * @deprecated - As a message may have multiple targets, use {@link #getTargets} instead
+           * @deprecated (since 1.79.0) - As a message may have multiple targets, use {@link #getTargets} instead
            *
            * Returns the message target or the first target if the message has multiple targets.
            *
@@ -14900,7 +14980,7 @@ declare namespace sap {
             bPersistent: boolean
           ): void;
           /**
-           * @deprecated - As a message may have multiple targets, use {@link #setTargets} instead
+           * @deprecated (since 1.79.0) - As a message may have multiple targets, use {@link #setTargets} instead
            *
            * Sets the message target; in case the message has multiple targets, sets the first target of the message.
            * The syntax is MessageProcessor dependent. See the documentation of the respective MessageProcessor.
@@ -15873,6 +15953,13 @@ declare namespace sap {
         }
         /**
          * @SINCE 1.9.2
+         * @deprecated (since 1.108) - as there are no more known usages of `HTMLViews`, and as the use of HTML
+         * as syntax does not bring any advantages over XML. The HTML necessary for the `HTMLView` is not re-used
+         * for the HTML of the controls, but is fully replaced.
+         *
+         * Consider using {@link sap.ui.core.mvx.XMLView XMLViews} or "typed views" (view classes written in JavaScript)
+         * instead. For more information, see the documentation on {@link topic:91f27e3e6f4d1014b6dd926db0e91070
+         * View types}.
          *
          * A view defined/constructed by declarative HTML.
          */
@@ -18162,6 +18249,41 @@ declare namespace sap {
         enum AnimationMode {}
       }
 
+      namespace date {
+        /**
+         * @SINCE 1.108.0
+         *
+         * The `CalendarWeekNumbering` enum defines how to calculate calendar weeks. Each value defines:
+         * 	 - The first day of the week,
+         * 	 - the first week of the year.
+         */
+        enum CalendarWeekNumbering {
+          /**
+           * The default calendar week numbering:
+           *
+           * The framework determines the week numbering scheme; currently it is derived from the active format locale.
+           * Future versions of UI5 might select a different week numbering scheme.
+           */
+          Default = "Default",
+          /**
+           * Official calendar week numbering in most of Europe (ISO 8601 standard):
+           * 	Monday is first day of the week, the week containing January 4th is first week of the year.
+           */
+          ISO_8601 = "ISO_8601",
+          /**
+           * Official calendar week numbering in much of the Middle East (Middle Eastern calendar):
+           * 	Saturday is first day of the week, the week containing January 1st is first week of the year.
+           */
+          MiddleEastern = "MiddleEastern",
+          /**
+           * Official calendar week numbering in the United States, Canada, Brazil, Israel, Japan, and other countries
+           * (Western traditional calendar):
+           * 	Sunday is first day of the week, the week containing January 1st is first week of the year.
+           */
+          WesternTraditional = "WesternTraditional",
+        }
+      }
+
       namespace Element {
         /**
          * @SINCE 1.67
@@ -27793,7 +27915,8 @@ declare namespace sap {
          */
         getTemplate(sId: string): sap.ui.core.Component;
         /**
-         * @deprecated (since 1.107) - use {@link sap.ui.core.UIArea.registry#get UIArea.registry#get} instead!
+         * @deprecated (since 1.107) - use {@link sap.ui.core.UIArea.registry#get UIArea.registry#get} instead,
+         * but note that `UIArea.registry.get` only accepts the ID of the UIArea as argument.
          *
          * Returns the {@link sap.ui.core.UIArea UIArea} with the given ID or that belongs to the given DOM element.
          *
@@ -31716,6 +31839,9 @@ declare namespace sap {
          *                            // `null` can be provided.
          *      editable: true,       // Boolean which describes whether the control is editable. If not relevant it must not be set or
          *                            // `null` can be provided.
+         *      required: true,       // Boolean which describes whether the control is mandatory. If not relevant it must not be set or
+         *                            // `null` can be provided. The required state might also be handled as part of the description. In this
+         *                            // case this flag should not be used.
          *      children: []          // Aggregations of the given control (e.g. when the control is a layout). Primitive aggregations will be ignored.
          *                            // Note: Children should only be provided when it is helpful to understand the accessibility context
          *                            //       (e.g. a form control must not provide details of its internals (fields, labels, ...) but a
@@ -38690,7 +38816,7 @@ declare namespace sap {
          * of IDs for the ARIA attributes `aria-describedby` and `aria-labelledby`.
          *
          * Label controls that reference the given element in their `labelFor` relation are automatically added
-         * to the `aria-labelledby` attributes.
+         * to the `aria-labelledby` attribute.
          *
          * Note: This function is only a heuristic of a control property to ARIA attribute mapping. Control developers
          * have to check whether it fulfills their requirements. In case of problems (for example the `RadioButton`
@@ -41241,6 +41367,10 @@ declare namespace sap {
          * Type: Medium size
          */
         Medium = "Medium",
+        /**
+         * Type: Medium size, specifically if the BusyIndicator is displayed over a page section
+         */
+        Section = "Section",
         /**
          * Type: small size
          */
@@ -41818,12 +41948,14 @@ declare namespace sap {
       type Collision = string;
 
       /**
-       * A string type that represents CSS color values.
-       *
-       * Allowed values are CSS hex colors like "#666666" or "#fff", RGB/HSL values like "rgb(0,0,0)" or "hsla(50%,10%,30%,0.5)"
-       * as well as CSS color names like "green" and "darkblue" and special values like "inherit" and "transparent".
+       * A string type that represents CSS color values (CSS Color Level 3).
        *
-       * The empty string is also allowed and has the same effect as setting no color.
+       * **Allowed values are:**
+       * 	 - Hex colors like `#666666` or `#fff`,
+       * 	 - HSL/RGB values with or without transparency, like `hsla(90,10%,30%,0.5)` or `rgb(0,0,0)`,
+       * 	 - CSS color names like `darkblue`, or special values like `inherit` and `transparent`,
+       * 	 - an empty string, which has the same effect as setting no color.  For more information about
+       * 			the CSS Level 3 color specification, see {@link https://www.w3.org/TR/css-color-3/#css-system}.
        */
       type CSSColor = string;
 
@@ -42131,7 +42263,7 @@ declare namespace sap {
        */
       namespace analytics {
         /**
-         * @EXPERIMENTAL
+         * @EXPERIMENTAL - This module is only for experimental use!
          *
          * If called on an instance of an (v1/v2) ODataModel it will enrich it with analytics capabilities.
          */
@@ -43918,7 +44050,7 @@ declare namespace sap {
           }
         }
         /**
-         * @EXPERIMENTAL
+         * @EXPERIMENTAL - This module is only for experimental use!
          *
          * The OData4Analytics API is purely experimental, not yet functionally complete and not meant for productive
          * usage. At present, its only purpose is to demonstrate how easy analytical extensions of OData4SAP can
@@ -43946,7 +44078,7 @@ declare namespace sap {
         const odata4analytics: odata4analytics;
 
         /**
-         * @EXPERIMENTAL
+         * @EXPERIMENTAL - This module is only for experimental use!
          *
          * Tree binding implementation for OData entity sets with aggregate semantics.
          *
@@ -45031,7 +45163,7 @@ declare namespace sap {
        */
       namespace odata {
         /**
-         * @EXPERIMENTAL
+         * @EXPERIMENTAL - This module is only for experimental and internal use!
          *
          * Adapter for TreeBindings to add the ListBinding functionality and use the tree structure in list based
          * controls. Only usable with the sap.ui.table.TreeTable control. The functions defined here are only available
@@ -48828,6 +48960,10 @@ declare namespace sap {
              *
              * Note: This method requires that the model metadata has been loaded; see {@link sap.ui.model.odata.v2.ODataModel#metadataLoaded}.
              *
+             * Since 1.108.0, this method supports deep create, which means it may be called if this binding's context
+             * is transient. The restrictions specified for {@link sap.ui.model.odata.v2.ODataModel#createEntry} regarding
+             * deep create apply.
+             *
              * @returns The context representing the created entity
              */
             create(
@@ -48843,8 +48979,9 @@ declare namespace sap {
                */
               bAtEnd: boolean,
               /**
-               * A map of parameters as specified for {@link sap.ui.model.odata.v2.ODataModel#createEntry} where only
-               * the following subset of these is supported.
+               * A map of parameters as specified for {@link sap.ui.model.odata.v2.ODataModel#createEntry}, where only
+               * the subset given below is supported. In case of deep create, **none** of the parameters in `mParameters`
+               * must be set.
                */
               mParameters: {
                 /**
@@ -48886,6 +49023,10 @@ declare namespace sap {
              *
              * Note: This method requires that the model metadata has been loaded; see {@link sap.ui.model.odata.v2.ODataModel#metadataLoaded}.
              *
+             * Since 1.108.0, this method supports deep create, which means it may be called if this binding's context
+             * is transient. The restrictions specified for {@link sap.ui.model.odata.v2.ODataModel#createEntry} regarding
+             * deep create apply.
+             *
              * @returns The context representing the created entity
              */
             create(
@@ -48894,8 +49035,9 @@ declare namespace sap {
                */
               oInitialData: object,
               /**
-               * A map of parameters as specified for {@link sap.ui.model.odata.v2.ODataModel#createEntry} where only
-               * the following subset of these is supported.
+               * A map of parameters as specified for {@link sap.ui.model.odata.v2.ODataModel#createEntry}, where only
+               * the subset given below is supported. In case of deep create, **none** of the parameters in `mParameters`
+               * must be set.
                */
               mParameters: {
                 /**
@@ -48937,6 +49079,10 @@ declare namespace sap {
              *
              * Note: This method requires that the model metadata has been loaded; see {@link sap.ui.model.odata.v2.ODataModel#metadataLoaded}.
              *
+             * Since 1.108.0, this method supports deep create, which means it may be called if this binding's context
+             * is transient. The restrictions specified for {@link sap.ui.model.odata.v2.ODataModel#createEntry} regarding
+             * deep create apply.
+             *
              * @returns The context representing the created entity
              */
             create(
@@ -48948,8 +49094,9 @@ declare namespace sap {
                */
               bAtEnd: boolean,
               /**
-               * A map of parameters as specified for {@link sap.ui.model.odata.v2.ODataModel#createEntry} where only
-               * the following subset of these is supported.
+               * A map of parameters as specified for {@link sap.ui.model.odata.v2.ODataModel#createEntry}, where only
+               * the subset given below is supported. In case of deep create, **none** of the parameters in `mParameters`
+               * must be set.
                */
               mParameters: {
                 /**
@@ -48991,12 +49138,17 @@ declare namespace sap {
              *
              * Note: This method requires that the model metadata has been loaded; see {@link sap.ui.model.odata.v2.ODataModel#metadataLoaded}.
              *
+             * Since 1.108.0, this method supports deep create, which means it may be called if this binding's context
+             * is transient. The restrictions specified for {@link sap.ui.model.odata.v2.ODataModel#createEntry} regarding
+             * deep create apply.
+             *
              * @returns The context representing the created entity
              */
             create(
               /**
-               * A map of parameters as specified for {@link sap.ui.model.odata.v2.ODataModel#createEntry} where only
-               * the following subset of these is supported.
+               * A map of parameters as specified for {@link sap.ui.model.odata.v2.ODataModel#createEntry}, where only
+               * the subset given below is supported. In case of deep create, **none** of the parameters in `mParameters`
+               * must be set.
                */
               mParameters: {
                 /**
@@ -50205,7 +50357,8 @@ declare namespace sap {
              * topic:6c47b2b39db9404582994070ec3d57a2#loio4c4cd99af9b14e08bb72470cc7cabff4 Creating Entities documentation}
              * for comprehensive information on the topic.
              *
-             * Please note that deep creates are not supported and may not work.
+             * **Note:** This function does not support a "deep create" scenario. Use {@link #createEntry} or {@link
+             * sap.ui.model.odata.v2.ODataListBinding#create} instead.
              *
              * @returns An object which has an `abort` function to abort the current request.
              */
@@ -50370,9 +50523,14 @@ declare namespace sap {
              * for example if the server requires a unit for an amount. This also applies if this property has a default
              * value.
              *
-             * Note: A deep create (including data defined by navigation properties) is not supported. The dependent
-             * entity has to be created using a second list binding, after this entity has been saved successfully in
-             * the back-end system.
+             * Note: Deep create is only supported since 1.108.0, where "deep create" means creation of a sub-entity
+             * for a navigation property of a transient, not yet persisted root entity. Before 1.108.0, the sub-entity
+             * had to be created after the transient entity had been saved successfully in the back-end system. Since
+             * 1.108.0, a deep create is triggered when the `sPath` parameter is a navigation property for the entity
+             * type associated with the transient context given in `mParameters.context`. The payload of the OData request
+             * to create the root entity then contains its sub-entities. On creation of a sub-entity, only the `sPath`,
+             * `mParameters.context` and `mParameters.properties` method parameters are allowed; the context given in
+             * `mParameters.context` must not be inactive.
              *
              * @returns An OData V2 context object that points to the newly created entry; or `undefined` if the service
              * metadata are not yet loaded or if a `created` callback parameter is given
@@ -52018,9 +52176,9 @@ declare namespace sap {
             ): this;
           }
           /**
-           * @deprecated - Use {@link sap.ui.model.odata.CountMode} to specify how the count of collections is retrieved.
-           * Use the `useBatch` parameter of the {@link sap.ui.model.odata.v2.ODataModel} constructor to specify whether
-           * requests are sent in $batch.
+           * @deprecated (since 1.74.0) - Use {@link sap.ui.model.odata.CountMode} to specify how the count of collections
+           * is retrieved. Use the `useBatch` parameter of the {@link sap.ui.model.odata.v2.ODataModel} constructor
+           * to specify whether requests are sent in $batch.
            *
            * Different modes for retrieving the count of collections.
            */
@@ -52775,17 +52933,16 @@ declare namespace sap {
              * Deletes the OData entity this context points to. The context is removed from the binding immediately,
              * even if {@link sap.ui.model.odata.v4.SubmitMode.API} is used, and the request is only sent later when
              * {@link sap.ui.model.odata.v4.ODataModel#submitBatch} is called. As long as the context is deleted on
-             * the client, but not yet on the server, {@link #isDeleted} returns `true`. The context must not be used,
-             * e.g. as a binding context, while {@link #isDeleted} returns `true`.
+             * the client, but not yet on the server, {@link #isDeleted} returns `true` and the context must not be
+             * used anymore (except for checking {@link #isDeleted}), especially not as a binding context. The application
+             * has to take care that the context is no longer used.
              *
              * 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. `resetChanges` in binding or model cancels
              * the deletion and restores the context.
              *
-             * The usage of a group ID with {@link sap.ui.model.odata.v4.SubmitMode.API} is possible since 1.105 - this
-             * is an experimental API.
-             *
-             * The context must not be used anymore after successful deletion.
+             * If the DELETE request succeeds, the context is destroyed and must not be used anymore. If it fails, the
+             * context is restored, reinserted into the list, and fully functional again.
              * See:
              * 	#hasPendingChanges
              * 	sap.ui.model.odata.v4.ODataContextBinding#hasPendingChanges
@@ -52810,7 +52967,8 @@ 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).
+               * not exist 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.
                */
               sGroupId?: string,
               /**
@@ -53177,6 +53335,9 @@ declare namespace sap {
              * Use it to set fields affected by side effects to read-only before {@link #requestSideEffects} and make
              * them editable again when the promise resolves; in the error handler, you can repeat the loading of side
              * effects.
+             *  The promise is rejected if the call wants to refresh a whole list binding (via header context or an
+             * absolute path), but the deletion of a row context (see {@link #delete}) is pending with a different group
+             * ID.
              */
             requestSideEffects(
               /**
@@ -53616,11 +53777,10 @@ declare namespace sap {
             /**
              * @SINCE 1.39.0
              *
-             * Returns `true` if this binding or its dependent bindings have pending property changes or created entities
-             * which have not been sent successfully to the server. This function does not take into account the deletion
-             * of entities (see {@link sap.ui.model.odata.v4.Context#delete}) and the execution of OData operations
-             * (see {@link sap.ui.model.odata.v4.ODataContextBinding#execute}). Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isInactive
-             * inactive} contexts are ignored.
+             * Returns `true` if this binding or its dependent bindings have property changes, created entities, or
+             * entity deletions which have not been sent successfully to the server. This function does not take the
+             * execution of OData operations (see {@link sap.ui.model.odata.v4.ODataContextBinding#execute}) into account.
+             * Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isInactive inactive} contexts are ignored.
              *
              * Note: If this binding is relative, its data is cached separately for each parent context path. This method
              * returns `true` if there are pending changes for the current parent context path of this binding. If this
@@ -53633,10 +53793,11 @@ declare namespace sap {
                * Whether to ignore changes which will not be lost by APIs like {@link sap.ui.model.odata.v4.ODataListBinding#changeParameters
                * changeParameters}, {@link sap.ui.model.odata.v4.ODataListBinding#filter filter}, {@link sap.ui.model.odata.v4.ODataListBinding#refresh
                * refresh} (since 1.100.0), {@link sap.ui.model.odata.v4.ODataListBinding#sort sort}, or {@link sap.ui.model.odata.v4.ODataListBinding#suspend
-               * suspend} because they relate to a {@link sap.ui.model.odata.v4.Context#isKeepAlive kept-alive} context
-               * of this binding (since 1.97.0). Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isTransient transient}
-               * contexts of a {@link #getRootBinding root binding} are treated as kept-alive by this flag. Since 1.99.0,
-               * the same happens for bindings using the `$$ownRequest` parameter (see {@link sap.ui.model.odata.v4.ODataModel#bindList}).
+               * suspend} because they relate to a {@link sap.ui.model.odata.v4.Context#isKeepAlive kept-alive} (since
+               * 1.97.0) or {@link sap.ui.model.odata.v4.Context#delete deleted} (since 1.108.0) context of this binding.
+               * Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isTransient transient} contexts of a {@link #getRootBinding
+               * root binding} are treated as kept-alive by this flag. Since 1.99.0, the same happens for bindings using
+               * the `$$ownRequest` parameter (see {@link sap.ui.model.odata.v4.ODataModel#bindList}).
                */
               bIgnoreKeptAlive?: boolean
             ): boolean;
@@ -53771,7 +53932,8 @@ 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.
+             * 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} contexts do not count as pending changes.
              * See:
              * 	{@link topic:b0f5c531e5034a27952cc748954cbe39 Suspend and Resume}
              * 	sap.ui.model.Binding#suspend
@@ -54224,9 +54386,10 @@ declare namespace sap {
              *
              * If known, the value represents the sum of the element count of the collection on the server and the number
              * of {@link sap.ui.model.odata.v4.Context#isInactive active} {@link sap.ui.model.odata.v4.Context#isTransient
-             * transient} entities created on the client. Otherwise, it is `undefined`. The value is a number of type
-             * `Edm.Int64`. Since 1.91.0, in case of data aggregation with group levels, the count is the leaf count
-             * on the server; it is only determined if the `$count` system query option is given.
+             * transient} entities created on the client, minus the {@link #sap.ui.model.data.v4.Context#delete deleted}
+             * entities. Otherwise, it is `undefined`. The value is a number of type `Edm.Int64`. Since 1.91.0, in case
+             * of data aggregation with group levels, the count is the leaf count on the server; it is only determined
+             * if the `$count` system query option is given.
              *
              * The count is known to the binding in the following situations:
              * 	 The server-side count has been requested via the `$count` system query option.  A "short read"
@@ -54248,7 +54411,8 @@ declare namespace sap {
              *
              * Returns the contexts that were requested by a control last time. Does not trigger a data request. In
              * the time between the {@link #event:dataRequested} event and the {@link #event:dataReceived} event, the
-             * resulting array contains `undefined` at those indexes where the data is not yet available.
+             * resulting array contains `undefined` at those indexes where the data is not yet available or has been
+             * deleted.
              * See:
              * 	sap.ui.model.ListBinding#getCurrentContexts
              * 	#getAllCurrentContexts
@@ -54385,11 +54549,10 @@ declare namespace sap {
             /**
              * @SINCE 1.39.0
              *
-             * Returns `true` if this binding or its dependent bindings have pending property changes or created entities
-             * which have not been sent successfully to the server. This function does not take into account the deletion
-             * of entities (see {@link sap.ui.model.odata.v4.Context#delete}) and the execution of OData operations
-             * (see {@link sap.ui.model.odata.v4.ODataContextBinding#execute}). Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isInactive
-             * inactive} contexts are ignored.
+             * Returns `true` if this binding or its dependent bindings have property changes, created entities, or
+             * entity deletions which have not been sent successfully to the server. This function does not take the
+             * execution of OData operations (see {@link sap.ui.model.odata.v4.ODataContextBinding#execute}) into account.
+             * Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isInactive inactive} contexts are ignored.
              *
              * Note: If this binding is relative, its data is cached separately for each parent context path. This method
              * returns `true` if there are pending changes for the current parent context path of this binding. If this
@@ -54402,10 +54565,11 @@ declare namespace sap {
                * Whether to ignore changes which will not be lost by APIs like {@link sap.ui.model.odata.v4.ODataListBinding#changeParameters
                * changeParameters}, {@link sap.ui.model.odata.v4.ODataListBinding#filter filter}, {@link sap.ui.model.odata.v4.ODataListBinding#refresh
                * refresh} (since 1.100.0), {@link sap.ui.model.odata.v4.ODataListBinding#sort sort}, or {@link sap.ui.model.odata.v4.ODataListBinding#suspend
-               * suspend} because they relate to a {@link sap.ui.model.odata.v4.Context#isKeepAlive kept-alive} context
-               * of this binding (since 1.97.0). Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isTransient transient}
-               * contexts of a {@link #getRootBinding root binding} are treated as kept-alive by this flag. Since 1.99.0,
-               * the same happens for bindings using the `$$ownRequest` parameter (see {@link sap.ui.model.odata.v4.ODataModel#bindList}).
+               * suspend} because they relate to a {@link sap.ui.model.odata.v4.Context#isKeepAlive kept-alive} (since
+               * 1.97.0) or {@link sap.ui.model.odata.v4.Context#delete deleted} (since 1.108.0) context of this binding.
+               * Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isTransient transient} contexts of a {@link #getRootBinding
+               * root binding} are treated as kept-alive by this flag. Since 1.99.0, the same happens for bindings using
+               * the `$$ownRequest` parameter (see {@link sap.ui.model.odata.v4.ODataModel#bindList}).
                */
               bIgnoreKeptAlive?: boolean
             ): boolean;
@@ -54607,8 +54771,9 @@ declare namespace sap {
                 /**
                  * A map from aggregatable property names or aliases to objects containing the following details:
                  * 	 `grandTotal`: An optional boolean that tells whether a grand total for this aggregatable property is
-                 * needed (since 1.59.0); filtering by any aggregatable property is not supported in this case (since 1.89.0)
-                 * as is "$search" (since 1.93.0) or the `vGroup` parameter of {@link sap.ui.model.Sorter} (since 1.107.0)
+                 * needed (since 1.59.0); not supported in this case are:
+                 * 	 filtering by any aggregatable property (since 1.89.0),  "$search" (since 1.93.0),  the `vGroup`
+                 * parameter of {@link sap.ui.model.Sorter} (since 1.107.0),  shared requests (since 1.108.0).
                  *  `subtotals`: An optional boolean that tells whether subtotals for this aggregatable property are
                  * needed  `with`: An optional string that provides the name of the method (for example "sum") used
                  * for aggregation of this aggregatable property; see "3.1.2 Keyword with".  `name`: An optional string
@@ -54640,16 +54805,18 @@ declare namespace sap {
                 group?: object;
                 /**
                  * A list of groupable property names used to determine group levels. They may, but don't need to, be repeated
-                 * in `oAggregation.group`. Group levels cannot be combined with filtering for aggregated properties or
-                 * (since 1.93.0) with "$search" or (since 1.107.0) the `vGroup` parameter of {@link sap.ui.model.Sorter}.
+                 * in `oAggregation.group`. Group levels cannot be combined with:
+                 * 	 filtering for aggregated properties,  "$search" (since 1.93.0),  the `vGroup` parameter of
+                 * {@link sap.ui.model.Sorter} (since 1.107.0),  shared requests (since 1.108.0).
                  */
                 groupLevels?: string[];
                 /**
                  * The qualifier for the pair of "Org.OData.Aggregation.V1.RecursiveHierarchy" and "com.sap.vocabularies.Hierarchy.v1.RecursiveHierarchy"
                  * annotations at this binding's entity type (@experimental as of version 1.105.0). If present, a recursive
                  * hierarchy without data aggregation is defined, and the only other supported properties are `expandTo`
-                 * and `search`. A recursive hierarchy cannot be combined with "$search" or (since 1.107.0) the `vGroup`
-                 * parameter of {@link sap.ui.model.Sorter}.
+                 * and `search`. A recursive hierarchy cannot be combined with:
+                 * 	 "$search",  the `vGroup` parameter of {@link sap.ui.model.Sorter} (since 1.107.0),  shared
+                 * requests (since 1.108.0).
                  */
                 hierarchyQualifier?: string;
                 /**
@@ -54699,7 +54866,8 @@ 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.
+             * 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} contexts do not count as pending changes.
              * See:
              * 	{@link topic:b0f5c531e5034a27952cc748954cbe39 Suspend and Resume}
              * 	sap.ui.model.Binding#suspend
@@ -54768,12 +54936,14 @@ declare namespace sap {
                 total?: boolean;
                 /**
                  * Measures only: Whether the maximum value (ignoring currencies or units of measure) for this measure is
-                 * needed (since 1.55.0); filtering and sorting is supported in this case (since 1.58.0)
+                 * needed (since 1.55.0); filtering and sorting is supported in this case (since 1.58.0), but shared requests
+                 * are not (since 1.108.0)
                  */
                 max?: boolean;
                 /**
                  * Measures only: Whether the minimum value (ignoring currencies or units of measure) for this measure is
-                 * needed (since 1.55.0); filtering and sorting is supported in this case (since 1.58.0)
+                 * needed (since 1.55.0); filtering and sorting is supported in this case (since 1.58.0), but shared requests
+                 * are not (since 1.108.0)
                  */
                 min?: boolean;
                 /**
@@ -55965,15 +56135,19 @@ declare namespace sap {
                  * Whether multiple bindings for the same resource path share the data, so that it is requested only once;
                  * only the value `true` is allowed. This parameter can be inherited from the model's parameter "sharedRequests",
                  * see {@link sap.ui.model.odata.v4.ODataModel#constructor}. Supported since 1.80.0 **Note:** These bindings
-                 * are read-only, so they may be especially useful for value lists; the following APIs are **not** allowed
-                 *
+                 * are read-only, so they may be especially useful for value lists; state messages (since 1.108.0) and the
+                 * following APIs are **not** allowed
                  * 	 for the list binding itself:
-                 * 	 {@link sap.ui.model.odata.v4.ODataListBinding#create}   for the {@link sap.ui.model.odata.v4.ODataListBinding#getHeaderContext
-                 * header context} of a list binding:
+                 * 	 {@link sap.ui.model.odata.v4.ODataListBinding#create}  {@link sap.ui.model.odata.v4.ODataListBinding#getKeepAliveContext}
+                 * or {@link #getKeepAliveContext} as far as it affects such a list binding  {@link sap.ui.model.odata.v4.ODataListBinding#resetChanges}
+                 *   for the {@link sap.ui.model.odata.v4.ODataListBinding#getHeaderContext header context} of
+                 * a list binding:
                  * 	 {@link sap.ui.model.odata.v4.Context#requestSideEffects}   for the context of a list binding
                  * representing a single entity:
                  * 	 {@link sap.ui.model.odata.v4.Context#delete}  {@link sap.ui.model.odata.v4.Context#refresh}
-                 * {@link sap.ui.model.odata.v4.Context#requestSideEffects}  {@link sap.ui.model.odata.v4.Context#setProperty}
+                 * {@link sap.ui.model.odata.v4.Context#replaceWith}  {@link sap.ui.model.odata.v4.Context#requestSideEffects}
+                 *  {@link sap.ui.model.odata.v4.Context#setKeepAlive}  {@link sap.ui.model.odata.v4.Context#setProperty}
+                 *  executing a bound operation using `bReplaceWithRVC`, see {@link sap.ui.model.odata.v4.ODataContextBinding#execute}
                  *   for a dependent property binding of the list binding:
                  * 	 {@link sap.ui.model.odata.v4.ODataPropertyBinding#setValue}
                  */
@@ -56431,9 +56605,10 @@ declare namespace sap {
             /**
              * @SINCE 1.39.0
              *
-             * Returns `true` if there are pending changes, meaning updates or created entities (see {@link sap.ui.model.odata.v4.ODataListBinding#create})
-             * that have not yet been successfully sent to the server. Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isInactive
-             * inactive} contexts are ignored.
+             * Returns `true` if there are pending changes, which can be updates, created entities (see {@link sap.ui.model.odata.v4.ODataListBinding#create})
+             * or entity deletions (see {@link sap.ui.model.odata.v4.Context#delete}) that have not yet been successfully
+             * sent to the server. Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isInactive inactive} contexts
+             * are ignored.
              *
              * @returns `true` if there are pending changes
              */
@@ -56496,7 +56671,7 @@ declare namespace sap {
              * Requests the metadata for the given meta path and calculates the key predicate by taking the key properties
              * from the given entity instance.
              * See:
-             * 	#getKeyPredicates
+             * 	#getKeyPredicate
              *
              * @returns A promise that gets resolved with the proper URI-encoded key predicate, for example "(Sector='A%2FB%26C',ID='42')"
              * or "('42')", or `undefined` if at least one key property is undefined. It gets rejected if the metadata
@@ -56515,10 +56690,9 @@ declare namespace sap {
             /**
              * @SINCE 1.39.0
              *
-             * Resets all property changes and created entities associated with the given group ID which have not been
-             * successfully submitted via {@link #submitBatch}. Resets also invalid user input for the same group ID.
-             * This function does not reset the deletion of entities (see {@link sap.ui.model.odata.v4.Context#delete})
-             * and the execution of OData operations (see {@link sap.ui.model.odata.v4.ODataContextBinding#execute}).
+             * Resets all property changes, created entities, and entity deletions associated with the given group ID
+             * which have not been successfully submitted via {@link #submitBatch}. Resets also invalid user input for
+             * the same group ID. This function does not reset the execution of OData operations (see {@link sap.ui.model.odata.v4.ODataContextBinding#execute}).
              * See:
              * 	sap.ui.model.odata.v4.ODataModel#constructor.
              */
@@ -56692,11 +56866,10 @@ declare namespace sap {
             /**
              * @SINCE 1.39.0
              *
-             * Returns `true` if this binding or its dependent bindings have pending property changes or created entities
-             * which have not been sent successfully to the server. This function does not take into account the deletion
-             * of entities (see {@link sap.ui.model.odata.v4.Context#delete}) and the execution of OData operations
-             * (see {@link sap.ui.model.odata.v4.ODataContextBinding#execute}). Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isInactive
-             * inactive} contexts are ignored.
+             * Returns `true` if this binding or its dependent bindings have property changes, created entities, or
+             * entity deletions which have not been sent successfully to the server. This function does not take the
+             * execution of OData operations (see {@link sap.ui.model.odata.v4.ODataContextBinding#execute}) into account.
+             * Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isInactive inactive} contexts are ignored.
              *
              * Note: If this binding is relative, its data is cached separately for each parent context path. This method
              * returns `true` if there are pending changes for the current parent context path of this binding. If this
@@ -56709,10 +56882,11 @@ declare namespace sap {
                * Whether to ignore changes which will not be lost by APIs like {@link sap.ui.model.odata.v4.ODataListBinding#changeParameters
                * changeParameters}, {@link sap.ui.model.odata.v4.ODataListBinding#filter filter}, {@link sap.ui.model.odata.v4.ODataListBinding#refresh
                * refresh} (since 1.100.0), {@link sap.ui.model.odata.v4.ODataListBinding#sort sort}, or {@link sap.ui.model.odata.v4.ODataListBinding#suspend
-               * suspend} because they relate to a {@link sap.ui.model.odata.v4.Context#isKeepAlive kept-alive} context
-               * of this binding (since 1.97.0). Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isTransient transient}
-               * contexts of a {@link #getRootBinding root binding} are treated as kept-alive by this flag. Since 1.99.0,
-               * the same happens for bindings using the `$$ownRequest` parameter (see {@link sap.ui.model.odata.v4.ODataModel#bindList}).
+               * suspend} because they relate to a {@link sap.ui.model.odata.v4.Context#isKeepAlive kept-alive} (since
+               * 1.97.0) or {@link sap.ui.model.odata.v4.Context#delete deleted} (since 1.108.0) context of this binding.
+               * Since 1.98.0, {@link sap.ui.model.odata.v4.Context#isTransient transient} contexts of a {@link #getRootBinding
+               * root binding} are treated as kept-alive by this flag. Since 1.99.0, the same happens for bindings using
+               * the `$$ownRequest` parameter (see {@link sap.ui.model.odata.v4.ODataModel#bindList}).
                */
               bIgnoreKeptAlive?: boolean
             ): boolean;
@@ -62768,6 +62942,16 @@ declare namespace sap {
            */
           sFilterType?: sap.ui.model.FilterType
         ): this;
+        /**
+         * @SINCE 1.108.0
+         *
+         * Returns the count of entries in the tree, or `undefined` if it is unknown. If the tree is filtered, the
+         * count of all entries matching the filter conditions is returned. The entries required only for the tree
+         * structure are not counted.
+         *
+         * @returns The count of entries in the tree, or `undefined` if the binding is not resolved
+         */
+        getCount(): number | undefined;
         /**
          * Return node contexts for the tree
          *
@@ -66211,6 +66395,19 @@ declare namespace sap {
            */
           oContext: Object
         ): int;
+        /**
+         * @SINCE 1.108.0
+         *
+         * Returns the count of entries in the tree, or `undefined` if it is unknown. If the tree is filtered, the
+         * count of all entries matching the filter conditions is returned. The entries required only for the tree
+         * structure are not counted.
+         *
+         * **Note:** The default implementation returns `undefined` and has to be overwritten by subclasses.
+         *
+         * @returns The count of entries in the tree, or `undefined` if it is unknown, for example because the binding
+         * is not resolved or because this feature is not supported.
+         */
+        getCount(): number | undefined;
         /**
          * Returns the current value of the bound target
          *
@@ -66408,7 +66605,7 @@ declare namespace sap {
         getLength(): number;
       }
       /**
-       * @deprecated - use {@link sap.ui.model.TreeBindingAdapter} instead
+       * @deprecated (since 1.96.0) - use {@link sap.ui.model.TreeBindingAdapter} instead
        */
       class TreeBindingCompatibilityAdapter {
         /**
@@ -73356,6 +73553,8 @@ declare namespace sap {
 
     "sap/ui/base/SyncPromise": undefined;
 
+    "sap/ui/core/_UrlResolver": undefined;
+
     "sap/ui/core/AppCacheBuster": undefined;
 
     "sap/ui/core/BusyIndicator": undefined;
@@ -73386,6 +73585,10 @@ declare namespace sap {
 
     "sap/ui/core/CustomData": undefined;
 
+    "sap/ui/core/date/CalendarUtils": undefined;
+
+    "sap/ui/core/date/CalendarWeekNumbering": undefined;
+
     "sap/ui/core/date/UniversalDate": undefined;
 
     "sap/ui/core/date/UniversalDateUtils": undefined;