@openui5/types 1.118.0 → 1.119.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.
@@ -280,7 +280,7 @@ declare namespace sap {
280
280
  }
281
281
  }
282
282
 
283
- // For Library Version: 1.118.0
283
+ // For Library Version: 1.119.0
284
284
 
285
285
  declare module "sap/base/assert" {
286
286
  /**
@@ -2207,6 +2207,7 @@ declare module "sap/base/util/uid" {
2207
2207
  declare module "sap/base/util/UriParameters" {
2208
2208
  /**
2209
2209
  * @since 1.68
2210
+ * @deprecated (since 1.119) - See class description for details.
2210
2211
  *
2211
2212
  * Provides access to the individual parameters of a URL query string.
2212
2213
  *
@@ -2215,29 +2216,38 @@ declare module "sap/base/util/UriParameters" {
2215
2216
  * for a parameter and to {@link #getAll get a list of all values (`getAll()`)} for a parameter. Another
2216
2217
  * method allows to {@link #keys iterate over all parameter names (`keys()`)}.
2217
2218
  *
2218
- * The signature and behavior of those methods is aligned with the corresponding methods of the upcoming
2219
- * Web API `URLSearchParams`.
2220
- *
2221
2219
  * Decoding:
2222
2220
  *
2223
2221
  * The constructor and the factory methods expect percentage encoded input whereas all other APIs expect
2224
2222
  * and return decoded strings. After parsing the query string, any plus sign (0x2b) in names or values is
2225
2223
  * replaced by a blank (0x20) and the resulting strings are percentage decoded (`decodeURIComponent`).
2226
2224
  *
2227
- * Future Migration:
2228
- *
2229
- * **Note:** To simplify a future migration from this class to the standard `URLSearchParams` API, consuming
2230
- * code should follow some recommendations:
2231
- * - do not use the constructor, either use {@link #.fromURL UriParameters.fromURL} when the input is
2232
- * a full URL, or use {@link #.fromQuery UriParameters.fromQuery} when the input only contains the query
2233
- * part of an URL (e.g. `location.search`).
2234
- * - do not use the `get` method with the second parameter `bAll`; use the `getAll` method instead
2235
- * - do not access the internal property `mParams` (you never should access internal properties of UI5
2236
- * classes or objects). With the predecessor of this API, access to `mParams` was often used to check whether
2237
- * a parameter is defined at all. Using the new `has` method or checking the result of `get` against `null`
2238
- * serves the same purpose. Callers using `UriParameters.fromQuery(input)` can be migrated to `new
2239
- * URLSearchParams(input)` once the new API is available in all supported browsers. Callers using `UriParameters.fromURL(input)`
2240
- * can be migrated to `new URL(input).searchParams` then.
2225
+ * Deprecation:
2226
+ *
2227
+ * This class is deprecated in favor of the URL web standard classes `URLSearchParams` / `URL`.
2228
+ *
2229
+ * `UriParameters.fromQuery(input)` can be migrated to `new URLSearchParams(input)`
2230
+ *
2231
+ * `UriParameters.fromURL(input)` can be migrated to `new URL(input).searchParams`
2232
+ *
2233
+ * Caveats:
2234
+ *
2235
+ * The API has already been designed to be a drop-in replacement but there are some important caveats to
2236
+ * consider when switching to the standard APIs `URLSearchParams` / `URL`:
2237
+ * - `new URL(input).searchParams` validates the given URL according to the WHATWG URL Standard ({@link https://url.spec.whatwg.org}).
2238
+ * `UriParameters.fromURL(input)` only extracts the query string from the given input but does not perform
2239
+ * any validation.
2240
+ * - In some edge cases, especially for incomplete/invalid encoding, decoding behaves differently. Decoding
2241
+ * in `UriParameters` is described in the section above. For details about the encoding/decoding of `URLSearchParams`,
2242
+ * see the WHATWG URL Standard ({@link https://url.spec.whatwg.org}).
2243
+ * - The `get` method's second parameter, `bAll`, is not available; use the `getAll` method instead.
2244
+ * - The `keys` method's return value contains an entry for every occurrence of the key within the query,
2245
+ * in the defined order and including duplicates. `UriParameters#keys()` yields unique key values, even
2246
+ * when there are multiple values for the same key.
2247
+ * - The internal `mParams` property is not available anymore (you should never access internal properties
2248
+ * of UI5 classes or objects). With the predecessor of this API, access to `mParams` was often used to check
2249
+ * whether a parameter is defined at all. Using the `has` method or checking the result of `get` against
2250
+ * `null` serves the same purpose.
2241
2251
  */
2242
2252
  export default class UriParameters {
2243
2253
  /**
@@ -3261,6 +3271,24 @@ declare module "sap/ui/core/date/UI5Date" {
3261
3271
  }
3262
3272
  }
3263
3273
 
3274
+ declare module "sap/ui/core/getCompatibilityVersion" {
3275
+ import Version from "sap/base/util/Version";
3276
+
3277
+ /**
3278
+ * @deprecated (since 1.119.0)
3279
+ *
3280
+ * Returns the used compatibility version for the given feature.
3281
+ *
3282
+ * @returns the used compatibility version
3283
+ */
3284
+ export default function getCompatibilityVersion(
3285
+ /**
3286
+ * the key of desired feature
3287
+ */
3288
+ sFeature: string
3289
+ ): Version;
3290
+ }
3291
+
3264
3292
  declare module "sap/ui/core/InvisibleRenderer" {
3265
3293
  import Control from "sap/ui/core/Control";
3266
3294
 
@@ -3332,6 +3360,37 @@ declare module "sap/ui/core/InvisibleRenderer" {
3332
3360
  export default InvisibleRenderer;
3333
3361
  }
3334
3362
 
3363
+ declare module "sap/ui/core/message/MessageType" {
3364
+ /**
3365
+ * @since 1.118
3366
+ *
3367
+ * Specifies possible message types.
3368
+ */
3369
+ enum MessageType {
3370
+ /**
3371
+ * Message is an error
3372
+ */
3373
+ Error = "Error",
3374
+ /**
3375
+ * Message should be just an information
3376
+ */
3377
+ Information = "Information",
3378
+ /**
3379
+ * Message has no specific level
3380
+ */
3381
+ None = "None",
3382
+ /**
3383
+ * Message is a success message
3384
+ */
3385
+ Success = "Success",
3386
+ /**
3387
+ * Message is a warning
3388
+ */
3389
+ Warning = "Warning",
3390
+ }
3391
+ export default MessageType;
3392
+ }
3393
+
3335
3394
  declare module "sap/ui/core/Messaging" {
3336
3395
  import Message from "sap/ui/core/message/Message";
3337
3396
 
@@ -3439,6 +3498,49 @@ declare module "sap/ui/core/Messaging" {
3439
3498
  export default Messaging;
3440
3499
  }
3441
3500
 
3501
+ declare module "sap/ui/core/StaticArea" {
3502
+ import UIArea from "sap/ui/core/UIArea";
3503
+
3504
+ /**
3505
+ * Helper module to access the static area.
3506
+ *
3507
+ * The static area is a hidden DOM element with a unique ID and managed by the framework. It is typically
3508
+ * used for hidden or temporarily hidden elements like InvisibleText, Popup, Shadow, Blocklayer etc.
3509
+ *
3510
+ * All methods throw an `Error` when they are called before the document is ready.
3511
+ */
3512
+ interface StaticArea {
3513
+ /**
3514
+ * Checks whether the given DOM element is part of the static area.
3515
+ *
3516
+ * @returns Whether the given DOM reference is part of the static UIArea
3517
+ */
3518
+ contains(
3519
+ /**
3520
+ * The DOM element to check
3521
+ */
3522
+ oDomRef: Element
3523
+ ): boolean;
3524
+ /**
3525
+ * Returns the root element of the static, hidden area.
3526
+ *
3527
+ * It can be used e.g. for hiding elements like Popup, Shadow, Blocklayer etc. If it is not yet available,
3528
+ * a DIV element is created and appended to the body.
3529
+ *
3530
+ * @returns the root DOM element of the static, hidden area
3531
+ */
3532
+ getDomRef(): Element;
3533
+ /**
3534
+ * Returns the `UIArea` instance for the static area. If none exists yet, one gets created.
3535
+ *
3536
+ * @returns The `UIArea` instance for the static area
3537
+ */
3538
+ getUIArea(): UIArea;
3539
+ }
3540
+ const StaticArea: StaticArea;
3541
+ export default StaticArea;
3542
+ }
3543
+
3442
3544
  declare module "sap/ui/core/syncStyleClass" {
3443
3545
  import Control from "sap/ui/core/Control";
3444
3546
 
@@ -3476,7 +3578,11 @@ declare module "sap/ui/core/Theming" {
3476
3578
  */
3477
3579
  interface Theming {
3478
3580
  /**
3479
- * Attaches event handler `fnFunction` to the {@link #event:applied applied} event
3581
+ * Attaches event handler `fnFunction` to the {@link #event:applied applied} event.
3582
+ *
3583
+ * The given handler is called when the the applied event is fired. If the theme is already applied the
3584
+ * handler will be called immediately. The handler stays attached to the applied event for future theme
3585
+ * changes.
3480
3586
  */
3481
3587
  attachApplied(
3482
3588
  /**
@@ -3501,6 +3607,10 @@ declare module "sap/ui/core/Theming" {
3501
3607
  * @returns the theme name
3502
3608
  */
3503
3609
  getTheme(): string;
3610
+ /**
3611
+ * Notify content density changes
3612
+ */
3613
+ notifyContentDensityChanged(): void;
3504
3614
  /**
3505
3615
  * Allows setting the theme name
3506
3616
  *
@@ -7426,7 +7536,7 @@ declare module "sap/ui/base/ManagedObject" {
7426
7536
  * the same ID as an element or another `ManagedObject`.
7427
7537
  *
7428
7538
  * For the same reason, there is no general lookup for `ManagedObject`s via their ID. Only for subclasses
7429
- * that enforce unique IDs, there might be lookup mechanisms (e.g. {@link sap.ui.core.Core#byId sap.ui.getCore().byId() }
7539
+ * that enforce unique IDs, there might be lookup mechanisms (e.g. {@link sap.ui.core.Element#getElementById sap.ui.core.Element.getElementById }
7430
7540
  * for elements).
7431
7541
  *
7432
7542
  * @returns The objects's ID.
@@ -9205,6 +9315,14 @@ declare module "sap/ui/base/ManagedObjectMetadata" {
9205
9315
  */
9206
9316
  oAggregatedObject: ManagedObject
9207
9317
  ): void;
9318
+ /**
9319
+ * @since 1.119.0
9320
+ *
9321
+ * Get the prefix used for the generated IDs from configuration
9322
+ *
9323
+ * @returns The prefix for the generated IDs
9324
+ */
9325
+ static getUIDPrefix(): string;
9208
9326
  /**
9209
9327
  * Test whether a given ID looks like it was automatically generated.
9210
9328
  *
@@ -11228,7 +11346,28 @@ declare module "sap/ui/core/library" {
11228
11346
  /**
11229
11347
  * Specifies possible message types.
11230
11348
  */
11231
- export enum MessageType {}
11349
+ export enum MessageType {
11350
+ /**
11351
+ * Message is an error
11352
+ */
11353
+ Error = "Error",
11354
+ /**
11355
+ * Message should be just an information
11356
+ */
11357
+ Information = "Information",
11358
+ /**
11359
+ * Message has no specific level
11360
+ */
11361
+ None = "None",
11362
+ /**
11363
+ * Message is a success message
11364
+ */
11365
+ Success = "Success",
11366
+ /**
11367
+ * Message is a warning
11368
+ */
11369
+ Warning = "Warning",
11370
+ }
11232
11371
  /**
11233
11372
  * Defines the different possible states of an element that can be open or closed and does not only toggle
11234
11373
  * between these states, but also spends some time in between (e.g. because of an animation).
@@ -12866,6 +13005,8 @@ declare module "sap/ui/core/Component" {
12866
13005
  onDeactivate(): void;
12867
13006
  /**
12868
13007
  * @since 1.15.1
13008
+ * @deprecated (since 1.119) - recommended to use the browser-native page lifecycle API, providing events
13009
+ * such as 'pageshow' and 'pagehide'
12869
13010
  *
12870
13011
  * The window before unload hook. Override this method in your Component class implementation, to handle
12871
13012
  * cleanup before the real unload or to prompt a question to the user, if the component should be exited.
@@ -12876,6 +13017,8 @@ declare module "sap/ui/core/Component" {
12876
13017
  onWindowBeforeUnload(): string | undefined;
12877
13018
  /**
12878
13019
  * @since 1.15.1
13020
+ * @deprecated (since 1.119) - recommended to use the browser-native API to listen for errors: window.addEventListener("error",
13021
+ * function() { ... })
12879
13022
  *
12880
13023
  * The window error hook. Override this method in your Component class implementation to listen to unhandled
12881
13024
  * errors.
@@ -12896,6 +13039,9 @@ declare module "sap/ui/core/Component" {
12896
13039
  ): void;
12897
13040
  /**
12898
13041
  * @since 1.15.1
13042
+ * @deprecated (since 1.119) - Newer browser versions deprecate the browser-native 'unload' event. Therefore,
13043
+ * the former API won't reliably work anymore. Please have a look at the browser-native page lifecycle API,
13044
+ * e.g. its events 'pageshow' and 'pagehide'.
12899
13045
  *
12900
13046
  * The window unload hook. Override this method in your Component class implementation, to handle cleanup
12901
13047
  * of the component once the window will be unloaded (e.g. closed).
@@ -14179,6 +14325,8 @@ declare module "sap/ui/core/Configuration" {
14179
14325
  getAccessibility(): boolean;
14180
14326
  /**
14181
14327
  * @since 1.77.0
14328
+ * @deprecated (since 1.118) - Please use {@link module:sap/base/i18n/Localization.getActiveTerminologies }
14329
+ * instead.
14182
14330
  *
14183
14331
  * Returns the list of active terminologies defined via the Configuration.
14184
14332
  *
@@ -14246,6 +14394,8 @@ declare module "sap/ui/core/Configuration" {
14246
14394
  */
14247
14395
  getCalendarWeekNumbering(): CalendarWeekNumbering;
14248
14396
  /**
14397
+ * @deprecated (since 1.119.0)
14398
+ *
14249
14399
  * Returns the used compatibility version for the given feature.
14250
14400
  *
14251
14401
  * @returns the used compatibility version
@@ -14452,6 +14602,9 @@ declare module "sap/ui/core/Configuration" {
14452
14602
  */
14453
14603
  getTimezone(): string;
14454
14604
  /**
14605
+ * @deprecated (since 1.119.0) - Please use {@link sap.ui.base.ManagedObjectMetadata.getUIDPrefix ManagedObjectMetadata.getUIDPrefix }
14606
+ * instead.
14607
+ *
14455
14608
  * Prefix to be used for automatically generated control IDs. Default is a double underscore "__".
14456
14609
  *
14457
14610
  * @returns the prefix to be used
@@ -16072,7 +16225,7 @@ declare module "sap/ui/core/Core" {
16072
16225
 
16073
16226
  import UI5Element from "sap/ui/core/Element";
16074
16227
 
16075
- import Component from "sap/ui/core/Component";
16228
+ import { default as Component, MetadataOptions } from "sap/ui/core/Component";
16076
16229
 
16077
16230
  import RenderManager from "sap/ui/core/RenderManager";
16078
16231
 
@@ -16088,7 +16241,7 @@ declare module "sap/ui/core/Core" {
16088
16241
 
16089
16242
  import ResourceBundle from "sap/base/i18n/ResourceBundle";
16090
16243
 
16091
- import MessageManager from "sap/ui/core/message/MessageManager";
16244
+ import Messaging from "sap/ui/core/Messaging";
16092
16245
 
16093
16246
  import Metadata from "sap/ui/base/Metadata";
16094
16247
 
@@ -16099,65 +16252,54 @@ declare module "sap/ui/core/Core" {
16099
16252
  /**
16100
16253
  * Core Class of the SAP UI Library.
16101
16254
  *
16102
- * This class boots the Core framework and makes it available for the application via method `sap.ui.getCore()`.
16103
- *
16104
- * Example:
16105
- * ```javascript
16106
- *
16107
- *
16108
- * var oCore = sap.ui.getCore();
16109
- *
16110
- * ```
16111
- *
16255
+ * This class boots the Core framework and makes it available for the application by requiring `sap.ui.core.Core`.
16112
16256
  *
16113
- * With methods of the Core framework you can {@link #attachInit execute code} after the framework has been
16114
- * initialized. It provides access to the {@link #getConfiguration configuration} and exposes events that
16115
- * an application or a control can register to (e.g. {@link #event:localizationChanged localizationChanged},
16116
- * {@link #event:parseError parseError}, {@link #event:validationError validationError}, {@link #event:formatError formatError},
16117
- * {@link #event:validationSuccess validationSuccess}).
16257
+ * The Core provides a {@link #ready ready function} to execute code after the core was booted.
16118
16258
  *
16119
16259
  * Example:
16120
16260
  * ```javascript
16121
16261
  *
16122
16262
  *
16123
- * oCore.attachInit(function() {
16124
- * if ( oCore.getConfiguration().getRTL() ) {
16263
+ * oCore.ready(function() {
16125
16264
  * ...
16126
- * }
16127
16265
  * });
16128
16266
  *
16129
- * oCore.attachLocalizationChanged(function(oEvent) {
16130
- * ...
16131
- * });
16267
+ * await oCore.ready();
16268
+ * ...
16132
16269
  *
16133
16270
  * ```
16134
16271
  */
16135
16272
  interface Core {
16136
16273
  /**
16137
- * Creates a new subclass of class sap.ui.core.Core with name `sClassName` and enriches it with the information
16274
+ * @deprecated (since 1.119.0)
16275
+ *
16276
+ * Creates a new subclass of class `sap.ui.core.Core` with name `sClassName` and enriches it with the information
16138
16277
  * contained in `oClassInfo`.
16139
16278
  *
16140
- * `oClassInfo` might contain the same kind of information as described in {@link sap.ui.base.Object.extend}.
16279
+ * `oClassInfo` might contain the same kind of information as described in {@link sap.ui.base.ManagedObject.extend}.
16141
16280
  *
16142
- * @returns Created class / constructor function
16281
+ * @returns The created class / constructor function
16143
16282
  */
16144
16283
  extend(
16145
16284
  /**
16146
- * Name of the class being created
16285
+ * Qualified name of the newly created class
16147
16286
  */
16148
16287
  sClassName: string,
16149
16288
  /**
16150
16289
  * Object literal with information about the class
16151
16290
  */
16152
- oClassInfo?: object,
16153
- /**
16154
- * Constructor function for the metadata object; if not given, it defaults to the metadata implementation
16155
- * used by this class
16156
- */
16157
- FNMetaImpl?: Function
16291
+ oClassInfo?: {
16292
+ /**
16293
+ * The metadata object describing the class. See {@link sap.ui.core.Component.MetadataOptions MetadataOptions }
16294
+ * for the values allowed in every extend.
16295
+ */
16296
+ metadata?: MetadataOptions;
16297
+ }
16158
16298
  ): Function;
16159
16299
  /**
16160
- * Returns a metadata object for class sap.ui.core.Core.
16300
+ * @deprecated (since 1.119.0)
16301
+ *
16302
+ * Returns the metadata for class `sap.ui.core.Core`.
16161
16303
  *
16162
16304
  * @returns Metadata object describing this class
16163
16305
  */
@@ -16172,6 +16314,8 @@ declare module "sap/ui/core/Core" {
16172
16314
  */
16173
16315
  applyChanges(): void;
16174
16316
  /**
16317
+ * @deprecated (since 1.119) - Please use {@link module:sap/ui/core/Theming.setTheme Theming.setTheme} instead.
16318
+ *
16175
16319
  * Applies the theme with the given name (by loading the respective style sheets, which does not disrupt
16176
16320
  * the application).
16177
16321
  *
@@ -16200,6 +16344,8 @@ declare module "sap/ui/core/Core" {
16200
16344
  sThemeBaseUrl?: string
16201
16345
  ): void;
16202
16346
  /**
16347
+ * @deprecated (since 1.119)
16348
+ *
16203
16349
  * Registers a listener for control events.
16204
16350
  *
16205
16351
  * When called, the context of the listener (its `this`) will be bound to `oListener` if specified, otherwise
@@ -16525,6 +16671,9 @@ declare module "sap/ui/core/Core" {
16525
16671
  vFieldGroupIds?: string | string[]
16526
16672
  ): Control[];
16527
16673
  /**
16674
+ * @deprecated (since 1.119) - Please use {@link sap.ui.core.Element.getElementById Element.getElementById }
16675
+ * instead.
16676
+ *
16528
16677
  * Returns the registered element with the given ID, if any.
16529
16678
  *
16530
16679
  * The ID must be the globally unique ID of an element, the same as returned by `oElement.getId()`.
@@ -16603,6 +16752,8 @@ declare module "sap/ui/core/Core" {
16603
16752
  mSettings?: object
16604
16753
  ): Component | Promise<Component>;
16605
16754
  /**
16755
+ * @deprecated (since 1.119)
16756
+ *
16606
16757
  * Returns a new instance of the RenderManager for exclusive use by the caller.
16607
16758
  *
16608
16759
  * The caller must take care to destroy the render manager when it is no longer needed. Calling this method
@@ -16625,6 +16776,8 @@ declare module "sap/ui/core/Core" {
16625
16776
  oDomRef: string | Element
16626
16777
  ): UIArea;
16627
16778
  /**
16779
+ * @deprecated (since 1.119)
16780
+ *
16628
16781
  * Unregisters a listener for control events.
16629
16782
  *
16630
16783
  * The passed function and listener object must match the ones used for event registration.
@@ -16955,6 +17108,10 @@ declare module "sap/ui/core/Core" {
16955
17108
  sId: ID | null | undefined
16956
17109
  ): UI5Element | undefined;
16957
17110
  /**
17111
+ * @deprecated (since 1.119) - Please use {@link sap.ui.core.Element.getActiveElement Element.getActiveElement }
17112
+ * to get the currently focused element. You can then retrieve the ID of that element with {@link sap.ui.core.Element#getId Element#getId}.
17113
+ * Please be aware, {@link sap.ui.core.Element.getActiveElement Element.getActiveElement} can return 'undefined'.
17114
+ *
16958
17115
  * Returns the Id of the control/element currently in focus.
16959
17116
  *
16960
17117
  * @returns the Id of the control/element currently in focus.
@@ -16975,6 +17132,8 @@ declare module "sap/ui/core/Core" {
16975
17132
  ): UI5Element | undefined;
16976
17133
  /**
16977
17134
  * @since 1.8.0
17135
+ * @deprecated (since 1.119.0) - Please use {@link sap.ui.core.EventBus.getInstance EventBus.getInstance }
17136
+ * for global usage instead. Creating an own local instance is the preferred usage.
16978
17137
  *
16979
17138
  * Returns the event bus.
16980
17139
  *
@@ -16982,6 +17141,9 @@ declare module "sap/ui/core/Core" {
16982
17141
  */
16983
17142
  getEventBus(): EventBus;
16984
17143
  /**
17144
+ * @deprecated (since 1.119) - Please use {@link sap.ui.core.Lib.getResourceBundleFor Lib.getResourceBundleFor }
17145
+ * instead.
17146
+ *
16985
17147
  * Retrieves a resource bundle for the given library and locale.
16986
17148
  *
16987
17149
  * If only one argument is given, it is assumed to be the libraryName. The locale then falls back to the
@@ -17029,6 +17191,9 @@ declare module "sap/ui/core/Core" {
17029
17191
  bAsync?: boolean
17030
17192
  ): ResourceBundle | undefined | Promise<ResourceBundle | undefined>;
17031
17193
  /**
17194
+ * @deprecated (since 1.119) - Please use {@link sap.ui.core.Lib.getResourceBundleFor Lib.getResourceBundleFor }
17195
+ * instead.
17196
+ *
17032
17197
  * Retrieves a resource bundle for the given library and locale.
17033
17198
  *
17034
17199
  * If only one argument is given, it is assumed to be the libraryName. The locale then falls back to the
@@ -17072,6 +17237,8 @@ declare module "sap/ui/core/Core" {
17072
17237
  bAsync?: boolean
17073
17238
  ): ResourceBundle | undefined | Promise<ResourceBundle | undefined>;
17074
17239
  /**
17240
+ * @deprecated (since 1.119)
17241
+ *
17075
17242
  * Returns a map of library info objects for all currently loaded libraries, keyed by their names.
17076
17243
  *
17077
17244
  * The structure of the library info objects matches the structure of the info object that the {@link #initLibrary }
@@ -17087,11 +17254,11 @@ declare module "sap/ui/core/Core" {
17087
17254
  getLoadedLibraries(): Record<string, Object>;
17088
17255
  /**
17089
17256
  * @since 1.33.0
17090
- * @deprecated (since 1.119) - Please use {@link sap.ui.core.Messaging Messaging} instead.
17257
+ * @deprecated (since 1.118) - Please use {@link module:sap/ui/core/Messaging Messaging} instead.
17091
17258
  *
17092
- * Returns the active `MessageManager` instance.
17259
+ * Returns the `Messaging` module.
17093
17260
  */
17094
- getMessageManager(): MessageManager;
17261
+ getMessageManager(): Messaging;
17095
17262
  /**
17096
17263
  * @deprecated (since 1.118) - Please use {@link sap.ui.base.ManagedObject#getModel ManagedObject#getModel }
17097
17264
  * instead.
@@ -17128,6 +17295,9 @@ declare module "sap/ui/core/Core" {
17128
17295
  */
17129
17296
  getRootComponent(): Component;
17130
17297
  /**
17298
+ * @deprecated (since 1.119.0) - Please use {@link module:sap/ui/core/StaticArea.getDomRef StaticArea.getDomRef }
17299
+ * instead.
17300
+ *
17131
17301
  * Returns the static, hidden area DOM element belonging to this core instance.
17132
17302
  *
17133
17303
  * It can be used e.g. for hiding elements like Popups, Shadow, Blocklayer etc.
@@ -17147,8 +17317,8 @@ declare module "sap/ui/core/Core" {
17147
17317
  */
17148
17318
  getTemplate(sId: string): Component;
17149
17319
  /**
17150
- * @deprecated (since 1.107) - use {@link sap.ui.core.UIArea.registry#get UIArea.registry#get} instead,
17151
- * but note that `UIArea.registry.get` only accepts the ID of the UIArea as argument.
17320
+ * @deprecated (since 1.107) - For access to the static UIArea, please use the {@link module:sap/ui/core/StaticArea StaticArea }
17321
+ * instead.
17152
17322
  *
17153
17323
  * Returns the {@link sap.ui.core.UIArea UIArea} with the given ID or that belongs to the given DOM element.
17154
17324
  *
@@ -17179,6 +17349,8 @@ declare module "sap/ui/core/Core" {
17179
17349
  */
17180
17350
  hasModel(): boolean;
17181
17351
  /**
17352
+ * @deprecated (since 1.119)
17353
+ *
17182
17354
  * Includes a library theme into the current page (if a variant is specified it will include the variant
17183
17355
  * library theme)
17184
17356
  */
@@ -17197,6 +17369,8 @@ declare module "sap/ui/core/Core" {
17197
17369
  sQuery?: string
17198
17370
  ): void;
17199
17371
  /**
17372
+ * @deprecated (since 1.119) - Please use {@link sap.ui.core.Lib.init Lib.init} instead.
17373
+ *
17200
17374
  * Provides the framework with information about a library.
17201
17375
  *
17202
17376
  * This method is intended to be called exactly once while the main module of a library (its `library.js`
@@ -17289,6 +17463,8 @@ declare module "sap/ui/core/Core" {
17289
17463
  */
17290
17464
  isMobile(): boolean;
17291
17465
  /**
17466
+ * @deprecated (since 1.119.0) - Please use {@link module:sap/ui/core/StaticArea.contains StaticArea.contains }
17467
+ * instead.
17292
17468
  * @ui5-protected Do not call from applications (only from related classes in the framework)
17293
17469
  *
17294
17470
  * Checks whether the given DOM element is the root of the static area.
@@ -17302,6 +17478,9 @@ declare module "sap/ui/core/Core" {
17302
17478
  oDomRef: Element
17303
17479
  ): boolean;
17304
17480
  /**
17481
+ * @deprecated (since 1.119) - Please use {@link module:sap/ui/core/Theming.attachApplied Theming.attachApplied }
17482
+ * instead.
17483
+ *
17305
17484
  * Returns true, if the styles of the current theme are already applied, false otherwise.
17306
17485
  *
17307
17486
  * This function must not be used before the init event of the Core. If the styles are not yet applied a
@@ -17311,6 +17490,8 @@ declare module "sap/ui/core/Core" {
17311
17490
  */
17312
17491
  isThemeApplied(): boolean;
17313
17492
  /**
17493
+ * @deprecated (since 1.119) - Please use {@link sap.ui.core.Lib.load Lib.load} instead.
17494
+ *
17314
17495
  * Loads the given library and its dependencies and makes its content available to the application.
17315
17496
  *
17316
17497
  * What it does:
@@ -17411,6 +17592,9 @@ declare module "sap/ui/core/Core" {
17411
17592
  */
17412
17593
  lock(): void;
17413
17594
  /**
17595
+ * @deprecated (since 1.119) - Please use {@link module:sap/ui/core/Theming.notifyContentDensityChanged Theming.notifyContentDensityChanged }
17596
+ * instead.
17597
+ *
17414
17598
  * Triggers a realignment of controls
17415
17599
  *
17416
17600
  * This method should be called after changing the cozy/compact CSS class of a DOM element at runtime, for
@@ -17502,6 +17686,7 @@ declare module "sap/ui/core/Core" {
17502
17686
  ): void;
17503
17687
  /**
17504
17688
  * @since 1.10
17689
+ * @deprecated (since 1.119)
17505
17690
  *
17506
17691
  * Defines the root directory from below which UI5 should load the theme with the given name. Optionally
17507
17692
  * allows restricting the setting to parts of a theme covering specific control libraries.
@@ -17571,6 +17756,7 @@ declare module "sap/ui/core/Core" {
17571
17756
  ): this;
17572
17757
  /**
17573
17758
  * @since 1.10
17759
+ * @deprecated (since 1.119)
17574
17760
  *
17575
17761
  * Defines the root directory from below which UI5 should load the theme with the given name. Optionally
17576
17762
  * allows restricting the setting to parts of a theme covering specific control libraries.
@@ -19113,7 +19299,7 @@ declare module "sap/ui/core/dnd/DragDropInfo" {
19113
19299
  /**
19114
19300
  * The underlying browser event
19115
19301
  */
19116
- browserEvent?: Event;
19302
+ browserEvent?: DragEvent;
19117
19303
  }
19118
19304
 
19119
19305
  export type DragDropInfo$DragStartEvent = Event<
@@ -19218,7 +19404,7 @@ declare module "sap/ui/core/dnd/DragInfo" {
19218
19404
  * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
19219
19405
  * otherwise it will be bound to this `sap.ui.core.dnd.DragInfo` itself.
19220
19406
  *
19221
- * This event is fired when a drag operation is being ended.
19407
+ * This event is fired when a drag operation is ended.
19222
19408
  *
19223
19409
  * @returns Reference to `this` in order to allow method chaining
19224
19410
  */
@@ -19245,7 +19431,7 @@ declare module "sap/ui/core/dnd/DragInfo" {
19245
19431
  * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
19246
19432
  * otherwise it will be bound to this `sap.ui.core.dnd.DragInfo` itself.
19247
19433
  *
19248
- * This event is fired when a drag operation is being ended.
19434
+ * This event is fired when a drag operation is ended.
19249
19435
  *
19250
19436
  * @returns Reference to `this` in order to allow method chaining
19251
19437
  */
@@ -19412,7 +19598,7 @@ declare module "sap/ui/core/dnd/DragInfo" {
19412
19598
  /**
19413
19599
  * @since 1.56
19414
19600
  *
19415
- * This event is fired when a drag operation is being ended.
19601
+ * This event is fired when a drag operation is ended.
19416
19602
  */
19417
19603
  dragEnd?: (oEvent: DragInfo$DragEndEvent) => void;
19418
19604
  }
@@ -19431,7 +19617,7 @@ declare module "sap/ui/core/dnd/DragInfo" {
19431
19617
  /**
19432
19618
  * The underlying browser event
19433
19619
  */
19434
- browserEvent?: Event;
19620
+ browserEvent?: DragEvent;
19435
19621
  }
19436
19622
 
19437
19623
  export type DragInfo$DragEndEvent = Event<
@@ -19453,7 +19639,7 @@ declare module "sap/ui/core/dnd/DragInfo" {
19453
19639
  /**
19454
19640
  * The underlying browser event
19455
19641
  */
19456
- browserEvent?: Event;
19642
+ browserEvent?: DragEvent;
19457
19643
  }
19458
19644
 
19459
19645
  export type DragInfo$DragStartEvent = Event<
@@ -20107,7 +20293,7 @@ declare module "sap/ui/core/dnd/DropInfo" {
20107
20293
  /**
20108
20294
  * The underlying browser event
20109
20295
  */
20110
- browserEvent?: Event;
20296
+ browserEvent?: DragEvent;
20111
20297
  }
20112
20298
 
20113
20299
  export type DropInfo$DragEnterEvent = Event<
@@ -20127,7 +20313,7 @@ declare module "sap/ui/core/dnd/DropInfo" {
20127
20313
  dragSession?: DragSession;
20128
20314
 
20129
20315
  /**
20130
- * The calculated position of the drop action relative to the `target`.
20316
+ * The calculated position of the drop action relative to the `target`
20131
20317
  */
20132
20318
  dropPosition?:
20133
20319
  | dnd.RelativeDropPosition
@@ -20136,7 +20322,7 @@ declare module "sap/ui/core/dnd/DropInfo" {
20136
20322
  /**
20137
20323
  * The underlying browser event
20138
20324
  */
20139
- browserEvent?: Event;
20325
+ browserEvent?: DragEvent;
20140
20326
  }
20141
20327
 
20142
20328
  export type DropInfo$DragOverEvent = Event<
@@ -20161,7 +20347,7 @@ declare module "sap/ui/core/dnd/DropInfo" {
20161
20347
  droppedControl?: UI5Element;
20162
20348
 
20163
20349
  /**
20164
- * The calculated position of the drop action relative to the `droppedControl`.
20350
+ * The calculated position of the drop action relative to the `droppedControl`
20165
20351
  */
20166
20352
  dropPosition?:
20167
20353
  | dnd.RelativeDropPosition
@@ -20170,7 +20356,7 @@ declare module "sap/ui/core/dnd/DropInfo" {
20170
20356
  /**
20171
20357
  * The underlying browser event
20172
20358
  */
20173
- browserEvent?: Event;
20359
+ browserEvent?: DragEvent;
20174
20360
  }
20175
20361
 
20176
20362
  export type DropInfo$DropEvent = Event<
@@ -20197,12 +20383,12 @@ declare module "sap/ui/core/Element" {
20197
20383
 
20198
20384
  import ContextBinding from "sap/ui/model/ContextBinding";
20199
20385
 
20386
+ import { ID } from "sap/ui/core/library";
20387
+
20200
20388
  import LayoutData from "sap/ui/core/LayoutData";
20201
20389
 
20202
20390
  import TooltipBase from "sap/ui/core/TooltipBase";
20203
20391
 
20204
- import { ID } from "sap/ui/core/library";
20205
-
20206
20392
  /**
20207
20393
  * Base Class for UI Elements.
20208
20394
  *
@@ -20381,7 +20567,7 @@ declare module "sap/ui/core/Element" {
20381
20567
  * to `data-sap-ui`
20382
20568
  */
20383
20569
  bIncludeRelated?: boolean
20384
- ): UI5Element;
20570
+ ): UI5Element | undefined;
20385
20571
  /**
20386
20572
  * @deprecated (since 1.3.1) - Use the static `extend` method of the desired base class (e.g. {@link sap.ui.core.Element.extend})
20387
20573
  *
@@ -20448,6 +20634,28 @@ declare module "sap/ui/core/Element" {
20448
20634
  */
20449
20635
  FNMetaImpl?: Function
20450
20636
  ): Function;
20637
+ /**
20638
+ * @since 1.119
20639
+ *
20640
+ * Returns the element currently in focus.
20641
+ *
20642
+ * @returns The currently focused element
20643
+ */
20644
+ static getActiveElement(): UI5Element | undefined;
20645
+ /**
20646
+ * Retrieves an Element by its ID.
20647
+ *
20648
+ * When the ID is `null` or `undefined` or when there's no element with the given ID, then `undefined` is
20649
+ * returned.
20650
+ *
20651
+ * @returns Element with the given ID or `undefined`
20652
+ */
20653
+ static getElementById(
20654
+ /**
20655
+ * ID of the element to retrieve
20656
+ */
20657
+ id: ID
20658
+ ): UI5Element | undefined;
20451
20659
  /**
20452
20660
  * Returns a metadata object for class sap.ui.core.Element.
20453
20661
  *
@@ -21350,20 +21558,6 @@ declare module "sap/ui/core/Element" {
21350
21558
  */
21351
21559
  thisArg?: Object
21352
21560
  ): void;
21353
- /**
21354
- * Retrieves an Element by its ID.
21355
- *
21356
- * When the ID is `null` or `undefined` or when there's no element with the given ID, then `undefined` is
21357
- * returned.
21358
- *
21359
- * @returns Element with the given ID or `undefined`
21360
- */
21361
- get(
21362
- /**
21363
- * ID of the element to retrieve
21364
- */
21365
- id: ID
21366
- ): UI5Element | undefined;
21367
21561
  }
21368
21562
  export const registry: registry;
21369
21563
 
@@ -21531,6 +21725,14 @@ declare module "sap/ui/core/EventBus" {
21531
21725
  */
21532
21726
  FNMetaImpl?: Function
21533
21727
  ): Function;
21728
+ /**
21729
+ * @since 1.119.0
21730
+ *
21731
+ * Returns the singleton instance of the EventBus for global usage.
21732
+ *
21733
+ * @returns the event bus
21734
+ */
21735
+ static getInstance(): EventBus;
21534
21736
  /**
21535
21737
  * Returns a metadata object for class sap.ui.core.EventBus.
21536
21738
  *
@@ -26403,17 +26605,11 @@ declare module "sap/ui/core/Lib" {
26403
26605
  /**
26404
26606
  * @since 1.118
26405
26607
  *
26406
- * Library Loading: To load a library, {@link #.load} can be used directly without creating a library instance
26407
- * in advance.
26608
+ * Constructor must not be used: To load a library, please use the static method {@link #.load}.
26408
26609
  *
26409
- * What a library does:
26410
- * - preload: {@link #preload} loads the library-preload bundle and its resource bundle and apply the
26411
- * same for its dependencies
26412
- * - theming: {@link #_includeTheme} creates a <link> in the page referring to the corresponding
26413
- * `library.css`
26414
- * - resource bundle: {@link #getResourceBundle} returns the resource bundle directly when it's already
26415
- * loaded or triggers a synchronous request to load it. {@link #loadResourceBundle} loads a library's resource
26416
- * bundle file asynchronously. The resource bundle file is also loaded when the `preload` function is called
26610
+ * This class also provides other static methods which are related to a library, such as {@link #.getResourceBundleFor }
26611
+ * to retrieve the resource bundle of a library, {@link #.init} to provide information for a library and
26612
+ * so on.
26417
26613
  */
26418
26614
  export default class Lib extends BaseObject {
26419
26615
  constructor();
@@ -26450,9 +26646,26 @@ declare module "sap/ui/core/Lib" {
26450
26646
  /**
26451
26647
  * Retrieves a resource bundle for the given library and locale.
26452
26648
  *
26649
+ * This method returns the resource bundle directly. When the resource bundle for the given locale isn't
26650
+ * loaded yet, synchronous request will be used to load the resource bundle.
26651
+ *
26453
26652
  * If only one argument is given, it is assumed to be the library name. The locale then falls back to the
26454
26653
  * current {@link sap.ui.core.Configuration#getLanguage session locale}.
26455
26654
  *
26655
+ * Configuration via App Descriptor: When the App Descriptor for the library is available without further
26656
+ * request (manifest.json has been preloaded) and when the App Descriptor is at least of version 1.9.0 or
26657
+ * higher, then this method will evaluate the App Descriptor entry `"sap.ui5" / "library" / "i18n"`.
26658
+ *
26659
+ * - When the entry is `true`, a bundle with the default name "messagebundle.properties" will be loaded
26660
+ *
26661
+ * - If it is a string, then that string will be used as name of the bundle
26662
+ * - If it is `false`, no bundle will be loaded and the result will be `undefined`
26663
+ *
26664
+ * Caching: Once a resource bundle for a library has been loaded, it will be cached. Further calls for the
26665
+ * same locale won't create new requests, but return the already loaded bundle. There's therefore no need
26666
+ * for control code to cache the returned bundle for a longer period of time. Not further caching the result
26667
+ * also prevents stale texts after a locale change.
26668
+ *
26456
26669
  * @returns The best matching resource bundle for the given parameters or `undefined`
26457
26670
  */
26458
26671
  static getResourceBundleFor(
@@ -28952,20 +29165,37 @@ declare module "sap/ui/core/message/Message" {
28952
29165
  declare module "sap/ui/core/message/MessageManager" {
28953
29166
  import BaseObject from "sap/ui/base/Object";
28954
29167
 
29168
+ import Message from "sap/ui/core/message/Message";
29169
+
29170
+ import MessageModel from "sap/ui/model/message/MessageModel";
29171
+
28955
29172
  import Metadata from "sap/ui/base/Metadata";
28956
29173
 
29174
+ import MessageProcessor from "sap/ui/core/message/MessageProcessor";
29175
+
29176
+ import ManagedObject from "sap/ui/base/ManagedObject";
29177
+
28957
29178
  /**
28958
- * @deprecated (since 1.118) - Please use {@link sap.ui.core.Messaging Messaging} instead.
29179
+ * @deprecated (since 1.118) - Please use {@link module:sap/ui/core/Messaging Messaging} instead.
28959
29180
  */
28960
29181
  export default class MessageManager extends BaseObject {
28961
29182
  /**
28962
29183
  * Constructor for a new MessageManager.
28963
29184
  *
28964
- * Creating own instances of MessageManager is deprecated. Please require 'sap/ui/core/Messaging' instead
28965
- * and use the module export directly without using 'new'.
29185
+ * Creating own instances of MessageManager is deprecated. Please require {@link module:sap/ui/core/Messaging 'sap/ui/core/Messaging' }
29186
+ * instead and use the module export directly without using 'new'.
28966
29187
  */
28967
29188
  constructor();
28968
29189
 
29190
+ /**
29191
+ * Add messages to Messaging
29192
+ */
29193
+ static addMessages(
29194
+ /**
29195
+ * Array of sap.ui.core.message.Message or single sap.ui.core.message.Message
29196
+ */
29197
+ vMessages: Message | Message[]
29198
+ ): void;
28969
29199
  /**
28970
29200
  * Creates a new subclass of class sap.ui.core.message.MessageManager with name `sClassName` and enriches
28971
29201
  * it with the information contained in `oClassInfo`.
@@ -28989,12 +29219,90 @@ declare module "sap/ui/core/message/MessageManager" {
28989
29219
  */
28990
29220
  FNMetaImpl?: Function
28991
29221
  ): Function;
29222
+ /**
29223
+ * Get the MessageModel
29224
+ *
29225
+ * @returns oMessageModel The Message Model
29226
+ */
29227
+ static getMessageModel(): MessageModel;
28992
29228
  /**
28993
29229
  * Returns a metadata object for class sap.ui.core.message.MessageManager.
28994
29230
  *
28995
29231
  * @returns Metadata object describing this class
28996
29232
  */
28997
29233
  static getMetadata(): Metadata;
29234
+ /**
29235
+ * Register MessageProcessor
29236
+ */
29237
+ static registerMessageProcessor(
29238
+ /**
29239
+ * The MessageProcessor
29240
+ */
29241
+ oProcessor: MessageProcessor
29242
+ ): void;
29243
+ /**
29244
+ * When using the databinding type system, the validation/parsing of a new property value could fail. In
29245
+ * this case, a validationError/parseError event is fired. These events bubble up to the core. For registered
29246
+ * ManagedObjects, the Messaging attaches to these events and creates a `sap.ui.core.message.Message` (bHandleValidation=true)
29247
+ * for each of these errors and cancels the event bubbling.
29248
+ */
29249
+ static registerObject(
29250
+ /**
29251
+ * The sap.ui.base.ManagedObject
29252
+ */
29253
+ oObject: ManagedObject,
29254
+ /**
29255
+ * Handle validationError/parseError events for this object. If set to true, the Messaging creates a Message
29256
+ * for each validation/parse error. The event bubbling is canceled in every case.
29257
+ */
29258
+ bHandleValidation: boolean
29259
+ ): void;
29260
+ /**
29261
+ * Remove all messages
29262
+ */
29263
+ static removeAllMessages(): void;
29264
+ /**
29265
+ * Remove given Messages
29266
+ */
29267
+ static removeMessages(
29268
+ /**
29269
+ * The message(s) to be removed.
29270
+ */
29271
+ vMessages: Message | Message[]
29272
+ ): void;
29273
+ /**
29274
+ * Deregister MessageProcessor
29275
+ */
29276
+ static unregisterMessageProcessor(
29277
+ /**
29278
+ * The MessageProcessor
29279
+ */
29280
+ oProcessor: MessageProcessor
29281
+ ): void;
29282
+ /**
29283
+ * Unregister ManagedObject
29284
+ */
29285
+ static unregisterObject(
29286
+ /**
29287
+ * The sap.ui.base.ManagedObject
29288
+ */
29289
+ oObject: ManagedObject
29290
+ ): void;
29291
+ /**
29292
+ * Update Messages by providing two arrays of old and new messages.
29293
+ *
29294
+ * The old ones will be removed, the new ones will be added.
29295
+ */
29296
+ static updateMessages(
29297
+ /**
29298
+ * Array of old messages to be removed
29299
+ */
29300
+ aOldMessages: Message[],
29301
+ /**
29302
+ * Array of new messages to be added
29303
+ */
29304
+ aNewMessages: Message[]
29305
+ ): void;
28998
29306
  }
28999
29307
  }
29000
29308
 
@@ -29191,7 +29499,7 @@ declare module "sap/ui/core/message/MessageProcessor" {
29191
29499
  oListener?: object
29192
29500
  ): this;
29193
29501
  /**
29194
- * @deprecated - 1.115 Use {@link sap.ui.core.Messaging#updateMessages} instead
29502
+ * @deprecated (since 1.115) - Use {@link module:sap/ui/core/Messaging.updateMessages} instead
29195
29503
  * @ui5-protected Do not call from applications (only from related classes in the framework)
29196
29504
  *
29197
29505
  * Fires event {@link #event:messageChange messageChange} to attached listeners.
@@ -29239,35 +29547,6 @@ declare module "sap/ui/core/message/MessageProcessor" {
29239
29547
  >;
29240
29548
  }
29241
29549
 
29242
- declare module "sap/ui/core/message/MessageType" {
29243
- /**
29244
- * Specifies possible message types.
29245
- */
29246
- enum MessageType {
29247
- /**
29248
- * Message is an error
29249
- */
29250
- Error = "Error",
29251
- /**
29252
- * Message should be just an information
29253
- */
29254
- Information = "Information",
29255
- /**
29256
- * Message has no specific level
29257
- */
29258
- None = "None",
29259
- /**
29260
- * Message is a success message
29261
- */
29262
- Success = "Success",
29263
- /**
29264
- * Message is a warning
29265
- */
29266
- Warning = "Warning",
29267
- }
29268
- export default MessageType;
29269
- }
29270
-
29271
29550
  declare module "sap/ui/core/mvc/Controller" {
29272
29551
  import EventProvider from "sap/ui/base/EventProvider";
29273
29552
 
@@ -30701,7 +30980,7 @@ declare module "sap/ui/core/mvc/View" {
30701
30980
  * Returns an element by its ID in the context of this view.
30702
30981
  *
30703
30982
  * This method expects a view-local ID of an element (the same as e.g. defined in the *.view.xml of an XMLView).
30704
- * For a search with a global ID (the value returned by `oElement.getId()`) you should rather use {@link sap.ui.core.Core#byId sap.ui.getCore().byId()}.
30983
+ * For a search with a global ID (the value returned by `oElement.getId()`) you should rather use {@link sap.ui.core.Element#getElementById Element.getElementById}.
30705
30984
  *
30706
30985
  * @returns Element by its ID or `undefined`
30707
30986
  */
@@ -32888,16 +33167,6 @@ declare module "sap/ui/core/RenderManager" {
32888
33167
  * rendering optimization.
32889
33168
  */
32890
33169
  export default class RenderManager extends Object {
32891
- /**
32892
- * Creates an instance of the RenderManager.
32893
- *
32894
- * Applications or controls must not call the `RenderManager` constructor on their own but should use the
32895
- * {@link sap.ui.core.Core#createRenderManager sap.ui.getCore().createRenderManager()} method to create
32896
- * an instance for their exclusive use.
32897
- * See:
32898
- * sap.ui.core.Core
32899
- * sap.ui.getCore
32900
- */
32901
33170
  constructor();
32902
33171
 
32903
33172
  /**
@@ -48836,6 +49105,8 @@ declare module "sap/ui/model/ClientListBinding" {
48836
49105
  declare module "sap/ui/model/ClientModel" {
48837
49106
  import Model from "sap/ui/model/Model";
48838
49107
 
49108
+ import PropertyBinding from "sap/ui/model/PropertyBinding";
49109
+
48839
49110
  import Metadata from "sap/ui/base/Metadata";
48840
49111
 
48841
49112
  /**
@@ -48881,6 +49152,41 @@ declare module "sap/ui/model/ClientModel" {
48881
49152
  * @returns Metadata object describing this class
48882
49153
  */
48883
49154
  static getMetadata(): Metadata;
49155
+ /**
49156
+ * Creates a new property binding for this model.
49157
+ * See:
49158
+ * sap.ui.model.Model#bindProperty
49159
+ * #getProperty
49160
+ *
49161
+ * @returns The new property binding
49162
+ */
49163
+ bindProperty(
49164
+ /**
49165
+ * The path pointing to the property that should be bound; either an absolute path or a path relative to
49166
+ * a given `oContext`
49167
+ */
49168
+ sPath: string,
49169
+ /**
49170
+ * A context object for the new binding
49171
+ */
49172
+ oContext?: object,
49173
+ /**
49174
+ * Map of optional parameters for the binding
49175
+ */
49176
+ mParameters?: {
49177
+ /**
49178
+ * Whether this binding does not propagate model messages to the control; supported since 1.119.0. Some
49179
+ * composite types like {@link sap.ui.model.type.Currency} automatically ignore model messages for some
49180
+ * of their parts depending on their format options; setting this parameter to `true` or `false` overrules
49181
+ * the automatism of the type.
49182
+ *
49183
+ * For example, a binding for a currency code is used in a composite binding for rendering the proper number
49184
+ * of decimals, but the currency code is not displayed in the attached control. In that case, messages for
49185
+ * the currency code shall not be displayed at that control, only messages for the amount.
49186
+ */
49187
+ ignoreMessages?: boolean;
49188
+ }
49189
+ ): PropertyBinding;
48884
49190
  /**
48885
49191
  * See:
48886
49192
  * sap.ui.model.Model.prototype.destroy
@@ -48993,6 +49299,17 @@ declare module "sap/ui/model/ClientPropertyBinding" {
48993
49299
  * @returns Metadata object describing this class
48994
49300
  */
48995
49301
  static getMetadata(): Metadata;
49302
+ /**
49303
+ * @since 1.119.0
49304
+ *
49305
+ * Returns `true`, as this binding supports the feature of not propagating model messages to the control.
49306
+ * See:
49307
+ * sap.ui.model.Binding#getIgnoreMessages
49308
+ * sap.ui.model.Binding#setIgnoreMessages
49309
+ *
49310
+ * @returns `true`
49311
+ */
49312
+ supportsIgnoreMessages(): boolean;
48996
49313
  }
48997
49314
  }
48998
49315
 
@@ -50394,7 +50711,8 @@ declare module "sap/ui/model/Filter" {
50394
50711
  */
50395
50712
  vOperator?:
50396
50713
  | (FilterOperator | keyof typeof FilterOperator)
50397
- | ((p1: any) => boolean | boolean),
50714
+ | boolean
50715
+ | ((p1: any) => boolean),
50398
50716
  /**
50399
50717
  * First value to use with the given filter operator
50400
50718
  */
@@ -51541,8 +51859,6 @@ declare module "sap/ui/model/ListBinding" {
51541
51859
  declare module "sap/ui/model/message/MessageModel" {
51542
51860
  import ClientModel from "sap/ui/model/ClientModel";
51543
51861
 
51544
- import MessageManager from "sap/ui/core/message/MessageManager";
51545
-
51546
51862
  import Metadata from "sap/ui/base/Metadata";
51547
51863
 
51548
51864
  import Context from "sap/ui/model/Context";
@@ -51556,12 +51872,7 @@ declare module "sap/ui/model/message/MessageModel" {
51556
51872
  /**
51557
51873
  * Constructor for a new JSONModel.
51558
51874
  */
51559
- constructor(
51560
- /**
51561
- * The MessageManager instance
51562
- */
51563
- oMessageManager: MessageManager
51564
- );
51875
+ constructor();
51565
51876
 
51566
51877
  /**
51567
51878
  * Creates a new subclass of class sap.ui.model.message.MessageModel with name `sClassName` and enriches
@@ -57916,8 +58227,6 @@ declare module "sap/ui/model/odata/type/DateTimeWithTimezone" {
57916
58227
  */
57917
58228
  getPartsIgnoringMessages(): number[];
57918
58229
  /**
57919
- * @experimental (since 1.114.0)
57920
- *
57921
58230
  * Returns a language-dependent placeholder text such as "e.g. " where is formatted
57922
58231
  * using this type.
57923
58232
  *
@@ -58904,8 +59213,6 @@ declare module "sap/ui/model/odata/type/ODataType" {
58904
59213
  */
58905
59214
  static getMetadata(): Metadata;
58906
59215
  /**
58907
- * @experimental (since 1.114.0)
58908
- *
58909
59216
  * Returns a language-dependent placeholder text such as "e.g. " where is formatted
58910
59217
  * using this type.
58911
59218
  *
@@ -61572,9 +61879,12 @@ declare module "sap/ui/model/odata/v2/ODataModel" {
61572
61879
  */
61573
61880
  serviceUrlParams?: Record<string, string>;
61574
61881
  /**
61575
- * Enable/disable security token handling
61882
+ * Enable/disable security token handling. If the "skipServerCache" string value is provided, the security
61883
+ * token is not cached with the server as key in order to avoid failing $batch requests when accessing services
61884
+ * running on different back-end systems behind a reverse proxy (since 1.119).
61885
+ * Use this option only if the system landscape is known.
61576
61886
  */
61577
- tokenHandling?: boolean;
61887
+ tokenHandling?: boolean | "skipServerCache";
61578
61888
  /**
61579
61889
  * Send security token for GET requests in case read access logging is activated for the OData Service in
61580
61890
  * the backend.
@@ -63226,13 +63536,14 @@ declare module "sap/ui/model/odata/v2/ODataModel" {
63226
63536
  */
63227
63537
  getRefreshAfterChange(): boolean;
63228
63538
  /**
63229
- * Returns the current security token.
63539
+ * @deprecated (since 1.119.0) - use {@link #securityTokenAvailable} instead
63230
63540
  *
63231
- * If the token has not been requested from the server it will be requested first (synchronously).
63541
+ * Returns the current security token if available; triggers a request to fetch the security token if it
63542
+ * is not available.
63232
63543
  *
63233
- * @returns The security token
63544
+ * @returns The security token; `undefined` if it is not available
63234
63545
  */
63235
- getSecurityToken(): string;
63546
+ getSecurityToken(): string | undefined;
63236
63547
  /**
63237
63548
  * Return the annotation object. Please note that the metadata is loaded asynchronously and this function
63238
63549
  * might return undefined because the metadata has not been loaded yet. In this case attach to the `annotationsLoaded`
@@ -65433,6 +65744,31 @@ declare module "sap/ui/model/odata/v4/Context" {
65433
65744
  * `undefined` if it is not created using {@link sap.ui.model.odata.v4.ODataListBinding#create}
65434
65745
  */
65435
65746
  isTransient(): boolean | undefined;
65747
+ /**
65748
+ * @experimental (since 1.119.0)
65749
+ *
65750
+ * Moves this node to the given parent (in case of a recursive hierarchy, see {@link #setAggregation}, where
65751
+ * `oAggregation.expandTo` must be one). No other {@link sap.ui.model.odata.v4.ODataListBinding#create creation},
65752
+ * {@link #delete deletion}, or move must be pending, and no other modification (including collapse of some
65753
+ * ancestor node) must happen while this move is pending!
65754
+ *
65755
+ * This context's {@link #getIndex index} may change and it becomes "created persisted", with {@link #isTransient }
65756
+ * returning `false` etc.
65757
+ *
65758
+ * @returns A promise which is resolved without a defined result when the move is finished, or rejected
65759
+ * in case of an error
65760
+ */
65761
+ move(
65762
+ /**
65763
+ * A parameter object
65764
+ */
65765
+ oParameters: {
65766
+ /**
65767
+ * The new parent's context
65768
+ */
65769
+ parent: Context;
65770
+ }
65771
+ ): Promise<void>;
65436
65772
  /**
65437
65773
  * @since 1.53.0
65438
65774
  *
@@ -66001,13 +66337,21 @@ declare module "sap/ui/model/odata/v4/ODataContextBinding" {
66001
66337
  * also rejected if `bReplaceWithRVC` is supplied, and there is no return value context at all or the existing
66002
66338
  * context as described above is currently part of the list's collection (that is, has an index).
66003
66339
  * A return value context is an {@link sap.ui.model.odata.v4.Context} which represents a bound operation
66004
- * response. It is created only if the operation is bound and has a single entity return value from the
66005
- * same entity set as the operation's binding parameter and has a parent context which is an {@link sap.ui.model.odata.v4.Context }
66006
- * and points to an entity from an entity set. It is destroyed the next time this operation binding is executed
66007
- * again!
66340
+ * response. It is created only if the operation is bound and these conditions apply:
66341
+ * The operation has a single entity return value from the same entity set as the operation's binding
66342
+ * parameter. It has a parent context which is an {@link sap.ui.model.odata.v4.Context} and points
66343
+ * to (an entity from) an entity set. The path of the parent context must not contain a navigation property
66344
+ * (but see last paragraph). **Note:** A return value context is destroyed the next time the operation
66345
+ * binding is executed again.
66008
66346
  * If a return value context is created, it must be used instead of `this.getBoundContext()`. All bound
66009
66347
  * messages will be related to the return value context only. Such a message can only be connected to a
66010
66348
  * corresponding control if the control's property bindings use the return value context as binding context.
66349
+ *
66350
+ * A return value context may also be provided if the parent context's path contains a maximum of one navigation
66351
+ * property. In addition to the existing preconditions for a return value context, the metadata has to specify
66352
+ * a partner attribute for the navigation property and the partner relationship has to be bi-directional.
66353
+ * Also the navigation property binding has to be available in the entity set of the first segment in the
66354
+ * parent context's path (@experimental as of version 1.119.0).
66011
66355
  */
66012
66356
  execute(
66013
66357
  /**
@@ -66593,8 +66937,8 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
66593
66937
  * (see {@link #setAggregation}). The parent node must be identified via a {@link sap.ui.model.odata.v4.Context }
66594
66938
  * instance given as `oInitialData["@$ui5.node.parent"]`. `oAggregation.expandTo` (see {@link #setAggregation})
66595
66939
  * must be one, `bSkipRefresh` must be set, but both `bAtEnd` and `bInactive` must not be set. No other
66596
- * creation must be pending, and no other modification (including collapse of some ancestor node) must happen
66597
- * while this creation is pending!
66940
+ * creation or {@link sap.ui.model.odata.v4.Context#move move} must be pending, and no other modification
66941
+ * (including collapse of some ancestor node) must happen while this creation is pending!
66598
66942
  *
66599
66943
  * @returns The context object for the created entity; its method {@link sap.ui.model.odata.v4.Context#created }
66600
66944
  * returns a promise that is resolved when the creation is finished
@@ -66783,8 +67127,10 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
66783
67127
  * identified via the `hierarchyQualifier` given to {@link #setAggregation}.
66784
67128
  * "$DistanceFromRootProperty" holds the path to the property which provides the raw value for "@$ui5.node.level"
66785
67129
  * (minus one) and should be used only to interpret the response retrieved via {@link #getDownloadUrl}.
66786
- * "$NodeProperty" holds the path to the property which provides the hierarchy node value. That property
66787
- * is always $select'ed automatically and can be accessed as usual.
67130
+ * "$DrillStateProperty" holds the path to the property which provides the raw value for "@$ui5.node.isExpanded"
67131
+ * and should be used only to interpret the response retrieved via {@link #getDownloadUrl}. "$NodeProperty"
67132
+ * holds the path to the property which provides the hierarchy node value. That property is always $select'ed
67133
+ * automatically and can be accessed as usual.
66788
67134
  */
66789
67135
  bVerbose?: boolean
66790
67136
  ): object | undefined;
@@ -71952,8 +72298,6 @@ declare module "sap/ui/model/type/Date" {
71952
72298
  */
71953
72299
  getOutputPattern(): string;
71954
72300
  /**
71955
- * @experimental (since 1.114.0)
71956
- *
71957
72301
  * Returns a language-dependent placeholder text such as "e.g. " where is formatted
71958
72302
  * using this type.
71959
72303
  *
@@ -72089,8 +72433,6 @@ declare module "sap/ui/model/type/DateInterval" {
72089
72433
  sTargetType: string
72090
72434
  ): string;
72091
72435
  /**
72092
- * @experimental (since 1.114.0)
72093
- *
72094
72436
  * Returns a language-dependent placeholder text such as "e.g. " where is formatted
72095
72437
  * using this type.
72096
72438
  *
@@ -82233,6 +82575,8 @@ declare namespace sap {
82233
82575
 
82234
82576
  "sap/ui/core/Fragment": undefined;
82235
82577
 
82578
+ "sap/ui/core/getCompatibilityVersion": undefined;
82579
+
82236
82580
  "sap/ui/core/History": undefined;
82237
82581
 
82238
82582
  "sap/ui/core/HTML": undefined;