@openui5/sap.ui.core 1.113.0 → 1.114.0

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.113.0
+ * @version 1.114.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.113.0
+ * @version 1.114.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.113.0
+ * @version 1.114.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.113.0
+ * @version 1.114.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.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_isEqualWith
  * @author SAP SE
  * @since 1.80
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_isNil
  * @author SAP SE
  * @since 1.80
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_max
  * @author SAP SE
  * @since 1.71
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_merge
  * @author SAP SE
  * @since 1.71
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_mergeWith
  * @author SAP SE
  * @since 1.71
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_min
  * @author SAP SE
  * @since 1.71
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_omit
  * @author SAP SE
  * @since 1.71
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_pick
  * @author SAP SE
  * @since 1.71
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_pickBy
  * @author SAP SE
  * @since 1.71
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_throttle
  * @author SAP SE
  * @since 1.71
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_toArray
  * @author SAP SE
  * @since 1.80
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_union
  * @author SAP SE
  * @since 1.81
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_unionBy
  * @author SAP SE
  * @since 1.81
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_unionWith
  * @author SAP SE
  * @since 1.81
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_uniq
  * @author SAP SE
  * @since 1.71
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_uniqBy
  * @author SAP SE
  * @since 1.71
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_uniqWith
  * @author SAP SE
  * @since 1.71
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_without
  * @author SAP SE
  * @since 1.80
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_xor
  * @author SAP SE
  * @since 1.80
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_xorBy
  * @author SAP SE
  * @since 1.80
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_xorWith
  * @author SAP SE
  * @since 1.80
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_zipObject
  * @author SAP SE
  * @since 1.81
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

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

@@ -10,7 +10,7 @@
  * @alias module:sap/base/util/restricted/_zipObjectDeep
  * @author SAP SE
  * @since 1.81
- * @version 1.113.0
+ * @version 1.114.0
  * @private
  * @ui5-restricted
 */

package/src/sap/ui/Device.js

@@ -11,7 +11,7 @@
  * This API is independent from any other part of the UI5 framework. This allows it to be loaded beforehand, if it is needed, to create the UI5 bootstrap
  * dynamically depending on the capabilities of the browser or device.
  *
- * @version 1.113.0
+ * @version 1.114.0
  * @namespace
  * @name sap.ui.Device
  * @public
@@ -32,7 +32,7 @@ if (typeof window.sap.ui !== "object") {
 
 	//Skip initialization if API is already available
 	if (typeof window.sap.ui.Device === "object" || typeof window.sap.ui.Device === "function") {
-		var apiVersion = "1.113.0";
+		var apiVersion = "1.114.0";
 		window.sap.ui.Device._checkAPIVersion(apiVersion);
 		return;
 	}
@@ -105,7 +105,7 @@ if (typeof window.sap.ui !== "object") {
 
 	//Only used internal to make clear when Device API is loaded in wrong version
 	Device._checkAPIVersion = function(sVersion) {
-		var v = "1.113.0";
+		var v = "1.114.0";
 		if (v != sVersion) {
 			oLogger.log(WARNING, "Device API version differs: " + v + " <-> " + sVersion);
 		}
@@ -909,6 +909,7 @@ if (typeof window.sap.ui !== "object") {
 	 * screen width range: <code>sapUiMedia-3Step-<i>NAME_OF_THE_INTERVAL</i></code>.
 	 *
 	 * @name sap.ui.Device.media.RANGESETS.SAP_3STEPS
+	 * @type string
 	 * @public
 	 */
 	/**
@@ -928,6 +929,7 @@ if (typeof window.sap.ui !== "object") {
 	 * screen width range: <code>sapUiMedia-4Step-<i>NAME_OF_THE_INTERVAL</i></code>.
 	 *
 	 * @name sap.ui.Device.media.RANGESETS.SAP_4STEPS
+	 * @type string
 	 * @public
 	 */
 	/**
@@ -949,6 +951,7 @@ if (typeof window.sap.ui !== "object") {
 	 * screen width range: <code>sapUiMedia-6Step-<i>NAME_OF_THE_INTERVAL</i></code>.
 	 *
 	 * @name sap.ui.Device.media.RANGESETS.SAP_6STEPS
+	 * @type string
 	 * @public
 	 */
 	/**
@@ -976,6 +979,7 @@ if (typeof window.sap.ui !== "object") {
 	 * </ul>
 	 *
 	 * @name sap.ui.Device.media.RANGESETS.SAP_STANDARD
+	 * @type string
 	 * @public
 	 */
 
@@ -996,6 +1000,7 @@ if (typeof window.sap.ui !== "object") {
 	 * screen width range: <code>sapUiMedia-StdExt-<i>NAME_OF_THE_INTERVAL</i></code>.
 	 *
 	 * @name sap.ui.Device.media.RANGESETS.SAP_STANDARD_EXTENDED
+	 * @type string
 	 * @public
 	 */
 

package/src/sap/ui/Global.js

@@ -18,7 +18,7 @@
  * sap.ui.lazyRequire("sap.ui.core.Control");
  * sap.ui.lazyRequire("sap.m.Button");
  *
- * @version 1.113.0
+ * @version 1.114.0
  * @author  SAP SE
  * @public
  */
@@ -49,7 +49,7 @@ sap.ui.define([
 	 * The <code>sap</code> namespace is automatically registered with the
 	 * OpenAjax hub if it exists.
 	 *
-	 * @version 1.113.0
+	 * @version 1.114.0
 	 * @namespace
 	 * @public
 	 * @name sap
@@ -62,7 +62,7 @@ sap.ui.define([
 	 * The <code>sap.ui</code> namespace is the central OpenAjax compliant entry
 	 * point for UI related JavaScript functionality provided by SAP.
 	 *
-	 * @version 1.113.0
+	 * @version 1.114.0
 	 * @namespace
 	 * @name sap.ui
 	 * @public
@@ -76,7 +76,7 @@ sap.ui.define([
 		 * The version of the SAP UI Library
 		 * @type string
 		 */
-		version: "1.113.0",
+		version: "1.114.0",
 		// buildinfo.lastchange is deprecated and is therefore defaulted to empty string
 		buildinfo : { lastchange : "", buildtime : "${buildtime}" }
 	});

package/src/sap/ui/base/BindingParser.js

@@ -228,21 +228,50 @@ sap.ui.define([
 					bindContext: false
 				});
 
-				// TODO find another solution for the type parameters?
-				if (typeof FNType === "function") {
-					o.type = new FNType(o.formatOptions, o.constraints);
-				} else {
-					o.type = FNType;
-				}
+				var fnInstantiateType = function(TypeClass) {
+					if (typeof TypeClass === "function") {
+						o.type = new TypeClass(o.formatOptions, o.constraints);
+					} else {
+						o.type = TypeClass;
+					}
 
-				if (!o.type) {
-					Log.error("Failed to resolve type '" + sType + "'. Maybe not loaded or a typo?");
-				}
+					if (!o.type) {
+						Log.error("Failed to resolve type '" + sType + "'. Maybe not loaded or a typo?");
+					}
 
-				// TODO why are formatOptions and constraints also removed for an already instantiated type?
-				// TODO why is a value of type object not validated (instanceof Type)
-				delete o.formatOptions;
-				delete o.constraints;
+					// TODO why are formatOptions and constraints also removed for an already instantiated type?
+					// TODO why is a value of type object not validated (instanceof Type)
+					delete o.formatOptions;
+					delete o.constraints;
+				};
+
+				if (oEnv.aTypePromises) {
+					var pType;
+
+					// FNType is either:
+					//    a) a function
+					//       * a lazy-stub
+					//       * a regular constructor function
+					//    b) an object that must implement Type interface (we take this "as-is")
+					//    c) undefined, we try to interpret the original string as a module name then
+					if (typeof FNType === "function" && !FNType._sapUiLazyLoader ||
+						FNType && typeof FNType === "object") {
+						pType = Promise.resolve(fnInstantiateType(FNType));
+					} else {
+						// load type asynchronously
+						pType = new Promise(function(fnResolve, fnReject) {
+							sap.ui.require([sType.replace(/\./g, "/")], fnResolve, fnReject);
+						}).catch(function(oError){
+							// [Compatibility]: We must not throw an error during type creation (except constructor failures!).
+							//                  We catch any require() rejection and log the error.
+							Log.error(oError);
+						}).then(fnInstantiateType);
+					}
+
+					oEnv.aTypePromises.push(pType);
+				} else {
+					fnInstantiateType(FNType);
+				}
 			}
 		}
 
@@ -382,12 +411,24 @@ sap.ui.define([
 		};
 	}
 
-	BindingParser.simpleParser = function(sString, oContext) {
+	BindingParser.simpleParser = function(sString) {
+		// The simpleParser only needs the first string argument and additionally in the async case the 7th one.
+		// see "BindingParser.complexParser" for the other arguments
+		var bResolveTypesAsync = arguments[7];
 
+		var oBindingInfo;
 		if ( sString.startsWith("{") && sString.endsWith("}") ) {
-			return makeSimpleBindingInfo(sString.slice(1, -1));
+			oBindingInfo = makeSimpleBindingInfo(sString.slice(1, -1));
 		}
 
+		if (bResolveTypesAsync) {
+			return {
+				bindingInfo: oBindingInfo,
+				resolved: Promise.resolve()
+			};
+		}
+
+		return oBindingInfo;
 	};
 
 	BindingParser.simpleParser.escape = function(sValue) {
@@ -408,9 +449,12 @@ sap.ui.define([
 	 *   globally
 	 * @param {object} [mLocals]
 	 *   variables allowed in the expression as map of variable name to its value
+	 * @param {boolean} [bResolveTypesAsync]
+	 *   whether the Type classes should be resolved asynchronously.
+	 *   The parsing result is enriched with an additional Promise capturing all transitive Type loading.
 	 */
 	BindingParser.complexParser = function(sString, oContext, bUnescape,
-			bTolerateFunctionsNotFound, bStaticContext, bPreferContext, mLocals) {
+			bTolerateFunctionsNotFound, bStaticContext, bPreferContext, mLocals, bResolveTypesAsync) {
 		var b2ndLevelMergedNeeded = false, // whether some 2nd level parts again have parts
 			oBindingInfo = {parts:[]},
 			bMergeNeeded = false, // whether some top-level parts again have parts
@@ -420,7 +464,8 @@ sap.ui.define([
 				aFunctionsNotFound: undefined, // lazy creation
 				bPreferContext : bPreferContext,
 				bStaticContext: bStaticContext,
-				bTolerateFunctionsNotFound: bTolerateFunctionsNotFound
+				bTolerateFunctionsNotFound: bTolerateFunctionsNotFound,
+				aTypePromises: bResolveTypesAsync ? [] : undefined
 			},
 			aFragments = [],
 			bUnescaped,
@@ -543,9 +588,25 @@ sap.ui.define([
 			if (oEnv.aFunctionsNotFound) {
 				oBindingInfo.functionsNotFound = oEnv.aFunctionsNotFound;
 			}
+
+			if (bResolveTypesAsync) {
+				// parse result contains additionally a Promise with all asynchronously loaded types
+				return {
+					bindingInfo: oBindingInfo,
+					resolved: Promise.all(oEnv.aTypePromises)
+				};
+			}
+
 			return oBindingInfo;
 		} else if ( bUnescape && bUnescaped ) {
-			return aFragments.join('');
+			var sResult = aFragments.join('');
+			if (bResolveTypesAsync) {
+				return {
+					bindingInfo: sResult,
+					resolved: Promise.resolve()
+				};
+			}
+			return sResult;
 		}
 
 	};

package/src/sap/ui/base/Event.js

@@ -23,7 +23,7 @@ sap.ui.define(['./Object', "sap/base/assert"],
 	 * @extends sap.ui.base.Object
 	 * @implements sap.ui.base.Poolable
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.114.0
 	 * @alias sap.ui.base.Event
 	 * @public
 	 */

package/src/sap/ui/base/EventProvider.js

@@ -18,7 +18,7 @@ sap.ui.define(['./Event', './Object', './ObjectPool', "sap/base/assert"],
 	 * @abstract
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.114.0
 	 * @public
 	 * @alias sap.ui.base.EventProvider
 	 */

package/src/sap/ui/base/Interface.js

@@ -28,7 +28,7 @@ sap.ui.define(['sap/ui/base/Object'], function(BaseObject) {
 	 * no internals of the class can be accessed.
 	 *
 	 * @author Malte Wedel, Daniel Brinkmann
-	 * @version 1.113.0
+	 * @version 1.114.0
 	 * @param {sap.ui.base.Object} oObject
 	 *   Object for which a facade should be created
 	 * @param {string[]} aMethods

package/src/sap/ui/base/ManagedObject.js

@@ -253,7 +253,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.EventProvider
 	 * @author SAP SE
-	 * @version 1.113.0
+	 * @version 1.114.0
 	 * @public
 	 * @alias sap.ui.base.ManagedObject
 	 */
@@ -1010,7 +1010,7 @@ sap.ui.define([
 	 *
 	 * @param {sap.ui.base.ManagedObject|object} vData
 	 *   The data to create the object from
-	 * @param {object} [oKeyInfo]
+	 * @param {sap.ui.base.ManagedObject.MetadataOptions.Aggregation} [oKeyInfo]
 	 *   Info object for the aggregation to which the created object will be added;
 	 *   serves as a fallback for determining the type of the object to be created
 	 * @param {object} [oScope]
@@ -1628,7 +1628,7 @@ sap.ui.define([
 	 * If no origin info is available, <code>null</code> will be returned.
 	 *
 	 * @param {string} sPropertyName Name of the property
-	 * @returns {object|null} An object describing the origin of this property's value or <code>null</code>
+	 * @returns {{source: string, locale: string}}|null} An object describing the origin of this property's value or <code>null</code>
 	 * @public
 	 */
 	ManagedObject.prototype.getOriginInfo = function(sPropertyName) {
@@ -1722,8 +1722,8 @@ sap.ui.define([
 	 * Use the concrete method get<i>XYZ</i> for association 'XYZ' instead.
 	 *
 	 * @param {string} sAssociationName the name of the association
-	 * @param {object} oDefaultForCreation
-	 *            the object that is used in case the current aggregation is empty (only null or empty array allowed)
+	 * @param {null|Array} oDefaultForCreation
+	 *            the value that is used in case the current aggregation is empty (only null or empty array is allowed)
 	 * @returns {string | string[] | null} the ID of the associated managed object or an array of such IDs; may be null if the association has not been populated
 	 * @protected
 	 */
@@ -2034,7 +2034,7 @@ sap.ui.define([
 	 *
 	 * @param {string}
 	 *            sAggregationName name of an 0..1 aggregation
-	 * @param {object}
+	 * @param {sap.ui.base.ManagedObject}
 	 *            oObject the managed object that is set as aggregated object
 	 * @param {boolean}
 	 *            [bSuppressInvalidate] if true, this ManagedObject is not marked as changed
@@ -3062,8 +3062,9 @@ sap.ui.define([
 	 *
 	 * @param {string} sName Name of the property or aggregation
 	 *
-	 * @returns {object} A binding info object, containing at least a <code>path</code> or <code>parts</code> property
-	 *                   and, depending on the binding type, additional properties
+	 * @returns {sap.ui.base.ManagedObject.PropertyBindingInfo|sap.ui.base.ManagedObject.AggregationBindingInfo}
+	 *  A binding info object, containing at least a <code>path</code> or <code>parts</code> property and, depending on
+	 *  the binding type, additional properties
 	 *
 	 * @protected
 	 */
@@ -3305,7 +3306,7 @@ sap.ui.define([
 	 *   parameters depend on the model implementation, they should be documented with the
 	 *   <code>bindProperty</code> method of the corresponding model class or with the model specific
 	 *   subclass of <code>sap.ui.model.PropertyBinding</code>
-	 * @property {object} [events=null]
+	 * @property {Object<string,function>} [events=null]
 	 *   Map of event handler functions keyed by the name of the binding events that they should be attached to
 	 * @property {Array<string|sap.ui.base.ManagedObject.PropertyBindingInfo>} [parts]
 	 *   Array of binding info objects for the parts of a composite binding; the structure of
@@ -3565,7 +3566,7 @@ sap.ui.define([
 	 *   will be destroyed, and when this  <code>ManagedObject</code> is cloned, the template will be cloned
 	 *   as well; the third option (<code>undefined</code>) only exists for compatibility reasons, its behavior
 	 *   is not fully reliable and it may leak the template
-	 * @property {function} [factory]
+	 * @property {function(string, sap.ui.model.Context):sap.ui.base.ManagedObject} [factory]
 	 *   A factory function that will be called to create an object for each item in the aggregation;
 	 *   this is an alternative to providing a template object and can be used when the objects should differ
 	 *   depending on the binding context; the factory function will be called with two parameters: an ID that
@@ -3581,7 +3582,7 @@ sap.ui.define([
 	 *   The initial sort order (optional)
 	 * @property {sap.ui.model.Filter|sap.ui.model.Filter[]} [filters]
 	 *   The predefined filters for this aggregation (optional)
-	 * @property {string|function} [key]
+	 * @property {string|function(sap.ui.model.Context):string} [key]
 	 *   Name of the key property or a function getting the context as only parameter to calculate a key
 	 *   for entries. This can be used to improve update behaviour in models, where a key is not already
 	 *   available.
@@ -3590,7 +3591,7 @@ sap.ui.define([
 	 *   parameters depend on the model implementation, they should be documented with the
 	 *   <code>bindList</code> method of the corresponding model class or with the model specific
 	 *   subclass of <code>sap.ui.model.ListBinding</code>
-	 * @property {function} [groupHeaderFactory]
+	 * @property {function({key: string}):sap.ui.base.ManagedObject} [groupHeaderFactory]
 	 *   A factory function to generate custom group visualization (optional). It should return a
 	 *   control suitable to visualize a group header (e.g. a <code>sap.m.GroupHeaderListItem</code>
 	 *   for a <code>sap.m.List</code>).