@openui5/sap.ui.core 1.108.1 → 1.109.0

package/src/sap/ui/model/odata/v4/lib/_AggregationHelper.js

@@ -36,6 +36,8 @@ sap.ui.define([
 			search : "string",
 			subtotalsAtBottomOnly : "boolean"
 		},
+		oFrozenCollapsed = Object.freeze({"@$ui5.node.isExpanded" : false}),
+		oFrozenExpanded = Object.freeze({"@$ui5.node.isExpanded" : true}),
 		// Example: "Texts/Country asc"
 		// capture groups: 1 - the property path
 		rOrderbyItem = new RegExp("^(" + _Parser.sODataIdentifier
@@ -97,6 +99,7 @@ sap.ui.define([
 	/*
 	 * Takes care of the $skip/$top system query options and returns the corresponding
 	 * transformation(s).
+	 *
 	 * @param {object} mQueryOptions
 	 *   A modifiable map of key-value pairs representing the query string
 	 * @param {number} [mQueryOptions.$skip]
@@ -122,6 +125,54 @@ sap.ui.define([
 	}
 
 	_AggregationHelper = {
+		/**
+		 * Before overwriting the given placeholder with the given element, perform some sanity
+		 * checks and restore some data from the placeholder to the element.
+		 *
+		 * @param {object} oPlaceholder - A placeholder
+		 * @param {object} oElement - Any node or leaf element
+		 * @param {sap.ui.model.odata.v4.lib._CollectionCache} oCache
+		 *   The group level cache which the given element has been read from
+		 * @param {number} iIndex
+		 *   The index of the given element within the cache's collection
+		 * @throws {Error}
+		 *   In case an unexpected element or placeholder would be overwritten, or in case of a
+		 *   structural change
+		 *
+		 * @private
+		 */
+		beforeOverwritePlaceholder : function (oPlaceholder, oElement, oCache, iIndex) {
+			var oParent = _Helper.getPrivateAnnotation(oPlaceholder, "parent");
+
+			if (!_Helper.hasPrivateAnnotation(oPlaceholder, "placeholder")) {
+				throw new Error("Unexpected element");
+			}
+			if (oParent !== oCache
+				|| _Helper.getPrivateAnnotation(oPlaceholder, "index") !== iIndex
+				|| oPlaceholder["@$ui5.node.level"] !== oElement["@$ui5.node.level"]
+				// Note: level 0 is used for initial placeholders of 1st level cache in case
+				// expandTo > 1
+				&& oPlaceholder["@$ui5.node.level"] !== 0) {
+				throw new Error("Wrong placeholder");
+			}
+			["descendants", "filter", "predicate"].forEach(function (sAnnotation) {
+				if (_Helper.hasPrivateAnnotation(oPlaceholder, sAnnotation)
+					&& _Helper.getPrivateAnnotation(oElement, sAnnotation)
+						!== _Helper.getPrivateAnnotation(oPlaceholder, sAnnotation)) {
+					throw new Error("Unexpected structural change: " + sAnnotation);
+				}
+			});
+
+			_Helper.copyPrivateAnnotation(oPlaceholder, "spliced", oElement);
+			if ("@$ui5.node.isExpanded" in oPlaceholder) {
+				if ((oElement["@$ui5.node.isExpanded"] === undefined)
+						!== (oPlaceholder["@$ui5.node.isExpanded"] === undefined)) {
+					throw new Error("Not a leaf anymore (or vice versa)");
+				}
+				oElement["@$ui5.node.isExpanded"] = oPlaceholder["@$ui5.node.isExpanded"];
+			}
+		},
+
 		/**
 		 * Builds the value for a "$apply" system query option based on the given data aggregation
 		 * information. The value is "groupby((<groupable_1,...,groupable_N),aggregate(
@@ -344,7 +395,9 @@ sap.ui.define([
 		/**
 		 * Builds the value for a "$apply" system query option based on the given data aggregation
 		 * information for a recursive hierarchy. If no query options are given, only a symbolic
-		 * "$apply" is constructed to avoid timing issues with metadata.
+		 * "$apply" is constructed to avoid timing issues with metadata. The property paths for
+		 * DistanceFromRootProperty, DrillStateProperty, and LimitedDescendantCountProperty are
+		 * stored at <code>oAggregation</code> using a "$" prefix (if not already stored).
 		 *
 		 * @param {object} oAggregation
 		 *   An object holding the information needed for a recursive hierarchy; see
@@ -383,14 +436,21 @@ sap.ui.define([
 				sSeparator = "";
 
 			function select(sProperty) {
+				var sPropertyPath;
+
 				if (mQueryOptions.$select) {
-					if (!mRecursiveHierarchy) {
-						mRecursiveHierarchy = oAggregation.$fetchMetadata(sPath
-							+ "/@com.sap.vocabularies.Hierarchy.v1.RecursiveHierarchy#"
-							+ sHierarchyQualifier).getResult();
-					}
+					sPropertyPath = oAggregation["$" + sProperty];
+					if (!sPropertyPath) {
+						if (!mRecursiveHierarchy) {
+							mRecursiveHierarchy = oAggregation.$fetchMetadata(sPath
+								+ "/@com.sap.vocabularies.Hierarchy.v1.RecursiveHierarchy#"
+								+ sHierarchyQualifier).getResult();
+						}
 
-					mQueryOptions.$select.push(mRecursiveHierarchy[sProperty].$PropertyPath);
+						sPropertyPath = oAggregation["$" + sProperty]
+							= mRecursiveHierarchy[sProperty].$PropertyPath;
+					}
+					mQueryOptions.$select.push(sPropertyPath);
 				}
 			}
 
@@ -434,8 +494,8 @@ sap.ui.define([
 					+ "',Levels=" + (oAggregation.expandTo || 1)
 					+ ")";
 				if (oAggregation.expandTo > 1) {
-					select("DescendantCountProperty");
 					select("DistanceFromRootProperty");
+					select("LimitedDescendantCountProperty");
 				}
 			}
 			select("DrillStateProperty");
@@ -499,7 +559,7 @@ sap.ui.define([
 		 *
 		 * @param {number} iLevel - The level
 		 * @param {number} iIndex - The index within the parent cache
-		 * @param {object} oParentCache - The parent cache
+		 * @param {sap.ui.model.odata.v4.lib._CollectionCache} oParentCache - The parent cache
 		 * @returns {object} A placeholder object
 		 *
 		 * @public
@@ -509,6 +569,7 @@ sap.ui.define([
 
 			_Helper.setPrivateAnnotation(oPlaceholder, "index", iIndex);
 			_Helper.setPrivateAnnotation(oPlaceholder, "parent", oParentCache);
+			_Helper.setPrivateAnnotation(oPlaceholder, "placeholder", true);
 
 			return oPlaceholder;
 		},
@@ -631,6 +692,21 @@ sap.ui.define([
 			return aAllProperties;
 		},
 
+		/**
+		 * Gets an object with property updates to be applied when collapsing the given group node.
+		 *
+		 * @param {object} oGroupNode
+		 *   The group node which is about to be expanded
+		 * @returns {object}
+		 *   An object with property updates to be applied when collapsing the given group node
+		 *
+		 * @public
+		 * @see .getOrCreateExpandedObject
+		 */
+		getCollapsedObject : function (oGroupNode) {
+			return _Helper.getPrivateAnnotation(oGroupNode, "collapsed") || oFrozenCollapsed;
+		},
+
 		/**
 		 * Returns the "$orderby" system query option filtered in such a way that only aggregatable
 		 * or groupable properties, units, or additionally requested properties are used, provided
@@ -722,7 +798,7 @@ sap.ui.define([
 		/**
 		 * Gets an object with property updates to be applied when expanding the given group node,
 		 * creating it when needed for the first time. Creates a corresponding object to be applied
-		 * when collapsing the node again. Takes placement of subtotals into account.
+		 * when collapsing the node again, if needed. Takes placement of subtotals into account.
 		 *
 		 * @param {object} oAggregation
 		 *   An object holding the information needed for data aggregation;
@@ -733,20 +809,23 @@ sap.ui.define([
 		 *   An object with property updates to be applied when expanding the given group node
 		 *
 		 * @public
+		 * @see .getCollapsedObject
 		 */
 		getOrCreateExpandedObject : function (oAggregation, oGroupNode) {
-			var oCollapsed,
-				oExpanded = _Helper.getPrivateAnnotation(oGroupNode, "expanded");
+			var oCollapsed, oExpanded;
 
+			if (oAggregation.subtotalsAtBottomOnly === undefined) { // "top only"
+				return oFrozenExpanded;
+			}
+
+			oExpanded = _Helper.getPrivateAnnotation(oGroupNode, "expanded");
 			if (!oExpanded) {
 				oCollapsed = {"@$ui5.node.isExpanded" : false};
 				_Helper.setPrivateAnnotation(oGroupNode, "collapsed", oCollapsed);
 				oExpanded = {"@$ui5.node.isExpanded" : true};
 				_Helper.setPrivateAnnotation(oGroupNode, "expanded", oExpanded);
-				if (oAggregation.subtotalsAtBottomOnly !== undefined) { // "only or also at bottom"
-					_AggregationHelper.extractSubtotals(oAggregation, oGroupNode, oCollapsed,
-						oAggregation.subtotalsAtBottomOnly ? oExpanded : null);
-				}
+				_AggregationHelper.extractSubtotals(oAggregation, oGroupNode, oCollapsed,
+					oAggregation.subtotalsAtBottomOnly ? oExpanded : null);
 			}
 
 			return oExpanded;
@@ -840,6 +919,20 @@ sap.ui.define([
 			});
 		},
 
+		/**
+		 * Marks the value of the given element's private annotation "spliced" with
+		 * <code>$stale : true</code>, if available.
+		 *
+		 * @param {object} oElement - Any node or leaf element
+		 */
+		markSplicedStale : function (oElement) {
+			var aSpliced = _Helper.getPrivateAnnotation(oElement, "spliced");
+
+			if (aSpliced) { // => collapsed
+				aSpliced.$stale = true;
+			}
+		},
+
 		/**
 		 * Removes any potential "UI5grand__" prefix from the given grand totals.
 		 *

package/src/sap/ui/model/odata/v4/lib/_Cache.js

@@ -1772,7 +1772,7 @@ sap.ui.define([
 	 *   Path of the entity, relative to the cache (as used by change listeners)
 	 * @param {boolean} [bUpdating]
 	 *   Whether the given property will not be overwritten by a creation POST(+GET) response
-	 * @returns {Promise}
+	 * @returns {sap.ui.base.SyncPromise}
 	 *   A promise which resolves with <code>undefined</code> once the value has been set, or is
 	 *   rejected with an error if setting fails somehow
 	 * @throws {Error} If the cache is shared
@@ -1880,6 +1880,9 @@ sap.ui.define([
 	 *   If no back-end request is needed, the function is not called.
 	 * @param {function} fnIsKeepAlive
 	 *   A function to tell whether the entity is kept-alive
+	 * @param {boolean} [bInactive]
+	 *   If <code>true</code>, the cache and the POST request will be updated, but the entity stays
+	 *   inactive
 	 * @returns {Promise}
 	 *   A promise for the PATCH request (resolves with <code>undefined</code>); rejected in case of
 	 *   cancellation or if no <code>fnErrorCallback</code> is given
@@ -1889,7 +1892,7 @@ sap.ui.define([
 	 */
 	_Cache.prototype.update = function (oGroupLock, sPropertyPath, vValue, fnErrorCallback,
 			sEditUrl, sEntityPath, sUnitOrCurrencyPath, bPatchWithoutSideEffects, fnPatchSent,
-			fnIsKeepAlive) {
+			fnIsKeepAlive, bInactive) {
 		var oPromise,
 			aPropertyPath = sPropertyPath.split("/"),
 			aUnitOrCurrencyPath,
@@ -2081,7 +2084,7 @@ sap.ui.define([
 			if (oPostBody) {
 				// change listeners are informed later
 				_Helper.updateAll({}, sEntityPath, oPostBody, oUpdateData);
-				if (oEntity["@$ui5.context.isInactive"]) {
+				if (oEntity["@$ui5.context.isInactive"] && !bInactive) {
 					oUpdateData["@$ui5.context.isInactive"] = false;
 					that.iActiveElements += 1;
 					addToCount(that.mChangeListeners, "", that.aElements, 1);
@@ -2105,9 +2108,10 @@ sap.ui.define([
 				}
 			}
 			if (sTransientGroup) {
-				// When updating a transient entity, _Helper.updateAll has already updated the
-				// POST request.
-				if (sParkedGroup) {
+				// When updating a transient entity, the above _Helper.updateAll has already updated
+				// the POST request.
+				// If the entity remains inactive, update the request, but keep it parked
+				if (sParkedGroup && !bInactive) {
 					_Helper.setPrivateAnnotation(oEntity, "transient", sTransientGroup);
 					that.oRequestor.relocate(sParkedGroup, oPostBody, sTransientGroup);
 				}
@@ -2451,6 +2455,17 @@ sap.ui.define([
 		this.addKeptElement(oElement); // maintain $byPredicate
 	};
 
+	/**
+	 * Drops the element with the given index and predicate from this cache's collection.
+	 *
+	 * @param {number} iIndex - An index
+	 * @param {string} sPredicate - A key predicate
+	 */
+	_CollectionCache.prototype.drop = function (iIndex, sPredicate) {
+		delete this.aElements[iIndex];
+		delete this.aElements.$byPredicate[sPredicate];
+	};
+
 	/**
 	 * Returns a promise to be resolved (synchronously if possible) with an OData object for the
 	 * requested data.
@@ -2543,6 +2558,57 @@ sap.ui.define([
 		this.oSyncPromiseAll = undefined; // from now on, fetchValue has to wait again
 	};
 
+	/**
+	 * Determines the list of visible or kept-alive elements determined by the given predicates. All
+	 * other elements from the back end are discarded!
+	 *
+	 * @param {string[]} aPredicates
+	 *   The key predicates of the root elements to request side effects for
+	 * @returns {object[]}
+	 *   The list of visible or kept-alive elements
+	 *
+	 * @private
+	 */
+	_CollectionCache.prototype.filterVisibleElements = function (aPredicates) {
+		var aElements,
+			iMaxIndex = -1,
+			mPredicates = {}, // a set of the predicates (as map to true) to speed up the search
+			that = this;
+
+		aPredicates.forEach(function (sPredicate) {
+			mPredicates[sPredicate] = true;
+		});
+
+		aElements = this.aElements.filter(function (oElement, i) {
+			var sPredicate;
+
+			if (!oElement) {
+				return false; // ignore
+			}
+			if (_Helper.hasPrivateAnnotation(oElement, "transient")) {
+				iMaxIndex = i;
+				return false; // keep, but do not request
+			}
+
+			sPredicate = _Helper.getPrivateAnnotation(oElement, "predicate");
+			if (mPredicates[sPredicate]
+					|| _Helper.hasPrivateAnnotation(oElement, "transientPredicate")) {
+				iMaxIndex = i;
+				delete mPredicates[sPredicate];
+				return true; // keep and request
+			}
+
+			that.drop(i, sPredicate);
+			return false;
+		});
+		this.aElements.length = iMaxIndex + 1;
+		Object.keys(mPredicates).forEach(function (sPredicate) {
+			aElements.push(that.aElements.$byPredicate[sPredicate]);
+		});
+
+		return aElements;
+	};
+
 	/**
 	 * Returns a filter that excludes all created entities in this cache's collection and all
 	 * entities that have been deleted on the client, but not on the server yet.
@@ -3122,10 +3188,8 @@ sap.ui.define([
 	_CollectionCache.prototype.requestSideEffects = function (oGroupLock, aPaths, aPredicates,
 			bSingle) {
 		var aElements,
-			iMaxIndex = -1,
 			mMergeableQueryOptions,
 			mQueryOptions,
-			mPredicates = {}, // a set of the predicates (as map to true) to speed up the search
 			sResourcePath,
 			bSkip,
 			mTypeForMetaPath = this.fetchTypes().getResult(),
@@ -3145,44 +3209,17 @@ sap.ui.define([
 		if (!mQueryOptions) {
 			return SyncPromise.resolve(); // micro optimization: use *sync.* promise which is cached
 		}
+		if (this.beforeRequestSideEffects) {
+			this.beforeRequestSideEffects(mQueryOptions);
+		}
 
 		if (bSingle) {
 			aElements = [this.aElements.$byPredicate[aPredicates[0]]];
 		} else {
-			aPredicates.forEach(function (sPredicate) {
-				mPredicates[sPredicate] = true;
-			});
-
-			aElements = this.aElements.filter(function (oElement, i) {
-				var sPredicate;
-
-				if (!oElement) {
-					return false; // ignore
-				}
-				if (_Helper.hasPrivateAnnotation(oElement, "transient")) {
-					iMaxIndex = i;
-					return false; // keep, but do not request
-				}
-
-				sPredicate = _Helper.getPrivateAnnotation(oElement, "predicate");
-				if (mPredicates[sPredicate]
-						|| _Helper.hasPrivateAnnotation(oElement, "transientPredicate")) {
-					iMaxIndex = i;
-					delete mPredicates[sPredicate];
-					return true; // keep and request
-				}
-
-				delete that.aElements[i];
-				delete that.aElements.$byPredicate[sPredicate];
-				return false;
-			});
-			this.aElements.length = iMaxIndex + 1;
+			aElements = this.filterVisibleElements(aPredicates);
 			if (!aElements.length) {
 				return SyncPromise.resolve(); // micro optimization: use cached *sync.* promise
 			}
-			Object.keys(mPredicates).forEach(function (sPredicate) {
-				aElements.push(that.aElements.$byPredicate[sPredicate]);
-			});
 		}
 		mQueryOptions.$filter = aElements.map(function (oElement) {
 			// all elements have a key predicate, so we will get a key filter
@@ -3922,7 +3959,8 @@ sap.ui.define([
 	 * @param {sap.ui.model.odata.v4.lib._Requestor} oRequestor
 	 *   The requestor
 	 * @param {string} sResourcePath
-	 *   A resource path relative to the service URL; it must not contain a query string<br>
+	 *   A resource path relative to the service URL; it must not contain a query string
+	 *   <br>
 	 *   Example: Products
 	 * @param {object} [mQueryOptions]
 	 *   A map of key-value pairs representing the query string, the value in this pair has to
@@ -3994,7 +4032,8 @@ sap.ui.define([
 	 * @param {sap.ui.model.odata.v4.lib._Requestor} oRequestor
 	 *   The requestor
 	 * @param {string} sResourcePath
-	 *   A resource path relative to the service URL; it must not contain a query string<br>
+	 *   A resource path relative to the service URL; it must not contain a query string
+	 *   <br>
 	 *   Example: Products
 	 * @param {object} [mQueryOptions]
 	 *   A map of key-value pairs representing the query string, the value in this pair has to
@@ -4021,7 +4060,8 @@ sap.ui.define([
 	 * @param {sap.ui.model.odata.v4.lib._Requestor} oRequestor
 	 *   The requestor
 	 * @param {string} sResourcePath
-	 *   A resource path relative to the service URL; it must not contain a query string<br>
+	 *   A resource path relative to the service URL; it must not contain a query string
+	 *   <br>
 	 *   Example: Products
 	 * @param {object} [mQueryOptions]
 	 *   A map of key-value pairs representing the query string, the value in this pair has to

package/src/sap/ui/model/odata/v4/lib/_Helper.js

@@ -356,6 +356,32 @@ sap.ui.define([
 				: JSON.parse(JSON.stringify(vValue, fnReplacer));
 		},
 
+		/**
+		 * Copies the value of the private client-side instance annotation with the given
+		 * unqualified name from the given source to the given target object, if present at the
+		 * source.
+		 *
+		 * @param {object} oSource
+		 *   Any object
+		 * @param {string} sAnnotation
+		 *   The unqualified name of a private client-side instance annotation (hidden inside
+		 *   namespace "@$ui5._")
+		 * @param {object} oTarget
+		 *   Any object
+		 * @throws {Error}
+		 *   If the annotation to be copied is already present at the target, no matter if the value
+		 *   is the same or not
+		 */
+		copyPrivateAnnotation : function (oSource, sAnnotation, oTarget) {
+			if (_Helper.hasPrivateAnnotation(oSource, sAnnotation)) {
+				if (_Helper.hasPrivateAnnotation(oTarget, sAnnotation)) {
+					throw new Error("Must not overwrite: " + sAnnotation);
+				}
+				_Helper.setPrivateAnnotation(oTarget, sAnnotation,
+					_Helper.getPrivateAnnotation(oSource, sAnnotation));
+			}
+		},
+
 		/**
 		 * Returns an <code>Error</code> instance from a jQuery XHR wrapper.
 		 *

package/src/sap/ui/model/resource/ResourceModel.js

@@ -229,7 +229,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.model.Model
 	 * @public
-	 * @version 1.108.1
+	 * @version 1.109.0
 	 */
 	var ResourceModel = Model.extend("sap.ui.model.resource.ResourceModel", /** @lends sap.ui.model.resource.ResourceModel.prototype */ {
 

package/src/sap/ui/model/type/Boolean.js

@@ -19,7 +19,7 @@ sap.ui.define(['sap/ui/model/SimpleType', 'sap/ui/model/FormatException', 'sap/u
 	 * @extends sap.ui.model.SimpleType
 	 *
 	 * @author SAP SE
-	 * @version 1.108.1
+	 * @version 1.109.0
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/type/Currency.js

@@ -32,7 +32,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.CompositeType
 	 *
 	 * @author SAP SE
-	 * @version 1.108.1
+	 * @version 1.109.0
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/type/Date.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.SimpleType
 	 *
 	 * @author SAP SE
-	 * @version 1.108.1
+	 * @version 1.109.0
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions] Formatting options. For a list of all available options, see {@link sap.ui.core.format.DateFormat.getDateInstance DateFormat}.

package/src/sap/ui/model/type/DateInterval.js

@@ -33,7 +33,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.CompositeType
 	 *
 	 * @author SAP SE
-	 * @version 1.108.1
+	 * @version 1.109.0
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions] Formatting options. For a list of all available options, see {@link sap.ui.core.format.DateFormat.getDateInstance DateFormat}.

package/src/sap/ui/model/type/DateTime.js

@@ -19,7 +19,7 @@ sap.ui.define(['./Date', 'sap/ui/core/format/DateFormat'],
 	 * @extends sap.ui.model.type.Date
 	 *
 	 * @author SAP SE
-	 * @version 1.108.1
+	 * @version 1.109.0
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions] Formatting options. For a list of all available options, see {@link sap.ui.core.format.DateFormat.getDateTimeInstance DateFormat}.

package/src/sap/ui/model/type/DateTimeInterval.js

@@ -19,7 +19,7 @@ sap.ui.define(['./DateInterval', 'sap/ui/core/format/DateFormat'],
 	 * @extends sap.ui.model.type.DateInterval
 	 *
 	 * @author SAP SE
-	 * @version 1.108.1
+	 * @version 1.109.0
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions] Formatting options. For a list of all available options, see {@link sap.ui.core.format.DateFormat.getDateTimeInstance DateFormat}.

package/src/sap/ui/model/type/FileSize.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.SimpleType
 	 *
 	 * @author SAP SE
-	 * @version 1.108.1
+	 * @version 1.109.0
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions] formatting options. Supports the same options as {@link sap.ui.core.format.FileSizeFormat.getInstance FileSizeFormat.getInstance}

package/src/sap/ui/model/type/Float.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.SimpleType
 	 *
 	 * @author SAP SE
-	 * @version 1.108.1
+	 * @version 1.109.0
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions] Formatting options. For a list of all available options, see {@link sap.ui.core.format.NumberFormat NumberFormat}.

package/src/sap/ui/model/type/Integer.js

@@ -26,7 +26,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.SimpleType
 	 *
 	 * @author SAP SE
-	 * @version 1.108.1
+	 * @version 1.109.0
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions] Formatting options. For a list of all available options, see {@link sap.ui.core.format.NumberFormat NumberFormat}.

package/src/sap/ui/model/type/String.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.SimpleType
 	 *
 	 * @author SAP SE
-	 * @version 1.108.1
+	 * @version 1.109.0
 	 *
 	 * @alias sap.ui.model.type.String
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/type/Time.js

@@ -19,7 +19,7 @@ sap.ui.define(['./Date', 'sap/ui/core/format/DateFormat'],
 	 * @extends sap.ui.model.type.Date
 	 *
 	 * @author SAP SE
-	 * @version 1.108.1
+	 * @version 1.109.0
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions] Formatting options. For a list of all available options, see {@link sap.ui.core.format.DateFormat.getTimeInstance DateFormat}.

package/src/sap/ui/model/type/TimeInterval.js

@@ -19,7 +19,7 @@ sap.ui.define(['./DateInterval', 'sap/ui/core/format/DateFormat'],
 	 * @extends sap.ui.model.type.DateInterval
 	 *
 	 * @author SAP SE
-	 * @version 1.108.1
+	 * @version 1.109.0
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions] Formatting options. For a list of all available options, see {@link sap.ui.core.format.DateFormat.getTimeInstance DateFormat}.

package/src/sap/ui/model/type/Unit.js

@@ -48,7 +48,7 @@ sap.ui.define([
 	 *
 	 *
 	 * @author SAP SE
-	 * @version 1.108.1
+	 * @version 1.109.0
 	 *
 	 * @public
 	 * @param {object} [oFormatOptions]

package/src/sap/ui/model/xml/XMLModel.js

@@ -47,7 +47,7 @@ sap.ui.define([
 	 * @extends sap.ui.model.ClientModel
 	 *
 	 * @author SAP SE
-	 * @version 1.108.1
+	 * @version 1.109.0
 	 *
 	 * @param {XMLDocument|string} oData
 	 *   Either the URL where to load the XML from or an XML document

package/src/sap/ui/qunit/QUnitUtils.js

@@ -24,6 +24,7 @@ sap.ui.define('sap/ui/qunit/QUnitUtils', [
 	"sap/base/strings/capitalize",
 	"sap/base/util/UriParameters",
 	"sap/base/Log",
+	"sap/ui/core/Element",
 	"sap/ui/dom/jquery/control" // jQuery Plugin "control"
 ],
 	function(
@@ -34,7 +35,8 @@ sap.ui.define('sap/ui/qunit/QUnitUtils', [
 		camelize,
 		capitalize,
 		UriParameters,
-		Log
+		Log,
+		Element
 	) {
 	"use strict";
 
@@ -218,6 +220,16 @@ sap.ui.define('sap/ui/qunit/QUnitUtils', [
 
 	};
 
+	var fnClosestTo = Element.closestTo && Element.closestTo.bind(Element);
+
+	/**
+	 * @deprecated Since 1.106
+	 */
+	if ( fnClosestTo == null ) {
+		fnClosestTo = function(oElement) {
+			return jQuery(oElement).control(0);
+		};
+	}
 
 	/**
 	 * Programmatically triggers a touch event specified by its name.
@@ -236,7 +248,7 @@ sap.ui.define('sap/ui/qunit/QUnitUtils', [
 		}
 
 		var oEvent = fakeEvent(sEventName, oTarget, oParams),
-			oElement = jQuery(oTarget).control(0),
+			oElement = fnClosestTo(oTarget),
 			sEventHandlerName = (sEventHandlerPrefix == null ? 'on' : sEventHandlerPrefix) + sEventName;
 
 		if (oElement && oElement[sEventHandlerName]) {

package/src/sap/ui/qunit/utils/ControlIterator.js

@@ -53,7 +53,7 @@ sap.ui.define(['sap/ui/core/Core', "sap/ui/VersionInfo"],
 	 * @namespace
 	 *
 	 * @author SAP SE
-	 * @version 1.108.1
+	 * @version 1.109.0
 	 *
 	 * @public
 	 * @since 1.48.0