@openui5/sap.m 1.109.0 → 1.110.0

package/src/sap/m/ComboBox.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -106,7 +106,7 @@ sap.ui.define([
 		 * </ul>
 		 *
 		 * @author SAP SE
-		 * @version 1.109.0
+		 * @version 1.110.0
 		 *
 		 * @constructor
 		 * @extends sap.m.ComboBoxBase
@@ -117,6 +117,9 @@ sap.ui.define([
 		 */
 		var ComboBox = ComboBoxBase.extend("sap.m.ComboBox", /** @lends sap.m.ComboBox.prototype */ {
 			metadata: {
+				interfaces : [
+					"sap.m.IToolbarInteractiveControl"
+				],
 				library: "sap.m",
 				designtime: "sap/m/designtime/ComboBox.designtime",
 				properties: {
@@ -150,6 +153,16 @@ sap.ui.define([
 						type: "boolean",
 						group: "Misc",
 						defaultValue: false
+					},
+
+					/**
+					 * Indicates whether the picker is opened.
+					 * @private
+					 */
+					 _open: {
+						type: "boolean",
+						defaultValue: false,
+						visibility: "hidden"
 					}
 				},
 				associations: {
@@ -483,6 +496,12 @@ sap.ui.define([
 				this.clearSelection();
 				this.setValue(sValue);
 			}
+
+			if (this.getShowClearIcon()) {
+				this._getClearIcon().setVisible(this.shouldShowClearIcon());
+			} else if (this._oClearIcon) {
+				this._getClearIcon().setVisible(false);
+			}
 		};
 
 		/**
@@ -566,7 +585,7 @@ sap.ui.define([
 			var oSelectedItem = this.getSelectedItem(),
 				oSelectedListItem = ListHelpers.getListItem(oSelectedItem);
 
-			if (this.bProcessingLoadItemsEvent && (this.getItems().length === 0)) {
+			if (this.bProcessingLoadItemsEvent && !this.bItemsUpdated && (this.getItems().length === 0)) {
 				return;
 			}
 
@@ -661,7 +680,12 @@ sap.ui.define([
 			// if the loadItems event is being processed,
 			// we need to open the dropdown list to show the busy indicator
 			if (this.bProcessingLoadItemsEvent && (this.getPickerType() === "Dropdown")) {
-				this.open();
+
+				if (this.isOpen() && !this.getValue()) {
+					this.close();
+				} else {
+					this.open();
+				}
 			}
 
 			if (this.getLastFocusedListItem()) {
@@ -852,10 +876,9 @@ sap.ui.define([
 		 */
 		ComboBox.prototype.onBeforeOpen = function() {
 			ComboBoxBase.prototype.onBeforeOpen.apply(this, arguments);
-			var fnPickerTypeBeforeOpen = this["onBeforeOpen" + this.getPickerType()],
-				oDomRef = this.getFocusDomRef();
+			var fnPickerTypeBeforeOpen = this["onBeforeOpen" + this.getPickerType()];
 
-				this.setProperty("open", true);
+				this.setProperty("_open", true);
 
 			// the dropdown list can be opened by calling the .open() method (without
 			// any end user interaction), in this case if items are not already loaded
@@ -864,13 +887,6 @@ sap.ui.define([
 				this.loadItems();
 			}
 
-			if (oDomRef) {
-
-				// expose a parent/child contextual relationship to assistive technologies,
-				// notice that the "aria-controls" attribute is set when the popover opened.
-				oDomRef.setAttribute("aria-controls", this.getPicker().getId());
-			}
-
 			// call the hook to add additional content to the list
 			this.addContent();
 			fnPickerTypeBeforeOpen && fnPickerTypeBeforeOpen.call(this);
@@ -926,12 +942,7 @@ sap.ui.define([
 			ComboBoxBase.prototype.onBeforeClose.apply(this, arguments);
 			var oDomRef = this.getFocusDomRef();
 
-			this.setProperty("open", false);
-
-			if (oDomRef) {
-				// notice that the "aria-controls" attribute is removed when the popover is closed.
-				oDomRef.removeAttribute("aria-controls");
-			}
+			this.setProperty("_open", false);
 
 			if (document.activeElement === oDomRef) {
 				this.updateFocusOnClose();
@@ -1926,6 +1937,19 @@ sap.ui.define([
 			}
 		};
 
+		/**
+		 * Required by the {@link sap.m.IToolbarInteractiveControl} interface.
+		 * Determines if the Control is interactive.
+		 *
+		 * @returns {boolean} If it is an interactive Control
+		 *
+		 * @private
+		 * @ui5-restricted sap.m.OverflowToolBar, sap.m.Toolbar
+		 */
+		ComboBox.prototype._getToolbarInteractive = function () {
+			return true;
+		};
+
 		return ComboBox;
 
 	});

package/src/sap/m/ComboBoxBase.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -66,7 +66,7 @@ sap.ui.define([
 		 * @abstract
 		 *
 		 * @author SAP SE
-		 * @version 1.109.0
+		 * @version 1.110.0
 		 *
 		 * @constructor
 		 * @public
@@ -92,13 +92,12 @@ sap.ui.define([
 
 					/**
 					 * Indicates whether the picker is opened.
-					 *
+					 * @deprecated since version 1.110
 					 * @private
 					 */
 					 open: {
 						type: "boolean",
-						defaultValue: false,
-						hidden: true
+						defaultValue: false
 					},
 
 					/**
@@ -199,6 +198,9 @@ sap.ui.define([
 		ComboBoxBase.prototype.updateItems = function(sReason) {
 			this.bItemsUpdated = false;
 
+			var iItemsCount = this.getItems().length;
+			var oList;
+
 			// for backward compatibility and to keep the old data binding behavior,
 			// the items should be destroyed before calling .updateAggregation("items")
 			this.destroyItems();
@@ -214,6 +216,19 @@ sap.ui.define([
 
 				this.onItemsLoaded();
 			}
+
+			oList = this._getList();
+
+			// when there are no items both before the update and after it, we have to remove the busy state
+			if (oList && iItemsCount === this.getItems().length) {
+				oList.setBusy(false);
+				oList.setShowNoData(!this.getItems().length);
+				this.bInitialBusyIndicatorState = false;
+
+				if (this.getValue()) {
+					this.open();
+				}
+			}
 		};
 
 		/**
@@ -659,12 +674,6 @@ sap.ui.define([
 				it's new, because the old is already switched to have the value state header as parent */
 				this._updateSuggestionsPopoverValueState();
 			}
-
-			if (this.getShowClearIcon()) {
-				this._getClearIcon().setVisible(this.shouldShowClearIcon());
-			} else if (this._oClearIcon) {
-				this._getClearIcon().setVisible(false);
-			}
 		};
 
 		ComboBoxBase.prototype._handlePopupOpenAndItemsLoad = function (bOpenOnInteraction, oObjectToFocus) {

package/src/sap/m/ComboBoxBaseRenderer.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (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(['./ComboBoxTextFieldRenderer', 'sap/ui/core/Renderer'],
@@ -31,10 +31,10 @@ sap.ui.define(['./ComboBoxTextFieldRenderer', 'sap/ui/core/Renderer'],
 		 */
 		ComboBoxBaseRenderer.getAccessibilityState = function (oControl) {
 			var mAccessibilityState = ComboBoxTextFieldRenderer.getAccessibilityState.call(this, oControl),
-				oList = oControl._getList();
+				oPicker = oControl.getPicker();
 
-			if (oList) {
-				mAccessibilityState.controls = oList.getId();
+			if (oPicker) {
+				mAccessibilityState.controls = oPicker.getId();
 			}
 			return mAccessibilityState;
 		};

package/src/sap/m/ComboBoxRenderer.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (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(['./ComboBoxBaseRenderer', 'sap/ui/core/Renderer', 'sap/m/inputUtils/ListHelpers'

package/src/sap/m/ComboBoxTextField.js

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

package/src/sap/m/ComboBoxTextFieldRenderer.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (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([

package/src/sap/m/CustomAttribute.js

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

package/src/sap/m/CustomDynamicDateOption.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 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.109.0
+		 * @version 1.110.0
 		 *
 		 * @public
 		 * @since 1.92

package/src/sap/m/CustomListItem.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 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.109.0
+	 * @version 1.110.0
 	 *
 	 * @constructor
 	 * @public
@@ -42,7 +42,7 @@ sap.ui.define(['./ListItemBase', './library', './CustomListItemRenderer'],
 				 * <b>Note:</b> If defined, then only the provided custom accessibility description is announced when there is a focus on the list item.
 				 * @since 1.84
 				 */
-				accDescription: {tpye: "string", group: "Behavior"}
+				accDescription: {type: "string", group: "Behavior"}
 			},
 			aggregations : {
 

package/src/sap/m/CustomListItemRenderer.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 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-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 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.109.0
+	 * @version 1.110.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/m/CustomTileRenderer.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (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(['./TileRenderer', 'sap/ui/core/Renderer'],

package/src/sap/m/CustomTreeItem.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 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.109.0
+	 * @version 1.110.0
 	 * @constructor
 	 * @public
 	 * @since 1.48.0

package/src/sap/m/CustomTreeItemRenderer.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 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-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -154,7 +154,7 @@ sap.ui.define([
 	 * the close event), or select Cancel.
 	 *
 	 * @extends sap.m.DateTimeField
-	 * @version 1.109.0
+	 * @version 1.110.0
 	 *
 	 * @constructor
 	 * @public
@@ -182,7 +182,7 @@ sap.ui.define([
 				 * If not set, the dates are only displayed in the primary calendar type
 				 * @since 1.34.1
 				 */
-				secondaryCalendarType : {type : "sap.ui.core.CalendarType", group : "Appearance", defaultValue : null},
+				secondaryCalendarType : {type : "sap.ui.core.CalendarType", group : "Appearance"},
 
 				/**
 				 * Minimum date that can be shown and selected in the <code>DatePicker</code>. This must be a JavaScript date object.
@@ -353,7 +353,7 @@ sap.ui.define([
 	 *
 	 * <b>Note:</b> If this property is used, the <code>value</code> property should not be changed from the caller.
 	 *
-	 * @returns {object} the value of property <code>dateValue</code>
+	 * @returns {Date} the value of property <code>dateValue</code>
 	 * @public
 	 * @name sap.m.DatePicker#getDateValue
 	 * @function
@@ -377,7 +377,8 @@ sap.ui.define([
 			src: this.getIconSrc(),
 			noTabStop: true,
 			decorative: false,
-			useIconTooltip: false
+			useIconTooltip: false,
+			alt: oResourceBundle.getText("OPEN_PICKER_TEXT")
 		});
 
 		// idicates whether the picker is still open
@@ -489,7 +490,7 @@ sap.ui.define([
 	 * Sets the displayFormat of the DatePicker.
 	 *
 	 * @param {string} sDisplayFormat  new value for <code>displayFormat</code>
-	 * @returns {this} <code>this</code> to allow method chaining
+	 * @returns {this} Reference to <code>this</code> for method chaining
 	 * @public
 	 */
 	 DatePicker.prototype.setDisplayFormat = function(sDisplayFormat) {
@@ -511,7 +512,7 @@ sap.ui.define([
 	 * Defines the width of the DatePicker. Default value is 100%
 	 *
 	 * @param {string} sWidth  new value for <code>width</code>
-	 * @returns {this} <code>this</code> to allow method chaining
+	 * @returns {this} Reference to <code>this</code> for method chaining
 	 * @public
 	 */
 	DatePicker.prototype.setWidth = function(sWidth) {
@@ -660,7 +661,7 @@ sap.ui.define([
 	 * This prevents unwanted automatic corrections of wrong input.
 	 *
 	 * @param {string} sValue The new value of the input.
-	 * @return {this} <code>this</code> to allow method chaining
+	 * @returns {this} Reference to <code>this</code> for method chaining
 	 * @public
 	 * @name sap.m.DatePicker#setValue
 	 * @function
@@ -685,6 +686,11 @@ sap.ui.define([
 		return oDate;
 	};
 
+	/**
+	 * Set minimum date that can be shown and selected in the <code>DatePicker</code>. This must be a JavaScript date object.
+	 * @param {Date} oDate A JavaScript Date
+	 * @returns {this} Reference to <code>this</code> for method chaining
+	 */
 	DatePicker.prototype.setMinDate = function(oDate) {
 
 		if (!this._isValidDate(oDate)) {
@@ -726,6 +732,11 @@ sap.ui.define([
 
 	};
 
+	/**
+	 * Set maximum date that can be shown and selected in the <code>DatePicker</code>. This must be a JavaScript date object.
+	 * @param {Date} oDate A JavaScript Date
+	 * @returns {this} Reference to <code>this</code> for method chaining
+	 */
 	DatePicker.prototype.setMaxDate = function(oDate) {
 
 		if (!this._isValidDate(oDate)) {
@@ -890,7 +901,7 @@ sap.ui.define([
 	 *
 	 * @since 1.38.5
 	 * @param {sap.ui.unified.DateTypeRange} oSpecialDate the specialDate to add; if empty, nothing is added
-	 * @return {this} Reference to <code>this</code> in order to allow method chaining
+	 * @returns {this} Reference to <code>this</code> for method chaining
 	 * @public
 	 */
 	DatePicker.prototype.addSpecialDate = function(oSpecialDate){
@@ -913,7 +924,7 @@ sap.ui.define([
 	 * @param {int} iIndex the 0-based index the <code>specialDate</code> should be inserted at;
 	 *              for a negative value of <code>iIndex</code>, the <code>specialDate</code> is inserted at position 0;
 	 *              for a value greater than the current size of the aggregation, the <code>specialDate</code> is inserted at the last position
-	 * @return {this} Reference to <code>this</code> in order to allow method chaining
+	 * @returns {this} Reference to <code>this</code> for method chaining
 	 * @public
 	 */
 	DatePicker.prototype.insertSpecialDate = function(oSpecialDate, iIndex){
@@ -972,7 +983,7 @@ sap.ui.define([
 	 * @since 1.38.5
 	 * @param {sap.ui.core.ID | sap.ui.unified.CalendarLegend} oLegend ID of an element which becomes the new target of this <code>legend</code> association;
 	 *                                                         alternatively, an element instance may be given
-	 * @return {this} Reference to <code>this</code> in order to allow method chaining
+	 * @returns {this} Reference to <code>this</code> for method chaining
 	 * @public
 	 */
 	DatePicker.prototype.setLegend = function(oLegend){
@@ -1384,7 +1395,7 @@ sap.ui.define([
 
 	/**
 	 * @see sap.ui.core.Control#getAccessibilityInfo
-	 * @returns {object} Current accessibility state of the control.
+	 * @returns {sap.ui.core.AccessibilityInfo} Current accessibility state of the control.
 	 * @protected
 	 */
 	DatePicker.prototype.getAccessibilityInfo = function() {
@@ -1702,7 +1713,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @param {object} [mArguments] the arguments to pass along with the event.
-	 * @return {this} <code>this</code> to allow method chaining
+	 * @returns {this} Reference to <code>this</code> for method chaining
 	 * @protected
 	 * @name sap.m.DatePicker#fireChange
 	 * @function

package/src/sap/m/DatePickerRenderer.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (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/Renderer', './InputBaseRenderer', 'sap/ui/core/library'],

package/src/sap/m/DateRangeSelection.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (c) Copyright 2009-2023 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
 
@@ -130,8 +130,8 @@ sap.ui.define([
 	 * compact mode and provides a touch-friendly size in cozy mode.
 	 *
 	 * @extends sap.m.DatePicker
-	 * @version 1.109.0
-	 * @version 1.109.0
+	 * @version 1.110.0
+	 * @version 1.110.0
 	 *
 	 * @constructor
 	 * @public
@@ -298,7 +298,7 @@ sap.ui.define([
 	 * If this property is used, the <code>dateValue</code> property should not be changed from the caller.
 	 *
 	 * @param {string} sValue The new value of the input.
-	 * @return {this} <code>this</code> to allow method chaining.
+	 * @returns {this} Reference to <code>this</code> for method chaining
 	 * @public
 	 */
 	DateRangeSelection.prototype.setValue = function(sValue) {
@@ -360,8 +360,8 @@ sap.ui.define([
 
 	/**
 	 * Converts the parameter to a Javascript Date, if it is a timestamp integer.
-	 * @param {object|int} vBindingDate A timestamp or a Javascript Date
-	 * @returns {object} A Javascript Date object
+	 * @param {Date|int} vBindingDate A timestamp or a Javascript Date
+	 * @returns {Date} A Javascript Date object
 	 * @private
 	 */
 	function _normalizeDateValue(vBindingDate) {
@@ -370,8 +370,8 @@ sap.ui.define([
 
 	/**
 	 * Converts the parameter to a timestamp integer, if it is a Javascript Date.
-	 * @param {object|int} vBindingDate A timestamp or a Javascript Date
-	 * @returns {object} A timestamp integer
+	 * @param {Date|int} vBindingDate A timestamp or a Javascript Date
+	 * @returns {int} A timestamp integer
 	 * @private
 	 */
 	function _denormalizeDateValue(vBindingDate) {
@@ -383,7 +383,7 @@ sap.ui.define([
 	 *
 	 * <b>Note:</b> Property <code>valueFormat</code> is not supported in the <code>sap.m.DateRangeSelection</code> control.
 	 *
-	 * @return {string} the value of property valueFormat
+	 * @returns {string} the value of property valueFormat
 	 * @public
 	 * @name sap.m.DateRangeSelection#getValueFormat
 	 * @function
@@ -395,7 +395,7 @@ sap.ui.define([
 	 * <b>Note:</b> Property <code>valueFormat</code> is not supported in the <code>sap.m.DateRangeSelection</code> control.
 	 *
 	 * @param {string} sValueFormat New value for property valueFormat
-	 * @return {this} <code>this</code> to allow method chaining
+	 * @returns {this} Reference to <code>this</code> for method chaining
 	 * @public
 	 */
 	DateRangeSelection.prototype.setValueFormat = function(sValueFormat) {
@@ -459,7 +459,7 @@ sap.ui.define([
 	 *
 	 * <b>Note:</b> If this property is used, the <code>value</code> property should not be changed from the caller.
 	 *
-	 * @returns {object} the value of property <code>dateValue</code>
+	 * @returns {Date} the value of property <code>dateValue</code>
 	 * @public
 	 * @name sap.m.DateRangeSelection#getDateValue
 	 * @function
@@ -472,8 +472,8 @@ sap.ui.define([
 	 *
 	 * <b>Note:</b> If this property is used, the <code>value</code> property should not be changed from the caller.
 	 *
-	 * @param {object} oDateValue New value for property <code>dateValue</code>
-	 * @return {this} <code>this</code> to allow method chaining.
+	 * @param {Date} oDateValue New value for property <code>dateValue</code>
+	 * @returns {this} Reference to <code>this</code> for method chaining
 	 * @public
 	 */
 	DateRangeSelection.prototype.setDateValue = function(oDateValue) {
@@ -493,6 +493,17 @@ sap.ui.define([
 
 	};
 
+	/**
+	 * Setter for property <code>secondDateValue</code>.
+	 *
+	 * The start date of the range as JavaScript Date object. This is independent from any formatter.
+	 *
+	 * <b>Note:</b> If this property is used, the <code>value</code> property should not be changed from the caller.
+	 *
+	 * @param {Date} oSecondDateValue New value for property <code>dateValue</code>
+	 * @returns {this} Reference to <code>this</code> for method chaining
+	 * @public
+	 */
 	DateRangeSelection.prototype.setSecondDateValue = function(oSecondDateValue) {
 
 		if (!this._isValidDate(oSecondDateValue)) {
@@ -948,7 +959,7 @@ sap.ui.define([
 
 	/**
 	 * @see sap.ui.core.Control#getAccessibilityInfo
-	 * @returns {object} Current accessibility state of the control
+	 * @returns {sap.ui.core.AccessibilityInfo} Current accessibility state of the control
 	 * @protected
 	 */
 	DateRangeSelection.prototype.getAccessibilityInfo = function() {
@@ -1291,7 +1302,7 @@ sap.ui.define([
 	 * </ul>
 	 *
 	 * @param {object} [mArguments] The arguments to pass along with the event.
-	 * @return {this} <code>this</code> to allow method chaining
+	 * @returns {this} Reference to <code>this</code> for method chaining
 	 * @protected
 	 * @name sap.m.DateRangeSelection#fireChange
 	 * @function

package/src/sap/m/DateRangeSelectionRenderer.js

@@ -1,6 +1,6 @@
 /*!
  * OpenUI5
- * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
+ * (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/Renderer', './DatePickerRenderer'],