@openui5/sap.ui.core 1.92.0 → 1.95.0

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

@@ -266,7 +266,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.base.EventProvider
 	 * @author SAP SE
-	 * @version 1.92.0
+	 * @version 1.95.0
 	 * @public
 	 * @alias sap.ui.base.ManagedObject
 	 */
@@ -1151,7 +1151,7 @@ sap.ui.define([
 					if (oBindingInfo && typeof oBindingInfo === "object") {
 						this.bindProperty(sKey, oBindingInfo);
 					} else {
-						this[oKeyInfo._sMutator](oBindingInfo || oValue);
+						this[oKeyInfo._sMutator](typeof oBindingInfo === "string" ? oBindingInfo : oValue);
 					}
 					break;
 				case 1: // SINGLE_AGGREGATION
@@ -1166,7 +1166,7 @@ sap.ui.define([
 							}
 							oValue = oValue[0];
 						}
-						this[oKeyInfo._sMutator](makeObject(oBindingInfo || oValue, oKeyInfo, oScope));
+						this[oKeyInfo._sMutator](makeObject(typeof oBindingInfo === "string" ? oBindingInfo : oValue, oKeyInfo, oScope));
 					}
 					break;
 				case 2: // MULTIPLE_AGGREGATION
@@ -1174,7 +1174,7 @@ sap.ui.define([
 					if (oBindingInfo && typeof oBindingInfo === "object" ) {
 						this.bindAggregation(sKey, oBindingInfo);
 					} else {
-						oValue = oBindingInfo || oValue; // could be an unescaped string if altTypes contains 'string'
+						oValue = typeof oBindingInfo === "string" ? oBindingInfo : oValue; // could be an unescaped string if altTypes contains 'string'
 						if ( oValue ) {
 							if ( Array.isArray(oValue) ) {
 								addAllToAggregation(oValue); // wrap a single object as array
@@ -2797,6 +2797,19 @@ sap.ui.define([
 			this.iSuppressInvalidate++;
 		}
 
+		// Data Binding
+		for (sName in this.mBindingInfos) {
+			if (this.mBindingInfos[sName].factory) {
+				this._detachAggregationBindingHandlers(sName);
+			} else {
+				this._detachPropertyBindingHandlers(sName);
+			}
+		}
+
+		for (sName in this.mObjectBindingInfos) {
+			this._detachObjectBindingHandlers(sName);
+		}
+
 		if (this.exit) {
 			this.exit();
 		}
@@ -3099,6 +3112,25 @@ sap.ui.define([
 		oBinding.initialize();
 	};
 
+	/**
+	 * Detach all object binding event handler
+	 *
+	 * @param {string} sModelName Name of the model to detach the handler for.
+	 * @private
+	 */
+	ManagedObject.prototype._detachObjectBindingHandlers = function(sModelName) {
+		var oBindingInfo = this.mObjectBindingInfos[sModelName];
+		if (oBindingInfo) {
+			if (oBindingInfo.binding) {
+				oBindingInfo.binding.detachChange(oBindingInfo.modelChangeHandler);
+				oBindingInfo.binding.detachEvents(oBindingInfo.events);
+				if (this.refreshDataState) {
+					oBindingInfo.binding.detachAggregatedDataStateChange(oBindingInfo.dataStateChangeHandler);
+				}
+			}
+		}
+	};
+
 	/**
 	 * Removes the defined binding context of this object, all bindings will now resolve
 	 * relative to the parent context again.
@@ -3111,10 +3143,8 @@ sap.ui.define([
 		var oBindingInfo = this.mObjectBindingInfos[sModelName];
 		if (oBindingInfo) {
 			if (oBindingInfo.binding) {
-				oBindingInfo.binding.detachChange(oBindingInfo.modelChangeHandler);
-				oBindingInfo.binding.detachEvents(oBindingInfo.events);
-				if (this.refreshDataState) {
-					oBindingInfo.binding.detachAggregatedDataStateChange(oBindingInfo.dataStateChangeHandler);
+				if (!this._bIsBeingDestroyed) {
+					this._detachObjectBindingHandlers(sModelName);
 				}
 				oBindingInfo.binding.destroy();
 			}
@@ -3515,6 +3545,33 @@ sap.ui.define([
 		}
 	};
 
+	/**
+	 * Detach all property binding event handler
+	 *
+	 * Note: The DataState event handler could not be detached here. This must happen after
+	 * the destroy call to correctly cleanup messages. We leave it in unbindProperty and
+	 * check for destroy state in the handler itself.
+	 *
+	 * @param {string} sName the name of the property
+	 * @private
+	 */
+	ManagedObject.prototype._detachPropertyBindingHandlers = function(sName) {
+		var oBindingInfo = this.mBindingInfos[sName],
+			oBinding;
+		if (oBindingInfo) {
+			oBinding = oBindingInfo.binding;
+			if (oBinding) {
+				oBinding.detachChange(oBindingInfo.modelChangeHandler);
+				oBinding.detachEvents(oBindingInfo.events);
+				/* to reset messages on a control we need to detach the datastate handler after destroy,
+				as binding destroy clears up validation messages */
+				if (this.refreshDataState && this._bIsBeingDestroyed) {
+					oBinding.detachAggregatedDataStateChange(oBindingInfo.dataStateChangeHandler);
+				}
+			}
+		}
+	};
+
 	/**
 	 * Unbind the property from the model
 	 *
@@ -3529,17 +3586,18 @@ sap.ui.define([
 		if (oBindingInfo) {
 			oBinding = oBindingInfo.binding;
 			if (oBinding) {
-				oBinding.detachChange(oBindingInfo.modelChangeHandler);
-				oBinding.detachEvents(oBindingInfo.events);
+				if (!this._bIsBeingDestroyed) {
+					this._detachPropertyBindingHandlers(sName);
+				}
 				oBinding.destroy();
 				/* to reset messages on a control we need to detach the datastate handler after destroy,
 				   as binding destroy clears up validation messages */
-				if (this.refreshDataState) {
+				if (this.refreshDataState && !this._bIsBeingDestroyed) {
 					oBinding.detachAggregatedDataStateChange(oBindingInfo.dataStateChangeHandler);
 				}
 			}
 
-			if (this._observer) {
+			if (this._observer && !this._bIsBeingDestroyed) {
 				this._observer.bindingChange(this,sName,"remove", this.mBindingInfos[sName], "property");
 			}
 
@@ -3699,7 +3757,7 @@ sap.ui.define([
 	 *   Name of the model to bind against; when <code>undefined</code> or omitted, the default model is used
 	 * @property {sap.ui.base.ManagedObject} [template]
 	 *   The template to clone for each item in the aggregation; either a template or a factory must be given
-	 * @property {boolean|undefined} [templateShareable=undefined]
+	 * @property {boolean} [templateShareable=undefined]
 	 *   Whether the framework should assume that the application takes care of the lifecycle of the given
 	 *   template; when set to <code>true</code>, the template can be used in multiple bindings, either in
 	 *   parallel or over time, and the framework won't clone it when this <code>ManagedObject</code> is cloned;
@@ -3941,6 +3999,26 @@ sap.ui.define([
 		}
 	};
 
+	/**
+	 * Detach all aggregation binding event handler
+	 *
+	 * @param {string} sName the name of the aggregation
+	 * @private
+	 */
+	ManagedObject.prototype._detachAggregationBindingHandlers = function(sName) {
+		var oBindingInfo = this.mBindingInfos[sName];
+		if (oBindingInfo) {
+			if (oBindingInfo.binding) {
+				oBindingInfo.binding.detachChange(oBindingInfo.modelChangeHandler);
+				oBindingInfo.binding.detachRefresh(oBindingInfo.modelRefreshHandler);
+				oBindingInfo.binding.detachEvents(oBindingInfo.events);
+				if (this.refreshDataState) {
+					oBindingInfo.binding.detachAggregatedDataStateChange(oBindingInfo.dataStateChangeHandler);
+				}
+			}
+		}
+	};
+
 	/**
 	 * Unbind the aggregation from the model.
 	 *
@@ -3963,11 +4041,8 @@ sap.ui.define([
 			oAggregationInfo = this.getMetadata().getAggregation(sName);
 		if (oBindingInfo) {
 			if (oBindingInfo.binding) {
-				oBindingInfo.binding.detachChange(oBindingInfo.modelChangeHandler);
-				oBindingInfo.binding.detachRefresh(oBindingInfo.modelRefreshHandler);
-				oBindingInfo.binding.detachEvents(oBindingInfo.events);
-				if (this.refreshDataState) {
-					oBindingInfo.binding.detachAggregatedDataStateChange(oBindingInfo.dataStateChangeHandler);
+				if (!this._bIsBeingDestroyed) {
+					this._detachAggregationBindingHandlers(sName);
 				}
 				oBindingInfo.binding.destroy();
 			}
@@ -3980,8 +4055,7 @@ sap.ui.define([
 					oBindingInfo.template._sapui_candidateForDestroy = true;
 				}
 			}
-
-			if (this._observer) {
+			if (this._observer && !this._bIsBeingDestroyed) {
 				this._observer.bindingChange(this,sName,"remove", this.mBindingInfos[sName], "aggregation");
 			}
 			delete this.mBindingInfos[sName];
@@ -4218,6 +4292,7 @@ sap.ui.define([
 	ManagedObject.prototype.updateBindings = function(bUpdateAll, sModelName) {
 		var that = this,
 			sName,
+			bCanCreate,
 			oBindingInfo;
 
 		/*
@@ -4302,14 +4377,18 @@ sap.ui.define([
 		// create object bindings if they don't exist yet
 		for ( sName in this.mObjectBindingInfos ) {
 			oBindingInfo = this.mObjectBindingInfos[sName];
-
+			bCanCreate = canCreate(oBindingInfo);
 			// if there is a binding and if it became invalid through the current model change, then remove it
 			if ( oBindingInfo.binding && becameInvalid(oBindingInfo) ) {
 				removeBinding(oBindingInfo);
+				// if model does not exists anymore, also delete the BindingContext
+				if (!bCanCreate) {
+					delete this.mElementBindingContexts[sName];
+				}
 			}
 
 			// if there is no binding and if all required information is available, create a binding object
-			if ( !oBindingInfo.binding && canCreate(oBindingInfo) ) {
+			if ( !oBindingInfo.binding && bCanCreate ) {
 				this._bindObject(oBindingInfo);
 			}
 		}
@@ -4582,7 +4661,7 @@ sap.ui.define([
 	 * <b>Note:</b> A ManagedObject inherits binding contexts from the Core only when it is a descendant of a UIArea.
 	 *
 	 * @param {string} [sModelName] the name of the model or <code>undefined</code>
-	 * @return {sap.ui.model.Context} The binding context of this object
+	 * @returns {sap.ui.model.Context|null|undefined} The binding context of this object
 	 * @public
 	 */
 	ManagedObject.prototype.getBindingContext = function(sModelName){
@@ -4869,7 +4948,7 @@ sap.ui.define([
 	 * Omitting the model name (or using the value <code>undefined</code>) is explicitly allowed and
 	 * refers to the default model.
 	 *
-	 * @param {string|undefined} [sModelName] name of the model to be retrieved
+	 * @param {string} [sModelName] name of the model to be retrieved
 	 * @return {sap.ui.model.Model} oModel
 	 * @public
 	 */
@@ -5315,6 +5394,34 @@ sap.ui.define([
 		this._onContextualSettingsChanged();
 	};
 
+	/**
+	 * Checks if an object's destruction has been started. During the
+	 * descruction of an object its ID is still registered, and child
+	 * objects could be still aggregated.
+	 * Creating another object with the same ID would lead to duplicate ID
+	 * issues.
+	 * To check if the destruction is finished, call <code>isDestroyed</code>.
+	 *
+	 * @return {boolean} Whether an object's destruction has been started
+	 * @since 1.93
+	 * @protected
+	 */
+	ManagedObject.prototype.isDestroyStarted = function() {
+		return !!this._bIsBeingDestroyed;
+	};
+
+	/**
+	 * Returns whether this object is destroyed or not. A
+	 * destroyed object cannot be used anymore.
+	 *
+	 * @return {boolean} Whether the object is destroyed
+	 * @since 1.93
+	 * @public
+	 */
+	ManagedObject.prototype.isDestroyed = function() {
+		return !!this.bIsDestroyed;
+	};
+
 	ManagedObject._defaultContextualSettings = {};
 
 	return ManagedObject;

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

@@ -73,7 +73,7 @@ function(
 	 *
 	 *
 	 * @author Frank Weigel
-	 * @version 1.92.0
+	 * @version 1.95.0
 	 * @since 0.8.6
 	 * @alias sap.ui.base.ManagedObjectMetadata
 	 * @extends sap.ui.base.Metadata
@@ -211,7 +211,10 @@ function(
 	};
 
 	Property.prototype.getType = function() {
-		return this._oType || (this._oType = DataType.getType(this.type));
+		if (!this._oType) {
+			this._oType = DataType.getType(this.type);
+		}
+		return this._oType;
 	};
 
 	Property.prototype.getDefaultValue = function() {
@@ -323,7 +326,10 @@ function(
 	};
 
 	Aggregation.prototype.getType = function() {
-		return this._oType || (this._oType = DataType.getType(this.type));
+		if (!this._oType) {
+			this._oType = DataType.getType(this.type);
+		}
+		return this._oType;
 	};
 
 	Aggregation.prototype.get = function(instance) {
@@ -704,7 +710,10 @@ function(
 	};
 
 	Association.prototype.getType = function() {
-		return this._oType || (this._oType = DataType.getType(this.type));
+		if (!this._oType) {
+			this._oType = DataType.getType(this.type);
+		}
+		return this._oType;
 	};
 
 	Association.prototype.get = function(instance) {

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

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

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

@@ -13,8 +13,8 @@
  */
 
 // Provides class sap.ui.base.Object
-sap.ui.define(['./Interface', './Metadata', "sap/base/Log"],
-	function(Interface, Metadata, Log) {
+sap.ui.define(['./Metadata', "sap/base/Log"],
+	function(Metadata, Log) {
 	"use strict";
 
 
@@ -26,7 +26,7 @@ sap.ui.define(['./Interface', './Metadata', "sap/base/Log"],
 	 * @class Base class for all SAPUI5 Objects.
 	 * @abstract
 	 * @author Malte Wedel
-	 * @version 1.92.0
+	 * @version 1.95.0
 	 * @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.
@@ -67,7 +67,7 @@ sap.ui.define(['./Interface', './Metadata', "sap/base/Log"],
 		// initially, an Object instance has no associated Interface and the getInterface
 		// method is defined only in the prototype. So the code here will be executed.
 		// It creates an interface (basically the same code as in the old implementation)
-		var oInterface = new Interface(this, this.getMetadata().getAllPublicMethods());
+		var oInterface = new BaseObject._Interface(this, this.getMetadata().getAllPublicMethods());
 		// Now this Object instance gets a new, private implementation of getInterface
 		// that returns the newly created oInterface. Future calls of getInterface on the
 		// same Object therefore will return the already created interface
@@ -236,6 +236,51 @@ sap.ui.define(['./Interface', './Metadata', "sap/base/Log"],
 		return oObject instanceof BaseObject && oObject.isA(vTypeName);
 	};
 
+	/**
+	 * @param  {sap.ui.base.Object} [oObject] Object for which a facade should be created
+	 * @param  {string[]} [aMethods=[]] Names of the methods, that should be available in the new facade
+	 * @param  {boolean} [_bReturnFacade=false] If true, the return value of a function call is this created Interface instance instead of the BaseObject interface
+	 * @private
+	 * @static
+	 */
+	BaseObject._Interface = function(oObject, aMethods, _bReturnFacade) {
+		// if object is null or undefined, return itself
+		if (!oObject) {
+			return oObject;
+		}
+
+		function fCreateDelegator(oObject, sMethodName) {
+			return function() {
+					// return oObject[sMethodName].apply(oObject, arguments);
+					var tmp = oObject[sMethodName].apply(oObject, arguments);
+					// to avoid to hide the implementation behind the interface you need
+					// to override the getInterface function in the object or create the interface with bFacade = true
+					if (_bReturnFacade) {
+						return this;
+					} else {
+						return (tmp instanceof BaseObject) ? tmp.getInterface() : tmp;
+					}
+				};
+		}
+
+		// if there are no methods return
+		if (!aMethods) {
+			return {};
+		}
+
+		var sMethodName;
+
+		// create functions for all delegated methods
+		// PERFOPT: 'cache' length of aMethods to reduce # of resolutions
+		for (var i = 0, ml = aMethods.length; i < ml; i++) {
+			sMethodName = aMethods[i];
+			//!oObject[sMethodName] for 'lazy' loading interface methods ;-)
+			if (!oObject[sMethodName] || typeof oObject[sMethodName] === "function") {
+				this[sMethodName] = fCreateDelegator(oObject, sMethodName);
+			}
+		}
+	};
+
 	return BaseObject;
 
 }, /* bExport= */ true);

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.92.0
+	 * @version 1.95.0
 	 * @alias sap.ui.base.ObjectPool
 	 * @public
 	 */

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

@@ -100,7 +100,8 @@ sap.ui.define([], function() {
 						aArgs = [fnWrappedHandler, 0].concat(arguments);
 						_timeout.apply(window, aArgs);
 					} else {
-						fnHandler = typeof vHandler !== "function" ? new Function(vHandler) : vHandler; // eslint-disable-line no-new-func
+						// eslint-disable-next-line no-new-func
+						fnHandler = typeof vHandler !== "function" ? new Function(vHandler) : vHandler; // legacy-relevant
 						fnHandler.apply(window, arguments);
 					}
 				};

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

@@ -6,7 +6,7 @@
   <copyright>OpenUI5
  * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.</copyright>
-  <version>1.92.0</version>
+  <version>1.95.0</version>
 
   <documentation>The SAPUI5 Core Runtime.
 
@@ -112,7 +112,7 @@
         <raw-module name="sap/ui/thirdparty/URITemplate.js" depends="sap/ui/thirdparty/URI.js"/>
         <raw-module name="sap/ui/thirdparty/vkbeautify.js" />
         <raw-module name="sap/ui/thirdparty/zyngascroll.js" requiresTopLevelScope="false" />
-        <raw-module name="sap/ui/thirdparty/hyphenopoly/hyphenopoly.bundle.js" depends="sap/ui/thirdparty/hyphenopoly/hyphenEngine.asm.js" />
+        <raw-module name="sap/ui/thirdparty/hyphenopoly/Hyphenopoly.js" depends="sap/ui/thirdparty/hyphenopoly/hyphenEngine.asm.js" />
         <raw-module name="sap/ui/thirdparty/hyphenopoly/hyphenEngine.asm.js" requiresTopLevelScope="false" />
         <raw-module name="ui5loader.js" />
         <raw-module name="ui5loader-autoconfig.js" depends="ui5loader.js" />
@@ -235,7 +235,7 @@
         <exclude name="sap.ui.qunit." />
         <exclude name="sap.ui.thirdparty." />
         <exclude name="sap.ui.model.odata.datajs" /> <!-- legacy redirect, only part of internal core overlay -->
-        <exclude name="sap.ui.core.designtime.mvc.ControllerExtensionTemplate" /> <!-- template file with partially unexpected content --> 
+        <exclude name="sap.ui.core.designtime.mvc.ControllerExtensionTemplate" /> <!-- template file with partially unexpected content -->
     </jsdoc>
     <!-- excludes for the JSCoverage -->
     <jscoverage xmlns="http://www.sap.com/ui5/buildext/jscoverage" >
@@ -470,9 +470,9 @@
             <copyright>OpenJS Foundation and other contributors</copyright>
             <pattern>sap/ui/base/util/restricted/_/lodash.custom.js</pattern>
         </lib>
-        <lib name="hyphenopoly" displayName="Hyphenopoly" version="2.4.0" homepage="https://github.com/mnater/Hyphenopoly">
+        <lib name="hyphenopoly" displayName="Hyphenopoly" version="3.4.0" homepage="https://github.com/mnater/Hyphenopoly">
             <license url="https://github.com/mnater/Hyphenopoly/blob/master/LICENSE" type="MIT" />
-            <copyright>2018 Mathias Nater</copyright>
+            <copyright>2021 Mathias Nater</copyright>
             <pattern>sap/ui/thirdparty/hyphenopoly/*</pattern>
         </lib>
         <lib name="p-cancelable" displayName="p-cancelable" version="2.0.0" homepage="https://github.com/sindresorhus/p-cancelable/tree/v2.0.0">

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

@@ -16,10 +16,10 @@ sap.ui.define([
 	'sap/base/util/extend',
 	'sap/base/strings/escapeRegExp',
 	'sap/ui/thirdparty/jquery',
-	'sap/ui/core/IconPool',
+	'sap/ui/core/_IconRegistry',
 	'./Core' // provides sap.ui.getCore()
 ],
-	function(ManagedObject, URI, Log, extend, escapeRegExp, jQuery, IconPool/*, Core */) {
+	function(ManagedObject, URI, Log, extend, escapeRegExp, jQuery, _IconRegistry/*, Core */) {
 	"use strict";
 
 	/*
@@ -389,7 +389,7 @@ sap.ui.define([
 					return fnValidateProperty.apply(this, oArgs || arguments);
 				};
 
-				IconPool._convertUrl = function(sUrl) {
+				_IconRegistry._convertUrl = function(sUrl) {
 					return fnConvertUrl(sUrl);
 				};
 
@@ -446,7 +446,7 @@ sap.ui.define([
 				ManagedObject.prototype.validateProperty = fnValidateProperty;
 
 				// remove the function from IconPool
-				delete IconPool._convertUrl;
+				delete _IconRegistry._convertUrl;
 
 				// only remove xhr interception if xhr#open was not modified meanwhile
 				if (XMLHttpRequest.prototype.open === fnEnhancedXhrOpen) {

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.92.0
+	 * @version 1.95.0
 	 * @public
 	 * @alias sap.ui.core.BusyIndicator
 	 */
@@ -101,11 +101,6 @@ sap.ui.define([
 	 * @private
 	 */
 	BusyIndicator._init = function() {
-		// Create the graphics element
-		// inserts 2 divs:
-		// 1. an empty one which will contain the old indicator (used in goldreflection)
-		// 2. a div containing the new standard busy indicator (used in bluecrystal)
-
 		var oRootDomRef = document.createElement("div");
 		oRootDomRef.id = this.sDOM_ID;
 
@@ -125,13 +120,8 @@ sap.ui.define([
 		oBusyElement.setAttribute("title", sTitle);
 		oRootDomRef.appendChild(oBusyElement);
 
-		// Render into invisible area, so the size settings from CSS are applied
-		var oInvisible = sap.ui.getCore().getStaticAreaRef();
-		oInvisible.appendChild(oRootDomRef);
-
 		this.oDomRef = oRootDomRef;
 
-		//TODO how could this be destroyed? Who can/will destroy this?
 		this.oPopup = new Popup(oRootDomRef);
 		this.oPopup.setModal(true, "sapUiBlyBusy");
 		this.oPopup.setShadow(false);

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

@@ -14,7 +14,8 @@ sap.ui.define(['./BlockLayerUtils'], //require of sap/ui/core/library not possib
 	/**
 	 * @alias sap.ui.core.BusyIndicatorUtils
 	 * @namespace
-	 * @public
+	 * @private
+	 * @ui5-restricted sap.ui.core, sap.chart
 	 */
 	var BusyIndicatorUtils = function() {};
 
@@ -24,6 +25,8 @@ sap.ui.define(['./BlockLayerUtils'], //require of sap/ui/core/library not possib
 	 *
 	 * @param {string} sSize either "Large" or "Medium". Other sizes will be mapped to "Medium"
 	 * @returns {DOM.element} the element for the busy indicator
+	 * @private
+	 * @ui5-restricted sap.ui.core, sap.chart
 	 */
 	BusyIndicatorUtils.getElement = function(sSize) {
 		//default size is medium