@openui5/sap.m 1.96.25 → 1.96.26

package/src/sap/m/ColumnPopoverSelectListItem.js

@@ -1,6 +1,6 @@
 /*
  * ! OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([
@@ -29,7 +29,7 @@ sap.ui.define([
 	 * @extends sap.m.ColumnPopoverItem
 	 *
 	 * @author SAP SE
-	 * @version 1.96.25
+	 * @version 1.96.26
 	 *
 	 * @constructor
 	 * @since 1.86

package/src/sap/m/ColumnPopoverSortItem.js

@@ -1,6 +1,6 @@
 /*
  * ! OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([
@@ -29,7 +29,7 @@ sap.ui.define([
 	 * @extends sap.m.ColumnPopoverItem
 	 *
 	 * @author SAP SE
-	 * @version 1.96.25
+	 * @version 1.96.26
 	 *
 	 * @constructor
 	 * @since 1.66

package/src/sap/m/ComboBox.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -108,7 +108,7 @@ sap.ui.define([
 		 * </ul>
 		 *
 		 * @author SAP SE
-		 * @version 1.96.25
+		 * @version 1.96.26
 		 *
 		 * @constructor
 		 * @extends sap.m.ComboBoxBase

package/src/sap/m/ComboBoxBase.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -64,7 +64,7 @@ sap.ui.define([
 		 * @abstract
 		 *
 		 * @author SAP SE
-		 * @version 1.96.25
+		 * @version 1.96.26
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/ComboBoxBaseRenderer.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define(['./ComboBoxTextFieldRenderer', 'sap/ui/core/Renderer', 'sap/ui/core/Core'],

package/src/sap/m/ComboBoxRenderer.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define(['./ComboBoxBaseRenderer', 'sap/ui/core/Renderer', 'sap/m/inputUtils/ListHelpers'

package/src/sap/m/ComboBoxTextField.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -35,7 +35,7 @@ sap.ui.define([
 		 * @extends sap.m.InputBase
 		 *
 		 * @author SAP SE
-		 * @version 1.96.25
+		 * @version 1.96.26
 		 *
 		 * @constructor
 		 * @public

package/src/sap/m/ComboBoxTextFieldRenderer.js

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

package/src/sap/m/CustomDynamicDateOption.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -20,7 +20,7 @@ sap.ui.define(['sap/m/DynamicDateOption'],
 		 * @extends sap.m.DynamicDateOption
 		 *
 		 * @author SAP SE
-		 * @version 1.96.25
+		 * @version 1.96.26
 		 *
 		 * @public
 		 * @since 1.92

package/src/sap/m/CustomListItem.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -24,7 +24,7 @@ sap.ui.define(['./ListItemBase', './library', './CustomListItemRenderer'],
 	 * @extends sap.m.ListItemBase
 	 *
 	 * @author SAP SE
-	 * @version 1.96.25
+	 * @version 1.96.26
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/CustomListItemRenderer.js

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

package/src/sap/m/CustomTile.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -21,7 +21,7 @@ sap.ui.define(['./Tile', './library', './CustomTileRenderer'],
 	 * Use the CustomTile control to display application specific content in the Tile control.
 	 * The tile width is 8.5em and height is 10em.
 	 * @extends sap.m.Tile
-	 * @version 1.96.25
+	 * @version 1.96.26
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/CustomTileRenderer.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define(['./TileRenderer', 'sap/ui/core/Renderer'],

package/src/sap/m/CustomTreeItem.js

@@ -1,6 +1,6 @@
 /*
  * ! OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -23,7 +23,7 @@ sap.ui.define([
 	 *        <code>Table, Form</code> etc, should not be aggregated as content.
 	 * @extends sap.m.TreeItemBase
 	 * @author SAP SE
-	 * @version 1.96.25
+	 * @version 1.96.26
 	 * @constructor
 	 * @public
 	 * @since 1.48.0

package/src/sap/m/CustomTreeItemRenderer.js

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

package/src/sap/m/DatePicker.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -152,7 +152,7 @@ sap.ui.define([
 	 * the close event), or select Cancel.
 	 *
 	 * @extends sap.m.DateTimeField
-	 * @version 1.96.25
+	 * @version 1.96.26
 	 *
 	 * @constructor
 	 * @public
@@ -1058,22 +1058,10 @@ sap.ui.define([
 
 	};
 
-	// overwrite _getInputValue to do the conversion there
-	DatePicker.prototype._getInputValue = function(sValue) {
-
-		sValue = (typeof sValue == "undefined") ? this._$input.val() : sValue.toString();
-
-		var oDate = this._parseValue(sValue, true);
-		sValue = this._formatValue(oDate, true);
-
-		return sValue;
-
-	};
-
 	// overwrite _getInputValue to do the output conversion
 	DatePicker.prototype.updateDomValue = function(sValue) {
 
-		if (this.isActive() && (this._$input.val() !== sValue)) {
+		if (this.isActive() && this._$input.val() !== sValue) {
 			// dom value updated other than value property
 			this._bCheckDomValue = true;
 
@@ -1083,11 +1071,18 @@ sap.ui.define([
 			var oDate = this._parseValue(sValue, true);
 			sValue = this._formatValue(oDate);
 
-			// update the DOM value when necessary
-			// otherwise cursor can goto end of text unnecessarily
-			this._$input.val(sValue);
-			if (document.activeElement === this._$input[0]) {
-				this._$input.cursorPos(this._curpos);
+			// if set to true, handle the user input and data
+			// model updates concurrency in order to not overwrite
+			// values coming from the user
+			if (this._bPreferUserInteraction) {
+				this.handleInputValueConcurrency(sValue);
+			} else {
+				// update the DOM value when necessary
+				// otherwise cursor can goto end of text unnecessarily
+				this._$input.val(sValue);
+				if (document.activeElement === this._$input[0]) {
+					this._$input.cursorPos(this._curpos);
+				}
 			}
 		}
 

package/src/sap/m/DatePickerRenderer.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define(['sap/ui/core/Renderer', './InputBaseRenderer', 'sap/ui/core/library'],
@@ -21,7 +21,9 @@ sap.ui.define(['sap/ui/core/Renderer', './InputBaseRenderer', 'sap/ui/core/libra
 	 * @param {sap.m.DatePicker} oDP An object representation of the control that should be rendered.
 	 */
 	DatePickerRenderer.writeInnerValue = function(oRm, oDP) {
-		if (oDP._bValid || oDP._bOutOfAllowedRange) {
+		if (oDP._inPreferredUserInteraction()) {
+			oRm.attr("value", oDP._$input.val());
+		} else if (oDP._bValid || oDP._bOutOfAllowedRange) {
 			oRm.attr("value", oDP._formatValue(oDP.getDateValue()));
 		} else {
 			oRm.attr("value", oDP.getValue());

package/src/sap/m/DateRangeSelection.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -126,8 +126,8 @@ sap.ui.define([
 	 * compact mode and provides a touch-friendly size in cozy mode.
 	 *
 	 * @extends sap.m.DatePicker
-	 * @version 1.96.25
-	 * @version 1.96.25
+	 * @version 1.96.26
+	 * @version 1.96.26
 	 *
 	 * @constructor
 	 * @public
@@ -301,14 +301,26 @@ sap.ui.define([
 	 * @public
 	 */
 	DateRangeSelection.prototype.setValue = function(sValue) {
+		sValue = this.validateProperty("value", sValue);
 
 		if (sValue !== this.getValue()) {
 			this.setLastValue(sValue);
 		} else {
 			return this;
 		}
-		// Set the property in any case but check validity on output
-		this.setProperty("value", sValue);
+
+		var aDates = this._parseAndValidateValue(sValue);
+		this.setProperty("dateValue", _normalizeDateValue(aDates[0]), this._bPreferUserInteraction);
+		this.setProperty("secondDateValue", _normalizeDateValue(aDates[1]), this._bPreferUserInteraction);
+
+		this._formatValueAndUpdateOutput(aDates);
+		this.setProperty("value", sValue, this._bPreferUserInteraction);
+
+		return this;
+
+	};
+
+	DateRangeSelection.prototype._parseAndValidateValue = function(sValue) {
 		this._bValid = true;
 
 		// Convert to date object(s)
@@ -321,23 +333,28 @@ sap.ui.define([
 				Log.warning("Value can not be converted to a valid dates", this);
 			}
 		}
+		return aDates;
+	};
 
-		this.setProperty("dateValue", _normalizeDateValue(aDates[0]));
-		this.setProperty("secondDateValue", _normalizeDateValue(aDates[1]));
+	DateRangeSelection.prototype._formatValueAndUpdateOutput = function(aDates) {
+		if (!this.getDomRef()) {
+			return;
+		}
 
-		// Do not call InputBase.setValue because the displayed value and the output value might have different pattern
-		if (this.getDomRef()) {
-			// Convert to output
-			var sOutputValue = this._formatValue(aDates[0], aDates[1]);
+		// Convert to output
+		var sOutputValue = this._formatValue(aDates[0], aDates[1]);
 
-			if (this._$input.val() !== sOutputValue) {
-				this._$input.val(sOutputValue);
-				this._curpos = this._$input.cursorPos();
-			}
+		if (this._bPreferUserInteraction) {
+			// Handle the value concurrency before setting the value property of the control,
+			// in order to distinguish whether the user only focused the input field or typed in it
+			this.handleInputValueConcurrency(sOutputValue);
+		} else if (this._$input.val() !== sOutputValue) {
+			// update the DOM value when necessary
+			// otherwise cursor can go to the end of text unnecessarily
+			this._$input.val(sOutputValue);
+			this._curpos = this._$input.cursorPos();
 		}
 
-		return this;
-
 	};
 
 	/**
@@ -776,21 +793,21 @@ sap.ui.define([
 
 	};
 
-	// Overwrite DatePicker's _getInputValue  to support two date range processing
-	DateRangeSelection.prototype._getInputValue = function(sValue) {
+	// // Overwrite DatePicker's _getInputValue  to support two date range processing
+	// DateRangeSelection.prototype._getInputValue = function(sValue) {
 
-		sValue = (typeof sValue == "undefined") ? this._$input.val() : sValue.toString();
+	// 	sValue = (typeof sValue == "undefined") ? this._$input.val() : sValue.toString();
 
-		if (!sValue) {
-			return "";
-		}
+	// 	if (!sValue) {
+	// 		return "";
+	// 	}
 
-		var aDates = this._parseValue(sValue);
-		sValue = this._formatValue( aDates[0], aDates[1]);
+	// 	var aDates = this._parseValue(sValue);
+	// 	sValue = this._formatValue( aDates[0], aDates[1]);
 
-		return sValue;
+	// 	return sValue;
 
-	};
+	// };
 
 	// overwrite _getInputValue to do the output conversion
 	DateRangeSelection.prototype.updateDomValue = function(sValue) {
@@ -804,14 +821,22 @@ sap.ui.define([
 		var aDates = this._parseValue(sValue);
 		sValue = this._formatValue( aDates[0], aDates[1]);
 
-		// update the DOM value when necessary
-		// otherwise cursor can goto end of text unnecessarily
-		if (this.isActive() && (this._$input.val() !== sValue)) {
-			this._$input.val(sValue);
-			this._$input.cursorPos(this._curpos);
+		// if set to true, handle the user input and data
+		// model updates concurrency in order to not overwrite
+		// values coming from the user
+		if (this._bPreferUserInteraction) {
+			this.handleInputValueConcurrency(sValue);
+		} else {
+			// update the DOM value when necessary
+			// otherwise cursor can goto end of text unnecessarily
+			if (this.isActive() && (this._$input.val() !== sValue)) {
+				this._$input.val(sValue);
+				this._$input.cursorPos(this._curpos);
+			}
 		}
 
 		return this;
+
 	};
 
 	//Support of two date range version of Calendar added into original DatePicker's version

package/src/sap/m/DateRangeSelectionRenderer.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define(['sap/ui/core/Renderer', './DatePickerRenderer'],
@@ -23,8 +23,9 @@ sap.ui.define(['sap/ui/core/Renderer', './DatePickerRenderer'],
 	 * @param {sap.ui.core.Control} oControl An object representation of the control that should be rendered.
 	 */
 	DateRangeSelectionRenderer.writeInnerValue = function(oRm, oControl) {
-
-		if (oControl._bValid) {
+		if (oControl._inPreferredUserInteraction()) {
+			oRm.attr("value", oControl._$input.val());
+		} else if (oControl._bValid) {
 			oRm.attr("value", oControl._formatValue(oControl.getDateValue(), oControl.getSecondDateValue()));
 		} else {
 			oRm.attr("value", oControl.getValue());

package/src/sap/m/DateTimeField.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -59,7 +59,7 @@ sap.ui.define([
 	 * @extends sap.m.InputBase
 	 *
 	 * @author SAP SE
-	 * @version 1.96.25
+	 * @version 1.96.26
 	 *
 	 * @constructor
 	 * @public
@@ -123,8 +123,18 @@ sap.ui.define([
 			this.setLastValue(sValue);
 		}
 
-		// set the property in any case but check validity on output
-		this.setProperty("value", sValue);
+		// convert to date object and check validity on output
+		var oDate = this._parseAndValidateValue(sValue);
+		this.setProperty("dateValue", oDate, this._bPreferUserInteraction);
+
+		// do not call InputBase.setValue because the displayed value and the output value might have different pattern
+		this._formatValueAndUpdateOutput(oDate, sValue);
+		this.setProperty("value", sValue, this._bPreferUserInteraction);
+
+		return this;
+	};
+
+	DateTimeField.prototype._parseAndValidateValue = function(sValue) {
 		this._bValid = true;
 
 		// convert to date object
@@ -136,26 +146,68 @@ sap.ui.define([
 				Log.warning("Value can not be converted to a valid date", this);
 			}
 		}
+		return oDate;
+	};
 
-		this.setProperty("dateValue", oDate);
+	DateTimeField.prototype._formatValueAndUpdateOutput = function(oDate, sValue) {
+		if (!this.getDomRef()) {
+			return;
+		}
+		// convert to output
+		var sOutputValue = oDate ? this._formatValue(oDate) : sValue;
+
+		if (this._bPreferUserInteraction) {
+			// Handle the value concurrency before setting the value property of the control,
+			// in order to distinguish whether the user only focused the input field or typed in it
+			this.handleInputValueConcurrency(sOutputValue);
+		} else if (this._$input.val() !== sOutputValue) {
+			// update the DOM value when necessary
+			// otherwise cursor can go to the end of text unnecessarily
+			this._$input.val(sOutputValue);
+			this._curpos = this._$input.cursorPos();
+		}
+	};
 
-		// do not call InputBase.setValue because the displayed value and the output value might have different pattern
-		if (this.getDomRef()) {
-			// convert to output
-			var sOutputValue;
-			if (oDate) {
-				sOutputValue = this._formatValue(oDate);
-			} else {
-				sOutputValue = sValue;
-			}
+	DateTimeField.prototype.handleInputValueConcurrency = function(sValue) {
+		var oInnerDomRef = this.getFocusDomRef(),
+			sInputDOMValue = oInnerDomRef && InputBase.prototype._getInputValue.apply(this),
+			sInputPropertyValue = this.getProperty("value"),
+			bInputFocused = document.activeElement === oInnerDomRef,
+			bBindingUpdate = this.isBound("value") && this.getBindingInfo("value").skipModelUpdate;
 
-			if (this._$input.val() !== sOutputValue) {
-				this._$input.val(sOutputValue);
-				this._curpos = this._$input.cursorPos();
-			}
+		// if the user is currently in the field and he has typed a value,
+		// the changes from the model should not overwrite the user input
+		if (bInputFocused && bBindingUpdate && sInputDOMValue && (sInputPropertyValue !== sInputDOMValue)) {
+			return this;
 		}
 
-		return this;
+		oInnerDomRef.value = sValue;
+
+		// when the user has focused on an empty input and a value update is
+		// triggered via binding, after updating, the value should be
+		// selected in order to be easily overwritten by the user
+		if (bInputFocused && bBindingUpdate && !sInputDOMValue) {
+			oInnerDomRef.select();
+		}
+	};
+
+	/**
+	 * Determines if a user is currently typing into the input field and this interaction should be taken with priority.
+	 * @returns {boolean} True if a user interaction is currently getting handled with priority.
+	 */
+	DateTimeField.prototype._inPreferredUserInteraction = function() {
+		if (this._bPreferUserInteraction && this.getDomRef()) {
+			var oInnerDomRef = this.getFocusDomRef(),
+				sInputDOMValue = oInnerDomRef && this._getInputValue(),
+				sInputPropertyValue = this.getProperty("value"),
+				bInputFocused = document.activeElement === oInnerDomRef;
+
+			// if the user is currently in the field and he has typed a value,
+			// the changes from the model should not overwrite the user input
+			return bInputFocused && sInputDOMValue && (sInputPropertyValue !== sInputDOMValue);
+		}
+
+		return false;
 	};
 
 	DateTimeField.prototype.setDateValue = function (oDate) {

package/src/sap/m/DateTimeFieldRenderer.js

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

package/src/sap/m/DateTimeInput.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -62,7 +62,7 @@ function(
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.96.25
+	 * @version 1.96.26
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/DateTimeInputRenderer.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2024 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 sap.ui.define([],