@sapui5/ts-types 1.149.1 → 1.150.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.
Files changed (67) hide show
  1. package/package.json +1 -1
  2. package/types/index.d.ts +7 -7
  3. package/types/sap.apf.d.ts +1 -1
  4. package/types/sap.ca.ui.d.ts +1 -1
  5. package/types/sap.chart.d.ts +1 -1
  6. package/types/sap.collaboration.d.ts +1 -1
  7. package/types/sap.esh.search.ui.d.ts +165 -223
  8. package/types/sap.f.d.ts +57 -5
  9. package/types/sap.fe.ariba.d.ts +1 -1
  10. package/types/sap.fe.base.d.ts +1 -1
  11. package/types/sap.fe.controls.d.ts +1 -1
  12. package/types/sap.fe.core.d.ts +35 -15
  13. package/types/sap.fe.ina.d.ts +1 -1
  14. package/types/sap.fe.macros.d.ts +93 -43
  15. package/types/sap.fe.navigation.d.ts +1 -1
  16. package/types/sap.fe.placeholder.d.ts +1 -1
  17. package/types/sap.fe.plugins.managecache.d.ts +1 -1
  18. package/types/sap.fe.templates.d.ts +1 -1
  19. package/types/sap.fe.test.d.ts +140 -30
  20. package/types/sap.fe.tools.d.ts +1 -1
  21. package/types/sap.feedback.ui.d.ts +1 -1
  22. package/types/sap.gantt.d.ts +141 -137
  23. package/types/sap.insights.d.ts +1 -1
  24. package/types/{mobile-1.149.0-d.ts → sap.m.d.ts} +251 -27
  25. package/types/sap.makit.d.ts +1 -1
  26. package/types/sap.me.d.ts +1 -1
  27. package/types/sap.ndc.d.ts +1 -1
  28. package/types/sap.ovp.d.ts +1 -1
  29. package/types/sap.rules.ui.d.ts +1 -1
  30. package/types/sap.sac.df.d.ts +1 -1
  31. package/types/sap.suite.ui.commons.d.ts +132 -59
  32. package/types/sap.suite.ui.generic.template.d.ts +1 -1
  33. package/types/sap.suite.ui.microchart.d.ts +4 -3
  34. package/types/sap.tnt.d.ts +1 -1
  35. package/types/sap.ui.codeeditor.d.ts +1 -1
  36. package/types/{commons-1.149.0-d.ts → sap.ui.commons.d.ts} +4 -3
  37. package/types/sap.ui.comp.d.ts +37 -25
  38. package/types/{core-1.149.0-d.ts → sap.ui.core.d.ts} +753 -466
  39. package/types/{dt-1.149.0-d.ts → sap.ui.dt.d.ts} +1 -1
  40. package/types/sap.ui.export.d.ts +1 -1
  41. package/types/sap.ui.fl.d.ts +1 -1
  42. package/types/sap.ui.generic.app.d.ts +16 -11
  43. package/types/sap.ui.generic.template.d.ts +1 -1
  44. package/types/sap.ui.geomap.d.ts +111 -209
  45. package/types/sap.ui.integration.d.ts +1 -1
  46. package/types/sap.ui.layout.d.ts +7 -5
  47. package/types/{mdc-1.149.0-d.ts → sap.ui.mdc.d.ts} +78 -9
  48. package/types/sap.ui.richtexteditor.d.ts +1 -1
  49. package/types/{rta-1.149.0-d.ts → sap.ui.rta.d.ts} +1 -1
  50. package/types/sap.ui.suite.d.ts +1 -1
  51. package/types/sap.ui.support.d.ts +3 -1
  52. package/types/sap.ui.table.d.ts +10 -7
  53. package/types/sap.ui.testrecorder.d.ts +1 -1
  54. package/types/sap.ui.unified.d.ts +72 -3
  55. package/types/{ux3-1.149.0-d.ts → sap.ui.ux3.d.ts} +1 -1
  56. package/types/sap.ui.vbm.d.ts +1 -1
  57. package/types/sap.ui.vk.d.ts +1 -1
  58. package/types/sap.ui.vtm.d.ts +1 -1
  59. package/types/sap.uiext.inbox.d.ts +1 -1
  60. package/types/sap.ushell.d.ts +1 -3
  61. package/types/sap.ushell_abap.d.ts +1 -1
  62. package/types/sap.uxap.d.ts +1 -1
  63. package/types/sap.viz.d.ts +58 -39
  64. package/types/sap.webanalytics.core.d.ts +1 -1
  65. package/types/sap.zen.commons.d.ts +39 -25
  66. package/types/sap.zen.crosstab.d.ts +15 -8
  67. package/types/sap.zen.dsh.d.ts +17 -9
@@ -279,7 +279,7 @@ declare namespace sap {
279
279
  "sap/ui/thirdparty/qunit-2": undefined;
280
280
  }
281
281
  }
282
- // For Library Version: 1.149.0
282
+ // For Library Version: 1.150.0
283
283
 
284
284
  declare module "sap/base/assert" {
285
285
  /**
@@ -12380,10 +12380,10 @@ declare namespace sap {
12380
12380
  * the event handler is done.
12381
12381
  */
12382
12382
  class Event<
12383
- ParamsType extends Record<string, any> = object,
12384
- SourceType extends
12385
- sap.ui.base.EventProvider = sap.ui.base.EventProvider,
12386
- >
12383
+ ParamsType extends Record<string, any> = object,
12384
+ SourceType extends sap.ui.base.EventProvider =
12385
+ sap.ui.base.EventProvider,
12386
+ >
12387
12387
  extends sap.ui.base.Object
12388
12388
  implements sap.ui.base.Poolable
12389
12389
  {
@@ -18802,11 +18802,117 @@ declare namespace sap {
18802
18802
  */
18803
18803
  TOWARDS_ZERO = "TOWARDS_ZERO",
18804
18804
  }
18805
+ /**
18806
+ * The format options for currencies.
18807
+ */
18808
+ type CurrencyFormatOptions =
18809
+ sap.ui.core.format.NumberFormat.FormatOptions & {
18810
+ /**
18811
+ * Defines whether the currency is shown as a code in currency format. The currency symbol is displayed
18812
+ * when this option is set to `false` and a symbol has been defined for the given currency code.
18813
+ */
18814
+ currencyCode?: boolean;
18815
+ /**
18816
+ * Can be set either to 'standard' (the default value) or to 'accounting' for an accounting-specific currency
18817
+ * display
18818
+ */
18819
+ currencyContext?:
18820
+ | "standard"
18821
+ | "accounting"
18822
+ | "sap-standard"
18823
+ | "sap-accounting";
18824
+ /**
18825
+ * Defines a set of custom currencies exclusive to this NumberFormat instance. Custom currencies must not
18826
+ * only consist of digits. If custom currencies are defined on the instance, no other currencies can be
18827
+ * formatted and parsed by this instance. Globally available custom currencies can be added via the global
18828
+ * configuration. See the above examples. See also {@link module:sap/base/i18n/Formatting.setCustomCurrencies Formatting.setCustomCurrencies }
18829
+ * and {@link module:sap/base/i18n/Formatting.addCustomCurrencies Formatting.addCustomCurrencies}.
18830
+ */
18831
+ customCurrencies?: Record<string, object>;
18832
+ /**
18833
+ * The number of decimal digits.
18834
+ */
18835
+ decimals?: int;
18836
+ /**
18837
+ * The target length of places after the decimal separator; if the number has fewer decimals than specified
18838
+ * in this option, it is padded with whitespaces at the end up to the target length. An additional whitespace
18839
+ * character for the decimal separator is added for a number without any decimals. **Note:** This format
18840
+ * option is only allowed if the following conditions apply:
18841
+ * - It has a value greater than 0.
18842
+ * - The `oFormatOptions.style` format option is **not** set to `"short"` or `"long"`.
18843
+ */
18844
+ decimalPadding?: int;
18845
+ /**
18846
+ * Since 1.130.0. Defines what value an empty string is parsed into and what value is formatted as an empty
18847
+ * string. The {@link #format} and {@link #parse} functions are done in a symmetric way. For example, when
18848
+ * this parameter is set to `NaN`, an empty string is parsed as `NaN`, and `NaN` is formatted as an empty
18849
+ * string.
18850
+ */
18851
+ emptyString?: null | number | string;
18852
+ /**
18853
+ * Deprecated as of 1.130; this format option does not have an effect on currency formats since decimals
18854
+ * can always be determined, either through the given format options, custom currencies or the CLDR
18855
+ */
18856
+ minFractionDigits?: int;
18857
+ /**
18858
+ * Since 1.28.2, whether to parse the number as a string in order to keep the precision for big numbers.
18859
+ * Numbers in scientific notation are parsed back to standard notation. For example, `5e-3` is parsed to
18860
+ * `0.005`.
18861
+ */
18862
+ parseAsString?: boolean;
18863
+ /**
18864
+ * The maximum number of digits in the formatted representation of a number; if the `precision` is less
18865
+ * than the overall length of the number, its fractional part is truncated through rounding. As the `precision`
18866
+ * only affects the rounding of a number, its integer part can retain more digits than defined by this parameter.
18867
+ * **Example:** With a `precision` of 2, `234.567` is formatted to `235`. **Note:** The formatted output
18868
+ * may differ depending on locale.
18869
+ */
18870
+ precision?: int;
18871
+ /**
18872
+ * Whether {@link #format} preserves decimal digits (except trailing zeros) when there are more decimals
18873
+ * than the `maxFractionDigits` format option allows. When decimals aren't preserved, the formatted number
18874
+ * is rounded to `maxFractionDigits`.
18875
+ */
18876
+ preserveDecimals?: boolean;
18877
+ /**
18878
+ * Defines whether the currency code/symbol is shown in the formatted string, e.g. true: "1.00 EUR", false:
18879
+ * "1.00" for locale "en" If both `showMeasure` and `showNumber` are false, an empty string is returned
18880
+ */
18881
+ showMeasure?: boolean;
18882
+ /**
18883
+ * Defines whether the number is shown as part of the result string, e.g. 1 EUR for locale "en"
18884
+ * ```javascript
18885
+ * `NumberFormat.getCurrencyInstance({showNumber: true}).format(1, "EUR"); // "1.00 EUR"````
18886
+ *
18887
+ * ```javascript
18888
+ * `NumberFormat.getCurrencyInstance({showNumber: false}).format(1, "EUR"); // "EUR"````
18889
+ * If both `showMeasure` and `showNumber` are false, an empty string is returned
18890
+ */
18891
+ showNumber?: boolean;
18892
+ /**
18893
+ * The style of format. Valid values are based on the CLDR `decimalFormat`. When set to `short` or `long`,
18894
+ * numbers are formatted into compact forms. When this option is set, the default value of the `precision`
18895
+ * option is set to `2`. This can be changed by setting either `min/maxFractionDigits`, `decimals`, `shortDecimals`,
18896
+ * or the `precision` option itself.
18897
+ */
18898
+ style?: "short" | "long" | "standard";
18899
+ /**
18900
+ * Overrides the global configuration value {@link module:sap/base/i18n/Formatting.getTrailingCurrencyCode Formatting.getTrailingCurrencyCode},
18901
+ * which has a default value of `true`. This is ignored if `oFormatOptions.currencyCode` is set to `false`,
18902
+ * or if `oFormatOptions.pattern` is supplied.
18903
+ */
18904
+ trailingCurrencyCode?: boolean;
18905
+ };
18906
+
18805
18907
  /**
18806
18908
  * The format options for floating-point numbers.
18807
18909
  */
18808
18910
  type FloatFormatOptions =
18809
18911
  sap.ui.core.format.NumberFormat.FormatOptions & {
18912
+ /**
18913
+ * The number of decimal digits.
18914
+ */
18915
+ decimals?: int;
18810
18916
  /**
18811
18917
  * The target length of places after the decimal separator; if the number has fewer decimal places than
18812
18918
  * given in this option, it is padded with whitespaces at the end up to the target length. An additional
@@ -18816,10 +18922,23 @@ declare namespace sap {
18816
18922
  * - The `oFormatOptions.style` format option is **not** set to `"short"` or `"long"`.
18817
18923
  */
18818
18924
  decimalPadding?: int;
18925
+ /**
18926
+ * Since 1.130.0. Defines what value an empty string is parsed into and what value is formatted as an empty
18927
+ * string. The {@link #format} and {@link #parse} functions are done in a symmetric way. For example, when
18928
+ * this parameter is set to `NaN`, an empty string is parsed as `NaN`, and `NaN` is formatted as an empty
18929
+ * string.
18930
+ */
18931
+ emptyString?: null | number | string;
18819
18932
  /**
18820
18933
  * The minimal number of decimal digits.
18821
18934
  */
18822
18935
  minFractionDigits?: int;
18936
+ /**
18937
+ * Since 1.28.2, whether to parse the number as a string in order to keep the precision for big numbers.
18938
+ * Numbers in scientific notation are parsed back to standard notation. For example, `5e-3` is parsed to
18939
+ * `0.005`.
18940
+ */
18941
+ parseAsString?: boolean;
18823
18942
  /**
18824
18943
  * The maximum number of digits in the formatted representation of a number; if the `precision` is less
18825
18944
  * than the overall length of the number, its fractional part is truncated through rounding. As the `precision`
@@ -18828,6 +18947,12 @@ declare namespace sap {
18828
18947
  * may differ depending on locale.
18829
18948
  */
18830
18949
  precision?: int;
18950
+ /**
18951
+ * Whether {@link #format} preserves decimal digits (except trailing zeros) when there are more decimals
18952
+ * than the `maxFractionDigits` format option allows. When decimals aren't preserved, the formatted number
18953
+ * is rounded to `maxFractionDigits`.
18954
+ */
18955
+ preserveDecimals?: boolean;
18831
18956
  /**
18832
18957
  * The style of format. Valid values are based on the CLDR `decimalFormat`. When set to `short` or `long`,
18833
18958
  * numbers are formatted into compact forms. When this option is set, the default value of the `precision`
@@ -18841,22 +18966,11 @@ declare namespace sap {
18841
18966
  * The base type for the numeric format options.
18842
18967
  */
18843
18968
  type FormatOptions = {
18844
- /**
18845
- * The number of decimal digits.
18846
- */
18847
- decimals?: int;
18848
18969
  /**
18849
18970
  * The character used as decimal separator. If none is given, the locale-specific decimal separator is used.
18850
18971
  * **Note:** `decimalSeparator` must always be different from `groupingSeparator`.
18851
18972
  */
18852
18973
  decimalSeparator?: string;
18853
- /**
18854
- * Since 1.130.0. Defines what value an empty string is parsed into and what value is formatted as an empty
18855
- * string. The {@link #format} and {@link #parse} functions are done in a symmetric way. For example, when
18856
- * this parameter is set to `NaN`, an empty string is parsed as `NaN`, and `NaN` is formatted as an empty
18857
- * string.
18858
- */
18859
- emptyString?: null | number | string;
18860
18974
  /**
18861
18975
  * The grouping base size in digits if it is different from the grouping size (e.g. Indian grouping).
18862
18976
  */
@@ -18892,12 +19006,6 @@ declare namespace sap {
18892
19006
  * The symbol for the minus sign. If none is given, the locale-specific minus sign is used.
18893
19007
  */
18894
19008
  minusSign?: string;
18895
- /**
18896
- * Since 1.28.2, whether to parse the number as a string in order to keep the precision for big numbers.
18897
- * Numbers in scientific notation are parsed back to standard notation. For example, `5e-3` is parsed to
18898
- * `0.005`.
18899
- */
18900
- parseAsString?: boolean;
18901
19009
  /**
18902
19010
  * The CLDR number pattern which is used to format a number. If none is given, the default pattern for the
18903
19011
  * locale and type is used.
@@ -18907,12 +19015,6 @@ declare namespace sap {
18907
19015
  * The symbol for the plus sign. If none is given, the locale-specific plus sign is used.
18908
19016
  */
18909
19017
  plusSign?: string;
18910
- /**
18911
- * Whether {@link #format} preserves decimal digits except trailing zeros if there are more decimals than
18912
- * the `maxFractionDigits` format option allows. If decimals are not preserved, the formatted number is
18913
- * rounded to `maxFractionDigits`.
18914
- */
18915
- preserveDecimals?: boolean;
18916
19018
  /**
18917
19019
  * Defines how numbers are rounded when the number of fraction digits exceeds the value of `maxFractionDigits`.
18918
19020
  * The rounding behavior of the formatter can be defined in the following ways:
@@ -18959,6 +19061,17 @@ declare namespace sap {
18959
19061
  */
18960
19062
  type IntegerFormatOptions =
18961
19063
  sap.ui.core.format.NumberFormat.FormatOptions & {
19064
+ /**
19065
+ * The number of decimal digits.
19066
+ */
19067
+ decimals?: int;
19068
+ /**
19069
+ * Since 1.130.0. Defines what value an empty string is parsed into and what value is formatted as an empty
19070
+ * string. The {@link #format} and {@link #parse} functions are done in a symmetric way. For example, when
19071
+ * this parameter is set to `NaN`, an empty string is parsed as `NaN`, and `NaN` is formatted as an empty
19072
+ * string.
19073
+ */
19074
+ emptyString?: null | number | string;
18962
19075
  /**
18963
19076
  * The minimal number of decimal digits.
18964
19077
  */
@@ -18972,6 +19085,121 @@ declare namespace sap {
18972
19085
  * `234567` is formatted to `"235K"`.
18973
19086
  */
18974
19087
  precision?: int;
19088
+ /**
19089
+ * Since 1.28.2, whether to parse the number as a string in order to keep the precision for big numbers.
19090
+ * Numbers in scientific notation are parsed back to standard notation. For example, `5e-3` is parsed to
19091
+ * `0.005`.
19092
+ */
19093
+ parseAsString?: boolean;
19094
+ /**
19095
+ * Whether {@link #format} preserves decimal digits (except trailing zeros) when there are more decimals
19096
+ * than the `maxFractionDigits` format option allows. When decimals aren't preserved, the formatted number
19097
+ * is rounded to `maxFractionDigits`.
19098
+ */
19099
+ preserveDecimals?: boolean;
19100
+ /**
19101
+ * The style of format. Valid values are based on the CLDR `decimalFormat`. When set to `short` or `long`,
19102
+ * numbers are formatted into compact forms. When this option is set, the default value of the `precision`
19103
+ * option is set to `2`. This can be changed by setting either `min/maxFractionDigits`, `decimals`, `shortDecimals`,
19104
+ * or the `precision` option itself.
19105
+ */
19106
+ style?: "short" | "long" | "standard";
19107
+ };
19108
+
19109
+ /**
19110
+ * The format options for units.
19111
+ */
19112
+ type UnitFormatOptions =
19113
+ sap.ui.core.format.NumberFormat.FormatOptions & {
19114
+ /**
19115
+ * Defines the allowed units for formatting and parsing, for example `["size-meter", "volume-liter", ...]`
19116
+ * If this option is not specified, all units are allowed.
19117
+ */
19118
+ allowedUnits?: string[];
19119
+ /**
19120
+ * Defines a set of custom units, for example:
19121
+ * ```javascript
19122
+ * {"electric-inductance": {
19123
+ * "displayName": "henry",
19124
+ * "unitPattern-count-one": "{0} H",
19125
+ * "unitPattern-count-other": "{0} H",
19126
+ * "perUnitPattern": "{0}/H",
19127
+ * "decimals": 2,
19128
+ * "precision": 4
19129
+ * }
19130
+ * }```
19131
+ */
19132
+ customUnits?: Record<string, object>;
19133
+ /**
19134
+ * The number of decimal digits.
19135
+ */
19136
+ decimals?: int;
19137
+ /**
19138
+ * The target length of places after the decimal separator; if the number has fewer decimals than specified
19139
+ * in this option, it is padded with whitespaces at the end up to the target length. An additional whitespace
19140
+ * character for the decimal separator is added for a number without any decimals. **Note:** This format
19141
+ * option is only allowed if the following conditions apply:
19142
+ * - It has a value greater than 0.
19143
+ * - The `oFormatOptions.style` format option is **not** set to `"short"` or `"long"`.
19144
+ */
19145
+ decimalPadding?: int;
19146
+ /**
19147
+ * Since 1.130.0. Defines what value an empty string is parsed into and what value is formatted as an empty
19148
+ * string. The {@link #format} and {@link #parse} functions are done in a symmetric way. For example, when
19149
+ * this parameter is set to `NaN`, an empty string is parsed as `NaN`, and `NaN` is formatted as an empty
19150
+ * string.
19151
+ */
19152
+ emptyString?: null | number | string;
19153
+ /**
19154
+ * The minimal number of decimal digits.
19155
+ */
19156
+ minFractionDigits?: int;
19157
+ /**
19158
+ * Since 1.28.2, whether to parse the number as a string in order to keep the precision for big numbers.
19159
+ * Numbers in scientific notation are parsed back to standard notation. For example, `5e-3` is parsed to
19160
+ * `0.005`.
19161
+ */
19162
+ parseAsString?: boolean;
19163
+ /**
19164
+ * The maximum number of digits in the formatted representation of a number; if the `precision` is less
19165
+ * than the overall length of the number, its fractional part is truncated through rounding. As the `precision`
19166
+ * only affects the rounding of a number, its integer part can retain more digits than defined by this parameter.
19167
+ * **Example:** With a `precision` of 2, `234.567` is formatted to `235`. **Note:** The formatted output
19168
+ * may differ depending on locale.
19169
+ */
19170
+ precision?: int;
19171
+ /**
19172
+ * Whether {@link #format} preserves decimal digits (except trailing zeros) when there are more decimals
19173
+ * than the `maxFractionDigits` format option allows. When decimals aren't preserved, the formatted number
19174
+ * is rounded to `maxFractionDigits`.
19175
+ */
19176
+ preserveDecimals?: boolean;
19177
+ /**
19178
+ * Defines whether the unit of measure is shown in the formatted string, for example 1 day for locale "en"
19179
+ *
19180
+ * ```javascript
19181
+ * NumberFormat.getUnitInstance({showMeasure: true})
19182
+ * .format(1, "duration-day"); // "1 day"```
19183
+ *
19184
+ * ```javascript
19185
+ * NumberFormat.getUnitInstance({showMeasure: false})
19186
+ * .format(1, "duration-day"); // "1"```
19187
+ * If both `showMeasure` and `showNumber` are set to false, an empty string is returned.
19188
+ */
19189
+ showMeasure?: boolean;
19190
+ /**
19191
+ * Defines whether the number is shown as part of the formatted string, for example 1 day for locale "en"
19192
+ *
19193
+ * ```javascript
19194
+ * NumberFormat.getUnitInstance({showNumber: true})
19195
+ * .format(1, "duration-day"); // "1 day"```
19196
+ *
19197
+ * ```javascript
19198
+ * NumberFormat.getUnitInstance({showNumber: false})
19199
+ * .format(1, "duration-day"); // "day"```
19200
+ * If both `showMeasure` and `showNumber` are false, an empty string is returned
19201
+ */
19202
+ showNumber?: boolean;
18975
19203
  /**
18976
19204
  * The style of format. Valid values are based on the CLDR `decimalFormat`. When set to `short` or `long`,
18977
19205
  * numbers are formatted into compact forms. When this option is set, the default value of the `precision`
@@ -19776,172 +20004,7 @@ declare namespace sap {
19776
20004
  * The option object, which supports the following parameters. If no options are given, default values according
19777
20005
  * to the type and locale settings are used.
19778
20006
  */
19779
- oFormatOptions?: {
19780
- /**
19781
- * defines whether the currency is shown as a code in currency format. The currency symbol is displayed
19782
- * when this option is set to `false` and a symbol has been defined for the given currency code.
19783
- */
19784
- currencyCode?: boolean;
19785
- /**
19786
- * can be set either to 'standard' (the default value) or to 'accounting' for an accounting-specific currency
19787
- * display
19788
- */
19789
- currencyContext?: string;
19790
- /**
19791
- * defines a set of custom currencies exclusive to this NumberFormat instance. Custom currencies must not
19792
- * only consist of digits. If custom currencies are defined on the instance, no other currencies can be
19793
- * formatted and parsed by this instance. Globally available custom currencies can be added via the global
19794
- * configuration. See the above examples. See also {@link module:sap/base/i18n/Formatting.setCustomCurrencies Formatting.setCustomCurrencies }
19795
- * and {@link module:sap/base/i18n/Formatting.addCustomCurrencies Formatting.addCustomCurrencies}.
19796
- */
19797
- customCurrencies?: Record<string, object>;
19798
- /**
19799
- * The target length of places after the decimal separator; if the number has fewer decimal places than
19800
- * given in this option, it is padded with whitespaces at the end up to the target length. An additional
19801
- * whitespace character for the decimal separator is added for a number without any decimals. **Note:**
19802
- * This format option is only allowed if the following conditions apply:
19803
- * - It has a value greater than 0.
19804
- * - The `FormatOptions.showMeasure` format option is set to `false`.
19805
- * - The `oFormatOptions.style` format option is **not** set to `"short"` or `"long"`.
19806
- */
19807
- decimalPadding?: int;
19808
- /**
19809
- * defines the number of decimal digits
19810
- */
19811
- decimals?: int;
19812
- /**
19813
- * defines the character used as decimal separator. Note: `decimalSeparator` must always be different from
19814
- * `groupingSeparator`.
19815
- */
19816
- decimalSeparator?: string;
19817
- /**
19818
- * since 1.30.0 defines what an empty string is parsed as, and what is formatted as an empty string. The
19819
- * allowed values are "" (empty string), NaN, `null`, or 0. The 'format' and 'parse' functions are done
19820
- * in a symmetric way. For example, when this parameter is set to NaN, an empty string is parsed as [NaN,
19821
- * undefined], and NaN is formatted as an empty string.
19822
- */
19823
- emptyString?: null | number | string;
19824
- /**
19825
- * defines the grouping base size in digits if it is different from the grouping size (e.g. Indian grouping)
19826
- */
19827
- groupingBaseSize?: int;
19828
- /**
19829
- * defines whether grouping is enabled (grouping separators are shown). **Note:** Grouping is disabled if
19830
- * the `groupingSize` format option is set to a non-positive value.
19831
- */
19832
- groupingEnabled?: boolean;
19833
- /**
19834
- * defines the character used as grouping separator. Note: `groupingSeparator` must always be different
19835
- * from `decimalSeparator`.
19836
- */
19837
- groupingSeparator?: string;
19838
- /**
19839
- * defines the grouping size in digits; the default is `3`. **Note:** If this format option is set to a
19840
- * non-positive value, grouping will be disabled entirely.
19841
- */
19842
- groupingSize?: int;
19843
- /**
19844
- * defines the maximum number of decimal digits
19845
- */
19846
- maxFractionDigits?: int;
19847
- /**
19848
- * defines the maximum number of non-decimal digits. If the number exceeds this maximum, e.g. 1e+120, "?"
19849
- * characters are shown instead of digits.
19850
- */
19851
- maxIntegerDigits?: int;
19852
- /**
19853
- * Deprecated as of 1.130; this format option does not have an effect on currency formats since decimals
19854
- * can always be determined, either through the given format options, custom currencies or the CLDR
19855
- */
19856
- minFractionDigits?: int;
19857
- /**
19858
- * defines the minimal number of non-decimal digits
19859
- */
19860
- minIntegerDigits?: int;
19861
- /**
19862
- * defines the used minus symbol
19863
- */
19864
- minusSign?: string;
19865
- /**
19866
- * since 1.28.2 defines whether to output the string from the parse function in order to keep the precision
19867
- * for big numbers. Numbers in scientific notation are parsed back to standard notation. For example, "5e-3"
19868
- * is parsed to "0.005".
19869
- */
19870
- parseAsString?: boolean;
19871
- /**
19872
- * CLDR number pattern which is used to format the number
19873
- */
19874
- pattern?: string;
19875
- /**
19876
- * defines the used plus symbol
19877
- */
19878
- plusSign?: string;
19879
- /**
19880
- * Whether {@link #format} preserves decimal digits except trailing zeros in case there are more decimals
19881
- * than the `maxFractionDigits` format option allows. If decimals are not preserved, the formatted number
19882
- * is rounded to `maxFractionDigits`.
19883
- */
19884
- preserveDecimals?: boolean;
19885
- /**
19886
- * Specifies the rounding behavior for discarding the digits after the maximum fraction digits defined by
19887
- * `maxFractionDigits`. This can be assigned
19888
- * - by value in {@link sap.ui.core.format.NumberFormat.RoundingMode RoundingMode},
19889
- * - via a function that is used for rounding the number and takes two parameters: the number itself,
19890
- * and the number of decimal digits that should be reserved. **Using a function is deprecated since 1.121.0**;
19891
- * string based numbers are not rounded via this custom function.
19892
- */
19893
- roundingMode?: sap.ui.core.format.NumberFormat.RoundingMode;
19894
- /**
19895
- * defines the number of decimal in the shortened format string. If this isn't specified, the 'decimals'
19896
- * options is used
19897
- */
19898
- shortDecimals?: int;
19899
- /**
19900
- * only use short number formatting for values above this limit
19901
- */
19902
- shortLimit?: int;
19903
- /**
19904
- * since 1.40 specifies a number from which the scale factor for 'short' or 'long' style format is generated.
19905
- * The generated scale factor is used for all numbers which are formatted with this format instance. This
19906
- * option has effect only when the option 'style' is set to 'short' or 'long'. This option is by default
19907
- * set with `undefined` which means the scale factor is selected automatically for each number being formatted.
19908
- */
19909
- shortRefNumber?: int;
19910
- /**
19911
- * defines whether the currency code/symbol is shown in the formatted string, e.g. true: "1.00 EUR", false:
19912
- * "1.00" for locale "en" If both `showMeasure` and `showNumber` are false, an empty string is returned
19913
- */
19914
- showMeasure?: boolean;
19915
- /**
19916
- * defines whether the number is shown as part of the result string, e.g. 1 EUR for locale "en" `NumberFormat.getCurrencyInstance({showNumber:true}).format(1,
19917
- * "EUR"); // "1.00 EUR"` `NumberFormat.getCurrencyInstance({showNumber:false}).format(1, "EUR"); // "EUR"`
19918
- * If both `showMeasure` and `showNumber` are false, an empty string is returned
19919
- */
19920
- showNumber?: boolean;
19921
- /**
19922
- * since 1.40 specifies whether the scale factor is shown in the formatted number. This option takes effect
19923
- * only when the 'style' options is set to either 'short' or 'long'.
19924
- */
19925
- showScale?: boolean;
19926
- /**
19927
- * whether the positions of grouping separators are validated. Space characters used as grouping separators
19928
- * are not validated.
19929
- */
19930
- strictGroupingValidation?: boolean;
19931
- /**
19932
- * defines the style of format. Valid values are 'short, 'long' or 'standard' (based on the CLDR decimalFormat).
19933
- * When set to 'short' or 'long', numbers are formatted into the 'short' form only. When this option is
19934
- * set, the default value of the 'precision' option is set to 2. This can be changed by setting either min/maxFractionDigits,
19935
- * decimals, shortDecimals, or the 'precision' option itself.
19936
- */
19937
- style?: string;
19938
- /**
19939
- * overrides the global configuration value {@link module:sap/base/i18n/Formatting.getTrailingCurrencyCode Formatting.getTrailingCurrencyCode},
19940
- * which has a default value of `true</>. This is ignored if oFormatOptions.currencyCode` is set to
19941
- * `false`, or if `oFormatOptions.pattern` is supplied.
19942
- */
19943
- trailingCurrencyCode?: boolean;
19944
- },
20007
+ oFormatOptions?: sap.ui.core.format.NumberFormat.CurrencyFormatOptions,
19945
20008
  /**
19946
20009
  * The locale to get the formatter for; if no locale is given, a locale for the currently configured language
19947
20010
  * is used; see {@link module:sap/base/i18n/Formatting.getLanguageTag Formatting.getLanguageTag}
@@ -20194,167 +20257,7 @@ declare namespace sap {
20194
20257
  * The option object, which supports the following parameters. If no options are given, default values according
20195
20258
  * to the type and locale settings are used.
20196
20259
  */
20197
- oFormatOptions?: {
20198
- /**
20199
- * defines the allowed units for formatting and parsing, e.g. ["size-meter", "volume-liter", ...]
20200
- */
20201
- allowedUnits?: any[];
20202
- /**
20203
- * defines a set of custom units, e.g. {"electric-inductance": { "displayName": "henry", "unitPattern-count-one":
20204
- * "{0} H", "unitPattern-count-other": "{0} H", "perUnitPattern": "{0}/H", "decimals": 2, "precision": 4
20205
- * }}
20206
- */
20207
- customUnits?: Record<string, object>;
20208
- /**
20209
- * The target length of places after the decimal separator; if the number has fewer decimal places than
20210
- * given in this option, it is padded with whitespaces at the end up to the target length. An additional
20211
- * whitespace character for the decimal separator is added for a number without any decimals. **Note:**
20212
- * This format option is only allowed if the following conditions apply:
20213
- * - It has a value greater than 0.
20214
- * - The `FormatOptions.showMeasure` format option is set to `false`.
20215
- * - The `oFormatOptions.style` format option is **not** set to `"short"` or `"long"`.
20216
- */
20217
- decimalPadding?: int;
20218
- /**
20219
- * defines the number of decimal digits
20220
- */
20221
- decimals?: int;
20222
- /**
20223
- * defines the character used as decimal separator. Note: `decimalSeparator` must always be different from
20224
- * `groupingSeparator`.
20225
- */
20226
- decimalSeparator?: string;
20227
- /**
20228
- * since 1.30.0 defines what an empty string is parsed as, and what is formatted as an empty string. The
20229
- * allowed values are "" (empty string), NaN, `null`, or 0. The 'format' and 'parse' functions are done
20230
- * in a symmetric way. For example, when this parameter is set to NaN, an empty string is parsed as [NaN,
20231
- * undefined], and NaN is formatted as an empty string.
20232
- */
20233
- emptyString?: null | number | string;
20234
- /**
20235
- * defines the grouping base size in digits if it is different from the grouping size (e.g. Indian grouping)
20236
- */
20237
- groupingBaseSize?: int;
20238
- /**
20239
- * defines whether grouping is enabled (grouping separators are shown). **Note:** Grouping is disabled if
20240
- * the `groupingSize` format option is set to a non-positive value.
20241
- */
20242
- groupingEnabled?: boolean;
20243
- /**
20244
- * defines the character used as grouping separator. Note: `groupingSeparator` must always be different
20245
- * from `decimalSeparator`.
20246
- */
20247
- groupingSeparator?: string;
20248
- /**
20249
- * defines the grouping size in digits; the default is `3`. **Note:** If this format option is set to a
20250
- * non-positive value, grouping will be disabled entirely.
20251
- */
20252
- groupingSize?: int;
20253
- /**
20254
- * defines the maximum number of decimal digits
20255
- */
20256
- maxFractionDigits?: int;
20257
- /**
20258
- * defines the maximum number of non-decimal digits. If the number exceeds this maximum, e.g. 1e+120, "?"
20259
- * characters are shown instead of digits.
20260
- */
20261
- maxIntegerDigits?: int;
20262
- /**
20263
- * defines the minimal number of decimal digits
20264
- */
20265
- minFractionDigits?: int;
20266
- /**
20267
- * defines the minimal number of non-decimal digits
20268
- */
20269
- minIntegerDigits?: int;
20270
- /**
20271
- * defines the used minus symbol
20272
- */
20273
- minusSign?: string;
20274
- /**
20275
- * since 1.28.2 defines whether to output the string from the parse function in order to keep the precision
20276
- * for big numbers. Numbers in scientific notation are parsed back to standard notation. For example, "5e-3"
20277
- * is parsed to "0.005".
20278
- */
20279
- parseAsString?: boolean;
20280
- /**
20281
- * CLDR number pattern which is used to format the number
20282
- */
20283
- pattern?: string;
20284
- /**
20285
- * defines the used plus symbol
20286
- */
20287
- plusSign?: string;
20288
- /**
20289
- * The maximum number of digits in the formatted representation of a number; if the `precision` is less
20290
- * than the overall length of the number, its fractional part is truncated through rounding. As the `precision`
20291
- * only affects the rounding of a number, its integer part can retain more digits than defined by this parameter.
20292
- * **Example:** With a `precision` of 2, the parameters `"234.567", "mass-kilogram"` are formatted to `"235
20293
- * kg"`. **Note:** The formatted output may differ depending on locale.
20294
- */
20295
- precision?: int;
20296
- /**
20297
- * Whether {@link #format} preserves decimal digits except trailing zeros in case there are more decimals
20298
- * than the `maxFractionDigits` format option allows. If decimals are not preserved, the formatted number
20299
- * is rounded to `maxFractionDigits`.
20300
- */
20301
- preserveDecimals?: boolean;
20302
- /**
20303
- * Specifies the rounding behavior for discarding the digits after the maximum fraction digits defined by
20304
- * `maxFractionDigits`. This can be assigned
20305
- * - by value in {@link sap.ui.core.format.NumberFormat.RoundingMode RoundingMode},
20306
- * - via a function that is used for rounding the number and takes two parameters: the number itself,
20307
- * and the number of decimal digits that should be reserved. **Using a function is deprecated since 1.121.0**;
20308
- * string based numbers are not rounded via this custom function.
20309
- */
20310
- roundingMode?: sap.ui.core.format.NumberFormat.RoundingMode;
20311
- /**
20312
- * defines the number of decimals in the shortened format string. If this option isn't specified, the 'decimals'
20313
- * option is used instead.
20314
- */
20315
- shortDecimals?: int;
20316
- /**
20317
- * defines a limit above which only short number formatting is used
20318
- */
20319
- shortLimit?: int;
20320
- /**
20321
- * since 1.40 specifies a number from which the scale factor for the 'short' or 'long' style format is generated.
20322
- * The generated scale factor is used for all numbers which are formatted with this format instance. This
20323
- * option only takes effect when the 'style' option is set to 'short' or 'long'. This option is set to `undefined`
20324
- * by default, which means that the scale factor is selected automatically for each number being formatted.
20325
- */
20326
- shortRefNumber?: int;
20327
- /**
20328
- * defines whether the unit of measure is shown in the formatted string, e.g. for input 1 and "duration-day"
20329
- * true: "1 day", false: "1". If both `showMeasure` and `showNumber` are false, an empty string is returned
20330
- */
20331
- showMeasure?: boolean;
20332
- /**
20333
- * defines whether the number is shown as part of the result string, e.g. 1 day for locale "en" `NumberFormat.getUnitInstance({showNumber:true}).format(1,
20334
- * "duration-day"); // "1 day"` `NumberFormat.getUnitInstance({showNumber:false}).format(1, "duration-day");
20335
- * // "day"` e.g. 2 days for locale "en" `NumberFormat.getUnitInstance({showNumber:true}).format(2, "duration-day");
20336
- * // "2 days"` `NumberFormat.getUnitInstance({showNumber:false}).format(2, "duration-day"); // "days"`
20337
- * If both `showMeasure` and `showNumber` are false, an empty string is returned
20338
- */
20339
- showNumber?: boolean;
20340
- /**
20341
- * since 1.40 specifies whether the scale factor is shown in the formatted number. This option takes effect
20342
- * only when the 'style' options is set to either 'short' or 'long'.
20343
- */
20344
- showScale?: boolean;
20345
- /**
20346
- * whether the positions of grouping separators are validated. Space characters used as grouping separators
20347
- * are not validated.
20348
- */
20349
- strictGroupingValidation?: boolean;
20350
- /**
20351
- * defines the style of format. Valid values are 'short, 'long' or 'standard' (based on the CLDR decimalFormat).
20352
- * When set to 'short' or 'long', numbers are formatted into compact forms. When this option is set, the
20353
- * default value of the 'precision' option is set to 2. This can be changed by setting either min/maxFractionDigits,
20354
- * decimals, shortDecimals, or the 'precision' option itself.
20355
- */
20356
- style?: string;
20357
- },
20260
+ oFormatOptions?: sap.ui.core.format.NumberFormat.UnitFormatOptions,
20358
20261
  /**
20359
20262
  * The locale to get the formatter for; if no locale is given, a locale for the currently configured language
20360
20263
  * is used; see {@link module:sap/base/i18n/Formatting.getLanguageTag Formatting.getLanguageTag}
@@ -20457,8 +20360,9 @@ declare namespace sap {
20457
20360
  * following target syntax: 'ControlID/PropertyName'. Creating an instance of this class using the "new"
20458
20361
  * keyword always results in the same instance (Singleton).
20459
20362
  */
20460
- class ControlMessageProcessor extends sap.ui.core.message
20461
- .MessageProcessor {
20363
+ class ControlMessageProcessor
20364
+ extends sap.ui.core.message.MessageProcessor
20365
+ {
20462
20366
  /**
20463
20367
  * Constructor for a new ControlMessageProcessor
20464
20368
  */
@@ -25624,6 +25528,28 @@ declare namespace sap {
25624
25528
  * @returns false if it was initialized before, true if it was initialized the first time
25625
25529
  */
25626
25530
  init(): boolean;
25531
+ /**
25532
+ * Parses the given hash and returns the hash segment that belongs to the given router.
25533
+ *
25534
+ * In nested component routing scenarios, the browser hash contains segments for multiple routers combined
25535
+ * with "&/" delimiters and prefix keys. This method parses the given hash and returns only the portion
25536
+ * that is relevant to the given router, based on the prefix key of its {@link sap.ui.core.routing.RouterHashChanger}.
25537
+ *
25538
+ * @since 1.149
25539
+ *
25540
+ * @returns The hash segment belonging to the given router, or `undefined` if the router has no {@link sap.ui.core.routing.RouterHashChanger }
25541
+ * assigned
25542
+ */
25543
+ parseHashForRouter(
25544
+ /**
25545
+ * The full browser hash to parse (e.g. as returned by {@link sap.ui.core.routing.History#getPreviousHash})
25546
+ */
25547
+ sHash: string,
25548
+ /**
25549
+ * The router for which the hash segment should be extracted
25550
+ */
25551
+ oRouter: sap.ui.core.routing.Router
25552
+ ): string | undefined;
25627
25553
  /**
25628
25554
  * Replaces the hash with a certain value. When using the replace function, no browser history entry is
25629
25555
  * written. If you want to have an entry in the browser history, please use the {@link #setHash} function.
@@ -29146,7 +29072,8 @@ declare namespace sap {
29146
29072
  * are loaded and available or within the callback in case not all CSS files are already loaded. This is
29147
29073
  * the **only asynchronous** API variant. This variant is the preferred way to retrieve theming parameters.
29148
29074
  * The structure of the return value is the same as listed above depending on the type of the name property
29149
- * within the `object`.
29075
+ * within the `object`. Further information on the usage of theming parameters can be found here: {@link https://ui5.sap.com/#/topic/45df6dff504647c686ab9ba72af827f6 Enhanced Theming Concepts}.
29076
+ *
29150
29077
  *
29151
29078
  * The returned key-value maps are a copy so changing values in the map does not have any effect
29152
29079
  *
@@ -39801,6 +39728,13 @@ declare namespace sap {
39801
39728
  * and the models will be propagated if defined. If the `usage` property is set the ComponentLifecycle is
39802
39729
  * processed like a "Container" lifecycle.
39803
39730
  *
39731
+ * **Note:** The `component` association is stored by ID, not by object reference (see {@link sap.ui.base.ManagedObject#setAssociation}).
39732
+ * Setting an ID that equals the currently stored one is treated as a no-op. When a previously associated
39733
+ * UIComponent is destroyed via {@link sap.ui.core.UIComponent#destroy}, the association is **not** cleared
39734
+ * automatically. If, however, the application destroys the component differently or replaces it with a
39735
+ * new instance that happens to share the same ID, the stale ID must be cleared explicitly by calling `setComponent(null)`
39736
+ * before assigning the new instance.
39737
+ *
39804
39738
  *
39805
39739
  * @returns the reference to `this` in order to allow method chaining
39806
39740
  */
@@ -39809,7 +39743,7 @@ declare namespace sap {
39809
39743
  * ID of an element which becomes the new target of this component association. Alternatively, an element
39810
39744
  * instance may be given.
39811
39745
  */
39812
- vComponent: sap.ui.core.ID | sap.ui.core.UIComponent
39746
+ vComponent: sap.ui.core.ID | sap.ui.core.UIComponent | null
39813
39747
  ): this;
39814
39748
  /**
39815
39749
  * Sets a new value for property {@link #getHandleValidation handleValidation}.
@@ -47865,7 +47799,7 @@ declare namespace sap {
47865
47799
  * Popup; a value of null removes all previous content
47866
47800
  */
47867
47801
  aContent: /* was Element */
47868
- global_Element[] | sap.ui.core.Element[] | string[]
47802
+ global_Element[] | sap.ui.core.Element[] | string[]
47869
47803
  ): this;
47870
47804
  /**
47871
47805
  * This enabled/disables the Popup to follow its opening reference. If the Popup is open and a followOf
@@ -56331,6 +56265,8 @@ declare namespace sap {
56331
56265
  /**
56332
56266
  * Adapter for TreeBindings to add the ListBinding functionality and use the tree structure in list based
56333
56267
  * controls.
56268
+ *
56269
+ * @deprecated As of version 1.150.0. will be replaced by OData V4 hierarchy functionality, see {@link topic:7d914317c0b64c23824bf932cc8a4ae1/section_RCH Recursive Hierarchy}
56334
56270
  */
56335
56271
  function ODataTreeBindingFlat(): void;
56336
56272
  /**
@@ -56618,32 +56554,7 @@ declare namespace sap {
56618
56554
  * the feature of ignoring messages, see {@link sap.ui.model.Binding#supportsIgnoreMessages}, and the corresponding
56619
56555
  * binding parameter is not set manually.
56620
56556
  */
56621
- oFormatOptions?: {
56622
- /**
56623
- * Not supported; the type derives this from its currency customizing part.
56624
- */
56625
- customCurrencies?: object;
56626
- /**
56627
- * Whether the amount is parsed to a string; set to `false` if the amount's underlying type is represented
56628
- * as a `number`, for example {@link sap.ui.model.odata.type.Int32}
56629
- */
56630
- parseAsString?: boolean;
56631
- /**
56632
- * Whether the amount is parsed if no currency is entered; defaults to `true` if neither `showMeasure` nor
56633
- * `showNumber` is set to a falsy value, otherwise defaults to `false`
56634
- */
56635
- unitOptional?: boolean;
56636
- /**
56637
- * Defines how an empty string is parsed into the amount. With the default value `0` the amount becomes
56638
- * `0` when an empty string is parsed.
56639
- */
56640
- emptyString?: any;
56641
- /**
56642
- * By default decimals are preserved, unless `oFormatOptions.style` is given as "short" or "long"; since
56643
- * 1.89.0
56644
- */
56645
- preserveDecimals?: boolean;
56646
- },
56557
+ oFormatOptions?: sap.ui.model.odata.type.CurrencyFormatOptions,
56647
56558
  /**
56648
56559
  * Only the 'skipDecimalsValidation' constraint is supported. Constraints are immutable, that is, they can
56649
56560
  * only be set once on construction.
@@ -57007,8 +56918,9 @@ declare namespace sap {
57007
56918
  *
57008
56919
  * @since 1.27.0
57009
56920
  */
57010
- abstract class DateTimeBase extends sap.ui.model.odata.type
57011
- .ODataType {
56921
+ abstract class DateTimeBase
56922
+ extends sap.ui.model.odata.type.ODataType
56923
+ {
57012
56924
  /**
57013
56925
  * Base constructor for the primitive types `Edm.DateTime` and `Edm.DateTimeOffset`.
57014
56926
  */
@@ -57404,7 +57316,7 @@ declare namespace sap {
57404
57316
  getPartsIgnoringMessages(): number[];
57405
57317
  /**
57406
57318
  * Returns a language-dependent placeholder text such as "e.g. " where is formatted
57407
- * using this type.
57319
+ * using this type. If given, a sample date within the given range is used.
57408
57320
  *
57409
57321
  *
57410
57322
  * @returns The language-dependent placeholder text or `undefined` if the type does not offer a placeholder
@@ -57413,11 +57325,11 @@ declare namespace sap {
57413
57325
  /**
57414
57326
  * The minimum date
57415
57327
  */
57416
- oMinimum?: /* was: sap.ui.core.date.UI5Date */ any,
57328
+ oMinimum?: import("sap/ui/core/date/UI5Date").default,
57417
57329
  /**
57418
57330
  * The maximum date
57419
57331
  */
57420
- oMaximum?: /* was: sap.ui.core.date.UI5Date */ any
57332
+ oMaximum?: import("sap/ui/core/date/UI5Date").default
57421
57333
  ): string | undefined;
57422
57334
  /**
57423
57335
  * Parses the given value.
@@ -58329,9 +58241,8 @@ declare namespace sap {
58329
58241
  * using this type. The `oMinimum` and `oMaximum` parameters are supported since 1.149.0 and only by types
58330
58242
  * that use {@link sap.ui.core.format.DateFormat} for formatting ({@link sap.ui.model.odata.type.Date},
58331
58243
  * {@link sap.ui.model.odata.type.DateTime}, {@link sap.ui.model.odata.type.DateTimeOffset}, {@link sap.ui.model.odata.type.DateTimeWithTimezone},
58332
- * {@link sap.ui.model.odata.type.Time}, and {@link sap.ui.model.odata.type.TimeOfDay}). The default sample
58333
- * date is used if it is valid. Otherwise, the closest valid year end, highest valid month end, or highest
58334
- * valid date is used.
58244
+ * {@link sap.ui.model.odata.type.Time}, and {@link sap.ui.model.odata.type.TimeOfDay}). If given, a sample
58245
+ * date within [`oMinimum`, `oMaximum`] is used.
58335
58246
  *
58336
58247
  *
58337
58248
  * @returns The language-dependent placeholder text or `undefined` if the type does not offer a placeholder
@@ -59210,32 +59121,7 @@ declare namespace sap {
59210
59121
  * the feature of ignoring messages, see {@link sap.ui.model.Binding#supportsIgnoreMessages}, and the corresponding
59211
59122
  * binding parameter is not set manually.
59212
59123
  */
59213
- oFormatOptions?: {
59214
- /**
59215
- * Not supported; the type derives this from its unit customizing part.
59216
- */
59217
- customUnits?: object;
59218
- /**
59219
- * Whether the measure is parsed to a string; set to `false` if the measure's underlying type is represented
59220
- * as a `number`, for example {@link sap.ui.model.odata.type.Int32}
59221
- */
59222
- parseAsString?: boolean;
59223
- /**
59224
- * By default decimals are preserved, unless `oFormatOptions.style` is given as "short" or "long"; since
59225
- * 1.89.0
59226
- */
59227
- preserveDecimals?: boolean;
59228
- /**
59229
- * Whether the measure is parsed if no unit is entered; defaults to `true` if neither `showMeasure` nor
59230
- * `showNumber` is set to a falsy value, otherwise defaults to `false`
59231
- */
59232
- unitOptional?: boolean;
59233
- /**
59234
- * Defines how an empty string is parsed into the measure. With the default value `0` the measure becomes
59235
- * `0` when an empty string is parsed.
59236
- */
59237
- emptyString?: any;
59238
- },
59124
+ oFormatOptions?: sap.ui.model.odata.type.UnitFormatOptions,
59239
59125
  /**
59240
59126
  * Only the 'skipDecimalsValidation' constraint is supported. Constraints are immutable, that is, they can
59241
59127
  * only be set once on construction.
@@ -59367,6 +59253,102 @@ declare namespace sap {
59367
59253
  ): void;
59368
59254
  }
59369
59255
 
59256
+ /**
59257
+ * Format options for the {@link sap.ui.model.odata.type.Currency} type.
59258
+ */
59259
+ type CurrencyFormatOptions =
59260
+ sap.ui.core.format.NumberFormat.FormatOptions & {
59261
+ /**
59262
+ * Defines whether the currency is shown as a code in currency format. The currency symbol is displayed
59263
+ * when this option is set to `false` and a symbol exists for the given currency code.
59264
+ */
59265
+ currencyCode?: boolean;
59266
+ /**
59267
+ * Can be set to either 'standard' (the default value) or to 'accounting' for an accounting-specific currency
59268
+ * display
59269
+ */
59270
+ currencyContext?:
59271
+ | "standard"
59272
+ | "accounting"
59273
+ | "sap-standard"
59274
+ | "sap-accounting";
59275
+ /**
59276
+ * The target length of places after the decimal separator; if the number has fewer decimals than specified
59277
+ * in this option, it is padded with whitespaces at the end up to the target length. An additional whitespace
59278
+ * character for the decimal separator is added for a number without any decimals. **Note:** This format
59279
+ * option is only allowed if the following conditions apply:
59280
+ * - It has a value greater than 0.
59281
+ * - The `oFormatOptions.style` format option is **not** set to `"short"` or `"long"`.
59282
+ */
59283
+ decimalPadding?: int;
59284
+ /**
59285
+ * The number of decimal digits.
59286
+ */
59287
+ decimals?: int;
59288
+ /**
59289
+ * Defines how an empty string is parsed into the amount. With the default value `0`, the amount becomes
59290
+ * `0` when an empty string is parsed.
59291
+ */
59292
+ emptyString?: any;
59293
+ /**
59294
+ * Deprecated as of 1.130; this format option does not have an effect on currency formats since decimals
59295
+ * can always be determined, either through the given format options, custom currencies, or the CLDR
59296
+ */
59297
+ minFractionDigits?: int;
59298
+ /**
59299
+ * Whether the amount is parsed to a string; set to `false` if the amount's underlying type is represented
59300
+ * as a `number`, for example {@link sap.ui.model.odata.type.Int32}
59301
+ */
59302
+ parseAsString?: boolean;
59303
+ /**
59304
+ * The maximum number of digits in the formatted representation of a number; if the `precision` is less
59305
+ * than the overall length of the number, its fractional part is truncated through rounding. As the `precision`
59306
+ * only affects the rounding of a number, its integer part can retain more digits than defined by this parameter.
59307
+ * **Example:** With a `precision` of 2, `234.567` is formatted to `235`. **Note:** The formatted output
59308
+ * may differ depending on locale.
59309
+ */
59310
+ precision?: int;
59311
+ /**
59312
+ * By default, decimals are preserved unless `oFormatOptions.style` is given as "short" or "long"; since
59313
+ * 1.89.0
59314
+ */
59315
+ preserveDecimals?: boolean;
59316
+ /**
59317
+ * Defines whether the currency code or symbol is shown in the formatted string, for example true: "1.00
59318
+ * EUR", false: "1.00" for locale "en" If both `showMeasure` and `showNumber` are `false`, an empty string
59319
+ * is returned
59320
+ */
59321
+ showMeasure?: boolean;
59322
+ /**
59323
+ * Defines whether the number is shown as part of the result string, for example 1 EUR for locale "en"
59324
+ * ```javascript
59325
+ * `NumberFormat.getCurrencyInstance({showNumber: true}).format(1, "EUR"); // "1.00 EUR"````
59326
+ *
59327
+ * ```javascript
59328
+ * `NumberFormat.getCurrencyInstance({showNumber: false}).format(1, "EUR"); // "EUR"````
59329
+ * If both `showMeasure` and `showNumber` are `false`, an empty string is returned
59330
+ */
59331
+ showNumber?: boolean;
59332
+ /**
59333
+ * The style of format. Valid values are based on the CLDR `decimalFormat`. When set to `short` or `long`,
59334
+ * numbers are formatted into compact forms. When this option is set, the default value of the `precision`
59335
+ * option is set to `2`. This can be changed by setting either `min/maxFractionDigits`, `decimals`, `shortDecimals`,
59336
+ * or the `precision` option itself.
59337
+ */
59338
+ style?: "short" | "long" | "standard";
59339
+ /**
59340
+ * Overrides the global configuration value {@link module:sap/base/i18n/Formatting.getTrailingCurrencyCode Formatting.getTrailingCurrencyCode},
59341
+ * which has a default value of `true`. This is ignored if `oFormatOptions.currencyCode` is set to `false`,
59342
+ * or if `oFormatOptions.pattern` is supplied.
59343
+ */
59344
+ trailingCurrencyCode?: boolean;
59345
+ /**
59346
+ * Whether the amount is parsed if no currency is entered; defaults to `true` if neither `showMeasure` nor
59347
+ * `showNumber` is set to a falsy value, otherwise defaults to `false`
59348
+ */
59349
+ unitOptional?: boolean;
59350
+ };
59351
+
59370
59352
  /**
59371
59353
  * The format options of the OData floating point number type {@link sap.ui.model.odata.type.Decimal}. It
59372
59354
  * differs to the other two OData floating point number types {@link sap.ui.model.odata.type.Double} and
@@ -59406,6 +59388,98 @@ declare namespace sap {
59406
59388
  */
59407
59389
  parseEmptyValueToZero?: boolean;
59408
59390
  };
59391
+
59392
+ /**
59393
+ * Format options for the {@link sap.ui.model.odata.type.Unit}.
59394
+ */
59395
+ type UnitFormatOptions =
59396
+ sap.ui.core.format.NumberFormat.FormatOptions & {
59397
+ /**
59398
+ * The number of decimals to be used for formatting the numerical value of the unit composite type; if none
59399
+ * of the format options `maxFractionDigits`, `minFractionDigits` or `decimals` are given, the following
59400
+ * defaults apply:
59401
+ * - **0** if the numerical value is of an OData integer type, i.e. {@link sap.ui.model.odata.type.Int }
59402
+ * or {@link sap.ui.model.odata.type.Int64}
59403
+ * - the **scale constraint of the numerical value's type** if this type is {@link sap.ui.model.odata.type.Decimal }
59404
+ * and the scale is not "variable"
59405
+ * - **3** otherwise
59406
+ */
59407
+ decimals?: int;
59408
+ /**
59409
+ * The target length of places after the decimal separator; if the number has fewer decimals than specified
59410
+ * in this option, it is padded with whitespaces at the end up to the target length. An additional whitespace
59411
+ * character for the decimal separator is added for a number without any decimals. **Note:** This format
59412
+ * option is only allowed if the following conditions apply:
59413
+ * - It has a value greater than 0
59414
+ * - The `oFormatOptions.style` format option is **not** set to `"short"` or `"long"`
59415
+ */
59416
+ decimalPadding?: int;
59417
+ /**
59418
+ * Defines how an empty string is parsed into the measure. With the default value `0` the measure becomes
59419
+ * `0` when an empty string is parsed.
59420
+ */
59421
+ emptyString?: null | number | string;
59422
+ /**
59423
+ * The minimal number of decimal digits.
59424
+ */
59425
+ minFractionDigits?: int;
59426
+ /**
59427
+ * Whether the measure is parsed to a string; set to `false` if the measure's underlying type is represented
59428
+ * as a `number`, for example {@link sap.ui.model.odata.type.Int32}
59429
+ */
59430
+ parseAsString?: boolean;
59431
+ /**
59432
+ * The maximum number of digits in the formatted representation of a number; if the `precision` is less
59433
+ * than the overall length of the number, its fractional part is truncated through rounding. As the `precision`
59434
+ * only affects the rounding of a number, its integer part can retain more digits than defined by this parameter.
59435
+ * **Example:** With a `precision` of 2, `234.567` is formatted to `235`. **Note:** The formatted output
59436
+ * may differ depending on locale.
59437
+ */
59438
+ precision?: int;
59439
+ /**
59440
+ * By default decimals are preserved, unless `oFormatOptions.style` is given as "short" or "long"; since
59441
+ * 1.89.0
59442
+ */
59443
+ preserveDecimals?: boolean;
59444
+ /**
59445
+ * Defines whether the unit of measure is shown in the formatted string, for example 1 day for locale "en"
59446
+ *
59447
+ * ```javascript
59448
+ * NumberFormat.getUnitInstance({showMeasure: true})
59449
+ * .format(1, "duration-day"); // "1 day"```
59450
+ *
59451
+ * ```javascript
59452
+ * NumberFormat.getUnitInstance({showMeasure: false})
59453
+ * .format(1, "duration-day"); // "1"```
59454
+ * If both `showMeasure` and `showNumber` are set to false, an empty string is returned.
59455
+ */
59456
+ showMeasure?: boolean;
59457
+ /**
59458
+ * Defines whether the number is shown as part of the formatted string, for example 1 day for locale "en"
59459
+ *
59460
+ * ```javascript
59461
+ * NumberFormat.getUnitInstance({showNumber: true})
59462
+ * .format(1, "duration-day"); // "1 day"```
59463
+ *
59464
+ * ```javascript
59465
+ * NumberFormat.getUnitInstance({showNumber: false})
59466
+ * .format(1, "duration-day"); // "day"```
59467
+ * If both `showMeasure` and `showNumber` are false, an empty string is returned
59468
+ */
59469
+ showNumber?: boolean;
59470
+ /**
59471
+ * The style of format. Valid values are based on the CLDR `decimalFormat`. When set to `short` or `long`,
59472
+ * numbers are formatted into compact forms. When this option is set, the default value of the `precision`
59473
+ * option is set to `2`. This can be changed by setting either `min/maxFractionDigits`, `decimals`, `shortDecimals`,
59474
+ * or the `precision` option itself.
59475
+ */
59476
+ style?: "short" | "long" | "standard";
59477
+ /**
59478
+ * Whether the measure is parsed if no unit is entered; defaults to `true` if neither `showMeasure` nor
59479
+ * `showNumber` is set to a falsy value, otherwise defaults to `false`
59480
+ */
59481
+ unitOptional?: boolean;
59482
+ };
59409
59483
  }
59410
59484
  /**
59411
59485
  * OData-based DataBinding
@@ -61799,6 +61873,7 @@ declare namespace sap {
61799
61873
  * See:
61800
61874
  * {@link http://www.sap.com/protocols/SAPData "SAP Annotations for OData Version 2.0" Specification}
61801
61875
  *
61876
+ * @deprecated As of version 1.150.0. will be replaced by OData V4 hierarchy functionality, see {@link topic:7d914317c0b64c23824bf932cc8a4ae1/section_RCH Recursive Hierarchy}
61802
61877
  *
61803
61878
  * @returns The new tree binding
61804
61879
  */
@@ -63668,6 +63743,8 @@ declare namespace sap {
63668
63743
  /**
63669
63744
  * Tree binding implementation for the {@link sap.ui.model.odata.v2.ODataModel}. Use {@link sap.ui.model.odata.v2.ODataModel#bindTree }
63670
63745
  * for creating an instance.
63746
+ *
63747
+ * @deprecated As of version 1.150.0. will be replaced by OData V4 hierarchy functionality, see {@link topic:7d914317c0b64c23824bf932cc8a4ae1/section_RCH Recursive Hierarchy}
63671
63748
  */
63672
63749
  class ODataTreeBinding extends sap.ui.model.TreeBinding {
63673
63750
  /**
@@ -75266,20 +75343,7 @@ declare namespace sap {
75266
75343
  * feature of ignoring model messages, see {@link sap.ui.model.Binding#supportsIgnoreMessages}, and the
75267
75344
  * corresponding binding parameter is not set manually.
75268
75345
  */
75269
- oFormatOptions?: {
75270
- /**
75271
- * By default decimals are preserved, unless `oFormatOptions.style` is given as "short" or "long"; since
75272
- * 1.89.0
75273
- */
75274
- preserveDecimals?: boolean;
75275
- /**
75276
- * A set of format options as defined for {@link sap.ui.core.format.NumberFormat.getCurrencyInstance} which
75277
- * describes the format of amount and currency in the model in case the model holds this in one property
75278
- * of type `string`, e.g. as "EUR 22". If an empty object is given, grouping is disabled, the
75279
- * decimal separator is a dot and the grouping separator is a comma.
75280
- */
75281
- source?: object;
75282
- },
75346
+ oFormatOptions?: sap.ui.model.type.CurrencyFormatOptions,
75283
75347
  /**
75284
75348
  * Constraints for the value part
75285
75349
  */
@@ -75466,13 +75530,25 @@ declare namespace sap {
75466
75530
  */
75467
75531
  getOutputPattern(): string;
75468
75532
  /**
75469
- * Returns a language-dependent placeholder text such as "e.g. " where is formatted
75470
- * using this type.
75533
+ * Returns a language-dependent placeholder text for this type. The `oMinimum` and `oMaximum` parameters
75534
+ * are supported since 1.150.
75535
+ *
75536
+ * If given, a sample date within [`oMinimum`, `oMaximum`] is used. If not given, `oConstraints.minimum`/`oConstraints.maximum`
75537
+ * are used as fallback.
75471
75538
  *
75472
75539
  *
75473
75540
  * @returns The language-dependent placeholder text or `undefined` if the type does not offer a placeholder
75474
75541
  */
75475
- getPlaceholderText(): string | undefined;
75542
+ getPlaceholderText(
75543
+ /**
75544
+ * The minimum date
75545
+ */
75546
+ oMinimum?: import("sap/ui/core/date/UI5Date").default,
75547
+ /**
75548
+ * The maximum date
75549
+ */
75550
+ oMaximum?: import("sap/ui/core/date/UI5Date").default
75551
+ ): string | undefined;
75476
75552
  }
75477
75553
  /**
75478
75554
  * This class represents the date interval composite type.
@@ -75602,13 +75678,25 @@ declare namespace sap {
75602
75678
  sTargetType: string
75603
75679
  ): string;
75604
75680
  /**
75605
- * Returns a language-dependent placeholder text such as "e.g. " where is formatted
75606
- * using this type.
75681
+ * Returns a language-dependent placeholder text for this type. The `oMinimum` and `oMaximum` parameters
75682
+ * are supported since 1.150.
75683
+ *
75684
+ * If given, a sample date within [`oMinimum`, `oMaximum`] is used. If not given, `oConstraints.minimum`/`oConstraints.maximum`
75685
+ * are used as fallback.
75607
75686
  *
75608
75687
  *
75609
75688
  * @returns The language-dependent placeholder text or `undefined` if the type does not offer a placeholder
75610
75689
  */
75611
- getPlaceholderText(): string | undefined;
75690
+ getPlaceholderText(
75691
+ /**
75692
+ * The minimum date
75693
+ */
75694
+ oMinimum?: import("sap/ui/core/date/UI5Date").default,
75695
+ /**
75696
+ * The maximum date
75697
+ */
75698
+ oMaximum?: import("sap/ui/core/date/UI5Date").default
75699
+ ): string | undefined;
75612
75700
  /**
75613
75701
  * Parses the given value to an array of two values representing the start date and the end date of the
75614
75702
  * interval, where the time part of the start date is 0 and the time part of end date is the end of day
@@ -76255,30 +76343,7 @@ declare namespace sap {
76255
76343
  * model messages, see {@link sap.ui.model.Binding#supportsIgnoreMessages}, and the corresponding binding
76256
76344
  * parameter is not set manually.
76257
76345
  */
76258
- oFormatOptions?: {
76259
- /**
76260
- * The number of decimals to be used for formatting the numerical value of the unit composite type; if none
76261
- * of the format options `maxFractionDigits`, `minFractionDigits` or `decimals` are given, the following
76262
- * defaults apply:
76263
- * - **0** if the numerical value is of an OData integer type, i.e. {@link sap.ui.model.odata.type.Int }
76264
- * or {@link sap.ui.model.odata.type.Int64}
76265
- * - the **scale constraint of the numerical value's type** if this type is {@link sap.ui.model.odata.type.Decimal }
76266
- * and the scale is not "variable"
76267
- * - **3** otherwise
76268
- */
76269
- decimals?: object;
76270
- /**
76271
- * By default decimals are preserved, unless `oFormatOptions.style` is given as "short" or "long"; since
76272
- * 1.89.0
76273
- */
76274
- preserveDecimals?: boolean;
76275
- /**
76276
- * Additional set of format options to be used if the property in the model is not of type `string` and
76277
- * needs formatting as well. If an empty object is given, the grouping is disabled and a dot is used as
76278
- * decimal separator.
76279
- */
76280
- source?: object;
76281
- },
76346
+ oFormatOptions?: sap.ui.model.type.UnitFormatOptions,
76282
76347
  /**
76283
76348
  * Value constraints
76284
76349
  */
@@ -76394,6 +76459,115 @@ declare namespace sap {
76394
76459
  ): any[] | string;
76395
76460
  }
76396
76461
 
76462
+ /**
76463
+ * Format options for the {@link sap.ui.model.type.Currency} type.
76464
+ */
76465
+ type CurrencyFormatOptions =
76466
+ sap.ui.core.format.NumberFormat.FormatOptions & {
76467
+ /**
76468
+ * Defines whether the currency is shown as a code in currency format. The currency symbol is displayed
76469
+ * when this option is set to `false` and a symbol exists for the given currency code.
76470
+ */
76471
+ currencyCode?: boolean;
76472
+ /**
76473
+ * Can be set to either 'standard' (the default value) or to 'accounting' for an accounting-specific currency
76474
+ * display
76475
+ */
76476
+ currencyContext?:
76477
+ | "standard"
76478
+ | "accounting"
76479
+ | "sap-standard"
76480
+ | "sap-accounting";
76481
+ /**
76482
+ * Defines a set of custom currencies exclusive to this NumberFormat instance. Custom currencies must not
76483
+ * consist only of digits. If custom currencies are defined on the instance, no other currencies can be
76484
+ * formatted and parsed by this instance. Globally available custom currencies can be added via the global
76485
+ * configuration. See {@link module:sap/base/i18n/Formatting.setCustomCurrencies Formatting.setCustomCurrencies }
76486
+ * and {@link module:sap/base/i18n/Formatting.addCustomCurrencies Formatting.addCustomCurrencies}.
76487
+ */
76488
+ customCurrencies?: Record<string, object>;
76489
+ /**
76490
+ * The number of decimal digits.
76491
+ */
76492
+ decimals?: int;
76493
+ /**
76494
+ * The target length of places after the decimal separator; if the number has fewer decimals than specified
76495
+ * in this option, it is padded with whitespaces at the end up to the target length. An additional whitespace
76496
+ * character for the decimal separator is added for a number without any decimals. **Note:** This format
76497
+ * option is only allowed if the following conditions apply:
76498
+ * - It has a value greater than 0.
76499
+ * - The `oFormatOptions.style` format option is **not** set to `"short"` or `"long"`.
76500
+ */
76501
+ decimalPadding?: int;
76502
+ /**
76503
+ * Since 1.130.0. Defines what value an empty string is parsed into and what value is formatted as an empty
76504
+ * string. The {@link #format} and {@link #parse} functions are done in a symmetric way. For example, when
76505
+ * this parameter is set to `NaN`, an empty string is parsed as `NaN`, and `NaN` is formatted as an empty
76506
+ * string.
76507
+ */
76508
+ emptyString?: null | number | string;
76509
+ /**
76510
+ * Deprecated as of 1.130; this format option does not have an effect on currency formats since decimals
76511
+ * can always be determined, either through the given format options, custom currencies or the CLDR
76512
+ */
76513
+ minFractionDigits?: int;
76514
+ /**
76515
+ * Since 1.28.2, whether to parse the number as a string in order to keep the precision for large numbers.
76516
+ * Numbers in scientific notation are parsed back to standard notation. For example, `5e-3` is parsed to
76517
+ * `0.005`.
76518
+ */
76519
+ parseAsString?: boolean;
76520
+ /**
76521
+ * The maximum number of digits in the formatted representation of a number; if the `precision` is less
76522
+ * than the overall length of the number, its fractional part is truncated through rounding. As the `precision`
76523
+ * only affects the rounding of a number, its integer part can retain more digits than defined by this parameter.
76524
+ * **Example:** With a `precision` of 2, `234.567` is formatted to `235`. **Note:** The formatted output
76525
+ * may differ depending on locale.
76526
+ */
76527
+ precision?: int;
76528
+ /**
76529
+ * By default, decimals are preserved unless `oFormatOptions.style` is given as "short" or "long"; since
76530
+ * 1.89.0
76531
+ */
76532
+ preserveDecimals?: boolean;
76533
+ /**
76534
+ * Defines whether the currency code or symbol is shown in the formatted string, for example true: "1.00
76535
+ * EUR", false: "1.00" for locale "en" If both `showMeasure` and `showNumber` are `false`, an empty string
76536
+ * is returned
76537
+ */
76538
+ showMeasure?: boolean;
76539
+ /**
76540
+ * Defines whether the number is shown as part of the result string, for example 1 EUR for locale "en"
76541
+ * ```javascript
76542
+ * `NumberFormat.getCurrencyInstance({showNumber: true}).format(1, "EUR"); // "1.00 EUR"````
76543
+ *
76544
+ * ```javascript
76545
+ * `NumberFormat.getCurrencyInstance({showNumber: false}).format(1, "EUR"); // "EUR"````
76546
+ * If both `showMeasure` and `showNumber` are `false`, an empty string is returned
76547
+ */
76548
+ showNumber?: boolean;
76549
+ /**
76550
+ * A set of format options as defined for {@link sap.ui.core.format.NumberFormat.getCurrencyInstance} which
76551
+ * describes the format of amount and currency in the model in case the model holds this in one property
76552
+ * of type `string`, for example as "EUR 22". If an empty object is given, grouping is disabled, the decimal
76553
+ * separator is a dot, and the grouping separator is a comma.
76554
+ */
76555
+ source?: object;
76556
+ /**
76557
+ * The style of format. Valid values are based on the CLDR `decimalFormat`. When set to `short` or `long`,
76558
+ * numbers are formatted into compact forms. When this option is set, the default value of the `precision`
76559
+ * option is set to `2`. This can be changed by setting either `min/maxFractionDigits`, `decimals`, `shortDecimals`,
76560
+ * or the `precision` option itself.
76561
+ */
76562
+ style?: "short" | "long" | "standard";
76563
+ /**
76564
+ * Overrides the global configuration value {@link module:sap/base/i18n/Formatting.getTrailingCurrencyCode Formatting.getTrailingCurrencyCode},
76565
+ * which has a default value of `true`. This is ignored if `oFormatOptions.currencyCode` is set to `false`,
76566
+ * or if `oFormatOptions.pattern` is supplied.
76567
+ */
76568
+ trailingCurrencyCode?: boolean;
76569
+ };
76570
+
76397
76571
  /**
76398
76572
  * The format options of the {@link sap.ui.model.type.Float} type.
76399
76573
  */
@@ -76419,6 +76593,118 @@ declare namespace sap {
76419
76593
  */
76420
76594
  source?: Record<string, any>;
76421
76595
  };
76596
+
76597
+ /**
76598
+ * Format options for the {@link sap.ui.model.type.Unit Unit type}.
76599
+ */
76600
+ type UnitFormatOptions =
76601
+ sap.ui.core.format.NumberFormat.FormatOptions & {
76602
+ /**
76603
+ * Defines the allowed units for formatting and parsing, for example `["size-meter", "volume-liter", ...]`
76604
+ * If this option is not specified, all units are allowed.
76605
+ */
76606
+ allowedUnits?: string[];
76607
+ /**
76608
+ * Defines a set of custom units, for example:
76609
+ * ```javascript
76610
+ * {"electric-inductance": {
76611
+ * "displayName": "henry",
76612
+ * "unitPattern-count-one": "{0} H",
76613
+ * "unitPattern-count-other": "{0} H",
76614
+ * "perUnitPattern": "{0}/H",
76615
+ * "decimals": 2,
76616
+ * "precision": 4
76617
+ * }
76618
+ * }```
76619
+ */
76620
+ customUnits?: Record<string, object>;
76621
+ /**
76622
+ * The number of decimals to be used for formatting the numerical value of the unit composite type; if none
76623
+ * of the format options `maxFractionDigits`, `minFractionDigits` or `decimals` are given, the following
76624
+ * defaults apply:
76625
+ * - **0** if the numerical value is of an OData integer type, i.e. {@link sap.ui.model.odata.type.Int }
76626
+ * or {@link sap.ui.model.odata.type.Int64}
76627
+ * - the **scale constraint of the numerical value's type** if this type is {@link sap.ui.model.odata.type.Decimal }
76628
+ * and the scale is not "variable"
76629
+ * - **3** otherwise
76630
+ */
76631
+ decimals?: int;
76632
+ /**
76633
+ * The target length of places after the decimal separator; if the number has fewer decimals than specified
76634
+ * in this option, it is padded with whitespaces at the end up to the target length. An additional whitespace
76635
+ * character for the decimal separator is added for a number without any decimals. **Note:** This format
76636
+ * option is only allowed if the following conditions apply:
76637
+ * - It has a value greater than 0
76638
+ * - The `oFormatOptions.style` format option is **not** set to `"short"` or `"long"`
76639
+ */
76640
+ decimalPadding?: int;
76641
+ /**
76642
+ * Defines how an empty string is parsed into the measure. With the default value `0` the measure becomes
76643
+ * `0` when an empty string is parsed.
76644
+ */
76645
+ emptyString?: null | number | string;
76646
+ /**
76647
+ * The minimal number of decimal digits.
76648
+ */
76649
+ minFractionDigits?: int;
76650
+ /**
76651
+ * Whether the measure is parsed to a string; set to `false` if the measure's underlying type is represented
76652
+ * as a `number`, for example {@link sap.ui.model.type.Integer}
76653
+ */
76654
+ parseAsString?: boolean;
76655
+ /**
76656
+ * The maximum number of digits in the formatted representation of a number; if the `precision` is less
76657
+ * than the overall length of the number, its fractional part is truncated through rounding. As the `precision`
76658
+ * only affects the rounding of a number, its integer part can retain more digits than defined by this parameter.
76659
+ * **Example:** With a `precision` of 2, `234.567` is formatted to `235`. **Note:** The formatted output
76660
+ * may differ depending on locale.
76661
+ */
76662
+ precision?: int;
76663
+ /**
76664
+ * By default decimals are preserved, unless `oFormatOptions.style` is given as "short" or "long"; since
76665
+ * 1.89.0
76666
+ */
76667
+ preserveDecimals?: boolean;
76668
+ /**
76669
+ * Defines whether the unit of measure is shown in the formatted string, for example 1 day for locale "en"
76670
+ *
76671
+ * ```javascript
76672
+ * NumberFormat.getUnitInstance({showMeasure: true})
76673
+ * .format(1, "duration-day"); // "1 day"```
76674
+ *
76675
+ * ```javascript
76676
+ * NumberFormat.getUnitInstance({showMeasure: false})
76677
+ * .format(1, "duration-day"); // "1"```
76678
+ * If both `showMeasure` and `showNumber` are set to false, an empty string is returned.
76679
+ */
76680
+ showMeasure?: boolean;
76681
+ /**
76682
+ * Defines whether the number is shown as part of the formatted string, for example 1 day for locale "en"
76683
+ *
76684
+ * ```javascript
76685
+ * NumberFormat.getUnitInstance({showNumber: true})
76686
+ * .format(1, "duration-day"); // "1 day"```
76687
+ *
76688
+ * ```javascript
76689
+ * NumberFormat.getUnitInstance({showNumber: false})
76690
+ * .format(1, "duration-day"); // "day"```
76691
+ * If both `showMeasure` and `showNumber` are false, an empty string is returned
76692
+ */
76693
+ showNumber?: boolean;
76694
+ /**
76695
+ * Additional set of format options to be used if the property in the model is not of type `string` and
76696
+ * needs formatting as well. If an empty object is given, the grouping is disabled and a dot is used as
76697
+ * decimal separator.
76698
+ */
76699
+ source?: object;
76700
+ /**
76701
+ * The style of format. Valid values are based on the CLDR `decimalFormat`. When set to `short` or `long`,
76702
+ * numbers are formatted into compact forms. When this option is set, the default value of the `precision`
76703
+ * option is set to `2`. This can be changed by setting either `min/maxFractionDigits`, `decimals`, `shortDecimals`,
76704
+ * or the `precision` option itself.
76705
+ */
76706
+ style?: "short" | "long" | "standard";
76707
+ };
76422
76708
  }
76423
76709
  /**
76424
76710
  * Parameters of the Binding#AggregatedDataStateChange event.
@@ -84616,8 +84902,9 @@ declare namespace sap {
84616
84902
  *
84617
84903
  * @since 1.23
84618
84904
  */
84619
- class AggregationContainsPropertyEqual extends sap.ui.test.matchers
84620
- .Matcher {
84905
+ class AggregationContainsPropertyEqual
84906
+ extends sap.ui.test.matchers.Matcher
84907
+ {
84621
84908
  /**
84622
84909
  * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
84623
84910
  * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description