@openui5/ts-types-esm 1.105.1 → 1.105.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openui5/ts-types-esm",
-  "version": "1.105.1",
+  "version": "1.105.3",
   "description": "OpenUI5 TypeScript Definitions - ES Modules",
   "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.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/tnt/library" {
   export interface IToolHeader {

package/types/sap.m.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/f/library" {
   export interface IShellBar {
@@ -15408,6 +15408,8 @@ declare module "sap/m/DatePicker" {
 
   import DateRange from "sap/ui/unified/DateRange";
 
+  import CalendarWeekNumbering from "sap/ui/core/date/CalendarWeekNumbering";
+
   import { ID } from "sap/ui/core/library";
 
   import ElementMetadata from "sap/ui/core/ElementMetadata";
@@ -15853,6 +15855,19 @@ declare module "sap/m/DatePicker" {
      * @returns Current accessibility state of the control.
      */
     getAccessibilityInfo(): object;
+    /**
+     * @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.
+     *
+     * @returns Value of property `calendarWeekNumbering`
+     */
+    getCalendarWeekNumbering():
+      | CalendarWeekNumbering
+      | keyof typeof CalendarWeekNumbering;
     /**
      * The date as JavaScript Date object. This is independent from any formatter.
      *
@@ -16105,6 +16120,26 @@ declare module "sap/m/DatePicker" {
        */
       oSpecialDate: DateTypeRange
     ): DateTypeRange;
+    /**
+     * @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.
+     *
+     * 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?:
+        | CalendarWeekNumbering
+        | keyof typeof CalendarWeekNumbering
+    ): this;
     /**
      * Sets the displayFormat of the DatePicker.
      *
@@ -16378,6 +16413,17 @@ declare module "sap/m/DatePicker" {
      */
     hideInput?: boolean | 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.
+     */
+    calendarWeekNumbering?:
+      | (CalendarWeekNumbering | keyof typeof CalendarWeekNumbering)
+      | PropertyBindingInfo
+      | `{${string}}`;
+
     /**
      * @SINCE 1.38.5
      *

package/types/sap.tnt.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/tnt/library" {
   /**

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/ui/codeeditor/library" {}
 

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/ui/commons/library" {
   import { ColorPickerMode as ColorPickerMode1 } from "sap/ui/unified/library";

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

@@ -264,7 +264,7 @@ interface JQuery<TElement = HTMLElement> extends Iterable<TElement> {
   ): jQuery;
 }
 
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 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
@@ -15826,6 +15835,45 @@ declare module "sap/ui/core/CustomData" {
   }
 }
 
+declare module "sap/ui/core/date/CalendarWeekNumbering" {
+  /**
+   * @SINCE 1.105.2
+   *
+   * 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
+   * 2.
+   */
+  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",
+  }
+  export default CalendarWeekNumbering;
+}
+
 declare module "sap/ui/core/DeclarativeSupport" {
   import HTMLView from "sap/ui/core/mvc/HTMLView";
 
@@ -19352,6 +19400,8 @@ declare module "sap/ui/core/ExtensionPoint" {
 }
 
 declare module "sap/ui/core/format/DateFormat" {
+  import CalendarWeekNumbering from "sap/ui/core/date/CalendarWeekNumbering";
+
   import CalendarType from "sap/ui/core/CalendarType";
 
   import Locale from "sap/ui/core/Locale";
@@ -19380,6 +19430,14 @@ declare module "sap/ui/core/format/DateFormat" {
        * Object which defines the format options
        */
       oFormatOptions?: {
+        /**
+         * @since 1.105.2 specifies the calendar week numbering. If specified, this overwrites `oFormatOptions.firstDayOfWeek`
+         * and `oFormatOptions.minimalDaysInFirstWeek`. Note: This API has been introduced with version 1.108 and
+         * downported to this release with patch level 2.
+         */
+        calendarWeekNumbering?:
+          | CalendarWeekNumbering
+          | keyof typeof CalendarWeekNumbering;
         /**
          * @since 1.105.0 specifies the first day of the week starting with `0` (which is Sunday); if not defined,
          * the value taken from the locale is used
@@ -19468,6 +19526,14 @@ declare module "sap/ui/core/format/DateFormat" {
        * Object which defines the format options
        */
       oFormatOptions?: {
+        /**
+         * @since 1.105.2 specifies the calendar week numbering. If specified, this overwrites `oFormatOptions.firstDayOfWeek`
+         * and `oFormatOptions.minimalDaysInFirstWeek`. Note: This API has been introduced with version 1.108 and
+         * downported to this release with patch level 2.
+         */
+        calendarWeekNumbering?:
+          | CalendarWeekNumbering
+          | keyof typeof CalendarWeekNumbering;
         /**
          * @since 1.105.0 specifies the first day of the week starting with `0` (which is Sunday); if not defined,
          * the value taken from the locale is used
@@ -19560,6 +19626,14 @@ declare module "sap/ui/core/format/DateFormat" {
        * An object which defines the format options
        */
       oFormatOptions?: {
+        /**
+         * @since 1.105.2 specifies the calendar week numbering. If specified, this overwrites `oFormatOptions.firstDayOfWeek`
+         * and `oFormatOptions.minimalDaysInFirstWeek`. Note: This API has been introduced with version 1.108 and
+         * downported to this release with patch level 2.
+         */
+        calendarWeekNumbering?:
+          | CalendarWeekNumbering
+          | keyof typeof CalendarWeekNumbering;
         /**
          * @since 1.105.0 specifies the first day of the week starting with `0` (which is Sunday); if not defined,
          * the value taken from the locale is used
@@ -19649,6 +19723,14 @@ declare module "sap/ui/core/format/DateFormat" {
        * Object which defines the format options
        */
       oFormatOptions?: {
+        /**
+         * @since 1.105.2 specifies the calendar week numbering. If specified, this overwrites `oFormatOptions.firstDayOfWeek`
+         * and `oFormatOptions.minimalDaysInFirstWeek`. Note: This API has been introduced with version 1.108 and
+         * downported to this release with patch level 2.
+         */
+        calendarWeekNumbering?:
+          | CalendarWeekNumbering
+          | keyof typeof CalendarWeekNumbering;
         /**
          * @since 1.105.0 specifies the first day of the week starting with `0` (which is Sunday); if not defined,
          * the value taken from the locale is used
@@ -75616,6 +75698,8 @@ declare namespace sap {
 
     "sap/ui/core/CustomData": 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.105.1
+// For Library Version: 1.105.3
 
 declare namespace sap {}

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/ui/fl/library" {}
 

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/ui/integration/library" {
   import { URI } from "sap/ui/core/library";

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/ui/layout/library" {
   import Control from "sap/ui/core/Control";

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/ui/mdc/filterbar/vh/FilterContainer" {
   import Metadata from "sap/ui/base/Metadata";

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/ui/rta/api/startAdaptation" {
   import Control from "sap/ui/core/Control";

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/ui/suite/library" {
   /**

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/ui/support/library" {
   /**

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/ui/table/library" {
   import TreeAutoExpandMode1 from "sap/ui/model/TreeAutoExpandMode";

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/ui/testrecorder/library" {}
 

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/ui/unified/library" {
   /**
@@ -331,6 +331,8 @@ declare module "sap/ui/unified/Calendar" {
 
   import Event from "sap/ui/base/Event";
 
+  import CalendarWeekNumbering from "sap/ui/core/date/CalendarWeekNumbering";
+
   import ElementMetadata from "sap/ui/core/ElementMetadata";
 
   import CalendarType from "sap/ui/core/CalendarType";
@@ -851,6 +853,19 @@ declare module "sap/ui/unified/Calendar" {
      * ariaLabelledBy}.
      */
     getAriaLabelledBy(): 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():
+      | CalendarWeekNumbering
+      | keyof typeof CalendarWeekNumbering;
     /**
      * @SINCE 1.38.0
      *
@@ -867,8 +882,9 @@ declare module "sap/ui/unified/Calendar" {
      *
      * 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`.
      *
@@ -1242,13 +1258,34 @@ declare module "sap/ui/unified/Calendar" {
        */
       vSpecialDate: int | string | DateTypeRange
     ): 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?:
+        | CalendarWeekNumbering
+        | keyof typeof 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.
      *
@@ -1492,8 +1529,9 @@ declare module "sap/ui/unified/Calendar" {
     /**
      * @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 | PropertyBindingInfo | `{${string}}`;
 
@@ -1584,6 +1622,17 @@ declare module "sap/ui/unified/Calendar" {
      */
     showCurrentDateButton?: boolean | 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?:
+      | (CalendarWeekNumbering | keyof typeof CalendarWeekNumbering)
+      | PropertyBindingInfo
+      | `{${string}}`;
+
     /**
      * Dates or date ranges for selected dates.
      *
@@ -2979,6 +3028,8 @@ declare module "sap/ui/unified/calendar/Month" {
 
   import Event from "sap/ui/base/Event";
 
+  import CalendarWeekNumbering from "sap/ui/core/date/CalendarWeekNumbering";
+
   import ElementMetadata from "sap/ui/core/ElementMetadata";
 
   import CalendarType from "sap/ui/core/CalendarType";
@@ -3419,6 +3470,19 @@ declare module "sap/ui/unified/calendar/Month" {
      * ariaLabelledBy}.
      */
     getAriaLabelledBy(): 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():
+      | CalendarWeekNumbering
+      | keyof typeof CalendarWeekNumbering;
     /**
      * Gets current value of property {@link #getDate date}.
      *
@@ -3441,8 +3505,9 @@ declare module "sap/ui/unified/calendar/Month" {
      *
      * 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`.
      *
@@ -3728,6 +3793,26 @@ declare module "sap/ui/unified/calendar/Month" {
        */
       vSpecialDate: int | string | DateTypeRange
     ): 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?:
+        | CalendarWeekNumbering
+        | keyof typeof CalendarWeekNumbering
+    ): this;
     /**
      * Sets a new value for property {@link #getDate date}.
      *
@@ -3749,8 +3834,9 @@ declare module "sap/ui/unified/calendar/Month" {
      *
      * 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.
      *
@@ -3949,8 +4035,9 @@ declare module "sap/ui/unified/calendar/Month" {
     /**
      * @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 | PropertyBindingInfo | `{${string}}`;
 
@@ -4001,6 +4088,17 @@ declare module "sap/ui/unified/calendar/Month" {
      */
     showWeekNumbers?: boolean | 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?:
+      | (CalendarWeekNumbering | keyof typeof CalendarWeekNumbering)
+      | PropertyBindingInfo
+      | `{${string}}`;
+
     /**
      * Date Ranges for selected dates of the DatePicker
      */

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/ui/ux3/library" {
   /**

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/ui/webc/common/library" {}
 

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/ui/webc/fiori/library" {
   /**

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

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/ui/webc/main/library" {
   /**

package/types/sap.uxap.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.105.1
+// For Library Version: 1.105.3
 
 declare module "sap/uxap/library" {
   /**