@openui5/types 1.120.1 → 1.120.3

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.120.1
283
+ // For Library Version: 1.120.3
284
284
 
285
285
  declare module "sap/base/assert" {
286
286
  /**
@@ -3595,6 +3595,122 @@ declare module "sap/ui/core/AnimationMode" {
3595
3595
  export default AnimationMode;
3596
3596
  }
3597
3597
 
3598
+ declare module "sap/ui/core/ComponentRegistry" {
3599
+ import { ID } from "sap/ui/core/library";
3600
+
3601
+ import Component from "sap/ui/core/Component";
3602
+
3603
+ /**
3604
+ * @since 1.120
3605
+ *
3606
+ * Registry of all `Component`s that currently exist.
3607
+ */
3608
+ interface ComponentRegistry {
3609
+ /**
3610
+ * Number of existing components.
3611
+ */
3612
+ size: int;
3613
+
3614
+ /**
3615
+ * Return an object with all instances of `sap.ui.core.Component`, keyed by their ID.
3616
+ *
3617
+ * Each call creates a new snapshot object. Depending on the size of the UI, this operation therefore might
3618
+ * be expensive. Consider to use the `forEach` or `filter` method instead of executing similar operations
3619
+ * on the returned object.
3620
+ *
3621
+ * **Note**: The returned object is created by a call to `Object.create(null)`, and therefore lacks all
3622
+ * methods of `Object.prototype`, e.g. `toString` etc.
3623
+ *
3624
+ * @returns Object with all components, keyed by their ID
3625
+ */
3626
+ all(): Record<ID, Component>;
3627
+ /**
3628
+ * Returns an array with components for which the given `callback` returns a value that coerces to `true`.
3629
+ *
3630
+ * The expected signature of the callback is
3631
+ * ```javascript
3632
+ *
3633
+ * function callback(oComponent, sID)
3634
+ * ```
3635
+ * where `oComponent` is the currently visited component instance and `sID` is the ID of that instance.
3636
+ *
3637
+ * If components are created or destroyed within the `callback`, then the behavior is not specified. Newly
3638
+ * added objects might or might not be visited. When a component is destroyed during the filtering and was
3639
+ * not visited yet, it might or might not be visited. As the behavior for such concurrent modifications
3640
+ * is not specified, it may change in newer releases.
3641
+ *
3642
+ * If a `thisArg` is given, it will be provided as `this` context when calling `callback`. The `this` value
3643
+ * that the implementation of `callback` sees, depends on the usual resolution mechanism. E.g. when `callback`
3644
+ * was bound to some context object, that object wins over the given `thisArg`.
3645
+ *
3646
+ * This function returns an array with all components matching the given predicate. The order of the components
3647
+ * in the array is not specified and might change between calls (over time and across different versions
3648
+ * of UI5).
3649
+ *
3650
+ * @returns Array of components matching the predicate; order is undefined and might change in newer versions
3651
+ * of UI5
3652
+ */
3653
+ filter(
3654
+ /**
3655
+ * predicate against which each Component is tested
3656
+ */
3657
+ callback: (p1: Component, p2: ID) => boolean,
3658
+ /**
3659
+ * context object to provide as `this` in each call of `callback`
3660
+ */
3661
+ thisArg?: Object
3662
+ ): Component[];
3663
+ /**
3664
+ * Calls the given `callback` for each existing component.
3665
+ *
3666
+ * The expected signature of the callback is
3667
+ * ```javascript
3668
+ *
3669
+ * function callback(oComponent, sID)
3670
+ * ```
3671
+ * where `oComponent` is the currently visited component instance and `sID` is the ID of that instance.
3672
+ *
3673
+ * The order in which the callback is called for components is not specified and might change between calls
3674
+ * (over time and across different versions of UI5).
3675
+ *
3676
+ * If components are created or destroyed within the `callback`, then the behavior is not specified. Newly
3677
+ * added objects might or might not be visited. When a component is destroyed during the filtering and was
3678
+ * not visited yet, it might or might not be visited. As the behavior for such concurrent modifications
3679
+ * is not specified, it may change in newer releases.
3680
+ *
3681
+ * If a `thisArg` is given, it will be provided as `this` context when calling `callback`. The `this` value
3682
+ * that the implementation of `callback` sees, depends on the usual resolution mechanism. E.g. when `callback`
3683
+ * was bound to some context object, that object wins over the given `thisArg`.
3684
+ */
3685
+ forEach(
3686
+ /**
3687
+ * Function to call for each Component
3688
+ */
3689
+ callback: (p1: Component, p2: ID) => void,
3690
+ /**
3691
+ * Context object to provide as `this` in each call of `callback`
3692
+ */
3693
+ thisArg?: Object
3694
+ ): void;
3695
+ /**
3696
+ * Retrieves a Component by its ID.
3697
+ *
3698
+ * When the ID is `null` or `undefined` or when there's no Component with the given ID, then `undefined`
3699
+ * is returned.
3700
+ *
3701
+ * @returns Component with the given ID or `undefined`
3702
+ */
3703
+ get(
3704
+ /**
3705
+ * ID of the Component to retrieve
3706
+ */
3707
+ id: ID
3708
+ ): Component | undefined;
3709
+ }
3710
+ const ComponentRegistry: ComponentRegistry;
3711
+ export default ComponentRegistry;
3712
+ }
3713
+
3598
3714
  declare module "sap/ui/core/ComponentSupport" {
3599
3715
  /**
3600
3716
  * @since 1.58.0
@@ -4358,6 +4474,122 @@ declare module "sap/ui/core/date/UI5Date" {
4358
4474
  }
4359
4475
  }
4360
4476
 
4477
+ declare module "sap/ui/core/ElementRegistry" {
4478
+ import { ID } from "sap/ui/core/library";
4479
+
4480
+ import UI5Element from "sap/ui/core/Element";
4481
+
4482
+ /**
4483
+ * @since 1.120
4484
+ *
4485
+ * Registry of all `sap.ui.core.Element`s that currently exist.
4486
+ */
4487
+ interface ElementRegistry {
4488
+ /**
4489
+ * Number of existing elements.
4490
+ */
4491
+ size: int;
4492
+
4493
+ /**
4494
+ * Return an object with all instances of `sap.ui.core.Element`, keyed by their ID.
4495
+ *
4496
+ * Each call creates a new snapshot object. Depending on the size of the UI, this operation therefore might
4497
+ * be expensive. Consider to use the `forEach` or `filter` method instead of executing similar operations
4498
+ * on the returned object.
4499
+ *
4500
+ * **Note**: The returned object is created by a call to `Object.create(null)`, and therefore lacks all
4501
+ * methods of `Object.prototype`, e.g. `toString` etc.
4502
+ *
4503
+ * @returns Object with all elements, keyed by their ID
4504
+ */
4505
+ all(): Record<ID, UI5Element>;
4506
+ /**
4507
+ * Returns an array with elements for which the given `callback` returns a value that coerces to `true`.
4508
+ *
4509
+ * The expected signature of the callback is
4510
+ * ```javascript
4511
+ *
4512
+ * function callback(oElement, sID)
4513
+ * ```
4514
+ * where `oElement` is the currently visited element instance and `sID` is the ID of that instance.
4515
+ *
4516
+ * If elements are created or destroyed within the `callback`, then the behavior is not specified. Newly
4517
+ * added objects might or might not be visited. When an element is destroyed during the filtering and was
4518
+ * not visited yet, it might or might not be visited. As the behavior for such concurrent modifications
4519
+ * is not specified, it may change in newer releases.
4520
+ *
4521
+ * If a `thisArg` is given, it will be provided as `this` context when calling `callback`. The `this` value
4522
+ * that the implementation of `callback` sees, depends on the usual resolution mechanism. E.g. when `callback`
4523
+ * was bound to some context object, that object wins over the given `thisArg`.
4524
+ *
4525
+ * This function returns an array with all elements matching the given predicate. The order of the elements
4526
+ * in the array is not specified and might change between calls (over time and across different versions
4527
+ * of UI5).
4528
+ *
4529
+ * @returns Array of elements matching the predicate; order is undefined and might change in newer versions
4530
+ * of UI5
4531
+ */
4532
+ filter(
4533
+ /**
4534
+ * predicate against which each element is tested
4535
+ */
4536
+ callback: (p1: UI5Element, p2: ID) => boolean,
4537
+ /**
4538
+ * context object to provide as `this` in each call of `callback`
4539
+ */
4540
+ thisArg?: Object
4541
+ ): UI5Element[];
4542
+ /**
4543
+ * Calls the given `callback` for each element.
4544
+ *
4545
+ * The expected signature of the callback is
4546
+ * ```javascript
4547
+ *
4548
+ * function callback(oElement, sID)
4549
+ * ```
4550
+ * where `oElement` is the currently visited element instance and `sID` is the ID of that instance.
4551
+ *
4552
+ * The order in which the callback is called for elements is not specified and might change between calls
4553
+ * (over time and across different versions of UI5).
4554
+ *
4555
+ * If elements are created or destroyed within the `callback`, then the behavior is not specified. Newly
4556
+ * added objects might or might not be visited. When an element is destroyed during the filtering and was
4557
+ * not visited yet, it might or might not be visited. As the behavior for such concurrent modifications
4558
+ * is not specified, it may change in newer releases.
4559
+ *
4560
+ * If a `thisArg` is given, it will be provided as `this` context when calling `callback`. The `this` value
4561
+ * that the implementation of `callback` sees, depends on the usual resolution mechanism. E.g. when `callback`
4562
+ * was bound to some context object, that object wins over the given `thisArg`.
4563
+ */
4564
+ forEach(
4565
+ /**
4566
+ * Function to call for each element
4567
+ */
4568
+ callback: (p1: UI5Element, p2: ID) => void,
4569
+ /**
4570
+ * Context object to provide as `this` in each call of `callback`
4571
+ */
4572
+ thisArg?: Object
4573
+ ): void;
4574
+ /**
4575
+ * Retrieves an Element by its ID.
4576
+ *
4577
+ * When the ID is `null` or `undefined` or when there's no element with the given ID, then `undefined` is
4578
+ * returned.
4579
+ *
4580
+ * @returns Element with the given ID or `undefined`
4581
+ */
4582
+ get(
4583
+ /**
4584
+ * ID of the element to retrieve
4585
+ */
4586
+ id: ID
4587
+ ): UI5Element | undefined;
4588
+ }
4589
+ const ElementRegistry: ElementRegistry;
4590
+ export default ElementRegistry;
4591
+ }
4592
+
4361
4593
  declare module "sap/ui/core/getCompatibilityVersion" {
4362
4594
  import Version from "sap/base/util/Version";
4363
4595
 
@@ -12680,6 +12912,8 @@ declare module "sap/ui/core/library" {
12680
12912
  }
12681
12913
 
12682
12914
  /**
12915
+ * @deprecated (since 1.120) - Please use {@link sap.ui.core.message.MessageType} instead.
12916
+ *
12683
12917
  * Specifies possible message types.
12684
12918
  */
12685
12919
  export enum MessageType {
@@ -13755,6 +13989,7 @@ declare module "sap/ui/core/Component" {
13755
13989
  );
13756
13990
  /**
13757
13991
  * @since 1.67
13992
+ * @deprecated (since 1.120) - Use {@link module:sap/ui/core/ComponentRegistry} instead.
13758
13993
  *
13759
13994
  * Registry of all `Component`s that currently exist.
13760
13995
  */
@@ -14438,6 +14673,7 @@ declare module "sap/ui/core/Component" {
14438
14673
 
14439
14674
  /**
14440
14675
  * @since 1.67
14676
+ * @deprecated (since 1.120) - Use {@link module:sap/ui/core/ComponentRegistry} instead.
14441
14677
  *
14442
14678
  * Registry of all `Component`s that currently exist.
14443
14679
  */
@@ -21965,6 +22201,7 @@ declare module "sap/ui/core/Element" {
21965
22201
  );
21966
22202
  /**
21967
22203
  * @since 1.67
22204
+ * @deprecated (since 1.120) - Use {@link module:sap/ui/core/ElementRegistry} instead.
21968
22205
  *
21969
22206
  * Registry of all `sap.ui.core.Element`s that currently exist.
21970
22207
  */
@@ -22069,18 +22306,24 @@ declare module "sap/ui/core/Element" {
22069
22306
  */
22070
22307
  static getActiveElement(): UI5Element | undefined;
22071
22308
  /**
22072
- * Retrieves an Element by its ID.
22309
+ * @since 1.119
22073
22310
  *
22074
- * When the ID is `null` or `undefined` or when there's no element with the given ID, then `undefined` is
22075
- * returned.
22311
+ * Returns the registered element with the given ID, if any.
22312
+ *
22313
+ * The ID must be the globally unique ID of an element, the same as returned by `oElement.getId()`.
22314
+ *
22315
+ * When the element has been created from a declarative source (e.g. XMLView), that source might have used
22316
+ * a shorter, non-unique local ID. A search for such a local ID cannot be executed with this method. It
22317
+ * can only be executed on the corresponding scope (e.g. on an XMLView instance), by using the {@link sap.ui.core.mvc.View#byId View#byId }
22318
+ * method of that scope.
22076
22319
  *
22077
22320
  * @returns Element with the given ID or `undefined`
22078
22321
  */
22079
22322
  static getElementById(
22080
22323
  /**
22081
- * ID of the element to retrieve
22324
+ * ID of the element to search for
22082
22325
  */
22083
- id: ID
22326
+ sId: ID | null | undefined
22084
22327
  ): UI5Element | undefined;
22085
22328
  /**
22086
22329
  * Returns a metadata object for class sap.ui.core.Element.
@@ -22826,12 +23069,19 @@ declare module "sap/ui/core/Element" {
22826
23069
  oDelegate: object
22827
23070
  ): this;
22828
23071
  /**
22829
- * @ui5-protected Do not call from applications (only from related classes in the framework)
23072
+ * @deprecated (since 1.70) - using this method is no longer recommended, but still works. Synchronous DOM
23073
+ * updates via this method have several drawbacks: they only work when the control has been rendered before
23074
+ * (no initial rendering possible), multiple state changes won't be combined automatically into a single
23075
+ * re-rendering, they might cause additional layout trashing, standard invalidation might cause another
23076
+ * async re-rendering.
22830
23077
  *
22831
- * This triggers immediate rerendering of its parent and thus of itself and its children.
23078
+ * The recommended alternative is to rely on invalidation and standard re-rendering.
22832
23079
  *
22833
23080
  * As `sap.ui.core.Element` "bubbles up" the rerender, changes to child-`Elements` will also result in immediate
22834
23081
  * rerendering of the whole sub tree.
23082
+ * @ui5-protected Do not call from applications (only from related classes in the framework)
23083
+ *
23084
+ * This triggers immediate rerendering of its parent and thus of itself and its children.
22835
23085
  */
22836
23086
  rerender(): void;
22837
23087
  /**
@@ -22894,6 +23144,7 @@ declare module "sap/ui/core/Element" {
22894
23144
 
22895
23145
  /**
22896
23146
  * @since 1.67
23147
+ * @deprecated (since 1.120) - Use {@link module:sap/ui/core/ElementRegistry} instead.
22897
23148
  *
22898
23149
  * Registry of all `sap.ui.core.Element`s that currently exist.
22899
23150
  */
@@ -22984,6 +23235,20 @@ declare module "sap/ui/core/Element" {
22984
23235
  */
22985
23236
  thisArg?: Object
22986
23237
  ): void;
23238
+ /**
23239
+ * Retrieves an Element by its ID.
23240
+ *
23241
+ * When the ID is `null` or `undefined` or when there's no element with the given ID, then `undefined` is
23242
+ * returned.
23243
+ *
23244
+ * @returns Element with the given ID or `undefined`
23245
+ */
23246
+ get(
23247
+ /**
23248
+ * ID of the element to retrieve
23249
+ */
23250
+ id: ID
23251
+ ): UI5Element | undefined;
22987
23252
  }
22988
23253
  export const registry: registry;
22989
23254
 
@@ -28170,6 +28435,11 @@ declare module "sap/ui/core/Lib" {
28170
28435
  * in `mSettings` and will evaluate the descriptor file instead. Library developers therefore must keep
28171
28436
  * the information in both files in sync if the `manifest.json` file is maintained manually.
28172
28437
  *
28438
+ * Library API-Version 2:
28439
+ *
28440
+ * The Library API Version 2 has been introduced to avoid access to the global namespace when retrieving
28441
+ * enum types. With Library API Version 2 a library must declare its enum types via {@link module:sap/ui/base/DataType.registerEnum DataType.registerEnum}.
28442
+ *
28173
28443
  * @returns Returns the library namespace, based on the given library name.
28174
28444
  */
28175
28445
  static init(
@@ -28185,6 +28455,10 @@ declare module "sap/ui/core/Lib" {
28185
28455
  * Version of the library
28186
28456
  */
28187
28457
  version?: string;
28458
+ /**
28459
+ * The library's API version; supported values are 1, 2 and `undefined` (defaults to 1).
28460
+ */
28461
+ apiVersion?: int;
28188
28462
  /**
28189
28463
  * List of libraries that this library depends on; names are in dot notation (e.g. "sap.ui.core")
28190
28464
  */
@@ -29280,35 +29554,33 @@ declare module "sap/ui/core/LocaleData" {
29280
29554
  /**
29281
29555
  * Get month names in width "narrow", "abbreviated" or "wide".
29282
29556
  *
29283
- * @returns array of month names (starting with January)
29557
+ * @returns The array of month names
29284
29558
  */
29285
29559
  getMonths(
29286
29560
  /**
29287
- * the required width for the month names
29561
+ * The required width for the month names
29288
29562
  */
29289
- sWidth: string,
29563
+ sWidth: "narrow" | "abbreviated" | "wide",
29290
29564
  /**
29291
- * the type of calendar. If it's not set, it falls back to the calendar type either set in configuration
29292
- * or calculated from locale.
29565
+ * The type of calendar; defaults to the calendar type either set in configuration or calculated from locale
29293
29566
  */
29294
29567
  sCalendarType?: CalendarType
29295
- ): any[];
29568
+ ): string[];
29296
29569
  /**
29297
29570
  * Get standalone month names in width "narrow", "abbreviated" or "wide".
29298
29571
  *
29299
- * @returns array of month names (starting with January)
29572
+ * @returns The array of standalone month names
29300
29573
  */
29301
29574
  getMonthsStandAlone(
29302
29575
  /**
29303
- * the required width for the month names
29576
+ * The required width for the month names
29304
29577
  */
29305
- sWidth: string,
29578
+ sWidth: "narrow" | "abbreviated" | "wide",
29306
29579
  /**
29307
- * the type of calendar. If it's not set, it falls back to the calendar type either set in configuration
29308
- * or calculated from locale.
29580
+ * The type of calendar; defaults to the calendar type either set in configuration or calculated from locale
29309
29581
  */
29310
29582
  sCalendarType?: CalendarType
29311
- ): any[];
29583
+ ): string[];
29312
29584
  /**
29313
29585
  * Get number symbol "decimal", "group", "plusSign", "minusSign", "percentSign".
29314
29586
  *
@@ -29932,6 +30204,8 @@ declare module "sap/ui/core/Message" {
29932
30204
  import { PropertyBindingInfo } from "sap/ui/base/ManagedObject";
29933
30205
 
29934
30206
  /**
30207
+ * @deprecated (since 1.120) - Please use {@link sap.ui.core.message.Message} instead.
30208
+ *
29935
30209
  * This element is used to provide messages.
29936
30210
  *
29937
30211
  * Rendering must be done within the control that uses this kind of element. Its default level is none.
@@ -30277,7 +30551,7 @@ declare module "sap/ui/core/message/ControlMessageProcessor" {
30277
30551
  declare module "sap/ui/core/message/Message" {
30278
30552
  import BaseObject from "sap/ui/base/Object";
30279
30553
 
30280
- import { MessageType } from "sap/ui/core/library";
30554
+ import MessageType from "sap/ui/core/message/MessageType";
30281
30555
 
30282
30556
  import MessageProcessor from "sap/ui/core/message/MessageProcessor";
30283
30557
 
@@ -30317,7 +30591,7 @@ declare module "sap/ui/core/message/Message" {
30317
30591
  /**
30318
30592
  * The message type
30319
30593
  */
30320
- type?: MessageType;
30594
+ type?: MessageType | keyof typeof MessageType;
30321
30595
  /**
30322
30596
  * The message code
30323
30597
  */
@@ -30494,7 +30768,7 @@ declare module "sap/ui/core/message/Message" {
30494
30768
  *
30495
30769
  * @returns type
30496
30770
  */
30497
- getType(): MessageType;
30771
+ getType(): MessageType | keyof typeof MessageType;
30498
30772
  /**
30499
30773
  * Sets the additionaltext for the message or merge different additionaltext strings
30500
30774
  */
@@ -30616,7 +30890,7 @@ declare module "sap/ui/core/message/Message" {
30616
30890
  /**
30617
30891
  * The Message type
30618
30892
  */
30619
- sType: MessageType
30893
+ sType: MessageType | keyof typeof MessageType
30620
30894
  ): void;
30621
30895
  }
30622
30896
  }
@@ -32453,6 +32727,8 @@ declare module "sap/ui/core/mvc/View" {
32453
32727
  sId: string
32454
32728
  ): UI5Element | undefined;
32455
32729
  /**
32730
+ * @deprecated (since 1.120) - please call the corresponding View factory instead, e.g. {@link sap.ui.core.mvc.XMLView.create}
32731
+ *
32456
32732
  * Creates a clone of this view.
32457
32733
  *
32458
32734
  * Overrides the clone method to avoid conflicts between generic cloning of the content aggregation and
@@ -42159,6 +42435,7 @@ declare module "sap/ui/core/UIArea" {
42159
42435
  constructor();
42160
42436
  /**
42161
42437
  * @since 1.107
42438
+ * @deprecated (since 1.120)
42162
42439
  *
42163
42440
  * Registry of all `sap.ui.core.Element`s that currently exist.
42164
42441
  */
@@ -42474,16 +42751,21 @@ declare module "sap/ui/core/UIArea" {
42474
42751
  }
42475
42752
  /**
42476
42753
  * @since 1.107
42754
+ * @deprecated (since 1.120)
42477
42755
  *
42478
42756
  * Registry of all `sap.ui.core.Element`s that currently exist.
42479
42757
  */
42480
42758
  interface registry {
42481
42759
  /**
42760
+ * @deprecated (since 1.120)
42761
+ *
42482
42762
  * Number of existing UIAreas.
42483
42763
  */
42484
42764
  size: int;
42485
42765
 
42486
42766
  /**
42767
+ * @deprecated (since 1.120)
42768
+ *
42487
42769
  * Return an object with all instances of `sap.ui.core.UIArea`, keyed by their ID.
42488
42770
  *
42489
42771
  * Each call creates a new snapshot object. Depending on the size of the UI, this operation therefore might
@@ -42497,6 +42779,8 @@ declare module "sap/ui/core/UIArea" {
42497
42779
  */
42498
42780
  all(): Record<ID, UIArea>;
42499
42781
  /**
42782
+ * @deprecated (since 1.120)
42783
+ *
42500
42784
  * Returns an array with UIAreas for which the given `callback` returns a value that coerces to `true`.
42501
42785
  *
42502
42786
  * The expected signature of the callback is
@@ -42533,6 +42817,8 @@ declare module "sap/ui/core/UIArea" {
42533
42817
  thisArg?: Object
42534
42818
  ): UIArea[];
42535
42819
  /**
42820
+ * @deprecated (since 1.120)
42821
+ *
42536
42822
  * Calls the given `callback` for each UIArea.
42537
42823
  *
42538
42824
  * The expected signature of the callback is
@@ -42565,6 +42851,8 @@ declare module "sap/ui/core/UIArea" {
42565
42851
  thisArg?: Object
42566
42852
  ): void;
42567
42853
  /**
42854
+ * @deprecated (since 1.120)
42855
+ *
42568
42856
  * Retrieves an UIArea by its ID.
42569
42857
  *
42570
42858
  * When the ID is `null` or `undefined` or when there's no UIArea with the given ID, then `undefined` is
@@ -50012,8 +50300,8 @@ declare module "sap/ui/model/Binding" {
50012
50300
  oListener?: object
50013
50301
  ): void;
50014
50302
  /**
50015
- * Removes all control messages for this binding from the MessageManager in addition to the standard clean-up
50016
- * tasks.
50303
+ * Removes all control messages for this binding from {@link sap.ui.core.Messaging} in addition to the standard
50304
+ * clean-up tasks.
50017
50305
  * See:
50018
50306
  * sap.ui.base.EventProvider#destroy
50019
50307
  */
@@ -51403,7 +51691,7 @@ declare module "sap/ui/model/CompositeBinding" {
51403
51691
  declare module "sap/ui/model/CompositeDataState" {
51404
51692
  import DataState from "sap/ui/model/DataState";
51405
51693
 
51406
- import Message from "sap/ui/core/Message";
51694
+ import Message from "sap/ui/core/message/Message";
51407
51695
 
51408
51696
  import Metadata from "sap/ui/base/Metadata";
51409
51697
 
@@ -51909,7 +52197,7 @@ declare module "sap/ui/model/ContextBinding" {
51909
52197
  declare module "sap/ui/model/DataState" {
51910
52198
  import BaseObject from "sap/ui/base/Object";
51911
52199
 
51912
- import Message from "sap/ui/core/Message";
52200
+ import Message from "sap/ui/core/message/Message";
51913
52201
 
51914
52202
  import Metadata from "sap/ui/base/Metadata";
51915
52203
 
@@ -67192,14 +67480,13 @@ declare module "sap/ui/model/odata/v4/Context" {
67192
67480
  /**
67193
67481
  * @experimental (since 1.120.0)
67194
67482
  *
67195
- * Returns the parent node (in case of a recursive hierarchy, see {@link #setAggregation}, where `oAggregation.expandTo`
67196
- * must be equal to one).
67197
- * See:
67198
- * #requestParent
67483
+ * Returns the parent node (in case of a recursive hierarchy; see {@link sap.ui.model.odata.v4.ODataListBinding#setAggregation})
67484
+ * or `undefined` if the parent of this node hasn't been read yet; it can then be requested via {@link #requestParent}.
67199
67485
  *
67200
- * @returns The parent node, or `null` if this node is a root node and thus has no parent
67486
+ * @returns The parent node, or `null` if this node is a root node and thus has no parent, or `undefined`
67487
+ * if the parent node hasn't been read yet
67201
67488
  */
67202
- getParent(): Context | null;
67489
+ getParent(): Context | null | undefined;
67203
67490
  /**
67204
67491
  * @since 1.39.0
67205
67492
  *
@@ -67258,7 +67545,7 @@ declare module "sap/ui/model/odata/v4/Context" {
67258
67545
  /**
67259
67546
  * Some node which may be a descendant
67260
67547
  */
67261
- oNode: Context
67548
+ oNode?: Context
67262
67549
  ): boolean;
67263
67550
  /**
67264
67551
  * @since 1.105.0
@@ -67343,9 +67630,10 @@ declare module "sap/ui/model/odata/v4/Context" {
67343
67630
  * @experimental (since 1.119.0)
67344
67631
  *
67345
67632
  * Moves this node to the given parent (in case of a recursive hierarchy, see {@link sap.ui.model.odata.v4.ODataListBinding#setAggregation},
67346
- * where `oAggregation.expandTo` must be one). No other {@link sap.ui.model.odata.v4.ODataListBinding#create creation},
67633
+ * where `oAggregation.expandTo` must be either one or at least `Number.MAX_SAFE_INTEGER`). No other {@link sap.ui.model.odata.v4.ODataListBinding#create creation},
67347
67634
  * {@link #delete deletion}, or move must be pending, and no other modification (including collapse of some
67348
- * ancestor node) must happen while this move is pending!
67635
+ * ancestor node) must happen while this move is pending! Omitting a new parent turns this node into a root
67636
+ * node (since 1.121.0).
67349
67637
  *
67350
67638
  * This context's {@link #getIndex index} may change and it becomes "created persisted", with {@link #isTransient }
67351
67639
  * returning `false` etc.
@@ -67357,11 +67645,11 @@ declare module "sap/ui/model/odata/v4/Context" {
67357
67645
  /**
67358
67646
  * A parameter object
67359
67647
  */
67360
- oParameters: {
67648
+ oParameters?: {
67361
67649
  /**
67362
67650
  * The new parent's context
67363
67651
  */
67364
- parent: Context;
67652
+ parent?: Context;
67365
67653
  }
67366
67654
  ): Promise<void>;
67367
67655
  /**
@@ -67443,8 +67731,9 @@ declare module "sap/ui/model/odata/v4/Context" {
67443
67731
  /**
67444
67732
  * @experimental (since 1.120.0)
67445
67733
  *
67446
- * Requests the parent node (in case of a recursive hierarchy, see {@link #setAggregation}, where `oAggregation.expandTo`
67447
- * must be equal to one).
67734
+ * Requests the parent node (in case of a recursive hierarchy; see {@link sap.ui.model.odata.v4.ODataListBinding#setAggregation}).
67735
+ *
67736
+ * Note: **DO NOT** call {@link #setKeepAlive} on the resulting context!
67448
67737
  * See:
67449
67738
  * #getParent
67450
67739
  *
@@ -68520,12 +68809,12 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
68520
68809
  * parent's navigation property, which is sent with the payload of the parent entity. Such a nested context
68521
68810
  * cannot be inactive.
68522
68811
  *
68523
- * **Note:** After a succesful creation of the main entity the context returned for a nested entity is no
68524
- * longer valid. Do not use the {@link sap.ui.model.odata.v4.Context#created created} promise of such a
68525
- * context! New contexts are created for the nested collection because it is not possible to reliably assign
68526
- * the response entities to those of the request, especially if the count differs. For this reason, the
68527
- * `created` promises of all nested contexts are always rejected with an instance of `Error`, even if the
68528
- * deep create succeeds. This error always has the property `canceled` with the value `true`.
68812
+ * **Note:** After a successful creation of the main entity the context returned for a nested entity is
68813
+ * no longer valid. Do not use the {@link sap.ui.model.odata.v4.Context#created created} promise of such
68814
+ * a context! New contexts are created for the nested collection because it is not possible to reliably
68815
+ * assign the response entities to those of the request, especially if the count differs. For this reason,
68816
+ * the `created` promises of all nested contexts are always rejected with an instance of `Error`, even if
68817
+ * the deep create succeeds. This error always has the property `canceled` with the value `true`.
68529
68818
  *
68530
68819
  * Since 1.118.0 deep create also supports single-valued navigation properties; no API call is required
68531
68820
  * in this case. Simply bind properties of the related entity relative to a transient context. An update
@@ -68735,9 +69024,9 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
68735
69024
  * back to the setter (@experimental as of version 1.111.0). They are retrieved from the pair of "Org.OData.Aggregation.V1.RecursiveHierarchy"
68736
69025
  * and "com.sap.vocabularies.Hierarchy.v1.RecursiveHierarchy" annotations at this binding's entity type,
68737
69026
  * identified via the `hierarchyQualifier` given to {@link #setAggregation}.
68738
- * "$DistanceFromRootProperty" holds the path to the property which provides the raw value for "@$ui5.node.level"
69027
+ * "$DistanceFromRoot" holds the path to the property which provides the raw value for "@$ui5.node.level"
68739
69028
  * (minus one) and should be used only to interpret the response retrieved via {@link #getDownloadUrl}.
68740
- * "$DrillStateProperty" holds the path to the property which provides the raw value for "@$ui5.node.isExpanded"
69029
+ * "$DrillState" holds the path to the property which provides the raw value for "@$ui5.node.isExpanded"
68741
69030
  * and should be used only to interpret the response retrieved via {@link #getDownloadUrl}. "$NodeProperty"
68742
69031
  * holds the path to the property which provides the hierarchy node value. That property is always $select'ed
68743
69032
  * automatically and can be accessed as usual.
@@ -68847,11 +69136,10 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
68847
69136
  * @since 1.74.0
68848
69137
  *
68849
69138
  * Returns a URL by which the complete content of the list can be downloaded in JSON format. The request
68850
- * delivers all entities considering the binding's query options (such as filters or sorters).
68851
- *
68852
- * The returned URL does not specify `$skip` and `$top` and leaves it up to the server how many rows it
68853
- * delivers. Many servers tend to choose a small limit without `$skip` and `$top`, so it might be wise to
68854
- * add an appropriate value for `$top` at least.
69139
+ * delivers all entities considering the binding's query options (such as filters or sorters). Returns `null`
69140
+ * if the binding's filter is {@link sap.ui.filter.Filter.NONE}. The returned URL does not specify `$skip`
69141
+ * and `$top` and leaves it up to the server how many rows it delivers. Many servers tend to choose a small
69142
+ * limit without `$skip` and `$top`, so it might be wise to add an appropriate value for `$top` at least.
68855
69143
  *
68856
69144
  * Additionally, you must be aware of server-driven paging and be ready to send a follow-up request if the
68857
69145
  * response contains `@odata.nextlink`.
@@ -68859,9 +69147,9 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
68859
69147
  * The URL cannot be determined synchronously in all cases; use {@link #requestDownloadUrl} to allow for
68860
69148
  * asynchronous determination then.
68861
69149
  *
68862
- * @returns The download URL
69150
+ * @returns The download URL or `null`
68863
69151
  */
68864
- getDownloadUrl(): string;
69152
+ getDownloadUrl(): string | null;
68865
69153
  /**
68866
69154
  * @since 1.81.0
68867
69155
  *
@@ -69093,8 +69381,9 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
69093
69381
  /**
69094
69382
  * @since 1.74.0
69095
69383
  *
69096
- * Returns a URL by which the complete content of the list can be downloaded in JSON format. The request
69097
- * delivers all entities considering the binding's query options (such as filters or sorters).
69384
+ * Resolves with a URL by which the complete content of the list can be downloaded in JSON format. The request
69385
+ * delivers all entities considering the binding's query options (such as filters or sorters). Resolves
69386
+ * with `null` if the binding's filter is {@link sap.ui.filter.Filter.NONE}.
69098
69387
  *
69099
69388
  * The returned URL does not specify `$skip` and `$top` and leaves it up to the server how many rows it
69100
69389
  * delivers. Many servers tend to choose a small limit without `$skip` and `$top`, so it might be wise to
@@ -69105,9 +69394,9 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
69105
69394
  * See:
69106
69395
  * #getDownloadUrl
69107
69396
  *
69108
- * @returns A promise that is resolved with the download URL
69397
+ * @returns A promise that is resolved with the download URL or `null`
69109
69398
  */
69110
- requestDownloadUrl(): Promise<string>;
69399
+ requestDownloadUrl(): Promise<string | null>;
69111
69400
  /**
69112
69401
  * @since 1.86.0
69113
69402
  * @ui5-protected Do not call from applications (only from related classes in the framework)
@@ -69119,6 +69408,9 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
69119
69408
  * The resulting filter does not consider application or control filters specified for this list binding
69120
69409
  * in its constructor or in its {@link #filter} method; add filters which you want to keep with the "and"
69121
69410
  * conjunction to the resulting filter before calling {@link #filter}.
69411
+ *
69412
+ * If there are only messages for transient entries, the method returns {@link sap.ui.model.Filter.NONE}.
69413
+ * Take care not to combine this filter with other filters.
69122
69414
  * See:
69123
69415
  * sap.ui.model.ListBinding#requestFilterForMessages
69124
69416
  *
@@ -69211,8 +69503,8 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
69211
69503
  * The number (as a positive integer) of different levels initially available without calling {@link sap.ui.model.odata.v4.Context#expand }
69212
69504
  * (@experimental as of version 1.105.0; available for read-only hierarchies since 1.117.0), supported only
69213
69505
  * if a `hierarchyQualifier` is given. Root nodes are on the first level. By default, only root nodes are
69214
- * available; they are not yet expanded. Since 1.120.0, `Number.MAX_SAFE_INTEGER` can be used to expand
69215
- * all levels.
69506
+ * available; they are not yet expanded. Since 1.120.0, `expandTo >= Number.MAX_SAFE_INTEGER` can be used
69507
+ * to expand all levels (`1E16` is recommended inside XML views for simplicity).
69216
69508
  */
69217
69509
  expandTo?: number;
69218
69510
  /**
@@ -69439,8 +69731,7 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
69439
69731
  context?: Context;
69440
69732
 
69441
69733
  /**
69442
- * Whether the POST was successfully processed; in case of an error, the error is already reported to the
69443
- * {@link sap.ui.core.message.MessageManager}
69734
+ * Whether the POST was successfully processed; in case of an error, the error is already reported to {@link sap.ui.core.Messaging}
69444
69735
  */
69445
69736
  success?: boolean;
69446
69737
  }
@@ -70026,11 +70317,12 @@ declare module "sap/ui/model/odata/v4/ODataMetaModel" {
70026
70317
  * "@@.AH.isMultiple" or "@@.isMultiple", represent computed annotations. Their name without the "@@" prefix
70027
70318
  * must refer to a function in `mParameters.scope` in case of a relative name starting with a dot, which
70028
70319
  * is stripped before lookup; see the `<template:alias>` instruction for XML Templating. In case of an
70029
- * absolute name, it is searched in `mParameters.scope` first and then in the global namespace. The names
70030
- * "requestCurrencyCodes" and "requestUnitsOfMeasure" default to {@link #requestCurrencyCodes} and {@link #requestUnitsOfMeasure }
70031
- * resp. if not present in `mParameters.scope`. This function is called with the current object (or primitive
70032
- * value) and additional details and returns the result of this {@link #requestObject} call. The additional
70033
- * details are given as an object with the following properties:
70320
+ * absolute name, it is searched in `mParameters.scope` first and then in the global namespace. (Using the
70321
+ * global namespace is @deprecated as of version 1.120.3). The names "requestCurrencyCodes" and "requestUnitsOfMeasure"
70322
+ * default to {@link #requestCurrencyCodes} and {@link #requestUnitsOfMeasure} resp. if not present in `mParameters.scope`.
70323
+ * This function is called with the current object (or primitive value) and additional details and returns
70324
+ * the result of this {@link #requestObject} call. The additional details are given as an object with the
70325
+ * following properties:
70034
70326
  * `{boolean} $$valueAsPromise` Whether the computed annotation may return a `Promise` resolving with
70035
70327
  * its value (since 1.57.0) `{@link sap.ui.model.Context} context` Points to the current object
70036
70328
  * `{object} overload` In case of annotations of an operation or a parameter, if filtering by binding parameter
@@ -70131,7 +70423,8 @@ declare module "sap/ui/model/odata/v4/ODataMetaModel" {
70131
70423
  */
70132
70424
  mParameters?: {
70133
70425
  /**
70134
- * Optional scope for lookup of aliases for computed annotations (since 1.43.0)
70426
+ * Scope for lookup of aliases for computed annotations (since 1.43.0). Since 1.120.3 looking up a computed
70427
+ * annotation via its global name is deprecated; always use this scope instead.
70135
70428
  */
70136
70429
  scope?: object;
70137
70430
  }
@@ -84132,6 +84425,8 @@ declare namespace sap {
84132
84425
 
84133
84426
  "sap/ui/core/ComponentMetadata": undefined;
84134
84427
 
84428
+ "sap/ui/core/ComponentRegistry": undefined;
84429
+
84135
84430
  "sap/ui/core/ComponentSupport": undefined;
84136
84431
 
84137
84432
  "sap/ui/core/Configuration": undefined;
@@ -84174,6 +84469,8 @@ declare namespace sap {
84174
84469
 
84175
84470
  "sap/ui/core/ElementMetadata": undefined;
84176
84471
 
84472
+ "sap/ui/core/ElementRegistry": undefined;
84473
+
84177
84474
  "sap/ui/core/EnabledPropagator": undefined;
84178
84475
 
84179
84476
  "sap/ui/core/EventBus": undefined;
@@ -84356,6 +84653,8 @@ declare namespace sap {
84356
84653
 
84357
84654
  "sap/ui/core/UIArea": undefined;
84358
84655
 
84656
+ "sap/ui/core/UIAreaRegistry": undefined;
84657
+
84359
84658
  "sap/ui/core/UIComponent": undefined;
84360
84659
 
84361
84660
  "sap/ui/core/util/Export": undefined;