@openui5/sap.ui.core 1.108.0 → 1.109.0

package/THIRDPARTY.txt

@@ -478,7 +478,7 @@ License: Apache-2.0
 License Text: https://github.com/SAP/openui5/blob/master/LICENSES/Apache-2.0.txt
 Contained in: lib/jsdoc/ui5/plugin.js
 
-Component: SAP Theming Base Content, version: 11.1.40
+Component: SAP Theming Base Content, version: 11.1.44
 Copyright: SAP SE or an SAP affiliate company and Theming Base Content contributors
 License: Apache-2.0
 License Text: https://github.com/SAP/openui5/blob/master/LICENSES/Apache-2.0.txt

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openui5/sap.ui.core",
-  "version": "1.108.0",
+  "version": "1.109.0",
   "description": "OpenUI5 Core Library sap.ui.core",
   "author": "SAP SE (https://www.sap.com)",
   "license": "Apache-2.0",

package/src/jquery.sap.global.js

@@ -202,7 +202,7 @@ sap.ui.define([
 	/**
 	 * Root Namespace for the jQuery plug-in provided by SAP SE.
 	 *
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 * @namespace
 	 * @public
 	 * @static

package/src/jquery.sap.properties.js

@@ -67,7 +67,7 @@ sap.ui.define(['jquery.sap.global', 'sap/base/util/Properties'],
 	 * {@link #setProperty} to store or change a value for a key and {@link #getKeys}
 	 * can be used to retrieve an array of all keys that are currently stored in the collection.
 	 *
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 * @since 0.9.0
 	 * @name jQuery.sap.util.Properties
 	 * @public

package/src/jquery.sap.resources.js

@@ -99,7 +99,7 @@ sap.ui.define([
 	 * Exception: Fallback for "zh_HK" is "zh_TW" before zh.
 	 *
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 * @since 0.9.0
 	 * @name jQuery.sap.util.ResourceBundle
 	 * @public

package/src/jquery.sap.script.js

@@ -267,7 +267,7 @@ sap.ui.define([
 	 * Use {@link jQuery.sap.getUriParameters} to create an instance of jQuery.sap.util.UriParameters.
 	 *
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 * @since 0.9.0
 	 * @name jQuery.sap.util.UriParameters
 	 * @public

package/src/jquery.sap.storage.js

@@ -37,7 +37,7 @@ sap.ui.define([
 	 * @param {string} [sIdPrefix] Prefix used for the Ids. If not set a default prefix is used.
 	 * @returns {jQuery.sap.storage.Storage}
 	 *
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 * @since 0.11.0
 	 * @namespace
 	 * @public
@@ -97,7 +97,7 @@ sap.ui.define([
 	 * should be deleted the method {@link #removeAll} should be used.
 	 *
 	 * @author SAP SE
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 * @since 0.11.0
 	 * @public
 	 * @name jQuery.sap.storage.Storage
@@ -201,7 +201,7 @@ sap.ui.define([
 	 * Enumeration of the storage types supported by {@link jQuery.sap.storage.Storage}
 	 * @enum {string}
 	 * @public
-	 * @version 1.108.0
+	 * @version 1.109.0
 	 * @since 0.11.0
 	 */
 	jQuery.sap.storage.Type = Storage.Type;

package/src/sap/base/Log.js

@@ -97,12 +97,10 @@ sap.ui.define(["sap/base/util/now"], function(now) {
 		ALL : (5 + 1)
 	};
 
-	var sDefaultComponent,
-
 	/**
 	 * The array that holds the log entries that have been recorded so far
 	 */
-	aLog = [],
+	var aLog = [],
 
 	/**
 	 * Maximum log level to be recorded (per component).
@@ -201,107 +199,144 @@ sap.ui.define(["sap/base/util/now"], function(now) {
 
 	/**
 	 * Creates a new fatal-level entry in the log with the given message, details and calling component.
-	 * @param {string} sMessage Message text to display
-	 * @param {string} [sDetails=''] Details about the message, might be omitted
-	 * @param {string} [sComponent=''] Name of the component that produced the log entry
-	 * @param {function} [fnSupportInfo] Callback that returns an additional support object to be logged in support mode.
-	 *   This function is only called if support info mode is turned on with <code>logSupportInfo(true)</code>.
-	 *   To avoid negative effects regarding execution times and memory consumption, the returned object should be a simple
-	 *   immutable JSON object with mostly static and stable content.
+	 *
+	 * @param {string} sMessage
+	 *   Message text to display
+	 * @param {string|Error} [vDetails='']
+	 *   Optional details about the message, might be omitted. Can be an Error object which will be
+	 *   logged together with its stacktrace.
+	 * @param {string} [sComponent='']
+	 *   Name of the component that produced the log entry
+	 * @param {function} [fnSupportInfo]
+	 *   Callback that returns an additional support object to be logged in support mode.
+	 *   This function is only called if support info mode is turned on with
+	 *   <code>logSupportInfo(true)</code>. To avoid negative effects regarding execution times and
+	 *   memory consumption, the returned object should be a simple immutable JSON object with mostly
+	 *   static and stable content.
 	 * @public
 	 * @SecSink {0 1 2|SECRET} Could expose secret data in logs
 	 */
-	Log.fatal = function(sMessage, sDetails, sComponent, fnSupportInfo) {
-		log(Log.Level.FATAL, sMessage, sDetails, sComponent, fnSupportInfo);
+	Log.fatal = function(sMessage, vDetails, sComponent, fnSupportInfo) {
+		log(Log.Level.FATAL, sMessage, vDetails, sComponent, fnSupportInfo);
 	};
 
 	/**
 	 * Creates a new error-level entry in the log with the given message, details and calling component.
 	 *
-	 * @param {string} sMessage Message text to display
-	 * @param {string} [sDetails=''] Details about the message, might be omitted
-	 * @param {string} [sComponent=''] Name of the component that produced the log entry
-	 * @param {function} [fnSupportInfo] Callback that returns an additional support object to be logged in support mode.
-	 *   This function is only called if support info mode is turned on with <code>logSupportInfo(true)</code>.
-	 *   To avoid negative effects regarding execution times and memory consumption, the returned object should be a simple
-	 *   immutable JSON object with mostly static and stable content.
+	 * @param {string} sMessage
+	 *   Message text to display
+	 * @param {string|Error} [vDetails='']
+	 *   Optional details about the message, might be omitted. Can be an Error object which will be
+	 *   logged together with its stacktrace.
+	 * @param {string} [sComponent='']
+	 *   Name of the component that produced the log entry
+	 * @param {function} [fnSupportInfo]
+	 *   Callback that returns an additional support object to be logged in support mode.
+	 *   This function is only called if support info mode is turned on with
+	 *   <code>logSupportInfo(true)</code>. To avoid negative effects regarding execution times and
+	 *   memory consumption, the returned object should be a simple immutable JSON object with mostly
+	 *   static and stable content.
 	 * @public
 	 * @SecSink {0 1 2|SECRET} Could expose secret data in logs
 	 */
-	Log.error = function(sMessage, sDetails, sComponent, fnSupportInfo) {
-		log(Log.Level.ERROR, sMessage, sDetails, sComponent, fnSupportInfo);
+	Log.error = function(sMessage, vDetails, sComponent, fnSupportInfo) {
+		log(Log.Level.ERROR, sMessage, vDetails, sComponent, fnSupportInfo);
 	};
 
 	/**
 	 * Creates a new warning-level entry in the log with the given message, details and calling component.
 	 *
-	 * @param {string} sMessage Message text to display
-	 * @param {string} [sDetails=''] Details about the message, might be omitted
-	 * @param {string} [sComponent=''] Name of the component that produced the log entry
-	 * @param {function} [fnSupportInfo] Callback that returns an additional support object to be logged in support mode.
-	 *   This function is only called if support info mode is turned on with <code>logSupportInfo(true)</code>.
-	 *   To avoid negative effects regarding execution times and memory consumption, the returned object should be a simple
-	 *   immutable JSON object with mostly static and stable content.
+	 * @param {string} sMessage
+	 *   Message text to display
+	 * @param {string|Error} [vDetails='']
+	 *   Optional details about the message, might be omitted. Can be an Error object which will be
+	 *   logged together with its stacktrace.
+	 * @param {string} [sComponent='']
+	 *   Name of the component that produced the log entry
+	 * @param {function} [fnSupportInfo]
+	 *   Callback that returns an additional support object to be logged in support mode.
+	 *   This function is only called if support info mode is turned on with
+	 *   <code>logSupportInfo(true)</code>. To avoid negative effects regarding execution times and
+	 *   memory consumption, the returned object should be a simple immutable JSON object with mostly
+	 *   static and stable content.
 	 * @public
 	 * @SecSink {0 1 2|SECRET} Could expose secret data in logs
 	 */
-	Log.warning = function(sMessage, sDetails, sComponent, fnSupportInfo) {
-		log(Log.Level.WARNING, sMessage, sDetails, sComponent, fnSupportInfo);
+	Log.warning = function(sMessage, vDetails, sComponent, fnSupportInfo) {
+		log(Log.Level.WARNING, sMessage, vDetails, sComponent, fnSupportInfo);
 	};
 
 	/**
 	 * Creates a new info-level entry in the log with the given message, details and calling component.
 	 *
-	 * @param {string} sMessage Message text to display
-	 * @param {string} [sDetails=''] Details about the message, might be omitted
-	 * @param {string} [sComponent=''] Name of the component that produced the log entry
-	 * @param {function} [fnSupportInfo] Callback that returns an additional support object to be logged in support mode.
-	 *   This function is only called if support info mode is turned on with <code>logSupportInfo(true)</code>.
-	 *   To avoid negative effects regarding execution times and memory consumption, the returned object should be a simple
-	 *   immutable JSON object with mostly static and stable content.
+	 * @param {string} sMessage
+	 *   Message text to display
+	 * @param {string|Error} [vDetails='']
+	 *   Optional details about the message, might be omitted. Can be an Error object which will be
+	 *   logged with the stack.
+	 * @param {string} [sComponent='']
+	 *   Name of the component that produced the log entry
+	 * @param {function} [fnSupportInfo]
+	 *   Callback that returns an additional support object to be logged in support mode.
+	 *   This function is only called if support info mode is turned on with
+	 *   <code>logSupportInfo(true)</code>. To avoid negative effects regarding execution times and
+	 *   memory consumption, the returned object should be a simple immutable JSON object with mostly
+	 *   static and stable content.
 	 * @public
 	 * @SecSink {0 1 2|SECRET} Could expose secret data in logs
 	 */
-	Log.info = function(sMessage, sDetails, sComponent, fnSupportInfo) {
-		log(Log.Level.INFO, sMessage, sDetails, sComponent, fnSupportInfo);
+	Log.info = function(sMessage, vDetails, sComponent, fnSupportInfo) {
+		log(Log.Level.INFO, sMessage, vDetails, sComponent, fnSupportInfo);
 	};
 
 	/**
 	 * Creates a new debug-level entry in the log with the given message, details and calling component.
 	 *
-	 * @param {string} sMessage Message text to display
-	 * @param {string} [sDetails=''] Details about the message, might be omitted
-	 * @param {string} [sComponent=''] Name of the component that produced the log entry
-	 * @param {function} [fnSupportInfo] Callback that returns an additional support object to be logged in support mode.
-	 *   This function is only called if support info mode is turned on with <code>logSupportInfo(true)</code>.
-	 *   To avoid negative effects regarding execution times and memory consumption, the returned object should be a simple
-	 *   immutable JSON object with mostly static and stable content.
+	 * @param {string} sMessage
+	 *   Message text to display
+	 * @param {string|Error} [vDetails='']
+	 *   Optional details about the message, might be omitted. Can be an Error object which will be
+	 *   logged with the stack.
+	 * @param {string} [sComponent='']
+	 *   Name of the component that produced the log entry
+	 * @param {function} [fnSupportInfo]
+	 *   Callback that returns an additional support object to be logged in support mode.
+	 *   This function is only called if support info mode is turned on with
+	 *   <code>logSupportInfo(true)</code>. To avoid negative effects regarding execution times and
+	 *   memory consumption, the returned object should be a simple immutable JSON object with mostly
+	 *   static and stable content.
 	 * @public
 	 * @SecSink {0 1 2|SECRET} Could expose secret data in logs
 	 */
-	Log.debug = function(sMessage, sDetails, sComponent, fnSupportInfo) {
-		log(Log.Level.DEBUG, sMessage, sDetails, sComponent, fnSupportInfo);
+	Log.debug = function(sMessage, vDetails, sComponent, fnSupportInfo) {
+		log(Log.Level.DEBUG, sMessage, vDetails, sComponent, fnSupportInfo);
 	};
 
 	/**
 	 * Creates a new trace-level entry in the log with the given message, details and calling component.
 	 *
-	 * @param {string} sMessage Message text to display
-	 * @param {string} [sDetails=''] Details about the message, might be omitted
-	 * @param {string} [sComponent=''] Name of the component that produced the log entry
-	 * @param {function} [fnSupportInfo] Callback that returns an additional support object to be logged in support mode.
-	 *   This function is only called if support info mode is turned on with <code>logSupportInfo(true)</code>.
-	 *   To avoid negative effects regarding execution times and memory consumption, the returned object should be a simple
-	 *   immutable JSON object with mostly static and stable content.
+	 * @param {string} sMessage
+	 *   Message text to display
+	 * @param {string|Error} [vDetails='']
+	 *   Optional details about the message, might be omitted. Can be an Error object which will be
+	 *   logged with the stack.
+	 * @param {string} [sComponent='']
+	 *   Name of the component that produced the log entry
+	 * @param {function} [fnSupportInfo]
+	 *   Callback that returns an additional support object to be logged in support mode.
+	 *   This function is only called if support info mode is turned on with
+	 *   <code>logSupportInfo(true)</code>. To avoid negative effects regarding execution times and
+	 *   memory consumption, the returned object should be a simple immutable JSON object with mostly
+	 *   static and stable content.
 	 * @public
 	 * @SecSink {0 1 2|SECRET} Could expose secret data in logs
 	 */
-	Log.trace = function(sMessage, sDetails, sComponent, fnSupportInfo) {
-		log(Log.Level.TRACE, sMessage, sDetails, sComponent, fnSupportInfo);
+	Log.trace = function(sMessage, vDetails, sComponent, fnSupportInfo) {
+		log(Log.Level.TRACE, sMessage, vDetails, sComponent, fnSupportInfo);
 	};
 
 	/**
-	 * Defines the maximum <code>sap.base.log.Level</code> of log entries that will be recorded.
+	 * Defines the maximum <code>sap/base/Log.Level</code> of log entries that will be recorded.
 	 * Log entries with a higher (less important) log level will be omitted from the log.
 	 * When a component name is given, the log level will be configured for that component
 	 * only, otherwise the log level for the default component of this logger is set.
@@ -315,7 +350,7 @@ sap.ui.define(["sap/base/util/now"], function(now) {
 	 * @public
 	 */
 	Log.setLevel = function(iLogLevel, sComponent, _bDefault) {
-		sComponent = sComponent || sDefaultComponent || '';
+		sComponent = sComponent || '';
 		if (!_bDefault || mMaxLevel[sComponent] == null) {
 			mMaxLevel[sComponent] = iLogLevel;
 			var sLogLevel;
@@ -338,7 +373,7 @@ sap.ui.define(["sap/base/util/now"], function(now) {
 	 * @public
 	 */
 	Log.getLevel = function(sComponent) {
-		return level(sComponent || sDefaultComponent);
+		return level(sComponent);
 	};
 
 	/**
@@ -353,7 +388,7 @@ sap.ui.define(["sap/base/util/now"], function(now) {
 	 * @public
 	 */
 	Log.isLoggable = function(iLevel, sComponent) {
-		return (iLevel == null ? Log.Level.DEBUG : iLevel) <= level(sComponent || sDefaultComponent);
+		return (iLevel == null ? Log.Level.DEBUG : iLevel) <= level(sComponent);
 	};
 
 	/**
@@ -376,32 +411,38 @@ sap.ui.define(["sap/base/util/now"], function(now) {
 	 * (or higher than the global level, if no component is given),
 	 * then no entry is created and <code>undefined</code> is returned.
 	 *
-	 * If an <code>Error</code> is passed via <code>sDetails</code> the stack
+	 * If an <code>Error</code> is passed via <code>vDetails</code> the stack
 	 * of the <code>Error</code> will be logged as a separate parameter in
 	 * the proper <code>console</code> function for the matching log level.
 	 *
-	 * @param {module:sap/base/Log.Level} iLevel One of the log levels FATAL, ERROR, WARNING, INFO, DEBUG, TRACE
-	 * @param {string} sMessage The message to be logged
-	 * @param {string|Error} [sDetails] The optional details for the message; could be an Error which will be logged with the stack to easily find the root cause of the Error
-	 * @param {string} [sComponent] The log component under which the message should be logged
-	 * @param {function} [fnSupportInfo] Callback that returns an additional support object to be logged in support mode.
-	 *   This function is only called if support info mode is turned on with <code>logSupportInfo(true)</code>.
-	 *   To avoid negative effects regarding execution times and memory consumption, the returned object should be a simple
-	 *   immutable JSON object with mostly static and stable content.
-	 * @returns {object} The log entry as an object or <code>undefined</code> if no entry was created
+	 * @param {module:sap/base/Log.Level} iLevel
+	 *   One of the log levels FATAL, ERROR, WARNING, INFO, DEBUG, TRACE
+	 * @param {string} sMessage
+	 *   The message to be logged
+	 * @param {string|Error} [vDetails]
+	 *   The optional details for the message; could be an Error which will be logged with the
+	 *   stacktrace, to easily find the root cause of the Error
+	 * @param {string} [sComponent]
+	 *   The log component under which the message should be logged
+	 * @param {function} [fnSupportInfo] Callback that returns an additional support object to be
+	 *   logged in support mode. This function is only called if support info mode is turned on with
+	 *   <code>logSupportInfo(true)</code>. To avoid negative effects regarding execution times and
+	 *   memory consumption, the returned object should be a simple immutable JSON object with mostly
+	 *   static and stable content.
+	 * @returns {object}
+	 *   The log entry as an object or <code>undefined</code> if no entry was created
 	 * @private
 	 */
-	function log(iLevel, sMessage, sDetails, sComponent, fnSupportInfo) {
-		if (!fnSupportInfo && !sComponent && typeof sDetails === "function") {
-			fnSupportInfo = sDetails;
-			sDetails = "";
+	function log(iLevel, sMessage, vDetails, sComponent, fnSupportInfo) {
+		if (!fnSupportInfo && !sComponent && typeof vDetails === "function") {
+			fnSupportInfo = vDetails;
+			vDetails = "";
 		}
 		if (!fnSupportInfo && typeof sComponent === "function") {
 			fnSupportInfo = sComponent;
 			sComponent = "";
 		}
 
-		sComponent = sComponent || sDefaultComponent;
 		if (iLevel <= level(sComponent) ) {
 			var fNow =  now(),
 				oNow = new Date(fNow),
@@ -412,7 +453,7 @@ sap.ui.define(["sap/base/util/now"], function(now) {
 					timestamp: fNow,
 					level    : iLevel,
 					message  : String(sMessage || ""),
-					details  : String(sDetails || ""),
+					details  : String(vDetails || ""),
 					component: String(sComponent || "")
 				};
 			if (bLogSupportInfo && typeof fnSupportInfo === "function") {
@@ -445,24 +486,24 @@ sap.ui.define(["sap/base/util/now"], function(now) {
 			 */
 			/*eslint-disable no-console */
 			if (console) { // in Firefox, console might not exist or it might even disappear
-				var isDetailsError = sDetails instanceof Error,
+				var isDetailsError = vDetails instanceof Error,
 					logText = oLogEntry.date + " " + oLogEntry.time + " " + oLogEntry.message + " - " + oLogEntry.details + " " + oLogEntry.component;
 				switch (iLevel) {
 					case Log.Level.FATAL:
-					case Log.Level.ERROR: isDetailsError ? console.error(logText, "\n", sDetails) : console.error(logText); break;
-					case Log.Level.WARNING: isDetailsError ? console.warn(logText, "\n", sDetails) : console.warn(logText); break;
+					case Log.Level.ERROR: isDetailsError ? console.error(logText, "\n", vDetails) : console.error(logText); break;
+					case Log.Level.WARNING: isDetailsError ? console.warn(logText, "\n", vDetails) : console.warn(logText); break;
 					case Log.Level.INFO:
 						if (console.info) { // info not available in iOS simulator
-							isDetailsError ? console.info(logText, "\n", sDetails) : console.info(logText);
+							isDetailsError ? console.info(logText, "\n", vDetails) : console.info(logText);
 						} else {
-							isDetailsError ? console.log(logText, "\n", sDetails) : console.log(logText);
+							isDetailsError ? console.log(logText, "\n", vDetails) : console.log(logText);
 						}
 						break;
 					case Log.Level.DEBUG:
-						isDetailsError ? console.debug(logText, "\n", sDetails) : console.debug(logText);
+						isDetailsError ? console.debug(logText, "\n", vDetails) : console.debug(logText);
 						break;
 					case Log.Level.TRACE:
-						isDetailsError ? console.trace(logText, "\n", sDetails) : console.trace(logText);
+						isDetailsError ? console.trace(logText, "\n", vDetails) : console.trace(logText);
 						break;
 				}
 				if (console.info && oLogEntry.supportInfo) {

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

@@ -334,20 +334,42 @@ sap.ui.define([
 	 * Returns a locale-specific string value for the given key sKey.
 	 *
 	 * The text is searched in this resource bundle according to the fallback chain described in
-	 * {@link module:sap/base/i18n/ResourceBundle}. If no text could be found, the key itself is used as text.
+	 * {@link module:sap/base/i18n/ResourceBundle}. If no text could be found, the key itself is used
+	 * as text.
+	 *
+	 *
+	 * <h3>Placeholders</h3>
+	 *
+	 * A text can contain placeholders that will be replaced with concrete values when
+	 * <code>getText</code> is called. The replacement is triggered by the <code>aArgs</code> parameter.
+	 *
+	 * Whenever this parameter is given, then the text and the arguments are additionally run through
+	 * the {@link module:sap/base/strings/formatMessage} API to replace placeholders in the text with
+	 * the corresponding values from the arguments array. The resulting string is returned by
+	 * <code>getText</code>.
+	 *
+	 * As the <code>formatMessage</code> API imposes some requirements on the input text (regarding
+	 * curly braces and single apostrophes), text authors need to be aware of the specifics of the
+	 * <code>formatMessage</code> API. Callers of <code>getText</code>, on the other side, should only
+	 * supply <code>aArgs</code> when the text has been created with the <code>formatMessage</code> API
+	 * in mind. Otherwise, single apostrophes in the text might be removed unintentionally.
+	 *
+	 * When <code>getText</code> is called without <code>aArgs</code>, the <code>formatMessage</code>
+	 * API is not applied and the transformation reg. placeholders and apostrophes does not happen.
 	 *
-	 * If the second parameter <code>aArgs</code> is given, then any placeholder of the form "{<i>n</i>}"
-	 * (with <i>n</i> being an integer) is replaced by the corresponding value from <code>aArgs</code>
-	 * with index <i>n</i>.  Note: This replacement is applied to the key if no text could be found.
 	 * For more details on the replacement mechanism refer to {@link module:sap/base/strings/formatMessage}.
 	 *
 	 * @param {string} sKey Key to retrieve the text for
 	 * @param {any[]} [aArgs] List of parameter values which should replace the placeholders "{<i>n</i>}"
-	 *     (<i>n</i> is the index) in the found locale-specific string value. Note that the replacement is done
-	 *     whenever <code>aArgs</code> is given, no matter whether the text contains placeholders or not
-	 *     and no matter whether <code>aArgs</code> contains a value for <i>n</i> or not.
-	 * @param {boolean} [bIgnoreKeyFallback=false] If set, <code>undefined</code> is returned instead of the key string, when the key is not found in any bundle or fallback bundle.
-	 * @returns {string|undefined} The value belonging to the key, if found; otherwise the key itself or <code>undefined</code> depending on <code>bIgnoreKeyFallback</code>.
+	 *     (<i>n</i> is the index) in the found locale-specific string value. Note that the replacement
+	 *     is done whenever <code>aArgs</code> is given, no matter whether the text contains placeholders
+	 *     or not and no matter whether <code>aArgs</code> contains a value for <i>n</i> or not.
+	 * @param {boolean} [bIgnoreKeyFallback=false]
+	 *     If set, <code>undefined</code> is returned instead of the key string, when the key is not found
+	 *     in any bundle or fallback bundle.
+	 * @returns {string|undefined}
+	 *     The value belonging to the key, if found; otherwise the key itself or <code>undefined</code>
+	 *     depending on <code>bIgnoreKeyFallback</code>.
 	 *
 	 * @public
 	 */
@@ -929,12 +951,20 @@ sap.ui.define([
 	};
 
 	/**
-	 * Hook called by sap.ui.core.Core to enrich bundle config with terminologies
+	 * Hook implemented by sap.ui.core.Core. to enrich bundle config with terminologies.
+	 * See also the documentation of the hook's implementation in Core.js.
 	 *
+	 * @see sap.ui.core.Core.getLibraryResourceBundle
+	 *
+	 * @params {object} the ResourceBundle.create bundle config
 	 * @private
 	 * @ui5-restricted sap.ui.core.Core
 	 */
-	ResourceBundle._enrichBundleConfig = function() {};
+	ResourceBundle._enrichBundleConfig = function(mParams) {
+		// Note: the ResourceBundle is a base module, which might be used standalone without the Core,
+		// so the bundle config must remain untouched
+		return mParams;
+	};
 
 	// ---- handling of supported locales and fallback chain ------------------------------------------
 

package/src/sap/base/util/includes.js

@@ -49,7 +49,7 @@ sap.ui.define([
 	* @param {int} [iFromIndex=0] - optional start index, negative start index will start from the end
 	* @returns {boolean} - true if value is in the collection, false otherwise
 	* @public
-	* @deprecated as of version 1.90. Use the <code>Array.includes</code> or <code>String.includes</code> instead.
+	* @deprecated as of version 1.90. Use the <code>Array.prototype.includes</code> or <code>String.prototype.includes</code> instead, but note that <code>Array.prototype.includes</code> or <code>String.prototype.includes</code> fail when called on null values.
 	*/
 	var fnIncludes = function (vCollection, vValue, iFromIndex) {
 		if (typeof iFromIndex !== 'number') {

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.108.0
+ * @version 1.109.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.108.0
+ * @version 1.109.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.108.0
+ * @version 1.109.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.108.0
+ * @version 1.109.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.108.0
+ * @version 1.109.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.108.0
+ * @version 1.109.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.108.0
+ * @version 1.109.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.108.0
+ * @version 1.109.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.108.0
+ * @version 1.109.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.108.0
+ * @version 1.109.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.108.0
+ * @version 1.109.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.108.0
+ * @version 1.109.0
  * @private
  * @ui5-restricted
 */