@openui5/ts-types 1.107.1 → 1.108.0

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.107.1
+// For Library Version: 1.108.0
 
 declare namespace sap {
   namespace ui {
@@ -1316,7 +1316,7 @@ declare namespace sap {
           | `{${string}}`;
 
         /**
-         * @EXPERIMENTAL (since 1.28)
+         * @EXPERIMENTAL (since 1.28) - This feature has a limited functionality.
          *
          * Enables or disables grouping. If grouping is enabled, the table is grouped by the column which is defined
          * in the `groupBy` association.
@@ -1640,7 +1640,7 @@ declare namespace sap {
           | `{${string}}`;
 
         /**
-         * @EXPERIMENTAL (since 1.28)
+         * @EXPERIMENTAL (since 1.28) - This feature has a limited functionality.
          *
          * The column by which the table is grouped. Grouping will only be performed if `enableGrouping` is set
          * to `true`. Setting `groupBy` in the view does not work and throws an error. It can only be set if the
@@ -1831,7 +1831,8 @@ declare namespace sap {
 
       interface $TreeTableSettings extends sap.ui.table.$TableSettings {
         /**
-         * @deprecated (since 1.46.3) - replaced by the `numberOfExpandedLevels` binding parameter
+         * @deprecated (since 1.46.3) - replaced by the `numberOfExpandedLevels` binding parameter. May not work
+         * with all bindings.
          *
          * Specifies whether the first level is expanded.
          *
@@ -1872,7 +1873,8 @@ declare namespace sap {
           | sap.ui.base.ManagedObject.PropertyBindingInfo;
 
         /**
-         * @deprecated (since 1.76) - replaced by the `collapseRecursive` binding parameter
+         * @deprecated (since 1.76) - replaced by the `collapseRecursive` binding parameter. May not work with all
+         * bindings.
          *
          * Setting collapseRecursive to true means, that when collapsing a node all subsequent child nodes will
          * also be collapsed. This property is only supported with sap.ui.model.odata.v2.ODataModel. **Note:** collapseRecursive
@@ -1897,7 +1899,7 @@ declare namespace sap {
           | `{${string}}`;
 
         /**
-         * @deprecated (since 1.76) - replaced by the `rootLevel` binding parameter
+         * @deprecated (since 1.76) - replaced by the `rootLevel` binding parameter. May not work with all bindings.
          *
          * The root level is the level of the topmost tree nodes, which will be used as an entry point for OData
          * services. This property is only supported when the TreeTable uses an underlying odata services with hierarchy
@@ -2128,7 +2130,7 @@ declare namespace sap {
         ): this;
       }
       /**
-       * @EXPERIMENTAL (since 1.21)
+       * @EXPERIMENTAL (since 1.21) - The AnalyticalColumnMenu will be productized soon.
        *
        * A column menu which is used by the analytical column
        */
@@ -5675,7 +5677,8 @@ declare namespace sap {
           oListener?: object
         ): this;
         /**
-         * @EXPERIMENTAL
+         * @EXPERIMENTAL - Experimental! Presently implemented to only work with a very limited set of controls
+         * (e.g. sap.m.Text).
          *
          * Triggers automatic resizing of a column to the widest content.
          */
@@ -6109,7 +6112,8 @@ declare namespace sap {
         ): this;
         /**
          * @deprecated (since 1.56) - replaced by the `sap.ui.export` library.
-         * @EXPERIMENTAL
+         * @EXPERIMENTAL - Experimental because the property for the column/cell definitions (sortProperty) could
+         * change in future.
          *
          * Creates a new {@link sap.ui.core.util.Export} object and fills row/column information from the table
          * if not provided. For the cell content, the column's "sortProperty" will be used (experimental!)
@@ -6747,7 +6751,7 @@ declare namespace sap {
          */
         getEnableCustomFilter(): boolean;
         /**
-         * @EXPERIMENTAL (since 1.28)
+         * @EXPERIMENTAL (since 1.28) - This feature has a limited functionality.
          *
          * Gets current value of property {@link #getEnableGrouping enableGrouping}.
          *
@@ -6855,7 +6859,7 @@ declare namespace sap {
          */
         getFooter(): sap.ui.core.Control | string;
         /**
-         * @EXPERIMENTAL (since 1.28)
+         * @EXPERIMENTAL (since 1.28) - This feature has a limited functionality.
          *
          * ID of the element which is the current target of the association {@link #getGroupBy groupBy}, or `null`.
          */
@@ -7579,7 +7583,7 @@ declare namespace sap {
           bEnableCustomFilter?: boolean
         ): this;
         /**
-         * @EXPERIMENTAL (since 1.28)
+         * @EXPERIMENTAL (since 1.28) - This feature has a limited functionality.
          *
          * Sets a new value for property {@link #getEnableGrouping enableGrouping}.
          *
@@ -7727,7 +7731,7 @@ declare namespace sap {
           vFooter: sap.ui.core.Control | string
         ): this;
         /**
-         * @EXPERIMENTAL (since 1.28)
+         * @EXPERIMENTAL (since 1.28) - This feature has a limited functionality.
          *
          * Sets the associated {@link #getGroupBy groupBy}.
          *
@@ -8255,7 +8259,7 @@ declare namespace sap {
          */
         getTable(): sap.ui.core.ID;
         /**
-         * @EXPERIMENTAL (since 1.21.2)
+         * @EXPERIMENTAL (since 1.21.2) - API might change / feature requires the sap.m library!
          *
          * Opens the personalization dialog for the Table to modify the visibility and the order of the columns.
          *
@@ -8609,7 +8613,8 @@ declare namespace sap {
           }
         ): this;
         /**
-         * @deprecated (since 1.76) - replaced by the `collapseRecursive` binding parameter
+         * @deprecated (since 1.76) - replaced by the `collapseRecursive` binding parameter. May not work with all
+         * bindings.
          *
          * Gets current value of property {@link #getCollapseRecursive collapseRecursive}.
          *
@@ -8643,7 +8648,8 @@ declare namespace sap {
          */
         getEnableGrouping(): boolean;
         /**
-         * @deprecated (since 1.46.3) - replaced by the `numberOfExpandedLevels` binding parameter
+         * @deprecated (since 1.46.3) - replaced by the `numberOfExpandedLevels` binding parameter. May not work
+         * with all bindings.
          *
          * Gets current value of property {@link #getExpandFirstLevel expandFirstLevel}.
          *
@@ -8685,7 +8691,7 @@ declare namespace sap {
          */
         getGroupHeaderProperty(): string;
         /**
-         * @deprecated (since 1.76) - replaced by the `rootLevel` binding parameter
+         * @deprecated (since 1.76) - replaced by the `rootLevel` binding parameter. May not work with all bindings.
          *
          * Gets current value of property {@link #getRootLevel rootLevel}.
          *
@@ -8771,7 +8777,8 @@ declare namespace sap {
          */
         selectAll(): this;
         /**
-         * @deprecated (since 1.76) - replaced by the `collapseRecursive` binding parameter
+         * @deprecated (since 1.76) - replaced by the `collapseRecursive` binding parameter. May not work with all
+         * bindings.
          *
          * Sets a new value for property {@link #getCollapseRecursive collapseRecursive}.
          *
@@ -8816,7 +8823,8 @@ declare namespace sap {
          */
         setEnableGrouping(bValue: boolean): this;
         /**
-         * @deprecated (since 1.46.3) - replaced by the `numberOfExpandedLevels` binding parameter
+         * @deprecated (since 1.46.3) - replaced by the `numberOfExpandedLevels` binding parameter. May not work
+         * with all bindings.
          *
          * Sets a new value for property {@link #getExpandFirstLevel expandFirstLevel}.
          *
@@ -8889,7 +8897,7 @@ declare namespace sap {
           sGroupHeaderProperty?: string
         ): this;
         /**
-         * @deprecated (since 1.76) - replaced by the `rootLevel` binding parameter
+         * @deprecated (since 1.76) - replaced by the `rootLevel` binding parameter. May not work with all bindings.
          *
          * Sets a new value for property {@link #getRootLevel rootLevel}.
          *

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.107.1
+// For Library Version: 1.108.0
 
 declare namespace sap {
   interface IUI5DefineDependencyNames {

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.107.1
+// For Library Version: 1.108.0
 
 declare namespace sap {
   namespace ui {
@@ -240,8 +240,9 @@ declare namespace sap {
           /**
            * @SINCE 1.28.9
            *
-           * If set, the first day of the displayed week is this day. Valid values are 0 to 6. If not a valid value
-           * is set, the default of the used locale is used.
+           * If the property is set, this day marks the start of the displayed week. Valid values are 0 to 6. If no
+           * valid property is set, the current locale's default is applied. Note: This property should not be used
+           * with the calendarWeekNumbering property.
            */
           firstDayOfWeek?:
             | int
@@ -304,6 +305,17 @@ declare namespace sap {
             | sap.ui.base.ManagedObject.PropertyBindingInfo
             | `{${string}}`;
 
+          /**
+           * @SINCE 1.108.0
+           *
+           * If set, the calendar week numbering is used for display. If not set, the calendar week numbering of the
+           * global configuration is used. Note: This property should not be used with firstDayOfWeek property.
+           */
+          calendarWeekNumbering?:
+            | sap.ui.core.date.CalendarWeekNumbering
+            | sap.ui.base.ManagedObject.PropertyBindingInfo
+            | `{${string}}`;
+
           /**
            * Date Ranges for selected dates of the DatePicker
            */
@@ -523,6 +535,17 @@ declare namespace sap {
             | sap.ui.base.ManagedObject.PropertyBindingInfo
             | `{${string}}`;
 
+          /**
+           * @SINCE 1.108.0
+           *
+           * If set, the calendar type is used for display. If not set, the calendar type of the global configuration
+           * is used.
+           */
+          primaryCalendarType?:
+            | sap.ui.core.CalendarType
+            | sap.ui.base.ManagedObject.PropertyBindingInfo
+            | `{${string}}`;
+
           /**
            * Date ranges for selected dates. If `singleSelection` is set, only the first entry is used.
            *
@@ -640,6 +663,17 @@ declare namespace sap {
             | sap.ui.base.ManagedObject.PropertyBindingInfo
             | `{${string}}`;
 
+          /**
+           * @SINCE 1.108.0
+           *
+           * If set, the calendar type is used for display. If not set, the calendar type of the global configuration
+           * is used.
+           */
+          primaryCalendarType?:
+            | sap.ui.core.CalendarType
+            | sap.ui.base.ManagedObject.PropertyBindingInfo
+            | `{${string}}`;
+
           /**
            * Date ranges for selected dates. If `singleSelection` is set, only the first entry is used.
            */
@@ -2327,6 +2361,17 @@ declare namespace sap {
            * ariaLabelledBy}.
            */
           getAriaLabelledBy(): sap.ui.core.ID[];
+          /**
+           * @SINCE 1.108.0
+           *
+           * Gets current value of property {@link #getCalendarWeekNumbering calendarWeekNumbering}.
+           *
+           * If set, the calendar week numbering is used for display. If not set, the calendar week numbering of the
+           * global configuration is used. Note: This property should not be used with firstDayOfWeek property.
+           *
+           * @returns Value of property `calendarWeekNumbering`
+           */
+          getCalendarWeekNumbering(): sap.ui.core.date.CalendarWeekNumbering;
           /**
            * Gets current value of property {@link #getDate date}.
            *
@@ -2349,8 +2394,9 @@ declare namespace sap {
            *
            * Gets current value of property {@link #getFirstDayOfWeek firstDayOfWeek}.
            *
-           * If set, the first day of the displayed week is this day. Valid values are 0 to 6. If not a valid value
-           * is set, the default of the used locale is used.
+           * If the property is set, this day marks the start of the displayed week. Valid values are 0 to 6. If no
+           * valid property is set, the current locale's default is applied. Note: This property should not be used
+           * with the calendarWeekNumbering property.
            *
            * Default value is `-1`.
            *
@@ -2636,6 +2682,24 @@ declare namespace sap {
              */
             vSpecialDate: int | string | sap.ui.unified.DateTypeRange
           ): sap.ui.unified.DateTypeRange | null;
+          /**
+           * @SINCE 1.108.0
+           *
+           * Sets a new value for property {@link #getCalendarWeekNumbering calendarWeekNumbering}.
+           *
+           * If set, the calendar week numbering is used for display. If not set, the calendar week numbering of the
+           * global configuration is used. Note: This property should not be used with firstDayOfWeek property.
+           *
+           * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+           *
+           * @returns Reference to `this` in order to allow method chaining
+           */
+          setCalendarWeekNumbering(
+            /**
+             * New value for property `calendarWeekNumbering`
+             */
+            sCalendarWeekNumbering?: sap.ui.core.date.CalendarWeekNumbering
+          ): this;
           /**
            * Sets a new value for property {@link #getDate date}.
            *
@@ -2657,8 +2721,9 @@ declare namespace sap {
            *
            * Sets a new value for property {@link #getFirstDayOfWeek firstDayOfWeek}.
            *
-           * If set, the first day of the displayed week is this day. Valid values are 0 to 6. If not a valid value
-           * is set, the default of the used locale is used.
+           * If the property is set, this day marks the start of the displayed week. Valid values are 0 to 6. If no
+           * valid property is set, the current locale's default is applied. Note: This property should not be used
+           * with the calendarWeekNumbering property.
            *
            * When called with a value of `null` or `undefined`, the default value of the property will be restored.
            *
@@ -3732,6 +3797,17 @@ declare namespace sap {
            * @returns Value of property `months`
            */
           getMonths(): int;
+          /**
+           * @SINCE 1.108.0
+           *
+           * Gets current value of property {@link #getPrimaryCalendarType primaryCalendarType}.
+           *
+           * If set, the calendar type is used for display. If not set, the calendar type of the global configuration
+           * is used.
+           *
+           * @returns Value of property `primaryCalendarType`
+           */
+          getPrimaryCalendarType(): sap.ui.core.CalendarType;
           /**
            * Gets content of aggregation {@link #getSelectedDates selectedDates}.
            *
@@ -3942,6 +4018,24 @@ declare namespace sap {
              */
             iMonths?: int
           ): this;
+          /**
+           * @SINCE 1.108.0
+           *
+           * Sets a new value for property {@link #getPrimaryCalendarType primaryCalendarType}.
+           *
+           * If set, the calendar type is used for display. If not set, the calendar type of the global configuration
+           * is used.
+           *
+           * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+           *
+           * @returns Reference to `this` in order to allow method chaining
+           */
+          setPrimaryCalendarType(
+            /**
+             * New value for property `primaryCalendarType`
+             */
+            sPrimaryCalendarType?: sap.ui.core.CalendarType
+          ): this;
           /**
            * Sets a new value for property {@link #getShowHeader showHeader}.
            *
@@ -4351,6 +4445,17 @@ declare namespace sap {
            * ID of the element which is the current target of the association {@link #getLegend legend}, or `null`.
            */
           getLegend(): sap.ui.core.ID;
+          /**
+           * @SINCE 1.108.0
+           *
+           * Gets current value of property {@link #getPrimaryCalendarType primaryCalendarType}.
+           *
+           * If set, the calendar type is used for display. If not set, the calendar type of the global configuration
+           * is used.
+           *
+           * @returns Value of property `primaryCalendarType`
+           */
+          getPrimaryCalendarType(): sap.ui.core.CalendarType;
           /**
            * Gets content of aggregation {@link #getSelectedDates selectedDates}.
            *
@@ -4596,6 +4701,24 @@ declare namespace sap {
              */
             oLegend: sap.ui.core.ID | sap.ui.unified.CalendarLegend
           ): this;
+          /**
+           * @SINCE 1.108.0
+           *
+           * Sets a new value for property {@link #getPrimaryCalendarType primaryCalendarType}.
+           *
+           * If set, the calendar type is used for display. If not set, the calendar type of the global configuration
+           * is used.
+           *
+           * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+           *
+           * @returns Reference to `this` in order to allow method chaining
+           */
+          setPrimaryCalendarType(
+            /**
+             * New value for property `primaryCalendarType`
+             */
+            sPrimaryCalendarType?: sap.ui.core.CalendarType
+          ): this;
           /**
            * Sets a new value for property {@link #getShowHeader showHeader}.
            *
@@ -5235,8 +5358,9 @@ declare namespace sap {
         /**
          * @SINCE 1.28.9
          *
-         * If set, the first day of the displayed week is this day. Valid values are 0 to 6. If not a valid value
-         * is set, the default of the used locale is used.
+         * If the property is set, this day marks the start of the displayed week. Valid values are 0 to 6. If no
+         * valid property is set, the current locale's default is applied. Note: This property should not be used
+         * with the calendarWeekNumbering property.
          */
         firstDayOfWeek?:
           | int
@@ -5348,6 +5472,17 @@ declare namespace sap {
           | sap.ui.base.ManagedObject.PropertyBindingInfo
           | `{${string}}`;
 
+        /**
+         * @SINCE 1.108.0
+         *
+         * If set, the calendar week numbering is used for display. If not set, the calendar week numbering of the
+         * global configuration is used. Note: This property should not be used with firstDayOfWeek property.
+         */
+        calendarWeekNumbering?:
+          | sap.ui.core.date.CalendarWeekNumbering
+          | sap.ui.base.ManagedObject.PropertyBindingInfo
+          | `{${string}}`;
+
         /**
          * Dates or date ranges for selected dates.
          *
@@ -5504,7 +5639,8 @@ declare namespace sap {
 
         /**
          * @SINCE 1.93.0
-         * @EXPERIMENTAL (since 1.93)
+         * @EXPERIMENTAL (since 1.93) - providing only limited functionality. Also, the API might be changed in
+         * the future.
          *
          * Holds the content of the appointment.
          *
@@ -7897,6 +8033,17 @@ declare namespace sap {
          * ariaLabelledBy}.
          */
         getAriaLabelledBy(): sap.ui.core.ID[];
+        /**
+         * @SINCE 1.108.0
+         *
+         * Gets current value of property {@link #getCalendarWeekNumbering calendarWeekNumbering}.
+         *
+         * If set, the calendar week numbering is used for display. If not set, the calendar week numbering of the
+         * global configuration is used. Note: This property should not be used with firstDayOfWeek property.
+         *
+         * @returns Value of property `calendarWeekNumbering`
+         */
+        getCalendarWeekNumbering(): sap.ui.core.date.CalendarWeekNumbering;
         /**
          * @SINCE 1.38.0
          *
@@ -7913,8 +8060,9 @@ declare namespace sap {
          *
          * Gets current value of property {@link #getFirstDayOfWeek firstDayOfWeek}.
          *
-         * If set, the first day of the displayed week is this day. Valid values are 0 to 6. If not a valid value
-         * is set, the default of the used locale is used.
+         * If the property is set, this day marks the start of the displayed week. Valid values are 0 to 6. If no
+         * valid property is set, the current locale's default is applied. Note: This property should not be used
+         * with the calendarWeekNumbering property.
          *
          * Default value is `-1`.
          *
@@ -8288,13 +8436,32 @@ declare namespace sap {
            */
           vSpecialDate: int | string | sap.ui.unified.DateTypeRange
         ): sap.ui.unified.DateTypeRange | null;
+        /**
+         * @SINCE 1.108.0
+         *
+         * Sets a new value for property {@link #getCalendarWeekNumbering calendarWeekNumbering}.
+         *
+         * If set, the calendar week numbering is used for display. If not set, the calendar week numbering of the
+         * global configuration is used. Note: This property should not be used with firstDayOfWeek property.
+         *
+         * When called with a value of `null` or `undefined`, the default value of the property will be restored.
+         *
+         * @returns Reference to `this` in order to allow method chaining
+         */
+        setCalendarWeekNumbering(
+          /**
+           * New value for property `calendarWeekNumbering`
+           */
+          sCalendarWeekNumbering?: sap.ui.core.date.CalendarWeekNumbering
+        ): this;
         /**
          * @SINCE 1.28.9
          *
          * Sets a new value for property {@link #getFirstDayOfWeek firstDayOfWeek}.
          *
-         * If set, the first day of the displayed week is this day. Valid values are 0 to 6. If not a valid value
-         * is set, the default of the used locale is used.
+         * If the property is set, this day marks the start of the displayed week. Valid values are 0 to 6. If no
+         * valid property is set, the current locale's default is applied. Note: This property should not be used
+         * with the calendarWeekNumbering property.
          *
          * When called with a value of `null` or `undefined`, the default value of the property will be restored.
          *
@@ -8583,7 +8750,8 @@ declare namespace sap {
         static getMetadata(): sap.ui.core.ElementMetadata;
         /**
          * @SINCE 1.93.0
-         * @EXPERIMENTAL (since 1.93)
+         * @EXPERIMENTAL (since 1.93) - providing only limited functionality. Also, the API might be changed in
+         * the future.
          *
          * Adds some customContent to the aggregation {@link #getCustomContent customContent}.
          *
@@ -8597,7 +8765,8 @@ declare namespace sap {
         ): this;
         /**
          * @SINCE 1.93.0
-         * @EXPERIMENTAL (since 1.93)
+         * @EXPERIMENTAL (since 1.93) - providing only limited functionality. Also, the API might be changed in
+         * the future.
          *
          * Destroys all the customContent in the aggregation {@link #getCustomContent customContent}.
          *
@@ -8617,7 +8786,8 @@ declare namespace sap {
         getColor(): sap.ui.core.CSSColor;
         /**
          * @SINCE 1.93.0
-         * @EXPERIMENTAL (since 1.93)
+         * @EXPERIMENTAL (since 1.93) - providing only limited functionality. Also, the API might be changed in
+         * the future.
          *
          * Gets content of aggregation {@link #getCustomContent customContent}.
          *
@@ -8699,7 +8869,8 @@ declare namespace sap {
         getTitle(): string;
         /**
          * @SINCE 1.93.0
-         * @EXPERIMENTAL (since 1.93)
+         * @EXPERIMENTAL (since 1.93) - providing only limited functionality. Also, the API might be changed in
+         * the future.
          *
          * Checks for the provided `sap.ui.core.Control` in the aggregation {@link #getCustomContent customContent}.
          * and returns its index if found or -1 otherwise.
@@ -8714,7 +8885,8 @@ declare namespace sap {
         ): int;
         /**
          * @SINCE 1.93.0
-         * @EXPERIMENTAL (since 1.93)
+         * @EXPERIMENTAL (since 1.93) - providing only limited functionality. Also, the API might be changed in
+         * the future.
          *
          * Inserts a customContent into the aggregation {@link #getCustomContent customContent}.
          *
@@ -8734,7 +8906,8 @@ declare namespace sap {
         ): this;
         /**
          * @SINCE 1.93.0
-         * @EXPERIMENTAL (since 1.93)
+         * @EXPERIMENTAL (since 1.93) - providing only limited functionality. Also, the API might be changed in
+         * the future.
          *
          * Removes all the controls from the aggregation {@link #getCustomContent customContent}.
          *
@@ -8745,7 +8918,8 @@ declare namespace sap {
         removeAllCustomContent(): sap.ui.core.Control[];
         /**
          * @SINCE 1.93.0
-         * @EXPERIMENTAL (since 1.93)
+         * @EXPERIMENTAL (since 1.93) - providing only limited functionality. Also, the API might be changed in
+         * the future.
          *
          * Removes a customContent from the aggregation {@link #getCustomContent customContent}.
          *
@@ -13128,7 +13302,7 @@ declare namespace sap {
       /**
        * @SINCE 1.16.0
        * @deprecated (since 1.44.0)
-       * @EXPERIMENTAL (since 1.16.0)
+       * @EXPERIMENTAL (since 1.16.0) - API is not yet finished and might change completely
        *
        * Switches between two control areas and animates it via CSS transitions
        */
@@ -19408,7 +19582,7 @@ declare namespace sap {
       /**
        * @SINCE 1.15.0
        * @deprecated (since 1.44.0)
-       * @EXPERIMENTAL (since 1.15.0)
+       * @EXPERIMENTAL (since 1.15.0) - API is not yet finished and might change completely
        *
        * Provides a main content and a secondary content area
        */
@@ -19950,7 +20124,7 @@ declare namespace sap {
       }
       /**
        * @SINCE 1.16.0
-       * @EXPERIMENTAL (since 1.16.0)
+       * @EXPERIMENTAL (since 1.16.0) - API is not yet finished and might change completely
        *
        * Predefined animations for the ContentSwitcher
        */