@sapui5/ts-types 1.124.0 → 1.125.0

package/types/sap.suite.ui.microchart.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.124.0
+// For Library Version: 1.125.0
 
 declare namespace sap {
   namespace suite {
@@ -99,7 +99,7 @@ declare namespace sap {
            * in which the control is placed or by the width and height property.
            *
            * @since 1.38.0
-           * @deprecated (since 1.60)
+           * @deprecated (since 1.60) - the concept has been discarded.
            */
           isResponsive?:
             | boolean
@@ -439,7 +439,7 @@ declare namespace sap {
            * in which the control is placed or by the width and height property.
            *
            * @since 1.38.0
-           * @deprecated (since 1.58)
+           * @deprecated (since 1.58) - the concept has been discarded.
            */
           isResponsive?:
             | boolean
@@ -551,7 +551,7 @@ declare namespace sap {
            * in which the control is placed. Size, width and height properties are ignored in this case.
            *
            * @since 1.38.0
-           * @deprecated (since 1.60.0)
+           * @deprecated (since 1.60.0) - the concept has been discarded.
            */
           isResponsive?:
             | boolean
@@ -782,7 +782,7 @@ declare namespace sap {
            * in which the control is placed. Size and Width properties are ignored in such case.
            *
            * @since 1.38.0
-           * @deprecated (since 1.58)
+           * @deprecated (since 1.58) - the concept has been discarded.
            */
           isResponsive?:
             | boolean
@@ -958,7 +958,7 @@ declare namespace sap {
            * in which the control is placed. Size and Width properties are ignored in such case.
            *
            * @since 1.38.0
-           * @deprecated (since 1.61.0)
+           * @deprecated (since 1.61.0) - the concept has been discarded.
            */
           isResponsive?:
             | boolean
@@ -1090,7 +1090,7 @@ declare namespace sap {
            * container, in which case the `size` and `width` properties are ignored.
            *
            * @since 1.38.0
-           * @deprecated (since 1.62.0)
+           * @deprecated (since 1.62.0) - the concept has been discarded.
            */
           isResponsive?:
             | boolean
@@ -2687,7 +2687,7 @@ declare namespace sap {
            * Default value is `false`.
            *
            * @since 1.38.0
-           * @deprecated (since 1.60)
+           * @deprecated (since 1.60) - the concept has been discarded.
            *
            * @returns Value of property `isResponsive`
            */
@@ -3021,7 +3021,7 @@ declare namespace sap {
            * Default value is `false`.
            *
            * @since 1.38.0
-           * @deprecated (since 1.60)
+           * @deprecated (since 1.60) - the concept has been discarded.
            *
            * @returns Reference to `this` in order to allow method chaining
            */
@@ -4053,7 +4053,7 @@ declare namespace sap {
            * Default value is `false`.
            *
            * @since 1.38.0
-           * @deprecated (since 1.58)
+           * @deprecated (since 1.58) - the concept has been discarded.
            *
            * @returns Value of property `isResponsive`
            */
@@ -4427,7 +4427,7 @@ declare namespace sap {
            * Default value is `false`.
            *
            * @since 1.38.0
-           * @deprecated (since 1.58)
+           * @deprecated (since 1.58) - the concept has been discarded.
            *
            * @returns Reference to `this` in order to allow method chaining
            */
@@ -5155,7 +5155,7 @@ declare namespace sap {
            * Default value is `false`.
            *
            * @since 1.38.0
-           * @deprecated (since 1.60.0)
+           * @deprecated (since 1.60.0) - the concept has been discarded.
            *
            * @returns Value of property `isResponsive`
            */
@@ -5362,7 +5362,7 @@ declare namespace sap {
            * Default value is `false`.
            *
            * @since 1.38.0
-           * @deprecated (since 1.60.0)
+           * @deprecated (since 1.60.0) - the concept has been discarded.
            *
            * @returns Reference to `this` in order to allow method chaining
            */
@@ -6150,7 +6150,7 @@ declare namespace sap {
            * Default value is `false`.
            *
            * @since 1.38.0
-           * @deprecated (since 1.58)
+           * @deprecated (since 1.58) - the concept has been discarded.
            *
            * @returns Value of property `isResponsive`
            */
@@ -6373,7 +6373,7 @@ declare namespace sap {
            * Default value is `false`.
            *
            * @since 1.38.0
-           * @deprecated (since 1.58)
+           * @deprecated (since 1.58) - the concept has been discarded.
            *
            * @returns Reference to `this` in order to allow method chaining
            */
@@ -7027,7 +7027,7 @@ declare namespace sap {
            * Default value is `false`.
            *
            * @since 1.38.0
-           * @deprecated (since 1.61.0)
+           * @deprecated (since 1.61.0) - the concept has been discarded.
            *
            * @returns Value of property `isResponsive`
            */
@@ -7234,7 +7234,7 @@ declare namespace sap {
            * Default value is `false`.
            *
            * @since 1.38.0
-           * @deprecated (since 1.61.0)
+           * @deprecated (since 1.61.0) - the concept has been discarded.
            *
            * @returns Reference to `this` in order to allow method chaining
            */
@@ -7647,7 +7647,7 @@ declare namespace sap {
            * Default value is `false`.
            *
            * @since 1.38.0
-           * @deprecated (since 1.62.0)
+           * @deprecated (since 1.62.0) - the concept has been discarded.
            *
            * @returns Value of property `isResponsive`
            */
@@ -7911,7 +7911,7 @@ declare namespace sap {
            * Default value is `false`.
            *
            * @since 1.38.0
-           * @deprecated (since 1.62.0)
+           * @deprecated (since 1.62.0) - the concept has been discarded.
            *
            * @returns Reference to `this` in order to allow method chaining
            */

package/types/sap.tnt.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.124.0
+// For Library Version: 1.125.0
 
 declare namespace sap {
   /**

package/types/sap.ui.codeeditor.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.124.0
+// For Library Version: 1.125.0
 
 declare namespace sap {
   namespace ui {

package/types/sap.ui.commons.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.124.0
+// For Library Version: 1.125.0
 
 declare namespace sap {
   namespace ui {

package/types/sap.ui.comp.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.124.0
+// For Library Version: 1.125.0
 
 declare namespace sap {
   namespace ui {
@@ -9991,7 +9991,7 @@ declare namespace sap {
            * library is loaded synchroniously as soon as a event handler for the `initialise` event has been attached.
            * Since this event does not fulfill CSP requirements, please use event `initialized` instead.
            *
-           * @deprecated (since 1.65)
+           * @deprecated (since 1.65) - replaced by {@link initialized}.
            */
           initialise?: (oEvent: sap.ui.base.Event) => void;
 
@@ -10146,7 +10146,7 @@ declare namespace sap {
         /**
          * Parameters of the SmartChart#initialise event.
          *
-         * @deprecated (since 1.65)
+         * @deprecated (since 1.65) - replaced by {@link initialized}.
          */
         interface SmartChart$InitialiseEventParameters {}
 
@@ -11073,7 +11073,7 @@ declare namespace sap {
            *
            * The passed function and listener object must match the ones used for event registration.
            *
-           * @deprecated (since 1.65)
+           * @deprecated (since 1.65) - replaced by {@link initialized}.
            *
            * @returns Reference to `this` in order to allow method chaining
            */
@@ -11277,7 +11277,7 @@ declare namespace sap {
           /**
            * Fires event {@link #event:initialise initialise} to attached listeners.
            *
-           * @deprecated (since 1.65)
+           * @deprecated (since 1.65) - replaced by {@link initialized}.
            * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * @returns Reference to `this` in order to allow method chaining
@@ -12690,7 +12690,7 @@ declare namespace sap {
         /**
          * Event object of the SmartChart#initialise event.
          *
-         * @deprecated (since 1.65)
+         * @deprecated (since 1.65) - replaced by {@link initialized}.
          */
         type SmartChart$InitialiseEvent = sap.ui.base.Event<
           SmartChart$InitialiseEventParameters,
@@ -25565,7 +25565,7 @@ declare namespace sap {
            * If this set to true, width and height of the control are determined by the width and height of the container
            * in which the control is placed or by the width and height property.
            *
-           * @deprecated (since 1.62)
+           * @deprecated (since 1.62) - the concept has been discarded.
            */
           isResponsive?:
             | boolean
@@ -25679,7 +25679,7 @@ declare namespace sap {
            * If this set to true, width and height of the control are determined by the width and height of the container
            * in which the control is placed or by the width and height property.
            *
-           * @deprecated (since 1.62)
+           * @deprecated (since 1.62) - the concept has been discarded.
            */
           isResponsive?:
             | boolean
@@ -26702,7 +26702,7 @@ declare namespace sap {
            *
            * Default value is `false`.
            *
-           * @deprecated (since 1.62)
+           * @deprecated (since 1.62) - the concept has been discarded.
            *
            * @returns Value of property `isResponsive`
            */
@@ -26886,7 +26886,7 @@ declare namespace sap {
            *
            * Default value is `false`.
            *
-           * @deprecated (since 1.62)
+           * @deprecated (since 1.62) - the concept has been discarded.
            *
            * @returns Reference to `this` in order to allow method chaining
            */
@@ -27193,7 +27193,7 @@ declare namespace sap {
            *
            * Default value is `false`.
            *
-           * @deprecated (since 1.62)
+           * @deprecated (since 1.62) - the concept has been discarded.
            *
            * @returns Value of property `isResponsive`
            */
@@ -27346,7 +27346,7 @@ declare namespace sap {
            *
            * Default value is `false`.
            *
-           * @deprecated (since 1.62)
+           * @deprecated (since 1.62) - the concept has been discarded.
            *
            * @returns Reference to `this` in order to allow method chaining
            */
@@ -30258,16 +30258,19 @@ declare namespace sap {
           /**
            * This event is fired just before the paste event is triggered and can be used to prevent the default paste
            * behavior.
+           * **Note**: If no validation is desired, applications can use the `rawData` parameter to directly access
+           * the pasted data.
+           * **Note**: If a column contains additional properties, they are considered as separate columns for the
+           * pasting.
            *
            * @since 1.64
-           * @experimental (since 1.64) - This API is experimental and subject to change
            */
           beforePaste?: (oEvent: SmartTable$BeforePasteEvent) => void;
 
           /**
-           * This event is fired when paste is triggered.
+           * This event is fired when pasting is triggered.
            *
-           * @experimental (since 1.64) - This API is experimental and subject to change
+           * @since 1.64
            */
           paste?: (oEvent: SmartTable$PasteEvent) => void;
 
@@ -30332,14 +30335,18 @@ declare namespace sap {
 
         /**
          * Parameters of the SmartTable#beforePaste event.
-         *
-         * @experimental (since 1.64) - This API is experimental and subject to change
          */
         interface SmartTable$BeforePasteEventParameters {
           /**
-           * Contains array of column info object as determined by the SmartTable
+           * Contains an array of column info objects as determined by the `SmartTable` control.
+           */
+          columnInfos?: sap.ui.comp.smarttable.ColumnInfoForPaste[];
+
+          /**
+           * Two-dimensional array of strings with data from the clipboard. The first dimension represents the rows,
+           * and the second dimension represents the cells of the tabular data.
            */
-          columnInfos?: object[];
+          rawData?: string[][];
         }
 
         /**
@@ -30398,12 +30405,46 @@ declare namespace sap {
 
         /**
          * Parameters of the SmartTable#paste event.
-         *
-         * @experimental (since 1.64) - This API is experimental and subject to change
          */
         interface SmartTable$PasteEventParameters {
           /**
-           * Contains parsed/validated paste information returned by PasteHelper.parse API
+           * The result of the parsing returned by `PasteHelper.parse` API.
+           *  The result object contains parsed data if the validation was successful (the error array has the value
+           * `null`), or it contains all collected errors if the validation failed (the data array has the value `null`).
+           *
+           * Example of the result object after the successful validation - the data array is filled, and the error
+           * object is empty:
+           * ```javascript
+           *
+           *   oResult = {
+           *     parsedData: [
+           *       {FirstName: "Max", LastName : "Mustermann"},
+           *       {FirstName: "John", LastName: "Doe"}
+           *     ],
+           *     errors: null
+           *   });
+           * ```
+           *
+           *
+           * The error array contains objects with the following properties:
+           * 	 - row {number} Row index where the error occurred
+           * 	 - column {number} Column index where the error occurred
+           * 	 - property {string} The column-related property
+           * 	 - value {string} The pasted value
+           * 	 - type {object} The type instance that is used to parse the pasted value
+           * 	 - message {string} The error message
+           *
+           * Example of the result object after the failed validation - error information is available, and the data
+           * array is empty:
+           * ```javascript
+           *
+           *   oResult = {
+           *     parsedData: null,
+           *     errors: [
+           *       {row: 2, column: 3, property: 'age', value: 'x', type:'sap.ui.model.odata.type.Byte', message: 'Value "x" in row 2 and column 2 cannot be parsed.'}
+           *     ]
+           *   });
+           * ```
            */
           result?: object;
         }
@@ -30742,9 +30783,12 @@ declare namespace sap {
            *
            * This event is fired just before the paste event is triggered and can be used to prevent the default paste
            * behavior.
+           * **Note**: If no validation is desired, applications can use the `rawData` parameter to directly access
+           * the pasted data.
+           * **Note**: If a column contains additional properties, they are considered as separate columns for the
+           * pasting.
            *
            * @since 1.64
-           * @experimental (since 1.64) - This API is experimental and subject to change
            *
            * @returns Reference to `this` in order to allow method chaining
            */
@@ -30771,9 +30815,12 @@ declare namespace sap {
            *
            * This event is fired just before the paste event is triggered and can be used to prevent the default paste
            * behavior.
+           * **Note**: If no validation is desired, applications can use the `rawData` parameter to directly access
+           * the pasted data.
+           * **Note**: If a column contains additional properties, they are considered as separate columns for the
+           * pasting.
            *
            * @since 1.64
-           * @experimental (since 1.64) - This API is experimental and subject to change
            *
            * @returns Reference to `this` in order to allow method chaining
            */
@@ -31148,9 +31195,9 @@ declare namespace sap {
            * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
            * otherwise it will be bound to this `sap.ui.comp.smarttable.SmartTable` itself.
            *
-           * This event is fired when paste is triggered.
+           * This event is fired when pasting is triggered.
            *
-           * @experimental (since 1.64) - This API is experimental and subject to change
+           * @since 1.64
            *
            * @returns Reference to `this` in order to allow method chaining
            */
@@ -31175,9 +31222,9 @@ declare namespace sap {
            * When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
            * otherwise it will be bound to this `sap.ui.comp.smarttable.SmartTable` itself.
            *
-           * This event is fired when paste is triggered.
+           * This event is fired when pasting is triggered.
            *
-           * @experimental (since 1.64) - This API is experimental and subject to change
+           * @since 1.64
            *
            * @returns Reference to `this` in order to allow method chaining
            */
@@ -31440,7 +31487,6 @@ declare namespace sap {
            * The passed function and listener object must match the ones used for event registration.
            *
            * @since 1.64
-           * @experimental (since 1.64) - This API is experimental and subject to change
            *
            * @returns Reference to `this` in order to allow method chaining
            */
@@ -31597,7 +31643,7 @@ declare namespace sap {
            *
            * The passed function and listener object must match the ones used for event registration.
            *
-           * @experimental (since 1.64) - This API is experimental and subject to change
+           * @since 1.64
            *
            * @returns Reference to `this` in order to allow method chaining
            */
@@ -31729,7 +31775,6 @@ declare namespace sap {
            * event object. The return value of this method indicates whether the default action should be executed.
            *
            * @since 1.64
-           * @experimental (since 1.64) - This API is experimental and subject to change
            * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * @returns Whether or not to prevent the default action
@@ -31843,7 +31888,7 @@ declare namespace sap {
           /**
            * Fires event {@link #event:paste paste} to attached listeners.
            *
-           * @experimental (since 1.64) - This API is experimental and subject to change
+           * @since 1.64
            * @ui5-protected Do not call from applications (only from related classes in the framework)
            *
            * @returns Reference to `this` in order to allow method chaining
@@ -33864,6 +33909,35 @@ declare namespace sap {
            */
           TreeTable = "TreeTable",
         }
+        /**
+         * Paste-related column information
+         *
+         * @since 1.125
+         */
+        type ColumnInfoForPaste = {
+          /**
+           * ID of the column
+           */
+          columnId: string;
+          /**
+           * Data property that is used when pasting data
+           */
+          property: string;
+          /**
+           * Defines whether the column is ignored during pasting
+           */
+          ignore: boolean;
+          /**
+           * The type instance that is used to parse the pasted value
+           */
+          type: sap.ui.model.SimpleType;
+          /**
+           * Function that is used to parse the pasted value if no type instance is available (for example, for custom
+           * columns)
+           */
+          customParseFunction?: Function;
+        };
+
         /**
          * Event object of the SmartTable#afterVariantApply event.
          */
@@ -33898,8 +33972,6 @@ declare namespace sap {
 
         /**
          * Event object of the SmartTable#beforePaste event.
-         *
-         * @experimental (since 1.64) - This API is experimental and subject to change
          */
         type SmartTable$BeforePasteEvent = sap.ui.base.Event<
           SmartTable$BeforePasteEventParameters,
@@ -33968,8 +34040,6 @@ declare namespace sap {
 
         /**
          * Event object of the SmartTable#paste event.
-         *
-         * @experimental (since 1.64) - This API is experimental and subject to change
          */
         type SmartTable$PasteEvent = sap.ui.base.Event<
           SmartTable$PasteEventParameters,
@@ -34034,8 +34104,9 @@ declare namespace sap {
             | sap.ui.base.ManagedObject.PropertyBindingInfo;
 
           /**
-           * The OData entity set whose metadata is used to create the variant items based on the SelectionPresentationVariant
+           * The v2 oData entity set whose metadata is used to create the variant items based on the `SelectionPresentationVariant`
            * annotation.
+           * **Note:**This property may be set only once during the initialization phase and may not be changed afterwords.
            */
           entitySet?: string | sap.ui.base.ManagedObject.PropertyBindingInfo;
 
@@ -35062,8 +35133,9 @@ declare namespace sap {
           /**
            * Gets current value of property {@link #getEntitySet entitySet}.
            *
-           * The OData entity set whose metadata is used to create the variant items based on the SelectionPresentationVariant
+           * The v2 oData entity set whose metadata is used to create the variant items based on the `SelectionPresentationVariant`
            * annotation.
+           * **Note:**This property may be set only once during the initialization phase and may not be changed afterwords.
            *
            *
            * @returns Value of property `entitySet`