@openui5/sap.m 1.119.0 → 1.120.0

package/src/sap/m/GrowingEnablement.js

@@ -68,7 +68,6 @@ sap.ui.define([
 			this._iRenderedDataItems = iRenderedItemsLength;
 			this._iLimit = iRenderedItemsLength;
 			this._bLoading = false;
-			this._sGroupingPath = "";
 			this._bDataRequested = false;
 			this._bSkippedItemsUpdateUntilDataReceived = false;
 			this._iLastItemsCount = 0;
@@ -356,7 +355,7 @@ sap.ui.define([
 		_getGroupingPath : function(oBinding) {
 			var aSorters = oBinding.aSorters || [];
 			var oSorter = aSorters[0] || {};
-			return (oSorter.fnGroup) ? oSorter.sPath || "" : "";
+			return (oSorter.fnGroup) ? oSorter.sPath || "" : undefined;
 		},
 
 		// if table has pop-in then we have two rows for one item
@@ -727,7 +726,7 @@ sap.ui.define([
 
 				} else {
 
-					if (sGroupingPath && !this._sGroupingPath) {
+					if (sGroupingPath != undefined && this._sGroupingPath == undefined) {
 						// if it was already grouped then we need to remove group headers first
 						oControl.removeGroupHeaders(true);
 					}

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.119.0
+	 * @version 1.120.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.119.0
+	 * @version 1.120.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/HeaderContainer.js

@@ -22,6 +22,7 @@ sap.ui.define([
 		"sap/ui/events/PseudoEvents",
 		"sap/ui/thirdparty/jquery",
 		"sap/ui/core/Configuration",
+		"sap/ui/core/Lib",
 		"sap/ui/dom/jquery/scrollLeftRTL", // jQuery Plugin "scrollLeftRTL"
 		"sap/ui/dom/jquery/scrollRightRTL", // jQuery Plugin "scrollRightRTL"
 		"sap/ui/dom/jquery/Selectors" // jQuery custom selectors ":sapTabbable"
@@ -44,7 +45,8 @@ sap.ui.define([
 		KeyCodes,
 		PseudoEvents,
 		jQuery,
-		Configuration
+		Configuration,
+		CoreLib
 	) {
 		"use strict";
 
@@ -124,7 +126,7 @@ sap.ui.define([
 		 * @since 1.44.0
 		 *
 		 * @author SAP SE
-		 * @version 1.119.0
+		 * @version 1.120.0
 		 *
 		 * @public
 		 * @alias sap.m.HeaderContainer
@@ -277,7 +279,7 @@ sap.ui.define([
 		HeaderContainer.prototype.init = function () {
 			this._aItemEnd = [];
 			this._bRtl = Configuration.getRTL();
-			this._oRb = sap.ui.getCore().getLibraryResourceBundle("sap.m");
+			this._oRb = CoreLib.getResourceBundleFor("sap.m");
 			this._oScrollCntr = new ScrollContainer(this.getId() + "-scrl-cntnr", {
 				width: "100%",
 				height: "100%",
@@ -876,7 +878,7 @@ sap.ui.define([
 
 
 		HeaderContainer.prototype._handleMobileScrolling = function () {
-			if (Core.isMobile()) {
+			if (Device.browser.mobile) {
 				var $scroll = this.$("scrl-cntnr-scroll"),
 					bIsHorizontal = this.getOrientation() === Orientation.Horizontal,
 					sProperty = bIsHorizontal ? "clientX" : "clientY",

package/src/sap/m/HeaderContainerItemNavigator.js

@@ -16,7 +16,7 @@ sap.ui.define([
 	 * @since 1.67.0
 	 *
 	 * @author SAP SE
-	 * @version 1.119.0
+	 * @version 1.120.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.119.0
+	 * @version 1.120.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.119.0
+	 * @version 1.120.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/m/IconTabFilter.js

@@ -93,7 +93,7 @@ sap.ui.define([
 	 * @implements sap.m.IconTab
 	 *
 	 * @author SAP SE
-	 * @version 1.119.0
+	 * @version 1.120.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/IconTabFilterExpandButtonBadge.js

@@ -31,7 +31,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.119.0
+	 * @version 1.120.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/m/IconTabHeader.js

@@ -77,7 +77,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.119.0
+	 * @version 1.120.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/IconTabSeparator.js

@@ -33,7 +33,7 @@ sap.ui.define([
 	 * @implements sap.m.IconTab
 	 *
 	 * @author SAP SE
-	 * @version 1.119.0
+	 * @version 1.120.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/IllustratedMessage.js

@@ -86,7 +86,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.119.0
+	 * @version 1.120.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/Illustration.js

@@ -41,7 +41,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.119.0
+	 * @version 1.120.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/Image.js

@@ -59,7 +59,7 @@ sap.ui.define([
 	 * @implements sap.ui.core.IFormContent
 	 *
 	 * @author SAP SE
-	 * @version 1.119.0
+	 * @version 1.120.0
 	 *
 	 * @public
 	 * @alias sap.m.Image

package/src/sap/m/ImageContent.js

@@ -33,7 +33,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.119.0
+	 * @version 1.120.0
 	 * @since 1.38
 	 *
 	 * @public

package/src/sap/m/Input.js

@@ -161,7 +161,7 @@ function(
 	 * @extends sap.m.InputBase
 	 * @implements sap.ui.core.IAccessKeySupport
 	 * @author SAP SE
-	 * @version 1.119.0
+	 * @version 1.120.0
 	 *
 	 * @constructor
 	 * @public
@@ -617,7 +617,7 @@ function(
 		// phase of the life cycle. Without this line, initially the condition fails and fires liveChange event
 		// even though there is no user input (check Input.prototype.onsapright).
 		this._setTypedInValue("");
-
+		this._bDoTypeAhead = false;
 
 		// indicates whether input is clicked (on mobile) or the clear button
 		// used for identifying whether dialog should be open.
@@ -681,10 +681,8 @@ function(
 		this.$().off("click");
 	};
 
-	/**
+	/*
 	 * Overwrites the onBeforeRendering.
-	 *
-	 * @public
 	 */
 	Input.prototype.onBeforeRendering = function() {
 		var sSelectedKey = this.getSelectedKey(),
@@ -1452,6 +1450,7 @@ function(
 		var bPopupOpened = this._isSuggestionsPopoverOpen(),
 			bFocusInPopup = !this.hasStyleClass("sapMFocus") && bPopupOpened,
 			aItems = this._hasTabularSuggestions() ? this.getSuggestionRows() : this.getSuggestionItems(),
+			bFireSubmit = this.getEnabled() && this.getEditable(),
 			iValueLength, oSelectedItem;
 
 		// when enter is pressed before the timeout of suggestion delay, suggest event is cancelled
@@ -1476,7 +1475,12 @@ function(
 
 		!bFocusInPopup && InputBase.prototype.onsapenter.apply(this, arguments);
 
-		if (this.getEnabled() && this.getEditable() && !(this.getValueHelpOnly() && this.getShowValueHelp())) {
+		/**
+		 * @deprecated As of version 1.119
+		 */
+		bFireSubmit = bFireSubmit && !(this.getShowValueHelp() && this.getValueHelpOnly());
+
+		if (bFireSubmit) {
 			this.fireSubmit({value: this.getValue()});
 		}
 
@@ -1994,7 +1998,14 @@ function(
 		oFilterResults = this._getFilteredSuggestionItems(sTypedChars);
 		iSuggestionsLength = oFilterResults.items.length;
 
-		if (iSuggestionsLength > 0 && !this.getValueHelpOnly()) {
+		var bOpenSuggestionsPopup = iSuggestionsLength > 0;
+
+		/**
+		 * @deprecated As of version 1.119
+		 */
+		bOpenSuggestionsPopup = bOpenSuggestionsPopup && !this.getValueHelpOnly();
+
+		if (bOpenSuggestionsPopup) {
 			this._openSuggestionPopup(this.getValue().length >= this.getStartSuggestion());
 		} else {
 			this._hideSuggestionPopup();
@@ -2182,6 +2193,29 @@ function(
 		}
 	};
 
+	/**
+	 * We check both the main and the inner (mobile) input for stored typeahead information
+	 * as the _handleTypeAhead could be called in both contexts depending on the different cases.
+	 *
+	 * For example when we have delayed (dynamically) loaded items on mobile devices the typeahead
+	 * information is stored on the inner dialog's input on user interaction, but when the items
+	 * are updated it is async and the typeahead is handled by the main sap.m.Input instance
+	 *
+	 * @param {sap.m.Input} oInput Input's instance to which the type ahead would be applied. For example: this OR Dialog's Input instance.
+	 * @returns {null|boolean} Should type-ahead be performed or null if no type-ahead info is available.
+	 * @private
+	 */
+	Input.prototype._getEffectiveTypeAhead = function () {
+		var oSuggestionsPopover = this._getSuggestionsPopover();
+		var oPopupInput = oSuggestionsPopover && oSuggestionsPopover.getInput();
+
+		if (!this.isMobileDevice() || this._bDoTypeAhead !== null) {
+			return this._bDoTypeAhead && document.activeElement === this.getFocusDomRef();
+		}
+
+		return oPopupInput._bDoTypeAhead && (!!oPopupInput && document.activeElement === oPopupInput.getFocusDomRef());
+	};
+
 	/**
 	 * Handles Input's specific type ahead logic.
 	 *
@@ -2198,7 +2232,13 @@ function(
 		};
 		var oListDelegate;
 		var oList = oInput._getSuggestionsPopover() && oInput._getSuggestionsPopover().getItemsContainer();
-		this._setTypedInValue(oDomRef.value.substring(0, oDomRef.selectionStart));
+		var bDoTypeAhead = this._getEffectiveTypeAhead();
+
+		if (oDomRef.selectionStart !== oDomRef.selectionEnd) {
+			this._setTypedInValue(oDomRef.value.substring(0, oDomRef.selectionStart));
+		} else {
+			this._setTypedInValue(oDomRef.value);
+		}
 
 		// check if typeahead is already performed
 		if ((oInput && oInput.getValue().toLowerCase()) === (this._getProposedItemText() && this._getProposedItemText().toLowerCase())) {
@@ -2207,9 +2247,7 @@ function(
 
 		oInput._setProposedItemText(null);
 
-		if (!this._bDoTypeAhead || sValue === "" ||
-			sValue.length < this.getStartSuggestion() || document.activeElement !== this.getFocusDomRef()) {
-
+		if (!bDoTypeAhead) {
 			return;
 		}
 
@@ -2251,6 +2289,10 @@ function(
 
 		oInput._setProposedItemText(mTypeAheadInfo.value);
 
+		// This method could be called multiple times in cases when the items are loaded with delay (dynamically)
+		// and also in the context of the dialog's inner input when on mobile so we have to keep the typeahead info
+		this._mTypeAheadInfo = mTypeAheadInfo;
+
 		return mTypeAheadInfo;
 	};
 
@@ -3140,10 +3182,16 @@ function(
 	 */
 	Input.prototype.showItems = function (fnFilter) {
 		var oFilterResults, iSuggestionsLength,
-			fnFilterStore = this._getFilterFunction();
+			fnFilterStore = this._getFilterFunction(),
+			bShowItems = !this.getEnabled() || !this.getEditable();
+
+		/**
+		 * @deprecated As of version 1.119
+		 */
+		bShowItems = bShowItems || this.getValueHelpOnly();
 
 		// in case of a non-editable or disabled, the popup cannot be opened
-		if (!this.getEnabled() || !this.getEditable() || this.getValueHelpOnly()) {
+		if (bShowItems) {
 			return;
 		}
 
@@ -3279,7 +3327,24 @@ function(
 	 */
 	Input.prototype._getFilteredSuggestionItems = function (sValue) {
 		var oFilterResults,
-			oList = this._getSuggestionsPopover().getItemsContainer();
+			oSuggestionsPopover = this._getSuggestionsPopover(),
+			oList = oSuggestionsPopover.getItemsContainer(),
+			oPopupInput = oSuggestionsPopover && oSuggestionsPopover.getInput(),
+			bDoTypeAhead = false;
+
+		// Check if the typeahead should be performed in case of newly fetched items
+		// We check both the main input and the input of the inner dialog when on mobile devices
+		// because type ahead handling is being called in both context depending on whether it
+		// is called after input event or newly loaded items
+		if (this.isMobileDevice()) {
+			bDoTypeAhead = (!oPopupInput._getProposedItemText() && !oPopupInput._mTypeAheadInfo) || (oPopupInput._mTypeAheadInfo && !oPopupInput._mTypeAheadInfo.value);
+		} else {
+			bDoTypeAhead = (this._getProposedItemText() && !this._mTypeAheadInfo) || (this._mTypeAheadInfo && !this._mTypeAheadInfo.value);
+		}
+
+		if (bDoTypeAhead) {
+			this._handleTypeAhead(this);
+		}
 
 		if (this._hasTabularSuggestions()) {
 			// show list on phone (is hidden when search string is empty)

package/src/sap/m/InputBase.js

@@ -66,7 +66,7 @@ function(
 	 * @implements sap.ui.core.IFormContent
 	 *
 	 * @author SAP SE
-	 * @version 1.119.0
+	 * @version 1.120.0
 	 *
 	 * @constructor
 	 * @public
@@ -243,6 +243,7 @@ function(
 	 * https://html.spec.whatwg.org/multipage/forms.html#input-type-attr-summary
 	 *
 	 * @see sap.m.InputBase#oninput
+	 * @type boolean
 	 * @protected
 	 */
 	InputBase.prototype.bShowLabelAsPlaceholder = !Device.support.input.placeholder;
@@ -298,6 +299,7 @@ function(
 		/**
 		 * Indicates whether the input field is in the rendering phase.
 		 *
+		 * @type boolean
 		 * @protected
 		 */
 		this.bRenderingPhase = false;

package/src/sap/m/InputListItem.js

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

package/src/sap/m/InputRenderer.js

@@ -50,6 +50,7 @@ sap.ui.define(['sap/ui/core/InvisibleText', 'sap/ui/core/Renderer', './InputBase
 	 */
 	InputRenderer.writeInnerAttributes = function (oRm, oControl) {
 		var bShowSuggestions = oControl.getShowSuggestion();
+		var bAddReadOnly = (!oControl.getEnabled() && oControl.getType() == "Password") || (oControl.getShowSuggestion() && oControl.isMobileDevice());
 
 		oRm.attr("type", oControl.getType().toLowerCase());
 		//if Input is of type "Number" step attribute should be "any" allowing input of floating point numbers
@@ -64,9 +65,12 @@ sap.ui.define(['sap/ui/core/InvisibleText', 'sap/ui/core/Renderer', './InputBase
 			oRm.attr("autocomplete", "off"); // autocomplete="off" needed so the native browser autocomplete is not shown?
 		}
 
-		if ((!oControl.getEnabled() && oControl.getType() == "Password")
-			|| (oControl.getShowSuggestion() && oControl.isMobileDevice())
-			|| (oControl.getValueHelpOnly() && oControl.getEnabled() && oControl.getEditable() && oControl.getShowValueHelp())) {
+		/**
+		 * @deprecated As of version 1.119
+		 */
+		bAddReadOnly = bAddReadOnly || (oControl.getValueHelpOnly() && oControl.getEnabled() && oControl.getEditable() && oControl.getShowValueHelp());
+
+		if (bAddReadOnly) {
 			// required for JAWS reader on password fields on desktop and in other cases:
 			oRm.attr("readonly", "readonly");
 		}

package/src/sap/m/Label.js

@@ -78,7 +78,7 @@ function(
 	 * @implements sap.ui.core.Label, sap.ui.core.IShrinkable, sap.ui.core.IAccessKeySupport
 	 *
 	 * @author SAP SE
-	 * @version 1.119.0
+	 * @version 1.120.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/LightBox.js

@@ -96,7 +96,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.119.0
+	 * @version 1.120.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/LightBoxItem.js

@@ -43,7 +43,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.119.0
+	 * @version 1.120.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/Link.js

@@ -86,7 +86,7 @@ function(
 	 * @implements sap.ui.core.IShrinkable, sap.ui.core.IFormContent, sap.ui.core.ITitleContent, sap.ui.core.IAccessKeySupport
 	 *
 	 * @author SAP SE
-	 * @version 1.119.0
+	 * @version 1.120.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/LinkTileContent.js

@@ -0,0 +1,143 @@
+/*!
+ * OpenUI5
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
+ */
+sap.ui.define([
+    "sap/ui/core/Element",
+    "sap/m/HBox",
+    "sap/m/Link",
+    "sap/ui/core/Icon"
+    ],function(Element,HBox,Link,Icon){
+    "use strict";
+    /**
+	 * Constructor for a new LinkTileContent.
+	 *
+	 * @param {string} [sId] ID for the new control, it is generated automatically if an ID is not provided.
+	 * @param {object} [mSettings] Initial settings for the new control.
+	 * @class This element is used within the GenericTile control that generates a combination of an icon and a linkl
+	 * @extends sap.ui.core.Element
+	 * @author SAP SE
+	 * @version 1.120.0
+	 * @constructor
+	 * @public
+	 * @since 1.120
+	 * @alias sap.m.LinkTileContent
+	 */
+    const LinkTileContent = Element.extend("sap.m.LinkTileContent",{
+        metadata:{
+            library: "sap.m",
+            properties: {
+                /**
+				 * This property can be set by following options:
+				 *
+				 * <b>Option 1:</b></br>
+				 * The value has to be matched by following pattern <code>sap-icon://collection-name/icon-name</code> where
+				 * <code>collection-name</code> and <code>icon-name</code> have to be replaced by the desired values.
+				 * In case the default UI5 icons are used the <code>collection-name</code> can be omited.</br>
+				 * <i>Example:</i> <code>sap-icon://accept</code>
+				 *
+				 * <b>Option 2:</b>
+				 * The value is determined by using {@link sap.ui.core.IconPool.getIconURI} with an Icon name parameter
+				 * and an optional collection parameter which is required when using application extended Icons.</br>
+				 * <i>Example:</i> <code>IconPool.getIconURI("accept")</code>
+				 */
+                iconSrc: {type : "sap.ui.core.URI", group : "Data", defaultValue : null},
+				/**
+				 * Defines the displayed link text.
+				 */
+                linkText: {type : "string", group : "Data", defaultValue : ''},
+                /**
+				 * Defines the link target URI. Supports standard hyperlink behavior.
+				 * <b>Note:</b> Don't set <code>href</code> property if an action should be triggered by the link. Instead set <code>accessibleRole</code>
+				 * property to <code>LinkAccessibleRole.Button</code> and register a <code>press</code> event handler.
+				 */
+                linkHref: {type : "sap.ui.core.URI", group : "Data", defaultValue : null}
+            },
+            events: {
+                /**
+				 * Event is fired when the user triggers the link control.
+				 */
+                linkPress: {
+                    allowPreventDefault : true,
+					parameters: {
+						/**
+						 * Indicates whether the CTRL key was pressed when the link was selected.
+						 * @since 1.120
+						 */
+						ctrlKey: { type: "boolean" },
+						/**
+						 * Indicates whether the "meta" key was pressed when the link was selected.
+						 *
+						 * On Macintosh keyboards, this is the command key (⌘).
+						 * On Windows keyboards, this is the windows key (⊞).
+						 *
+						 * @since 1.120
+						 */
+						metaKey: { type: "boolean" }
+					}
+                }
+            }
+        }
+    });
+    LinkTileContent.prototype.init = function() {
+        this._linkTileContent = null;
+    };
+    /**
+     * Returns the current element instance
+     * @returns {Object<sap.m.LinkTileContent>}
+     * @public
+     */
+    LinkTileContent.prototype.getLinkTileContentInstance = function() {
+        if (!this._linkTileContent) {
+            this._linkTileContent = new HBox();
+            this._addItem(this._linkTileContent);
+            this._linkTileContent.addStyleClass("sapLTC");
+        }
+        return this._linkTileContent;
+    };
+    /**
+     * It adds an icon and link to the element
+     * @param {Object<sap.m.HBox>} oHBox
+     * @private
+     */
+    LinkTileContent.prototype._addItem = function(oHBox) {
+        const {iconSrc,linkText,linkHref} = this.mProperties;
+        this._oIcon = new Icon({
+            size: "1rem",
+            src: iconSrc
+        });
+        this._oLink = new Link({
+            text: linkText,
+            href: linkHref,
+            press: this._onLinkPress.bind(this)
+        });
+        oHBox.addItem(this._oIcon);
+        oHBox.addItem(this._oLink);
+    };
+    /**
+     * Returns the current element instance
+     * @returns {Object<sap.m.Link>}
+     * @private
+     */
+    LinkTileContent.prototype._getLink = function() {
+        return this._oLink;
+    };
+    /**
+     * Returns the current element instance
+     * @returns {Object<sap.ui.core.Icon>}
+     * @private
+     */
+    LinkTileContent.prototype._getIcon = function() {
+        return this._oIcon;
+    };
+    /**
+     * Sets the press event handler on the link
+     * @private
+     */
+    LinkTileContent.prototype._onLinkPress = function(oEvent) {
+        const {ctrlKey,metaKey} = oEvent.mParameters;
+        this.fireLinkPress({ctrlKey,metaKey});
+    };
+    return LinkTileContent;
+});

package/src/sap/m/List.js

@@ -30,7 +30,7 @@ sap.ui.define(["./library", "./ListBase", "./ListRenderer"],
 	 * @extends sap.m.ListBase
 	 *
 	 * @author SAP SE
-	 * @version 1.119.0
+	 * @version 1.120.0
 	 *
 	 * @constructor
 	 * @public