@sapui5/ts-types-esm 1.145.1 → 1.147.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (69) hide show
  1. package/package.json +1 -1
  2. package/types/index.d.ts +3 -6
  3. package/types/sap.apf.d.ts +1 -1
  4. package/types/sap.ca.ui.d.ts +1 -1
  5. package/types/sap.chart.d.ts +4 -7
  6. package/types/sap.collaboration.d.ts +1 -1
  7. package/types/sap.esh.search.ui.d.ts +56 -67
  8. package/types/sap.f.d.ts +220 -527
  9. package/types/sap.fe.ariba.d.ts +1 -1
  10. package/types/sap.fe.controls.d.ts +1 -1
  11. package/types/sap.fe.core.d.ts +1 -1
  12. package/types/sap.fe.ina.d.ts +1 -1
  13. package/types/sap.fe.macros.d.ts +3921 -3221
  14. package/types/sap.fe.navigation.d.ts +1 -1
  15. package/types/sap.fe.placeholder.d.ts +1 -1
  16. package/types/sap.fe.plugins.managecache.d.ts +1 -1
  17. package/types/sap.fe.templates.d.ts +1 -1
  18. package/types/sap.fe.test.d.ts +49 -1
  19. package/types/sap.fe.tools.d.ts +1 -1
  20. package/types/sap.feedback.ui.d.ts +1 -1
  21. package/types/sap.gantt.d.ts +228 -1
  22. package/types/sap.insights.d.ts +14 -1
  23. package/types/{mobile-1.145.0-esm-d.ts → sap.m.d.ts} +596 -48
  24. package/types/sap.makit.d.ts +1 -1
  25. package/types/sap.me.d.ts +1 -1
  26. package/types/sap.ndc.d.ts +1 -1
  27. package/types/sap.ovp.d.ts +1 -1
  28. package/types/sap.rules.ui.d.ts +1 -1
  29. package/types/sap.sac.df.d.ts +1 -1
  30. package/types/sap.suite.ui.commons.d.ts +299 -10
  31. package/types/sap.suite.ui.generic.template.d.ts +79 -1
  32. package/types/sap.suite.ui.microchart.d.ts +1 -1
  33. package/types/sap.tnt.d.ts +9 -19
  34. package/types/sap.ui.codeeditor.d.ts +82 -46
  35. package/types/sap.ui.commons.d.ts +1 -1
  36. package/types/sap.ui.comp.d.ts +5 -15
  37. package/types/{core-1.145.0-esm-d.ts → sap.ui.core.d.ts} +1214 -396
  38. package/types/sap.ui.dt.d.ts +1 -1
  39. package/types/sap.ui.export.d.ts +1 -1
  40. package/types/sap.ui.fl.d.ts +9 -1
  41. package/types/sap.ui.generic.app.d.ts +5 -5
  42. package/types/sap.ui.generic.template.d.ts +1 -1
  43. package/types/sap.ui.geomap.d.ts +1 -1
  44. package/types/sap.ui.integration.d.ts +87 -290
  45. package/types/sap.ui.layout.d.ts +1 -1
  46. package/types/{mdc-1.145.0-esm-d.ts → sap.ui.mdc.d.ts} +113 -22
  47. package/types/sap.ui.richtexteditor.d.ts +6 -6
  48. package/types/sap.ui.rta.d.ts +1 -1
  49. package/types/sap.ui.suite.d.ts +1 -1
  50. package/types/sap.ui.support.d.ts +2 -2
  51. package/types/sap.ui.table.d.ts +1 -1
  52. package/types/sap.ui.testrecorder.d.ts +1 -1
  53. package/types/sap.ui.unified.d.ts +41 -11
  54. package/types/sap.ui.ux3.d.ts +1 -1
  55. package/types/sap.ui.vbm.d.ts +8 -24
  56. package/types/sap.ui.vk.d.ts +209 -2
  57. package/types/sap.ui.vtm.d.ts +2 -2
  58. package/types/sap.uiext.inbox.d.ts +1 -1
  59. package/types/sap.ushell.d.ts +609 -202
  60. package/types/sap.ushell_abap.d.ts +1 -1
  61. package/types/sap.uxap.d.ts +151 -2
  62. package/types/sap.viz.d.ts +4 -5
  63. package/types/sap.webanalytics.core.d.ts +1 -1
  64. package/types/sap.zen.commons.d.ts +1 -1
  65. package/types/sap.zen.crosstab.d.ts +1 -1
  66. package/types/sap.zen.dsh.d.ts +1 -1
  67. package/types/sap.ui.webc.common.d.ts +0 -164
  68. package/types/sap.ui.webc.fiori.d.ts +0 -16235
  69. package/types/sap.ui.webc.main.d.ts +0 -51365
@@ -279,7 +279,7 @@ declare namespace sap {
279
279
  "sap/ui/thirdparty/qunit-2": undefined;
280
280
  }
281
281
  }
282
- // For Library Version: 1.145.0
282
+ // For Library Version: 1.147.0
283
283
 
284
284
  declare module "sap/base/assert" {
285
285
  /**
@@ -5531,211 +5531,418 @@ declare module "sap/ui/events/ControlEvents" {
5531
5531
 
5532
5532
  declare module "sap/ui/events/KeyCodes" {
5533
5533
  /**
5534
+ * KeyCodes enumeration.
5535
+ *
5534
5536
  * @since 1.58
5535
5537
  */
5536
5538
  enum KeyCodes {
5539
+ /**
5540
+ * Letter A key
5541
+ */
5537
5542
  A = "65",
5538
-
5543
+ /**
5544
+ * Alt key
5545
+ */
5539
5546
  ALT = "18",
5540
-
5547
+ /**
5548
+ * Down arrow key
5549
+ */
5541
5550
  ARROW_DOWN = "40",
5542
-
5551
+ /**
5552
+ * Left arrow key
5553
+ */
5543
5554
  ARROW_LEFT = "37",
5544
-
5555
+ /**
5556
+ * Right arrow key
5557
+ */
5545
5558
  ARROW_RIGHT = "39",
5546
-
5559
+ /**
5560
+ * Up arrow key
5561
+ */
5547
5562
  ARROW_UP = "38",
5548
-
5563
+ /**
5564
+ * Letter B key
5565
+ */
5549
5566
  B = "66",
5550
-
5567
+ /**
5568
+ * Backslash (\) key
5569
+ */
5551
5570
  BACKSLASH = "226",
5552
-
5571
+ /**
5572
+ * Backspace key
5573
+ */
5553
5574
  BACKSPACE = "8",
5554
-
5575
+ /**
5576
+ * Pause/Break key
5577
+ */
5555
5578
  BREAK = "19",
5556
-
5579
+ /**
5580
+ * Letter C key
5581
+ */
5557
5582
  C = "67",
5558
-
5583
+ /**
5584
+ * Caps Lock key
5585
+ */
5559
5586
  CAPS_LOCK = "20",
5560
-
5587
+ /**
5588
+ * Comma (,) key
5589
+ */
5561
5590
  COMMA = "188",
5562
-
5591
+ /**
5592
+ * Context menu key
5593
+ */
5563
5594
  CONTEXT_MENU = "93",
5564
-
5595
+ /**
5596
+ * Control key
5597
+ */
5565
5598
  CONTROL = "17",
5566
-
5599
+ /**
5600
+ * Letter D key
5601
+ */
5567
5602
  D = "68",
5568
-
5603
+ /**
5604
+ * Delete key
5605
+ */
5569
5606
  DELETE = "46",
5570
-
5607
+ /**
5608
+ * Digit 0 key
5609
+ */
5571
5610
  DIGIT_0 = "48",
5572
-
5611
+ /**
5612
+ * Digit 1 key
5613
+ */
5573
5614
  DIGIT_1 = "49",
5574
-
5615
+ /**
5616
+ * Digit 2 key
5617
+ */
5575
5618
  DIGIT_2 = "50",
5576
-
5619
+ /**
5620
+ * Digit 3 key
5621
+ */
5577
5622
  DIGIT_3 = "51",
5578
-
5623
+ /**
5624
+ * Digit 4 key
5625
+ */
5579
5626
  DIGIT_4 = "52",
5580
-
5627
+ /**
5628
+ * Digit 5 key
5629
+ */
5581
5630
  DIGIT_5 = "53",
5582
-
5631
+ /**
5632
+ * Digit 6 key
5633
+ */
5583
5634
  DIGIT_6 = "54",
5584
-
5635
+ /**
5636
+ * Digit 7 key
5637
+ */
5585
5638
  DIGIT_7 = "55",
5586
-
5639
+ /**
5640
+ * Digit 8 key
5641
+ */
5587
5642
  DIGIT_8 = "56",
5588
-
5643
+ /**
5644
+ * Digit 9 key
5645
+ */
5589
5646
  DIGIT_9 = "57",
5590
-
5647
+ /**
5648
+ * Dot/period (.) key
5649
+ */
5591
5650
  DOT = "190",
5592
-
5651
+ /**
5652
+ * Letter E key
5653
+ */
5593
5654
  E = "69",
5594
-
5655
+ /**
5656
+ * End key
5657
+ */
5595
5658
  END = "35",
5596
-
5659
+ /**
5660
+ * Enter key
5661
+ */
5597
5662
  ENTER = "13",
5598
-
5663
+ /**
5664
+ * Equals (=) key
5665
+ */
5599
5666
  EQUALS = "221",
5600
-
5667
+ /**
5668
+ * Escape key
5669
+ */
5601
5670
  ESCAPE = "27",
5602
-
5671
+ /**
5672
+ * Letter F key
5673
+ */
5603
5674
  F = "70",
5604
-
5675
+ /**
5676
+ * F1 function key
5677
+ */
5605
5678
  F1 = "112",
5606
-
5679
+ /**
5680
+ * F10 function key
5681
+ */
5607
5682
  F10 = "121",
5608
-
5683
+ /**
5684
+ * F11 function key
5685
+ */
5609
5686
  F11 = "122",
5610
-
5687
+ /**
5688
+ * F12 function key
5689
+ */
5611
5690
  F12 = "123",
5612
-
5691
+ /**
5692
+ * F2 function key
5693
+ */
5613
5694
  F2 = "113",
5614
-
5695
+ /**
5696
+ * F3 function key
5697
+ */
5615
5698
  F3 = "114",
5616
-
5699
+ /**
5700
+ * F4 function key
5701
+ */
5617
5702
  F4 = "115",
5618
-
5703
+ /**
5704
+ * F5 function key
5705
+ */
5619
5706
  F5 = "116",
5620
-
5707
+ /**
5708
+ * F6 function key
5709
+ */
5621
5710
  F6 = "117",
5622
-
5711
+ /**
5712
+ * F7 function key
5713
+ */
5623
5714
  F7 = "118",
5624
-
5715
+ /**
5716
+ * F8 function key
5717
+ */
5625
5718
  F8 = "119",
5626
-
5719
+ /**
5720
+ * F9 function key
5721
+ */
5627
5722
  F9 = "120",
5628
-
5723
+ /**
5724
+ * Letter G key
5725
+ */
5629
5726
  G = "71",
5630
-
5727
+ /**
5728
+ * Grave accent (`) key
5729
+ */
5631
5730
  GREAT_ACCENT = "220",
5632
-
5731
+ /**
5732
+ * Letter H key
5733
+ */
5633
5734
  H = "72",
5634
-
5735
+ /**
5736
+ * Home key
5737
+ */
5635
5738
  HOME = "36",
5636
-
5739
+ /**
5740
+ * Letter I key
5741
+ */
5637
5742
  I = "73",
5638
-
5743
+ /**
5744
+ * Insert key
5745
+ */
5639
5746
  INSERT = "45",
5640
-
5747
+ /**
5748
+ * Letter J key
5749
+ */
5641
5750
  J = "74",
5642
-
5751
+ /**
5752
+ * Letter K key
5753
+ */
5643
5754
  K = "75",
5644
-
5755
+ /**
5756
+ * Letter L key
5757
+ */
5645
5758
  L = "76",
5646
-
5759
+ /**
5760
+ * Letter M key
5761
+ */
5647
5762
  M = "77",
5648
-
5763
+ /**
5764
+ * Minus (-) key
5765
+ */
5649
5766
  MINUS = "219",
5650
-
5767
+ /**
5768
+ * Letter N key
5769
+ */
5651
5770
  N = "78",
5652
-
5771
+ /**
5772
+ * Num Lock key
5773
+ */
5653
5774
  NUM_LOCK = "144",
5654
-
5775
+ /**
5776
+ * Numpad 0 key
5777
+ */
5655
5778
  NUMPAD_0 = "96",
5656
-
5779
+ /**
5780
+ * Numpad 1 key
5781
+ */
5657
5782
  NUMPAD_1 = "97",
5658
-
5783
+ /**
5784
+ * Numpad 2 key
5785
+ */
5659
5786
  NUMPAD_2 = "98",
5660
-
5787
+ /**
5788
+ * Numpad 3 key
5789
+ */
5661
5790
  NUMPAD_3 = "99",
5662
-
5791
+ /**
5792
+ * Numpad 4 key
5793
+ */
5663
5794
  NUMPAD_4 = "100",
5664
-
5795
+ /**
5796
+ * Numpad 5 key
5797
+ */
5665
5798
  NUMPAD_5 = "101",
5666
-
5799
+ /**
5800
+ * Numpad 6 key
5801
+ */
5667
5802
  NUMPAD_6 = "102",
5668
-
5803
+ /**
5804
+ * Numpad 7 key
5805
+ */
5669
5806
  NUMPAD_7 = "103",
5670
-
5807
+ /**
5808
+ * Numpad 8 key
5809
+ */
5671
5810
  NUMPAD_8 = "104",
5672
-
5811
+ /**
5812
+ * Numpad 9 key
5813
+ */
5673
5814
  NUMPAD_9 = "105",
5674
-
5815
+ /**
5816
+ * Numpad asterisk (*) key
5817
+ */
5675
5818
  NUMPAD_ASTERISK = "106",
5676
-
5819
+ /**
5820
+ * Numpad comma/decimal (.) key
5821
+ */
5677
5822
  NUMPAD_COMMA = "110",
5678
-
5823
+ /**
5824
+ * Numpad minus (-) key
5825
+ */
5679
5826
  NUMPAD_MINUS = "109",
5680
-
5827
+ /**
5828
+ * Numpad plus (+) key
5829
+ */
5681
5830
  NUMPAD_PLUS = "107",
5682
-
5831
+ /**
5832
+ * Numpad slash (/) key
5833
+ */
5683
5834
  NUMPAD_SLASH = "111",
5684
-
5835
+ /**
5836
+ * Letter O key
5837
+ */
5685
5838
  O = "79",
5686
-
5839
+ /**
5840
+ * Open bracket ([) key
5841
+ */
5687
5842
  OPEN_BRACKET = "186",
5688
-
5843
+ /**
5844
+ * Letter P key
5845
+ */
5689
5846
  P = "80",
5690
-
5847
+ /**
5848
+ * Page Down key
5849
+ */
5691
5850
  PAGE_DOWN = "34",
5692
-
5851
+ /**
5852
+ * Page Up key
5853
+ */
5693
5854
  PAGE_UP = "33",
5694
-
5855
+ /**
5856
+ * Pipe (|) key
5857
+ */
5695
5858
  PIPE = "191",
5696
-
5859
+ /**
5860
+ * Plus (+) key
5861
+ */
5697
5862
  PLUS = "187",
5698
-
5863
+ /**
5864
+ * Print Screen key
5865
+ */
5699
5866
  PRINT = "44",
5700
-
5867
+ /**
5868
+ * Letter Q key
5869
+ */
5701
5870
  Q = "81",
5702
-
5871
+ /**
5872
+ * Letter R key
5873
+ */
5703
5874
  R = "82",
5704
-
5875
+ /**
5876
+ * Letter S key
5877
+ */
5705
5878
  S = "83",
5706
-
5879
+ /**
5880
+ * Scroll Lock key
5881
+ */
5707
5882
  SCROLL_LOCK = "145",
5708
-
5883
+ /**
5884
+ * Semicolon (;) key
5885
+ */
5709
5886
  SEMICOLON = "192",
5710
-
5887
+ /**
5888
+ * Shift key
5889
+ */
5711
5890
  SHIFT = "16",
5712
-
5891
+ /**
5892
+ * Single quote (') key
5893
+ */
5713
5894
  SINGLE_QUOTE = "222",
5714
-
5895
+ /**
5896
+ * Slash (/) key
5897
+ */
5715
5898
  SLASH = "189",
5716
-
5899
+ /**
5900
+ * Sleep key
5901
+ */
5717
5902
  SLEEP = "95",
5718
-
5903
+ /**
5904
+ * Space bar key
5905
+ */
5719
5906
  SPACE = "32",
5720
-
5907
+ /**
5908
+ * Letter T key
5909
+ */
5721
5910
  T = "84",
5722
-
5911
+ /**
5912
+ * Tab key
5913
+ */
5723
5914
  TAB = "9",
5724
-
5915
+ /**
5916
+ * Turn off key
5917
+ */
5725
5918
  TURN_OFF = "94",
5726
-
5919
+ /**
5920
+ * Letter U key
5921
+ */
5727
5922
  U = "85",
5728
-
5923
+ /**
5924
+ * Letter V key
5925
+ */
5729
5926
  V = "86",
5730
-
5927
+ /**
5928
+ * Letter W key
5929
+ */
5731
5930
  W = "87",
5732
-
5931
+ /**
5932
+ * Windows key (or Meta key on Mac)
5933
+ */
5733
5934
  WINDOWS = "91",
5734
-
5935
+ /**
5936
+ * Letter X key
5937
+ */
5735
5938
  X = "88",
5736
-
5939
+ /**
5940
+ * Letter Y key
5941
+ */
5737
5942
  Y = "89",
5738
-
5943
+ /**
5944
+ * Letter Z key
5945
+ */
5739
5946
  Z = "90",
5740
5947
  }
5741
5948
  export default KeyCodes;
@@ -5795,6 +6002,24 @@ declare module "sap/ui/model/FilterProcessor" {
5795
6002
  * @since 1.71
5796
6003
  */
5797
6004
  interface FilterProcessor {
6005
+ /**
6006
+ * Combines control filters and application filters using AND and returns the resulting filter
6007
+ *
6008
+ * @since 1.146.0
6009
+ *
6010
+ * @returns A single filter containing all filters of the arrays combined or `undefined` if no filters are
6011
+ * given
6012
+ */
6013
+ combineFilters(
6014
+ /**
6015
+ * The control filters
6016
+ */
6017
+ aFilters?: Filter[],
6018
+ /**
6019
+ * The application filters
6020
+ */
6021
+ aApplicationFilters?: Filter[]
6022
+ ): Filter | undefined;
5798
6023
  /**
5799
6024
  * Groups filters according to their path and combines filters on the same path using "OR" and filters on
5800
6025
  * different paths using "AND", all multi-filters contained are ANDed.
@@ -7520,9 +7745,9 @@ declare module "sap/ui/model/odata/v2/ODataModel" {
7520
7745
  * has been resolved!
7521
7746
  *
7522
7747
  *
7523
- * @returns The meta model for this `ODataModel`
7748
+ * @returns The meta model for this `ODataModel`, or `undefined` if the model has been destroyed
7524
7749
  */
7525
- getMetaModel(): ODataMetaModel;
7750
+ getMetaModel(): ODataMetaModel | undefined;
7526
7751
  /**
7527
7752
  * Returns a JSON object that is a copy of the entity data referenced by the given `sPath` and `oContext`.
7528
7753
  * It does not load any data and may not return all requested data if it is not available.
@@ -11310,7 +11535,7 @@ declare module "sap/ui/app/Application" {
11310
11535
  * Returns the application root component.
11311
11536
  *
11312
11537
  * @since 1.13.1
11313
- * @deprecated As of version 1.14.
11538
+ * @deprecated As of version 1.14. superseded by {@link sap.ui.core.Component}.
11314
11539
  *
11315
11540
  * @returns The root component
11316
11541
  */
@@ -12392,8 +12617,8 @@ declare module "sap/ui/base/ManagedObject" {
12392
12617
  * ```
12393
12618
  *
12394
12619
  *
12395
- * Note that when setting string values, any curly braces in those values need to be escaped, so they are
12396
- * not interpreted as binding expressions. Use {@link #escapeSettingsValue} to do so.
12620
+ * Note that when setting string values, any curly braces and backslashes in those values need to be escaped,
12621
+ * so they are not interpreted as binding expressions. Use {@link #escapeSettingsValue} to do so.
12397
12622
  *
12398
12623
  * **Note:** As of version 1.120, providing aggregation content via an object literal is deprecated, in
12399
12624
  * case the object's type is given via the property 'Type' as a string, or is derived via the defined type
@@ -12514,8 +12739,8 @@ declare module "sap/ui/base/ManagedObject" {
12514
12739
  * ```
12515
12740
  *
12516
12741
  *
12517
- * Note that when setting string values, any curly braces in those values need to be escaped, so they are
12518
- * not interpreted as binding expressions. Use {@link #escapeSettingsValue} to do so.
12742
+ * Note that when setting string values, any curly braces and backslashes in those values need to be escaped,
12743
+ * so they are not interpreted as binding expressions. Use {@link #escapeSettingsValue} to do so.
12519
12744
  *
12520
12745
  * **Note:** As of version 1.120, providing aggregation content via an object literal is deprecated, in
12521
12746
  * case the object's type is given via the property 'Type' as a string, or is derived via the defined type
@@ -12579,17 +12804,46 @@ declare module "sap/ui/base/ManagedObject" {
12579
12804
  );
12580
12805
 
12581
12806
  /**
12582
- * Escapes the given value so it can be used in the constructor's settings object. Should be used when property
12583
- * values are initialized with static string values which could contain binding characters (curly braces).
12807
+ * Escapes the given value so it can be used in the constructor's settings object.
12808
+ *
12809
+ * Use this method when passing static string values that might contain binding syntax characters. Without
12810
+ * escaping, curly braces in strings would be misinterpreted as data binding expressions.
12811
+ *
12812
+ * **Characters that are escaped:**
12813
+ * - `{` (opening curly brace) - binding expression start
12814
+ * - `}` (closing curly brace) - binding expression end
12815
+ * - `\` (backslash) - escape character itself
12816
+ *
12817
+ * Each of the above characters is prefixed with a backslash, e.g. `{foo}` becomes `\{foo\}`.
12818
+ *
12819
+ * **When to use:**
12820
+ * - Static string values containing curly braces that should be displayed literally
12821
+ * - Rendering escaped backslashes (e.g. expecting `\\\\` to result in `\\`)
12822
+ * - User input or external data used as property values in constructors
12823
+ * - JSON content that should not be parsed as bindings
12824
+ *
12825
+ * Example usage:
12826
+ * ```javascript
12827
+ *
12828
+ * new MyControl({
12829
+ * // Without escaping: "{info}" would be interpreted as a binding to the path "info"
12830
+ * // With escaping: displays the literal text "{info}"
12831
+ * text: ManagedObject.escapeSettingsValue("{info}")
12832
+ * });
12833
+ * ```
12834
+ *
12835
+ *
12836
+ * **Note:** This is only needed when setting values via the constructor or {@link #applySettings}. Setter
12837
+ * method calls, e.g. `setText("{info}")` do not interpret binding syntax and thus do not require escaping.
12584
12838
  *
12585
12839
  * @since 1.52
12586
12840
  *
12587
- * @returns The given value, escaped for usage as static property value in the constructor's settings object
12588
- * (or unchanged, if not of type string)
12841
+ * @returns The escaped string value, or the original value if not a string
12589
12842
  */
12590
12843
  static escapeSettingsValue(
12591
12844
  /**
12592
- * Value to escape; only needs to be done for string values, but the call will work for all types
12845
+ * Value to escape; only strings are escaped, other types (e.g. objects) are returned through unchanged.
12846
+ * Strings nested in objects must be escaped individually.
12593
12847
  */
12594
12848
  vValue: any
12595
12849
  ): any;
@@ -13264,9 +13518,18 @@ declare module "sap/ui/base/ManagedObject" {
13264
13518
  * Destroys (all) the managed object(s) in the aggregation named `sAggregationName` and empties the aggregation.
13265
13519
  * If the aggregation did contain any object, this ManagedObject is marked as changed.
13266
13520
  *
13521
+ * **Note:** Destroying an aggregation by calling this method (or indirectly via `destroyXYZ`) does
13522
+ * not call the named aggregation mutators (`setXYZ` for a 0..1 aggregation, `removeXYZ` for
13523
+ * a 0..n aggregation) for the aggregated children. Controls that implement side effects in those methods
13524
+ * therefore must also implement similar side effects in their `destroyXYZ` method.
13525
+ *
13526
+ * While this is understood as inconvenient, it was decided (February 2026, after a thorough investigation),
13527
+ * not to change it. Too many existing controls depend on the current behavior, and, even worse, would have
13528
+ * severe problems with a changed behavior.
13529
+ *
13267
13530
  * **Note:** This method is a low-level API as described in the class documentation.
13268
13531
  * Applications or frameworks must not use this method to generically destroy all objects in an aggregation.
13269
- * Use the concrete method destroyXYZ for aggregation 'XYZ' instead.
13532
+ * Use the concrete method `destroyXYZ` for aggregation 'XYZ' instead.
13270
13533
  *
13271
13534
  * @ui5-protected Do not call from applications (only from related classes in the framework)
13272
13535
  *
@@ -14507,13 +14770,20 @@ declare module "sap/ui/base/ManagedObject" {
14507
14770
  */
14508
14771
  length?: int;
14509
14772
  /**
14510
- * The initial sort order (optional)
14773
+ * The initial sort order
14511
14774
  */
14512
14775
  sorter?: Sorter | Sorter[];
14513
14776
  /**
14514
- * The predefined filters for this aggregation (optional)
14777
+ * The predefined {@link sap.ui.model.FilterType.Application application filters} for this aggregation where
14778
+ * filter values are constants.
14515
14779
  */
14516
14780
  filters?: Filter | Filter[];
14781
+ /**
14782
+ * The predefined {@link sap.ui.model.FilterType.ApplicationBound bound application filters} for this aggregation.
14783
+ * Filter values support binding expressions. The aggregation updates its filters whenever a filter value
14784
+ * changes through data binding. Supported since 1.146.0.
14785
+ */
14786
+ boundFilters?: Filter | Filter[];
14517
14787
  /**
14518
14788
  * Name of the key property or a function getting the context as only parameter to calculate a key for entries.
14519
14789
  * This can be used to improve update behaviour in models, where a key is not already available.
@@ -17174,7 +17444,6 @@ declare module "sap/ui/core/library" {
17174
17444
  /**
17175
17445
  * Implementing this interface allows a control to be accessible via access keys.
17176
17446
  *
17177
- * @since 1.104
17178
17447
  * @experimental As of version 1.104.
17179
17448
  */
17180
17449
  export interface IAccessKeySupport {
@@ -17184,21 +17453,18 @@ declare module "sap/ui/core/library" {
17184
17453
  * Returns a refence to DOM element to be focused during Access key navigation. If not implemented getFocusDomRef()
17185
17454
  * method is used.
17186
17455
  *
17187
- * @since 1.104
17188
17456
  * @experimental As of version 1.104.
17189
17457
  */
17190
17458
  getAccessKeysFocusTarget?(): void;
17191
17459
  /**
17192
17460
  * If implemented called when access keys feature is enabled and highlighting is over
17193
17461
  *
17194
- * @since 1.104
17195
17462
  * @experimental As of version 1.104.
17196
17463
  */
17197
17464
  onAccKeysHighlightEnd?(): void;
17198
17465
  /**
17199
17466
  * If implemented called when access keys feature is enabled and highlighting is ongoing
17200
17467
  *
17201
- * @since 1.104
17202
17468
  * @experimental As of version 1.104.
17203
17469
  */
17204
17470
  onAccKeysHighlightStart?(): void;
@@ -18507,56 +18773,56 @@ declare module "sap/ui/core/CommandExecution" {
18507
18773
  import { PropertyBindingInfo } from "sap/ui/base/ManagedObject";
18508
18774
 
18509
18775
  /**
18776
+ * The CommandExecution registers a shortcut when it is added to the dependent aggregation of a control.
18777
+ * The shortcut information is retrieved from the owner components manifest (`/sap.ui5/commands/<command>`).
18778
+ *
18779
+ * You can use a CommandExecution instead of an event handler in XMLViews by using `cmd:` plus the command
18780
+ * name.
18781
+ *
18782
+ * Example for `sap.m.Button`:
18783
+ *
18784
+ *
18785
+ * ```javascript
18786
+ *
18787
+ * <Button press="cmd:MyCommand" />
18788
+ * ```
18789
+ *
18790
+ *
18791
+ * When the press event is fired, the CommandExecution will be triggered and the `execute` event is fired.
18792
+ *
18793
+ * When using commands, the component will create a model named `$cmd`. The model data provides the enabled
18794
+ * and visible state of all CommandExecutions. With that, action-triggering controls (e.g. a button) can
18795
+ * be bound to the enable/visible property of the CommandExecution to centrally control their state.
18796
+ *
18797
+ * **Note: The usage of the `$cmd` model is restricted to `sap.suite.ui.generic`**
18798
+ *
18799
+ * When binding a button's enabled state to this model, it follows the enabled state of the CommandExecution.
18800
+ * The binding path must be relative like `myCommand/enabled`:
18801
+ *
18802
+ *
18803
+ * ```javascript
18804
+ *
18805
+ * <Button press="cmd:MyCommand" enabled="$cmd>MyCommand/enabled" />
18806
+ * ```
18807
+ *
18808
+ *
18809
+ * A CommandExecution can have three states:
18810
+ * - the CommandExecution is visible and enabled. If the configured shortcut is executed, the configured
18811
+ * event handler of this CommandExecution is called
18812
+ * - the CommandExecution is visible but not enabled. If the configured shortcut is executed, neither
18813
+ * the configured event handler of this CommandExecution nor any event handler configured on CommandExecutions
18814
+ * in the ancestor chain is called
18815
+ * - the CommandExecution is not visible. If the configured shortcut is executed, the configured event
18816
+ * handler of this CommandExecution is not called, but the event is propagated to its parent, which can
18817
+ * then handle the event by a configured CommandExecution or propagate the event to its parent, until no
18818
+ * parent exits anymore and the browser can handle the executed shortcut
18819
+ *
18510
18820
  * @since 1.70
18511
18821
  */
18512
18822
  export default class CommandExecution extends UI5Element {
18513
18823
  /**
18514
18824
  * Creates and initializes a new CommandExecution.
18515
18825
  *
18516
- * The CommandExecution registers a shortcut when it is added to the dependent aggregation of a control.
18517
- * The shortcut information is retrieved from the owner components manifest (`/sap.ui5/commands/<command>`).
18518
- *
18519
- * You can use a CommandExecution instead of an event handler in XMLViews by using `cmd:` plus the command
18520
- * name.
18521
- *
18522
- * Example for `sap.m.Button`:
18523
- *
18524
- *
18525
- * ```javascript
18526
- *
18527
- * <Button press="cmd:MyCommand" />
18528
- * ```
18529
- *
18530
- *
18531
- * When the press event is fired, the CommandExecution will be triggered and the `execute` event is fired.
18532
- *
18533
- * When using commands, the component will create a model named `$cmd`. The model data provides the enabled
18534
- * and visible state of all CommandExecutions. With that, action-triggering controls (e.g. a button) can
18535
- * be bound to the enable/visible property of the CommandExecution to centrally control their state.
18536
- *
18537
- * **Note: The usage of the `$cmd` model is restricted to `sap.suite.ui.generic`**
18538
- *
18539
- * When binding a button's enabled state to this model, it follows the enabled state of the CommandExecution.
18540
- * The binding path must be relative like `myCommand/enabled`:
18541
- *
18542
- *
18543
- * ```javascript
18544
- *
18545
- * <Button press="cmd:MyCommand" enabled="$cmd>MyCommand/enabled" />
18546
- * ```
18547
- *
18548
- *
18549
- * A CommandExecution can have three states:
18550
- * - the CommandExecution is visible and enabled. If the configured shortcut is executed, the configured
18551
- * event handler of this CommandExecution is called
18552
- * - the CommandExecution is visible but not enabled. If the configured shortcut is executed, neither
18553
- * the configured event handler of this CommandExecution nor any event handler configured on CommandExecutions
18554
- * in the ancestor chain is called
18555
- * - the CommandExecution is not visible. If the configured shortcut is executed, the configured event
18556
- * handler of this CommandExecution is not called, but the event is propagated to its parent, which can
18557
- * then handle the event by a configured CommandExecution or propagate the event to its parent, until no
18558
- * parent exits anymore and the browser can handle the executed shortcut
18559
- *
18560
18826
  * Accepts an object literal `mSettings` that defines initial property values, aggregated and associated
18561
18827
  * objects as well as event handlers. See {@link sap.ui.base.ManagedObject#constructor} for a general description
18562
18828
  * of the syntax of the settings object.
@@ -24531,24 +24797,24 @@ declare module "sap/ui/core/Core" {
24531
24797
  * ```
24532
24798
  *
24533
24799
  *
24534
- * If parts of the theme are at different locations (e.g. because you provide a standard theme like "sap_belize"
24800
+ * If parts of the theme are at different locations (e.g. because you provide a standard theme like "sap_horizon"
24535
24801
  * for a custom control library and this self-made part of the standard theme is at a different location
24536
24802
  * than the UI5 resources), you can also specify for which control libraries the setting should be used,
24537
24803
  * by giving an array with the names of the respective control libraries as second parameter:
24538
24804
  * ```javascript
24539
24805
  *
24540
- * sap.ui.getCore().setThemeRoot("sap_belize", ["my.own.library"], "https://mythemeserver.com/allThemes");
24806
+ * sap.ui.getCore().setThemeRoot("sap_horizon", ["my.own.library"], "https://mythemeserver.com/allThemes");
24541
24807
  * ```
24542
24808
  *
24543
24809
  *
24544
- * This will cause the Belize theme to be loaded from the UI5 location for all standard libraries. Resources
24810
+ * This will cause the Horizon theme to be loaded from the UI5 location for all standard libraries. Resources
24545
24811
  * for styling the `my.own.library` controls will be loaded from the configured location:
24546
24812
  * ```javascript
24547
24813
  *
24548
- * https://sdk.openui5.org/resources/sap/ui/core/themes/sap_belize/library.css
24549
- * https://sdk.openui5.org/resources/sap/ui/layout/themes/sap_belize/library.css
24550
- * https://sdk.openui5.org/resources/sap/m/themes/sap_belize/library.css
24551
- * https://mythemeserver.com/allThemes/my/own/library/themes/sap_belize/library.css
24814
+ * https://sdk.openui5.org/resources/sap/ui/core/themes/sap_horizon/library.css
24815
+ * https://sdk.openui5.org/resources/sap/ui/layout/themes/sap_horizon/library.css
24816
+ * https://sdk.openui5.org/resources/sap/m/themes/sap_horizon/library.css
24817
+ * https://mythemeserver.com/allThemes/my/own/library/themes/sap_horizon/library.css
24552
24818
  * ```
24553
24819
  *
24554
24820
  *
@@ -24602,24 +24868,24 @@ declare module "sap/ui/core/Core" {
24602
24868
  * ```
24603
24869
  *
24604
24870
  *
24605
- * If parts of the theme are at different locations (e.g. because you provide a standard theme like "sap_belize"
24871
+ * If parts of the theme are at different locations (e.g. because you provide a standard theme like "sap_horizon"
24606
24872
  * for a custom control library and this self-made part of the standard theme is at a different location
24607
24873
  * than the UI5 resources), you can also specify for which control libraries the setting should be used,
24608
24874
  * by giving an array with the names of the respective control libraries as second parameter:
24609
24875
  * ```javascript
24610
24876
  *
24611
- * sap.ui.getCore().setThemeRoot("sap_belize", ["my.own.library"], "https://mythemeserver.com/allThemes");
24877
+ * sap.ui.getCore().setThemeRoot("sap_horizon", ["my.own.library"], "https://mythemeserver.com/allThemes");
24612
24878
  * ```
24613
24879
  *
24614
24880
  *
24615
- * This will cause the Belize theme to be loaded from the UI5 location for all standard libraries. Resources
24881
+ * This will cause the Horizon theme to be loaded from the UI5 location for all standard libraries. Resources
24616
24882
  * for styling the `my.own.library` controls will be loaded from the configured location:
24617
24883
  * ```javascript
24618
24884
  *
24619
- * https://sdk.openui5.org/resources/sap/ui/core/themes/sap_belize/library.css
24620
- * https://sdk.openui5.org/resources/sap/ui/layout/themes/sap_belize/library.css
24621
- * https://sdk.openui5.org/resources/sap/m/themes/sap_belize/library.css
24622
- * https://mythemeserver.com/allThemes/my/own/library/themes/sap_belize/library.css
24885
+ * https://sdk.openui5.org/resources/sap/ui/core/themes/sap_horizon/library.css
24886
+ * https://sdk.openui5.org/resources/sap/ui/layout/themes/sap_horizon/library.css
24887
+ * https://sdk.openui5.org/resources/sap/m/themes/sap_horizon/library.css
24888
+ * https://mythemeserver.com/allThemes/my/own/library/themes/sap_horizon/library.css
24623
24889
  * ```
24624
24890
  *
24625
24891
  *
@@ -31432,6 +31698,8 @@ declare module "sap/ui/core/Fragment" {
31432
31698
  /**
31433
31699
  * Gets current value of property {@link #getType type}.
31434
31700
  *
31701
+ * The Fragment type.
31702
+ *
31435
31703
  *
31436
31704
  * @returns Value of property `type`
31437
31705
  */
@@ -31439,6 +31707,8 @@ declare module "sap/ui/core/Fragment" {
31439
31707
  /**
31440
31708
  * Sets a new value for property {@link #getType type}.
31441
31709
  *
31710
+ * The Fragment type.
31711
+ *
31442
31712
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
31443
31713
  *
31444
31714
  *
@@ -31455,6 +31725,9 @@ declare module "sap/ui/core/Fragment" {
31455
31725
  * Describes the settings that can be provided to the Fragment constructor.
31456
31726
  */
31457
31727
  export interface $FragmentSettings extends $ManagedObjectSettings {
31728
+ /**
31729
+ * The Fragment type.
31730
+ */
31458
31731
  type?: string | PropertyBindingInfo;
31459
31732
 
31460
31733
  fragmentName?: string;
@@ -34236,8 +34509,9 @@ declare module "sap/ui/core/Lib" {
34236
34509
  * is e.g. useful when an application merges the CSS for multiple libraries and already loaded the resulting
34237
34510
  * stylesheet.
34238
34511
  *
34239
- * If a list of library `dependencies` is specified in the info object, those libraries will be loaded
34240
- * synchronously if they haven't been loaded yet.
34512
+ *
34513
+ * - If a list of library `dependencies` is specified in the info object, those libraries will be loaded
34514
+ * synchronously if they haven't been loaded yet.
34241
34515
  *
34242
34516
  * **Note:** Dependencies between libraries have to be modeled consistently in several places:
34243
34517
  * - Both eager and lazy dependencies have to be modelled in the `.library` file.
@@ -34268,10 +34542,72 @@ declare module "sap/ui/core/Lib" {
34268
34542
  * Library API-Version 2:
34269
34543
  *
34270
34544
  * The Library API Version 2 has been introduced to avoid access to the global namespace when retrieving
34271
- * enum types. With Library API Version 2 a library must declare its enum types via {@link module:sap/ui/base/DataType.registerEnum DataType.registerEnum}.
34545
+ * enum types. With Library API Version 2 a library must declare its enum types via {@link sap.ui.base.DataType.registerEnum }
34546
+ * as described in the "Defining Enums" section below.
34547
+ *
34548
+ * Library API version 2 is defined as a number (int) in the library's `init()` call:
34549
+ * ```javascript
34550
+ *
34551
+ * var thisLib = Library.init({
34552
+ * apiVersion: 2,
34553
+ * name: "my.library",
34554
+ * ...
34555
+ * });
34556
+ * ```
34557
+ *
34558
+ *
34559
+ * **Important:** The object returned by `Library.init()` should be used as the return value of the `library.js`
34560
+ * module.
34561
+ *
34562
+ * **Defining Enums**
34563
+ *
34564
+ * Enums that are exposed through a library (not as separate modules) should be defined as properties on
34565
+ * the object returned by `Library.init()`. Each enum must be registered via {@link sap.ui.base.DataType.registerEnum }
34566
+ * to make it available to the framework.
34567
+ *
34568
+ * Example for a simple enum definition:
34569
+ * ```javascript
34570
+ *
34571
+ * // The return value "thisLib" will be used to expose enums
34572
+ * var thisLib = Library.init({
34573
+ * apiVersion: 2,
34574
+ * name: "my.library",
34575
+ * ...
34576
+ * });
34577
+ *
34578
+ * // Note that enum keys and values must match
34579
+ * thisLib.MyEnumType = {
34580
+ * Small: "Small",
34581
+ * Medium: "Medium",
34582
+ * Large: "Large"
34583
+ * };
34584
+ *
34585
+ * // make sure to register the enum and make it know to the framework for later type checks
34586
+ * DataType.registerEnum("my.library.MyEnumType", thisLib.MyEnumType);
34587
+ * ```
34588
+ *
34589
+ *
34590
+ * **Special case: enums in nested namespaces**
34591
+ *
34592
+ * Ensure to create the namespace first and then define the enum:
34593
+ *
34594
+ *
34595
+ * ```javascript
34596
+ *
34597
+ * thisLib.cards = thisLib.cards || {};
34598
+ *
34599
+ * thisLib.cards.HeaderPosition = {
34600
+ * Top: "Top",
34601
+ * Bottom: "Bottom"
34602
+ * };
34603
+ *
34604
+ * DataType.registerEnum("my.library.cards.HeaderPosition", thisLib.cards.HeaderPosition);
34605
+ * ```
34272
34606
  *
34273
34607
  *
34274
- * @returns Returns the library namespace, based on the given library name.
34608
+ *
34609
+ * @returns Returns an object with the exports of the library (enums, helpers, ...). This object should
34610
+ * be used as the return value of the `library.js` module from which `Library.init` is called.
34275
34611
  */
34276
34612
  static init(
34277
34613
  /**
@@ -39710,7 +40046,8 @@ declare module "sap/ui/core/mvc/ViewType" {
39710
40046
  /**
39711
40047
  * JS View
39712
40048
  *
39713
- * @deprecated As of version 1.90.
40049
+ * @deprecated As of version 1.90. Consider using {@link sap.ui.core.mvx.XMLView XMLViews} or "typed views"
40050
+ * (view classes written in JavaScript) instead.
39714
40051
  */
39715
40052
  JS = "JS",
39716
40053
  /**
@@ -39723,7 +40060,8 @@ declare module "sap/ui/core/mvc/ViewType" {
39723
40060
  /**
39724
40061
  * Template View
39725
40062
  *
39726
- * @deprecated As of version 1.56.
40063
+ * @deprecated As of version 1.56. Consider using {@link sap.ui.core.mvx.XMLView XMLViews} or "typed views"
40064
+ * (view classes written in JavaScript) instead.
39727
40065
  */
39728
40066
  Template = "Template",
39729
40067
  /**
@@ -40366,6 +40704,9 @@ declare module "sap/ui/core/Popup" {
40366
40704
  * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
40367
40705
  * otherwise it will be bound to this `sap.ui.core.Popup` itself.
40368
40706
  *
40707
+ * Fired when the popup has completely closed (after any animation).
40708
+ *
40709
+ * @since 1.2
40369
40710
  *
40370
40711
  * @returns Reference to `this` in order to allow method chaining
40371
40712
  */
@@ -40390,6 +40731,9 @@ declare module "sap/ui/core/Popup" {
40390
40731
  * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
40391
40732
  * otherwise it will be bound to this `sap.ui.core.Popup` itself.
40392
40733
  *
40734
+ * Fired when the popup has completely closed (after any animation).
40735
+ *
40736
+ * @since 1.2
40393
40737
  *
40394
40738
  * @returns Reference to `this` in order to allow method chaining
40395
40739
  */
@@ -40409,6 +40753,9 @@ declare module "sap/ui/core/Popup" {
40409
40753
  * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
40410
40754
  * otherwise it will be bound to this `sap.ui.core.Popup` itself.
40411
40755
  *
40756
+ * Fired when the popup has completely opened (after any animation).
40757
+ *
40758
+ * @since 1.2
40412
40759
  *
40413
40760
  * @returns Reference to `this` in order to allow method chaining
40414
40761
  */
@@ -40433,6 +40780,9 @@ declare module "sap/ui/core/Popup" {
40433
40780
  * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
40434
40781
  * otherwise it will be bound to this `sap.ui.core.Popup` itself.
40435
40782
  *
40783
+ * Fired when the popup has completely opened (after any animation).
40784
+ *
40785
+ * @since 1.2
40436
40786
  *
40437
40787
  * @returns Reference to `this` in order to allow method chaining
40438
40788
  */
@@ -40470,6 +40820,7 @@ declare module "sap/ui/core/Popup" {
40470
40820
  *
40471
40821
  * The passed function and listener object must match the ones used for event registration.
40472
40822
  *
40823
+ * @since 1.2
40473
40824
  *
40474
40825
  * @returns Reference to `this` in order to allow method chaining
40475
40826
  */
@@ -40488,6 +40839,7 @@ declare module "sap/ui/core/Popup" {
40488
40839
  *
40489
40840
  * The passed function and listener object must match the ones used for event registration.
40490
40841
  *
40842
+ * @since 1.2
40491
40843
  *
40492
40844
  * @returns Reference to `this` in order to allow method chaining
40493
40845
  */
@@ -40509,6 +40861,7 @@ declare module "sap/ui/core/Popup" {
40509
40861
  /**
40510
40862
  * Fires event {@link #event:closed closed} to attached listeners.
40511
40863
  *
40864
+ * @since 1.2
40512
40865
  * @ui5-protected Do not call from applications (only from related classes in the framework)
40513
40866
  *
40514
40867
  * @returns Reference to `this` in order to allow method chaining
@@ -40522,6 +40875,7 @@ declare module "sap/ui/core/Popup" {
40522
40875
  /**
40523
40876
  * Fires event {@link #event:opened opened} to attached listeners.
40524
40877
  *
40878
+ * @since 1.2
40525
40879
  * @ui5-protected Do not call from applications (only from related classes in the framework)
40526
40880
  *
40527
40881
  * @returns Reference to `this` in order to allow method chaining
@@ -40877,34 +41231,65 @@ declare module "sap/ui/core/Popup" {
40877
41231
  * This enum is part of the 'sap/ui/core/Popup' module export and must be accessed by the property 'Dock'.
40878
41232
  */
40879
41233
  enum Dock {
41234
+ /**
41235
+ * Docks the popup at the begin of the reference element, at the bottom.
41236
+ */
40880
41237
  BeginBottom = "BeginBottom",
40881
-
41238
+ /**
41239
+ * Docks the popup at the begin of the reference element, vertically centered.
41240
+ */
40882
41241
  BeginCenter = "BeginCenter",
40883
-
41242
+ /**
41243
+ * Docks the popup at the begin of the reference element, at the top.
41244
+ */
40884
41245
  BeginTop = "BeginTop",
40885
-
41246
+ /**
41247
+ * Docks the popup horizontally centered to the reference element, at the bottom.
41248
+ */
40886
41249
  CenterBottom = "CenterBottom",
40887
-
41250
+ /**
41251
+ * Docks the popup horizontally and vertically centered to the reference element.
41252
+ */
40888
41253
  CenterCenter = "CenterCenter",
40889
-
41254
+ /**
41255
+ * Docks the popup horizontally centered to the reference element, at the top.
41256
+ */
40890
41257
  CenterTop = "CenterTop",
40891
-
41258
+ /**
41259
+ * Docks the popup at the end of the reference element, at the bottom.
41260
+ */
40892
41261
  EndBottom = "EndBottom",
40893
-
41262
+ /**
41263
+ * Docks the popup at the end of the reference element, vertically centered.
41264
+ */
40894
41265
  EndCenter = "EndCenter",
40895
-
41266
+ /**
41267
+ * Docks the popup at the end of the reference element, at the top.
41268
+ */
40896
41269
  EndTop = "EndTop",
40897
-
41270
+ /**
41271
+ * Docks the popup at the left side of the reference element, at the bottom.
41272
+ */
40898
41273
  LeftBottom = "LeftBottom",
40899
-
41274
+ /**
41275
+ * Docks the popup at the left side of the reference element, vertically centered.
41276
+ */
40900
41277
  LeftCenter = "LeftCenter",
40901
-
41278
+ /**
41279
+ * Docks the popup at the left side of the reference element, at the top.
41280
+ */
40902
41281
  LeftTop = "LeftTop",
40903
-
41282
+ /**
41283
+ * Docks the popup at the right side of the reference element, at the bottom.
41284
+ */
40904
41285
  RightBottom = "RightBottom",
40905
-
41286
+ /**
41287
+ * Docks the popup at the right side of the reference element, vertically centered.
41288
+ */
40906
41289
  RightCenter = "RightCenter",
40907
-
41290
+ /**
41291
+ * Docks the popup at the right side of the reference element, at the top.
41292
+ */
40908
41293
  RightTop = "RightTop",
40909
41294
  }
40910
41295
 
@@ -40927,8 +41312,18 @@ declare module "sap/ui/core/Popup" {
40927
41312
  * Describes the settings that can be provided to the Popup constructor.
40928
41313
  */
40929
41314
  export interface $PopupSettings extends $ManagedObjectSettings {
41315
+ /**
41316
+ * Fired when the popup has completely opened (after any animation).
41317
+ *
41318
+ * @since 1.2
41319
+ */
40930
41320
  opened?: (oEvent: Event) => void;
40931
41321
 
41322
+ /**
41323
+ * Fired when the popup has completely closed (after any animation).
41324
+ *
41325
+ * @since 1.2
41326
+ */
40932
41327
  closed?: (oEvent: Event) => void;
40933
41328
  }
40934
41329
 
@@ -41843,6 +42238,59 @@ declare module "sap/ui/core/RenderManager" {
41843
42238
  */
41844
42239
  oTargetDomNode: Element
41845
42240
  ): void;
42241
+ /**
42242
+ * Executes a rendering callback and flushes the result into the provided DOM node.
42243
+ *
42244
+ * The rendering callback receives a RenderManager instance with the semantic rendering API implementation
42245
+ * (DOM interface methods like `openStart`, `attr`, `openEnd`, `text`, `close`, etc.).
42246
+ *
42247
+ * This method combines rendering and flushing in a single call, automatically handling non-HTML namespaces
42248
+ * (e.g., SVG, MathML) by detecting the namespace of the target DOM node.
42249
+ *
42250
+ * **Difference from calling render() then flush() separately:** When rendering into a non-HTML namespace
42251
+ * context (e.g., SVG or MathML elements), this method automatically detects the target node's namespace
42252
+ * and applies it as a fallback namespace for the rendering operation. This ensures that elements created
42253
+ * without an explicit parent element (such as when rendering into a DocumentFragment initially) inherit
42254
+ * the correct namespace.
42255
+ *
42256
+ * This function must not be called within control renderers.
42257
+ *
42258
+ * Usage:
42259
+ * ```javascript
42260
+ *
42261
+ * const oRM = new RenderManager().getInterface();
42262
+ *
42263
+ * // assume that oSvgContainer is already part of the DOM and we want to render a circle into it
42264
+ * oRM.renderAndFlush(function(oRM) {
42265
+ * oRM.openStart("circle").attr("cx", "50").attr("cy", "50").attr("r", "40");
42266
+ * oRM.openEnd();
42267
+ * oRM.close("circle");
42268
+ * }, oSvgContainer);
42269
+ *
42270
+ * oRM.destroy();
42271
+ * ```
42272
+ *
42273
+ *
42274
+ * @since 1.147
42275
+ *
42276
+ * @returns Reference to `this` to allow method chaining
42277
+ */
42278
+ renderAndFlush(
42279
+ /**
42280
+ * Rendering callback that receives a RenderManager instance with the semantic rendering API implementation
42281
+ * (DOM interface methods like `openStart`, `attr`, `openEnd`, `text`, `close`, etc.)
42282
+ */
42283
+ fnRender: (p1: RenderManager) => void,
42284
+ /**
42285
+ * Node in the DOM where the result should be flushed into
42286
+ */
42287
+ oTargetDomNode: Element,
42288
+ /**
42289
+ * Determines whether the buffer of the target DOM node is expanded (`true`) or replaced (`false`), or the
42290
+ * new entry is inserted at a specific position (value of type `int`)
42291
+ */
42292
+ vInsert?: boolean | int
42293
+ ): this;
41846
42294
  /**
41847
42295
  * Turns the given control into its HTML representation and appends it to the rendering buffer.
41848
42296
  *
@@ -43191,34 +43639,6 @@ declare module "sap/ui/core/routing/Target" {
43191
43639
  * @returns Metadata object describing this class
43192
43640
  */
43193
43641
  static getMetadata(): Metadata;
43194
- /**
43195
- * This function is called between the target view is loaded and the view is added to the container.
43196
- *
43197
- * This function can be used for applying modification on the view or the container to make the rerendering
43198
- * occur together with the later aggregation change.
43199
- *
43200
- * @since 1.46.1
43201
- * @ui5-protected Do not call from applications (only from related classes in the framework)
43202
- */
43203
- _beforePlacingViewIntoContainer(
43204
- /**
43205
- * the object containing the arguments
43206
- */
43207
- mArguments: {
43208
- /**
43209
- * the container where the view will be added
43210
- */
43211
- container: Control;
43212
- /**
43213
- * the view which will be added to the container
43214
- */
43215
- view: Control;
43216
- /**
43217
- * the data passed from {@link sap.ui.core.routing.Target#display} method
43218
- */
43219
- data?: object;
43220
- }
43221
- ): void;
43222
43642
  /**
43223
43643
  * Attaches event handler `fnFunction` to the {@link #event:display display} event of this `sap.ui.core.routing.Target`.
43224
43644
  *
@@ -43262,6 +43682,37 @@ declare module "sap/ui/core/routing/Target" {
43262
43682
  */
43263
43683
  oListener?: object
43264
43684
  ): this;
43685
+ /**
43686
+ * This function is called between the target view is loaded and the view is added to the container.
43687
+ *
43688
+ * This function can be used for applying modification on the view or the container to make the rerendering
43689
+ * occur together with the later aggregation change.
43690
+ *
43691
+ * **Note:** This function was previously named `_beforePlacingViewIntoContainer` (with a leading underscore)
43692
+ * and has been renamed to be protected instead of private.
43693
+ *
43694
+ * @since 1.46.1
43695
+ * @ui5-protected Do not call from applications (only from related classes in the framework)
43696
+ */
43697
+ beforePlacingViewIntoContainer(
43698
+ /**
43699
+ * the object containing the arguments
43700
+ */
43701
+ mArguments: {
43702
+ /**
43703
+ * the container where the view will be added
43704
+ */
43705
+ container: Control;
43706
+ /**
43707
+ * the view which will be added to the container
43708
+ */
43709
+ view: Control;
43710
+ /**
43711
+ * the data passed from {@link sap.ui.core.routing.Target#display} method
43712
+ */
43713
+ data?: object;
43714
+ }
43715
+ ): void;
43265
43716
  /**
43266
43717
  * Destroys the target, will be called by {@link sap.m.routing.Targets} don't call this directly.
43267
43718
  *
@@ -51746,16 +52197,29 @@ declare module "sap/ui/core/util/MockServer" {
51746
52197
  * 'HTTPMETHOD'.
51747
52198
  */
51748
52199
  enum HTTPMETHOD {
52200
+ /**
52201
+ * HTTP DELETE method.
52202
+ */
51749
52203
  DELETE = "DELETE",
51750
-
52204
+ /**
52205
+ * HTTP GET method.
52206
+ */
51751
52207
  GET = "GET",
51752
-
52208
+ /**
52209
+ * HTTP MERGE method.
52210
+ */
51753
52211
  MERGE = "MERGE",
51754
-
52212
+ /**
52213
+ * HTTP PATCH method.
52214
+ */
51755
52215
  PATCH = "PATCH",
51756
-
52216
+ /**
52217
+ * HTTP POST method.
52218
+ */
51757
52219
  POST = "POST",
51758
-
52220
+ /**
52221
+ * HTTP PUT method.
52222
+ */
51759
52223
  PUT = "PUT",
51760
52224
  }
51761
52225
 
@@ -52839,6 +53303,9 @@ declare module "sap/ui/core/ws/SapPcpWebSocket" {
52839
53303
  * 'SUPPORTED_PROTOCOLS'.
52840
53304
  */
52841
53305
  enum SUPPORTED_PROTOCOLS {
53306
+ /**
53307
+ * Protocol v10.pcp.sap.com
53308
+ */
52842
53309
  v10 = "v10.pcp.sap.com",
52843
53310
  }
52844
53311
  /**
@@ -54002,7 +54469,7 @@ declare module "sap/ui/Device" {
54002
54469
  * have the possibility to customize the user agent, and to explicitly add this information.
54003
54470
  *
54004
54471
  * @since 1.31.0
54005
- * @deprecated As of version 1.98.
54472
+ * @deprecated As of version 1.98. without replacement, refer to the above note.
54006
54473
  */
54007
54474
  export const webview: boolean;
54008
54475
 
@@ -58174,7 +58641,9 @@ declare module "sap/ui/model/ClientListBinding" {
58174
58641
  aFilters?: Filter[] | Filter,
58175
58642
  /**
58176
58643
  * The type of the filter to replace; if no type is given, all filters previously configured with type {@link sap.ui.model.FilterType.Application }
58177
- * are cleared, and the given filters are used as filters of type {@link sap.ui.model.FilterType.Control}
58644
+ * are cleared, and the given filters are used as filters of type {@link sap.ui.model.FilterType.Control}.
58645
+ * Since 1.146.0, you may use {@link sap.ui.model.FilterType.ApplicationBound} to set bound application
58646
+ * filters.
58178
58647
  */
58179
58648
  sFilterType?: FilterType | keyof typeof FilterType
58180
58649
  ): this;
@@ -58219,6 +58688,8 @@ declare module "sap/ui/model/ClientModel" {
58219
58688
 
58220
58689
  import Context from "sap/ui/model/Context";
58221
58690
 
58691
+ import ClientContextBinding from "sap/ui/model/ClientContextBinding";
58692
+
58222
58693
  import PropertyBinding from "sap/ui/model/PropertyBinding";
58223
58694
 
58224
58695
  import Metadata from "sap/ui/base/Metadata";
@@ -58268,6 +58739,26 @@ declare module "sap/ui/model/ClientModel" {
58268
58739
  * @returns Metadata object describing this class
58269
58740
  */
58270
58741
  static getMetadata(): Metadata;
58742
+ /**
58743
+ * Creates a `sap.ui.model.ClientContextBinding`.
58744
+ *
58745
+ *
58746
+ * @returns The newly created `ClientContextBinding`
58747
+ */
58748
+ bindContext(
58749
+ /**
58750
+ * The path pointing to the property that should be bound
58751
+ */
58752
+ sPath: string,
58753
+ /**
58754
+ * The context object for this databinding
58755
+ */
58756
+ oContext?: Context,
58757
+ /**
58758
+ * Additional model-specific parameters
58759
+ */
58760
+ mParameters?: object
58761
+ ): ClientContextBinding;
58271
58762
  /**
58272
58763
  * Creates a new property binding for this model.
58273
58764
  * See:
@@ -58292,14 +58783,14 @@ declare module "sap/ui/model/ClientModel" {
58292
58783
  */
58293
58784
  mParameters?: {
58294
58785
  /**
58295
- * Whether this binding does not propagate model messages to the control; supported since 1.119.0. Some
58296
- * composite types like {@link sap.ui.model.type.Currency} automatically ignore model messages for some
58297
- * of their parts depending on their format options; setting this parameter to `true` or `false` overrules
58298
- * the automatism of the type.
58786
+ * Whether this binding ignores model messages instead of propagating them to the control. Supported since
58787
+ * 1.119.0. Some composite types like {@link sap.ui.model.type.Currency} automatically ignore model messages
58788
+ * for some of their parts, depending on their format options. Setting this parameter to `true` or `false`
58789
+ * overrules the automatism of the type.
58299
58790
  *
58300
- * For example, a binding for a currency code is used in a composite binding for rendering the proper number
58301
- * of decimals, but the currency code is not displayed in the attached control. In that case, messages for
58302
- * the currency code shall not be displayed at that control, only messages for the amount.
58791
+ * **Example:** A binding for a currency code is used in a composite binding for rendering the proper number
58792
+ * of decimals, but the currency code itself is not displayed in the attached control. In this case, messages
58793
+ * for the currency code aren't displayed at that control, only messages for the amount.
58303
58794
  */
58304
58795
  ignoreMessages?: boolean;
58305
58796
  }
@@ -58551,7 +59042,9 @@ declare module "sap/ui/model/ClientTreeBinding" {
58551
59042
  aFilters?: Filter[] | Filter,
58552
59043
  /**
58553
59044
  * The type of the filter to replace; if no type is given, all filters previously configured with type {@link sap.ui.model.FilterType.Application }
58554
- * are cleared, and the given filters are used as filters of type {@link sap.ui.model.FilterType.Control}
59045
+ * are cleared, and the given filters are used as filters of type {@link sap.ui.model.FilterType.Control}.
59046
+ * Since 1.146.0, you may use {@link sap.ui.model.FilterType.ApplicationBound} to set bound application
59047
+ * filters.
58555
59048
  */
58556
59049
  sFilterType?: FilterType | keyof typeof FilterType
58557
59050
  ): this;
@@ -60231,9 +60724,20 @@ declare module "sap/ui/model/FilterType" {
60231
60724
  */
60232
60725
  enum FilterType {
60233
60726
  /**
60234
- * Filters which are provided by the application.
60727
+ * Filters which are provided by the application and have constant values. Filters defined via the property
60728
+ * `filters` in {@link sap.ui.base.ManagedObject.AggregationBindingInfo} have this type. Filters of this
60729
+ * type are called "unbound application filters".
60235
60730
  */
60236
60731
  Application = "Application",
60732
+ /**
60733
+ * Filters provided by the application that may have values which are binding expressions. Filters defined
60734
+ * via the property `boundFilters` in {@link sap.ui.base.ManagedObject.AggregationBindingInfo} have this
60735
+ * type. Filters of this type are called "bound application filters". When a filter value changes through
60736
+ * data binding, the aggregation binding that uses this filter is filtered automatically.
60737
+ *
60738
+ * @since 1.146.0
60739
+ */
60740
+ ApplicationBound = "ApplicationBound",
60237
60741
  /**
60238
60742
  * Filters which are set by a control itself.
60239
60743
  *
@@ -60269,66 +60773,36 @@ declare module "sap/ui/model/FormatException" {
60269
60773
  declare module "sap/ui/model/json/JSONListBinding" {
60270
60774
  import ClientListBinding from "sap/ui/model/ClientListBinding";
60271
60775
 
60272
- import JSONModel from "sap/ui/model/json/JSONModel";
60273
-
60274
- import Context from "sap/ui/model/Context";
60275
-
60276
- import Sorter from "sap/ui/model/Sorter";
60277
-
60278
- import Filter from "sap/ui/model/Filter";
60279
-
60280
60776
  /**
60281
- * List binding implementation for JSON format.
60777
+ * List binding implementation for JSON model.
60282
60778
  *
60283
60779
  * @ui5-protected DO NOT USE IN APPLICATIONS (only for related classes in the framework)
60284
60780
  */
60285
60781
  export default class JSONListBinding extends ClientListBinding {
60286
60782
  /**
60287
- * Creates a new JSONListBinding.
60288
- *
60289
- * This constructor should only be called by subclasses or model implementations, not by application or
60290
- * control code. Such code should use {@link sap.ui.model.json.JSONModel#bindList JSONModel#bindList} on
60291
- * the corresponding model instance instead.
60292
- *
60293
60783
  * @ui5-protected Do not call from applications (only from related classes in the framework)
60294
60784
  */
60295
- protected constructor(
60296
- /**
60297
- * Model instance that this binding is created for and that it belongs to
60298
- */
60299
- oModel: JSONModel,
60300
- /**
60301
- * Binding path to be used for this binding
60302
- */
60303
- sPath: string,
60304
- /**
60305
- * Binding context relative to which a relative binding path will be resolved
60306
- */
60307
- oContext: Context,
60308
- /**
60309
- * The sorters used initially; call {@link #sort} to replace them
60310
- */
60311
- aSorters?: Sorter[] | Sorter,
60312
- /**
60313
- * The filters to be used initially with type {@link sap.ui.model.FilterType.Application}; call {@link #filter }
60314
- * to replace them
60315
- */
60316
- aFilters?: Filter[] | Filter,
60317
- /**
60318
- * Map of optional parameters as defined by subclasses; this class does not introduce any own parameters
60319
- */
60320
- mParameters?: object
60321
- );
60785
+ protected constructor();
60322
60786
  }
60323
60787
  }
60324
60788
 
60325
60789
  declare module "sap/ui/model/json/JSONModel" {
60326
60790
  import ClientModel from "sap/ui/model/ClientModel";
60327
60791
 
60328
- import Metadata from "sap/ui/base/Metadata";
60329
-
60330
60792
  import Context from "sap/ui/model/Context";
60331
60793
 
60794
+ import Sorter from "sap/ui/model/Sorter";
60795
+
60796
+ import Filter from "sap/ui/model/Filter";
60797
+
60798
+ import JSONListBinding from "sap/ui/model/json/JSONListBinding";
60799
+
60800
+ import JSONPropertyBinding from "sap/ui/model/json/JSONPropertyBinding";
60801
+
60802
+ import JSONTreeBinding from "sap/ui/model/json/JSONTreeBinding";
60803
+
60804
+ import Metadata from "sap/ui/base/Metadata";
60805
+
60332
60806
  /**
60333
60807
  * Model implementation for the JSON format.
60334
60808
  *
@@ -60427,6 +60901,107 @@ declare module "sap/ui/model/json/JSONModel" {
60427
60901
  */
60428
60902
  oContext?: Context
60429
60903
  ): any | null | undefined;
60904
+ /**
60905
+ * Creates a new {@link sap.ui.model.json.JSONListBinding}.
60906
+ *
60907
+ *
60908
+ * @returns The newly created JSONListBinding
60909
+ */
60910
+ bindList(
60911
+ /**
60912
+ * The path to the list or array to bind
60913
+ */
60914
+ sPath: string,
60915
+ /**
60916
+ * The context for the binding. This is mandatory when a relative binding path is provided.
60917
+ */
60918
+ oContext?: Context,
60919
+ /**
60920
+ * The sorters used initially. To replace them, call {@link sap.ui.model.ListBinding#sort}.
60921
+ */
60922
+ aSorters?: Sorter[] | Sorter,
60923
+ /**
60924
+ * The filters initially used with type {@link sap.ui.model.FilterType.Application}. To replace them, call
60925
+ * {@link sap.ui.model.ListBinding#filter}.
60926
+ */
60927
+ aFilters?: Filter[] | Filter,
60928
+ /**
60929
+ * Map of optional parameters as defined by subclasses. This class does not introduce any own parameters.
60930
+ */
60931
+ mParameters?: Record<string, any>
60932
+ ): JSONListBinding;
60933
+ /**
60934
+ * Creates a new {@link sap.ui.model.json.JSONPropertyBinding}.
60935
+ *
60936
+ *
60937
+ * @returns The newly created JSONPropertyBinding
60938
+ */
60939
+ bindProperty(
60940
+ /**
60941
+ * The path to the property to bind
60942
+ */
60943
+ sPath: string,
60944
+ /**
60945
+ * The context for the binding. This is mandatory when a relative binding path is provided.
60946
+ */
60947
+ oContext?: Context,
60948
+ /**
60949
+ * Additional model-specific parameters
60950
+ */
60951
+ mParameters?: {
60952
+ /**
60953
+ * Whether this binding ignores model messages instead of propagating them to the control. Supported since
60954
+ * 1.119.0. Some composite types like {@link sap.ui.model.type.Currency} automatically ignore model messages
60955
+ * for some of their parts, depending on their format options. Setting this parameter to `true` or `false`
60956
+ * overrules the automatism of the type.
60957
+ *
60958
+ * **Example:** A binding for a currency code is used in a composite binding for rendering the proper number
60959
+ * of decimals, but the currency code itself is not displayed in the attached control. In this case, messages
60960
+ * for the currency code aren't displayed at that control, only messages for the amount.
60961
+ */
60962
+ ignoreMessages?: boolean;
60963
+ }
60964
+ ): JSONPropertyBinding;
60965
+ /**
60966
+ * Creates a new {@link sap.ui.model.json.JSONTreeBinding}. The bound data can contain JSON objects and
60967
+ * arrays. Both are used to build the tree structure.
60968
+ *
60969
+ *
60970
+ * @returns The newly created JSONTreeBinding
60971
+ */
60972
+ bindTree(
60973
+ /**
60974
+ * The path pointing to the tree or array that is bound
60975
+ */
60976
+ sPath: string,
60977
+ /**
60978
+ * The context for the binding. This is mandatory when a relative binding path is provided.
60979
+ */
60980
+ oContext?: Context,
60981
+ /**
60982
+ * The filters initially used with type {@link sap.ui.model.FilterType.Application}. To replace them, call
60983
+ * {@link sap.ui.model.TreeBinding#filter}.
60984
+ */
60985
+ aFilters?: Filter[] | Filter,
60986
+ /**
60987
+ * Additional model-specific parameters
60988
+ */
60989
+ mParameters?: {
60990
+ /**
60991
+ * Keys of arrays to be used for building the tree structure. If not specified, all arrays and objects in
60992
+ * the bound data are used. Note: For arrays nested within other arrays with different names, add both array
60993
+ * names to `arrayNames`. To include a nested array in the hierarchy, you must list the names of all containing
60994
+ * arrays. If an array name is missing from the list, its child arrays are also excluded from the hierarchy,
60995
+ * even if you add them to `arrayNames`. If this parameter is set, all other objects and arrays in the bound
60996
+ * data are ignored.
60997
+ */
60998
+ arrayNames?: string[];
60999
+ },
61000
+ /**
61001
+ * The sorters used initially. To replace them, call {@link sap.ui.model.TreeBinding#sort}.
61002
+ */
61003
+ aSorters?: Sorter[] | Sorter
61004
+ ): JSONTreeBinding;
60430
61005
  /**
60431
61006
  * Returns a Promise of the current data-loading state. Every currently running {@link sap.ui.model.json.JSONModel#loadData }
60432
61007
  * call is respected by the returned Promise. This also includes a potential loadData call from the JSONModel's
@@ -60828,45 +61403,18 @@ declare module "sap/ui/model/json/TypedJSONContext" {
60828
61403
  declare module "sap/ui/model/json/JSONPropertyBinding" {
60829
61404
  import ClientPropertyBinding from "sap/ui/model/ClientPropertyBinding";
60830
61405
 
60831
- import JSONModel from "sap/ui/model/json/JSONModel";
60832
-
60833
- import Context from "sap/ui/model/Context";
60834
-
60835
61406
  import Metadata from "sap/ui/base/Metadata";
60836
61407
 
60837
61408
  /**
60838
- * Property binding implementation for JSON format.
61409
+ * Property binding implementation for JSON model.
60839
61410
  *
60840
61411
  * @ui5-protected DO NOT USE IN APPLICATIONS (only for related classes in the framework)
60841
61412
  */
60842
61413
  export default class JSONPropertyBinding extends ClientPropertyBinding {
60843
61414
  /**
60844
- * Creates a new JSONListBinding.
60845
- *
60846
- * This constructor should only be called by subclasses or model implementations, not by application or
60847
- * control code. Such code should use {@link sap.ui.model.json.JSONModel#bindProperty JSONModel#bindProperty }
60848
- * on the corresponding model instance instead.
60849
- *
60850
61415
  * @ui5-protected Do not call from applications (only from related classes in the framework)
60851
61416
  */
60852
- protected constructor(
60853
- /**
60854
- * Model instance that this binding is created for and that it belongs to
60855
- */
60856
- oModel: JSONModel,
60857
- /**
60858
- * Binding path to be used for this binding
60859
- */
60860
- sPath: string,
60861
- /**
60862
- * Binding context relative to which a relative binding path will be resolved
60863
- */
60864
- oContext: Context,
60865
- /**
60866
- * Map of optional parameters as defined by subclasses; this class does not introduce any own parameters
60867
- */
60868
- mParameters?: object
60869
- );
61417
+ protected constructor();
60870
61418
 
60871
61419
  /**
60872
61420
  * Creates a new subclass of class sap.ui.model.json.JSONPropertyBinding with name `sClassName` and enriches
@@ -60907,66 +61455,16 @@ declare module "sap/ui/model/json/JSONPropertyBinding" {
60907
61455
  declare module "sap/ui/model/json/JSONTreeBinding" {
60908
61456
  import ClientTreeBinding from "sap/ui/model/ClientTreeBinding";
60909
61457
 
60910
- import JSONModel from "sap/ui/model/json/JSONModel";
60911
-
60912
- import Filter from "sap/ui/model/Filter";
60913
-
60914
- import Sorter from "sap/ui/model/Sorter";
60915
-
60916
61458
  /**
60917
- * Tree binding implementation for JSON format.
60918
- *
60919
- * The bound data can contain JSON objects and arrays. Both will be used to build the tree structure. You
60920
- * can optionally define a set of arrays to be used for the tree structure in the parameter `arrayNames`.
60921
- * If this parameter is set, all other objects and arrays will be ignored.
61459
+ * Tree binding implementation for JSON model. See {@link sap.ui.model.json.JSONModel#bindTree}
60922
61460
  *
60923
61461
  * @ui5-protected DO NOT USE IN APPLICATIONS (only for related classes in the framework)
60924
61462
  */
60925
61463
  export default class JSONTreeBinding extends ClientTreeBinding {
60926
61464
  /**
60927
- * Creates a new JSONListBinding.
60928
- *
60929
- * This constructor should only be called by subclasses or model implementations, not by application or
60930
- * control code. Such code should use {@link sap.ui.model.json.JSONModel#bindTree JSONModel#bindTree} on
60931
- * the corresponding model instance instead.
60932
- *
60933
61465
  * @ui5-protected Do not call from applications (only from related classes in the framework)
60934
61466
  */
60935
- protected constructor(
60936
- /**
60937
- * Model instance that this binding is created for and that it belongs to
60938
- */
60939
- oModel: JSONModel,
60940
- /**
60941
- * Path pointing to the tree or array that should be bound
60942
- */
60943
- sPath: string,
60944
- /**
60945
- * Context object for this binding, mandatory when a relative binding path is given
60946
- */
60947
- oContext?: object,
60948
- /**
60949
- * The filters to be used initially with type {@link sap.ui.model.FilterType.Application}; call {@link #filter }
60950
- * to replace them
60951
- */
60952
- aFilters?: Filter[] | Filter,
60953
- /**
60954
- * Additional model-specific parameters
60955
- */
60956
- mParameters?: {
60957
- /**
60958
- * Keys of arrays to be used for building the tree structure. If not specified, all arrays and objects in
60959
- * the bound data will be used. Note that for arrays nested inside differently named arrays, you need to
60960
- * add both to `arrayNames`. You always have to add the complete parent chain. If any array is ignored,
60961
- * its child arrays will be ignored as well even if they have been added to `arrayNames`.
60962
- */
60963
- arrayNames?: string[];
60964
- },
60965
- /**
60966
- * The sorters used initially; call {@link #sort} to replace them
60967
- */
60968
- aSorters?: Sorter[] | Sorter
60969
- );
61467
+ protected constructor();
60970
61468
  }
60971
61469
  }
60972
61470
 
@@ -61097,6 +61595,26 @@ declare module "sap/ui/model/ListBinding" {
61097
61595
  */
61098
61596
  oListener?: object
61099
61597
  ): void;
61598
+ /**
61599
+ * Computes the binding's application filters by replacing application filters of the given type with the
61600
+ * given new filters. Subclasses call this method from their filter method implementation.
61601
+ *
61602
+ * @since 1.146.0
61603
+ * @ui5-protected Do not call from applications (only from related classes in the framework)
61604
+ *
61605
+ * @returns The new application filters
61606
+ */
61607
+ computeApplicationFilters(
61608
+ /**
61609
+ * The new filters for the given filter type
61610
+ */
61611
+ vFilter?: Filter[] | Filter,
61612
+ /**
61613
+ * The type of the application filters to replace
61614
+ */
61615
+ sFilterType?: /* was: sap.ui.model.FilterType.Application */
61616
+ any | /* was: sap.ui.model.FilterType.ApplicationBound */ any
61617
+ ): Filter[] | Filter | undefined;
61100
61618
  /**
61101
61619
  * Detaches event handler `fnFunction` from the {@link #event:filter filter} event of this `sap.ui.model.ListBinding`.
61102
61620
  *
@@ -61209,7 +61727,9 @@ declare module "sap/ui/model/ListBinding" {
61209
61727
  */
61210
61728
  aFilters?: Filter[] | Filter,
61211
61729
  /**
61212
- * The type of the filter to replace; if no type is given, the behavior depends on the model implementation
61730
+ * The type of filter to replace. If no type is specified, the behavior depends on the model implementation.
61731
+ * Since 1.146.0, you can use `sap.ui.model.FilterType.ApplicationBound` to replace bound application filters
61732
+ * if the model implementation supports it.
61213
61733
  */
61214
61734
  sFilterType?: FilterType | keyof typeof FilterType
61215
61735
  ): this;
@@ -62513,7 +63033,7 @@ declare module "sap/ui/model/Model" {
62513
63033
  /**
62514
63034
  * HTTP status code returned by the request (if available)
62515
63035
  */
62516
- statusCode?: string;
63036
+ statusCode?: string | number;
62517
63037
 
62518
63038
  /**
62519
63039
  * The status as a text, details not specified, intended only for diagnosis output
@@ -72852,7 +73372,7 @@ declare module "sap/ui/model/odata/v4/Context" {
72852
73372
  * (for example due to a filter), and the group ID must not have {@link sap.ui.model.odata.v4.SubmitMode.API}.
72853
73373
  * Such a deletion is not a pending change.
72854
73374
  *
72855
- * When using data aggregation without group levels, single entities can be deleted (@experimental as of
73375
+ * When using data aggregation without `groupLevels`, single entities can be deleted (@experimental as of
72856
73376
  * version 1.144.0, see {@link #isAggregated}). The same restrictions as for a recursive hierarchy apply.
72857
73377
  * See:
72858
73378
  * #hasPendingChanges
@@ -73148,11 +73668,24 @@ declare module "sap/ui/model/odata/v4/Context" {
73148
73668
  * @returns `true` if this context is kept alive
73149
73669
  */
73150
73670
  isKeepAlive(): boolean;
73671
+ /**
73672
+ * Tells whether this context is outdated:
73673
+ * `undefined`: The outdated state has not been determined yet `true`: The context is outdated `false`:
73674
+ * The context is up to date
73675
+ *
73676
+ * The outdated state can also be accessed via the instance annotation "@$ui5.context.isOutdated".
73677
+ *
73678
+ * @experimental As of version 1.147.
73679
+ *
73680
+ * @returns Whether this context is outdated, or `undefined` if the outdated state has not been determined
73681
+ * yet
73682
+ */
73683
+ isOutdated(): boolean | undefined;
73151
73684
  /**
73152
73685
  * Tells whether this context is currently selected, but not {@link #delete deleted} on the client. Selection
73153
- * was experimental as of version 1.111.0. Since 1.122.0, the selection state can also be accessed via instance
73154
- * annotation "@$ui5.context.isSelected" at the entity. Note that the annotation does not take the deletion
73155
- * state into account.
73686
+ * was experimental as of version 1.111.0. Since 1.122.0, the selection state can also be accessed via the
73687
+ * instance annotation "@$ui5.context.isSelected" at the entity. Note that the annotation does not take
73688
+ * the deletion state into account.
73156
73689
  * See:
73157
73690
  * #setSelected
73158
73691
  *
@@ -73410,6 +73943,12 @@ declare module "sap/ui/model/odata/v4/Context" {
73410
73943
  * 'dataRequested', can instead be done before calling {@link #requestSideEffects}. 'dataReceived',
73411
73944
  * can instead be done once the `oPromise` returned by {@link #requestSideEffects} fulfills or rejects (using
73412
73945
  * `oPromise.then(function () {...}, function () {...})`).
73946
+ *
73947
+ * Since 1.109.0, this context can also represent a node in a recursive hierarchy (see {@link sap.ui.model.odata.v4.ODataListBinding#setAggregation}).
73948
+ *
73949
+ * When using data aggregation but no recursive hierarchy, and without `groupLevels` or `"grandTotal like
73950
+ * 1.84"` (see {@link sap.ui.model.odata.v4.ODataListBinding#setAggregation}), this context can also represent
73951
+ * a single entity (see {@link #isAggregated}, @experimental as of version 1.146.0).
73413
73952
  * See:
73414
73953
  * sap.ui.model.odata.v4.ODataContextBinding#getBoundContext
73415
73954
  * sap.ui.model.odata.v4.ODataContextBinding#invoke
@@ -73418,13 +73957,15 @@ declare module "sap/ui/model/odata/v4/Context" {
73418
73957
  *
73419
73958
  * @since 1.61.0
73420
73959
  *
73421
- * @returns A promise which is resolved without a defined result, or rejected with an error if loading of
73422
- * side effects fails. Use it to set fields affected by side effects to read-only before {@link #requestSideEffects }
73960
+ * @returns A promise which is resolved without a defined result, or rejected with an error if the side
73961
+ * effects fail to load. Use it to set fields affected by side effects to read-only before {@link #requestSideEffects }
73423
73962
  * and make them editable again when the promise resolves; in the error handler, you can repeat the loading
73424
73963
  * of side effects.
73425
- * The promise is rejected if the call wants to refresh a whole list binding (via header context or an
73426
- * absolute path), but the deletion of a row context (see {@link #delete}) is pending with a different group
73427
- * ID.
73964
+ * The promise is rejected if
73965
+ * the call attempts to refresh an entire list binding (via header context or an absolute path) while
73966
+ * the deletion of a row context (see {@link #delete}) is pending with a different group ID, this is
73967
+ * the row context of a list binding with data aggregation which has `groupLevels` or `"grandTotal like
73968
+ * 1.84"`, or this context does not represent a single entity
73428
73969
  */
73429
73970
  requestSideEffects(
73430
73971
  /**
@@ -73439,9 +73980,11 @@ declare module "sap/ui/model/odata/v4/Context" {
73439
73980
  *
73440
73981
  * Since 1.82.0, absolute paths are supported. Absolute paths must start with the entity container (example
73441
73982
  * "/com.sap.gateway.default.iwbep.tea_busi.v0001.Container/TEAMS") of the service. All (navigation) properties
73442
- * in the complete model matching such an absolute path are updated. Since 1.85.0, "14.3.11 Expression edm:String"
73443
- * is accepted as well. Since 1.145.0, you can use `null` values (and `{$Null : null}`) as synonyms for
73444
- * empty navigation property paths.
73983
+ * in the complete model matching such an absolute path are updated. Since 1.146.0, {@link sap.ui.model.odata.v4.ODataModel#requestSideEffects }
73984
+ * can be used as well.
73985
+ *
73986
+ * Since 1.85.0, "14.3.11 Expression edm:String" is accepted as well. Since 1.145.0, you can use `null`
73987
+ * values (and `{$Null : null}`) as synonyms for empty navigation property paths.
73445
73988
  *
73446
73989
  * Since 1.108.8, a property path matching the "com.sap.vocabularies.Common.v1.Messages" annotation of a
73447
73990
  * list binding's entity type is treated specially for a row context of a list binding: It is loaded even
@@ -73452,8 +73995,8 @@ declare module "sap/ui/model/odata/v4/Context" {
73452
73995
  NavigationPropertyPathExpression | PropertyPathExpression | string
73453
73996
  >,
73454
73997
  /**
73455
- * The group ID to be used (since 1.69.0); if not specified, the update group ID for the context's binding
73456
- * is used, see {@link #getUpdateGroupId}. If a different group ID is specified, make sure that {@link #requestSideEffects }
73998
+ * The group ID to be used (since 1.69.0). If not specified, the {@link #getUpdateGroupId update group ID }
73999
+ * for the context's binding is used. If a different group ID is specified, make sure that {@link #requestSideEffects }
73457
74000
  * is called after the corresponding updates have been successfully processed by the server and that there
73458
74001
  * are no pending changes for the affected properties.
73459
74002
  */
@@ -74582,6 +75125,9 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
74582
75125
  * is set to `undefined`. The created context always knows its {@link sap.ui.model.odata.v4.Context#getPath path},
74583
75126
  * which can be used for {@link #getKeepAliveContext}.
74584
75127
  *
75128
+ * When using data aggregation without `groupLevels` and without `"grandTotal like 1.84"` (see {@link #setAggregation}),
75129
+ * single entities can be created (@experimental as of version 1.146.0, see {@link sap.ui.model.odata.v4.Context#isAggregated}).
75130
+ *
74585
75131
  * @since 1.43.0
74586
75132
  *
74587
75133
  * @returns The context object for the created entity; its method {@link sap.ui.model.odata.v4.Context#created }
@@ -74786,7 +75332,8 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
74786
75332
  */
74787
75333
  vFilters?: Filter | Filter[],
74788
75334
  /**
74789
- * The filter type to be used
75335
+ * The filter type to be used. Since 1.146.0, you may use {@link sap.ui.model.FilterType.ApplicationBound }
75336
+ * to replace bound application filters.
74790
75337
  */
74791
75338
  sFilterType?: FilterType | keyof typeof FilterType
74792
75339
  ): this;
@@ -74947,9 +75494,11 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
74947
75494
  */
74948
75495
  getGroupId(): string;
74949
75496
  /**
74950
- * Returns the header context which allows binding to `$count` or `@$ui5.context.isSelected`.
75497
+ * Returns the header context which allows binding to `$count`, `@$ui5.context.isOutdated`, or `@$ui5.context.isSelected`.
74951
75498
  * See:
74952
75499
  * #getCount
75500
+ * sap.ui.model.odata.v4.Context#isOutdated
75501
+ * sap.ui.model.odata.v4.Context#isSelected
74953
75502
  *
74954
75503
  * @since 1.45.0
74955
75504
  *
@@ -75294,10 +75843,10 @@ declare module "sap/ui/model/odata/v4/ODataListBinding" {
75294
75843
  */
75295
75844
  aggregate?: object;
75296
75845
  /**
75297
- * Whether created nodes are shown in place at the position specified by the service (since 1.130.0); only
75298
- * the value `true` is allowed. Otherwise, created nodes are displayed out of place as the first children
75299
- * of their parent or as the first roots, but not in their usual position as defined by the service and
75300
- * the current sort order.
75846
+ * Whether created nodes are shown in place at the position specified by the service (since 1.130.0), supported
75847
+ * only if a `hierarchyQualifier` is given; only the value `true` is allowed. Otherwise, created nodes are
75848
+ * displayed out of place as the first children of their parent or as the first roots, but not in their
75849
+ * usual position as defined by the service and the current sort order.
75301
75850
  */
75302
75851
  createInPlace?: boolean;
75303
75852
  /**
@@ -76557,7 +77106,7 @@ declare module "sap/ui/model/odata/v4/ODataModel" {
76557
77106
  *
76558
77107
  * Every resource path (relative to the service root URL, no query options) according to "4 Resource Path" in specification "OData Version 4.01. Part 2: URL Conventions" is a valid data
76559
77108
  * binding path within this model if a leading slash is added; for example "/" + "SalesOrderList('A%2FB%26C')"
76560
- * to access an entity instance with key "A/B&C". Note that appropriate URI encoding is necessary, see the
77109
+ * to access an entity instance with key "A/B&C". Note that appropriate URL encoding is necessary, see the
76561
77110
  * example of {@link sap.ui.model.odata.v4.ODataUtils.formatLiteral}. "4.5.1 Addressing Actions" needs an
76562
77111
  * operation binding, see {@link sap.ui.model.odata.v4.ODataContextBinding}.
76563
77112
  *
@@ -77389,7 +77938,7 @@ declare module "sap/ui/model/odata/v4/ODataModel" {
77389
77938
  *
77390
77939
  * @since 1.107.0
77391
77940
  *
77392
- * @returns The proper URI-encoded key predicate, for example "(Sector='A%2FB%26C',ID='42')" or "('42')",
77941
+ * @returns The proper URL-encoded key predicate, for example "(Sector='A%2FB%26C',ID='42')" or "('42')",
77393
77942
  * or `undefined` if at least one key property is undefined.
77394
77943
  */
77395
77944
  getKeyPredicate(
@@ -77551,7 +78100,7 @@ declare module "sap/ui/model/odata/v4/ODataModel" {
77551
78100
  *
77552
78101
  * @since 1.107.0
77553
78102
  *
77554
- * @returns A promise that gets resolved with the proper URI-encoded key predicate, for example "(Sector='A%2FB%26C',ID='42')"
78103
+ * @returns A promise that gets resolved with the proper URL-encoded key predicate, for example "(Sector='A%2FB%26C',ID='42')"
77555
78104
  * or "('42')", or `undefined` if at least one key property is undefined. It gets rejected if the metadata
77556
78105
  * cannot be fetched, or in case the entity has no key properties according to the metadata.
77557
78106
  */
@@ -77565,6 +78114,25 @@ declare module "sap/ui/model/odata/v4/ODataModel" {
77565
78114
  */
77566
78115
  oEntity: object
77567
78116
  ): Promise<string | undefined>;
78117
+ /**
78118
+ * Loads side effects for the given absolute paths on all affected bindings. For more information about
78119
+ * side effects in general, see {@link sap.ui.model.odata.v4.Context#requestSideEffects}.
78120
+ *
78121
+ * @since 1.146.0
78122
+ *
78123
+ * @returns A promise which is resolved without a defined result, or rejected with an error if the side
78124
+ * effects fail to load.
78125
+ */
78126
+ requestSideEffects(
78127
+ /**
78128
+ * The absolute paths for which to request side effects, for example "/SalesOrderList/SO_2_SOITEM/Note".
78129
+ */
78130
+ aAbsolutePaths: string[],
78131
+ /**
78132
+ * The group ID to be used. If not specified, the {@link #getUpdateGroupId update group ID} is used.
78133
+ */
78134
+ sGroupId?: string
78135
+ ): Promise<void>;
77568
78136
  /**
77569
78137
  * Resets all property changes, created entities, and entity deletions associated with the given group ID
77570
78138
  * which have not been successfully submitted via {@link #submitBatch}. Resets also invalid user input for
@@ -77712,12 +78280,16 @@ declare module "sap/ui/model/odata/v4/ODataModel" {
77712
78280
 
77713
78281
  /**
77714
78282
  * Parameters of the ODataModel#parseError event.
78283
+ *
78284
+ * @deprecated As of version 1.37.0. this event is not supported
77715
78285
  */
77716
78286
  export interface ODataModel$ParseErrorEventParameters
77717
78287
  extends Model$ParseErrorEventParameters {}
77718
78288
 
77719
78289
  /**
77720
78290
  * Event object of the ODataModel#parseError event.
78291
+ *
78292
+ * @deprecated As of version 1.37.0. this event is not supported
77721
78293
  */
77722
78294
  export type ODataModel$ParseErrorEvent = Event<
77723
78295
  ODataModel$ParseErrorEventParameters,
@@ -77751,12 +78323,16 @@ declare module "sap/ui/model/odata/v4/ODataModel" {
77751
78323
 
77752
78324
  /**
77753
78325
  * Parameters of the ODataModel#requestCompleted event.
78326
+ *
78327
+ * @deprecated As of version 1.37.0. this event is not supported
77754
78328
  */
77755
78329
  export interface ODataModel$RequestCompletedEventParameters
77756
78330
  extends Model$RequestCompletedEventParameters {}
77757
78331
 
77758
78332
  /**
77759
78333
  * Event object of the ODataModel#requestCompleted event.
78334
+ *
78335
+ * @deprecated As of version 1.37.0. this event is not supported
77760
78336
  */
77761
78337
  export type ODataModel$RequestCompletedEvent = Event<
77762
78338
  ODataModel$RequestCompletedEventParameters,
@@ -77765,12 +78341,16 @@ declare module "sap/ui/model/odata/v4/ODataModel" {
77765
78341
 
77766
78342
  /**
77767
78343
  * Parameters of the ODataModel#requestFailed event.
78344
+ *
78345
+ * @deprecated As of version 1.37.0. this event is not supported
77768
78346
  */
77769
78347
  export interface ODataModel$RequestFailedEventParameters
77770
78348
  extends Model$RequestFailedEventParameters {}
77771
78349
 
77772
78350
  /**
77773
78351
  * Event object of the ODataModel#requestFailed event.
78352
+ *
78353
+ * @deprecated As of version 1.37.0. this event is not supported
77774
78354
  */
77775
78355
  export type ODataModel$RequestFailedEvent = Event<
77776
78356
  ODataModel$RequestFailedEventParameters,
@@ -77779,12 +78359,16 @@ declare module "sap/ui/model/odata/v4/ODataModel" {
77779
78359
 
77780
78360
  /**
77781
78361
  * Parameters of the ODataModel#requestSent event.
78362
+ *
78363
+ * @deprecated As of version 1.37.0. this event is not supported
77782
78364
  */
77783
78365
  export interface ODataModel$RequestSentEventParameters
77784
78366
  extends Model$RequestSentEventParameters {}
77785
78367
 
77786
78368
  /**
77787
78369
  * Event object of the ODataModel#requestSent event.
78370
+ *
78371
+ * @deprecated As of version 1.37.0. this event is not supported
77788
78372
  */
77789
78373
  export type ODataModel$RequestSentEvent = Event<
77790
78374
  ODataModel$RequestSentEventParameters,
@@ -79396,6 +79980,11 @@ declare module "sap/ui/model/Sorter" {
79396
79980
  * See `vGroup` parameter
79397
79981
  */
79398
79982
  group?: boolean | Function;
79983
+ /**
79984
+ * An array of paths that are required for grouping. Supported since 1.147.0; consult the documentation
79985
+ * of the specific model implementation whether it evaluates these paths.
79986
+ */
79987
+ groupPaths?: string[];
79399
79988
  /**
79400
79989
  * The binding path for this sorter
79401
79990
  */
@@ -79505,6 +80094,14 @@ declare module "sap/ui/model/Sorter" {
79505
80094
  * @returns The group function
79506
80095
  */
79507
80096
  getGroupFunction(): Function;
80097
+ /**
80098
+ * Returns the group paths.
80099
+ *
80100
+ * @since 1.147.0
80101
+ *
80102
+ * @returns The array of group paths or `undefined` if this sorter has no group paths.
80103
+ */
80104
+ getGroupPaths(): string[] | undefined;
79508
80105
  /**
79509
80106
  * Returns the binding path for this sorter; see the path parameter of {@link sap.ui.model.Sorter#constructor}.
79510
80107
  *
@@ -79708,6 +80305,26 @@ declare module "sap/ui/model/TreeBinding" {
79708
80305
  */
79709
80306
  oListener?: object
79710
80307
  ): void;
80308
+ /**
80309
+ * Computes the binding's application filters by replacing application filters of the given type with the
80310
+ * given new filters. Subclasses call this method from their filter method implementation.
80311
+ *
80312
+ * @since 1.146.0
80313
+ * @ui5-protected Do not call from applications (only from related classes in the framework)
80314
+ *
80315
+ * @returns The new application filters
80316
+ */
80317
+ computeApplicationFilters(
80318
+ /**
80319
+ * The new filters for the given filter type
80320
+ */
80321
+ vFilter?: Filter[] | Filter,
80322
+ /**
80323
+ * The type of the application filters to replace
80324
+ */
80325
+ sFilterType?: /* was: sap.ui.model.FilterType.Application */
80326
+ any | /* was: sap.ui.model.FilterType.ApplicationBound */ any
80327
+ ): Filter[] | Filter | undefined;
79711
80328
  /**
79712
80329
  * Detaches event handler `fnFunction` from the {@link #event:_filter _filter} event of this `sap.ui.model.TreeBinding`.
79713
80330
  *
@@ -79737,7 +80354,9 @@ declare module "sap/ui/model/TreeBinding" {
79737
80354
  */
79738
80355
  aFilters?: Filter[] | Filter,
79739
80356
  /**
79740
- * The type of the filter to replace; if no type is given, the behavior depends on the model implementation
80357
+ * The type of filter to replace. If no type is specified, the behavior depends on the model implementation.
80358
+ * Since 1.146.0, you can use `sap.ui.model.FilterType.ApplicationBound` to set bound application filters
80359
+ * if the model implementation supports it.
79741
80360
  */
79742
80361
  sFilterType?: FilterType | keyof typeof FilterType
79743
80362
  ): void;
@@ -82114,8 +82733,12 @@ declare module "sap/ui/test/actions/EnterText" {
82114
82733
  /**
82115
82734
  * Gets current value of property {@link #getKeepFocus keepFocus}.
82116
82735
  *
82736
+ * If it is set to `true`, the input will remain focused after text is entered. Use this for inputs with
82737
+ * a suggestion list that you want to keep open.
82738
+ *
82117
82739
  * Default value is `false`.
82118
82740
  *
82741
+ * @since 1.67
82119
82742
  *
82120
82743
  * @returns Value of property `keepFocus`
82121
82744
  */
@@ -82123,8 +82746,13 @@ declare module "sap/ui/test/actions/EnterText" {
82123
82746
  /**
82124
82747
  * Gets current value of property {@link #getPressEnterKey pressEnterKey}.
82125
82748
  *
82749
+ * If it is set to `true`, an ENTER key will be entered after the text. Use this for inputs that shouldn't
82750
+ * lose the focus after a text is entered. (e.g. inputs in a sap.m.Popover shouldn't be focused out, as
82751
+ * this will make the popover close in FF and IE11)
82752
+ *
82126
82753
  * Default value is `false`.
82127
82754
  *
82755
+ * @since 1.76
82128
82756
  *
82129
82757
  * @returns Value of property `pressEnterKey`
82130
82758
  */
@@ -82164,10 +82792,14 @@ declare module "sap/ui/test/actions/EnterText" {
82164
82792
  /**
82165
82793
  * Sets a new value for property {@link #getKeepFocus keepFocus}.
82166
82794
  *
82795
+ * If it is set to `true`, the input will remain focused after text is entered. Use this for inputs with
82796
+ * a suggestion list that you want to keep open.
82797
+ *
82167
82798
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
82168
82799
  *
82169
82800
  * Default value is `false`.
82170
82801
  *
82802
+ * @since 1.67
82171
82803
  *
82172
82804
  * @returns Reference to `this` in order to allow method chaining
82173
82805
  */
@@ -82180,10 +82812,15 @@ declare module "sap/ui/test/actions/EnterText" {
82180
82812
  /**
82181
82813
  * Sets a new value for property {@link #getPressEnterKey pressEnterKey}.
82182
82814
  *
82815
+ * If it is set to `true`, an ENTER key will be entered after the text. Use this for inputs that shouldn't
82816
+ * lose the focus after a text is entered. (e.g. inputs in a sap.m.Popover shouldn't be focused out, as
82817
+ * this will make the popover close in FF and IE11)
82818
+ *
82183
82819
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
82184
82820
  *
82185
82821
  * Default value is `false`.
82186
82822
  *
82823
+ * @since 1.76
82187
82824
  *
82188
82825
  * @returns Reference to `this` in order to allow method chaining
82189
82826
  */
@@ -82231,8 +82868,21 @@ declare module "sap/ui/test/actions/EnterText" {
82231
82868
  */
82232
82869
  clearTextFirst?: boolean | PropertyBindingInfo | `{${string}}`;
82233
82870
 
82871
+ /**
82872
+ * If it is set to `true`, the input will remain focused after text is entered. Use this for inputs with
82873
+ * a suggestion list that you want to keep open.
82874
+ *
82875
+ * @since 1.67
82876
+ */
82234
82877
  keepFocus?: boolean | PropertyBindingInfo | `{${string}}`;
82235
82878
 
82879
+ /**
82880
+ * If it is set to `true`, an ENTER key will be entered after the text. Use this for inputs that shouldn't
82881
+ * lose the focus after a text is entered. (e.g. inputs in a sap.m.Popover shouldn't be focused out, as
82882
+ * this will make the popover close in FF and IE11)
82883
+ *
82884
+ * @since 1.76
82885
+ */
82236
82886
  pressEnterKey?: boolean | PropertyBindingInfo | `{${string}}`;
82237
82887
  }
82238
82888
  }
@@ -82253,6 +82903,10 @@ declare module "sap/ui/test/actions/Press" {
82253
82903
  * The `Press` action is used to simulate a press interaction with a control. Most controls are supported,
82254
82904
  * for example buttons, links, list items, tables, filters, and form controls.
82255
82905
  *
82906
+ * The `Press` action can also simulate right-click (context menu) interactions by setting the `rightClick`
82907
+ * property to true. This is useful for testing controls with custom context menus, such as `sap.ui.table.Table`
82908
+ * and `sap.m.Table`.
82909
+ *
82256
82910
  * The `Press` action targets a special DOM element representing the control. This DOM element can be customized.
82257
82911
  *
82258
82912
  * For most most controls (even custom ones), the DOM focus reference is an appropriate choice. You can
@@ -82348,7 +83002,10 @@ declare module "sap/ui/test/actions/Press" {
82348
83002
  static getMetadata(): ManagedObjectMetadata;
82349
83003
  /**
82350
83004
  * Sets focus on given control and triggers a 'tap' event on it (which is internally translated into a 'press'
82351
- * event). Logs an error if control is not visible (i.e. has no dom representation)
83005
+ * event). If `keyDown` or `keyUp` is set to `true`, dispatches the corresponding keyboard event instead
83006
+ * of mouse events. If `rightClick` property is set to `true`, triggers a `contextmenu` event instead, along
83007
+ * with appropriate `mousedown` and `mouseup` events. Logs an error if control is not visible (i.e. has
83008
+ * no dom representation)
82352
83009
  */
82353
83010
  executeOn(
82354
83011
  /**
@@ -82376,6 +83033,43 @@ declare module "sap/ui/test/actions/Press" {
82376
83033
  * @returns Value of property `ctrlKey`
82377
83034
  */
82378
83035
  getCtrlKey(): boolean;
83036
+ /**
83037
+ * Gets current value of property {@link #getKeyDown keyDown}.
83038
+ *
83039
+ * If it is set to `true`, a `keydown` keyboard event will be dispatched instead of mouse events. The modifier
83040
+ * keys (shiftKey, altKey, ctrlKey) will be applied to the keyboard event if set.
83041
+ *
83042
+ * @since 1.146
83043
+ *
83044
+ * @returns Value of property `keyDown`
83045
+ */
83046
+ getKeyDown(): boolean;
83047
+ /**
83048
+ * Gets current value of property {@link #getKeyUp keyUp}.
83049
+ *
83050
+ * If it is set to `true`, a `keyup` keyboard event will be dispatched instead of mouse events. The modifier
83051
+ * keys (shiftKey, altKey, ctrlKey) will be applied to the keyboard event if set.
83052
+ *
83053
+ * @since 1.146
83054
+ *
83055
+ * @returns Value of property `keyUp`
83056
+ */
83057
+ getKeyUp(): boolean;
83058
+ /**
83059
+ * Gets current value of property {@link #getRightClick rightClick}.
83060
+ *
83061
+ * If set to `true`, a right-click (context menu) event will be triggered instead of a left-click. This
83062
+ * simulates the native browser right-click behavior by dispatching `mousedown` and `mouseup` with `button:
83063
+ * 2`, followed by a `contextmenu` event. The `xPercentage` and `yPercentage` properties can be used to
83064
+ * specify the position of the right-click event.
83065
+ *
83066
+ * Default value is `false`.
83067
+ *
83068
+ * @since 1.147
83069
+ *
83070
+ * @returns Value of property `rightClick`
83071
+ */
83072
+ getRightClick(): boolean;
82379
83073
  /**
82380
83074
  * Gets current value of property {@link #getShiftKey shiftKey}.
82381
83075
  *
@@ -82442,6 +83136,64 @@ declare module "sap/ui/test/actions/Press" {
82442
83136
  */
82443
83137
  bCtrlKey: boolean
82444
83138
  ): this;
83139
+ /**
83140
+ * Sets a new value for property {@link #getKeyDown keyDown}.
83141
+ *
83142
+ * If it is set to `true`, a `keydown` keyboard event will be dispatched instead of mouse events. The modifier
83143
+ * keys (shiftKey, altKey, ctrlKey) will be applied to the keyboard event if set.
83144
+ *
83145
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
83146
+ *
83147
+ * @since 1.146
83148
+ *
83149
+ * @returns Reference to `this` in order to allow method chaining
83150
+ */
83151
+ setKeyDown(
83152
+ /**
83153
+ * New value for property `keyDown`
83154
+ */
83155
+ bKeyDown: boolean
83156
+ ): this;
83157
+ /**
83158
+ * Sets a new value for property {@link #getKeyUp keyUp}.
83159
+ *
83160
+ * If it is set to `true`, a `keyup` keyboard event will be dispatched instead of mouse events. The modifier
83161
+ * keys (shiftKey, altKey, ctrlKey) will be applied to the keyboard event if set.
83162
+ *
83163
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
83164
+ *
83165
+ * @since 1.146
83166
+ *
83167
+ * @returns Reference to `this` in order to allow method chaining
83168
+ */
83169
+ setKeyUp(
83170
+ /**
83171
+ * New value for property `keyUp`
83172
+ */
83173
+ bKeyUp: boolean
83174
+ ): this;
83175
+ /**
83176
+ * Sets a new value for property {@link #getRightClick rightClick}.
83177
+ *
83178
+ * If set to `true`, a right-click (context menu) event will be triggered instead of a left-click. This
83179
+ * simulates the native browser right-click behavior by dispatching `mousedown` and `mouseup` with `button:
83180
+ * 2`, followed by a `contextmenu` event. The `xPercentage` and `yPercentage` properties can be used to
83181
+ * specify the position of the right-click event.
83182
+ *
83183
+ * When called with a value of `null` or `undefined`, the default value of the property will be restored.
83184
+ *
83185
+ * Default value is `false`.
83186
+ *
83187
+ * @since 1.147
83188
+ *
83189
+ * @returns Reference to `this` in order to allow method chaining
83190
+ */
83191
+ setRightClick(
83192
+ /**
83193
+ * New value for property `rightClick`
83194
+ */
83195
+ bRightClick?: boolean
83196
+ ): this;
82445
83197
  /**
82446
83198
  * Sets a new value for property {@link #getShiftKey shiftKey}.
82447
83199
  *
@@ -82536,6 +83288,32 @@ declare module "sap/ui/test/actions/Press" {
82536
83288
  * @since 1.98
82537
83289
  */
82538
83290
  yPercentage?: float | PropertyBindingInfo | `{${string}}`;
83291
+
83292
+ /**
83293
+ * If it is set to `true`, a `keydown` keyboard event will be dispatched instead of mouse events. The modifier
83294
+ * keys (shiftKey, altKey, ctrlKey) will be applied to the keyboard event if set.
83295
+ *
83296
+ * @since 1.146
83297
+ */
83298
+ keyDown?: boolean | PropertyBindingInfo | `{${string}}`;
83299
+
83300
+ /**
83301
+ * If it is set to `true`, a `keyup` keyboard event will be dispatched instead of mouse events. The modifier
83302
+ * keys (shiftKey, altKey, ctrlKey) will be applied to the keyboard event if set.
83303
+ *
83304
+ * @since 1.146
83305
+ */
83306
+ keyUp?: boolean | PropertyBindingInfo | `{${string}}`;
83307
+
83308
+ /**
83309
+ * If set to `true`, a right-click (context menu) event will be triggered instead of a left-click. This
83310
+ * simulates the native browser right-click behavior by dispatching `mousedown` and `mouseup` with `button:
83311
+ * 2`, followed by a `contextmenu` event. The `xPercentage` and `yPercentage` properties can be used to
83312
+ * specify the position of the right-click event.
83313
+ *
83314
+ * @since 1.147
83315
+ */
83316
+ rightClick?: boolean | PropertyBindingInfo | `{${string}}`;
82539
83317
  }
82540
83318
  }
82541
83319
 
@@ -82619,6 +83397,8 @@ declare module "sap/ui/test/actions/Scroll" {
82619
83397
  /**
82620
83398
  * Gets current value of property {@link #getX x}.
82621
83399
  *
83400
+ * The x scroll position.
83401
+ *
82622
83402
  * Default value is `0`.
82623
83403
  *
82624
83404
  *
@@ -82628,6 +83408,8 @@ declare module "sap/ui/test/actions/Scroll" {
82628
83408
  /**
82629
83409
  * Gets current value of property {@link #getY y}.
82630
83410
  *
83411
+ * The y scroll position.
83412
+ *
82631
83413
  * Default value is `0`.
82632
83414
  *
82633
83415
  *
@@ -82637,6 +83419,8 @@ declare module "sap/ui/test/actions/Scroll" {
82637
83419
  /**
82638
83420
  * Sets a new value for property {@link #getX x}.
82639
83421
  *
83422
+ * The x scroll position.
83423
+ *
82640
83424
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
82641
83425
  *
82642
83426
  * Default value is `0`.
@@ -82653,6 +83437,8 @@ declare module "sap/ui/test/actions/Scroll" {
82653
83437
  /**
82654
83438
  * Sets a new value for property {@link #getY y}.
82655
83439
  *
83440
+ * The y scroll position.
83441
+ *
82656
83442
  * When called with a value of `null` or `undefined`, the default value of the property will be restored.
82657
83443
  *
82658
83444
  * Default value is `0`.
@@ -82671,8 +83457,14 @@ declare module "sap/ui/test/actions/Scroll" {
82671
83457
  * Describes the settings that can be provided to the Scroll constructor.
82672
83458
  */
82673
83459
  export interface $ScrollSettings extends $ActionSettings {
83460
+ /**
83461
+ * The x scroll position.
83462
+ */
82674
83463
  x?: int | PropertyBindingInfo | `{${string}}`;
82675
83464
 
83465
+ /**
83466
+ * The y scroll position.
83467
+ */
82676
83468
  y?: int | PropertyBindingInfo | `{${string}}`;
82677
83469
  }
82678
83470
  }
@@ -85998,6 +86790,27 @@ declare module "sap/ui/test/Opa5" {
85998
86790
  * Use when there are multiple views with the same viewName.
85999
86791
  */
86000
86792
  viewId?: string;
86793
+ /**
86794
+ * The namespace to be prepended to the view name defined in the `viewName` parameter. When set, all `waitFor`
86795
+ * calls inside the page object will resolve the view by `viewNamespace + "." + viewName`.
86796
+ *
86797
+ * Example:
86798
+ * ```javascript
86799
+ *
86800
+ * Opa5.createPageObjects({
86801
+ * onMyPage: {
86802
+ * viewName: "myView",
86803
+ * viewNamespace: "my.app.namespace",
86804
+ * assertions: { ... }
86805
+ * }
86806
+ * });
86807
+ * ```
86808
+ *
86809
+ *
86810
+ * Note: If all page objects share the same `viewNamespace`, consider setting it globally via {@link sap.ui.test.Opa5.extendConfig }
86811
+ * to avoid repetition.
86812
+ */
86813
+ viewNamespace?: string;
86001
86814
  /**
86002
86815
  * Base class for the page object's actions and assertions
86003
86816
  */
@@ -86628,8 +87441,13 @@ declare module "sap/ui/test/RecordReplay" {
86628
87441
  * 'InteractionType'.
86629
87442
  */
86630
87443
  enum InteractionType {
87444
+ /**
87445
+ * "EnterText" interaction type.
87446
+ */
86631
87447
  EnterText = "ENTER_TEXT",
86632
-
87448
+ /**
87449
+ * "Press" Interaction type.
87450
+ */
86633
87451
  Press = "PRESS",
86634
87452
  }
86635
87453
  }