@sapui5/ts-types 1.111.1 → 1.112.1

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.111.1
+// For Library Version: 1.112.0
 
 declare namespace sap {
   namespace ui {
@@ -8217,6 +8217,116 @@ declare namespace sap {
         }
       }
 
+      namespace odata {
+        interface $ComboBoxSettings extends sap.m.$ComboBoxSettings {
+          /**
+           * Sets the `value` property formatting according to the `com.sap.vocabularies.UI.v1.TextArrangementType`
+           * from the ValueList property.
+           */
+          textArrangement?:
+            | string
+            | sap.ui.base.ManagedObject.PropertyBindingInfo;
+        }
+
+        /**
+         * Extends the functionalities in sap.m.ComboBox
+         */
+        class ComboBox
+          extends sap.m.ComboBox
+          implements /* was: sap.ui.comp.IDropDownTextArrangement */ Object {
+          __implements__sap_ui_comp_IDropDownTextArrangement: boolean;
+          /**
+           * Constructor for a new `odata/ComboBox`.
+           *
+           * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
+           * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
+           * of the syntax of the settings object.
+           */
+          constructor(
+            /**
+             * Initial settings for the new control
+             */
+            mSettings?: sap.ui.comp.odata.$ComboBoxSettings
+          );
+          /**
+           * Constructor for a new `odata/ComboBox`.
+           *
+           * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
+           * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
+           * of the syntax of the settings object.
+           */
+          constructor(
+            /**
+             * ID for the new control, generated automatically if no ID is given
+             */
+            sId?: string,
+            /**
+             * Initial settings for the new control
+             */
+            mSettings?: sap.ui.comp.odata.$ComboBoxSettings
+          );
+
+          /**
+           * Creates a new subclass of class sap.ui.comp.odata.ComboBox with name `sClassName` and enriches it with
+           * the information contained in `oClassInfo`.
+           *
+           * `oClassInfo` might contain the same kind of information as described in {@link sap.m.ComboBox.extend}.
+           *
+           * @returns Created class / constructor function
+           */
+          static extend<T extends Record<string, unknown>>(
+            /**
+             * Name of the class being created
+             */
+            sClassName: string,
+            /**
+             * Object literal with information about the class
+             */
+            oClassInfo?: sap.ClassInfo<T, sap.ui.comp.odata.ComboBox>,
+            /**
+             * Constructor function for the metadata object; if not given, it defaults to the metadata implementation
+             * used by this class
+             */
+            FNMetaImpl?: Function
+          ): Function;
+          /**
+           * Returns a metadata object for class sap.ui.comp.odata.ComboBox.
+           *
+           * @returns Metadata object describing this class
+           */
+          static getMetadata(): sap.ui.core.ElementMetadata;
+          /**
+           * Gets current value of property {@link #getTextArrangement textArrangement}.
+           *
+           * Sets the `value` property formatting according to the `com.sap.vocabularies.UI.v1.TextArrangementType`
+           * from the ValueList property.
+           *
+           * Default value is `empty string`.
+           *
+           * @returns Value of property `textArrangement`
+           */
+          getTextArrangement(): string;
+          /**
+           * Sets a new value for property {@link #getTextArrangement textArrangement}.
+           *
+           * Sets the `value` property formatting according to the `com.sap.vocabularies.UI.v1.TextArrangementType`
+           * from the ValueList property.
+           *
+           * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+           *
+           * Default value is `empty string`.
+           *
+           * @returns Reference to `this` in order to allow method chaining
+           */
+          setTextArrangement(
+            /**
+             * New value for property `textArrangement`
+             */
+            sTextArrangement?: string
+          ): this;
+        }
+      }
+
       namespace personalization {
         /**
          * Provides enumeration sap.ui.comp.personalization.AggregationRole. A subset of aggregation roles used
@@ -11143,14 +11253,6 @@ declare namespace sap {
            * Property works the same as sap.m.Input control `value`
            */
           realValue?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
-
-          /**
-           * Sets the `value` property formatting according to the `com.sap.vocabularies.UI.v1.TextArrangementType`
-           * from the ValueList property.
-           */
-          valueTextArrangement?:
-            | string
-            | sap.ui.base.ManagedObject.PropertyBindingInfo;
         }
 
         interface $ConfigurationSettings extends sap.ui.core.$ElementSettings {
@@ -11949,17 +12051,6 @@ declare namespace sap {
            * @returns Value of property `realValue`
            */
           getRealValue(): string;
-          /**
-           * Gets current value of property {@link #getValueTextArrangement valueTextArrangement}.
-           *
-           * Sets the `value` property formatting according to the `com.sap.vocabularies.UI.v1.TextArrangementType`
-           * from the ValueList property.
-           *
-           * Default value is `empty string`.
-           *
-           * @returns Value of property `valueTextArrangement`
-           */
-          getValueTextArrangement(): string;
           /**
            * Sets a new value for property {@link #getEnteredValue enteredValue}.
            *
@@ -11992,24 +12083,6 @@ declare namespace sap {
              */
             sRealValue?: string
           ): this;
-          /**
-           * Sets a new value for property {@link #getValueTextArrangement valueTextArrangement}.
-           *
-           * Sets the `value` property formatting according to the `com.sap.vocabularies.UI.v1.TextArrangementType`
-           * from the ValueList property.
-           *
-           * When called with a value of `null` or `undefined`, the default value of the property will be restored.
-           *
-           * Default value is `empty string`.
-           *
-           * @returns Reference to `this` in order to allow method chaining
-           */
-          setValueTextArrangement(
-            /**
-             * New value for property `valueTextArrangement`
-             */
-            sValueTextArrangement?: string
-          ): this;
         }
         /**
          * The configuration allows to further define the behavior of a `SmartField`.
@@ -15703,6 +15776,17 @@ declare namespace sap {
           high?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
         }
 
+        interface $SFBMultiComboBoxSettings
+          extends sap.m.$MultiComboBoxSettings {
+          /**
+           * Sets the `value` property formatting according to the `com.sap.vocabularies.UI.v1.TextArrangementType`
+           * from the ValueList property.
+           */
+          textArrangement?:
+            | string
+            | sap.ui.base.ManagedObject.PropertyBindingInfo;
+        }
+
         interface $SmartFilterBarSettings
           extends sap.ui.comp.filterbar.$FilterBarSettings {
           /**
@@ -17118,6 +17202,84 @@ declare namespace sap {
             sSign?: sap.ui.comp.smartfilterbar.SelectOptionSign
           ): this;
         }
+        /**
+         * Extends the functionalities in sap.m.MultiComboBox
+         */
+        class SFBMultiComboBox
+          extends sap.m.MultiComboBox
+          implements /* was: sap.ui.comp.IDropDownTextArrangement */ Object {
+          __implements__sap_ui_comp_IDropDownTextArrangement: boolean;
+          /**
+           * Constructor for a new `SmartFilterBar/SFBMultiComboBox`.
+           *
+           * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
+           * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
+           * of the syntax of the settings object.
+           */
+          constructor();
+
+          /**
+           * Creates a new subclass of class sap.ui.comp.smartfilterbar.SFBMultiComboBox with name `sClassName` and
+           * enriches it with the information contained in `oClassInfo`.
+           *
+           * `oClassInfo` might contain the same kind of information as described in {@link sap.m.MultiComboBox.extend}.
+           *
+           * @returns Created class / constructor function
+           */
+          static extend<T extends Record<string, unknown>>(
+            /**
+             * Name of the class being created
+             */
+            sClassName: string,
+            /**
+             * Object literal with information about the class
+             */
+            oClassInfo?: sap.ClassInfo<
+              T,
+              sap.ui.comp.smartfilterbar.SFBMultiComboBox
+            >,
+            /**
+             * Constructor function for the metadata object; if not given, it defaults to the metadata implementation
+             * used by this class
+             */
+            FNMetaImpl?: Function
+          ): Function;
+          /**
+           * Returns a metadata object for class sap.ui.comp.smartfilterbar.SFBMultiComboBox.
+           *
+           * @returns Metadata object describing this class
+           */
+          static getMetadata(): sap.ui.core.ElementMetadata;
+          /**
+           * Gets current value of property {@link #getTextArrangement textArrangement}.
+           *
+           * Sets the `value` property formatting according to the `com.sap.vocabularies.UI.v1.TextArrangementType`
+           * from the ValueList property.
+           *
+           * Default value is `empty string`.
+           *
+           * @returns Value of property `textArrangement`
+           */
+          getTextArrangement(): string;
+          /**
+           * Sets a new value for property {@link #getTextArrangement textArrangement}.
+           *
+           * Sets the `value` property formatting according to the `com.sap.vocabularies.UI.v1.TextArrangementType`
+           * from the ValueList property.
+           *
+           * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+           *
+           * Default value is `empty string`.
+           *
+           * @returns Reference to `this` in order to allow method chaining
+           */
+          setTextArrangement(
+            /**
+             * New value for property `textArrangement`
+             */
+            sTextArrangement?: string
+          ): this;
+        }
         /**
          * The `SmartFilterBar` control uses the OData metadata of an entity in order to create a FilterBar.
          *  Whether a field is visible on the FilterBar, supports type-ahead and value help, for example, is automatically
@@ -34987,6 +35149,7 @@ declare namespace sap {
 
           /**
            * @SINCE 1.22.0
+           * @deprecated (since 1.26) - replaced by the `variantItems` aggregation
            *
            * Items displayed by the `VariantManagement` control.
            */
@@ -35837,6 +36000,7 @@ declare namespace sap {
           static getMetadata(): sap.ui.core.ElementMetadata;
           /**
            * @SINCE 1.22.0
+           * @deprecated (since 1.26) - replaced by the `variantItems` aggregation
            *
            * Adds some item to the aggregation {@link #getItems items}.
            *
@@ -36037,6 +36201,7 @@ declare namespace sap {
           ): void;
           /**
            * @SINCE 1.22.0
+           * @deprecated (since 1.26) - replaced by the `variantItems` aggregation
            *
            * Destroys all the items in the aggregation {@link #getItems items}.
            *
@@ -36251,6 +36416,7 @@ declare namespace sap {
           getInitialSelectionKey(): string;
           /**
            * @SINCE 1.22.0
+           * @deprecated (since 1.26) - replaced by the `variantItems` aggregation
            *
            * Gets content of aggregation {@link #getItems items}.
            *
@@ -36399,6 +36565,7 @@ declare namespace sap {
           getVariantItems(): sap.ui.comp.variants.VariantItem[];
           /**
            * @SINCE 1.22.0
+           * @deprecated (since 1.26) - replaced by the `variantItems` aggregation
            *
            * Checks for the provided `sap.ui.core.Item` in the aggregation {@link #getItems items}. and returns its
            * index if found or -1 otherwise.
@@ -36427,6 +36594,7 @@ declare namespace sap {
           ): int;
           /**
            * @SINCE 1.22.0
+           * @deprecated (since 1.26) - replaced by the `variantItems` aggregation
            *
            * Inserts a item into the aggregation {@link #getItems items}.
            *
@@ -36465,6 +36633,7 @@ declare namespace sap {
           ): this;
           /**
            * @SINCE 1.22.0
+           * @deprecated (since 1.26) - replaced by the `variantItems` aggregation
            *
            * Removes all the controls from the aggregation {@link #getItems items}.
            *
@@ -36485,6 +36654,7 @@ declare namespace sap {
           removeAllVariantItems(): sap.ui.comp.variants.VariantItem[];
           /**
            * @SINCE 1.22.0
+           * @deprecated (since 1.26) - replaced by the `variantItems` aggregation
            *
            * Removes a item from the aggregation {@link #getItems items}.
            *
@@ -36854,6 +37024,8 @@ declare namespace sap {
 
     "sap/ui/comp/navpopover/SmartLink": undefined;
 
+    "sap/ui/comp/odata/ComboBox": undefined;
+
     "sap/ui/comp/smartchart/SmartChart": undefined;
 
     "sap/ui/comp/smartfield/ComboBox": undefined;
@@ -36872,6 +37044,8 @@ declare namespace sap {
 
     "sap/ui/comp/smartfilterbar/SelectOption": undefined;
 
+    "sap/ui/comp/smartfilterbar/SFBMultiComboBox": undefined;
+
     "sap/ui/comp/smartfilterbar/SmartFilterBar": undefined;
 
     "sap/ui/comp/smartfilterbar/SmartFilterBarFilterGroupItem": undefined;

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

@@ -266,7 +266,21 @@ interface JQuery<TElement = HTMLElement> extends Iterable<TElement> {
   ): jQuery;
 }
 
-// For Library Version: 1.111.1
+declare module "sap/ui/thirdparty/jquery" {
+  export default jQuery;
+}
+declare module "sap/ui/thirdparty/qunit-2" {
+  export default QUnit;
+}
+
+declare namespace sap {
+  interface IUI5DefineDependencyNames {
+    "sap/ui/thirdparty/jquery": undefined;
+    "sap/ui/thirdparty/qunit-2": undefined;
+  }
+}
+
+// For Library Version: 1.112.0
 
 declare module "sap/base/assert" {
   /**
@@ -2530,7 +2544,8 @@ declare module "sap/ui/core/date/UI5Date" {
      */
     getUTCSeconds(): int;
     /**
-     * @deprecated (since 1.111.0) - as it is deprecated in JavaScript Date; use {@link #getFullYear} instead
+     * @deprecated (since 1.111) - as it is deprecated in the base class JavaScript Date; use {@link #getFullYear}
+     * instead
      *
      * Returns the year of this date instance minus 1900 according to the configured time zone, see `Date.prototype.getYear`.
      *
@@ -2794,7 +2809,8 @@ declare module "sap/ui/core/date/UI5Date" {
       iMilliseconds?: int
     ): int;
     /**
-     * @deprecated (since 1.111.0) - as it is deprecated in JavaScript Date; use {@link #setFullYear} instead
+     * @deprecated (since 1.111) - as it is deprecated in the base class JavaScript Date; use {@link #setFullYear}
+     * instead
      *
      * Sets the year for this date instance plus 1900 considering the configured time zone, see `Date.prototype.setYear`.
      *
@@ -11721,7 +11737,7 @@ declare namespace sap {
          *
          * @returns Whether the given object is an instance of the given type or of any of the given types
          */
-        static isA(
+        static isA<T extends sap.ui.base.Object = sap.ui.base.Object>(
           /**
            * Object which will be checked whether it is an instance of the given type
            */
@@ -11730,7 +11746,7 @@ declare namespace sap {
            * Type or types to check for
            */
           vTypeName: string | string[]
-        ): boolean;
+        ): oObject is T;
         /**
          * Destructor method for objects.
          */
@@ -11774,12 +11790,12 @@ declare namespace sap {
          *
          * @returns Whether this object is an instance of the given type or of any of the given types
          */
-        isA(
+        isA<T extends sap.ui.base.Object = sap.ui.base.Object>(
           /**
            * Type or types to check for
            */
           vTypeName: string | string[]
-        ): boolean;
+        ): this is T;
       }
       /**
        * Manages a pool of objects for reuse, all of the same type; the type has to be specified at construction
@@ -50863,6 +50879,13 @@ declare namespace sap {
                  * Map of custom headers (name/value pairs) like {"myHeader":"myHeaderValue",...}
                  */
                 headers?: Record<string, string>;
+                /**
+                 * **Experimental** as of version 1.112.0; may change behavior or be removed in future versions. Whether
+                 * to ignore all annotations from service metadata, so that they are not available as V4 annotations in
+                 * this model's metamodel; see {@link #getMetaModel}. Only annotations from annotation files are loaded;
+                 * see the `annotationURI` parameter.
+                 */
+                ignoreAnnotationsFromMetadata?: boolean;
                 /**
                  * If set to `true`, request payloads will be JSON, XML for `false`
                  */
@@ -50918,12 +50941,6 @@ declare namespace sap {
                  * for the `$metadata` request
                  */
                 serviceUrlParams?: Record<string, string>;
-                /**
-                 * 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 not annotations inside the metadata document
-                 */
-                skipMetadataAnnotationParsing?: boolean;
                 /**
                  * Enable/disable security token handling
                  */
@@ -50947,6 +50964,13 @@ declare namespace sap {
                  * 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
+                 */
+                skipMetadataAnnotationParsing?: boolean;
                 /**
                  * **Deprecated** for security reasons. Use strong server side authentication instead. UserID for the service.
                  */
@@ -51858,7 +51882,7 @@ declare namespace sap {
                  * for dependent bindings into fewer $batch requests. For more information, see {@link topic:6c47b2b39db9404582994070ec3d57a2#loio62149734b5c24507868e722fe87a75db
                  * Optimizing Dependent Bindings}
                  */
-                preliminaryContext?: boolean;
+                createPreliminaryContext?: boolean;
                 /**
                  * Optional map of custom query parameters, names of custom parameters must not start with `$`.
                  */
@@ -53274,10 +53298,6 @@ declare namespace sap {
                * A map which contains the following parameter properties:
                */
               mParameters?: {
-                /**
-                 * Deprecated - use `groupId` instead
-                 */
-                batchGroupId?: string;
                 /**
                  * Defines the group that should be submitted. If not specified, all deferred groups will be submitted.
                  * Requests belonging to the same group will be bundled in one batch request.
@@ -53297,6 +53317,16 @@ declare namespace sap {
                  * which contains additional error information
                  */
                 error?: Function;
+                /**
+                 * **Deprecated**, 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.
+                 */
+                merge?: boolean;
               }
             ): object;
             /**
@@ -55678,8 +55708,12 @@ 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.
              *
-             * Note: A deep create is not supported. The dependent entity has to be created using a second list binding.
-             * Note that it is not supported to bind relative to a transient context.
+             * Since 1.112.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
+             * also has a {@link sap.ui.model.odata.v4.Context#created created} promise, which resolves when the deep
+             * create resolves. Deep create is an **experimental** API.
              *
              * Note: Creating at the end is only allowed if the final length of the binding is known (see {@link #isLengthFinal}),
              * so that there is a clear position to place this entity at. This is the case if the complete collection
@@ -55695,7 +55729,8 @@ declare namespace sap {
                */
               oInitialData?: object,
               /**
-               * Whether an automatic refresh of the created entity will be skipped
+               * Whether an automatic refresh of the created entity will be skipped; ignored within a deep create (when
+               * the binding's parent context is transient)
                */
               bSkipRefresh?: boolean,
               /**
@@ -56783,8 +56818,8 @@ declare namespace sap {
             getOriginalProperty(): void;
             /**
              * @SINCE 1.37.0
-             * @deprecated (since 1.37.0) - use {@link #getObject}.
              *
+             * Use {@link #getObject}.
              * See:
              * 	sap.ui.model.Model#getProperty
              */
@@ -57692,11 +57727,10 @@ declare namespace sap {
                  */
                 $$ownRequest?: boolean;
                 /**
-                 * 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; state messages (since 1.108.0) and the
-                 * following APIs are **not** allowed
+                 * Whether multiple bindings for the same resource path share the data, so that it is requested only once.
+                 * 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; 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}  {@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}
@@ -59064,7 +59098,7 @@ declare namespace sap {
              * if `true`, the string values `vValue1` and `vValue2` are compared as a decimal number (only sign, integer
              * and fraction digits; no exponential format). Otherwise they are recognized by looking at their types.
              */
-            bAsDecimal?: string
+            bAsDecimal?: boolean
           ): int;
           /**
            * Formats a JavaScript value according to the given
@@ -59146,9 +59180,9 @@ declare namespace sap {
                    */
                   client: string;
                   /**
-                   * setting this flag to 'true' overrides the already existing origin
+                   * setting this flag to `true` overrides the already existing origin
                    */
-                  force: string;
+                  force: boolean;
                 }
               | string
           ): string;
@@ -73714,7 +73748,13 @@ declare namespace sap {
              *             ]}
              * ```
              */
-            matchers?: Function | any[] | object | sap.ui.test.matchers.Matcher;
+            matchers?:
+              | ((p1: sap.ui.core.Element) => void)
+              | Record<string, object>
+              | sap.ui.test.matchers.Matcher
+              | Array<(p1: sap.ui.core.Element) => void>
+              | Array<Record<string, object>>
+              | sap.ui.test.matchers.Matcher[];
             /**
              * Selects all control by their type. It is usually combined with a viewName or searchOpenDialogs. If no
              * control is matching the type, an empty array will be returned. Here are some samples:
@@ -73797,7 +73837,9 @@ declare namespace sap {
              * will stop. The first parameter passed into the function is the same value that gets passed to the success
              * function. Returning something other than boolean in check will not change the first parameter of success.
              */
-            check?: Function;
+            check?: (
+              p1: sap.ui.core.Element | sap.ui.core.Element[]
+            ) => boolean;
             /**
              * Will get invoked after the following conditions are met:
              * 	 -  One or multiple controls were found using controlType, Id, viewName. If visible is true (it is by
@@ -73808,7 +73850,7 @@ declare namespace sap {
              * 			(viewName, controlType, multiple ID's, regex ID's) that matched all matchers. Matchers can alter the
              * 			array or single control to something different. Please read the documentation of waitFor's matcher parameter.
              */
-            success?: Function;
+            success?: (p1: sap.ui.core.Element | sap.ui.core.Element[]) => void;
             /**
              * Invoked when the timeout is reached and the check never returned true.
              */

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

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