@openui5/sap.ui.dt 1.96.2 → 1.97.0

package/.reuse/dep5

@@ -418,7 +418,7 @@ Comment: these files contain content from SAP and BooleanExpressionEvaluator: Bo
 
 # Library: sap.ui.webc.common:
 
-Files: src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/base/*.* src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/theme-base/*.* src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/localization/*.* src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/icons/*.* src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/icons-tnt/*.*
+Files: src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/base/*.* src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/theming/*.* src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/localization/*.* src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/icons/*.* src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/icons-tnt/*.* src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/icons-business-suite/*.*
 Copyright: SAP
 License: Apache-2.0
 Comment: these files belong to: UI5 Web Components

package/THIRDPARTY.txt

@@ -412,10 +412,11 @@ Copyright: SAP
 License: Apache-2.0
 License Text: https://github.com/SAP/openui5/blob/master/LICENSES/Apache-2.0.txt
 Contained in: src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/base/*.*
-	src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/theme-base/*.*
+	src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/theming/*.*
 	src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/localization/*.*
 	src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/icons/*.*
 	src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/icons-tnt/*.*
+	src/sap.ui.webc.common/src/sap/ui/webc/common/thirdparty/icons-business-suite/*.*
 
 Component: lit-html, version: 1.4.1
 Copyright: Google LLC

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openui5/sap.ui.dt",
-  "version": "1.96.2",
+  "version": "1.97.0",
   "description": "OpenUI5 UI Library sap.ui.dt",
   "author": "SAP SE (https://www.sap.com)",
   "license": "Apache-2.0",
@@ -14,6 +14,6 @@
     "url": "https://github.com/SAP/openui5.git"
   },
   "dependencies": {
-    "@openui5/sap.ui.core": "1.96.2"
+    "@openui5/sap.ui.core": "1.97.0"
   }
 }

package/src/sap/ui/dt/.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.96.2</version>
+  <version>1.97.0</version>
 
   <documentation>SAP UI library: sap.ui.dt (by SAP, Author)</documentation>
 

package/src/sap/ui/dt/AggregationDesignTimeMetadata.js

@@ -23,7 +23,7 @@ function (
 	 * @extends sap.ui.dt.DesignTimeMetadata
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/dt/AggregationOverlay.js

@@ -35,7 +35,7 @@ function(
 	 * @extends sap.ui.dt.Overlay
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/dt/ControlObserver.js

@@ -22,7 +22,7 @@ function(ManagedObjectObserver) {
 	 * @extends sap.ui.dt.ManagedObjectObserver
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/dt/DOMUtil.js

@@ -23,7 +23,7 @@ sap.ui.define([
 	 * Utility functionality for DOM
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @private
 	 * @static
@@ -173,8 +173,8 @@ sap.ui.define([
 
 	/**
 	 * Checks whether DOM Element has vertical or horizontal scrollbar
-	 * @param oDomRef {HTMLElement} - DOM Element
-	 * @returns {boolean}
+	 * @param {HTMLElement} oDomRef - DOM element
+	 * @returns {boolean} <code>true</code> if the DOM element has a scrollbar
 	 */
 	DOMUtil.hasScrollBar = function(oDomRef) {
 		return DOMUtil.hasVerticalScrollBar(oDomRef) || DOMUtil.hasHorizontalScrollBar(oDomRef);
@@ -217,7 +217,8 @@ sap.ui.define([
 
 
 	/**
-	 * @param {HTMLElement} oDomRef
+	 * @param {HTMLElement} oDomRef - DOM element
+	 * @returns {object} Object with overflowX and overflowY
 	 */
 	DOMUtil.getOverflows = function(oDomRef) {
 		var $DomRef = jQuery(oDomRef);
@@ -438,8 +439,8 @@ sap.ui.define([
 	/**
 	 * Check whether the target node is a descendant of a node referenced by id
 	 * @param {string} sId - ID of a potential parent node
-	 * @param oTargetNode - Node to look for in a potential parent node
-	 * @returns {boolean} - true if a potential parent contains the target node
+	 * @param {HTMLElement} oTargetNode - Node to look for in a potential parent node
+	 * @returns {boolean} <code>true</code> if a potential parent contains the target node
 	 */
 	DOMUtil.contains = function (sId, oTargetNode) {
 		var oNode = document.getElementById(sId);

package/src/sap/ui/dt/DesignTime.js

@@ -25,7 +25,9 @@ sap.ui.define([
 	"sap/ui/dt/SelectionMode",
 	"sap/base/util/includes",
 	"sap/ui/dt/DesignTimeStatus",
-	"sap/base/util/restricted/_curry"
+	"sap/base/util/restricted/_curry",
+	"sap/base/util/restricted/_difference",
+	"sap/base/util/isEmptyObject"
 ],
 function (
 	ManagedObject,
@@ -48,7 +50,9 @@ function (
 	SelectionMode,
 	includes,
 	DesignTimeStatus,
-	_curry
+	_curry,
+	_difference,
+	isEmptyObject
 ) {
 	"use strict";
 
@@ -64,7 +68,7 @@ function (
 	 * @extends sap.ui.base.ManagedObject
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @private
@@ -702,6 +706,7 @@ function (
 	 * @property {boolean} [root="true"] - Proxy for "isRoot" property of sap.ui.dt.ElementOverlay constructor
 	 * @property {object} [parentMetadata] - Map with metadata from the parent
 	 * @property {boolean} [visible] - Proxy for "visible" property of sap.ui.dt.ElementOverlay constructor
+	 * @property {boolean} [isTemplate] - Marker that overlay is part of template
 	 * @private
 	 */
 
@@ -747,7 +752,7 @@ function (
 			.then(
 				// Fulfilled
 				function (oElementOverlay) {
-					return this._createChildren(oElementOverlay, mParams.parentMetadata)
+					return this._createChildren(oElementOverlay, mParams)
 						.then(function () {
 							// Remove overlay promise from the map only when it is "officially" available
 							// and registered everywhere (OverlayRegistry, Plugins, etc)
@@ -929,24 +934,45 @@ function (
 	}
 
 	/**
-	 * Create children for specified ElementOverlay
+	 * Creates children for specified ElementOverlay.
 	 * @param {sap.ui.dt.ElementOverlay} oElementOverlay - ElementOverlay to create children for
-	 * @param {object} [mParentAggregationMetadata] - Since children are being created for certain aggregation, this is an aggregation metadata.
-	 * @returns {Promise} - resolves when whole hierarchy of children for specified ElementOverlay is created
+	 * @param {object} mParams - Property bag
+	 * @param {object} [mParams.parentMetadata] - Parent aggregation metadata
+	 * @param {boolean} [mParams.isTemplate] - Whether the overlay is part of an aggregation binding template
+	 * @returns {Promise} Resolves when whole hierarchy of children for specified ElementOverlay is created
 	 * @private
 	 */
-	DesignTime.prototype._createChildren = function (oElementOverlay, mParentAggregationMetadata) {
+	DesignTime.prototype._createChildren = function (oElementOverlay, mParams) {
 		var aAggregationNames = oElementOverlay.getAggregationNames();
+		var mParentAggregationMetadata = mParams.parentMetadata;
 		var mAggregationBindingTemplates = getAggregationBindingTemplates(oElementOverlay, aAggregationNames);
 		var aTemplateAggregationNames = Object.keys(mAggregationBindingTemplates);
-		return Promise.all([
-			this._createChildrenOverlays(oElementOverlay, mParentAggregationMetadata, aTemplateAggregationNames, mAggregationBindingTemplates),
-			this._createChildrenOverlays(oElementOverlay, mParentAggregationMetadata, aAggregationNames)
-		]);
+
+		// Consider each aggregation binding template which is not nested inside an existing template structure as a root template
+		// Separate root templates and their children from the instances of the root template as well as all nested template instances
+		var bEncounteredTemplate = mParams.isTemplate !== undefined;
+		var bHasTemplateAggregation = !isEmptyObject(mAggregationBindingTemplates);
+		var bIsRootTemplate = bHasTemplateAggregation && !bEncounteredTemplate;
+		var bIsTemplate = bIsRootTemplate ? true : mParams.isTemplate;
+		// Whether cloned instances are nested deeply in the root template structure
+		var bIsCloneInsideTemplate = bIsRootTemplate ? false : mParams.isTemplate;
+
+		// Avoid creating aggregation overlays for cloned template instances inside the template structure
+		if (bHasTemplateAggregation && bIsTemplate && !bIsRootTemplate) {
+			aAggregationNames = _difference(aAggregationNames, aTemplateAggregationNames);
+		}
+
+		return this._createChildrenOverlays(oElementOverlay, mParentAggregationMetadata, aTemplateAggregationNames, bIsTemplate, mAggregationBindingTemplates)
+			.then(this._createChildrenOverlays.bind(this, oElementOverlay, mParentAggregationMetadata, aAggregationNames, bIsCloneInsideTemplate));
 	};
 
-	DesignTime.prototype._createChildrenOverlays = function (oElementOverlay, mParentAggregationMetadata, aAggregationNames, mAggregationBindingTemplates) {
-		var bIsTemplateAggregation = !!mAggregationBindingTemplates;
+	DesignTime.prototype._createChildrenOverlays = function (oElementOverlay, mParentAggregationMetadata, aAggregationNames, bIsTemplate, mAggregationBindingTemplates) {
+		var bIsTemplateAggregation = !isEmptyObject(mAggregationBindingTemplates);
+		// Nested template inside a clone of another template
+		if (bIsTemplateAggregation && !bIsTemplate) {
+			return Promise.resolve();
+		}
+
 		return Promise.all(
 			aAggregationNames.map(function (sAggregationName) {
 				var oElement = oElementOverlay.getElement();
@@ -975,7 +1001,8 @@ function (
 						return this.createOverlay({
 							element: oElement,
 							root: false,
-							parentMetadata: mAggregationMetadata
+							parentMetadata: mAggregationMetadata,
+							isTemplate: bIsTemplate
 						})
 							// If creation of one of the children is aborted, we still continue our execution
 							.catch(function (oError) {
@@ -989,6 +1016,7 @@ function (
 						if (
 							oChildElementOverlay instanceof ElementOverlay
 							&& !oChildElementOverlay.bIsDestroyed
+							&& !oChildElementOverlay.getParent()
 						) {
 							oAggregationOverlay.addChild(oChildElementOverlay, true);
 						}

package/src/sap/ui/dt/DesignTimeMetadata.js

@@ -46,7 +46,7 @@ function(
 	 * @extends sap.ui.base.ManagedObject
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/dt/ElementDesignTimeMetadata.js

@@ -9,8 +9,7 @@ sap.ui.define([
 	"sap/ui/dt/DesignTimeMetadata",
 	"sap/ui/dt/AggregationDesignTimeMetadata",
 	"sap/ui/dt/ElementUtil"
-],
-function(
+], function(
 	DesignTimeMetadata,
 	AggregationDesignTimeMetadata,
 	ElementUtil
@@ -28,7 +27,7 @@ function(
 	 * @extends sap.ui.dt.DesignTimeMetadata
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @private
@@ -252,6 +251,9 @@ function(
 	/**
 	 * Returns the scroll containers or an empty array
 	 *
+	 * @param {object} oElement - Element
+	 * @param {boolean} bInvalidate - Indicates if the scroll container should be invalidated first
+	 * @param {function} fnUpdateFunction - Function to be called for update
 	 * @return {array} scrollContainers or empty array
 	 * @public
 	 */

package/src/sap/ui/dt/ElementOverlay.js

@@ -55,7 +55,7 @@ sap.ui.define([
 	 * @extends sap.ui.dt.Overlay
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @private
@@ -421,6 +421,7 @@ sap.ui.define([
 
 	/**
 	 * Sorts children DOM Nodes in their visual order
+	 * @param {object} oContainer - Container object whose children should be sorted
 	 * @private
 	 */
 	ElementOverlay.prototype._sortChildren = function(oContainer) {
@@ -573,7 +574,8 @@ sap.ui.define([
 
 	/**
 	 * Gets information about scroll containers from DesignTime metadata
-	 * @returns {object[]} - returns an array with scroll containers description
+	 * @param {boolean} bInvalidate - Indicates if the scroll container should be invalidated first
+	 * @returns {object[]} Array with the scroll container's description
 	 */
 	ElementOverlay.prototype.getScrollContainers = function (bInvalidate) {
 		return this.getDesignTimeMetadata().getScrollContainers(this.getElement(), bInvalidate, this._updateScrollContainer.bind(this));

package/src/sap/ui/dt/ElementUtil.js

@@ -14,8 +14,7 @@ sap.ui.define([
 	"sap/ui/core/Component",
 	"sap/base/util/isPlainObject",
 	"sap/ui/core/UIArea"
-],
-function(
+], function(
 	jQuery,
 	BaseObject,
 	Util,
@@ -33,7 +32,7 @@ function(
 	 * @class Utility functionality to work with elements, e.g. iterate through aggregations, find parents, ...
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @private
 	 * @static
@@ -57,9 +56,6 @@ function(
 		}, this);
 	};
 
-	/**
-	 *
-	 */
 	ElementUtil.getElementInstance = function(vElement) {
 		if (typeof vElement === "string") {
 			var oElement = sap.ui.getCore().byId(vElement);
@@ -68,9 +64,6 @@ function(
 		return vElement;
 	};
 
-	/**
-	 *
-	 */
 	ElementUtil.hasAncestor = function(oElement, oAncestor) {
 		oAncestor = this.fixComponentContainerElement(oAncestor);
 		var oFixedParent;
@@ -88,17 +81,11 @@ function(
 		return !!oElement;
 	};
 
-	/**
-	 *
-	 */
 	ElementUtil.getClosestElementForNode = function(oNode) {
 		var $ClosestElement = jQuery(oNode).closest("[data-sap-ui]");
 		return $ClosestElement.length ? sap.ui.getCore().byId($ClosestElement.attr("data-sap-ui")) : undefined;
 	};
 
-	/**
-	 *
-	 */
 	ElementUtil.fixComponentParent = function(oElement) {
 		if (BaseObject.isA(oElement, "sap.ui.core.UIComponent")) {
 			var oComponentContainer = oElement.oContainer;
@@ -110,9 +97,6 @@ function(
 		}
 	};
 
-	/**
-	 *
-	 */
 	ElementUtil.fixComponentContainerElement = function(oElement) {
 		if (BaseObject.isA(oElement, "sap.ui.core.ComponentContainer")) {
 			// This happens when the compontentContainer has not been rendered yet
@@ -124,9 +108,6 @@ function(
 		return oElement;
 	};
 
-	/**
-	 *
-	 */
 	ElementUtil.getDomRef = function(oElement) {
 		if (oElement) {
 			var oDomRef;
@@ -140,9 +121,6 @@ function(
 		}
 	};
 
-	/**
-	 *
-	 */
 	ElementUtil.findAllSiblingsInContainer = function(oElement, oContainer) {
 		var oParent = oElement && oElement.getParent();
 		if (!oParent) {
@@ -211,9 +189,6 @@ function(
 		return this.getAggregation(oParent, sAggregationName).indexOf(oElement);
 	};
 
-	/**
-	 *
-	 */
 	ElementUtil.addAggregation = function(oParent, sAggregationName, oElement) {
 		if (this.hasAncestor(oParent, oElement)) {
 			throw new Error("Trying to add an element to itself or its successors");
@@ -226,9 +201,6 @@ function(
 		}
 	};
 
-	/**
-	 *
-	 */
 	ElementUtil.removeAggregation = function(oParent, sAggregationName, oElement, bSuppressInvalidate) {
 		var sAggregationRemoveMutator = this.getAggregationAccessors(oParent, sAggregationName).remove;
 		if (sAggregationRemoveMutator) {
@@ -238,9 +210,6 @@ function(
 		}
 	};
 
-	/**
-	 *
-	 */
 	ElementUtil.insertAggregation = function(oParent, sAggregationName, oElement, iIndex) {
 		if (this.hasAncestor(oParent, oElement)) {
 			throw new Error("Trying to add an element to itself or its successors");
@@ -265,9 +234,6 @@ function(
 		}
 	};
 
-	/**
-	 *
-	 */
 	ElementUtil.isValidForAggregation = function(oParent, sAggregationName, oElement) {
 		var oAggregationMetadata = oParent.getMetadata().getAggregation(sAggregationName);
 
@@ -329,9 +295,6 @@ function(
 			}, this);
 	};
 
-	/**
-	 *
-	 */
 	ElementUtil.hasInterface = function(oElement, sInterface) {
 		var aInterfaces = oElement.getMetadata().getInterfaces();
 		return aInterfaces.indexOf(sInterface) !== -1;

package/src/sap/ui/dt/ManagedObjectObserver.js

@@ -25,7 +25,7 @@ sap.ui.define([
 	 * @class The ManagedObjectObserver observes changes of a ManagedObject and propagates them via events.
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 * @constructor
 	 * @private
 	 * @since 1.30
@@ -588,6 +588,7 @@ sap.ui.define([
 	/**
 	 * Stops observing the target object. Override this method in classes which extend ManagedObjectObserver.
 	 *
+	 * @param {object} oTarget - Target object
 	 * @protected
 	 */
 	ManagedObjectObserver.prototype.unobserve = function(oTarget) {

package/src/sap/ui/dt/MetadataPropagationUtil.js

@@ -9,8 +9,7 @@ sap.ui.define([
 	"sap/ui/dt/Util",
 	"sap/base/util/merge",
 	"sap/base/util/isEmptyObject"
-],
-function(
+], function(
 	Util,
 	merge,
 	isEmptyObject
@@ -22,7 +21,7 @@ function(
 	 *
 	 * @class Functionality to propagate DesignTime and RelevantContainer
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 * @private
 	 * @static
 	 * @since 1.54
@@ -99,9 +98,10 @@ function(
 	 * Extend the passed aggregationOverlay metadata with propagated aggregationOverlay metadata from parent
 	 * and metadata to propagte from passed elementOverlay metadata.
 	 *
-	 * @param {object} mOriginalMetadata - aggregation designtime metadata data map to be extended with propagation data
-	 * @param {sap.ui.core.Element} oElement - element may be used as relevant container
-	 * @return {object} Returns extended data part of the element designtime metadata.
+	 * @param {object} mOriginalMetadata - Aggregation design time metadata data map to be extended with propagation data
+	 * @param {sap.ui.core.Element} oElement - Element may be used as relevant container
+	 * @param {object} mParentAggregationMetadata - Aggregation design time metadata of the parent
+	 * @return {object} Extended data part of the element design time metadata.
 	 */
 	MetadataPropagationUtil.propagateMetadataToAggregationOverlay = function(mOriginalMetadata, oElement, mParentAggregationMetadata) {
 		var mNewPropagationInfo;

package/src/sap/ui/dt/MutationObserver.js

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * @class The MutationObserver observes changes of a ManagedObject and propagates them via events.
 	 * @extends sap.ui.base.ManagedObject
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 * @constructor
 	 * @private
 	 * @since 1.30

package/src/sap/ui/dt/Overlay.js

@@ -4,7 +4,6 @@
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
-/* global Map */
 sap.ui.define([
 	"sap/ui/thirdparty/jquery",
 	"sap/ui/core/Element",
@@ -16,8 +15,7 @@ sap.ui.define([
 	"sap/ui/dt/Util",
 	"sap/base/Log",
 	"sap/ui/dt/util/ZIndexManager"
-],
-function (
+], function (
 	jQuery,
 	Element,
 	MutationObserver,
@@ -46,7 +44,7 @@ function (
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @constructor
 	 * @private
@@ -312,6 +310,7 @@ function (
 
 	/**
 	 * Creates and/or returns mutation observer instance
+	 * @returns {object} Mutation observer
 	 * @static
 	 */
 	Overlay.getMutationObserver = function() {
@@ -342,7 +341,7 @@ function (
 
 	/**
 	 * Returns set of attributes for DOM Node of overlay
-	 * @returns {{id: string, "data-sap-ui": string, class: string, tabindex: *}}
+	 * @returns {{id: string, "data-sap-ui": string, class: string, tabindex: *}} Object with attributes
 	 * @protected
 	 */
 	Overlay.prototype._getAttributes = function () {
@@ -539,7 +538,6 @@ function (
 	/**
 	 * Sets whether the overlay can get the browser focus (tabindex)
 	 * @param {boolean} bFocusable - true if the overlay is focusable
-	 * @returns {sap.ui.dt.Overlay} returns this
 	 * @public
 	 */
 	Overlay.prototype.setFocusable = function(bFocusable) {
@@ -562,7 +560,7 @@ function (
 
 	/**
 	 * Returns valuable parent node that has dimensions and certain position.
-	 * @returns {jQuery|null}
+	 * @returns {jQuery|null} Parent jQuery object or null, if there is none
 	 * @protected
 	 */
 	Overlay.prototype._getRenderingParent = function () {
@@ -574,6 +572,7 @@ function (
 	 * The calculation is based on original associated DOM state and parent overlays
 	 * This method also calls "applyStyles" method for every child Overlay of this Overlay (cascade)
 	 * @param {boolean} bForceScrollbarSync - `true` to force a scrollbars synchronisation if there are any
+	 * @returns {Promise} Resolves as soon as <code>applyStyles</code> is done
 	 * @public
 	 */
 	Overlay.prototype.applyStyles = function (bForceScrollbarSync) {
@@ -660,7 +659,7 @@ function (
 	 * then ZIndexManager is used to calculate a z-index value lower than open popups and higher than other controls.
 	 * @see sap.ui.core.util.ZIndexManager
 	 * @param {object} oGeometry - Geometry object to get reference z-index from
-	 * @param {jQuery} $overlayDomRef - DOM Element to receive the z-index
+	 * @param {jQuery} $overlayDomRef - DOM element to receive the z-index
 	 */
 	Overlay.prototype._setZIndex = function (oGeometry, $overlayDomRef) {
 		var oOriginalDomRef = oGeometry.domRef;
@@ -675,7 +674,7 @@ function (
 
 	/**
 	 * Sets size to specified DOM Element
-	 * @param {jQuery} $Target - DOM Element which will receive new size
+	 * @param {jQuery} $Target - DOM element which will receive new size
 	 * @param {object} oGeometry - Geometry object to get new dimensions from
 	 * @protected
 	 */
@@ -691,8 +690,8 @@ function (
 	};
 
 	/**
-	 * Sets position of specified DOM Element
-	 * @param {jQuery} $Target - DOM Element which will receive new position
+	 * Sets position of specified DOM element
+	 * @param {jQuery} $Target - DOM element which will receive new position
 	 * @param {object} oGeometry - Geometry object to get positioning from
 	 * @param {jQuery} $Parent - Offset element for position calculation
 	 * @protected
@@ -735,9 +734,10 @@ function (
 	 * Note: listeners are only removed, if the same combination of event type, callback function
 	 * and context object is given as in the call to <code>attachBrowserEvent</code>.
 	 *
-	 * @param {string} [sEventType] A string containing one or more JavaScript event types, such as "click" or "blur".
-	 * @param {function} [fnHandler] The function that is to be no longer executed.
-	 * @param {object} [oListener] The context object that was given in the call to <code>attachBrowserEvent</code>.
+	 * @param {string} [sEventType] - String containing one or more JavaScript event types, such as "click" or "blur".
+	 * @param {function} [fnHandler] - Function that is to be no longer executed.
+	 * @param {object} [oListener] - Context object that was given in the call to <code>attachBrowserEvent</code>.
+	 * @returns {sap.ui.dt.Overlay} <code>this</code> object
 	 * @public
 	 */
 	Overlay.prototype.detachBrowserEvent = function(sEventType, fnHandler, oListener) {
@@ -767,8 +767,7 @@ function (
 	/**
 	 * Cleans up when scrolling is no longer needed in the overlay
 	 * @param {jQuery} $TargetDomRef - DOM reference to the element where dummy container is located
-	 * @param {sap.ui.dt.ElementOverlay} [oTargetOverlay]
-	 *        Overlay which holds scrollbar padding via CSS classes. In case of root overlay, the target is undefined.
+	 * @param {sap.ui.dt.ElementOverlay} [oTargetOverlay] - Overlay which holds scrollbar padding via CSS classes. In case of root overlay, the target is undefined.
 	 *
 	 * @private
 	 */
@@ -866,6 +865,7 @@ function (
 	 * The geometry is calculated based on the associated element's DOM reference, if it exists or based on it's public children
 	 * Object may contain following fields: position - absolute position of Element in DOM; size - absolute size of Element in DOM
 	 * Object may contain domRef field, when the associated Element's DOM can be found
+	 * @param {boolean} bForceCalculation - Forces the recalculation of the geometry
 	 * @return {object} geometry object describing the DOM of the Element associated with this Overlay
 	 * @public
 	 */
@@ -900,7 +900,6 @@ function (
 	/**
 	 * Sets whether the Overlay is visible
 	 * @param {boolean} bVisible if the Overlay is visible
-	 * @returns {sap.ui.dt.Overlay} returns this
 	 * @public
 	 */
 	Overlay.prototype.setVisible = function(bVisible) {

package/src/sap/ui/dt/OverlayRegistry.js

@@ -25,7 +25,7 @@ function(
 	 * Static registry for Overlays
 	 *
 	 * @author SAP SE
-	 * @version 1.96.2
+	 * @version 1.97.0
 	 *
 	 * @private
 	 * @static
@@ -64,8 +64,7 @@ function(
 
 	/**
 	 * Registers an overlay for the element or element's id
-	 * @param {string|sap.ui.core.Element} vElementOrId element instance or id
-	 * @param {sap.ui.dt.Overlay} oOverlay overlay to register
+	 * @param {sap.ui.dt.Overlay} oOverlay - Overlay to register
 	 * @public
 	 */
 	OverlayRegistry.register = function(oOverlay) {