@openui5/sap.ui.core 1.115.1 → 1.116.0

package/src/sap/base/i18n/ResourceBundle.js

@@ -6,11 +6,12 @@
 sap.ui.define([
 		'sap/base/assert',
 		'sap/base/Log',
+		'sap/base/i18n/Localization',
 		'sap/base/strings/formatMessage',
 		'sap/base/util/Properties',
 		'sap/base/util/merge'
 	],
-	function(assert, Log, formatMessage, Properties, merge) {
+	function(assert, Log, Localization, formatMessage, Properties, merge) {
 	"use strict";
 
 	/* global Promise */
@@ -159,28 +160,12 @@ sap.ui.define([
 	function defaultLocale(sFallbackLocale) {
 		var sLocale;
 		// use the current session locale, if available
-		if (window.sap && window.sap.ui && sap.ui.getCore) {
-			sLocale = sap.ui.getCore().getConfiguration().getLanguage();
-			sLocale = normalize(sLocale);
-		}
+		sLocale = Localization.getLanguage();
+		sLocale = normalize(sLocale);
 		// last fallback is fallbackLocale if no or no valid locale is given
 		return sLocale || sFallbackLocale;
 	}
 
-	/**
-	 * Returns the supported locales from the configuration.
-	 * @returns {string[]} supported locales from the configuration. Otherwise, an empty array is returned.
-	 * @private
-	 */
-	function defaultSupportedLocales() {
-		if (window.sap && window.sap.ui && sap.ui.getCore) {
-			return sap.ui.getCore().getConfiguration().getSupportedLanguages();
-		}
-		return [];
-	}
-
-
-
 	/**
 	 * Helper to normalize the given locale (java.util.Locale format) to the BCP-47 syntax.
 	 *
@@ -299,7 +284,7 @@ sap.ui.define([
 		this._aFallbackLocales = calculateFallbackChain(
 			this.sLocale,
 			// bundle specific supported locales will be favored over configuration ones
-			aSupportedLocales || defaultSupportedLocales(),
+			aSupportedLocales || Localization.getSupportedLanguages(),
 			sFallbackLocale,
 			" of the bundle '" + this.oUrlInfo.url + "'",
 			bSkipFallbackLocaleAndRaw

package/src/sap/base/i18n/date/CalendarType.js

@@ -0,0 +1,54 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+// Provides type sap.base.i18n.date.CalendarType.
+sap.ui.define([], function() {
+	"use strict";
+
+	/**
+	 * The types of <code>Calendar</code>.
+	 *
+	 * @enum {string}
+	 * @alias module:sap/base/i18n/date/CalendarType
+	 * @private
+	 * @ui5-restricted sap.ui.core sap/base/i18n
+	 */
+	var CalendarType = {
+
+		/**
+		 * The Gregorian calendar
+		 * @public
+		 */
+		Gregorian: "Gregorian",
+
+		/**
+		 * The Islamic calendar
+		 * @public
+		 */
+		Islamic: "Islamic",
+
+		/**
+		 * The Japanese emperor calendar
+		 * @public
+		 */
+		Japanese: "Japanese",
+
+		/**
+		 * The Persian Jalali calendar
+		 * @public
+		 */
+		Persian: "Persian",
+
+		/**
+		 * The Thai buddhist calendar
+		 * @public
+		 */
+		Buddhist: "Buddhist"
+	};
+
+	return CalendarType;
+
+});

package/src/sap/base/i18n/date/CalendarWeekNumbering.js

@@ -0,0 +1,105 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+
+// Provides type sap.base.i18n.date.CalendarWeekNumbering.
+sap.ui.define([], function() {
+	"use strict";
+
+	/**
+	 * The <code>CalendarWeekNumbering</code> enum defines how to calculate calendar weeks. Each
+	 * value defines:
+	 * <ul>
+	 * <li>The first day of the week,</li>
+	 * <li>the first week of the year.</li>
+	 * </ul>
+	 *
+	 * @enum {string}
+	 * @private
+	 * @ui5-restricted sap.ui.core sap/base/i18n
+	 * @alias module:sap/base/i18n/date/CalendarWeekNumbering
+	 */
+	var 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.
+		 *
+		 * @public
+		 */
+		Default : "Default",
+
+		/**
+		 * Official calendar week numbering in most of Europe (ISO 8601 standard):
+		 * <ul>
+		 * <li>Monday is first day of the week,
+		 * <li>the week containing January 4th is first week of the year.
+		 * </ul>
+		 *
+		 * @public
+		 */
+		ISO_8601 : "ISO_8601",
+
+		/**
+		 * Official calendar week numbering in much of the Middle East (Middle Eastern calendar):
+		 * <ul>
+		 * <li>Saturday is first day of the week,
+		 * <li>the week containing January 1st is first week of the year.
+		 * </ul>
+		 *
+		 * @public
+		 */
+		MiddleEastern : "MiddleEastern",
+
+		/**
+		 * Official calendar week numbering in the United States, Canada, Brazil, Israel, Japan, and
+		 * other countries (Western traditional calendar):
+		 * <ul>
+		 * <li>Sunday is first day of the week,
+		 * <li>the week containing January 1st is first week of the year.
+		 * </ul>
+		 *
+		 * @public
+		 */
+		WesternTraditional : "WesternTraditional"
+	};
+
+	/**
+	 * Returns an object containing the week configuration values for the given calendar week
+	 * numbering algorithm.
+	 *
+	 * @param {module:sap/base/i18n/date/CalendarWeekNumbering} [sCalendarWeekNumbering=Default]
+	 *   The calendar week numbering algorithm
+	 * @returns {{firstDayOfWeek: 0|1|2|3|4|5|6, minimalDaysInFirstWeek: 1|2|3|4|5|6|7}|undefined}
+	 *   The week configuration values or <code>undefined</code> if the given calendar week
+	 *   numbering algorithm is "Default"
+	 *
+	 * @function
+	 * @name module:sap/base/i18n/date/CalendarWeekNumbering.getWeekConfigurationValues
+	 * @private
+	 */
+	Object.defineProperty(CalendarWeekNumbering, "getWeekConfigurationValues", {
+		// configurable : false,
+		// enumerable : false,
+		value : function (sCalendarWeekNumbering) {
+			switch (sCalendarWeekNumbering) {
+				case CalendarWeekNumbering.ISO_8601 :
+					return {firstDayOfWeek : 1, minimalDaysInFirstWeek : 4};
+				case CalendarWeekNumbering.MiddleEastern :
+					return {firstDayOfWeek : 6, minimalDaysInFirstWeek : 1};
+				case CalendarWeekNumbering.WesternTraditional :
+					return {firstDayOfWeek : 0, minimalDaysInFirstWeek : 1};
+				default:
+					return undefined;
+			}
+		}
+		// writable : false
+	});
+
+	return CalendarWeekNumbering;
+});

package/src/sap/base/i18n/date/TimezoneUtils.js

@@ -0,0 +1,287 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+sap.ui.define([], function() {
+	"use strict";
+
+	/**
+	 * Static collection of utility functions to handle time zone related conversions
+	 *
+	 * @author SAP SE
+	 * @version 1.116.0
+	 * @namespace
+	 * @alias module:sap/base/i18n/date/TimezoneUtils
+	 * @private
+	 * @ui5-restricted sap.ui.core.Configuration, sap/base/i18n/format/DateFormat
+	 */
+	var TimezoneUtils = {};
+
+	/**
+	 * Cache for the (browser's) local IANA timezone ID
+	 *
+	 * @type {string}
+	 */
+	var sLocalTimezone = "";
+
+	/**
+	 * Cache for valid time zones provided by <code>Intl.supportedValuesOf("timeZone")</code>
+	 *
+	 * @type {Array}
+	 */
+	var aSupportedTimezoneIDs;
+
+	/**
+	 * Cache for Intl.DateTimeFormat instances
+	 */
+	var oIntlDateTimeFormatCache = {
+		_oCache: new Map(),
+		/**
+		 * When cache limit is reached, it gets cleared
+		 */
+		_iCacheLimit: 10,
+
+		/**
+		 * Creates or gets an instance of Intl.DateTimeFormat.
+		 *
+		 * @param {string} sTimezone IANA timezone ID
+		 * @returns {Intl.DateTimeFormat} Intl.DateTimeFormat instance
+		 */
+		get: function (sTimezone) {
+			var cacheEntry = this._oCache.get(sTimezone);
+			if (cacheEntry) {
+				return cacheEntry;
+			}
+
+			var oOptions = {
+				hourCycle: "h23",
+				hour: "2-digit",
+				minute: "2-digit",
+				second: "2-digit",
+				fractionalSecondDigits: 3,
+				day: "2-digit",
+				month: "2-digit",
+				year: "numeric",
+				timeZone: sTimezone,
+				timeZoneName: 'short',
+				era: 'narrow',
+				weekday: "short"
+			};
+			var oInstance = new Intl.DateTimeFormat("en-US", oOptions);
+
+			// only store a limited number of entries in the cache
+			if (this._oCache.size === this._iCacheLimit) {
+				this._oCache = new Map();
+			}
+			this._oCache.set(sTimezone, oInstance);
+			return oInstance;
+		}
+	};
+
+	/**
+	 * Uses the <code>Intl.supportedValuesOf('timeZone')</code> and <code>Intl.DateTimeFormat</code>
+	 * API to check if the browser can handle the given IANA timezone ID.
+	 * <code>Intl.supportedValuesOf('timeZone')</code> offers direct access to the list of supported
+	 * time zones. It is not yet supported by all browsers but if it is supported and the given time
+	 * zone is in the list it is faster than probing.
+	 *
+	 * <code>Intl.supportedValuesOf('timeZone')</code> does not return all IANA timezone IDs which
+	 * the <code>Intl.DateTimeFormat</code> can handle, e.g. "Japan", "Etc/UTC".
+	 *
+	 * @param {string} sTimezone The IANA timezone ID which is checked, e.g <code>"Europe/Berlin"</code>
+	 * @returns {boolean} Whether the time zone is a valid IANA timezone ID
+	 * @private
+	 * @ui5-restricted sap.ui.core.Configuration, sap.ui.core.format.DateFormat
+	 */
+	TimezoneUtils.isValidTimezone = function(sTimezone) {
+		if (!sTimezone) {
+			return false;
+		}
+
+		if (Intl.supportedValuesOf) {
+			try {
+				aSupportedTimezoneIDs = aSupportedTimezoneIDs || Intl.supportedValuesOf('timeZone');
+				if (aSupportedTimezoneIDs.includes(sTimezone)) {
+					return true;
+				}
+				// although not contained in the supportedValues it still can be valid, therefore continue
+			} catch (oError) {
+				// ignore error
+				aSupportedTimezoneIDs = [];
+			}
+		}
+
+		try {
+			oIntlDateTimeFormatCache.get(sTimezone);
+			return true;
+		} catch (oError) {
+			return false;
+		}
+	};
+
+	/**
+	 * Converts a date to a specific time zone.
+	 * The resulting date reflects the given time zone such that the "UTC" Date methods
+	 * can be used, e.g. Date#getUTCHours() to display the hours in the given time zone.
+	 *
+	 * @example
+	 * var oDate = new Date("2021-10-13T15:22:33Z"); // UTC
+	 * // time zone difference UTC-4 (DST)
+	 * TimezoneUtils.convertToTimezone(oDate, "America/New_York");
+	 * // result is:
+	 * // 2021-10-13 11:22:33 in America/New_York
+	 * // same as new Date("2021-10-13T11:22:33Z"); // UTC
+	 *
+	 * @param {Date} oDate The date which should be converted.
+	 * @param {string} sTargetTimezone The target IANA timezone ID, e.g <code>"Europe/Berlin"</code>
+	 * @returns {Date} The new date in the target time zone.
+	 * @private
+	 * @ui5-restricted sap.ui.core.format.DateFormat, sap.ui.unified, sap.m
+	 */
+	TimezoneUtils.convertToTimezone = function(oDate, sTargetTimezone) {
+		var oFormatParts = this._getParts(oDate, sTargetTimezone);
+		return TimezoneUtils._getDateFromParts(oFormatParts);
+	};
+
+	/**
+	 * Uses the <code>Intl.DateTimeFormat</code> API to convert a date to a specific time zone.
+	 *
+	 * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Intl/DateTimeFormat/formatToParts
+	 * @param {Date} oDate The date which should be converted.
+	 * @param {string} sTargetTimezone The target IANA timezone ID, e.g <code>"Europe/Berlin"</code>
+	 * @returns {{
+	 *     day: string,
+	 *     era: string,
+	 *     fractionalSecond: string,
+	 *     hour: string,
+	 *     minute: string,
+	 *     month: string,
+	 *     second: string,
+	 *     timeZoneName: string,
+	 *     weekday: string,
+	 *     year: string
+	 * }} An object containing the date and time fields considering the target time zone.
+	 * @private
+	 */
+	TimezoneUtils._getParts = function(oDate, sTargetTimezone) {
+		var sKey, oPart,
+			oDateParts = Object.create(null),
+			oIntlDate = oIntlDateTimeFormatCache.get(sTargetTimezone),
+			// clone the date object before passing it to the Intl API, to ensure that no
+			// UniversalDate gets passed to it;
+			// no need to use UI5Date.getInstance as only the UTC timestamp is used
+			oParts = oIntlDate.formatToParts(new Date(oDate.getTime()));
+
+		for (sKey in oParts) {
+			oPart = oParts[sKey];
+			if (oPart.type !== "literal") {
+				oDateParts[oPart.type] = oPart.value;
+			}
+		}
+		return oDateParts;
+	};
+
+	/**
+	 * Creates a Date from the provided date parts.
+	 *
+	 * @param {object} oParts Separated date and time fields as object, see {@link #_getParts}.
+	 * @returns {Date} Returns the date object created from the provided parts.
+	 * @private
+	 */
+	TimezoneUtils._getDateFromParts = function(oParts) {
+		// no need to use UI5Date.getInstance as only the UTC timestamp is used
+		var oDate = new Date(0),
+			iUTCYear = parseInt(oParts.year);
+
+		if (oParts.era === "B") {
+			// The JS Date uses astronomical year numbering which supports year zero and negative
+			// year numbers.
+			// The Intl.DateTimeFormat API uses eras (no year zero and no negative year numbers).
+			// years around zero overview:
+			// | Astronomical | In Era
+			// |            2 | 2 Anno Domini (era: "A")
+			// |            1 | 1 Anno Domini (era: "A")
+			// |            0 | 1 Before Christ (era: "B")
+			// |           -1 | 2 Before Christ (era: "B")
+			// |           -2 | 3 Before Christ (era: "B")
+			// For the conversion to the JS Date the parts returned by the Intl.DateTimeFormat API
+			// need to be adapted.
+			iUTCYear = (iUTCYear * -1) + 1;
+		}
+
+		// Date.UTC cannot be used here to be able to support dates before the UNIX epoch
+		oDate.setUTCFullYear(iUTCYear,
+			parseInt(oParts.month) - 1,
+			parseInt(oParts.day));
+		oDate.setUTCHours(
+			parseInt(oParts.hour),
+			parseInt(oParts.minute),
+			parseInt(oParts.second),
+			parseInt(oParts.fractionalSecond || 0)); // some older browsers don't support fractionalSecond, e.g. Safari < 14.1 */
+
+		return oDate;
+	};
+
+	/**
+	 * Gets the offset to UTC in seconds for a given date in the time zone specified.
+	 *
+	 * For non-unique points in time, the daylight saving time takes precedence over the standard
+	 * time shortly after the switch back (e.g. clock gets set back 1 hour, duplicate hour).
+	 *
+	 * @example
+	 * var oDate = new Date("2021-10-13T13:22:33Z");
+	 * TimezoneUtils.calculateOffset(oDate, "America/New_York");
+	 * // => +14400 seconds (4 * 60 * 60 seconds)
+	 *
+	 * TimezoneUtils.calculateOffset(oDate, "Europe/Berlin");
+	 * // => -7200 seconds (-2 * 60 * 60 seconds)
+	 *
+	 * // daylight saving time (2018 Sun, 25 Mar, 02:00	CET → CEST	+1 hour (DST start)	UTC+2h)
+	 * // the given date is taken as it is in the time zone
+	 * TimezoneUtils.calculateOffset(new Date("2018-03-25T00:00:00Z"), "Europe/Berlin");
+	 * // => -3600 seconds (-1 * 60 * 60 seconds), interpreted as: 2018-03-25 00:00:00 (CET)
+	 *
+	 * TimezoneUtils.calculateOffset(new Date("2018-03-25T03:00:00Z"), "Europe/Berlin");
+	 * // => -7200 seconds (-2 * 60 * 60 seconds)
+	 *
+	 * var oHistoricalDate = new Date("1800-10-13T13:22:33Z");
+	 * TimezoneUtils.calculateOffset(oHistoricalDate, "Europe/Berlin");
+	 * // => -3208 seconds (-3208 seconds)
+	 *
+	 * @param {Date} oDate The date in the time zone used to calculate the offset to UTC.
+	 * @param {string} sTimezoneSource The source IANA timezone ID, e.g <code>"Europe/Berlin"</code>
+	 * @returns {number} The difference to UTC between the date in the time zone.
+	 * @private
+	 * @ui5-restricted sap.ui.core.format.DateFormat
+	 */
+	TimezoneUtils.calculateOffset = function(oDate, sTimezoneSource) {
+		var oFirstGuess = this.convertToTimezone(oDate, sTimezoneSource),
+			iInitialOffset = oDate.getTime() - oFirstGuess.getTime(),
+			// to get the correct summer/wintertime (daylight saving time) handling use the source
+			// date (apply the diff);
+			// no need to use UI5Date.getInstance as only the UTC timestamp is used
+			oDateSource = new Date(oDate.getTime() + iInitialOffset),
+			oDateTarget = this.convertToTimezone(oDateSource, sTimezoneSource);
+
+		return (oDateSource.getTime() - oDateTarget.getTime()) / 1000;
+	};
+
+	/**
+	 * Retrieves the browser's local IANA timezone ID.
+	 *
+	 * @returns {string} The local IANA timezone ID of the browser, e.g <code>"Europe/Berlin"</code>
+	 * @private
+	 * @ui5-restricted sap.ui.core.Configuration,sap.m.DateTimeField
+	 */
+	TimezoneUtils.getLocalTimezone = function() {
+		if (sLocalTimezone) {
+			return sLocalTimezone;
+		}
+		sLocalTimezone = new Intl.DateTimeFormat().resolvedOptions().timeZone;
+		return sLocalTimezone;
+	};
+
+
+	return TimezoneUtils;
+});

package/src/sap/base/util/restricted/_CancelablePromise.js

@@ -26,7 +26,7 @@
  * @alias module:sap/base/util/restricted/_CancelablePromise
  * @author SAP SE
  * @since 1.79
- * @version 1.115.1
+ * @version 1.116.0
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_castArray.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_castArray
  * @author SAP SE
  * @since 1.71
- * @version 1.115.1
+ * @version 1.116.0
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_compact.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_compact
  * @author SAP SE
  * @since 1.80
- * @version 1.115.1
+ * @version 1.116.0
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_curry.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_curry
  * @author SAP SE
  * @since 1.71
- * @version 1.115.1
+ * @version 1.116.0
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_debounce.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_debounce
  * @author SAP SE
  * @since 1.71
- * @version 1.115.1
+ * @version 1.116.0
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_difference.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_difference
  * @author SAP SE
  * @since 1.80
- * @version 1.115.1
+ * @version 1.116.0
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_differenceBy.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_differenceBy
  * @author SAP SE
  * @since 1.80
- * @version 1.115.1
+ * @version 1.116.0
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_differenceWith.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_differenceWith
  * @author SAP SE
  * @since 1.80
- * @version 1.115.1
+ * @version 1.116.0
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_flatMap.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_flatMap
  * @author SAP SE
  * @since 1.80
- * @version 1.115.1
+ * @version 1.116.0
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_flatMapDeep.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_flatMapDeep
  * @author SAP SE
  * @since 1.80
- * @version 1.115.1
+ * @version 1.116.0
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_flatMapDepth.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_flatMapDepth
  * @author SAP SE
  * @since 1.80
- * @version 1.115.1
+ * @version 1.116.0
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_flatten.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_flatten
  * @author SAP SE
  * @since 1.80
- * @version 1.115.1
+ * @version 1.116.0
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_flattenDeep.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_flattenDeep
  * @author SAP SE
  * @since 1.80
- * @version 1.115.1
+ * @version 1.116.0
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_flattenDepth.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_flattenDepth
  * @author SAP SE
  * @since 1.80
- * @version 1.115.1
+ * @version 1.116.0
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_intersection.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_intersection
  * @author SAP SE
  * @since 1.71
- * @version 1.115.1
+ * @version 1.116.0
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_intersectionBy.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_intersectionBy
  * @author SAP SE
  * @since 1.71
- * @version 1.115.1
+ * @version 1.116.0
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_intersectionWith.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_intersectionWith
  * @author SAP SE
  * @since 1.71
- * @version 1.115.1
+ * @version 1.116.0
  * @private
  * @ui5-restricted
 */

package/src/sap/base/util/restricted/_isEqual.js

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_isEqual
  * @author SAP SE
  * @since 1.80
- * @version 1.115.1
+ * @version 1.116.0
  * @private
  * @ui5-restricted
 */