@openui5/ts-types-esm 1.102.1 → 1.103.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -264,7 +264,7 @@ interface JQuery<TElement = HTMLElement> extends Iterable<TElement> {
264
264
  ): jQuery;
265
265
  }
266
266
 
267
- // For Library Version: 1.102.1
267
+ // For Library Version: 1.103.0
268
268
 
269
269
  declare module "sap/base/assert" {
270
270
  /**
@@ -3831,7 +3831,7 @@ declare module "sap/ui/util/Storage" {
3831
3831
  /**
3832
3832
  * Retrieves data item for a specific key.
3833
3833
  *
3834
- * @returns keys value or null
3834
+ * @returns key's value or `null`
3835
3835
  */
3836
3836
  get(
3837
3837
  /**
@@ -6437,7 +6437,7 @@ declare module "sap/ui/base/ManagedObject" {
6437
6437
  * Applications or frameworks must not use this method to generically read the content of an aggregation.
6438
6438
  * Use the concrete method getXYZ for aggregation 'XYZ' instead.
6439
6439
  *
6440
- * @returns Aggregation array in case of 0..n-aggregations or the managed object or null in case of 0..1-aggregations
6440
+ * @returns Aggregation array in case of 0..n-aggregations or the managed object or `null` in case of 0..1-aggregations
6441
6441
  */
6442
6442
  getAggregation(
6443
6443
  /**
@@ -6446,7 +6446,7 @@ declare module "sap/ui/base/ManagedObject" {
6446
6446
  sAggregationName: string,
6447
6447
  /**
6448
6448
  * Object that is used in case the current aggregation is empty. If provided, it must be null for 0..1 aggregations
6449
- * or an empty array for 0..n aggregations. If not provided, null is used.
6449
+ * or an empty array for 0..n aggregations. If not provided, `null` is used.
6450
6450
  *
6451
6451
  * **Note:** When an empty array is given and used because the aggregation was not set before, then this
6452
6452
  * array will be used for the aggregation from thereon. Sharing the same empty array between different calls
@@ -6622,14 +6622,16 @@ declare module "sap/ui/base/ManagedObject" {
6622
6622
  * information is not active by default and must be activated by configuration. Even then, it might not
6623
6623
  * be present for all properties and their values depending on where the value came form.
6624
6624
  *
6625
- * @returns a map of properties describing the origin of this property value or null
6625
+ * If no origin info is available, `null` will be returned.
6626
+ *
6627
+ * @returns An object describing the origin of this property's value or `null`
6626
6628
  */
6627
6629
  getOriginInfo(
6628
6630
  /**
6629
- * the name of the property
6631
+ * Name of the property
6630
6632
  */
6631
6633
  sPropertyName: string
6632
- ): object;
6634
+ ): object | null;
6633
6635
  /**
6634
6636
  * @SINCE 1.88.0
6635
6637
  *
@@ -6887,7 +6889,7 @@ declare module "sap/ui/base/ManagedObject" {
6887
6889
  *
6888
6890
  * If the given object is found in the aggregation, it is removed, it's parent relationship is unset and
6889
6891
  * this ManagedObject is marked as changed. The removed object is returned as result of this method. If
6890
- * the object could not be found, `undefined` is returned.
6892
+ * the object could not be found, `null` is returned.
6891
6893
  *
6892
6894
  * This method must only be called for aggregations of cardinality 0..n. The only way to remove objects
6893
6895
  * from a 0..1 aggregation is to set a `null` value for them.
@@ -6896,7 +6898,7 @@ declare module "sap/ui/base/ManagedObject" {
6896
6898
  * Applications or frameworks must not use this method to generically remove an object from an aggregation.
6897
6899
  * Use the concrete method removeXYZ for aggregation 'XYZ' instead.
6898
6900
  *
6899
- * @returns the removed object or null
6901
+ * @returns the removed object or `null`
6900
6902
  */
6901
6903
  removeAggregation(
6902
6904
  /**
@@ -6913,7 +6915,7 @@ declare module "sap/ui/base/ManagedObject" {
6913
6915
  * if true, this ManagedObject is not marked as changed
6914
6916
  */
6915
6917
  bSuppressInvalidate?: boolean
6916
- ): ManagedObject;
6918
+ ): ManagedObject | null;
6917
6919
  /**
6918
6920
  * Removes all objects from the 0..n-aggregation named `sAggregationName`.
6919
6921
  *
@@ -7943,14 +7945,14 @@ declare module "sap/ui/base/ManagedObjectMetadata" {
7943
7945
  * not part of the API. See the {@link #constructor Notes about Info objects} in the constructor documentation
7944
7946
  * of this class.
7945
7947
  *
7946
- * @returns aggregation info object or undefined
7948
+ * @returns aggregation info object or `undefined`
7947
7949
  */
7948
7950
  getManagedAggregation(
7949
7951
  /**
7950
7952
  * name of the aggregation to be retrieved or empty
7951
7953
  */
7952
7954
  sAggregationName: string
7953
- ): object;
7955
+ ): object | undefined;
7954
7956
  /**
7955
7957
  * Returns the info object for the named public or private association declared by the described class or
7956
7958
  * by any of its ancestors.
@@ -7959,14 +7961,14 @@ declare module "sap/ui/base/ManagedObjectMetadata" {
7959
7961
  * not part of the API. See the {@link #constructor Notes about Info objects} in the constructor documentation
7960
7962
  * of this class.
7961
7963
  *
7962
- * @returns association info object or undefined
7964
+ * @returns association info object or `undefined`
7963
7965
  */
7964
7966
  getManagedAssociation(
7965
7967
  /**
7966
7968
  * name of the association to be retrieved
7967
7969
  */
7968
7970
  sName: string
7969
- ): object;
7971
+ ): object | undefined;
7970
7972
  /**
7971
7973
  * Returns the info object for the named public or private property declared by the described class or by
7972
7974
  * any of its ancestors.
@@ -7978,14 +7980,14 @@ declare module "sap/ui/base/ManagedObjectMetadata" {
7978
7980
  * not part of the API. See the {@link #constructor Notes about Info objects} in the constructor documentation
7979
7981
  * of this class.
7980
7982
  *
7981
- * @returns property info object or undefined
7983
+ * @returns property info object or `undefined`
7982
7984
  */
7983
7985
  getManagedProperty(
7984
7986
  /**
7985
7987
  * name of the property to be retrieved or empty
7986
7988
  */
7987
7989
  sName: string
7988
- ): object;
7990
+ ): object | undefined;
7989
7991
  /**
7990
7992
  * Returns a map of info objects for the public properties of the described class. Properties declared by
7991
7993
  * ancestor classes are not included.
@@ -17102,7 +17104,7 @@ declare module "sap/ui/core/dnd/DragAndDrop" {
17102
17104
  * The key of the data
17103
17105
  */
17104
17106
  sKey: string
17105
- ): any;
17107
+ ): any | undefined;
17106
17108
  /**
17107
17109
  * Returns the data that has been set via `setData` method.
17108
17110
  *
@@ -18331,14 +18333,14 @@ declare module "sap/ui/core/Element" {
18331
18333
  * dash) and the DOM node with that compound ID will be returned. This matches the UI5 naming convention
18332
18334
  * for named inner DOM nodes of a control.
18333
18335
  *
18334
- * @returns The Element's DOM Element sub DOM Element or null
18336
+ * @returns The Element's DOM Element, sub DOM Element or `null`
18335
18337
  */
18336
18338
  getDomRef(
18337
18339
  /**
18338
18340
  * ID suffix to get the DOMRef for
18339
18341
  */
18340
18342
  sSuffix?: string
18341
- ): Element;
18343
+ ): Element | null;
18342
18344
  /**
18343
18345
  * @SINCE 1.56
18344
18346
  *
@@ -18367,13 +18369,13 @@ declare module "sap/ui/core/Element" {
18367
18369
  sModelName?: string
18368
18370
  ): ContextBinding;
18369
18371
  /**
18370
- * Returns the DOM Element that should get the focus.
18372
+ * Returns the DOM Element that should get the focus or `null` if there's no such element currently.
18371
18373
  *
18372
18374
  * To be overwritten by the specific control method.
18373
18375
  *
18374
- * @returns Returns the DOM Element that should get the focus
18376
+ * @returns Returns the DOM Element that should get the focus or `null`
18375
18377
  */
18376
- getFocusDomRef(): Element;
18378
+ getFocusDomRef(): Element | null;
18377
18379
  /**
18378
18380
  * Returns an object representing the serialized focus information.
18379
18381
  *
@@ -18420,20 +18422,20 @@ declare module "sap/ui/core/Element" {
18420
18422
  */
18421
18423
  getTooltip(): string | TooltipBase;
18422
18424
  /**
18423
- * Returns the tooltip for this element but only if it is a simple string. Otherwise an undefined value
18424
- * is returned.
18425
+ * Returns the tooltip for this element but only if it is a simple string. Otherwise, `undefined` is returned.
18425
18426
  *
18426
- * @returns string tooltip or undefined
18427
+ * @returns string tooltip or `undefined`
18427
18428
  */
18428
- getTooltip_AsString(): string;
18429
+ getTooltip_AsString(): string | undefined;
18429
18430
  /**
18430
- * Returns the main text for the current tooltip or undefined if there is no such text. If the tooltip is
18431
- * an object derived from sap.ui.core.Tooltip, then the text property of that object is returned. Otherwise
18432
- * the object itself is returned (either a string or undefined or null).
18431
+ * Returns the main text for the current tooltip or `undefined` if there is no such text.
18432
+ *
18433
+ * If the tooltip is an object derived from `sap.ui.core.TooltipBase`, then the text property of that object
18434
+ * is returned. Otherwise the object itself is returned (either a string or `undefined` or `null`).
18433
18435
  *
18434
- * @returns text of the current tooltip or undefined
18436
+ * @returns Text of the current tooltip or `undefined` or `null`
18435
18437
  */
18436
- getTooltip_Text(): string;
18438
+ getTooltip_Text(): string | undefined;
18437
18439
  /**
18438
18440
  * Checks for the provided `sap.ui.core.CustomData` in the aggregation {@link #getCustomData customData}.
18439
18441
  * and returns its index if found or -1 otherwise.
@@ -18596,7 +18598,7 @@ declare module "sap/ui/core/Element" {
18596
18598
  * The customData to remove or its index or id
18597
18599
  */
18598
18600
  vCustomData: int | string | CustomData
18599
- ): CustomData;
18601
+ ): CustomData | null;
18600
18602
  /**
18601
18603
  * @SINCE 1.19
18602
18604
  *
@@ -18609,7 +18611,7 @@ declare module "sap/ui/core/Element" {
18609
18611
  * The dependent to remove or its index or id
18610
18612
  */
18611
18613
  vDependent: int | string | UI5Element
18612
- ): UI5Element;
18614
+ ): UI5Element | null;
18613
18615
  /**
18614
18616
  * @SINCE 1.56
18615
18617
  *
@@ -18622,7 +18624,7 @@ declare module "sap/ui/core/Element" {
18622
18624
  * The dragDropConfig to remove or its index or id
18623
18625
  */
18624
18626
  vDragDropConfig: int | string | DragDropBase
18625
- ): DragDropBase;
18627
+ ): DragDropBase | null;
18626
18628
  /**
18627
18629
  * @SINCE 1.9.0
18628
18630
  *
@@ -20154,12 +20156,130 @@ declare module "sap/ui/core/format/NumberFormat" {
20154
20156
  * ```
20155
20157
  *
20156
20158
  *
20157
- * # * @param {object} [oFormatOptions] The option object, which supports the following parameters. If no
20158
- * options are given, default values according to the type and locale settings are used.
20159
- *
20160
20159
  * @returns float instance of the NumberFormat
20161
20160
  */
20162
20161
  static getFloatInstance(
20162
+ /**
20163
+ * The option object, which supports the following parameters. If no options are given, default values according
20164
+ * to the type and locale settings are used.
20165
+ */
20166
+ oFormatOptions?: {
20167
+ /**
20168
+ * defines the number of decimal digits
20169
+ */
20170
+ decimals?: int;
20171
+ /**
20172
+ * defines the character used as decimal separator. Note: `decimalSeparator` must always be different from
20173
+ * `groupingSeparator`.
20174
+ */
20175
+ decimalSeparator?: string;
20176
+ /**
20177
+ * @since 1.30.0 defines what an empty string is parsed as, and what is formatted as an empty string. The
20178
+ * allowed values are "" (empty string), NaN, `null`, or 0. The 'format' and 'parse' functions are done
20179
+ * in a symmetric way. For example, when this parameter is set to NaN, an empty string is parsed as NaN,
20180
+ * and NaN is formatted as an empty string.
20181
+ */
20182
+ emptyString?: number;
20183
+ /**
20184
+ * defines the grouping base size in digits if it is different from the grouping size (e.g. Indian grouping)
20185
+ */
20186
+ groupingBaseSize?: int;
20187
+ /**
20188
+ * defines whether grouping is enabled (grouping separators are shown)
20189
+ */
20190
+ groupingEnabled?: boolean;
20191
+ /**
20192
+ * defines the character used as grouping separator. Note: `groupingSeparator` must always be different
20193
+ * from `decimalSeparator`.
20194
+ */
20195
+ groupingSeparator?: string;
20196
+ /**
20197
+ * defines the grouping size in digits; the default is `3`. It must be a positive number.
20198
+ */
20199
+ groupingSize?: int;
20200
+ /**
20201
+ * defines the maximum number of decimal digits
20202
+ */
20203
+ maxFractionDigits?: int;
20204
+ /**
20205
+ * defines the maximum number of non-decimal digits. If the number exceeds this maximum, e.g. 1e+120, "?"
20206
+ * characters are shown instead of digits.
20207
+ */
20208
+ maxIntegerDigits?: int;
20209
+ /**
20210
+ * defines the minimal number of decimal digits
20211
+ */
20212
+ minFractionDigits?: int;
20213
+ /**
20214
+ * defines the minimal number of non-decimal digits
20215
+ */
20216
+ minIntegerDigits?: int;
20217
+ /**
20218
+ * defines the used minus symbol
20219
+ */
20220
+ minusSign?: string;
20221
+ /**
20222
+ * @since 1.28.2 defines whether to output the string from the parse function in order to keep the precision
20223
+ * for big numbers. Numbers in scientific notation are parsed back to standard notation. For example, "5e-3"
20224
+ * is parsed to "0.005".
20225
+ */
20226
+ parseAsString?: boolean;
20227
+ /**
20228
+ * CLDR number pattern which is used to format the number
20229
+ */
20230
+ pattern?: string;
20231
+ /**
20232
+ * defines the used plus symbol
20233
+ */
20234
+ plusSign?: string;
20235
+ /**
20236
+ * defines the numerical precision; the number of decimals is calculated dependent on the integer digits
20237
+ */
20238
+ precision?: int;
20239
+ /**
20240
+ * Whether {@link #format} preserves decimal digits except trailing zeros in case there are more decimals
20241
+ * than the `maxFractionDigits` format option allows. If decimals are not preserved, the formatted number
20242
+ * is rounded to `maxFractionDigits`.
20243
+ */
20244
+ preserveDecimals?: boolean;
20245
+ /**
20246
+ * specifies the rounding behavior for discarding the digits after the maximum fraction digits defined by
20247
+ * maxFractionDigits. Rounding will only be applied if the passed value is of type `number`. This can be
20248
+ * assigned
20249
+ * - by value in {@link sap.ui.core.format.NumberFormat.RoundingMode RoundingMode},
20250
+ * - via a function that is used for rounding the number and takes two parameters: the number itself,
20251
+ * and the number of decimal digits that should be reserved.
20252
+ */
20253
+ roundingMode?: RoundingMode | keyof typeof RoundingMode;
20254
+ /**
20255
+ * defines the number of decimal in the shortened format string. If this isn't specified, the 'decimals'
20256
+ * options is used
20257
+ */
20258
+ shortDecimals?: int;
20259
+ /**
20260
+ * only use short number formatting for values above this limit
20261
+ */
20262
+ shortLimit?: int;
20263
+ /**
20264
+ * @since 1.40 specifies a number from which the scale factor for 'short' or 'long' style format is generated.
20265
+ * The generated scale factor is used for all numbers which are formatted with this format instance. This
20266
+ * option has effect only when the option 'style' is set to 'short' or 'long'. This option is by default
20267
+ * set with `undefined` which means the scale factor is selected automatically for each number being formatted.
20268
+ */
20269
+ shortRefNumber?: int;
20270
+ /**
20271
+ * @since 1.40 specifies whether the scale factor is shown in the formatted number. This option takes effect
20272
+ * only when the 'style' options is set to either 'short' or 'long'.
20273
+ */
20274
+ showScale?: boolean;
20275
+ /**
20276
+ * defines the style of format. Valid values are 'short, 'long' or 'standard' (based on the CLDR decimalFormat).
20277
+ * When set to 'short' or 'long', numbers are formatted into compact forms. When this option is set, the
20278
+ * default value of the 'precision' option is set to 2. This can be changed by setting either min/maxFractionDigits,
20279
+ * decimals, shortDecimals, or the 'precision' option itself.
20280
+ */
20281
+ style?: string;
20282
+ },
20163
20283
  /**
20164
20284
  * Locale to get the formatter for
20165
20285
  */
@@ -21191,14 +21311,14 @@ declare module "sap/ui/core/HTML" {
21191
21311
  getContent(): string;
21192
21312
  /**
21193
21313
  *
21194
- * @returns The element's DOM reference or null
21314
+ * @returns The element's DOM reference or `null`
21195
21315
  */
21196
21316
  getDomRef(
21197
21317
  /**
21198
21318
  * Suffix of the Element to be retrieved or empty
21199
21319
  */
21200
21320
  sSuffix?: string
21201
- ): Element;
21321
+ ): Element | null;
21202
21322
  /**
21203
21323
  * Gets current value of property {@link #getPreferDOM preferDOM}.
21204
21324
  *
@@ -23830,9 +23950,9 @@ declare module "sap/ui/core/Locale" {
23830
23950
  *
23831
23951
  * Use {@link #getExtensions} to get the individual extension tokens as an array.
23832
23952
  *
23833
- * @returns the extension
23953
+ * @returns the extension or `null`
23834
23954
  */
23835
- getExtension(): string;
23955
+ getExtension(): string | null;
23836
23956
  /**
23837
23957
  * Get the locale extensions as an array of tokens.
23838
23958
  *
@@ -23903,17 +24023,17 @@ declare module "sap/ui/core/Locale" {
23903
24023
  * Note that the case might differ from the original language tag (Upper case first letter and lower case
23904
24024
  * reminder enforced as recommended by BCP47/ISO15924)
23905
24025
  *
23906
- * @returns the script code or null
24026
+ * @returns the script code or `null`
23907
24027
  */
23908
- getScript(): string;
24028
+ getScript(): string | null;
23909
24029
  /**
23910
24030
  * Get the locale variants as a single string or `null`.
23911
24031
  *
23912
24032
  * Multiple variants are separated by a dash '-'.
23913
24033
  *
23914
- * @returns the variant or null
24034
+ * @returns the variant or `null`
23915
24035
  */
23916
- getVariant(): string;
24036
+ getVariant(): string | null;
23917
24037
  /**
23918
24038
  * Get the locale variants as an array of individual variants.
23919
24039
  *
@@ -25931,9 +26051,9 @@ declare module "sap/ui/core/message/MessageParser" {
25931
26051
  /**
25932
26052
  * Returns the registered processor on which the events for message handling can be fired
25933
26053
  *
25934
- * @returns The currently set MessageProcessor or null if none is set
26054
+ * @returns The currently set MessageProcessor or `null` if none is set
25935
26055
  */
25936
- getProcessor(): MessageProcessor;
26056
+ getProcessor(): MessageProcessor | null;
25937
26057
  /**
25938
26058
  * Abstract parse method must be implemented in the inheriting class.
25939
26059
  */
@@ -27884,7 +28004,7 @@ declare module "sap/ui/core/mvc/View" {
27884
28004
  * The content to remove or its index or id
27885
28005
  */
27886
28006
  vContent: int | string | Control
27887
- ): Control;
28007
+ ): Control | null;
27888
28008
  /**
27889
28009
  * Executes preprocessors for a type of source
27890
28010
  *
@@ -30708,14 +30828,16 @@ declare module "sap/ui/core/routing/History" {
30708
30828
  * get Unknown because it might be backwards or forwards. For hash replacements, the history stack will
30709
30829
  * be replaced at this position for the history.
30710
30830
  *
30711
- * @returns or undefined, if no navigation has taken place yet.
30831
+ * @returns Direction for the given hash or `undefined`, if no navigation has taken place yet.
30712
30832
  */
30713
30833
  getDirection(
30714
30834
  /**
30715
30835
  * optional, if this parameter is not passed the last hashChange is taken.
30716
30836
  */
30717
30837
  sNewHash?: string
30718
- ): routing.HistoryDirection | keyof typeof routing.HistoryDirection;
30838
+ ):
30839
+ | (routing.HistoryDirection | keyof typeof routing.HistoryDirection)
30840
+ | undefined;
30719
30841
  /**
30720
30842
  * @SINCE 1.70
30721
30843
  *
@@ -30737,12 +30859,13 @@ declare module "sap/ui/core/routing/History" {
30737
30859
  */
30738
30860
  getHistoryStateOffset(): int | undefined;
30739
30861
  /**
30740
- * gets the previous hash in the history - if the last direction was Unknown or there was no navigation
30741
- * yet, undefined will be returned
30862
+ * Gets the previous hash in the history.
30742
30863
  *
30743
- * @returns or undefined
30864
+ * If the last direction was Unknown or there was no navigation yet, `undefined` will be returned.
30865
+ *
30866
+ * @returns Previous hash in the history or `undefined`
30744
30867
  */
30745
- getPreviousHash(): string;
30868
+ getPreviousHash(): string | undefined;
30746
30869
  }
30747
30870
  }
30748
30871
 
@@ -33119,7 +33242,7 @@ declare module "sap/ui/core/routing/Targets" {
33119
33242
  * Returns a target by its name (if you pass myTarget: { view: "myView" }) in the config myTarget is the
33120
33243
  * name.
33121
33244
  *
33122
- * @returns The target with the coresponding name or undefined. If an array way passed as name this will
33245
+ * @returns The target with the coresponding name or undefined. If an array was passed as name, this will
33123
33246
  * return an array with all found targets. Non existing targets will not be returned and an error is logged
33124
33247
  * when `bSuppressNotFoundError` param isn't set to `true`.
33125
33248
  */
@@ -34799,7 +34922,7 @@ declare module "sap/ui/core/tmpl/DOMElement" {
34799
34922
  * The attribute to remove or its index or id
34800
34923
  */
34801
34924
  vAttribute: int | string | DOMAttribute
34802
- ): DOMAttribute;
34925
+ ): DOMAttribute | null;
34803
34926
  /**
34804
34927
  * Removes a element from the aggregation {@link #getElements elements}.
34805
34928
  *
@@ -34810,7 +34933,7 @@ declare module "sap/ui/core/tmpl/DOMElement" {
34810
34933
  * The element to remove or its index or id
34811
34934
  */
34812
34935
  vElement: int | string | DOMElement
34813
- ): DOMElement;
34936
+ ): DOMElement | null;
34814
34937
  /**
34815
34938
  * Sets a new value for property {@link #getTag tag}.
34816
34939
  *
@@ -36424,7 +36547,7 @@ declare module "sap/ui/core/UIArea" {
36424
36547
  * The content to remove or its index or id
36425
36548
  */
36426
36549
  vContent: int | string | Control
36427
- ): Control;
36550
+ ): Control | null;
36428
36551
  /**
36429
36552
  * Removes a dependent from the aggregation {@link #getDependents dependents}.
36430
36553
  *
@@ -36435,7 +36558,7 @@ declare module "sap/ui/core/UIArea" {
36435
36558
  * The dependent to remove or its index or id
36436
36559
  */
36437
36560
  vDependent: int | string | Control
36438
- ): Control;
36561
+ ): Control | null;
36439
36562
  /**
36440
36563
  * @deprecated (since 1.1) - use {@link #removeAllContent} and {@link #addContent} instead
36441
36564
  *
@@ -37185,7 +37308,7 @@ declare module "sap/ui/core/util/Export" {
37185
37308
  * The column to remove or its index or id
37186
37309
  */
37187
37310
  vColumn: int | string | ExportColumn
37188
- ): ExportColumn;
37311
+ ): ExportColumn | null;
37189
37312
  /**
37190
37313
  * Removes a row from the aggregation {@link #getRows rows}.
37191
37314
  *
@@ -37196,7 +37319,7 @@ declare module "sap/ui/core/util/Export" {
37196
37319
  * The row to remove or its index or id
37197
37320
  */
37198
37321
  vRow: int | string | ExportRow
37199
- ): ExportRow;
37322
+ ): ExportRow | null;
37200
37323
  /**
37201
37324
  * Generates the file content, triggers a download / save action and returns a Promise with the instance
37202
37325
  * as context (this).
@@ -37657,7 +37780,7 @@ declare module "sap/ui/core/util/ExportRow" {
37657
37780
  * The cell to remove or its index or id
37658
37781
  */
37659
37782
  vCell: int | string | ExportCell
37660
- ): ExportCell;
37783
+ ): ExportCell | null;
37661
37784
  }
37662
37785
 
37663
37786
  export interface $ExportRowSettings extends $ManagedObjectSettings {
@@ -38997,7 +39120,7 @@ declare module "sap/ui/core/VariantLayoutData" {
38997
39120
  * The multipleLayoutData to remove or its index or id
38998
39121
  */
38999
39122
  vMultipleLayoutData: int | string | LayoutData
39000
- ): LayoutData;
39123
+ ): LayoutData | null;
39001
39124
  }
39002
39125
 
39003
39126
  export interface $VariantLayoutDataSettings extends $LayoutDataSettings {
@@ -39888,7 +40011,9 @@ declare module "sap/ui/Device" {
39888
40011
  * If this flag is set to `true`, the mobile variant of the browser is used or a tablet or phone device
39889
40012
  * is detected.
39890
40013
  *
39891
- * **Note:** This information might not be available for all browsers.
40014
+ * **Note:** This information might not be available for all browsers. **Note:** The flag is also set to
40015
+ * `true` for any touch device, including laptops with touchscreen monitor. For more information, see the
40016
+ * documentation for {@link sap.ui.Device.system.combi} devices.
39892
40017
  */
39893
40018
  export const mobile: boolean;
39894
40019
 
@@ -40458,7 +40583,9 @@ declare module "sap/ui/Device" {
40458
40583
  * If this flag is set to `true`, the used browser supports touch events.
40459
40584
  *
40460
40585
  * **Note:** This flag indicates whether the used browser supports touch events or not. This does not necessarily
40461
- * mean that the used device has a touchable screen.
40586
+ * mean that the used device has a touchable screen. **Note:** This flag also affects other {@link sap.ui.Device}
40587
+ * properties. For more information, see the documentation for {@link sap.ui.Device.browser.mobile} and
40588
+ * {@link sap.ui.Device.system.combi} devices.
40462
40589
  */
40463
40590
  export const touch: boolean;
40464
40591
 
@@ -59060,7 +59187,8 @@ declare module "sap/ui/model/odata/v4/Context" {
59060
59187
  * @returns A promise which is resolved without a result in case of success, or rejected with an instance
59061
59188
  * of `Error` in case of failure, for example if the annotation belongs to the read-only namespace "@$ui5.*".
59062
59189
  * With `bRetry` it is only rejected with an `Error` instance where `oError.canceled === true` when the
59063
- * property has been reset via the methods
59190
+ * entity has been deleted while the request was pending or the property has been reset via the methods
59191
+ *
59064
59192
  * {@link sap.ui.model.odata.v4.ODataModel#resetChanges} {@link sap.ui.model.odata.v4.ODataContextBinding#resetChanges}
59065
59193
  * or {@link sap.ui.model.odata.v4.ODataListBinding#resetChanges}.
59066
59194
  */
@@ -61873,6 +62001,37 @@ declare module "sap/ui/model/odata/v4/ODataModel" {
61873
62001
  */
61874
62002
  oContext?: Context1
61875
62003
  ): Context1;
62004
+ /**
62005
+ * @SINCE 1.103.0
62006
+ *
62007
+ * Deletes the entity with the given canonical path on the server and in all bindings. Pending changes in
62008
+ * contexts for this entity or in dependents thereof are canceled.
62009
+ *
62010
+ * Deleting in the bindings is only possible if the given path is a canonical path, and all paths follow
62011
+ * these rules in addition to the OData 4.0 specification:
62012
+ * Key properties are ordered just as in the metadata, for single key properties, the name of the
62013
+ * key is omitted, for collection-valued navigation properties, all keys are present, the key-value
62014
+ * pairs are encoded via encodeURIComponent.
62015
+ *
62016
+ * @returns A promise resolving when the delete succeeded, and rejecting with an instance of Error otherwise.
62017
+ * In the latter case the HTTP status code of the response is given in the error's property `status`.
62018
+ */
62019
+ delete(
62020
+ /**
62021
+ * The canonical path of the entity to delete, starting with a '/'
62022
+ */
62023
+ sCanonicalPath: string,
62024
+ /**
62025
+ * The group ID that is used for the DELETE request; if not specified, the model's {@link #getUpdateGroupId
62026
+ * update group ID} is used; the resulting group ID must not have {@link sap.ui.model.odata.v4.SubmitMode.API}
62027
+ */
62028
+ sGroupId?: string,
62029
+ /**
62030
+ * If `true`, deletion fails if the entity does not exist (HTTP status code 404 or 412 due to the `If-Match:
62031
+ * *` header); otherwise we assume that it has already been deleted by someone else and report success
62032
+ */
62033
+ bRejectIfNotFound?: boolean
62034
+ ): Promise<any>;
61876
62035
  /**
61877
62036
  * @SINCE 1.38.0
61878
62037
  *
@@ -64099,25 +64258,6 @@ declare module "sap/ui/model/TreeBindingAdapter" {
64099
64258
  * @returns Returns the number of entries in the tree
64100
64259
  */
64101
64260
  getLength(): number;
64102
- /**
64103
- * Gets an array of nodes for the requested part of the tree.
64104
- *
64105
- * @returns The requested tree nodes
64106
- */
64107
- getNodes(
64108
- /**
64109
- * The index of the first requested node
64110
- */
64111
- iStartIndex: number,
64112
- /**
64113
- * The maximum number of returned nodes; if not given the model's size limit is used; see {@link sap.ui.model.Model#setSizeLimit}
64114
- */
64115
- iLength: number,
64116
- /**
64117
- * The maximum number of nodes to read additionally as buffer
64118
- */
64119
- iThreshold?: number
64120
- ): object[];
64121
64261
  }
64122
64262
  }
64123
64263
 
@@ -65839,6 +65979,8 @@ declare module "sap/ui/test/actions/Drag" {
65839
65979
  $ActionSettings,
65840
65980
  } from "sap/ui/test/actions/Action";
65841
65981
 
65982
+ import Control from "sap/ui/core/Control";
65983
+
65842
65984
  import ManagedObjectMetadata from "sap/ui/base/ManagedObjectMetadata";
65843
65985
 
65844
65986
  /**
@@ -65899,6 +66041,17 @@ declare module "sap/ui/test/actions/Drag" {
65899
66041
  * @returns Metadata object describing this class
65900
66042
  */
65901
66043
  static getMetadata(): ManagedObjectMetadata;
66044
+ /**
66045
+ * Starts a drag event sequence for this control. To finish the drag, and drop the control on a specified
66046
+ * target, trigger a {@link sap.ui.test.actions.Drop} action on the target. Logs an error if control is
66047
+ * not visible (i.e. has no DOM representation)
66048
+ */
66049
+ executeOn(
66050
+ /**
66051
+ * the control on which the drag events are triggered
66052
+ */
66053
+ oControl: Control
66054
+ ): void;
65902
66055
  }
65903
66056
 
65904
66057
  export interface $DragSettings extends $ActionSettings {}
@@ -65910,6 +66063,8 @@ declare module "sap/ui/test/actions/Drop" {
65910
66063
  $ActionSettings,
65911
66064
  } from "sap/ui/test/actions/Action";
65912
66065
 
66066
+ import Control from "sap/ui/core/Control";
66067
+
65913
66068
  import ManagedObjectMetadata from "sap/ui/base/ManagedObjectMetadata";
65914
66069
 
65915
66070
  import { PropertyBindingInfo } from "sap/ui/base/ManagedObject";
@@ -65986,6 +66141,17 @@ declare module "sap/ui/test/actions/Drop" {
65986
66141
  * @returns Metadata object describing this class
65987
66142
  */
65988
66143
  static getMetadata(): ManagedObjectMetadata;
66144
+ /**
66145
+ * Starts a drop event sequence for this control, such that a predefined source will be dropped on the control.
66146
+ * To start a drag sequence ad define the dragged source, trigger a {@link sap.ui.test.actions.Drag} action
66147
+ * on the source. Logs an error if control is not visible (i.e. has no DOM representation)
66148
+ */
66149
+ executeOn(
66150
+ /**
66151
+ * the control on which the drop events are triggered
66152
+ */
66153
+ oControl: Control
66154
+ ): void;
65989
66155
  /**
65990
66156
  * Gets current value of property {@link #getAfter after}.
65991
66157
  *
@@ -66140,6 +66306,18 @@ declare module "sap/ui/test/actions/EnterText" {
66140
66306
  */
66141
66307
  mSettings?: $EnterTextSettings
66142
66308
  );
66309
+ /**
66310
+ * @SINCE 1.70
66311
+ *
66312
+ * A map of ID suffixes for controls that require a special DOM reference for `EnterText` interaction.
66313
+ *
66314
+ * You can specify an ID suffix for specific controls in this map. The enter text action will be triggered
66315
+ * on the DOM element with the specified suffix.
66316
+ *
66317
+ * Here is a sublist of supported controls and their `EnterText` control adapter:
66318
+ * - sap.m.StepInput - internal Input
66319
+ */
66320
+ static controlAdapters: Record<string, string | ((p1: Control) => string)>;
66143
66321
 
66144
66322
  /**
66145
66323
  * Creates a new subclass of class sap.ui.test.actions.EnterText with name `sClassName` and enriches it
@@ -66368,6 +66546,28 @@ declare module "sap/ui/test/actions/Press" {
66368
66546
  */
66369
66547
  mSettings?: $PressSettings
66370
66548
  );
66549
+ /**
66550
+ * @SINCE 1.63
66551
+ *
66552
+ * A map of ID suffixes for controls that require a special DOM reference for `Press` interaction.
66553
+ *
66554
+ * You can specify an ID suffix for specific controls in this map. The press action will be triggered on
66555
+ * the DOM element with the specified suffix.
66556
+ *
66557
+ * Here is a sublist of supported controls and their `Press` control adapter:
66558
+ * - sap.m.ComboBox - Arrow button
66559
+ * - sap.m.SearchField - Search Button
66560
+ * - sap.m.Input - Value help
66561
+ * - sap.m.List - More Button
66562
+ * - sap.m.Table - More Button
66563
+ * - sap.m.ObjectIdentifier - Title
66564
+ * - sap.m.ObjectAttribute - Text
66565
+ * - sap.m.Page - Back Button
66566
+ * - sap.m.semantic.FullscreenPage - Back Button
66567
+ * - sap.m.semantic.DetailPage - Back Button
66568
+ * - sap.ui.comp.smartfilterbar.SmartFilterBar - Go Button
66569
+ */
66570
+ static controlAdapters: Record<string, string | ((p1: Control) => string)>;
66371
66571
 
66372
66572
  /**
66373
66573
  * Creates a new subclass of class sap.ui.test.actions.Press with name `sClassName` and enriches it with
@@ -70556,8 +70756,8 @@ declare module "sap/ui/test/OpaBuilder" {
70556
70756
  /**
70557
70757
  * Creates a matcher function that returns an aggregation element of a control at a given index.
70558
70758
  *
70559
- * @returns the matcher function returns the item at a certain index in the aggregation or null if index
70560
- * not in range
70759
+ * @returns the matcher function returns the item at a certain index in the aggregation or `undefined` if
70760
+ * index not in range
70561
70761
  */
70562
70762
  aggregationAtIndex(
70563
70763
  /**
@@ -71035,7 +71235,7 @@ declare module "sap/ui/test/OpaPlugin" {
71035
71235
  */
71036
71236
  controlType?: string | Function;
71037
71237
  }
71038
- ): UI5Element | UI5Element[];
71238
+ ): UI5Element | UI5Element[] | null;
71039
71239
  /**
71040
71240
  * Gets the constructor function of a certain controlType
71041
71241
  *
@@ -71157,14 +71357,14 @@ declare module "sap/ui/test/OpaPlugin" {
71157
71357
  * Returns the view with a specific name. The result should be a unique view. If there are multiple visible
71158
71358
  * views with that name, none will be returned.
71159
71359
  *
71160
- * @returns or undefined
71360
+ * @returns Unique view or `undefined`
71161
71361
  */
71162
71362
  getView(
71163
71363
  /**
71164
- * the name of the view
71364
+ * Name of the view
71165
71365
  */
71166
71366
  sViewName: string
71167
- ): View;
71367
+ ): View | undefined;
71168
71368
  }
71169
71369
  }
71170
71370
 
@@ -73293,7 +73493,7 @@ declare namespace sap {
73293
73493
  * that {@link sap.ui.define} uses: module names are specified without the implicit extension '.js'. Relative
73294
73494
  * module names are not supported.
73295
73495
  *
73296
- * @returns A single module export value (sync probing variant) or undefined (async loading variant)
73496
+ * @returns A single module export value (sync probing variant) or `undefined` (async loading variant)
73297
73497
  */
73298
73498
  function require(
73299
73499
  /**
@@ -74299,7 +74499,9 @@ declare namespace sap {
74299
74499
  * If this flag is set to `true`, the mobile variant of the browser is used or a tablet or phone device
74300
74500
  * is detected.
74301
74501
  *
74302
- * **Note:** This information might not be available for all browsers.
74502
+ * **Note:** This information might not be available for all browsers. **Note:** The flag is also set to
74503
+ * `true` for any touch device, including laptops with touchscreen monitor. For more information, see the
74504
+ * documentation for {@link sap.ui.Device.system.combi} devices.
74303
74505
  */
74304
74506
  export const mobile: boolean;
74305
74507
 
@@ -74922,7 +75124,9 @@ declare namespace sap {
74922
75124
  * If this flag is set to `true`, the used browser supports touch events.
74923
75125
  *
74924
75126
  * **Note:** This flag indicates whether the used browser supports touch events or not. This does not necessarily
74925
- * mean that the used device has a touchable screen.
75127
+ * mean that the used device has a touchable screen. **Note:** This flag also affects other {@link sap.ui.Device}
75128
+ * properties. For more information, see the documentation for {@link sap.ui.Device.browser.mobile} and
75129
+ * {@link sap.ui.Device.system.combi} devices.
74926
75130
  */
74927
75131
  export const touch: boolean;
74928
75132
 
@@ -75123,6 +75327,8 @@ declare namespace sap {
75123
75327
 
75124
75328
  "sap/ui/base/ObjectPool": undefined;
75125
75329
 
75330
+ "sap/ui/base/SyncPromise": undefined;
75331
+
75126
75332
  "sap/ui/core/AppCacheBuster": undefined;
75127
75333
 
75128
75334
  "sap/ui/core/BusyIndicator": undefined;