@openui5/types 1.124.1 → 1.125.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.
@@ -1,4 +1,4 @@
1
- // For Library Version: 1.124.1
1
+ // For Library Version: 1.125.0
2
2
 
3
3
  declare module "sap/tnt/library" {
4
4
  /**
@@ -1,4 +1,4 @@
1
- // For Library Version: 1.124.1
1
+ // For Library Version: 1.125.0
2
2
 
3
3
  declare module "sap/ui/codeeditor/library" {}
4
4
 
@@ -1,4 +1,4 @@
1
- // For Library Version: 1.124.1
1
+ // For Library Version: 1.125.0
2
2
 
3
3
  declare module "sap/ui/commons/library" {
4
4
  import { ColorPickerMode as ColorPickerMode1 } from "sap/ui/unified/library";
@@ -279,7 +279,7 @@ declare namespace sap {
279
279
  "sap/ui/thirdparty/qunit-2": undefined;
280
280
  }
281
281
  }
282
- // For Library Version: 1.124.1
282
+ // For Library Version: 1.125.0
283
283
 
284
284
  declare module "sap/base/assert" {
285
285
  /**
@@ -15152,7 +15152,11 @@ declare module "sap/ui/core/Component" {
15152
15152
  */
15153
15153
  export default abstract class Component extends ManagedObject {
15154
15154
  /**
15155
- * Creates and initializes a new Component with the given `sId` and settings.
15155
+ * As `Component` is an abstract base class for components, applications should not call the constructor.
15156
+ * For many use cases the static {@link #.create Component.create} factory can be used to instantiate a
15157
+ * `Component`. Depending on the requirements, the framework also provides other ways to instantiate a `Component`,
15158
+ * documented under the {@link https://ui5.sap.com/#/topic/958ead51e2e94ab8bcdc90fb7e9d53d0 "Component" }
15159
+ * chapter.
15156
15160
  *
15157
15161
  * The set of allowed entries in the `mSettings` object depends on the concrete subclass and is described
15158
15162
  * there. See {@link sap.ui.core.Component} for a general description of this argument.
@@ -15171,7 +15175,11 @@ declare module "sap/ui/core/Component" {
15171
15175
  mSettings?: $ComponentSettings
15172
15176
  );
15173
15177
  /**
15174
- * Creates and initializes a new Component with the given `sId` and settings.
15178
+ * As `Component` is an abstract base class for components, applications should not call the constructor.
15179
+ * For many use cases the static {@link #.create Component.create} factory can be used to instantiate a
15180
+ * `Component`. Depending on the requirements, the framework also provides other ways to instantiate a `Component`,
15181
+ * documented under the {@link https://ui5.sap.com/#/topic/958ead51e2e94ab8bcdc90fb7e9d53d0 "Component" }
15182
+ * chapter.
15175
15183
  *
15176
15184
  * The set of allowed entries in the `mSettings` object depends on the concrete subclass and is described
15177
15185
  * there. See {@link sap.ui.core.Component} for a general description of this argument.
@@ -19363,22 +19371,28 @@ declare module "sap/ui/core/Core" {
19363
19371
  import Interface from "sap/ui/base/Interface";
19364
19372
 
19365
19373
  /**
19366
- * Core Class of the SAP UI Library.
19374
+ * Singleton Core instance of the SAP UI Library.
19367
19375
  *
19368
- * This class boots the Core framework and makes it available for the application by requiring `sap.ui.core.Core`.
19376
+ * The module export of `sap/ui/core/Core` is **not** a class, but the singleton Core instance itself. The
19377
+ * `sap.ui.core.Core` class itself must not be instantiated, except by the framework itself.
19369
19378
  *
19370
- * The Core provides a {@link #ready ready function} to execute code after the core was booted.
19379
+ * The Core provides a {@link #ready ready function} to execute code after the Core was booted.
19371
19380
  *
19372
19381
  * Example:
19373
19382
  * ```javascript
19374
19383
  *
19375
19384
  *
19376
- * oCore.ready(function() {
19385
+ * sap.ui.require(["sap/ui/core/Core"], async function(Core) {
19386
+ *
19387
+ * // Usage of a callback function
19388
+ * Core.ready(function() {
19377
19389
  * ...
19378
- * });
19390
+ * });
19379
19391
  *
19380
- * await oCore.ready();
19381
- * ...
19392
+ * // Usage of Core.ready() as a Promise
19393
+ * await Core.ready();
19394
+ * ...
19395
+ * });
19382
19396
  *
19383
19397
  * ```
19384
19398
  */
@@ -20739,7 +20753,8 @@ declare module "sap/ui/core/Core" {
20739
20753
  */
20740
20754
  notifyContentDensityChanged(): void;
20741
20755
  /**
20742
- * Returns a Promise that resolves if the Core is initialized.
20756
+ * Returns a Promise that resolves if the Core is initialized. Additionally, a callback function can be
20757
+ * passed, for use cases where using Promises is not an option.
20743
20758
  *
20744
20759
  * @since 1.118.0
20745
20760
  *
@@ -23346,17 +23361,20 @@ declare module "sap/ui/core/dnd/DropInfo" {
23346
23361
  /**
23347
23362
  * Fires event {@link #event:dragOver dragOver} to attached listeners.
23348
23363
  *
23364
+ * Listeners may prevent the default action of this event by calling the `preventDefault` method on the
23365
+ * event object. The return value of this method indicates whether the default action should be executed.
23366
+ *
23349
23367
  * @since 1.56
23350
23368
  * @ui5-protected Do not call from applications (only from related classes in the framework)
23351
23369
  *
23352
- * @returns Reference to `this` in order to allow method chaining
23370
+ * @returns Whether or not to prevent the default action
23353
23371
  */
23354
23372
  fireDragOver(
23355
23373
  /**
23356
23374
  * Parameters to pass along with the event
23357
23375
  */
23358
23376
  mParameters?: DropInfo$DragOverEventParameters
23359
- ): this;
23377
+ ): boolean;
23360
23378
  /**
23361
23379
  * Fires event {@link #event:drop drop} to attached listeners.
23362
23380
  *
@@ -23555,6 +23573,13 @@ declare module "sap/ui/core/dnd/DropInfo" {
23555
23573
  */
23556
23574
  dragSession?: DragSession;
23557
23575
 
23576
+ /**
23577
+ * The calculated position of the drop action relative to the `target`
23578
+ */
23579
+ dropPosition?:
23580
+ | dnd.RelativeDropPosition
23581
+ | keyof typeof dnd.RelativeDropPosition;
23582
+
23558
23583
  /**
23559
23584
  * The underlying browser event
23560
23585
  */
@@ -42230,7 +42255,7 @@ declare module "sap/ui/core/search/OpenSearchProvider" {
42230
42255
  /**
42231
42256
  * A SearchProvider which uses the OpenSearch protocol (either JSON or XML).
42232
42257
  *
42233
- * @deprecated (since 1.120)
42258
+ * @deprecated (since 1.120) - There is no API replacement.
42234
42259
  */
42235
42260
  export default class OpenSearchProvider extends SearchProvider {
42236
42261
  /**
@@ -42370,7 +42395,7 @@ declare module "sap/ui/core/search/OpenSearchProvider" {
42370
42395
  /**
42371
42396
  * Describes the settings that can be provided to the OpenSearchProvider constructor.
42372
42397
  *
42373
- * @deprecated (since 1.120)
42398
+ * @deprecated (since 1.120) - There is no API replacement.
42374
42399
  */
42375
42400
  export interface $OpenSearchProviderSettings extends $SearchProviderSettings {
42376
42401
  /**
@@ -42398,7 +42423,7 @@ declare module "sap/ui/core/search/SearchProvider" {
42398
42423
  *
42399
42424
  * Do not create instances of this class, but use a concrete subclass instead.
42400
42425
  *
42401
- * @deprecated (since 1.120)
42426
+ * @deprecated (since 1.120) - There is no API replacement.
42402
42427
  */
42403
42428
  export default abstract class SearchProvider extends UI5Element {
42404
42429
  /**
@@ -42507,7 +42532,7 @@ declare module "sap/ui/core/search/SearchProvider" {
42507
42532
  /**
42508
42533
  * Describes the settings that can be provided to the SearchProvider constructor.
42509
42534
  *
42510
- * @deprecated (since 1.120)
42535
+ * @deprecated (since 1.120) - There is no API replacement.
42511
42536
  */
42512
42537
  export interface $SearchProviderSettings extends $ElementSettings {
42513
42538
  /**
@@ -43117,7 +43142,8 @@ declare module "sap/ui/core/tmpl/DOMAttribute" {
43117
43142
  * Represents a DOM attribute of a DOM element.
43118
43143
  *
43119
43144
  * @since 1.15
43120
- * @deprecated (since 1.56)
43145
+ * @deprecated (since 1.56) - Use an {@link sap.ui.core.mvc.XMLView XMLView} or a {@link topic:e6bb33d076dc4f23be50c082c271b9f0 Typed View }
43146
+ * instead.
43121
43147
  */
43122
43148
  export default class DOMAttribute extends UI5Element {
43123
43149
  /**
@@ -43236,7 +43262,8 @@ declare module "sap/ui/core/tmpl/DOMAttribute" {
43236
43262
  /**
43237
43263
  * Describes the settings that can be provided to the DOMAttribute constructor.
43238
43264
  *
43239
- * @deprecated (since 1.56)
43265
+ * @deprecated (since 1.56) - Use an {@link sap.ui.core.mvc.XMLView XMLView} or a {@link topic:e6bb33d076dc4f23be50c082c271b9f0 Typed View }
43266
+ * instead.
43240
43267
  */
43241
43268
  export interface $DOMAttributeSettings extends $ElementSettings {
43242
43269
  /**
@@ -43267,7 +43294,8 @@ declare module "sap/ui/core/tmpl/DOMElement" {
43267
43294
  * Represents a DOM element. It allows to use databinding for the properties and nested DOM attributes.
43268
43295
  *
43269
43296
  * @since 1.15
43270
- * @deprecated (since 1.56)
43297
+ * @deprecated (since 1.56) - Use an {@link sap.ui.core.mvc.XMLView XMLView} or a {@link topic:e6bb33d076dc4f23be50c082c271b9f0 Typed View }
43298
+ * instead.
43271
43299
  */
43272
43300
  export default class DOMElement extends Control {
43273
43301
  /**
@@ -43574,7 +43602,8 @@ declare module "sap/ui/core/tmpl/DOMElement" {
43574
43602
  /**
43575
43603
  * Describes the settings that can be provided to the DOMElement constructor.
43576
43604
  *
43577
- * @deprecated (since 1.56)
43605
+ * @deprecated (since 1.56) - Use an {@link sap.ui.core.mvc.XMLView XMLView} or a {@link topic:e6bb33d076dc4f23be50c082c271b9f0 Typed View }
43606
+ * instead.
43578
43607
  */
43579
43608
  export interface $DOMElementSettings extends $ControlSettings {
43580
43609
  /**
@@ -43619,7 +43648,8 @@ declare module "sap/ui/core/tmpl/HandlebarsTemplate" {
43619
43648
  * The class for Handlebars Templates.
43620
43649
  *
43621
43650
  * @since 1.15
43622
- * @deprecated (since 1.56)
43651
+ * @deprecated (since 1.56) - Use an {@link sap.ui.core.mvc.XMLView XMLView} or a {@link topic:e6bb33d076dc4f23be50c082c271b9f0 Typed View }
43652
+ * instead.
43623
43653
  */
43624
43654
  export default abstract class HandlebarsTemplate extends Template {
43625
43655
  /**
@@ -43701,7 +43731,8 @@ declare module "sap/ui/core/tmpl/HandlebarsTemplate" {
43701
43731
  /**
43702
43732
  * Describes the settings that can be provided to the HandlebarsTemplate constructor.
43703
43733
  *
43704
- * @deprecated (since 1.56)
43734
+ * @deprecated (since 1.56) - Use an {@link sap.ui.core.mvc.XMLView XMLView} or a {@link topic:e6bb33d076dc4f23be50c082c271b9f0 Typed View }
43735
+ * instead.
43705
43736
  */
43706
43737
  export interface $HandlebarsTemplateSettings extends $TemplateSettings {}
43707
43738
  }
@@ -43998,7 +44029,8 @@ declare module "sap/ui/core/tmpl/TemplateControl" {
43998
44029
  * This is the base class for all template controls. Template controls are declared based on templates.
43999
44030
  *
44000
44031
  * @since 1.15
44001
- * @deprecated (since 1.56)
44032
+ * @deprecated (since 1.56) - Use an {@link sap.ui.core.mvc.XMLView XMLView} or a {@link topic:e6bb33d076dc4f23be50c082c271b9f0 Typed View }
44033
+ * instead.
44002
44034
  */
44003
44035
  export default class TemplateControl extends Control {
44004
44036
  /**
@@ -44429,7 +44461,8 @@ declare module "sap/ui/core/tmpl/TemplateControl" {
44429
44461
  /**
44430
44462
  * Describes the settings that can be provided to the TemplateControl constructor.
44431
44463
  *
44432
- * @deprecated (since 1.56)
44464
+ * @deprecated (since 1.56) - Use an {@link sap.ui.core.mvc.XMLView XMLView} or a {@link topic:e6bb33d076dc4f23be50c082c271b9f0 Typed View }
44465
+ * instead.
44433
44466
  */
44434
44467
  export interface $TemplateControlSettings extends $ControlSettings {
44435
44468
  /**
@@ -45034,7 +45067,7 @@ declare module "sap/ui/core/UIArea" {
45034
45067
  *
45035
45068
  * @since 1.107
45036
45069
  * @deprecated (since 1.120) - without a replacement. Applications should not be interested in the set of
45037
- * all `UIArea`s. They should only assign controls to them, by using {@link sap.ui.core.Control.prototype.placeAt Control.prototype.placeAt }
45070
+ * `UIArea`s. They should only assign controls to them, by using {@link sap.ui.core.Control.prototype.placeAt Control.prototype.placeAt }
45038
45071
  * or use the API of a `UIArea` as reachable via {@link sap.ui.core.Control.prototype.getUIArea Control.prototype.getUIArea}.
45039
45072
  */
45040
45073
  static registry: registry;
@@ -45350,7 +45383,7 @@ declare module "sap/ui/core/UIArea" {
45350
45383
  * The node must have an ID that will be used as ID for this instance of `UIArea`.
45351
45384
  *
45352
45385
  * @deprecated (since 1.107) - without a replacement. Applications should not create or modify `UIArea`s
45353
- * programmatically. THey should only assign controls to them, by using {@link sap.ui.core.Control.prototype.placeAt Control.prototype.placeAt }
45386
+ * programmatically. They should only assign controls to them, by using {@link sap.ui.core.Control.prototype.placeAt Control.prototype.placeAt }
45354
45387
  * or use the API of a `UIArea` as reachable via {@link sap.ui.core.Control.prototype.getUIArea Control.prototype.getUIArea}.
45355
45388
  */
45356
45389
  setRootNode(
@@ -45371,7 +45404,7 @@ declare module "sap/ui/core/UIArea" {
45371
45404
  *
45372
45405
  * @since 1.107
45373
45406
  * @deprecated (since 1.120) - without a replacement. Applications should not be interested in the set of
45374
- * all `UIArea`s. They should only assign controls to them, by using {@link sap.ui.core.Control.prototype.placeAt Control.prototype.placeAt }
45407
+ * `UIArea`s. They should only assign controls to them, by using {@link sap.ui.core.Control.prototype.placeAt Control.prototype.placeAt }
45375
45408
  * or use the API of a `UIArea` as reachable via {@link sap.ui.core.Control.prototype.getUIArea Control.prototype.getUIArea}.
45376
45409
  */
45377
45410
  interface registry {
@@ -45379,7 +45412,7 @@ declare module "sap/ui/core/UIArea" {
45379
45412
  * Number of existing UIAreas.
45380
45413
  *
45381
45414
  * @deprecated (since 1.120) - without a replacement. Applications should not be interested in the set of
45382
- * all `UIArea`s. They should only assign controls to them, by using {@link sap.ui.core.Control.prototype.placeAt Control.prototype.placeAt }
45415
+ * `UIArea`s. They should only assign controls to them, by using {@link sap.ui.core.Control.prototype.placeAt Control.prototype.placeAt }
45383
45416
  * or use the API of a `UIArea` as reachable via {@link sap.ui.core.Control.prototype.getUIArea Control.prototype.getUIArea}.
45384
45417
  */
45385
45418
  size: int;
@@ -45483,8 +45516,8 @@ declare module "sap/ui/core/UIArea" {
45483
45516
  * When the ID is `null` or `undefined` or when there's no UIArea with the given ID, then `undefined` is
45484
45517
  * returned.
45485
45518
  *
45486
- * @deprecated (since 1.120) - without a replacement. Applications should not be interested in the set of
45487
- * all `UIArea`s. They should only assign controls to them, by using {@link sap.ui.core.Control.prototype.placeAt Control.prototype.placeAt }
45519
+ * @deprecated (since 1.120) - without a replacement. Applications should not be interested in a certain
45520
+ * `UIArea`. They should only assign controls to them, by using {@link sap.ui.core.Control.prototype.placeAt Control.prototype.placeAt }
45488
45521
  * or use the API of a `UIArea` as reachable via {@link sap.ui.core.Control.prototype.getUIArea Control.prototype.getUIArea}.
45489
45522
  *
45490
45523
  * @returns UIArea with the given ID or `undefined`
@@ -45555,7 +45588,11 @@ declare module "sap/ui/core/UIComponent" {
45555
45588
  */
45556
45589
  export default abstract class UIComponent extends Component {
45557
45590
  /**
45558
- * Creates and initializes a new UIComponent with the given `sId` and settings.
45591
+ * As `UIComponent` is an abstract base class for UI components, applications should not call the constructor.
45592
+ * For many use cases the static {@link sap.ui.core.Component.create Component.create} factory can be used
45593
+ * to instantiate a `UIComponent`. Depending on the requirements, the framework also provides other ways
45594
+ * to instantiate a `UIComponent`, documented under the {@link https://ui5.sap.com/#/topic/958ead51e2e94ab8bcdc90fb7e9d53d0 "Component" }
45595
+ * chapter.
45559
45596
  *
45560
45597
  * The set of allowed entries in the `mSettings` object depends on the concrete subclass and is described
45561
45598
  * there. See {@link sap.ui.core.Component} for a general description of this argument.
@@ -45571,7 +45608,11 @@ declare module "sap/ui/core/UIComponent" {
45571
45608
  mSettings?: $UIComponentSettings
45572
45609
  );
45573
45610
  /**
45574
- * Creates and initializes a new UIComponent with the given `sId` and settings.
45611
+ * As `UIComponent` is an abstract base class for UI components, applications should not call the constructor.
45612
+ * For many use cases the static {@link sap.ui.core.Component.create Component.create} factory can be used
45613
+ * to instantiate a `UIComponent`. Depending on the requirements, the framework also provides other ways
45614
+ * to instantiate a `UIComponent`, documented under the {@link https://ui5.sap.com/#/topic/958ead51e2e94ab8bcdc90fb7e9d53d0 "Component" }
45615
+ * chapter.
45575
45616
  *
45576
45617
  * The set of allowed entries in the `mSettings` object depends on the concrete subclass and is described
45577
45618
  * there. See {@link sap.ui.core.Component} for a general description of this argument.
@@ -56045,9 +56086,11 @@ declare module "sap/ui/model/json/JSONModel" {
56045
56086
  /**
56046
56087
  * Constructor for a new JSONModel.
56047
56088
  *
56048
- * The observation feature is experimental! When observation is activated, the application can directly
56049
- * change the JS objects without the need to call setData, setProperty or refresh. Observation does only
56050
- * work for existing properties in the JSON, it cannot detect new properties or new array entries.
56089
+ * When observation is activated, the application can directly change the JS objects without the need to
56090
+ * call {@link sap.ui.model.json.JSONModel#setData}, {@link sap.ui.model.json.JSONModel#setProperty} or
56091
+ * {@link sap.ui.model.Model#refresh}. **Note:** Observation only works for existing properties in the JSON
56092
+ * model. Newly added or removed properties and newly added or removed array entries, for example, are not
56093
+ * detected.
56051
56094
  */
56052
56095
  constructor(
56053
56096
  /**
@@ -56055,7 +56098,7 @@ declare module "sap/ui/model/json/JSONModel" {
56055
56098
  */
56056
56099
  oData?: object | string,
56057
56100
  /**
56058
- * Whether to observe the JSON data for property changes (experimental)
56101
+ * Whether to observe the JSON data for property changes
56059
56102
  */
56060
56103
  bObserve?: boolean
56061
56104
  );
@@ -67252,8 +67295,8 @@ declare module "sap/ui/model/odata/v2/ODataModel" {
67252
67295
  */
67253
67296
  useBatch?: boolean;
67254
67297
  /**
67255
- * Experimental - `true` when user credentials are to be included in a cross-origin request; please note
67256
- * that this only works if all requests are asynchronous
67298
+ * If set to `true`, the user credentials are included in a cross-origin request. **Note:** This only works
67299
+ * if all requests are asynchronous.
67257
67300
  */
67258
67301
  withCredentials?: boolean;
67259
67302
  /**
@@ -69314,7 +69357,7 @@ declare module "sap/ui/model/odata/v2/ODataModel" {
69314
69357
  /**
69315
69358
  * Paths to be reset; if no array is passed, all changes are reset
69316
69359
  */
69317
- aPath?: any[],
69360
+ aPath?: string[],
69318
69361
  /**
69319
69362
  * Whether also deferred requests are taken into account so that they are aborted
69320
69363
  */
@@ -70961,9 +71004,9 @@ declare module "sap/ui/model/odata/v4/Context" {
70961
71004
  * depending on this context become unresolved, but no attempt is made to restore these bindings in case
70962
71005
  * of reset or failure.
70963
71006
  *
70964
- * Deleting a node in a recursive hierarchy (see {@link sap.ui.model.odata.v4.ODataListBinding#setAggregation})
70965
- * is supported (@experimental as of version 1.118.0). As a precondition, the context must not be {@link #setKeepAlive kept-alive }
70966
- * and hidden (for example due to a filter), and the group ID must not have {@link sap.ui.model.odata.v4.SubmitMode.API}.
71007
+ * Since 1.125.0, deleting a node in a recursive hierarchy (see {@link sap.ui.model.odata.v4.ODataListBinding#setAggregation})
71008
+ * is supported. As a precondition, the context must not be both {@link #setKeepAlive kept-alive} and hidden
71009
+ * (for example due to a filter), and the group ID must not have {@link sap.ui.model.odata.v4.SubmitMode.API}.
70967
71010
  * Such a deletion is not a pending change.
70968
71011
  * See:
70969
71012
  * #hasPendingChanges
@@ -71273,7 +71316,7 @@ declare module "sap/ui/model/odata/v4/Context" {
71273
71316
  * not be shown anymore due to the search or filter criteria. If the latter happens to this context, its
71274
71317
  * {@link #getIndex index} becomes `undefined`.
71275
71318
  *
71276
- * @experimental (since 1.119.0)
71319
+ * @since 1.125.0
71277
71320
  *
71278
71321
  * @returns A promise which is resolved without a defined result when the move is finished, or rejected
71279
71322
  * in case of an error
@@ -71284,12 +71327,12 @@ declare module "sap/ui/model/odata/v4/Context" {
71284
71327
  */
71285
71328
  oParameters: {
71286
71329
  /**
71287
- * The next sibling's context, or `null` to turn this node into the last sibling (since 1.124.0). Omitting
71288
- * the sibling moves this node to a position determined by the server.
71330
+ * The next sibling's context, or `null` to turn this node into the last sibling. Omitting the sibling moves
71331
+ * this node to a position determined by the server.
71289
71332
  */
71290
71333
  nextSibling?: Context | null;
71291
71334
  /**
71292
- * The new parent's context, or (since 1.121.0) `null` to turn this node into a root node
71335
+ * The new parent's context, or `null` to turn this node into a root node
71293
71336
  */
71294
71337
  parent: Context | null;
71295
71338
  }
@@ -72558,14 +72601,19 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
72558
72601
  * has been read or if the system query option `$count` is `true` and the binding has processed at least
72559
72602
  * one request.
72560
72603
  *
72561
- * Creating a new child beneath an existing and visible parent node (which must either be a leaf or expanded,
72562
- * but not collapsed) is supported (@experimental as of version 1.117.0) in case of a recursive hierarchy
72563
- * (see {@link #setAggregation}). The parent node must be identified via an {@link sap.ui.model.odata.v4.Context }
72564
- * instance given as `oInitialData["@$ui5.node.parent"]` (which is immediately removed from the new child's
72565
- * data). It can be `null` or absent when creating a new root node (@experimental as of version 1.120.0).
72566
- * `bSkipRefresh` must be set, but both `bAtEnd` and `bInactive` must not be set. No other creation or {@link sap.ui.model.odata.v4.Context#move move }
72567
- * must be pending, and no other modification (including collapse of some ancestor node) must happen while
72568
- * this creation is pending!
72604
+ * Since 1.125.0, creating a new child beneath an existing and visible parent node (which must either be
72605
+ * a leaf or expanded, but not collapsed) is supported in case of a recursive hierarchy (see {@link #setAggregation}).
72606
+ * The parent node must be identified via an {@link sap.ui.model.odata.v4.Context} instance given as `oInitialData["@$ui5.node.parent"]`
72607
+ * (which is immediately removed from the new child's data). It can be `null` or absent when creating a
72608
+ * new root node. `bSkipRefresh` must be set, but both `bAtEnd` and `bInactive` must not be set. No other
72609
+ * creation or {@link sap.ui.model.odata.v4.Context#move move} must be pending, and no other modification
72610
+ * (including collapse of some ancestor node) must happen while this creation is pending! When using the
72611
+ * `createInPlace` parameter (see {@link #setAggregation}, @experimental as of version 1.125.0), the new
72612
+ * {@link sap.ui.model.odata.v4.Context#isTransient transient} child is hidden until it becomes {@link sap.ui.model.odata.v4.Context#created created},
72613
+ * and then it is shown at a position determined by the back end and the current sort order. The position
72614
+ * of the new child can be retrieved by using its {@link sap.ui.model.odata.v4.Context#getIndex index}.
72615
+ * If the created child does not become part of the hierarchy due to the search or filter criteria, the
72616
+ * context will be destroyed and its {@link sap.ui.model.odata.v4.Context#getIndex index} is set to `undefined`.
72569
72617
  *
72570
72618
  * @since 1.43.0
72571
72619
  *
@@ -72753,7 +72801,7 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
72753
72801
  getAggregation(
72754
72802
  /**
72755
72803
  * Whether to additionally return the "$"-prefixed values described below which obviously cannot be given
72756
- * back to the setter (@experimental as of version 1.111.0). They are retrieved from the pair of "Org.OData.Aggregation.V1.RecursiveHierarchy"
72804
+ * back to the setter (since 1.125.0). They are retrieved from the pair of "Org.OData.Aggregation.V1.RecursiveHierarchy"
72757
72805
  * and "com.sap.vocabularies.Hierarchy.v1.RecursiveHierarchy" annotations at this binding's entity type,
72758
72806
  * identified via the `hierarchyQualifier` given to {@link #setAggregation}.
72759
72807
  * "$DistanceFromRoot" holds the path to the property which provides the raw value for "@$ui5.node.level"
@@ -73206,14 +73254,13 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
73206
73254
  * An object holding the information needed for data aggregation; see also OData
73207
73255
  * Extension for Data Aggregation Version 4.0. Since 1.76.0, `undefined` can be used to remove the data
73208
73256
  * aggregation object, which allows to set `$apply` explicitly afterwards. `null` is not supported.
73209
- * Since 1.89.0, the deprecated property `"grandTotal like 1.84" : true` can be used to turn on the handling
73210
- * of grand totals like in 1.84.0, using aggregates of aggregates and thus allowing to filter by aggregated
73211
- * properties while grand totals are needed. Beware that methods like "average" or "countdistinct" are not
73212
- * compatible with this approach, and it cannot be combined with group levels.
73213
- * Since 1.105.0, either a recursive hierarchy or pure data aggregation is supported, but no mix; `hierarchyQualifier`
73214
- * is the leading property that decides between those two use cases - this is an **experimental API** and
73215
- * is only supported if the model uses the `autoExpandSelect` parameter! Since 1.117.0, it is available
73216
- * for read-only hierarchies.
73257
+ * Since 1.89.0, the **deprecated** property `"grandTotal like 1.84" : true` can be used to turn on the
73258
+ * handling of grand totals like in 1.84.0, using aggregates of aggregates and thus allowing to filter by
73259
+ * aggregated properties while grand totals are needed. Beware that methods like "average" or "countdistinct"
73260
+ * are not compatible with this approach, and it cannot be combined with group levels.
73261
+ * Since 1.117.0, either a read-only recursive hierarchy or pure data aggregation is supported, but no
73262
+ * mix; `hierarchyQualifier` is the leading property that decides between those two use cases. Since 1.125.0,
73263
+ * maintenance of a recursive hierarchy is supported.
73217
73264
  */
73218
73265
  oAggregation?: {
73219
73266
  /**
@@ -73233,12 +73280,17 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
73233
73280
  * `CASE WHEN MIN(Unit) = MAX(Unit) THEN MIN(Unit) END`)
73234
73281
  */
73235
73282
  aggregate?: object;
73283
+ /**
73284
+ * Whether created nodes are shown in place at the position specified by the service (@experimental as of
73285
+ * version 1.125.0); only the value `true` is allowed. Otherwise, created nodes are displayed out of place
73286
+ * as the first child of their parent.
73287
+ */
73288
+ createInPlace?: boolean;
73236
73289
  /**
73237
73290
  * The number (as a positive integer) of different levels initially available without calling {@link sap.ui.model.odata.v4.Context#expand }
73238
- * (@experimental as of version 1.105.0; available for read-only hierarchies since 1.117.0), supported only
73239
- * if a `hierarchyQualifier` is given. Root nodes are on the first level. By default, only root nodes are
73240
- * available; they are not yet expanded. Since 1.120.0, `expandTo >= Number.MAX_SAFE_INTEGER` can be used
73241
- * to expand all levels (`1E16` is recommended inside XML views for simplicity).
73291
+ * (since 1.117.0), supported only if a `hierarchyQualifier` is given. Root nodes are on the first level.
73292
+ * By default, only root nodes are available; they are not yet expanded. Since 1.120.0, `expandTo >= Number.MAX_SAFE_INTEGER`
73293
+ * can be used to expand all levels (`1E16` is recommended inside XML views for simplicity).
73242
73294
  */
73243
73295
  expandTo?: number;
73244
73296
  /**
@@ -73263,12 +73315,10 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
73263
73315
  groupLevels?: string[];
73264
73316
  /**
73265
73317
  * The qualifier for the pair of "Org.OData.Aggregation.V1.RecursiveHierarchy" and "com.sap.vocabularies.Hierarchy.v1.RecursiveHierarchy"
73266
- * annotations at this binding's entity type (@experimental as of version 1.105.0; available for read-only
73267
- * hierarchies since 1.117.0). If present, a recursive hierarchy without data aggregation is defined, and
73268
- * the only other supported properties are `expandTo` and `search`. A recursive hierarchy cannot be combined
73269
- * with:
73270
- * "$search", the `vGroup` parameter of {@link sap.ui.model.Sorter} (since 1.107.0), shared
73271
- * requests (since 1.108.0).
73318
+ * annotations at this binding's entity type (since 1.117.0). If present, a recursive hierarchy without
73319
+ * data aggregation is defined, and the only other supported properties are `createInPlace`, `expandTo`,
73320
+ * and `search`. A recursive hierarchy cannot be combined with:
73321
+ * "$search", the `vGroup` parameter of {@link sap.ui.model.Sorter}, shared requests.
73272
73322
  */
73273
73323
  hierarchyQualifier?: string;
73274
73324
  /**
@@ -74110,7 +74160,7 @@ declare module "sap/ui/model/odata/v4/ODataMetaModel" {
74110
74160
  * must refer to a function in `mParameters.scope` in case of a relative name starting with a dot, which
74111
74161
  * is stripped before lookup; see the `<template:alias>` instruction for XML Templating. In case of an
74112
74162
  * absolute name, it is searched in `mParameters.scope` first and then in the global namespace. (Using the
74113
- * global namespace is deprecated as of version 1.120.3). The names "requestCurrencyCodes" and "requestUnitsOfMeasure"
74163
+ * global namespace is **deprecated** as of version 1.120.3). The names "requestCurrencyCodes" and "requestUnitsOfMeasure"
74114
74164
  * default to {@link #requestCurrencyCodes} and {@link #requestUnitsOfMeasure} resp. if not present in `mParameters.scope`.
74115
74165
  * This function is called with the current object (or primitive value) and additional details and returns
74116
74166
  * the result of this {@link #requestObject} call. The additional details are given as an object with the
@@ -74219,8 +74269,8 @@ declare module "sap/ui/model/odata/v4/ODataMetaModel" {
74219
74269
  /**
74220
74270
  * Scope for lookup of aliases for computed annotations (since 1.43.0) as a map from alias to a module (like
74221
74271
  * `{AH : AnnotationHelper}`) or function (like `{format : AnnotationHelper.format}`); the alias must not
74222
- * contain a dot. Since 1.120.3 looking up a computed annotation via its global name is deprecated; always
74223
- * use this scope instead.
74272
+ * contain a dot. Since 1.120.3 looking up a computed annotation via its global name is **deprecated**;
74273
+ * always use this scope instead.
74224
74274
  */
74225
74275
  scope?: Record<string, object | Function>;
74226
74276
  }
@@ -74537,10 +74587,10 @@ declare module "sap/ui/model/odata/v4/ODataModel" {
74537
74587
  */
74538
74588
  supportReferences?: boolean;
74539
74589
  /**
74590
+ * **deprecated:** As of Version 1.110.0, this parameter is obsolete; see also {@link https://ui5.sap.com/#/topic/648e360fa22d46248ca783dc6eb44531 Data Reuse }
74540
74591
  * (Controls synchronization between different bindings which refer to the same data for the case data changes
74541
74592
  * in one binding. Must be set to 'None' which means bindings are not synchronized at all; all other values
74542
- * are not supported and lead to an error.) **deprecated:** As of Version 1.110.0, this parameter is obsolete;
74543
- * see also {@link https://ui5.sap.com/#/topic/648e360fa22d46248ca783dc6eb44531 Data Reuse}
74593
+ * are not supported and lead to an error.)
74544
74594
  */
74545
74595
  synchronizationMode?: string;
74546
74596
  /**
@@ -75031,7 +75081,7 @@ declare module "sap/ui/model/odata/v4/ODataModel" {
75031
75081
  * are not supported.
75032
75082
  *
75033
75083
  * It is possible to create binding contexts pointing to metadata. A '##' is recognized as separator in
75034
- * the resolved path and splits it into two parts; note that '#' may also be used as separator but is deprecated
75084
+ * the resolved path and splits it into two parts; note that '#' may also be used as separator but is **deprecated**
75035
75085
  * since 1.51. The part before the separator is transformed into a metadata context (see {@link sap.ui.model.odata.v4.ODataMetaModel#getMetaContext}).
75036
75086
  * The part following the separator is then interpreted relative to this metadata context, even if it starts
75037
75087
  * with a '/'; a trailing '/' is allowed here, see {@link sap.ui.model.odata.v4.ODataMetaModel#requestObject }
@@ -76533,7 +76583,7 @@ declare module "sap/ui/model/resource/ResourceModel" {
76533
76583
  */
76534
76584
  activeTerminologies?: string[];
76535
76585
  /**
76536
- * Whether the language bundle should be loaded asynchronously
76586
+ * **Deprecated as of Version 1.125**; always use asynchronous loading for performance reasons
76537
76587
  */
76538
76588
  async?: boolean;
76539
76589
  /**
@@ -87724,6 +87774,8 @@ declare namespace sap {
87724
87774
 
87725
87775
  "sap/ui/model/DataState": undefined;
87726
87776
 
87777
+ "sap/ui/model/FieldHelp": undefined;
87778
+
87727
87779
  "sap/ui/model/Filter": undefined;
87728
87780
 
87729
87781
  "sap/ui/model/FilterOperator": undefined;
@@ -1,4 +1,4 @@
1
- // For Library Version: 1.124.1
1
+ // For Library Version: 1.125.0
2
2
 
3
3
  declare namespace sap {
4
4
  interface IUI5DefineDependencyNames {
@@ -1,4 +1,4 @@
1
- // For Library Version: 1.124.1
1
+ // For Library Version: 1.125.0
2
2
 
3
3
  declare module "sap/ui/fl/library" {}
4
4
 
@@ -1469,49 +1469,12 @@ declare module "sap/ui/fl/write/_internal/fieldExtensibility/MultiTenantABAPExte
1469
1469
  }
1470
1470
 
1471
1471
  declare module "sap/ui/fl/write/_internal/fieldExtensibility/SingleTenantABAPExtensibilityVariant" {
1472
- import ABAPExtensibilityVariant from "sap/ui/fl/write/_internal/fieldExtensibility/ABAPExtensibilityVariant";
1473
-
1474
- import Metadata from "sap/ui/base/Metadata";
1475
-
1476
1472
  /**
1477
1473
  * Extension variant for ABAP single tenant environnments (via so called Custom Fields)
1478
1474
  *
1479
1475
  * @since 1.87
1480
1476
  */
1481
- interface SingleTenantABAPExtensibilityVariant
1482
- extends ABAPExtensibilityVariant {
1483
- /**
1484
- * Creates a new subclass of class sap.ui.fl.write._internal.fieldExtensibility.SingleTenantABAPExtensibilityVariant
1485
- * with name `sClassName` and enriches it with the information contained in `oClassInfo`.
1486
- *
1487
- * `oClassInfo` might contain the same kind of information as described in {@link sap.ui.fl.write._internal.fieldExtensibility.ABAPExtensibilityVariant.extend}.
1488
- *
1489
- *
1490
- * @returns Created class / constructor function
1491
- */
1492
- extend(
1493
- /**
1494
- * Name of the class being created
1495
- */
1496
- sClassName: string,
1497
- /**
1498
- * Object literal with information about the class
1499
- */
1500
- oClassInfo?: object,
1501
- /**
1502
- * Constructor function for the metadata object; if not given, it defaults to the metadata implementation
1503
- * used by this class
1504
- */
1505
- FNMetaImpl?: Function
1506
- ): Function;
1507
- /**
1508
- * Returns a metadata object for class sap.ui.fl.write._internal.fieldExtensibility.SingleTenantABAPExtensibilityVariant.
1509
- *
1510
- *
1511
- * @returns Metadata object describing this class
1512
- */
1513
- getMetadata(): Metadata;
1514
- }
1477
+ interface SingleTenantABAPExtensibilityVariant {}
1515
1478
  const SingleTenantABAPExtensibilityVariant: SingleTenantABAPExtensibilityVariant;
1516
1479
  export default SingleTenantABAPExtensibilityVariant;
1517
1480
  }
@@ -1619,6 +1582,8 @@ declare namespace sap {
1619
1582
 
1620
1583
  "sap/ui/fl/apply/_internal/flexState/DataSelector": undefined;
1621
1584
 
1585
+ "sap/ui/fl/apply/_internal/flexState/FlexObjectState": undefined;
1586
+
1622
1587
  "sap/ui/fl/apply/_internal/flexState/FlexState": undefined;
1623
1588
 
1624
1589
  "sap/ui/fl/apply/_internal/flexState/InitialPrepareFunctions": undefined;