@openui5/ts-types 1.120.16 → 1.120.18

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openui5/ts-types",
-  "version": "1.120.16",
+  "version": "1.120.18",
   "description": "OpenUI5 TypeScript Definitions",
   "homepage": "https://openui5.org",
   "author": "SAP SE (https://www.sap.com)",

package/types/sap.f.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {
   /**

package/types/sap.m.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {
   /**
@@ -15861,7 +15861,7 @@ declare namespace sap {
          * Required for receiving a `readyState` is to set the property `sendXHR` to true. This property is not
          * supported by Internet Explorer 9.
          */
-        readyState?: string;
+        readyState?: int;
 
         /**
          * Status of the XHR request.
@@ -15869,7 +15869,7 @@ declare namespace sap {
          * Required for receiving a `status` is to set the property `sendXHR` to true. This property is not supported
          * by Internet Explorer 9.
          */
-        status?: string;
+        status?: int;
 
         /**
          * Http-Response which comes from the server.

package/types/sap.tnt.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {
   /**

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {
   namespace ui {

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {
   namespace ui {

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

@@ -280,7 +280,7 @@ declare namespace sap {
   }
 }
 
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare module "sap/base/assert" {
   /**
@@ -20124,14 +20124,64 @@ declare namespace sap {
            * **Note:** This static method is automatically propagated to subclasses of `ControllerExtension`.
            *
            *
-           * @returns A controller extension class
+           * @returns The adapted controller extension class
            */
-          static override(
+          static override<
+            TheExtension extends new () => ControllerExtension,
+            AddtlProps extends object
+          >(
+            this: TheExtension,
             /**
              * The custom extension definition
              */
-            oExtension: Record<string, Function>
-          ): Function;
+            customExtension: AddtlProps
+          ): new () => InstanceType<TheExtension> & AddtlProps;
+          /**
+           * A marker method for applying controller extensions to controller class members in TypeScript code.
+           * This method is only used to make TypeScript usage compatible to the UI5 runtime behavior, where an extension
+           * *class* is assigned when the controller is defined, but each controller instance gets an *instance* of
+           * this extension. This method call is removed in the class transformer when the ES class is transformed
+           * to the traditional UI5 class definition syntax.
+           *
+           * To allow for proper removal, it may only be called directly on the base class `ControllerExtension`,
+           * at the place where a controller extension is assigned to a member property of the new controller class.
+           * The class transformation then removes this call. If it is not removed because it is used in any other
+           * way, then it throws an error at runtime.
+           *
+           * Usage example:
+           * ```javascript
+           * import Routing from "sap/fe/core/controllerextensions/Routing";
+           * import ControllerExtension from "sap/ui/core/mvc/ControllerExtension";
+           * ...
+           * export default class App extends Controller {
+           *    routing = ControllerExtension.use(Routing);
+           * ```
+           *
+           * Usage example with overriding extension callbacks:
+           * ```javascript
+           * import Routing from "sap/fe/core/controllerextensions/Routing";
+           * import ControllerExtension from "sap/ui/core/mvc/ControllerExtension";
+           * ...
+           * export default class App extends Controller {
+           *    routing = ControllerExtension.use(Routing.override({
+           *       ...
+           *    }));
+           * ```
+           *
+           *
+           *
+           * @returns An instance of the given `ControllerExtension`. **NOTE:** this is only a dummy return type for
+           * proper usage in TypeScript. This method does not actually return an instance of `ControllerExtension`,
+           * but only throws an error at runtime. The sole purpose of this method is to mimic the actual runtime behavior
+           * where a *class* is given when a controller is defined, but an *instance* is present in each controller
+           * instance.
+           */
+          static use<TheExtension extends sap.ui.core.mvc.ControllerExtension>(
+            /**
+             * The ControllerExtension to use
+             */
+            extensionClass: new () => TheExtension
+          ): TheExtension;
           /**
            * Returns an Element of the connected view with the given local ID.
            *
@@ -26642,7 +26692,7 @@ declare namespace sap {
         /**
          * Describes the settings that can be provided to the OpenSearchProvider constructor.
          *
-         * @deprecated (since 1.120)
+         * @deprecated (since 1.120) - There is no API replacement.
          */
         interface $OpenSearchProviderSettings
           extends sap.ui.core.search.$SearchProviderSettings {
@@ -26664,7 +26714,7 @@ declare namespace sap {
         /**
          * Describes the settings that can be provided to the SearchProvider constructor.
          *
-         * @deprecated (since 1.120)
+         * @deprecated (since 1.120) - There is no API replacement.
          */
         interface $SearchProviderSettings extends sap.ui.core.$ElementSettings {
           /**
@@ -26676,7 +26726,7 @@ declare namespace sap {
         /**
          * A SearchProvider which uses the OpenSearch protocol (either JSON or XML).
          *
-         * @deprecated (since 1.120)
+         * @deprecated (since 1.120) - There is no API replacement.
          */
         class OpenSearchProvider extends sap.ui.core.search.SearchProvider {
           /**
@@ -26821,7 +26871,7 @@ declare namespace sap {
          *
          * Do not create instances of this class, but use a concrete subclass instead.
          *
-         * @deprecated (since 1.120)
+         * @deprecated (since 1.120) - There is no API replacement.
          */
         abstract class SearchProvider extends sap.ui.core.Element {
           /**
@@ -27209,7 +27259,8 @@ declare namespace sap {
         /**
          * Describes the settings that can be provided to the DOMAttribute constructor.
          *
-         * @deprecated (since 1.56)
+         * @deprecated (since 1.56) - Use an {@link sap.ui.core.mvc.XMLView XMLView} or a {@link topic:e6bb33d076dc4f23be50c082c271b9f0 Typed View }
+         * instead.
          */
         interface $DOMAttributeSettings extends sap.ui.core.$ElementSettings {
           /**
@@ -27226,7 +27277,8 @@ declare namespace sap {
         /**
          * Describes the settings that can be provided to the DOMElement constructor.
          *
-         * @deprecated (since 1.56)
+         * @deprecated (since 1.56) - Use an {@link sap.ui.core.mvc.XMLView XMLView} or a {@link topic:e6bb33d076dc4f23be50c082c271b9f0 Typed View }
+         * instead.
          */
         interface $DOMElementSettings extends sap.ui.core.$ControlSettings {
           /**
@@ -27261,7 +27313,8 @@ declare namespace sap {
         /**
          * Describes the settings that can be provided to the HandlebarsTemplate constructor.
          *
-         * @deprecated (since 1.56)
+         * @deprecated (since 1.56) - Use an {@link sap.ui.core.mvc.XMLView XMLView} or a {@link topic:e6bb33d076dc4f23be50c082c271b9f0 Typed View }
+         * instead.
          */
         interface $HandlebarsTemplateSettings
           extends sap.ui.core.tmpl.$TemplateSettings {}
@@ -27282,7 +27335,8 @@ declare namespace sap {
         /**
          * Describes the settings that can be provided to the TemplateControl constructor.
          *
-         * @deprecated (since 1.56)
+         * @deprecated (since 1.56) - Use an {@link sap.ui.core.mvc.XMLView XMLView} or a {@link topic:e6bb33d076dc4f23be50c082c271b9f0 Typed View }
+         * instead.
          */
         interface $TemplateControlSettings
           extends sap.ui.core.$ControlSettings {
@@ -27326,7 +27380,8 @@ declare namespace sap {
          * Represents a DOM attribute of a DOM element.
          *
          * @since 1.15
-         * @deprecated (since 1.56)
+         * @deprecated (since 1.56) - Use an {@link sap.ui.core.mvc.XMLView XMLView} or a {@link topic:e6bb33d076dc4f23be50c082c271b9f0 Typed View }
+         * instead.
          */
         class DOMAttribute extends sap.ui.core.Element {
           /**
@@ -27446,7 +27501,8 @@ declare namespace sap {
          * Represents a DOM element. It allows to use databinding for the properties and nested DOM attributes.
          *
          * @since 1.15
-         * @deprecated (since 1.56)
+         * @deprecated (since 1.56) - Use an {@link sap.ui.core.mvc.XMLView XMLView} or a {@link topic:e6bb33d076dc4f23be50c082c271b9f0 Typed View }
+         * instead.
          */
         class DOMElement extends sap.ui.core.Control {
           /**
@@ -27754,7 +27810,8 @@ declare namespace sap {
          * The class for Handlebars Templates.
          *
          * @since 1.15
-         * @deprecated (since 1.56)
+         * @deprecated (since 1.56) - Use an {@link sap.ui.core.mvc.XMLView XMLView} or a {@link topic:e6bb33d076dc4f23be50c082c271b9f0 Typed View }
+         * instead.
          */
         abstract class HandlebarsTemplate extends sap.ui.core.tmpl.Template {
           /**
@@ -28093,7 +28150,8 @@ declare namespace sap {
          * This is the base class for all template controls. Template controls are declared based on templates.
          *
          * @since 1.15
-         * @deprecated (since 1.56)
+         * @deprecated (since 1.56) - Use an {@link sap.ui.core.mvc.XMLView XMLView} or a {@link topic:e6bb33d076dc4f23be50c082c271b9f0 Typed View }
+         * instead.
          */
         class TemplateControl extends sap.ui.core.Control {
           /**
@@ -28545,7 +28603,7 @@ declare namespace sap {
          *
          * @since 1.107
          * @deprecated (since 1.120) - without a replacement. Applications should not be interested in the set of
-         * all `UIArea`s. They should only assign controls to them, by using {@link sap.ui.core.Control.prototype.placeAt Control.prototype.placeAt }
+         * `UIArea`s. They should only assign controls to them, by using {@link sap.ui.core.Control.prototype.placeAt Control.prototype.placeAt }
          * or use the API of a `UIArea` as reachable via {@link sap.ui.core.Control.prototype.getUIArea Control.prototype.getUIArea}.
          */
         interface registry {
@@ -28553,7 +28611,7 @@ declare namespace sap {
            * Number of existing UIAreas.
            *
            * @deprecated (since 1.120) - without a replacement. Applications should not be interested in the set of
-           * all `UIArea`s. They should only assign controls to them, by using {@link sap.ui.core.Control.prototype.placeAt Control.prototype.placeAt }
+           * `UIArea`s. They should only assign controls to them, by using {@link sap.ui.core.Control.prototype.placeAt Control.prototype.placeAt }
            * or use the API of a `UIArea` as reachable via {@link sap.ui.core.Control.prototype.getUIArea Control.prototype.getUIArea}.
            */
           size: int;
@@ -28657,8 +28715,8 @@ declare namespace sap {
            * When the ID is `null` or `undefined` or when there's no UIArea with the given ID, then `undefined` is
            * returned.
            *
-           * @deprecated (since 1.120) - without a replacement. Applications should not be interested in the set of
-           * all `UIArea`s. They should only assign controls to them, by using {@link sap.ui.core.Control.prototype.placeAt Control.prototype.placeAt }
+           * @deprecated (since 1.120) - without a replacement. Applications should not be interested in a certain
+           * `UIArea`. They should only assign controls to them, by using {@link sap.ui.core.Control.prototype.placeAt Control.prototype.placeAt }
            * or use the API of a `UIArea` as reachable via {@link sap.ui.core.Control.prototype.getUIArea Control.prototype.getUIArea}.
            *
            * @returns UIArea with the given ID or `undefined`
@@ -30379,7 +30437,7 @@ declare namespace sap {
         /**
          * Class to mock http requests made to a remote server supporting the OData V2 REST protocol.
          */
-        abstract class MockServer extends sap.ui.base.ManagedObject {
+        class MockServer extends sap.ui.base.ManagedObject {
           /**
            * Creates a mocked server. This helps to mock some back-end calls, e.g. for OData V2/JSON Models or simple
            * XHR calls, without changing the application code. This class can also be used for qunit tests.
@@ -47845,7 +47903,7 @@ declare namespace sap {
          * The node must have an ID that will be used as ID for this instance of `UIArea`.
          *
          * @deprecated (since 1.107) - without a replacement. Applications should not create or modify `UIArea`s
-         * programmatically. THey should only assign controls to them, by using {@link sap.ui.core.Control.prototype.placeAt Control.prototype.placeAt }
+         * programmatically. They should only assign controls to them, by using {@link sap.ui.core.Control.prototype.placeAt Control.prototype.placeAt }
          * or use the API of a `UIArea` as reachable via {@link sap.ui.core.Control.prototype.getUIArea Control.prototype.getUIArea}.
          */
         setRootNode(
@@ -53017,9 +53075,13 @@ declare namespace sap {
             oContext?: sap.ui.model.Context
           ): any | null | undefined;
           /**
-           * Load JSON-encoded data from the server using a GET HTTP request and store the resulting JSON data in
-           * the model. Note: Due to browser security restrictions, most "Ajax" requests are subject to the same origin
-           * policy, the request can not successfully retrieve data from a different domain, subdomain, or protocol.
+           * Loads JSON-encoded data from the server and stores the resulting JSON data in the model. Note: Due to
+           * browser security restrictions, most "Ajax" requests are subject to the same origin policy, the request
+           * can not successfully retrieve data from a different domain, subdomain, or protocol.
+           *
+           * Note: To send a JSON object in the body of a "POST" request to load the model data, `oParameters` has
+           * to be the JSON-stringified value of the object to be sent, and `mHeaders` has to contain a `"Content-Type"`
+           * property with the value `"application/json;charset=utf-8"`.
            *
            *
            * @returns in case bAsync is set to true a Promise is returned; this promise resolves/rejects based on
@@ -53027,13 +53089,16 @@ declare namespace sap {
            */
           loadData(
             /**
-             * A string containing the URL to which the request is sent.
+             * A string containing the URL to which the request is sent
              */
             sURL: string,
             /**
-             * A map or string that is sent to the server with the request. Data that is sent to the server is appended
-             * to the URL as a query string. If the value of the data parameter is an object (map), it is converted
-             * to a string and url-encoded before it is appended to the URL.
+             * The data to be sent to the server with the data-loading request. If `oParameters` is a string, it has
+             * to be encoded based on the used content type. The default encoding is `'application/x-www-form-urlencoded;
+             * charset=UTF-8'` but it may be overwritten via the `"Content-Type"` property given in `mHeaders`. If `oParameters`
+             * is an object, a string is generated and the keys and values are URL-encoded. The resulting string is
+             * appended to the URL if the HTTP request method cannot have a request body, e.g. for a "GET" request.
+             * Otherwise, the resulting string is added to the request body.
              */
             oParameters?: object | string,
             /**
@@ -53043,8 +53108,7 @@ declare namespace sap {
              */
             bAsync?: boolean,
             /**
-             * The type of request to make ("POST" or "GET"), default is "GET". Note: Other HTTP request methods, such
-             * as PUT and DELETE, can also be used here, but they are not supported by all browsers.
+             * The HTTP verb to use for the request ("GET" or "POST")
              */
             sType?: string,
             /**

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

@@ -1,3 +1,3 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {}

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {
   namespace ui {

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {
   namespace ui {

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {
   namespace ui {

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare module "sap/ui/mdc/AggregationBaseDelegate" {
   import BaseDelegate from "sap/ui/mdc/BaseDelegate";

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare module "sap/ui/rta/api/startAdaptation" {
   /**

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {
   namespace ui {

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {
   namespace ui {

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {
   namespace ui {

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {
   interface IUI5DefineDependencyNames {

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {
   namespace ui {

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {
   namespace ui {

package/types/sap.ui.webc.common.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {
   namespace ui {
@@ -6,6 +6,8 @@ declare namespace sap {
      * Namespace for UI5 Web Components Retrofit libraries
      *
      * @since 1.92.0
+     * @deprecated (since 1.120) - this Web Components consumption model has been discarded. An alternative
+     * consumption model is planned for the future.
      * @experimental (since 1.92.0)
      */
     namespace webc {

package/types/sap.ui.webc.fiori.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {
   namespace ui {

package/types/sap.ui.webc.main.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {
   namespace ui {

package/types/sap.uxap.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.120.16
+// For Library Version: 1.120.18
 
 declare namespace sap {
   /**