@openui5/sap.ui.dt 1.96.1 → 1.97.1

package/src/sap/ui/dt/enablement/report/TableRenderer.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -10,7 +10,7 @@ sap.ui.define(function() {
 
 	/**
 	 * @author SAP SE
-	 * @version 1.96.1
+	 * @version 1.97.1
 	 * @namespace
 	 */
 	var TableRenderer = {};

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

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -23,7 +23,7 @@ function (
 	 * @namespace
 	 * @name sap.ui.dt
 	 * @author SAP SE
-	 * @version 1.96.1
+	 * @version 1.97.1
 	 * @since 1.30
 	 * @experimental This class is experimental and provides only limited functionality. Also the API might be changed in future.
 	 * @private
@@ -32,7 +32,7 @@ function (
 	// delegate further initialization of this library to the Core
 	sap.ui.getCore().initLibrary({
 		name: "sap.ui.dt",
-		version: "1.96.1",
+		version: "1.97.1",
 		dependencies: ["sap.ui.core"],
 		types: [
 			"sap.ui.dt.SelectionMode"

package/src/sap/ui/dt/plugin/ContextMenu.js

@@ -1,6 +1,6 @@
 /*
  * ! OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([
@@ -34,7 +34,7 @@ sap.ui.define([
 	 * @class The ContextMenu registers event handler to open the context menu. Menu entries can dynamically be added
 	 * @extends sap.ui.dt.Plugin
 	 * @author SAP SE
-	 * @version 1.96.1
+	 * @version 1.97.1
 	 * @constructor
 	 * @private
 	 * @since 1.53
@@ -94,11 +94,13 @@ sap.ui.define([
 	 * @param {function} mMenuItem.enabled? function to determine if the menu entry should be enabled, the element for which the menu should be opened
 	 *        is passed, default true
 	 * @param {boolean} bRetrievedFromPlugin flag to mark if a menu item was retrieved from a plugin (in runtime)
+	 * @param {boolean} bPersistOneTime flag to mark that the Button persist the next Menu clearing
 	 */
-	ContextMenu.prototype.addMenuItem = function (mMenuItem, bRetrievedFromPlugin) {
+	ContextMenu.prototype.addMenuItem = function (mMenuItem, bRetrievedFromPlugin, bPersistOneTime) {
 		var mMenuItemEntry = {
 			menuItem: mMenuItem,
-			fromPlugin: !!bRetrievedFromPlugin
+			fromPlugin: !!bRetrievedFromPlugin,
+			bPersistOneTime: bPersistOneTime
 		};
 		this._aMenuItems.push(mMenuItemEntry);
 	};
@@ -134,11 +136,13 @@ sap.ui.define([
 
 	/**
 	 * Opens the Context Menu
-	 * @param {sap.ui.dt.Overlay} oOverlay overlay object
-	 * @param {boolean} bContextMenu whether the control should be opened as a context menu
-	 * @param {boolean} bIsSubMenu whether the new ContextMenu is a SubMenu opened by a menu item inside another ContextMenu
+	 * @param {sap.ui.dt.Overlay} oOverlay - Overlay object
+	 * @param {boolean} bContextMenu - Whether the control should be opened as a context menu
+	 * @param {boolean} bIsSubMenu - Whether the new ContextMenu is a SubMenu opened by a menu item inside another ContextMenu
+	 * @param {object} oEvent - Click event of the menu
 	 */
 	ContextMenu.prototype.open = function (oOverlay, bContextMenu, bIsSubMenu, oEvent) {
+		var aSelectedOverlays;
 		function addMenuItems(oMenu, aMenuItems) {
 			aMenuItems.forEach(function(oMenuItem, index) {
 				var sText = typeof oMenuItem.text === "function" ? oMenuItem.text(oOverlay) : oMenuItem.text;
@@ -161,7 +165,6 @@ sap.ui.define([
 			});
 		}
 
-		this._aMenuItems = [];
 		this._bContextMenu = !!bContextMenu;
 		if (this._bContextMenu) {
 			this.oContextMenuControl.removeStyleClass(miniMenuStyleClass);
@@ -182,12 +185,21 @@ sap.ui.define([
 		this.setContextElement(oNewContextElement);
 		this.getDesignTime().getSelectionManager().attachChange(this._onSelectionChanged, this);
 
-		var aSelectedOverlays = this.getSelectedOverlays().filter(function (oElementOverlay) {
+		aSelectedOverlays = this.getSelectedOverlays().filter(function (oElementOverlay) {
 			return oElementOverlay !== oOverlay;
 		});
 		aSelectedOverlays.unshift(oOverlay);
 
-		//Remove all previous entries retrieved by plugins (the list should always be rebuilt)
+		// Keep all persisted menu items
+		this._aMenuItems = this._aMenuItems.filter(function (mMenuItemEntry) {
+			if (mMenuItemEntry.bPersistOneTime) {
+				mMenuItemEntry.bPersistOneTime = false;
+				return true;
+			}
+			return !mMenuItemEntry.fromPlugin;
+		});
+
+		// Remove all previous entries retrieved by plugins (the list should always be rebuilt)
 		this.oContextMenuControl.destroyItems();
 
 		var oPromise = Promise.resolve();

package/src/sap/ui/dt/plugin/ControlDragDrop.js

@@ -1,6 +1,6 @@
 /*
  * ! OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -26,7 +26,7 @@ sap.ui.define([
 	 * @class The ControlDragDrop enables D&D functionality for the overlays based on aggregation types
 	 * @extends sap.ui.dt.plugin.DragDrop
 	 * @author SAP SE
-	 * @version 1.96.1
+	 * @version 1.97.1
 	 * @constructor
 	 * @private
 	 * @since 1.30

package/src/sap/ui/dt/plugin/CutPaste.js

@@ -1,6 +1,6 @@
 /*
  * ! OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -33,7 +33,7 @@ sap.ui.define([
 	 * @class The CutPaste enables Cut & Paste functionality for the overlays based on aggregation types
 	 * @extends sap.ui.dt.Plugin
 	 * @author SAP SE
-	 * @version 1.96.1
+	 * @version 1.97.1
 	 * @constructor
 	 * @private
 	 * @since 1.34

package/src/sap/ui/dt/plugin/DragDrop.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -12,8 +12,7 @@ sap.ui.define([
 	"sap/ui/dt/OverlayRegistry",
 	"sap/ui/thirdparty/jquery",
 	"sap/ui/Device"
-],
-function(
+], function(
 	BaseObject,
 	Plugin,
 	DOMUtil,
@@ -37,7 +36,7 @@ function(
 	 * @extends sap.ui.dt.Plugin
 	 *
 	 * @author SAP SE
-	 * @version 1.96.1
+	 * @version 1.97.1
 	 *
 	 * @constructor
 	 * @private
@@ -101,7 +100,7 @@ function(
 
 	/**
 	 * @override
-	 * @param {sap.ui.dt.Overlay} an Overlay which should be registered
+	 * @param {sap.ui.dt.Overlay} oOverlay - Overlay which should be registered
 	 */
 	DragDrop.prototype.registerElementOverlay = function(oOverlay) {
 		// this._checkMovable(oOverlay);
@@ -155,7 +154,7 @@ function(
 
 	/**
 	 * @private
-	 * @param {sap.ui.dt.Overlay} an Overlay to attach events to
+	 * @param {sap.ui.dt.Overlay} oOverlay - Overlay to attach events to
 	 */
 	DragDrop.prototype._attachDragEvents = function(oOverlay) {
 		oOverlay.attachBrowserEvent("dragstart", this._onDragStart, this);
@@ -166,7 +165,7 @@ function(
 
 	/**
 	 * @private
-	 * @param {sap.ui.dt.Overlay} an Overlay to detach events from
+	 * @param {sap.ui.dt.Overlay} oOverlay - Overlay to detach events from
 	 */
 	DragDrop.prototype._detachDragEvents = function(oOverlay) {
 		oOverlay.detachBrowserEvent("dragstart", this._onDragStart, this);
@@ -176,70 +175,70 @@ function(
 	};
 
 	/**
-	 * @param {sap.ui.dt.Overlay} oOverlay overlay instance
+	 * @param {sap.ui.dt.Overlay} oOverlay - Overlay instance
 	 * @protected
 	 */
 	DragDrop.prototype.onMovableChange = function() { };
 
 	/**
-	 * @param {sap.ui.dt.Overlay} oDraggedOverlay dragged overlay instance
+	 * @param {sap.ui.dt.Overlay} oDraggedOverlay - Dragged overlay instance
 	 * @protected
 	 */
 	DragDrop.prototype.onDragStart = function() { };
 
 	/**
-	 * @param {sap.ui.dt.Overlay} oDraggedOverlay dragged overlay instance
+	 * @param {sap.ui.dt.Overlay} oDraggedOverlay - Dragged overlay instance
 	 * @protected
 	 */
 	DragDrop.prototype.onDragEnd = function() { };
 
 	/**
-	 * @param {sap.ui.dt.Overlay} oDraggedOverlay dragged overlay instance
+	 * @param {sap.ui.dt.Overlay} oDraggedOverlay - Dragged overlay instance
 	 * @protected
 	 */
 	DragDrop.prototype.onDrag = function() { };
 
 	/**
-	 * @param {sap.ui.dt.Overlay} oOverlay overlay instance
+	 * @param {sap.ui.dt.Overlay} oOverlay - Overlay instance
 	 * @return {boolean} return true to omit event.preventDefault
 	 * @protected
 	 */
 	DragDrop.prototype.onDragEnter = function() { };
 
 	/**
-	 * @param {sap.ui.dt.Overlay} oOverlay overlay instance
+	 * @param {sap.ui.dt.Overlay} oOverlay - Overlay instance
 	 * @return {boolean} return true to omit event.preventDefault
 	 * @protected
 	 */
 	DragDrop.prototype.onDragLeave = function() { };
 
 	/**
-	 * @param {sap.ui.dt.Overlay} oOverlay overlay instance
+	 * @param {sap.ui.dt.Overlay} oOverlay - Overlay instance
 	 * @return {boolean} return true to omit event.preventDefault
 	 * @protected
 	 */
 	DragDrop.prototype.onDragOver = function() { };
 
 	/**
-	 * @param {sap.ui.dt.AggregationOverlay} oAggregationOverlay aggregation overlay instance
+	 * @param {sap.ui.dt.AggregationOverlay} oAggregationOverlay - Aggregation overlay instance
 	 * @protected
 	 */
 	DragDrop.prototype.onAggregationDragEnter = function() { };
 
 	/**
-	 * @param {sap.ui.dt.AggregationOverlay} oAggregationOverlay aggregation overlay instance
+	 * @param {sap.ui.dt.AggregationOverlay} oAggregationOverlay - Aggregation overlay instance
 	 * @protected
 	 */
 	DragDrop.prototype.onAggregationDragOver = function() { };
 
 	/**
-	 * @param {sap.ui.dt.AggregationOverlay} oAggregationOverlay aggregation overlay instance
+	 * @param {sap.ui.dt.AggregationOverlay} oAggregationOverlay - Aggregation overlay instance
 	 * @protected
 	 */
 	DragDrop.prototype.onAggregationDragLeave = function() { };
 
 	/**
-	 * @param {sap.ui.dt.AggregationOverlay} oAggregationOverlay aggregation overlay instance
+	 * @param {sap.ui.dt.AggregationOverlay} oAggregationOverlay - Aggregation overlay instance
 	 * @protected
 	 */
 	DragDrop.prototype.onAggregationDrop = function() { };
@@ -471,6 +470,8 @@ function(
 	};
 
 	/**
+	 * @param {sap.ui.dt.Overlay} oOverlay - Overlay instance
+	 * @returns {object} jQuery ghost object
 	 * @protected
 	 */
 	DragDrop.prototype.createGhost = function(oOverlay) {
@@ -512,7 +513,7 @@ function(
 
 	/**
 	 * @protected
-	 * @return {jQuery} jQuery object drag ghost
+	 * @return {jQuery} jQuery ghost object
 	 */
 	DragDrop.prototype.getGhost = function() {
 		return this._$ghost;

package/src/sap/ui/dt/plugin/ElementMover.js

@@ -1,6 +1,6 @@
 /*
  * ! OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -30,7 +30,7 @@ sap.ui.define([
 	 * @class The ElementMover enables movement of UI5 elements based on aggregation types, which can be used by drag and
 	 *        drop or cut and paste behavior.
 	 * @author SAP SE
-	 * @version 1.96.1
+	 * @version 1.97.1
 	 * @constructor
 	 * @private
 	 * @since 1.34
@@ -64,8 +64,9 @@ sap.ui.define([
 
 	/**
 	 * Predicate to compute movability of a type
+	 * @param {object} oElement - Element to be checked
+	 * @returns {boolean} <code>true</code> if type is movable, <code>false</code> otherwise
 	 * @public
-	 * @return true if type is movable, false otherwise
 	 */
 	ElementMover.prototype.isMovableType = function(oElement) {
 		var aMovableTypes = this._getMovableTypes();

package/src/sap/ui/dt/plugin/MouseSelection.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -22,7 +22,7 @@ function(Plugin) {
 	 * @extends sap.ui.dt.Plugin
 	 *
 	 * @author SAP SE
-	 * @version 1.96.1
+	 * @version 1.97.1
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/dt/plugin/TabHandling.js

@@ -1,6 +1,6 @@
 /*
  * ! OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -27,7 +27,7 @@ sap.ui.define([
 	 * @class The TabHandling plugin adjusts the tabindex for the elements.
 	 * @extends sap.ui.dt.Plugin
 	 * @author SAP SE
-	 * @version 1.96.1
+	 * @version 1.97.1
 	 * @constructor
 	 * @private
 	 * @since 1.38

package/src/sap/ui/dt/plugin/ToolHooks.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -16,7 +16,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.dt.Plugin
 	 * @author SAP SE
-	 * @version 1.96.1
+	 * @version 1.97.1
 	 * @constructor
 	 * @private
 	 * @since 1.61

package/src/sap/ui/dt/themes/base/library.source.less

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/dt/themes/sap_hcb/library.source.less

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 

package/src/sap/ui/dt/util/ZIndexManager.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -30,7 +30,7 @@ sap.ui.define([
 	 *
 	 * @class
 	 * @author SAP SE
-	 * @version 1.96.1
+	 * @version 1.97.1
 	 *
 	 * @private
 	 * @static

package/src/sap/ui/dt/util/_createPromise.js

@@ -1,16 +1,18 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define(function () {
 	"use strict";
 
 	/**
-	* @function
-	* @experimental
-	* @private
-	*/
+	 * @function
+	 * @experimental
+	 * @param {function} fn - Function that should be wrapped in a promise
+	 * @returns {object} Cancelable Promise
+	 * @private
+	 */
 	return function (fn) {
 		var bCancelled = false;
 		var oCancelPromise;