@openui5/sap.ui.core 1.97.1 → 1.99.1

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

@@ -266,7 +266,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.EventProvider
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.99.1
 	 * @public
 	 * @alias sap.ui.base.ManagedObject
 	 */
@@ -556,6 +556,9 @@ sap.ui.define([
 
 	}, /* Metadata constructor */ ManagedObjectMetadata);
 
+	// Marker to not 'forget' ui5Objects
+	var sUI5ObjectMarker = Symbol("ui5object");
+
 	/**
 	 * Returns the metadata for the ManagedObject class.
 	 *
@@ -657,14 +660,13 @@ sap.ui.define([
 	 * <li><code>byValue: <i>boolean</i></code> (either can be omitted or set to the boolean value <code>true</code>)
 	 *     If set to <code>true</code>, the property value will be {@link module:sap/base/util/deepClone deep cloned}
 	 *     on write and read operations to ensure that the internal value can't be modified by the outside. The property
-	 *     <code>byValue</code> is currently limited to a <code>boolean</code> value. Other types are reserved for future
+	 *     <code>byValue</code> is currently restricted to a <code>boolean</code> value. Other types are reserved for future
 	 *     use. Class definitions must only use boolean values for the flag (or omit it), but readers of ManagedObject
 	 *     metadata should handle any truthy value as <code>true</code> to be future safe.
 	 *     Note that using <code>byValue:true</code> has a performance impact on property access and therefore should be
 	 *     used carefully. It also doesn't make sense to set this option for properties with a primitive type (they have
-	 *     value semantic anyhow) or for properties with arrays of primitive types (they have been cloned already in the
-	 *     past with a cheaper implementation). Future versions of UI5 might encourage this as a limitation during class
-	 *     definition.
+	 *     value semantic anyhow) or for properties with arrays of primitive types (they are already cloned
+	 *     with a less expensive implementation).
 	 * <li><code>group:<i>string</i></code> a semantic grouping of the properties, intended to be used in design time tools.
 	 *     Allowed values are (case sensitive): Accessibility, Appearance, Behavior, Data, Designtime, Dimension, Identification, Misc</li>
 	 * <li><code>defaultValue: <i>any</i></code> the default value for the property or null if there is no defaultValue.</li>
@@ -2934,6 +2936,9 @@ sap.ui.define([
 			if (oValue.Type) {
 				// if value contains the 'Type' property (capital 'T'), this is not a binding info.
 				return undefined;
+			} else if (oValue[sUI5ObjectMarker]) {
+				// no bindingInfo, delete marker
+				delete oValue[sUI5ObjectMarker];
 			} else if (oValue.ui5object) {
 				// if value contains ui5object property, this is not a binding info,
 				// remove it and not check for path or parts property
@@ -2977,6 +2982,32 @@ sap.ui.define([
 		return this.mBindingInfos[sName];
 	};
 
+	/**
+	 * Configuration for the binding of a managed object
+	 *
+	 * <code>path</code> is the only mandatory property, all others are optional.
+	 *
+	 * @typedef {object} sap.ui.base.ManagedObject.ObjectBindingInfo
+	 *
+	 * @property {string} path
+	 *   Path in the model to bind to, either an absolute path or relative to the binding context for the
+	 *   corresponding model. If the path contains a '&gt;' sign, the string preceding it will override
+	 *   the <code>model</code> property, and the remainder after the '&gt;' sign will be used as binding path
+	 * @property {string} [model]
+	 *   Name of the model to bind against; when <code>undefined</code> or omitted, the default model is used
+	 * @property {boolean} [suspended]
+	 *   Whether the binding is initially suspended
+	 * @property {object} [parameters]
+	 *   Map of additional parameters for this binding; the names and value ranges of the supported
+	 *   parameters depend on the model implementation and should be documented with the
+	 *   <code>bindContext</code> method of the corresponding model class or with the model-specific
+	 *   subclass of <code>sap.ui.model.ContextBinding</code>
+	 * @property {Object<string,function>} [events]
+	 *   Map of event handler functions keyed by the name of the binding events that they are attached to
+	 *
+	 * @public
+	 */
+
 	/**
 	 * Bind the object to the referenced entity in the model.
 	 *
@@ -2997,23 +3028,8 @@ sap.ui.define([
 	 *
 	 * Also see {@link topic:91f05e8b6f4d1014b6dd926db0e91070 Context Binding} in the documentation.
 	 *
-	 * @param {object} oBindingInfo
-	 *            An object describing the binding
-	 * @param {string} oBindingInfo.path
-	 *            Path in the model to bind to, either an absolute path or relative to the binding context for the
-	 *            corresponding model; when the path contains a '&gt;' sign, the string preceding it will override
-	 *            the <code>model</code> property and the remainder after the '&gt;' will be used as binding path
-	 * @param {string} [oBindingInfo.model]
-	 *            Name of the model to bind against; when <code>undefined</code> or omitted, the default model is used
-	 * @param {object} [oBindingInfo.parameters=null]
-	 *            Map of additional parameters for this binding; the names and value ranges of the supported parameters
-	 *            depend on the model implementation, they should be documented with the <code>bindContext</code>
-	 *            method of the corresponding model class or with the model specific subclass of
-	 *            <code>sap.ui.model.ContextBinding</code>
-	 * @param {boolean} [oBindingInfo.suspended=false]
-	 *            Whether the binding should be suspended initially
-	 * @param {object} [oBindingInfo.events=null]
-	 *            Map of event handler functions keyed by the name of the binding events that they should be attached to
+	 * @param {sap.ui.base.ManagedObject.ObjectBindingInfo} oBindingInfo
+	 *            Binding info
 	 * @returns {this}
 	 *            Returns <code>this</code> to allow method chaining
 	 * @public
@@ -3064,7 +3080,7 @@ sap.ui.define([
 	/**
 	 * Create object binding.
 	 *
-	 * @param {object} oBindingInfo The bindingInfo object
+	 * @param {sap.ui.base.ManagedObject.ObjectBindingInfo} oBindingInfo The bindingInfo object
 	 * @private
 	 */
 	ManagedObject.prototype._bindObject = function(oBindingInfo) {
@@ -4242,7 +4258,6 @@ sap.ui.define([
 	 * is called and the method implementation might rely on those conditions.
 	 *
 	 * @param {string} sName name of the aggregation to refresh
-	 * @param {sap.ui.model.ChangeReason} sChangeReason the change reason
 	 * @protected
 	 */
 	ManagedObject.prototype.refreshAggregation = function(sName) {
@@ -4811,8 +4826,8 @@ sap.ui.define([
 	/**
 	 * Calls a registered listener during propagation
 	 *
-	 * @param {string|boolean} 	sName If set true all listeners will be called.
-	 * 							If a name is specified only the listener for this name is called
+	 * @param {function} listener
+	 *      If given, the given function will be called, other wise all propagation listeners will be called.
 	 * @returns {this} Returns <code>this</code> to allow method chaining
 	 * @private
 	 */
@@ -5082,6 +5097,7 @@ sap.ui.define([
 
 		// Clone properties (only those with non-default value)
 		var aKeys = Object.keys(mProps);
+		var vValue;
 		i = aKeys.length;
 		while ( i > 0 ) {
 			sKey = aKeys[--i];
@@ -5092,7 +5108,12 @@ sap.ui.define([
 				if (typeof mProps[sKey] === "string") {
 					mSettings[sKey] = escape(mProps[sKey]);
 				} else {
-					mSettings[sKey] = oProperty.byValue ? deepClone(mProps[sKey]) : mProps[sKey];
+					vValue = oProperty.byValue ? deepClone(mProps[sKey]) : mProps[sKey];
+					if (vValue && typeof vValue === "object" && !Object.isFrozen(vValue)) {
+						//mark objects to not interpret it as bindingInfos
+						vValue[sUI5ObjectMarker] = true;
+					}
+					mSettings[sKey] = vValue;
 				}
 			}
 		}

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

@@ -73,7 +73,7 @@ function(
 	 *
 	 *
 	 * @author Frank Weigel
-	 * @version 1.97.1
+	 * @version 1.99.1
 	 * @since 0.8.6
 	 * @alias sap.ui.base.ManagedObjectMetadata
 	 * @extends sap.ui.base.Metadata

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

@@ -26,7 +26,7 @@ sap.ui.define([
 	 *
 	 * @class Metadata for a class.
 	 * @author Frank Weigel
-	 * @version 1.97.1
+	 * @version 1.99.1
 	 * @since 0.8.6
 	 * @public
 	 * @alias sap.ui.base.Metadata

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

@@ -26,7 +26,7 @@ sap.ui.define(['./Metadata', "sap/base/Log"],
 	 * @class Base class for all SAPUI5 Objects.
 	 * @abstract
 	 * @author Malte Wedel
-	 * @version 1.97.1
+	 * @version 1.99.1
 	 * @public
 	 * @alias sap.ui.base.Object
 	 * @throws {Error} When an instance of the class or its subclasses is created without the <code>new</code> operator.

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

@@ -59,7 +59,7 @@ sap.ui.define(['./Object'],
 	 *
 	 * @extends sap.ui.base.Object
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.99.1
 	 * @alias sap.ui.base.ObjectPool
 	 * @public
 	 */

package/src/sap/ui/core/.library

@@ -6,7 +6,7 @@
   <copyright>OpenUI5
  * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.</copyright>
-  <version>1.97.1</version>
+  <version>1.99.1</version>
 
   <documentation>The SAPUI5 Core Runtime.
 
@@ -381,7 +381,7 @@
             <copyright>2010-2011, Christian Johansen</copyright>
             <pattern>sap/ui/thirdparty/sinon-qunit.js</pattern>
         </lib>
-        <lib name="urijs" displayName="URI.js" version="1.19.7" homepage="http://medialize.github.com/URI.js/">
+        <lib name="urijs" displayName="URI.js" version="1.19.10" homepage="http://medialize.github.com/URI.js/">
             <license url="http://opensource.org/licenses/mit-license" type="MIT" />
             <copyright>Rodney Rehm</copyright>
             <pattern>sap/ui/thirdparty/URI.js</pattern>

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

@@ -38,7 +38,7 @@ sap.ui.define([
 	 * Provides methods to show or hide a waiting animation covering the whole
 	 * page and blocking user interaction.
 	 * @namespace
-	 * @version 1.97.1
+	 * @version 1.99.1
 	 * @public
 	 * @alias sap.ui.core.BusyIndicator
 	 */

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

@@ -24,7 +24,7 @@ sap.ui.define(['./BlockLayerUtils'], //require of sap/ui/core/library not possib
 	 * styling + animation: LocalBusyIndicator.less
 	 *
 	 * @param {string} sSize either "Large" or "Medium". Other sizes will be mapped to "Medium"
-	 * @returns {DOM.element} the element for the busy indicator
+	 * @returns {Element} the element for the busy indicator
 	 * @private
 	 * @ui5-restricted sap.ui.core, sap.chart
 	 */

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.97.1
+	 * @version 1.99.1
 	 * @alias sap.ui.core.Component
 	 * @since 1.9.2
 	 */
@@ -423,11 +423,11 @@ sap.ui.define([
 	 * @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.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,

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.97.1
+	 * @version 1.99.1
 	 *
 	 * @public
 	 * @alias sap.ui.core.ComponentContainer

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

@@ -36,7 +36,7 @@ sap.ui.define([
 	 * @public
 	 * @class
 	 * @author SAP SE
-	 * @version 1.97.1
+	 * @version 1.99.1
 	 * @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.97.1
+	 * @version 1.99.1
 	 * @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 : "" },
@@ -163,7 +164,6 @@ sap.ui.define([
 					"xx-waitForTheme"       : { type : "string",  defaultValue : ""}, // rendering|init
 					"xx-hyphenation" : { type : "string",  defaultValue : ""}, // (empty string)|native|thirdparty|disable
 					"xx-flexBundleRequestForced" : { type : "boolean",  defaultValue : false },
-					// TODO: check and remove "xx-cssVariables" value after tooling also support CSS variables if possible
 					"xx-cssVariables"       : { type : "string",   defaultValue : "false" }, // false|true|additional (additional just includes the css_variables.css in addition)
 					"statistics"            : { type : "boolean",  defaultValue : false }
 			};
@@ -373,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 === "") {
@@ -634,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
@@ -694,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, ...).
@@ -780,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.
 		 *
@@ -1007,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
@@ -1539,9 +1590,8 @@ sap.ui.define([
 		},
 
 		/**
-		 * Sets the security token handlers for an OData V4 model. See chapter "Security Token
-		 * Handling" in
-		 * {@link topic:9613f1f2d88747cab21896f7216afdac Model Instantiation and Data Access}.
+		 * Sets the security token handlers for an OData V4 model. See chapter
+		 * {@link topic:9613f1f2d88747cab21896f7216afdac/section_STH Security Token Handling}.
 		 *
 		 * @param {function[]} aSecurityTokenHandlers - The security token handlers
 		 * @public
@@ -1733,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.
 	 *
@@ -1844,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) {
@@ -1862,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
 		 */
@@ -1891,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) {
@@ -1902,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
 		 */
@@ -2016,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

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.97.1
+	 * @version 1.99.1
 	 * @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() {
@@ -683,7 +684,7 @@ sap.ui.define([
 		} else {
 			// core not yet initialized, defer execution
 			var that = this;
-			oCore.attachInitEvent(function () {
+			oCore.attachInit(function () {
 				that.placeAt(oRef, vPosition);
 			});
 		}

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.97.1
+	 * @version 1.99.1
 	 * @alias sap.ui.core.Core
 	 * @public
 	 * @hideconstructor
@@ -809,9 +809,6 @@ sap.ui.define([
 			case Device.os.OS.ANDROID:
 				osCSS = "sap-android";
 				break;
-			case Device.os.OS.BLACKBERRY:
-				osCSS = "sap-bb";
-				break;
 		}
 		if (osCSS) {
 			html.classList.add(osCSS);
@@ -3553,13 +3550,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});
 	};
 
 

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

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * in the documentation.
 	 *
 	 * @extends sap.ui.core.Element
-	 * @version 1.97.1
+	 * @version 1.99.1
 	 *
 	 * @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.97.1
+	 * @version 1.99.1
 	 * @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.97.1
+	 * @version 1.99.1
 	 * @public
 	 * @alias sap.ui.core.Element
 	 * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
@@ -837,6 +837,7 @@ sap.ui.define([
 	 * @param {object} [oFocusInfo={}] Options for setting the focus
 	 * @param {boolean} [oFocusInfo.preventScroll=false] @since 1.60 if it's set to true, the focused
 	 *   element won't be shifted into the viewport if it's not completely visible before the focus is set
+ 	 * @param {any} [oFocusInfo.targetInfo] Further control-specific setting of the focus target within the control @since 1.98
 	 * @public
 	 */
 	Element.prototype.focus = function (oFocusInfo) {
@@ -1418,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.97.1
+	 * @version 1.99.1
 	 * @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.97.1
+	 * @version 1.99.1
 	 * @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.97.1
+	 * @version 1.99.1
 	 * @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;