@openui5/sap.m 1.136.3 → 1.139.0

package/src/sap/m/DialogRenderer.js

@@ -112,7 +112,7 @@ sap.ui.define([
 		}
 
 		oRM.accessibilityState(oDialog, {
-			role: sRole,
+			role: sRole.toLowerCase(),
 			modal: true
 		});
 
@@ -178,7 +178,9 @@ sap.ui.define([
 			oRM.openStart("header")
 				.openEnd();
 			if (oHeader) {
-				oHeader._applyContextClassFor("header");
+				if (oHeader._applyContextClassFor) {
+					oHeader._applyContextClassFor("header");
+				}
 				oRM.openStart("div")
 					.class("sapMDialogTitleGroup");
 
@@ -198,7 +200,9 @@ sap.ui.define([
 			}
 
 			if (oSubHeader && oSubHeader.getVisible()) {
-				oSubHeader._applyContextClassFor("subheader");
+				if (oSubHeader._applyContextClassFor) {
+					oSubHeader._applyContextClassFor("subheader");
+				}
 				oRM.openStart("div")
 					.class("sapMDialogSubHeader")
 					.openEnd()
@@ -241,10 +245,14 @@ sap.ui.define([
 				.class("sapMDialogFooter")
 				.openEnd();
 			if (oFooter) {
-				oFooter._applyContextClassFor("footer");
+				if (oFooter._applyContextClassFor) {
+					oFooter._applyContextClassFor("footer");
+				}
 				oRM.renderControl(oFooter);
 			} else {
-				oDialog._oToolbar._applyContextClassFor("footer");
+				if (oDialog._oToolbar._applyContextClassFor) {
+					oDialog._oToolbar._applyContextClassFor("footer");
+				}
 				oRM.renderControl(oDialog._oToolbar);
 			}
 			oRM.close("footer");
@@ -276,4 +284,4 @@ sap.ui.define([
 	};
 
 	return DialogRenderer;
-}, /* bExport= */ true);
+}, /* bExport= */ true);

package/src/sap/m/DisplayListItem.js

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * @extends sap.m.ListItemBase
 	 *
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/DraftIndicator.js

@@ -27,7 +27,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/DynamicDate.js

@@ -40,7 +40,7 @@ sap.ui.define([
 		 * @extends sap.ui.model.SimpleType
 		 *
 		 * @author SAP SE
-		 * @version 1.136.3
+		 * @version 1.139.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/DynamicDateOption.js

@@ -44,7 +44,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Element
 		 *
 		 * @author SAP SE
-		 * @version 1.136.3
+		 * @version 1.139.0
 		 *
 		 * @public
 		 * @since 1.92

package/src/sap/m/DynamicDateRange.js

@@ -288,7 +288,7 @@ sap.ui.define([
 		 * is opened. The dialog is closed via a date time period value selection or by pressing the "Cancel" button.
 		 *
 		 * @author SAP SE
-		 * @version 1.136.3
+		 * @version 1.139.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/DynamicDateValueHelpUIType.js

@@ -20,7 +20,7 @@ sap.ui.define(['sap/ui/core/Element'],
 		 * @extends sap.ui.core.Element
 		 *
 		 * @author SAP SE
-		 * @version 1.136.3
+		 * @version 1.139.0
 		 *
 		 * @public
 		 * @since 1.92

package/src/sap/m/ExpandableText.js

@@ -105,7 +105,7 @@ function(library,
 	 * @implements sap.ui.core.IFormContent, sap.m.IHyphenation, sap.ui.core.ILabelable
 	 *
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/FacetFilter.js

@@ -181,7 +181,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.core.Control
 	 * @implements sap.ui.core.IShrinkable
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/FacetFilterItem.js

@@ -20,7 +20,7 @@ sap.ui.define(['./ListItemBase', './library', './FacetFilterItemRenderer'],
 	 * @class
 	 * Represents a value for the {@link sap.m.FacetFilterList} control.
 	 * @extends sap.m.ListItemBase
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/FacetFilterList.js

@@ -53,7 +53,7 @@ sap.ui.define([
 	 * be closed.
 	 *
 	 * @extends sap.m.List
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/FeedContent.js

@@ -28,7 +28,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 * @since 1.34
 	 *
 	 * @public

package/src/sap/m/FeedInput.js

@@ -7,7 +7,6 @@
 sap.ui.define([
 	"./library",
 	"sap/ui/core/Control",
-	"sap/ui/core/IconPool",
 	"sap/m/TextArea",
 	"sap/m/Button",
 	"./FeedInputRenderer",
@@ -17,10 +16,11 @@ sap.ui.define([
 	"sap/m/Avatar",
 	"sap/m/AvatarShape",
 	"sap/m/AvatarSize",
-	"sap/ui/core/Lib"
+	"sap/ui/core/Lib",
+	"sap/base/Log"
 ],
-	function(library, Control, IconPool, TextArea, Button, FeedInputRenderer, jQuery, URLListValidator, sanitizeHTML0, Avatar,
-		AvatarShape, AvatarSize, CoreLib) {
+	function(library, Control, TextArea, Button, FeedInputRenderer, jQuery, URLListValidator, sanitizeHTML0, Avatar,
+		AvatarShape, AvatarSize, CoreLib, Log) {
 	"use strict";
 
 	// shortcut for sap.m.ButtonType
@@ -41,7 +41,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @constructor
 	 * @public
@@ -163,7 +163,15 @@ sap.ui.define([
 				/**
 				 * Defines the inner avatar control.
 				 */
-				_avatar: { type: "sap.m.Avatar", multiple: false, visibility: "hidden" }
+				_avatar: { type: "sap.m.Avatar", multiple: false, visibility: "hidden" },
+				/**
+				 * Defines the actions that are displayed next to the text area. These buttons can be used to trigger actions, such as attaching a file.
+				 * This is a {@link sap.m.Button}
+				 * If the actions are not set, the post button is displayed as the last control in the feed input.
+				 * <b>Note:</b> Only <code>sap.m.Button</code> is supported for this aggregation. If another control is provided, an error is logged and actions are ignored.
+				 * @since 1.139
+				 */
+				actions: {type: "sap.ui.core.Control", multiple: true}
 			},
 			events : {
 
@@ -395,7 +403,7 @@ sap.ui.define([
 	FeedInput.prototype.setValue = function (sValue) {
 		this.setProperty("value", sValue, true);
 		this._getTextArea().setValue(sValue);
-		this._enablePostButton();
+		this.enablePostButton();
 		return this;
 	};
 
@@ -417,7 +425,7 @@ sap.ui.define([
 			}
 		}
 		this._getTextArea().setEnabled(bEnabled);
-		this._enablePostButton();
+		this.enablePostButton();
 		return this;
 	};
 
@@ -448,7 +456,7 @@ sap.ui.define([
 				liveChange : jQuery.proxy(function (oEvt) {
 					var sValue = oEvt.getParameter("value");
 					this.setProperty("value", sValue, true); // update myself without re-rendering
-					this._enablePostButton();
+					this.enablePostButton();
 				}, this)
 			});
 			this._oTextArea.setParent(this);
@@ -487,21 +495,62 @@ sap.ui.define([
 	};
 
 	/**
-	 * Enable post button depending on the current value
+	 * Enables or disables the post button.
+	 * If a boolean parameter is provided, the post button's enabled state is set directly to that value.
+	 * @param {boolean} [bEnabled] - Sets the enabled state of the post button.
 	 */
-	FeedInput.prototype._enablePostButton = function () {
-		var bPostButtonEnabled = this._isControlEnabled();
+	FeedInput.prototype.enablePostButton = function(bEnabled) {
 		var oButton = this._getPostButton();
-		oButton.setEnabled(bPostButtonEnabled);
+		// If bEnabled is a boolean, set the button's enabled state directly
+		// Otherwise, check the control's validity to determine the button's enabled state
+		if (typeof bEnabled === "boolean") {
+			this._bEnablePostButton = bEnabled;
+			oButton.setEnabled(bEnabled);
+			// If the button is disabled and the current value is not empty, enable the button
+			// This ensures that the button is enabled when the value is set but the button is disabled
+			if (bEnabled == false && this.getValue()) {
+				oButton.setEnabled(!bEnabled);
+			}
+		} else {
+			var bPostButtonEnabled = this._isControlEnabled();
+			oButton.setEnabled(bPostButtonEnabled);
+		}
 	};
 
 	/**
-	 * Verifies if the control is enabled or not
-	 * @returns {boolean} True if control is enabled
+	 * Checks if the control is valid based on the enablePostButton flag and the value.
+	 * @param {boolean} bEnablePostButton
+	 * @returns {boolean}
 	 */
 	FeedInput.prototype._isControlEnabled = function() {
 		var sValue = this.getValue();
-		return this.getEnabled() && (typeof sValue === "string" || sValue instanceof String) && sValue.trim().length > 0;
+		if (this._bEnablePostButton) {
+			// If bEnablePostButton is true, always return true regardless of value
+			return true;
+		} else {
+			// If bEnablePostButton is false, only return true if there is a value
+			return (typeof sValue === "string" || sValue instanceof String) && sValue.trim().length > 0;
+		}
+	};
+
+	/**
+	 * Returns the action button if it is a sap.m.Button, otherwise logs an error and returns null.
+	 * @returns {sap.m.Button|null}
+	 */
+	FeedInput.prototype._getActionButtonIfValid = function () {
+		var oActionButton = this.getActions()[0]; // Get the first action button, if any
+		if (oActionButton && oActionButton.isA("sap.m.Button")) {
+			var sText = oActionButton.getText();
+			var sIcon = oActionButton.getIcon();
+			if (sIcon && (!sText || sText.trim() === "")) {
+				return oActionButton;
+			} else {
+				Log.error("FeedInput: The actionButton should only have an icon and no text.");
+			}
+		} else if (oActionButton) {
+			Log.error("FeedInput: The provided actionButton aggregation is not a sap.m.Button instance.");
+		}
+		return;
 	};
 
 	/**

package/src/sap/m/FeedInputRenderer.js

@@ -22,6 +22,7 @@ sap.ui.define(["sap/ui/core/Lib"],
 	 */
 	FeedInputRenderer.render = function (oRm, oControl) {
 		var sMyId = oControl.getId();
+		var oActionButton = oControl._getActionButtonIfValid();
 
 		oRm.openStart("div", oControl);
 		oRm.class("sapMFeedInBase");
@@ -42,9 +43,15 @@ sap.ui.define(["sap/ui/core/Lib"],
 		}
 		oRm.openStart("div", sMyId + "-container");
 		oRm.class("sapMFeedInContainer");
+		if (oActionButton) {
+			oRm.class("sapMFeedInAcitonButtonContainer");
+		}
 		oRm.openEnd();
 		var oTextArea = oControl._getTextArea();
 		oRm.renderControl(oTextArea);
+		if (oActionButton) {
+			oRm.renderControl(oActionButton.addStyleClass("sapMFeedInActionButton"));
+		}
 		oRm.renderControl(oControl._getPostButton());
 		oRm.close("div");
 		oRm.close("div");

package/src/sap/m/FeedListItem.js

@@ -60,11 +60,12 @@ function(
 	 * @class
 	 * The control provides a set of properties for text, sender information, time stamp.
 	 * Beginning with release 1.23 the new feature expand / collapse was introduced, which uses the property maxCharacters.
-	 * Beginning with release 1.44, sap.m.FormattedText was introduced which allows html formatted text to be displayed
+	 * Beginning with release 1.44, sap.m.FormattedText was introduced which allows html formatted text to be displayed.
+	 * The <code>actions</code> aggregation must contain instances of {@link sap.m.FeedListItemAction} in order to display them in the action sheet.
 	 * @extends sap.m.ListItemBase
 	 *
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @constructor
 	 * @public
@@ -189,15 +190,8 @@ function(
 				 */
 				disableStyleAttribute : {type : "boolean", group : "Appearance", defaultValue : false}
 			},
-			defaultAggregation: "actions",
 			aggregations: {
 
-				/**
-				 * Contains {@link sap.m.FeedListItemAction elements} that are displayed in the action sheet.
-				 * @since 1.52.0
-				 */
-				actions: {type: "sap.m.FeedListItemAction", multiple: true},
-
 				/**
 				 * Hidden aggregation which contains the text value
 				 */
@@ -291,6 +285,14 @@ function(
 		this._oInvisibleText.setText(FeedListItem._sTextListItem);
 	};
 
+	FeedListItem.prototype.validateAggregation = function(sAggregationName, vObject) {
+		var oResult = ListItemBase.prototype.validateAggregation.apply(this, arguments);
+		if (oResult && sAggregationName === "actions" && !vObject.isA("sap.m.FeedListItemAction")) {
+			throw new Error(vObject + " is not a valid action aggregation of " + this + ". The actions aggregation in this control only supports sap.m.FeedListItemAction.");
+		}
+		return oResult;
+	};
+
 	/**
 	 *
 	 * @private

package/src/sap/m/FeedListItemAction.js

@@ -4,8 +4,8 @@
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
-sap.ui.define(["sap/ui/core/Element"],
-	function(Element) {
+sap.ui.define(["./ListItemActionBase"],
+	function(ListItemActionBase) {
 	"use strict";
 
 	/**
@@ -16,38 +16,24 @@ sap.ui.define(["sap/ui/core/Element"],
 	 *
 	 * @class An action item of FeedListItem
 	 *
-	 * @extends sap.ui.core.Element
+	 * @extends sap.m.ListItemActionBase
 	 *
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @constructor
 	 * @public
 	 * @alias sap.m.FeedListItemAction
 	 * @since 1.52.0
 	 */
-	var FeedListItemAction = Element.extend("sap.m.FeedListItemAction", /** @lends sap.m.FeedListItemAction.prototype */ {
+	var FeedListItemAction = ListItemActionBase.extend("sap.m.FeedListItemAction", /** @lends sap.m.FeedListItemAction.prototype */ {
 		metadata: {
 			library: "sap.m",
 			properties: {
-				/**
-				 * The icon of the action.
-				 */
-				icon: { type: "sap.ui.core.URI", group: "Appearance", defaultValue: null },
-
-				/**
-				 * The text of the item. It is used as a tooltip and for accessibility reasons.
-				 */
-				text: { type: "string", group: "Misc", defaultValue: "" },
-
 				/**
 				 * The key of the item.
 				 */
 				key: { type: "string", group: "Misc", defaultValue: "" },
-				/**
-				 * Hides or shows a button on the UI.
-				 */
-				visible: { type: "boolean", group: "Appearance", defaultValue: true },
 				/**
 				 * Enables or disables a button on the UI. All buttons are enabled by default.
 				 * Disabled buttons are colored differently as per the theme of the UI.

package/src/sap/m/Fiori20Adapter.js

@@ -28,7 +28,7 @@ sap.ui.define([
 	 *
 	 *
 	 * @class text
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 * @private
 	 * @since 1.38
 	 * @alias HeaderAdapter
@@ -249,7 +249,7 @@ sap.ui.define([
 	 * Constructor for an sap.m.Fiori20Adapter.
 	 *
 	 * @class text
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 * @private
 	 * @since 1.38
 	 * @alias sap.m.Fiori20Adapter

package/src/sap/m/FlexBox.js

@@ -62,7 +62,7 @@ function(
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @public
 	 * @alias sap.m.FlexBox

package/src/sap/m/FlexItemData.js

@@ -24,7 +24,7 @@ sap.ui.define(["./FlexBoxStylingHelper", "./library", "sap/ui/core/LayoutData"],
 	 * @class
 	 * Holds layout data for a FlexBox / HBox / VBox.
 	 * @extends sap.ui.core.LayoutData
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/FormattedText.js

@@ -46,7 +46,7 @@ function(
 		 * @class
 		 * The FormattedText control allows the usage of a limited set of tags for inline display of formatted text in HTML format.
 		 * @extends sap.ui.core.Control
-		 * @version 1.136.3
+		 * @version 1.139.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/GenericTag.js

@@ -53,7 +53,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/GenericTile.js

@@ -89,7 +89,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 * @since 1.34.0
 	 *
 	 * @public
@@ -1702,23 +1702,40 @@ sap.ui.define([
 	 */
 	 GenericTile.prototype._getSizeDescription = function () {
 		var sText = "",
-			frameType = this.getFrameType();
+		    frameType = this.getFrameType(),
+                    bHasPress = this.hasListeners("press"),
+                    sUrl = this.getUrl();
 		if (this.getMode() === GenericTileMode.LineMode) {
 			var bIsLink = this.getUrl() && !this._isInActionScope() && this.getState() !== LoadState.Disabled;
-			var bHasPress = this.hasListeners("press");
 			if (bIsLink || bHasPress) {
 				sText = "GENERIC_TILE_LINK";
 			} else {
 				sText = "GENERIC_TILE_LINE_SIZE";
 			}
 		} else if (frameType === FrameType.OneByHalf) {
-			sText = "GENERIC_TILE_FLAT_SIZE";
-		} else if (frameType === FrameType.TwoByHalf) {
-			sText = "GENERIC_TILE_FLAT_WIDE_SIZE";
-		} else if (frameType === FrameType.TwoByOne) {
-			sText = "GENERIC_TILE_WIDE_SIZE";
-		} else if (frameType === FrameType.OneByOne) {
-			sText = "GENERIC_TILE_ROLE_DESCRIPTION";
+            if (bHasPress || sUrl) {
+                sText = "GENERIC_TILE_NAVIGATIONAL_FLAT_SIZE";
+            } else {
+                sText = "GENERIC_TILE_ACTION_FLAT_SIZE";
+            }
+       } else if (frameType === FrameType.TwoByHalf) {
+            if (bHasPress || sUrl) {
+                sText = "GENERIC_TILE_NAVIGATIONAL_FLAT_WIDE_SIZE";
+            } else {
+                sText = "GENERIC_TILE_ACTION_FLAT_WIDE_SIZE";
+            }
+       } else if (frameType === FrameType.TwoByOne) {
+            if (bHasPress || sUrl) {
+                sText = "GENERIC_TILE_NAVIGATIONAL_WIDE_SIZE";
+            } else {
+                sText = "GENERIC_TILE_ACTION_WIDE_SIZE";
+            }
+       } else if (frameType === FrameType.OneByOne) {
+            if (bHasPress || sUrl) {
+                sText = "GENERIC_TILE_NAVIGATIONAL_ROLE_DESCRIPTION";
+            } else {
+                sText = "GENERIC_TILE_ACTION_ROLE_DESCRIPTION";
+            }
 		}
 		return this._oRb.getText(sText);
 	};

package/src/sap/m/GroupHeaderListItem.js

@@ -25,7 +25,7 @@ sap.ui.define(["sap/ui/core/library", "./library", "./ListItemBase", "./GroupHea
 	 *
 	 * @class
 	 * <code>sap.m.GroupHeaderListItem</code> is used to display the title of a group and act as separator between groups in <code>sap.m.List</code> and <code>sap.m.Table</code>.
-	 * <b>Note:</b> The inherited properties <code>unread</code>, <code>selected</code>, <code>counter</code> and <code>press</code> event from <code>sap.m.ListItemBase</code> are not supported.
+	 * <b>Note:</b> The inherited properties <code>unread</code>, <code>selected</code>, <code>counter</code>, the <code>press</code> event, and the <code>actions</code> aggregation from <code>sap.m.ListItemBase</code> are not supported.
 	 *
 	 * There are the following known restrictions:
 	 * <ul>
@@ -37,7 +37,7 @@ sap.ui.define(["sap/ui/core/library", "./library", "./ListItemBase", "./GroupHea
 	 * @implements sap.m.ITableItem
 
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @constructor
 	 * @public
@@ -123,6 +123,10 @@ sap.ui.define(["sap/ui/core/library", "./library", "./ListItemBase", "./GroupHea
 		return true;
 	};
 
+	GroupHeaderListItem.prototype._getMaxActionsCount = function() {
+		return -1; // no actions for group headers
+	};
+
 	return GroupHeaderListItem;
 
 });

package/src/sap/m/GrowingList.js

@@ -22,7 +22,7 @@ sap.ui.define(['./List', './library', './GrowingListRenderer', 'sap/ui/core/Conf
 	 * @extends sap.m.List
 	 *
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/HBox.js

@@ -25,7 +25,7 @@ sap.ui.define(['./FlexBox', './library', './HBoxRenderer'],
 	 * @extends sap.m.FlexBox
 	 *
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/HeaderContainer.js

@@ -125,7 +125,7 @@ sap.ui.define([
 		 * @since 1.44.0
 		 *
 		 * @author SAP SE
-		 * @version 1.136.3
+		 * @version 1.139.0
 		 *
 		 * @public
 		 * @alias sap.m.HeaderContainer

package/src/sap/m/HeaderContainerItemNavigator.js

@@ -16,7 +16,7 @@ sap.ui.define([
 	 * @since 1.67.0
 	 *
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @constructor
 	 * @alias sap.m.HeaderContainerItemNavigator

package/src/sap/m/IconTabBar.js

@@ -94,7 +94,7 @@ sap.ui.define([
 	 * @implements sap.m.ObjectHeaderContainer, sap.f.IDynamicPageStickyContent
 	 *
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @public
 	 * @alias sap.m.IconTabBar

package/src/sap/m/IconTabBarSelectList.js

@@ -40,7 +40,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.136.3
+	 * @version 1.139.0
 	 *
 	 * @constructor
 	 * @private