@openui5/ts-types 1.102.10 → 1.102.12

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openui5/ts-types",
-  "version": "1.102.10",
+  "version": "1.102.12",
   "description": "OpenUI5 TypeScript Definitions",
   "homepage": "https://openui5.org",
   "author": "SAP SE (https://www.sap.com)",

package/types/sap.f.d.ts

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

package/types/sap.m.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.102.10
+// For Library Version: 1.102.12
 
 declare namespace sap {
   /**
@@ -15183,6 +15183,18 @@ declare namespace sap {
         | sap.ui.base.ManagedObject.PropertyBindingInfo
         | `{${string}}`;
 
+      /**
+       * @SINCE 1.102.11
+       *
+       * 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 API has been introduced with version 1.108 and downported to
+       * this release with patch level 11.
+       */
+      calendarWeekNumbering?:
+        | sap.ui.core.date.CalendarWeekNumbering
+        | sap.ui.base.ManagedObject.PropertyBindingInfo
+        | `{${string}}`;
+
       /**
        * @SINCE 1.38.5
        *
@@ -42946,6 +42958,18 @@ declare namespace sap {
        * @returns Current accessibility state of the control.
        */
       getAccessibilityInfo(): object;
+      /**
+       * @SINCE 1.102.11
+       *
+       * 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 API has been introduced with version 1.108 and downported to
+       * this release with patch level 11.
+       *
+       * @returns Value of property `calendarWeekNumbering`
+       */
+      getCalendarWeekNumbering(): sap.ui.core.date.CalendarWeekNumbering;
       /**
        * The date as JavaScript Date object. This is independent from any formatter.
        *
@@ -43198,6 +43222,25 @@ declare namespace sap {
          */
         oSpecialDate: sap.ui.unified.DateTypeRange
       ): sap.ui.unified.DateTypeRange;
+      /**
+       * @SINCE 1.102.11
+       *
+       * 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 API has been introduced with version 1.108 and downported to
+       * this release with patch level 11.
+       *
+       * 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 the displayFormat of the DatePicker.
        *

package/types/sap.tnt.d.ts

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

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

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

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

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

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

@@ -264,7 +264,7 @@ interface JQuery<TElement = HTMLElement> extends Iterable<TElement> {
   ): jQuery;
 }
 
-// For Library Version: 1.102.10
+// For Library Version: 1.102.12
 
 declare module "sap/base/assert" {
   /**
@@ -966,6 +966,9 @@ declare module "sap/base/security/URLListValidator" {
      *
      * Note: Adding the first entry to the list of allowed entries will disallow all URLs but the ones matching
      * the newly added entry.
+     *
+     * **Note**: It is strongly recommended to set a path only in combination with an origin (never set a path
+     * alone). There's almost no case where checking only the path of a URL would allow to ensure its validity.
      */
     add(
       /**
@@ -1000,7 +1003,13 @@ declare module "sap/base/security/URLListValidator" {
     /**
      * Validates a URL. Check if it's not a script or other security issue.
      *
-     * Split URL into components and check for allowed characters according to RFC 3986:
+     * **Note**: It is strongly recommended to validate only absolute URLs. There's almost no case where checking
+     * only the path of a URL would allow to ensure its validity. For compatibility reasons, this API cannot
+     * automatically resolve URLs relative to `document.baseURI`, but callers should do so. In that case, and
+     * when the allow list is not empty, an entry for the origin of `document.baseURI` must be added to the
+     * allow list.
+     *
+     * Details: Splits the given URL into components and checks for allowed characters according to RFC 3986:
      *
      *
      * ```javascript
@@ -2273,6 +2282,50 @@ declare module "sap/ui/core/ComponentSupport" {
   export default ComponentSupport;
 }
 
+declare module "sap/ui/core/date/CalendarUtils" {
+  /**
+   * @SINCE 1.102.11
+   *
+   * Provides calendar-related utilities.
+   *
+   * Note: This API has been introduced with version 1.108 and downported to this release with patch level
+   * 11.
+   */
+  interface CalendarUtils {
+    /**
+     * @SINCE 1.102.11
+     *
+     * Resolves calendar week configuration.
+     *
+     * Returns an object with the following fields:
+     * 	 - `firstDayOfWeek`: specifies the first day of the week starting with `0` (which is Sunday)
+     * 	 - `minimalDaysInFirstWeek`: minimal days at the beginning of the year which define the first calendar
+     * 			week
+     *
+     * Note: This API has been introduced with version 1.108 and downported to this release with patch level
+     * 11.
+     *
+     * @returns The calendar week configuration, or `undefined for an invalid value of sap.ui.core.date.CalendarWeekNumbering`.
+     */
+    getWeekConfigurationValues(
+      /**
+       * The calendar week numbering; if omitted, `Default` is used.
+       */
+      sCalendarWeekNumbering?:
+        | sap.ui.core.date.CalendarWeekNumbering
+        | keyof typeof sap.ui.core.date.CalendarWeekNumbering,
+      /**
+       * The locale to use; if not provided, this falls back to the format locale from the Configuration; see
+       * {@link sap.ui.core.Configuration.FormatSettings#getFormatLocale}. Is only used when `sCalendarWeekNumbering`
+       * is set to `Default`.
+       */
+      oLocale?: sap.ui.core.Locale
+    ): Object | undefined;
+  }
+  const CalendarUtils: CalendarUtils;
+  export default CalendarUtils;
+}
+
 declare module "sap/ui/core/InvisibleRenderer" {
   /**
    * @SINCE 1.66.0
@@ -13060,6 +13113,11 @@ declare namespace sap {
              * Object which defines the format options
              */
             oFormatOptions?: {
+              /**
+               * @since 1.102.11 specifies the calendar week numbering. Note: This API has been introduced with version
+               * 1.108 and downported to this release with patch level 11.
+               */
+              calendarWeekNumbering?: sap.ui.core.date.CalendarWeekNumbering;
               /**
                * @since 1.34.0 contains pattern symbols (e.g. "yMMMd" or "Hms") which will be converted into the pattern
                * in the used locale, which matches the wanted symbols best. The symbols must be in canonical order, that
@@ -13138,6 +13196,11 @@ declare namespace sap {
              * Object which defines the format options
              */
             oFormatOptions?: {
+              /**
+               * @since 1.102.11 specifies the calendar week numbering. Note: This API has been introduced with version
+               * 1.108 and downported to this release with patch level 11.
+               */
+              calendarWeekNumbering?: sap.ui.core.date.CalendarWeekNumbering;
               /**
                * @since 1.34.0 contains pattern symbols (e.g. "yMMMd" or "Hms") which will be converted into the pattern
                * in the used locale, which matches the wanted symbols best. The symbols must be in canonical order, that
@@ -13220,6 +13283,11 @@ declare namespace sap {
              * An object which defines the format options
              */
             oFormatOptions?: {
+              /**
+               * @since 1.102.11 specifies the calendar week numbering. Note: This API has been introduced with version
+               * 1.108 and downported to this release with patch level 11.
+               */
+              calendarWeekNumbering?: sap.ui.core.date.CalendarWeekNumbering;
               /**
                * A string containing pattern symbols (e.g. "yMMMd" or "Hms") which will be converted into a pattern for
                * the used locale that matches the wanted symbols best. The symbols must be in canonical order, that is:
@@ -13299,6 +13367,11 @@ declare namespace sap {
              * Object which defines the format options
              */
             oFormatOptions?: {
+              /**
+               * @since 1.102.11 specifies the calendar week numbering. Note: This API has been introduced with version
+               * 1.108 and downported to this release with patch level 11.
+               */
+              calendarWeekNumbering?: sap.ui.core.date.CalendarWeekNumbering;
               /**
                * @since 1.34.0 contains pattern symbols (e.g. "yMMMd" or "Hms") which will be converted into the pattern
                * in the used locale, which matches the wanted symbols best. The symbols must be in canonical order, that
@@ -17951,6 +18024,44 @@ declare namespace sap {
         }
       }
 
+      namespace date {
+        /**
+         * @SINCE 1.102.11
+         *
+         * The `CalendarWeekNumbering` enum defines how to calculate calendar weeks. Each value defines:
+         * 	 - The first day of the week,
+         * 	 - the first week of the year.
+         *
+         * Note: This API has been introduced with version 1.108 and downported to this release with patch level
+         * 11.
+         */
+        enum CalendarWeekNumbering {
+          /**
+           * The default calendar week numbering:
+           *
+           * The framework determines the week numbering scheme; currently it is derived from the active format locale.
+           * Future versions of UI5 might select a different week numbering scheme.
+           */
+          Default = "Default",
+          /**
+           * Official calendar week numbering in most of Europe (ISO 8601 standard):
+           * 	Monday is first day of the week, the week containing January 4th is first week of the year.
+           */
+          ISO_8601 = "ISO_8601",
+          /**
+           * Official calendar week numbering in much of the Middle East (Middle Eastern calendar):
+           * 	Saturday is first day of the week, the week containing January 1st is first week of the year.
+           */
+          MiddleEastern = "MiddleEastern",
+          /**
+           * Official calendar week numbering in the United States, Canada, Brazil, Israel, Japan, and other countries
+           * (Western traditional calendar):
+           * 	Sunday is first day of the week, the week containing January 1st is first week of the year.
+           */
+          WesternTraditional = "WesternTraditional",
+        }
+      }
+
       namespace Element {
         /**
          * @SINCE 1.67
@@ -72470,6 +72581,10 @@ declare namespace sap {
 
     "sap/ui/core/CustomData": undefined;
 
+    "sap/ui/core/date/CalendarUtils": undefined;
+
+    "sap/ui/core/date/CalendarWeekNumbering": undefined;
+
     "sap/ui/core/date/UniversalDate": undefined;
 
     "sap/ui/core/date/UniversalDateUtils": undefined;

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

@@ -1,3 +1,3 @@
-// For Library Version: 1.102.10
+// For Library Version: 1.102.12
 
 declare namespace sap {}

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

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

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

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

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

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

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

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

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.102.10
+// For Library Version: 1.102.12
 
 declare module "sap/ui/rta/api/startAdaptation" {
   /**

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

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

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

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

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

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

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

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

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.102.10
+// For Library Version: 1.102.12
 
 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,18 @@ declare namespace sap {
             | sap.ui.base.ManagedObject.PropertyBindingInfo
             | `{${string}}`;
 
+          /**
+           * @SINCE 1.102.11
+           *
+           * 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. Note:
+           * This API has been introduced with version 1.108 and downported to this release with patch level 11.
+           */
+          calendarWeekNumbering?:
+            | sap.ui.core.date.CalendarWeekNumbering
+            | sap.ui.base.ManagedObject.PropertyBindingInfo
+            | `{${string}}`;
+
           /**
            * Date Ranges for selected dates of the DatePicker
            */
@@ -2305,6 +2318,18 @@ declare namespace sap {
            * ariaLabelledBy}.
            */
           getAriaLabelledBy(): sap.ui.core.ID[];
+          /**
+           * @SINCE 1.102.11
+           *
+           * 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. Note:
+           * This API has been introduced with version 1.108 and downported to this release with patch level 11.
+           *
+           * @returns Value of property `calendarWeekNumbering`
+           */
+          getCalendarWeekNumbering(): sap.ui.core.date.CalendarWeekNumbering;
           /**
            * Gets current value of property {@link #getDate date}.
            *
@@ -2327,8 +2352,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`.
            *
@@ -2614,6 +2640,25 @@ declare namespace sap {
              */
             vSpecialDate: int | string | sap.ui.unified.DateTypeRange
           ): sap.ui.unified.DateTypeRange;
+          /**
+           * @SINCE 1.102.11
+           *
+           * 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. Note:
+           * This API has been introduced with version 1.108 and downported to this release with patch level 11.
+           *
+           * 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}.
            *
@@ -2635,8 +2680,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.
            *
@@ -5155,8 +5201,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
@@ -5268,6 +5315,18 @@ declare namespace sap {
           | sap.ui.base.ManagedObject.PropertyBindingInfo
           | `{${string}}`;
 
+        /**
+         * @SINCE 1.102.11
+         *
+         * 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. Note:
+         * This API has been introduced with version 1.108 and downported to this release with patch level 11.
+         */
+        calendarWeekNumbering?:
+          | sap.ui.core.date.CalendarWeekNumbering
+          | sap.ui.base.ManagedObject.PropertyBindingInfo
+          | `{${string}}`;
+
         /**
          * Dates or date ranges for selected dates.
          *
@@ -7807,6 +7866,18 @@ declare namespace sap {
          * ariaLabelledBy}.
          */
         getAriaLabelledBy(): sap.ui.core.ID[];
+        /**
+         * @SINCE 1.102.11
+         *
+         * 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. Note:
+         * This API has been introduced with version 1.108 and downported to this release with patch level 11.
+         *
+         * @returns Value of property `calendarWeekNumbering`
+         */
+        getCalendarWeekNumbering(): sap.ui.core.date.CalendarWeekNumbering;
         /**
          * @SINCE 1.38.0
          *
@@ -7823,8 +7894,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`.
          *
@@ -8198,13 +8270,33 @@ declare namespace sap {
            */
           vSpecialDate: int | string | sap.ui.unified.DateTypeRange
         ): sap.ui.unified.DateTypeRange;
+        /**
+         * @SINCE 1.102.11
+         *
+         * 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. Note:
+         * This API has been introduced with version 1.108 and downported to this release with patch level 11.
+         *
+         * 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.
          *

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

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

package/types/sap.ui.webc.common.d.ts

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

package/types/sap.ui.webc.fiori.d.ts

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

package/types/sap.ui.webc.main.d.ts

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

package/types/sap.uxap.d.ts

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