@openui5/sap.ui.core 1.98.0 → 1.101.0

package/src/sap/ui/core/Component.js

@@ -228,7 +228,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.ManagedObject
 	 * @abstract
 	 * @author SAP SE
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 * @alias sap.ui.core.Component
 	 * @since 1.9.2
 	 */
@@ -421,17 +421,18 @@ sap.ui.define([
 	 * @param {string|sap.ui.base.ManagedObject|sap.ui.core.Component} vObject Either Component Id, ManagedObject or component instance
 	 * @param {object} mOptions Info object to retrieve the customizing config
 	 * @param {object} mOptions.type Either <code>sap.ui.viewExtension</code>, <code>sap.ui.controllerReplacement</code>, <code>sap.ui.viewReplacement</code>, <code>sap.ui.viewModification</code> or <code>sap.ui.controllerExtension</code>
-	 * @param {object} mOptions.name Name of the customizing configuration
+	 * @param {object} [mOptions.name] Name of the customizing configuration. If none given the complete extension object is returned.
 	 * @param {object} [mOptions.extensionName] If type <code>sap.ui.viewExtension</code>, the extension name must be provided
-	 * @param {object} oExtInfo Config object containing the view/fragment and extension name
 	 * @throws {Error} If 'getExtensionComponent' function is given, but does not return an instance.
 	 * @returns {object|undefined} Object containing the customizing config or <code>undefined</code>
 	 * @static
-	 * @private ui5-restricted sap.ui.core
+	 * @private
+	 * @ui5-restricted sap.ui.core
 	 */
 	Component.getCustomizing = function(vObject, mOptions) {
 		var sType = mOptions.type,
-			sPath = "/sap.ui5/extends/extensions/" + sType + "/" + mOptions.name;
+			sExtensionSuffix = mOptions.name ? "/" + mOptions.name : "",
+			sPath = "/sap.ui5/extends/extensions/" + sType + sExtensionSuffix;
 
 		if (sType === "sap.ui.viewExtensions") {
 			sPath += "/" + mOptions.extensionName;
@@ -2468,15 +2469,9 @@ sap.ui.define([
 			 * register for messaging: register if either handleValidation is set in metadata
 			 * or if not set in metadata and set on instance
 			 */
-			var bHandleValidation = oInstance.getMetadata().handleValidation() !== undefined || vConfig.handleValidation;
-			if (bHandleValidation) {
-				// calculate handleValidation for registration
-				if (oInstance.getMetadata().handleValidation() !== undefined) {
-					bHandleValidation = oInstance.getMetadata().handleValidation();
-				} else {
-					bHandleValidation = vConfig.handleValidation;
-				}
-				sap.ui.getCore().getMessageManager().registerObject(oInstance, bHandleValidation);
+			var bHandleValidation = oInstance.getMetadata().getManifestEntry("/sap.ui5/handleValidation");
+			if (bHandleValidation !== undefined || vConfig.handleValidation) {
+				sap.ui.getCore().getMessageManager().registerObject(oInstance, bHandleValidation === undefined ? vConfig.handleValidation : bHandleValidation);
 			}
 
 			// Some services may demand immediate startup
@@ -3671,17 +3666,26 @@ sap.ui.define([
 	 *
 	 * @param {string} [sCommandName] The name of the command defined in manifest
 	 *
-	 * @returns {object} The command object as defined in the manifest
+	 * @returns {object|undefined} The command object as defined in the manifest, undefined if no command is found under the given name.
 	 * @private
 	 */
 	Component.prototype.getCommand = function(sCommandName) {
-		var oCommand,
-			oCommands = this._getManifestEntry("/sap.ui5/commands", true);
+		if (!this._mComputedCommands) {
+			var oCommandExtensions = Component.getCustomizing(this, {
+					type: "sap.ui.commands"
+				}) || {},
+				oOwnCommands = this._getManifestEntry("/sap.ui5/commands", true) || {},
+				sComponentName = this.getMetadata().getComponentName(),
+				sComponentIdSuffix = "",
+				oExtensionComponent = this.getExtensionComponent && this.getExtensionComponent();
 
-		if (oCommands && sCommandName) {
-			oCommand = oCommands[sCommandName];
+			if (oExtensionComponent && oExtensionComponent.getLocalId) {
+				sComponentIdSuffix = "#" + oExtensionComponent.getLocalId(this.getId());
+			}
+			this._mComputedCommands = merge({}, oOwnCommands, oCommandExtensions[sComponentName], oCommandExtensions[sComponentName + sComponentIdSuffix]);
 		}
-		return sCommandName ? oCommand : oCommands;
+
+		return sCommandName ? this._mComputedCommands[sCommandName] : this._mComputedCommands;
 	};
 
 	/**

package/src/sap/ui/core/ComponentContainer.js

@@ -59,7 +59,7 @@ sap.ui.define([
 	 * See also {@link module:sap/ui/core/ComponentSupport}.
 	 *
 	 * @extends sap.ui.core.Control
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.ComponentContainer

package/src/sap/ui/core/ComponentMetadata.js

@@ -31,12 +31,12 @@ sap.ui.define([
 	 * Creates a new metadata object for a Component subclass.
 	 *
 	 * @param {string} sClassName Fully qualified name of the class that is described by this metadata object
-	 * @param {object} oStaticInfo Static info to construct the metadata from
+	 * @param {object} oClassInfo Static info to construct the metadata from
 	 *
 	 * @public
 	 * @class
 	 * @author SAP SE
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 * @since 1.9.2
 	 * @alias sap.ui.core.ComponentMetadata
 	 * @extends sap.ui.base.ManagedObjectMetadata

package/src/sap/ui/core/ComponentSupport.js

@@ -97,7 +97,7 @@ sap.ui.define([
 	 * @author SAP SE
 	 * @public
 	 * @since 1.58.0
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 * @namespace
 	 * @alias module:sap/ui/core/ComponentSupport
 	 */

package/src/sap/ui/core/Configuration.js

@@ -11,6 +11,7 @@ sap.ui.define([
 	'../base/Object',
 	'./CalendarType',
 	'./Locale',
+	"./format/TimezoneUtil",
 	'sap/ui/thirdparty/URI',
 	"sap/base/util/UriParameters",
 	"sap/base/util/deepEqual",
@@ -26,6 +27,7 @@ sap.ui.define([
 		BaseObject,
 		CalendarType,
 		Locale,
+		TimezoneUtil,
 		URI,
 		UriParameters,
 		deepEqual,
@@ -101,12 +103,12 @@ sap.ui.define([
 			var M_SETTINGS = {
 					"theme"                 : { type : "string",   defaultValue : "base" },
 					"language"              : { type : "Locale",   defaultValue : detectLanguage() },
+					"timezone"              : { type : "string",   defaultValue : TimezoneUtil.getLocalTimezone() },
 					"formatLocale"          : { type : "Locale",   defaultValue : null },
 					"calendarType"          : { type : "string",   defaultValue : null },
 					"trailingCurrencyCode"  : { type : "boolean",  defaultValue : true },
-					// "timezone"              : "UTC",
 					"accessibility"         : { type : "boolean",  defaultValue : true },
-					"autoAriaBodyRole"      : { type : "boolean",  defaultValue : false,      noUrl:true }, //whether the framework automatically adds automatically the ARIA role 'application' to the html body
+					"autoAriaBodyRole"      : { type : "boolean",  defaultValue : false,      noUrl:true }, //whether the framework automatically adds the ARIA role 'application' to the html body
 					"animation"             : { type : "boolean",  defaultValue : true }, // deprecated, please use animationMode
 					"animationMode"         : { type : Configuration.AnimationMode, defaultValue : undefined }, // If no value is provided, animationMode will be set on instantiation depending on the animation setting.
 					"rtl"                   : { type : "boolean",  defaultValue : null },
@@ -145,7 +147,6 @@ sap.ui.define([
 					"xx-appCacheBusterHooks": { type : "object",   defaultValue : undefined, noUrl:true }, // e.g.: { handleURL: fn, onIndexLoad: fn, onIndexLoaded: fn }
 					"xx-disableCustomizing" : { type : "boolean",  defaultValue : false,     noUrl:true },
 					"xx-viewCache"          : { type : "boolean",  defaultValue : true },
-					"xx-test-mobile"        : { type : "boolean",  defaultValue : false },
 					"xx-depCache"           : { type : "boolean",  defaultValue : false },
 					"xx-libraryPreloadFiles": { type : "string[]", defaultValue : [] },
 					"xx-componentPreload"   : { type : "string",   defaultValue : "" },
@@ -372,6 +373,15 @@ sap.ui.define([
 					}
 				}
 
+				if (oUriParams.has('sap-timezone')) {
+					// validate the IANA timezone ID, but do not trigger a localizationChanged event
+					// because the initialization should not trigger a "*Changed" event
+					var sTimezone = oUriParams.get('sap-timezone');
+					if (checkTimezone(sTimezone)) {
+						this.timezone = sTimezone;
+					}
+				}
+
 				if (oUriParams.has('sap-theme')) {
 					var sValue = oUriParams.get('sap-theme');
 					if (sValue === "") {
@@ -633,7 +643,7 @@ sap.ui.define([
 		/**
 		 * Returns a string that identifies the current language.
 		 *
-		 * The value returned by this methods in most cases corresponds to the exact value that has been
+		 * The value returned by this method in most cases corresponds to the exact value that has been
 		 * configured by the user or application or that has been determined from the user agent settings.
 		 * It has not been normalized, but has been validated against a relaxed version of
 		 * {@link http://www.ietf.org/rfc/bcp/bcp47.txt BCP47}, allowing underscores ('_') instead of the
@@ -693,6 +703,18 @@ sap.ui.define([
 			return (this.sapLogonLanguage && this.sapLogonLanguage.toUpperCase()) || this.language.getSAPLogonLanguage();
 		},
 
+		/**
+		 * Retrieves the configured IANA timezone ID
+		 *
+		 * @returns {string} The configured IANA timezone ID, e.g. "America/New_York"
+		 * @public
+		 * @since 1.99.0
+		 * @experimental As of version 1.99.0, time zones are currently not supported by all controls.
+		 */
+		getTimezone : function () {
+			return this.timezone;
+		},
+
 		/**
 		 * Sets a new language to be used from now on for language/region dependent
 		 * functionality (e.g. formatting, data types, translated texts, ...).
@@ -779,6 +801,36 @@ sap.ui.define([
 			return this;
 		},
 
+		/**
+		 * Sets the timezone such that all date and time based calculations use this timezone.
+		 *
+		 * When the timezone has changed, the Core will fire its
+		 * {@link sap.ui.core.Core#event:localizationChanged localizationChanged} event.
+		 *
+		 * @param {string|null} [sTimezone] IANA timezone ID, e.g. "America/New_York". Use <code>null</code> to reset the timezone to the browser's local timezone.
+		 *   An invalid IANA timezone ID will fall back to the browser's timezone.
+		 * @public
+		 * @return {this} <code>this</code> to allow method chaining
+		 * @since 1.99.0
+		 * @experimental As of version 1.99.0, time zones are currently not supported by all controls.
+		 */
+		setTimezone : function (sTimezone) {
+			check(sTimezone == null || typeof sTimezone === 'string',
+				"Configuration.setTimezone: sTimezone must be null or be a string", /* warn= */ true);
+
+			if (sTimezone == null || !checkTimezone(sTimezone)) {
+				sTimezone = TimezoneUtil.getLocalTimezone();
+			}
+			if (this.timezone !== sTimezone) {
+				this.timezone = sTimezone;
+
+				var mChanges = this._collect();
+				mChanges.timezone = sTimezone;
+				this._endCollect();
+			}
+			return this;
+		},
+
 		/**
 		 * Returns a Locale object for the current language.
 		 *
@@ -1006,7 +1058,7 @@ sap.ui.define([
 		},
 
 		/**
-		 * Returns whether the framework automatically adds automatically
+		 * Returns whether the framework automatically adds
 		 * the ARIA role 'application' to the HTML body or not.
 		 * @return {boolean}
 		 * @since 1.27.0
@@ -1186,7 +1238,7 @@ sap.ui.define([
 		 * @returns {boolean} whether the design mode is active or not.
 		 * @since 1.13.2
 		 * @private
-		 * @ui5-restricted sap.watt, com.sap.webide
+		 * @ui5-restricted sap.watt, com.sap.webide, sap.ui.fl, sap.ui.rta, sap.ui.comp, SAP Business Application Studio
 		 */
 		getDesignMode : function() {
 			return this["xx-designMode"];
@@ -1731,6 +1783,21 @@ sap.ui.define([
 		throw new Error("Unsupported Enumeration value for " + sPropertyName + ", valid values are: " + aValidValues.join(", "));
 	}
 
+	/**
+	 * Checks if the provided timezone is valid and logs an error if not.
+	 *
+	 * @param {string} sTimezone The IANA timezone ID
+	 * @returns {boolean} Returns true if the timezone is valid
+	 */
+	function checkTimezone(sTimezone) {
+		var bIsValidTimezone = TimezoneUtil.isValidTimezone(sTimezone);
+		if (!bIsValidTimezone) {
+			Log.error("The provided timezone '" + sTimezone + "' is not a valid IANA timezone ID." +
+				" Falling back to browser's local timezone '" + TimezoneUtil.getLocalTimezone() + "'.");
+		}
+		return bIsValidTimezone;
+	}
+
 	/**
 	 * @class Encapsulates configuration settings that are related to data formatting/parsing.
 	 *
@@ -1842,7 +1909,7 @@ sap.ui.define([
 		 * * In the patterns <code>{0}</code> is replaced by the number
 		 *
 		 * E.g. In locale 'en' value <code>1</code> would result in <code>1 Bag</code>, while <code>2</code> would result in <code>2 Bags</code>
-		 * @param mUnits {object} custom unit object which replaces the current custom unit definition. Call with <code>null</code> to delete custom units.
+		 * @param {object} mUnits custom unit object which replaces the current custom unit definition. Call with <code>null</code> to delete custom units.
 		 * @returns {this}
 		 */
 		setCustomUnits: function (mUnits) {
@@ -1860,7 +1927,7 @@ sap.ui.define([
 		/**
 		 * Adds custom units.
 		 * Similar to {@link sap.ui.core.Configuration#setCustomUnits} but instead of setting the custom units, it will add additional ones.
-		 * @param mUnits {object} custom unit object which replaces the current custom unit definition. Call with <code>null</code> to delete custom units.
+		 * @param {object} mUnits custom unit object which replaces the current custom unit definition. Call with <code>null</code> to delete custom units.
 		 * @returns {this}
 		 * @see sap.ui.core.Configuration#setCustomUnits
 		 */
@@ -1889,7 +1956,7 @@ sap.ui.define([
 		 * </code>
 		 * Note: It is possible to create multiple entries per unit key.
 		 * Call with <code>null</code> to delete unit mappings.
-		 * @param mUnitMappings {object} unit mappings
+		 * @param {object} mUnitMappings unit mappings
 		 * @returns {this} Returns <code>this</code> to allow method chaining
 		 */
 		setUnitMappings: function (mUnitMappings) {
@@ -1900,7 +1967,7 @@ sap.ui.define([
 		/**
 		 * Adds unit mappings.
 		 * Similar to {@link sap.ui.core.Configuration#setUnitMappings} but instead of setting the unit mappings, it will add additional ones.
-		 * @param mUnitMappings {object} unit mappings
+		 * @param {object} mUnitMappings unit mappings
 		 * @returns {this}
 		 * @see sap.ui.core.Configuration#setUnitMappings
 		 */
@@ -2014,7 +2081,7 @@ sap.ui.define([
 		 * specific parts of the UI. See the documentation of {@link sap.ui.core.Configuration#setLanguage}
 		 * for details and restrictions.
 		 *
-		 * @param {string} sStyle must be one of decimal, group, plusSign, minusSign.
+		 * @param {string} sType must be one of decimal, group, plusSign, minusSign.
 		 * @param {string} sSymbol will be used to represent the given symbol type
 		 * @returns {this} Returns <code>this</code> to allow method chaining
 		 * @public
@@ -2069,6 +2136,8 @@ sap.ui.define([
 		 * </code>
 		 *
 		 * Note: To unset the custom currencies: call with <code>undefined</code>
+		 * Custom currencies must not only consist of digits but contain at least one non-digit character, e.g. "a",
+		 * so that the measure part can be distinguished from the number part.
 		 * @public
 		 * @param {object} mCurrencies currency map which is set
 		 * @returns {sap.ui.core.Configuration.FormatSettings}

package/src/sap/ui/core/Control.js

@@ -77,7 +77,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Element
 	 * @abstract
 	 * @author SAP SE
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 * @alias sap.ui.core.Control
 	 * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
 	 */
@@ -275,6 +275,7 @@ sap.ui.define([
 	 * @param {string} [sIdSuffix] a suffix to be appended to the cloned element id
 	 * @param {string[]} [aLocalIds] an array of local IDs within the cloned hierarchy (internally used)
 	 * @returns {this} reference to the newly created clone
+	 * @override
 	 * @public
 	 */
 	Control.prototype.clone = function() {

package/src/sap/ui/core/Core.js

@@ -210,7 +210,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.Object
 	 * @final
 	 * @author SAP SE
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 * @alias sap.ui.core.Core
 	 * @public
 	 * @hideconstructor
@@ -1513,6 +1513,9 @@ sap.ui.define([
 	};
 
 	/**
+	 * Creates a new <code>RenderManager</code> instance for use by the caller.
+	 *
+	 * @returns {sap.ui.core.RenderManager} A newly createdRenderManeger
 	 * @public
 	 * @deprecated Since version 0.15.0. Replaced by <code>createRenderManager()</code>
 	 */
@@ -1797,10 +1800,10 @@ sap.ui.define([
 	}
 
 	/**
-	 * Preprocessed given dependencies
+	 * Preprocess the given dependencies.
 	 *
-	 * @param {object} oDependencies - Dependencies to preprocess
-	 * @returns {object} oDependencies - Proprocessed dependencies
+	 * @param {object} dependencies - Dependencies to preprocess
+	 * @returns {object} Preprocessed dependencies
 	 */
 	function preprocessDependencies(dependencies) {
 		if (Array.isArray(dependencies)) {
@@ -2194,7 +2197,7 @@ sap.ui.define([
 	 * @param {string} [sId] the ID for the component instance
 	 * @param {object} [mSettings] the settings object for the component
 	 * @public
-	 * @returns {sap.ui.core.Component} the created Component instance
+	 * @returns {sap.ui.core.Component|Promise<sap.ui.core.Component>} The created component instance or a promise on it in the async use case
 	 * @deprecated Since 1.95. Please use {@link sap.ui.core.Component.create Component.create} instead.
 	 */
 	Core.prototype.createComponent = function(vComponent, sUrl, sId, mSettings) {
@@ -2315,6 +2318,7 @@ sap.ui.define([
 	 * @param {boolean} [oLibInfo.noLibraryCSS=false] Indicates whether the library doesn't provide / use theming.
 	 *                        When set to true, no library.css will be loaded for this library
 	 * @param {object} [oLibInfo.extensions] Potential extensions of the library metadata; structure not defined by the UI5 core framework.
+	 * @return {object|undefined} As of version 1.101; returns the library namespace, based on the given library name. Returns 'undefined' if no library name is provided.
 	 * @public
 	 */
 	Core.prototype.initLibrary = function(oLibInfo) {
@@ -2332,8 +2336,12 @@ sap.ui.define([
 			Log.error("[Deprecated] library " + sLibName + " uses old fashioned initLibrary() call (rebuild with newest generator)");
 		}
 
-		if ( !sLibName || mLoadedLibraries[sLibName] ) {
+		if (!sLibName) {
+			Log.error("A library name must be provided.", null, METHOD);
 			return;
+
+		} else if (mLoadedLibraries[sLibName]) {
+			return ObjectPath.get(sLibName);
 		}
 
 		Log.debug("Analyzing Library " + sLibName, null, METHOD);
@@ -2372,7 +2380,7 @@ sap.ui.define([
 		}
 
 		// ensure namespace
-		ObjectPath.create(sLibName);
+		var oLib = ObjectPath.create(sLibName);
 
 		// Create lib info object or merge with existing 'adhoc' library
 		this.mLibraries[sLibName] = oLibInfo = extend(this.mLibraries[sLibName] || {
@@ -2447,6 +2455,7 @@ sap.ui.define([
 
 		this.fireLibraryChanged({name : sLibName, stereotype : "library", operation: "add", metadata : oLibInfo});
 
+		return oLib;
 	};
 
 	// helper to add the FOUC marker to the CSS for the given id
@@ -3211,6 +3220,9 @@ sap.ui.define([
 
 	/**
 	 * Register a listener for the {@link sap.ui.core.Core#event:libraryChanged} event.
+	 *
+	 * @param {function} fnFunction Callback to be called when the <code>libraryChanged</code> event is fired
+	 * @param {object} [oListener] Optional context object to call the callback on
 	 */
 	Core.prototype.attachLibraryChanged = function(fnFunction, oListener) {
 		_oEventProvider.attachEvent(Core.M_EVENTS.LibraryChanged, fnFunction, oListener);
@@ -3218,6 +3230,9 @@ sap.ui.define([
 
 	/**
 	 * Unregister a listener from the {@link sap.ui.core.Core#event:libraryChanged} event.
+	 *
+	 * @param {function} fnFunction function to unregister
+	 * @param {object} [oListener] context object given during registration
 	 */
 	Core.prototype.detachLibraryChanged = function(fnFunction, oListener) {
 		_oEventProvider.detachEvent(Core.M_EVENTS.LibraryChanged, fnFunction, oListener);
@@ -3439,10 +3454,10 @@ sap.ui.define([
 	};
 
 	/**
-	 * Used to find out whether a certain DOM element is the static area
+	 * Checks whether the given DOM element is the root of the static area.
 	 *
-	 * @param {object} oDomRef
-	 * @return {boolean} whether the given DomRef is the StaticAreaRef
+	 * @param {Element} oDomRef DOM element to check
+	 * @returns {boolean} Whether the given DOM element is the root of the static area
 	 * @protected
 	 */
 	Core.prototype.isStaticAreaRef = function(oDomRef) {
@@ -3550,13 +3565,13 @@ sap.ui.define([
 	 * @param {string} sUIAreaId id of the UIArea that received the event
 	 * @private
 	 */
-	Core.prototype._handleControlEvent = function(/**event*/oEvent, sUiAreaId) {
+	Core.prototype._handleControlEvent = function(/**event*/oEvent, sUIAreaId) {
 		// Create a copy of the event
 		var oEventClone = jQuery.Event(oEvent.type);
 		Object.assign(oEventClone, oEvent);
 		oEventClone.originalEvent = undefined;
 
-		this.fireControlEvent({"browserEvent": oEventClone, "uiArea": sUiAreaId});
+		this.fireControlEvent({"browserEvent": oEventClone, "uiArea": sUIAreaId});
 	};
 
 
@@ -3945,6 +3960,8 @@ sap.ui.define([
 	 *
 	 * Please note that this event is a bubbling event and may already be canceled before reaching the core.
 	 *
+	 * @param {object}
+	 *            [oData] An object that will be passed to the handler along with the event object when the event is fired
 	 * @param {function}
 	 *            fnFunction The function to be called, when the event occurs
 	 * @param {object}

package/src/sap/ui/core/CustomData.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * in the documentation.
 	 *
 	 * @extends sap.ui.core.Element
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.CustomData

package/src/sap/ui/core/DeclarativeSupport.js

@@ -40,7 +40,7 @@ sap.ui.define([
 	 * @class Static class for enabling declarative UI support.
 	 *
 	 * @author Peter Muessig, Tino Butz
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 * @since 1.7.0
 	 * @public
 	 * @alias sap.ui.core.DeclarativeSupport

package/src/sap/ui/core/Element.js

@@ -126,7 +126,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 * @public
 	 * @alias sap.ui.core.Element
 	 * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
@@ -1419,12 +1419,9 @@ sap.ui.define([
 	 *
 	 * There's no difference between <code>bindElement</code> and {@link sap.ui.base.ManagedObject#bindObject}.
 	 *
-	 * @param {string|object} vPath the binding path or an object with more detailed binding options
-	 * @param {string} vPath.path the binding path
-	 * @param {object} [vPath.parameters] map of additional parameters for this binding
-	 * @param {string} [vPath.model] name of the model
-	 * @param {object} [vPath.events] map of event listeners for the binding events
-	 * @param {object} [mParameters] map of additional parameters for this binding (only taken into account when vPath is a string in that case it corresponds to vPath.parameters).
+	 * @param {string|sap.ui.base.ManagedObject.ObjectBindingInfo} vPath the binding path or an object with more detailed binding options
+	 * @param {object} [mParameters] map of additional parameters for this binding.
+	 * Only taken into account when <code>vPath</code> is a string. In that case it corresponds to <code>mParameters</code> of {@link sap.ui.base.ManagedObject.ObjectBindingInfo}.
 	 * The supported parameters are listed in the corresponding model-specific implementation of <code>sap.ui.model.ContextBinding</code>.
 	 *
 	 * @returns {this} reference to the instance itself

package/src/sap/ui/core/ElementMetadata.js

@@ -23,7 +23,7 @@ sap.ui.define([
 	 *
 	 * @class
 	 * @author SAP SE
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 * @since 0.8.6
 	 * @alias sap.ui.core.ElementMetadata
 	 * @extends sap.ui.base.ManagedObjectMetadata

package/src/sap/ui/core/EnabledPropagator.js

@@ -41,7 +41,7 @@ sap.ui.define([], function() {
 	 *
 	 * @param {boolean} [bDefault=true] Value that should be used as default value for the enhancement of the control.
 	 * @param {boolean} [bLegacy=false] Whether the introduced property should use the old name <code>Enabled</code>.
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 * @public
 	 * @class
 	 * @alias sap.ui.core.EnabledPropagator

package/src/sap/ui/core/EventBus.js

@@ -30,7 +30,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 * @public
 	 * @since 1.8.0
 	 * @alias sap.ui.core.EventBus

package/src/sap/ui/core/ExtensionPoint.js

@@ -113,7 +113,7 @@ sap.ui.define(["sap/base/Log", "sap/base/util/ObjectPath", "sap/ui/core/mvc/View
 					// We cannot model the Fragment class as a dependency of the ExtensionPoint class,
 					// since the XML Fragments rely on the XMLTP for parsing and thus create a cyclic dependency:
 					// XMLTP -> ExtensionPoint -> Fragment -> XMLTP
-					var Fragment = sap.ui.require("sap.ui.core.Fragment");
+					var Fragment = sap.ui.require("sap/ui/core/Fragment");
 
 					oFactoryConfig.fragmentName = oExtensionConfig.fragmentName;
 					oFactoryConfig.containingView = oView;
@@ -236,8 +236,13 @@ sap.ui.define(["sap/base/Log", "sap/base/util/ObjectPath", "sap/ui/core/mvc/View
 							next.index += aControls.length;
 							next = next._nextSibling;
 						}
+
+						this._aControls = aControls;
 					},
 
+					// the resolved controls of this ExtensionPoint
+					_aControls: [],
+
 					// only used internally to check for a marker object
 					_isExtensionPoint: true,
 

package/src/sap/ui/core/FocusHandler.js

@@ -201,7 +201,7 @@ sap.ui.define([
 		/**
 		 * Handles the focus/blur events.
 		 *
-		 * @param oRootRef e.g. document.body
+		 * @param {FocusEvent} oBrowserEvent Native browser focus/blur event object
 		 * @private
 		 */
 		FocusHandler.prototype.onEvent = function(oBrowserEvent){

package/src/sap/ui/core/Fragment.js

@@ -60,7 +60,7 @@ function(
 	 * @class
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 * @public
 	 * @alias sap.ui.core.Fragment
 	 */

package/src/sap/ui/core/HTML.js

@@ -44,7 +44,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 *
 	 * @public
 	 * @alias sap.ui.core.HTML

package/src/sap/ui/core/HTMLRenderer.js

@@ -20,7 +20,7 @@ sap.ui.define(['./RenderManager'], function(RenderManager) {
 		 * Renders either the configured content or a dummy div that will be replaced after rendering
 		 *
 		 * @param {sap.ui.core.RenderManager} [oRM] The RenderManager instance
-		 * @param {sap.ui.core.Control} [oControl] The instance of the invisible control
+		 * @param {sap.ui.core.HTML} [oControl] The instance of the invisible control
 		 */
 		render : function(oRM, oControl) {
 			// render an invisible, but easily identifiable placeholder for the content

package/src/sap/ui/core/History.js

@@ -22,7 +22,7 @@ sap.ui.define(['sap/ui/base/Object', "sap/ui/util/Storage"],
 	 *
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.98.0
+	 * @version 1.101.0
 	 * @alias sap.ui.core.History
 	 * @protected
 	 */