@openui5/sap.ui.core 1.93.3 → 1.96.2

package/src/sap/ui/model/ClientTreeBinding.js

@@ -3,7 +3,7 @@
  * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
-
+/*eslint-disable max-len */
 // Provides the JSON model implementation of a list binding
 sap.ui.define([
 	"./ChangeReason",
@@ -220,7 +220,10 @@ sap.ui.define([
 
 	/**
 	 * Makes sure the path is prepended and appended with a "/" if necessary.
-	 * @param {string} sContextPath the path to be checked
+	 *
+	 * @param {string} sContextPath The path to be checked
+	 *
+	 * @returns {string} The sanitized path
 	 */
 	ClientTreeBinding.prototype._sanitizePath = function (sContextPath) {
 		if (!sContextPath.endsWith("/")) {
@@ -291,7 +294,6 @@ sap.ui.define([
 		}
 		this._mLengthsCache = {};
 		this._fireChange({reason: "filter"});
-		// TODO remove this if the filter event is removed
 		this._fireFilter({filters: aFilters});
 
 		return this;
@@ -363,11 +365,12 @@ sap.ui.define([
 
 	/**
 	 * Sorts the contexts of this ClientTreeBinding.
-	 * The tree will be sorted level by level. So the nodes are NOT sorted absolute, but relative to their parent node,
-	 * to keep the hierarchy untouched.
+	 * The tree will be sorted level by level. So the nodes are NOT sorted absolute, but relative to
+	 * their parent node, to keep the hierarchy untouched.
 	 *
-	 * @param {sap.ui.model.Sorter[]} an array of Sorter instances which will be applied
-	 * @return {this} returns <code>this</code> to facilitate method chaining
+	 * @param {sap.ui.model.Sorter[]} aSorters An array of Sorter instances which will be applied
+	 *
+	 * @return {this} Returns <code>this</code> to facilitate method chaining
 	 * @public
 	 */
 	ClientTreeBinding.prototype.sort = function (aSorters) {
@@ -396,7 +399,10 @@ sap.ui.define([
 
 	/**
 	 * Sets the length cache.
-	 * Called by get*Contexts() to keep track of the child count (after filtering)
+	 * Called by get*Contexts() to keep track of the child count (after filtering).
+	 *
+	 * @param {string} sKey The cache entry to set the length for
+	 * @param {number} iLength The new length
 	 */
 	ClientTreeBinding.prototype._setLengthCache = function (sKey, iLength) {
 		// keep track of the child count for each context (after filtering)
@@ -407,7 +413,7 @@ sap.ui.define([
 	 * Check whether this Binding would provide new values and in case it changed,
 	 * inform interested parties about this.
 	 *
-	 * @param {boolean} bForceupdate
+	 * @param {boolean} bForceupdate Not used in this method
 	 *
 	 */
 	ClientTreeBinding.prototype.checkUpdate = function(bForceupdate){

package/src/sap/ui/model/ClientTreeBindingAdapter.js

@@ -3,7 +3,7 @@
  * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
-
+/*eslint-disable max-len */
 // Provides class sap.ui.model.odata.ODataAnnotations
 sap.ui.define([
 	'sap/ui/model/TreeBinding',
@@ -50,14 +50,6 @@ sap.ui.define([
 
 			this._invalidTree = true;
 
-			// TODO: Decide if the tree state feature should be available for ClientModels
-			//-> remove comments if yes
-
-			// restore old tree state if given
-			//if (this.mParameters.treeState) {
-			//	this.setTreeState(this.mParameters.treeState);
-			//}
-
 			//set the default auto expand mode
 			this.setNumberOfExpandedLevels(this.mParameters.numberOfExpandedLevels || 0);
 		};
@@ -205,30 +197,39 @@ sap.ui.define([
 		};
 
 		/**
-		 * Due to the tree invalidation mechanism the tree has to be rebuilt before a findNode operation.
-		 * Calling buildTree is performance-safe, as the tree is invalid anyway.
+		 * Find the first node in the tree matching the search criteria. In case the tree structure
+		 * is invalid, it is rebuilt before finding the node.
+		 *
+		 * @param {any} vParam The search criteria
+		 *
+		 * @returns {object} A tree node which may be a cached sum row
 		 */
-		ClientTreeBindingAdapter.prototype.findNode = function () {
+		ClientTreeBindingAdapter.prototype.findNode = function (vParam) {
 			this._buildTree();
 			return TreeBindingAdapter.prototype.findNode.apply(this, arguments);
 		};
 
 		/**
-		 * Due to the tree invalidation mechanism the tree has to be rebuilt before a setSelectedIndex operation.
-		 * Calling buildTree is performance-safe, as the tree is invalid anyway.
+		 * Marks a single node as selected. In case the tree structure is invalid, it is rebuilt
+		 * before a <code>setSelectedIndex</code> operation.
+		 *
+		 * @param {number} iRowIndex Row to mark as selected
 		 */
-		ClientTreeBindingAdapter.prototype.setSelectedIndex = function () {
+		ClientTreeBindingAdapter.prototype.setSelectedIndex = function (iRowIndex) {
 			this._buildTree();
-			return TreeBindingAdapter.prototype.setSelectedIndex.apply(this, arguments);
+			TreeBindingAdapter.prototype.setSelectedIndex.apply(this, arguments);
 		};
 
 		/**
-		 * Due to the tree invalidation mechanism the tree has to be rebuilt before a setSelctionInterval operation.
-		 * Calling buildTree is performance-safe, as the tree is invalid anyway.
+		 * Marks multiple nodes as selected. In case the tree structure is invalid, it is rebuilt
+		 * before a <code>setSelctionInterval</code> operation.
+		 *
+		 * @param {number} iFromIndex The first index to mark as selected
+		 * @param {number} iToIndex The last index to mark as selected
 		 */
-		ClientTreeBindingAdapter.prototype.setSelectionInterval = function () {
+		ClientTreeBindingAdapter.prototype.setSelectionInterval = function (iFromIndex, iToIndex) {
 			this._buildTree();
-			return TreeBindingAdapter.prototype.setSelectionInterval.apply(this, arguments);
+			TreeBindingAdapter.prototype.setSelectionInterval.apply(this, arguments);
 		};
 
 		/**
@@ -268,11 +269,15 @@ sap.ui.define([
 		};
 
 		/**
-		 * Calculate the request length based on the given information
+		 * Calculate the request length based on the given information.
+		 *
+		 * Because client treebinding knows the complete data from the very beginning, it returns
+		 * the maximum group size, the current section is not considered.
 		 *
-		 * Because client treebinding knows all of the data from the very beginning, it should simply return the the
-		 * maximum group size without looking at the current section.
+		 * @param {number} iMaxGroupSize The maximum group size
+		 * @param {object} oSection Information of the current section
 		 *
+		 * @returns {number} The request length
 		 */
 		ClientTreeBindingAdapter.prototype._calculateRequestLength = function(iMaxGroupSize, oSection) {
 			return iMaxGroupSize;

package/src/sap/ui/model/CompositeBinding.js

@@ -3,7 +3,7 @@
  * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
-
+/*eslint-disable max-len */
 // Provides an abstract property binding.
 sap.ui.define([
 	"./BindingMode",
@@ -28,28 +28,31 @@ sap.ui.define([
 	 * @class
 	 * Combines multiple property bindings (called 'parts') into a single one.
 	 *
-	 * A <code>CompositeBinding</code> combines the values from all its binding parts (each an instance of
-	 * <code>PropertyBinding</code>), either by calling a formatter function or by involving a
-	 * {@link sap.ui.model.CompositeType composite type}. When a formatter function is used, then the
-	 * composite binding is automatically limited to <code>OneWay</code> mode. When a type is used, the binding
-	 * can also operate in <code>TwoWay</code> mode.
+	 * A <code>CompositeBinding</code> combines the values from all its binding parts (each an
+	 * instance of <code>PropertyBinding</code>), either by calling a formatter function or by
+	 * involving a {@link sap.ui.model.CompositeType composite type}. When a formatter function is
+	 * used, the composite binding is automatically limited to <code>OneWay</code> mode. When a
+	 * type is used, the binding can also operate in <code>TwoWay</code> mode.
 	 *
-	 * Higher layers of the framework derive composite bindings from easy-to-write string representations
-	 * (the following features require complex binding syntax, e.g. <code>data-sap-ui-bindingSyntax="complex"</code>):
+	 * Higher layers of the framework derive composite bindings from easy-to-write string
+	 * representations (the following features require complex binding syntax, e.g.
+	 * <code>data-sap-ui-bindingSyntax="complex"</code>):
 	 *
 	 * XML views, for example, convert attribute values with nested curly braces like
 	 * <pre>
 	 *   text="{fullname} &amp;lt;{email}&amp;gt;"
 	 * </pre>
-	 * into a composite binding with two parts (one property binding for property "fullname" and one for
-	 * property "email") and with a generic formatter function that injects the values of the parts into
-	 * the string literal "{0} &lt;{1}&gt;" accordingly.
+	 * into a composite binding with two parts (one property binding for property "fullname" and one
+	 * for property "email") and with a generic formatter function that injects the values of the
+	 * parts into the string literal "{0} &lt;{1}&gt;" accordingly.
 	 *
-	 * Similarly, {@link topic:daf6852a04b44d118963968a1239d2c0 expression bindings} are parsed and converted
-	 * into composite bindings, too. The formatter function is created by the framework and executes the
-	 * calculations as defined by the expression string, taking the values from the binding parts as input.
+	 * Similarly, {@link topic:daf6852a04b44d118963968a1239d2c0 expression bindings} are parsed and
+	 * converted into composite bindings, too. The formatter function is created by the framework
+	 * and executes the calculations as defined by the expression string, taking the values from the
+	 * binding parts as input.
 	 *
-	 * <b>Note:</b> A nesting of composite bindings is currently not supported (albeit being helpful).
+	 * <b>Note:</b> A nesting of composite bindings is currently not supported (albeit being
+	 * helpful).
 	 *
 	 * @see {@link topic:a2fe8e763014477e87990ff50657a0d0}
 	 * @public
@@ -113,11 +116,14 @@ sap.ui.define([
 	};
 
 	/**
-	 * Sets the optional type and internal type for the binding. The type and internal type are used to do the parsing/formatting correctly.
-	 * The internal type is the property type of the element which the value is formatted to.
+	 * Sets the optional type and internal type for the binding. The type and internal type are used
+	 * to do the parsing/formatting correctly. The internal type is the property type of the element
+	 * which the value is formatted to.
 	 *
-	 * @param {sap.ui.model.CompositeType} oType the type for the binding
-	 * @param {string} sInternalType the internal type of the element property which this binding is bound against.
+	 * @param {sap.ui.model.CompositeType} oType
+	 *   The type for the binding
+	 * @param {string} sInternalType
+	 *   The internal type of the element property which this binding is bound against.
 	 *
 	 * @public
 	 */
@@ -197,7 +203,7 @@ sap.ui.define([
 	 * Sets the values. This will cause the setValue to be called for each nested binding, except
 	 * for undefined values in the array.
 	 *
-	 * @param {array} aValues the values to set for this binding
+	 * @param {array} aValues The values to set for this binding
 	 *
 	 * @public
 	 */
@@ -218,7 +224,7 @@ sap.ui.define([
 	/**
 	 * Returns the raw values of the property bindings in an array.
 	 *
-	 * @return {object} the values of the internal property bindings in an array
+	 * @return {object} The values of the internal property bindings in an array
 	 *
 	 * @public
 	 */
@@ -235,9 +241,10 @@ sap.ui.define([
 	};
 
 	/**
-	 * Returns the current external value of the bound target which is formatted via a type or formatter function.
+	 * Returns the current external value of the bound target which is formatted via a type or
+	 * formatter function.
 	 *
-	 * @return {object} the current value of the bound target
+	 * @return {object} The current value of the bound target
 	 *
 	 * @throws {sap.ui.model.FormatException}
 	 *
@@ -275,12 +282,13 @@ sap.ui.define([
 	};
 
 	/**
-	 * Sets the external value of a composite binding. If no CompositeType is assigned to the binding, the default
-	 * implementation assumes a space separated list of values. This will cause the setValue to be called for each
-	 * nested binding, except for undefined values in the array.
+	 * Sets the external value of a composite binding. If no CompositeType is assigned to the
+	 * binding, the default implementation assumes a space-separated list of values. This will cause
+	 * the setValue to be called for each nested binding, except for undefined values in the array.
+	 *
+	 * @param {object} oValue The value to set for this binding
+	 * @return {undefined|Promise} A promise in case of asynchronous type parsing or validation
 	 *
-	 * @param {object} oValue the value to set for this binding
-	 * @return {undefined|Promise} a promise in case of asynchronous type parsing or validation
 	 * @throws sap.ui.model.ParseException
 	 * @throws sap.ui.model.ValidateException
 	 *
@@ -292,10 +300,10 @@ sap.ui.define([
 
 		if (this.sInternalType === "raw") {
 			this.setRawValue(oValue);
-			return;
+			return undefined;
 		} else if (this.sInternalType === "internal") {
 			this.setInternalValue(oValue);
-			return;
+			return undefined;
 		}
 
 		oInternalType = this.sInternalType && DataType.getType(this.sInternalType);
@@ -303,7 +311,7 @@ sap.ui.define([
 		// No twoway binding when using formatters
 		if (this.fnFormatter) {
 			Log.warning("Tried to use twoway binding, but a formatter function is used");
-			return;
+			return undefined;
 		}
 
 		oDataState = this.getDataState();
@@ -358,10 +366,10 @@ sap.ui.define([
 	};
 
 	/**
-	 * Returns the current internal value of the bound target which is an array of the
-	 * internal (JS native) values of nested bindings
+	 * Returns the current internal value of the bound target which is an array of the internal (JS
+	 * native) values of nested bindings.
 	 *
-	 * @return {array} the current values of the nested bindings
+	 * @return {array} The current values of the nested bindings
 	 *
 	 * @public
 	 */
@@ -372,10 +380,11 @@ sap.ui.define([
 	};
 
 	/**
-	 * Sets the internal value of the bound target. Parameter must be an array of
-	 * values matching the internal (JS native) types of nested bindings.
+	 * Sets the internal value of the bound target. Parameter must be an array of values matching
+	 * the internal (JS native) types of nested bindings.
 	 *
 	 * @param {array} aValues the new values of the nested bindings
+	 * @return {undefined|Promise} A promise in case of asynchronous type parsing or validation
 	 *
 	 * @public
 	 */
@@ -421,10 +430,10 @@ sap.ui.define([
 	};
 
 	/**
-	 * Returns the current raw value of the bound target which is an array of the
-	 * raw (model) values of nested bindings
+	 * Returns the current raw value of the bound target which is an array of the raw (model)
+	 * values of nested bindings.
 	 *
-	 * @return {array} the current values of the nested bindings
+	 * @return {array} The current values of the nested bindings
 	 *
 	 * @public
 	 */
@@ -435,10 +444,11 @@ sap.ui.define([
 	};
 
 	/**
-	 * Sets the raw value of the bound target. Parameter must be an array of
-	 * values matching the raw (model) types of nested bindings.
+	 * Sets the raw value of the bound target. Parameter must be an array of values matching the raw
+	 * (model) types of nested bindings.
 	 *
 	 * @param {array} aValues the new values of the nested bindings
+	 * @return {undefined|Promise} A promise in case of asynchronous type parsing or validation
 	 *
 	 * @public
 	 */
@@ -510,6 +520,7 @@ sap.ui.define([
 	 * method always gets the full set of values to validate, even if partial updates are
 	 * used.
 	 *
+	 * @param {any[]} aValues Values to fill empty current values with
 	 * @return {array} Array of values used for validation
 	 *
 	 * @private
@@ -532,7 +543,7 @@ sap.ui.define([
 	/**
 	 * Returns the property bindings contained in this composite binding.
 	 *
-	 * @return {array} the property bindings in this composite binding
+	 * @return {array} The property bindings in this composite binding
 	 *
 	 * @public
 	 */
@@ -540,11 +551,11 @@ sap.ui.define([
 		return this.aBindings;
 	};
 
-
 	/**
 	 * {@see sap.ui.model.Binding#hasValidation}
 	 *
-	 * @returns {boolean} Returns true if the binding throws a validation exception when an invalid value is set on it.
+	 * @returns {boolean}
+	 *   Whether the binding throws a validation exception when an invalid value is set on it
 	 * @private
 	 */
 	CompositeBinding.prototype.hasValidation = function() {
@@ -570,11 +581,12 @@ sap.ui.define([
 	 * Attaches event handler <code>fnFunction</code> to the <code>change</code> event of this
 	 * <code>sap.ui.model.CompositeBinding</code>.
 	 *
-	 * When called, the context of the event handler (its <code>this</code>) will be bound to <code>oListener</code>
-	 * if specified, otherwise it will be bound to this <code>sap.ui.model.CompositeBinding</code> itself.
+	 * When called, the context of the event handler (its <code>this</code>) will be bound to
+	 * <code>oListener</code> if specified, otherwise it will be bound to this
+	 * <code>sap.ui.model.CompositeBinding</code> itself.
 	 *
 	 * @param {function} fnFunction The function to be called, when the event occurs
-	 * @param {object} [oListener] object on which to call the given function
+	 * @param {object} [oListener] Object on which to call the given function
 	 * @protected
 	 */
 	CompositeBinding.prototype.attachChange = function(fnFunction, oListener) {
@@ -605,7 +617,7 @@ sap.ui.define([
 	 * <code>sap.ui.model.CompositeBinding</code>.
 	 *
 	 * @param {function} fnFunction The function to be called, when the event occurs
-	 * @param {object} [oListener] object on which to call the given function
+	 * @param {object} [oListener] Object on which to call the given function
 	 * @protected
 	 */
 	CompositeBinding.prototype.detachChange = function(fnFunction, oListener) {
@@ -619,14 +631,15 @@ sap.ui.define([
 	};
 
 	/**
-	 * Attaches event handler <code>fnFunction</code> to the <code>DataStateChange</code> event of this
-	 * <code>sap.ui.model.CompositeBinding</code>.
+	 * Attaches event handler <code>fnFunction</code> to the <code>DataStateChange</code> event of
+	 * this <code>sap.ui.model.CompositeBinding</code>.
 	 *
-	 * When called, the context of the event handler (its <code>this</code>) will be bound to <code>oListener</code>
-	 * if specified, otherwise it will be bound to this <code>sap.ui.model.CompositeBinding</code> itself.
+	 * When called, the context of the event handler (its <code>this</code>) will be bound to
+	 * <code>oListener</code> if specified, otherwise it will be bound to this
+	 * <code>sap.ui.model.CompositeBinding</code> itself.
 	 *
 	 * @param {function} fnFunction The function to be called, when the event occurs
-	 * @param {object} [oListener] object on which to call the given function
+	 * @param {object} [oListener] Object on which to call the given function
 	 * @protected
 	 */
 	CompositeBinding.prototype.attachDataStateChange = function(fnFunction, oListener) {
@@ -652,7 +665,7 @@ sap.ui.define([
 	 * this <code>sap.ui.model.CompositeBinding</code>.
 	 *
 	 * @param {function} fnFunction The function to be called, when the event occurs
-	 * @param {object} [oListener] object on which to call the given function
+	 * @param {object} [oListener] Object on which to call the given function
 	 * @protected
 	 */
 	CompositeBinding.prototype.detachDataStateChange = function(fnFunction, oListener) {
@@ -666,15 +679,15 @@ sap.ui.define([
 	};
 
 	/**
-	 * Attaches event handler <code>fnFunction</code> to the <code>AggregatedDataStateChange</code> event of this
-	 * <code>sap.ui.model.CompositeBinding</code>.
+	 * Attaches event handler <code>fnFunction</code> to the <code>AggregatedDataStateChange</code>
+	 * event of this <code>sap.ui.model.CompositeBinding</code>.
 	 *
-	 * The <code>AggregatedDataStateChange</code> event is fired asynchronously, meaning that the <code>DataState</code>
-	 * object given as parameter of the event contains all changes that were applied to the <code>DataState</code>
-	 * in the running thread.
+	 * The <code>AggregatedDataStateChange</code> event is fired asynchronously, meaning that the
+	 * <code>DataState</code> object given as parameter of the event contains all changes that were
+	 * applied to the <code>DataState</code> in the running thread.
 	 *
 	 * @param {function} fnFunction The function to be called, when the event occurs
-	 * @param {object} [oListener] object on which to call the given function.
+	 * @param {object} [oListener] Object on which to call the given function
 	 * @protected
 	 */
 	CompositeBinding.prototype.attachAggregatedDataStateChange = function(fnFunction, oListener) {
@@ -700,11 +713,12 @@ sap.ui.define([
 	};
 
 	/**
-	 * Detaches event handler <code>fnFunction</code> from the <code>AggregatedDataStateChange</code>
-	 * event of this <code>sap.ui.model.CompositeBinding</code>.
+	 * Detaches event handler <code>fnFunction</code> from the
+	 * <code>AggregatedDataStateChange</code> event of this
+	 * <code>sap.ui.model.CompositeBinding</code>.
 	 *
 	 * @param {function} fnFunction The function to be called, when the event occurs
-	 * @param {object} [oListener] object on which to call the given function
+	 * @param {object} [oListener] Object on which to call the given function
 	 * @protected
 	 */
 	CompositeBinding.prototype.detachAggregatedDataStateChange = function(fnFunction, oListener) {
@@ -717,11 +731,12 @@ sap.ui.define([
 		}
 	};
 
-
 	/**
-	 * Determines if the property bindings in the composite binding should be updated by calling updateRequired on all property bindings with the specified model.
+	 * Determines if the property bindings in the composite binding should be updated by calling
+	 * updateRequired on all property bindings with the specified model.
+	 *
 	 * @param {object} oModel The model instance to compare against
-	 * @returns {boolean} true if this binding should be updated
+	 * @returns {boolean} Whether this binding should be updated
 	 * @protected
 	 */
 	CompositeBinding.prototype.updateRequired = function(oModel) {
@@ -735,9 +750,11 @@ sap.ui.define([
 	/**
 	 * Initialize the binding. The method should be called when creating a binding.
 	 * The default implementation calls checkUpdate(true).
-	 * Prevent checkUpdate to be triggered while initializing nestend bindings, it is
+	 * Prevent checkUpdate to be triggered while initializing nested bindings, it is
 	 * sufficient to call checkUpdate when all nested bindings are initialized.
 	 *
+	 * @returns {this} A reference to itself
+	 *
 	 * @protected
 	 */
 	CompositeBinding.prototype.initialize = function() {
@@ -756,8 +773,9 @@ sap.ui.define([
 
 
 	/**
-	 * Returns the data state for this binding
-	 * @return {sap.ui.model.CompositeDataState} the data state
+	 * Returns the data state for this binding.
+	 *
+	 * @return {sap.ui.model.CompositeDataState} The data state
 	 */
 	CompositeBinding.prototype.getDataState = function() {
 		if (!this.oDataState) {
@@ -771,9 +789,11 @@ sap.ui.define([
 	/**
 	 * Suspends the binding update. No change events will be fired.
 	 *
-	 * A refresh call with bForceUpdate set to true will also update the binding and fire a change in suspended mode.
-	 * Special operations on bindings, which require updates to work properly (as paging or filtering in list bindings)
-	 * will also update and cause a change event although the binding is suspended.
+	 * A refresh call with bForceUpdate set to true will also update the binding and fire a change
+	 * in suspended mode. Special operations on bindings, which require updates to work properly
+	 * (as paging or filtering in list bindings) will also update and cause a change event although
+	 * the binding is suspended.
+	 *
 	 * @public
 	 */
 	CompositeBinding.prototype.suspend = function() {
@@ -786,9 +806,11 @@ sap.ui.define([
 	/**
 	 * Suspends the binding update. No change events will be fired.
 	 *
-	 * A refresh call with bForceUpdate set to true will also update the binding and fire a change in suspended mode.
-	 * Special operations on bindings, which require updates to work properly (as paging or filtering in list bindings)
-	 * will also update and cause a change event although the binding is suspended.
+	 * A refresh call with bForceUpdate set to true will also update the binding and fire a change
+	 * in suspended mode. Special operations on bindings, which require updates to work properly
+	 * (as paging or filtering in list bindings) will also update and cause a change event although
+	 * the binding is suspended.
+	 *
 	 * @public
 	 */
 	CompositeBinding.prototype.resume = function() {
@@ -803,7 +825,7 @@ sap.ui.define([
 	 * Check whether this Binding would provide new values and in case it changed,
 	 * inform interested parties about this.
 	 *
-	 * @param {boolean} bForceupdate
+	 * @param {boolean} bForceUpdate Whether an update should be forced
 	 *
 	 */
 	CompositeBinding.prototype.checkUpdate = function(bForceUpdate){
@@ -842,5 +864,4 @@ sap.ui.define([
 	};
 
 	return CompositeBinding;
-
 });

package/src/sap/ui/model/CompositeDataState.js

@@ -3,7 +3,7 @@
  * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
-
+/*eslint-disable max-len */
 sap.ui.define(['./DataState', "sap/base/util/deepEqual", "sap/base/util/each"], function(DataState, deepEqual, each) {
 	"use strict";
 
@@ -14,7 +14,7 @@ sap.ui.define(['./DataState', "sap/base/util/deepEqual", "sap/base/util/each"],
 	 * @extends sap.ui.model.DataState
 	 *
 	 * @author SAP SE
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 *
 	 * @public
 	 * @alias sap.ui.model.CompositeDataState

package/src/sap/ui/model/CompositeType.js

@@ -3,7 +3,7 @@
  * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
-
+/*eslint-disable max-len */
 // Provides the base implementation for all composite type implementations
 sap.ui.define(['./SimpleType'],
 	function (SimpleType) {
@@ -39,7 +39,7 @@ sap.ui.define(['./SimpleType'],
 	 *   <code>true</code>.
 	 * @extends sap.ui.model.SimpleType
 	 * @public
-	 * @version 1.93.3
+	 * @version 1.96.2
 	 */
 	var CompositeType = SimpleType.extend("sap.ui.model.CompositeType", /** @lends sap.ui.model.CompositeType.prototype */ {
 

package/src/sap/ui/model/Context.js

@@ -3,7 +3,7 @@
  * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
-
+/*eslint-disable max-len */
 // Provides an abstraction for model bindings
 sap.ui.define(['sap/ui/base/Object', "sap/base/util/isPlainObject"],
 	function(BaseObject, isPlainObject) {
@@ -203,7 +203,9 @@ sap.ui.define(['sap/ui/base/Object', "sap/base/util/isPlainObject"],
 	};
 
 	/**
-	 * toString method returns path for compatibility
+	 * Returns the path of this Context instance.
+	 *
+	 * @returns {string} The path
 	 */
 	Context.prototype.toString = function() {
 		return this.sPath;

package/src/sap/ui/model/ContextBinding.js

@@ -3,7 +3,7 @@
  * (c) Copyright 2009-2021 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.
  */
-
+/*eslint-disable max-len */
 // Provides an abstraction for list bindings
 sap.ui.define(['./Binding'],
 	function(Binding) {
@@ -43,28 +43,20 @@ sap.ui.define(['./Binding'],
 	});
 
 	/**
-	 * Check whether this Binding would provide new values and in case it changed,
-	 * inform interested parties about this.
+	 * Check whether this Binding would provide new values and in case it changed, inform interested
+	 * parties about this.
 	 *
-	 * @param {boolean} bForceupdate
+	 * @param {boolean} bForceupdate Ignored in this method
 	 */
 	ContextBinding.prototype.checkUpdate = function(bForceupdate) {
 		// nothing to do here, data changes can not change the context
 	};
 
-	/**
-	 * Refreshes the binding, check whether the model data has been changed and fire change event
-	 * if this is the case. For server side models this should refetch the data from the server.
-	 *
-	 * @param {boolean} bForceUpdate Does not have any effect on this binding
-	 *
-	 * @public
-	 */
-
 	/**
 	 * Return the bound context.
 	 *
-	 * @returns {sap.ui.model.Context} Context object used by this context binding or <code>null</code>
+	 * @returns {sap.ui.model.Context}
+	 *   Context object used by this context binding or <code>null</code>
 	 * @public
 	 */
 	ContextBinding.prototype.getBoundContext = function() {