@openui5/sap.ui.mdc 1.141.2 → 1.143.0

package/src/sap/ui/mdc/field/FieldBase.js

@@ -101,7 +101,7 @@ sap.ui.define([
 	 * @implements sap.ui.core.IFormContent, sap.ui.core.ISemanticFormContent, sap.m.IOverflowToolbarContent, sap.ui.core.ILabelable
 	 *
 	 * @author SAP SE
-	 * @version 1.141.2
+	 * @version 1.143.0
 	 *
 	 * @constructor
 	 * @alias sap.ui.mdc.field.FieldBase
@@ -118,7 +118,13 @@ sap.ui.define([
 	 */
 	const FieldBase = Control.extend("sap.ui.mdc.field.FieldBase", /* @lends sap.ui.mdc.field.FieldBase.prototype */ {
 		metadata: {
-			interfaces: ["sap.ui.core.IFormContent", "sap.ui.core.ISemanticFormContent", "sap.m.IOverflowToolbarContent", "sap.ui.core.ILabelable"],
+			interfaces: [
+				"sap.ui.core.IFormContent",
+				"sap.ui.core.ISemanticFormContent",
+				"sap.m.IOverflowToolbarContent",
+				"sap.ui.core.ILabelable",
+				"sap.m.IToolbarInteractiveControl"
+			],
 			designtime: "sap/ui/mdc/designtime/field/FieldBase.designtime",
 			library: "sap.ui.mdc",
 			properties: {
@@ -136,7 +142,7 @@ sap.ui.define([
 				},
 
 				/**
-				 * The constraints of the type specified in <code>dataType</code>.
+				 * The constraints of the type specified in {@link #setDataType dataType}.
 				 */
 				dataTypeConstraints: {
 					type: "object",
@@ -145,7 +151,7 @@ sap.ui.define([
 				},
 
 				/**
-				 * The format options of the type specified in <code>dataType</code>.
+				 * The format options of the type specified in {@link #setDataType dataType}.
 				 */
 				dataTypeFormatOptions: {
 					type: "object",
@@ -217,7 +223,7 @@ sap.ui.define([
 				 * Visualizes the validation state of the control, for example, <code>Error</code>, <code>Warning</code> or <code>Success</code>.
 				 *
 				 * <b>Note:</b> The visualization of the <code>ValueState</code> property is handled by the inner rendered control.
-				 * If a control is set (using <code>content</code>, <code>contentEdit</code>, or <code>contentDisplay</code>), this control needs to support
+				 * If a control is set (using {@link #setContent content}, {@link #setContentEdit contentEdit}, or {@link #setContentDisplay contentDisplay}), this control needs to support
 				 * the <code>valueState</code> behavior, otherwise <code>valueState</code> is not visualized.
 				 */
 				valueState: {
@@ -251,7 +257,7 @@ sap.ui.define([
 				 *
 				 * This property is only used for single-value fields.
 				 *
-				 * <b>Note</b> If the data type used doesn't support multiple lines, an error is thrown.
+				 * <b>Note:</b> If the data type used doesn't support multiple lines, an error is thrown.
 				 */
 				multipleLines: {
 					type: "boolean",
@@ -264,7 +270,7 @@ sap.ui.define([
 				 *
 				 * The default value of -1 indicates that an unlimited number of conditions can be defined.
 				 *
-				 * <b>Note</b> If the data type used doesn't support multiple conditions, an error is thrown.
+				 * <b>Note:</b> If the data type used doesn't support multiple conditions, an error is thrown.
 				 */
 				maxConditions: {
 					type: "int",
@@ -278,8 +284,8 @@ sap.ui.define([
 				 * These should be bound to a {@link sap.ui.mdc.FilterBar FilterBar} using the corresponding <code>propertyPath</code>.
 				 *
 				 * <b>Note:</b> For {@link sap.ui.mdc.FilterField FilterField} controls, the <code>conditions</code> property is used to bind
-				 * {@link sap.ui.mdc.FilterField FilterField} to its parent {@link @link sap.ui.mdc.FilterBar FilterBar}.</br>
-				 * If this property is not explicitly configured, the {@link @link sap.ui.mdc.FilterBar FilterBar} sets a default binding.
+				 * {@link sap.ui.mdc.FilterField FilterField} to its parent {@link sap.ui.mdc.FilterBar FilterBar}.</br>
+				 * If this property is not explicitly configured, the {@link sap.ui.mdc.FilterBar FilterBar} sets a default binding.
 				 * For example, for a {@link sap.ui.mdc.FilterField FilterField} control inside a {@link sap.ui.mdc.FilterBar FilterBar} control, the binding looks like this:</br>
 				 * <code>conditions="{$filters>/conditions/propertyPath}"</code> with the following data:
 				 * <ul>
@@ -337,11 +343,11 @@ sap.ui.define([
 				/**
 				 * If set, an empty <code>Field</code> renders an empty indicator in display mode.
 				 *
-				 * This property only takes effect if <code>editMode</code> is set to <code>Display</code>.
+				 * This property only takes effect if {@link #setEditMode editMode} is set to <code>Display</code>.
 				 *
-				 * <b>Note</b> Empty means the <code>Field</code> holds no value. If an empty string is a valid value,
-				 * the <code>Field</code> might show nothing, depending on the <code>display</code> settings and assigned description
-				 * or <code>ValueHelp</code>.
+				 * <b>Note:</b> Empty means the <code>Field</code> holds no value. If an empty string is a valid value,
+				 * the <code>Field</code> might show nothing, depending on the {@link #setDisplay display} settings and assigned description
+				 * or {@link #setValueHelp ValueHelp}.
 				 *
 				 * @since 1.85.0
 				 */
@@ -388,7 +394,7 @@ sap.ui.define([
 				/**
 				 * Optional content that can be rendered.
 				 *
-				 * Per default, depending on <code>editMode</code>, <code>multipleLines</code> and the used data type, a content control is rendered. For simple string types, a {@link sap.m.Text Text}
+				 * Per default, depending on {@link #getEditMode editMode}, {@link #getMultipleLines multipleLines} and the used data type, a content control is rendered. For simple string types, a {@link sap.m.Text Text}
 				 * control is rendered in display mode and a {@link sap.m.Input Input} control in edit mode. If a control is assigned in the <code>content</code> aggregation, this will be
 				 * rendered instead.
 				 *
@@ -408,9 +414,9 @@ sap.ui.define([
 				},
 
 				/**
-				 * Optional content to be rendered if the <code>editMode</code> property is not set to <code>Display</code>.
+				 * Optional content to be rendered if the {@link #getEditMode editMode} property is not set to <code>Display</code>.
 				 *
-				 * Per default, depending on <code>multipleLines</code> and the used data type, a content control is rendered in edit mode. For simple string types, an {@link sap.m.Input Input}
+				 * Per default, depending on {@link #getMultipleLines multipleLines} and the used data type, a content control is rendered in edit mode. For simple string types, an {@link sap.m.Input Input}
 				 * control is rendered in edit mode. If a control is assigned in the <code>contentEdit</code> aggregation, this will be rendered instead.
 				 *
 				 * <b>Note:</b> If a control is assigned to the <code>content</code> aggregation, this one is ignored.
@@ -433,9 +439,9 @@ sap.ui.define([
 				},
 
 				/**
-				 * Optional content to be rendered  if the <code>editMode</code> property is set to <code>Display</code>.
+				 * Optional content to be rendered  if the {@link #getEditMode editMode} property is set to <code>Display</code>.
 				 *
-				 * Per default, depending on <code>multipleLines</code> and the used data type, a content control is rendered in display mode. For simple string types, a {@link sap.m.Text Text}
+				 * Per default, depending on {@link #getMultipleLines multipleLines} and the used data type, a content control is rendered in display mode. For simple string types, a {@link sap.m.Text Text}
 				 * control is rendered in display mode. If a control is assigned in the <code>contentDisplay</code> aggregation, this will be rendered instead.
 				 *
 				 * <b>Note:</b> If a control is assigned to the <code>content</code> aggregation, this one is ignored.
@@ -486,7 +492,7 @@ sap.ui.define([
 				 * <b>Note:</b> If the field is inside of a table, do not set the <code>ValueHelp</code> instance as <code>dependent</code>
 				 * to the field. If you do, every field instance in every table row gets a clone of it.
 				 * Put the <code>ValueHelp</code> instance e.g. as dependent on the table or page.
-				 * The <code>FieldHelp</code> instance must be somewhere in the control tree, otherwise there might
+				 * The <code>ValueHelp</code> instance must be somewhere in the control tree, otherwise there might
 				 * be rendering or update issues.
 				 *
 				 * <b>Note:</b> For <code>Boolean</code> fields, no <code>ValueHelp</code> should be added, but a default <code>ValueHelp</code> used instead.
@@ -500,12 +506,12 @@ sap.ui.define([
 				/**
 				 * Optional <code>ValueHelp</code>.
 				 *
-				 * This is an association that allows the usage of one <code>ValueHelp</code> instance for multiple fields.
+				 * This is an association that allows the usage of one {@link sap.ui.mdc.ValueHelp ValueHelp} instance for multiple fields.
 				 *
-				 * <b>Note:</b> If the field is inside of a table, do not set the <code>ValueHelp</code> instance as <code>dependent</code>
+				 * <b>Note:</b> If the field is inside of a table, do not set the {@link sap.ui.mdc.ValueHelp ValueHelp} instance as {@link sap.ui.core.Element#addDependent dependent}
 				 * to the field. If you do, every field instance in every table row gets a clone of it.
-				 * Put the <code>ValueHelp</code> instance e.g. as dependent on the table or page.
-				 * The <code>ValueHelp</code> instance must be somewhere in the control tree, otherwise there might
+				 * Put the {@link sap.ui.mdc.ValueHelp ValueHelp} instance e.g. as {@link sap.ui.core.Element#addDependent dependent} on the table or page.
+				 * The {@link sap.ui.mdc.ValueHelp ValueHelp} instance must be somewhere in the control tree, otherwise there might
 				 * be rendering or update issues.
 				 *
 				 * <b>Note:</b> For <code>Boolean</code> fields, no <code>ValueHelp</code> should be added, but a default <code>ValueHelp</code> used instead.
@@ -524,7 +530,7 @@ sap.ui.define([
 				/**
 				 * This event is fired when the value of the field is changed, for example, each time a key is pressed.
 				 *
-				 * <b>Note</b> This event is only triggered if the used content control has a <code>liveChange</code> event.
+				 * <b>Note:</b> This event is only triggered if the used content control has a <code>liveChange</code> event.
 				 */
 				liveChange: {
 					parameters: {
@@ -534,12 +540,12 @@ sap.ui.define([
 						value: { type: "string" },
 
 						/**
-						 * Indicates that the ESC key triggered the event
+						 * Indicates that the <kbd>ESC</kbd> key triggered the event
 						 */
 						escPressed: { type: "boolean" },
 
 						/**
-						 * The value of the input before pressing ESC key
+						 * The value of the input before pressing <kbd>ESC</kbd> key
 						 */
 						previousValue: { type: "string" }
 					}
@@ -552,7 +558,7 @@ sap.ui.define([
 				 * This event is fired when the user presses <kbd>Enter</kbd>.
 				 * It allows the application to implement some submit logic.
 				 *
-				 * <b>Note</b> This event is only triggered if the field is editable.
+				 * <b>Note:</b> This event is only triggered if the field is editable.
 				 *
 				 * @since 1.82.0
 				 */
@@ -631,7 +637,12 @@ sap.ui.define([
 				"contentEdit",
 				"contentDisplay"
 			],
-			associations: ["fieldHelp", "valueHelp", "ariaLabelledBy"]
+			associations: [
+				/** @deprecated As of version 1.114 */
+				"fieldHelp",
+				"valueHelp",
+				"ariaLabelledBy"
+			]
 		});
 
 		this.attachEvent("modelContextChange", this.handleModelContextChange, this);
@@ -1311,7 +1322,7 @@ sap.ui.define([
 	};
 
 	/**
-	 * Handler of the <code>ModelContextChange</code> event.
+	 * Handler of the {@link sap.ui.base.ManagedObject#event:modelContextChange modelContextChange} event.
 	 * @param {object} oEvent event
 	 * @protected
 	 */
@@ -1412,7 +1423,13 @@ sap.ui.define([
 			this.getContentFactory().updateConditionType();
 		}
 
-		if ((oChanges.name === "fieldHelp" || oChanges.name === "valueHelp") && oChanges.ids) {
+		if (oChanges.name === "valueHelp" && oChanges.ids) {
+			_valueHelpChanged.call(this, oChanges.ids, oChanges.mutation);
+			this.getContentFactory().updateConditionType();
+		}
+
+		/** @deprecated As of version 1.114 */
+		if (oChanges.name === "fieldHelp" && oChanges.ids) {
 			_valueHelpChanged.call(this, oChanges.ids, oChanges.mutation);
 			this.getContentFactory().updateConditionType();
 		}
@@ -1688,7 +1705,7 @@ sap.ui.define([
 	 * Registers invalidations event that is fired when width of the control is changed.
 	 *
 	 * @protected
-	 * @returns {object} Configuration information for the <code>sap.m.IOverflowToolbarContent</code> interface.
+	 * @returns {object} Configuration information for the {@link sap.m.IOverflowToolbarContent} interface.
 	 */
 	FieldBase.prototype.getOverflowToolbarConfig = function() {
 		return {
@@ -1703,6 +1720,25 @@ sap.ui.define([
 		};
 	};
 
+	/**
+	 * Returns whether the control is interactive or not.
+	 *
+	 * @returns {boolean} Whether it is an interactive Control
+	 * @private
+	 */
+	FieldBase.prototype._getToolbarInteractive = function() {
+		let bHasInteractiveContent = false;
+
+		const aContent = this.getCurrentContent();
+		if (aContent.length > 0) {
+			bHasInteractiveContent = aContent.reduce((bInteractive, oContent) => {
+				return bInteractive || oContent._getToolbarInteractive?.();
+			}, bHasInteractiveContent);
+		}
+
+		return bHasInteractiveContent;
+	};
+
 	/*
 	 * If Field is inside of a Form use Forms aria logic for label
 	 */
@@ -1805,10 +1841,10 @@ sap.ui.define([
 	}
 
 	/**
-	 * Assigns a <code>Label</code> control to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.MultiValueField MultiValueField}, or {@link sap.ui.mdc.FilterField FilterField} controls.
+	 * Assigns a {@link sap.m.Label Label} control to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.MultiValueField MultiValueField}, or {@link sap.ui.mdc.FilterField FilterField} controls.
 	 *
 	 * The text of the label is taken from the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.MultiValueField MultiValueField}, or {@link sap.ui.mdc.FilterField FilterField} controls.
-	 * The <code>labelFor</code> association is set to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.MultiValueField MultiValueField}, or {@link sap.ui.mdc.FilterField FilterField} control.
+	 * The {@link sap.m.Label#setLabelFor labelFor} association is set to the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.MultiValueField MultiValueField}, or {@link sap.ui.mdc.FilterField FilterField} control.
 	 *
 	 * @param {sap.ui.core.Label} oLabel Label control
 	 * @returns {this} Reference to <code>this</code> to allow method chaining
@@ -2104,6 +2140,9 @@ sap.ui.define([
 
 	};
 
+	/**
+	 * @this {sap.ui.mdc.field.FieldBase}
+	 */
 	function _createInternalContent() {
 
 		if (this.isFieldDestroyed()) {
@@ -2415,7 +2454,7 @@ sap.ui.define([
 	 * Resets invalid input information.
 	 *
 	 * Might be called if Binding changes or field is initialized.
-	 * @param {boolean} bRemoveUIMessage If set to <code>true</code> the <code>ValueState</code> and <code>ValueStateText</code> is removed
+	 * @param {boolean} bRemoveUIMessage If set to <code>true</code> the {@link #getValueState ValueState} and {@link #getValueStateText ValueStateText} is removed
 	 * @protected
 	 */
 	FieldBase.prototype.resetInvalidInput = function(bRemoveUIMessage) {
@@ -2886,13 +2925,20 @@ sap.ui.define([
 		}
 	}
 
-	// TODO: remove this function and replace by getValueHelp once FieldHelp association is completetly removed.
+	/**
+	 * @deprecated As of 1.114.0, together with `fieldHelp` association
+	 * @ui5-transform-hint replace-call getValueHelp
+	 * @private
+	 */
 	FieldBase.prototype._getValueHelp = function() {
 
 		return this.getValueHelp() || (this.getFieldHelp && this.getFieldHelp()); // as getFieldHelp not exist in legacy-free UI5
 
 	};
 
+	/**
+	 * @this {sap.ui.mdc.field.FieldBase}
+	 */
 	function _getValueHelp() {
 
 		let sId = this._getValueHelp();
@@ -3173,6 +3219,9 @@ sap.ui.define([
 
 			if (!bError) {
 				this.setProperty("conditions", aConditions, true); // do not invalidate whole field
+				if (this.shouldFireValidationSuccessOnConditionUpdate(aConditions)) {
+					_fireValidationSuccessForContent.call(this, oContent);
+				}
 			}
 
 			if (!FilterOperatorUtil.compareConditionsArray(aConditions, aConditionsOld)) { // update only if real change
@@ -3181,26 +3230,8 @@ sap.ui.define([
 				_triggerChange.call(this, aConditions, true);
 			}
 		} else if (bChangeAfterError) { // last valid value choosen again
+			_fireValidationSuccessForContent.call(this, oContent);
 			_triggerChange.call(this, aConditions, true);
-
-			if (oContent) { // fire validation success on content directly, as triggered only after ENTER or Focusout. (As we don't know the internal content behaviour we cannot just fake ENTER or Focusout)
-				for (const sProperty in oContent.getMetadata().getAllProperties()) {
-					if (oContent.getBindingPath(sProperty) === "/conditions") {
-						const oBinding = oContent.getBinding(sProperty);
-						const oType = oBinding?.getType();
-						if (oType instanceof ConditionsType) {
-							oContent.fireValidationSuccess({
-									element: oContent,
-									property: sProperty,
-									type: oType,
-									newValue: oContent.getDOMValue?.(),
-									oldValue: oContent.getProperty(sProperty)
-								}, false, true); // bAllowPreventDefault, bEnableEventBubbling
-							break;
-						}
-					}
-				}
-			}
 		}
 	}
 
@@ -4003,8 +4034,8 @@ sap.ui.define([
 
 	/**
 	 * Returns whether the given property value is initial and has not been explicitly set or no binding exist.
-	 * Even after setting the default value or setting null/undefined (which also causes the default value to be set),
-	 * the property is no longer initial. A property can be reset to initial state by calling <code>resetProperty(sPropertyName)</code>.
+	 * Even after setting the default value or setting <code>null</code>/<code>undefined</code> (which also causes the default value to be set),
+	 * the property is no longer initial. A property can be reset to initial state by calling <code>{@link sap.ui.base.ManagedObject#resetProperty resetProperty}(sPropertyName)</code>.
 	 *
 	 * @param {string} sPropertyName the name of the property
 	 * @returns {boolean} true if the property is initial
@@ -4040,11 +4071,11 @@ sap.ui.define([
 	 * Returns the user interaction state of the control.
 	 *
 	 * If the user starts typing or navigates via arrow keys in a value help,
-	 * the shown value might be updated. But as long as the user has not left the field or pressed the Enter key,
+	 * the shown value might be updated. But as long as the user has not left the field or pressed the <kbd>Enter</kbd> key,
 	 * the current user input will not be validated or updated or an event fired.
 	 *
 	 * As long as the user is interacting with the field, this function returns <code>true</code>.
-	 * If the user interaction has been completed because the user has left the field, pressed the Enter key,
+	 * If the user interaction has been completed because the user has left the field, pressed the <kbd>Enter</kbd> key,
 	 * or chosen a value from the value help, the function returns <code>false</code>.
 	 * @returns {boolean} <code>true</code> if there is a pending user input
 	 * @protected
@@ -4059,9 +4090,9 @@ sap.ui.define([
 	/**
 	 * Returns the configuration for the additional data type.
 	 *
-	 * For a {@link sap.ui.mdc.Field Field}, the data type is determined from the binding of the <code>additionalValue</code>.
-	 * For a {@link sap.ui.mdc.MultiValueField MultiValueField}, the data type is determined from the binding of the <code>description</code> of an item.
-	 * For a {@link sap.ui.mdc.FilterField FilterField}, the data type is provided via the <code>additionalDataType</code> property.
+	 * For a {@link sap.ui.mdc.Field Field}, the data type is determined from the binding of the {@link sap.ui.mdc.Field#getAdditionalValue additionalValue}.
+	 * For a {@link sap.ui.mdc.MultiValueField MultiValueField}, the data type is determined from the binding of the {@link sap.ui.mdc.field.MultiValueFieldItem#getDescription description} of an item.
+	 * For a {@link sap.ui.mdc.FilterField FilterField}, the data type is provided via the {@link sap.ui.mdc.FilterField#getAdditionalDataType additionalDataType} property.
 	 *
 	 * @returns {sap.ui.model.Type|object} Type instance of a configuration object
 	 * @protected
@@ -4076,7 +4107,7 @@ sap.ui.define([
 	/**
 	 * Allows fields to wait for async formatting result processing
 	 *
-	 * @returns {undefined|Promise} returns a promise waiting for ongoing formatting
+	 * @returns {undefined|Promise} returns a <code>Promise</code> waiting for ongoing formatting
 	 * @protected
 	 * @since 1.126.0
 	 */
@@ -4108,7 +4139,7 @@ sap.ui.define([
 	}
 
 	/**
-	 * Creates parameter for a <code>ParseError</code>, <code>ValidationError</code> or <code>ValidationSuccess</code>
+	 * Creates parameter for a {@link sap.ui.base.ManagedObject#event:ParseError ParseError}, {@link sap.ui.base.ManagedObject#event:ValidationError ValidationError} or {@link sap.ui.base.ManagedObject#event:ValidationSuccess ValidationSuccess}
 	 * event based on the corresponding event fired on the inner control.
 	 *
 	 * The basic implementation just adds the element and error information. The <code>property</code> and
@@ -4139,7 +4170,47 @@ sap.ui.define([
 	};
 
 	/**
-	 * Sets the ValueState for content controls
+	 * Checks if a condition update needs to fire a {@link sap.ui.base.ManagedObject#event:ValidationSuccess ValidationSuccess} event.
+	 *
+	 * This is required in {@link sap.ui.mdc.field.Field Field} if the condition update doesn't lead to an update of the
+	 * {@link sap.ui.mdc.field.Field#setValue value} property. (If only description or payload is changed.)
+	 *
+	 * @param {sap.ui.mdc.condition.ConditionObject[]} aConditions Current conditions
+	 * @returns {boolean} <code>true</code> if the {@link sap.ui.base.ManagedObject#event:ValidationSuccess ValidationSuccess} event is fired
+	 * @protected
+	 * @since 1.142.0
+	 */
+	FieldBase.prototype.shouldFireValidationSuccessOnConditionUpdate = function (aConditions) {
+
+		return false;
+
+	};
+
+	function _fireValidationSuccessForContent(oContent) {
+
+			if (oContent) { // fire validation success on content directly, as triggered only after ENTER or Focusout. (As we don't know the internal content behaviour we cannot just fake ENTER or Focusout)
+				for (const sProperty in oContent.getMetadata().getAllProperties()) {
+					if (oContent.getBindingPath(sProperty) === "/conditions") {
+						const oBinding = oContent.getBinding(sProperty);
+						const oType = oBinding?.getType();
+						if (oType instanceof ConditionsType) {
+							oContent.fireValidationSuccess({
+									element: oContent,
+									property: sProperty,
+									type: oType,
+									newValue: oContent.getDOMValue?.(),
+									oldValue: oContent.getProperty(sProperty)
+								}, false, true); // bAllowPreventDefault, bEnableEventBubbling
+							break;
+						}
+					}
+				}
+			}
+
+	}
+
+	/**
+	 * Sets the <code>ValueState</code> for content controls
 	 *
 	 * @param {string} sContentId Id of the content control
 	 * @param {sap.ui.core.ValueState} sValueState value state
@@ -4158,7 +4229,7 @@ sap.ui.define([
 	};
 
 	/**
-	 * Gets the ValueState for content controls
+	 * Gets the <code>ValueState</code> for content controls
 	 *
 	 * @param {string} sContentId Id of the content control or Id of the field itself
 	 * @returns {object} value state information for content control
@@ -4193,7 +4264,7 @@ sap.ui.define([
 	};
 
 	/**
-	 * Resets the ValueState for content controls
+	 * Resets the <code>ValueState</code> for content controls
 	 *
 	 * @protected
 	 * @since 1.138.0

package/src/sap/ui/mdc/field/FieldInfoBase.js

@@ -31,7 +31,7 @@ sap.ui.define([
 	 * A <code>FieldInfoBase</code> element is a base class that shows any kind of information related to the <code>Field</code> control, for example, navigation targets or contact details.
 	 * This is the basis for link-features. If the link is pressed a popover might be opened.
 	 * @extends sap.ui.mdc.Element
-	 * @version 1.141.2
+	 * @version 1.143.0
 	 * @constructor
 	 * @since 1.54.0
 	 * @public

package/src/sap/ui/mdc/field/FieldInput.js

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * The <code>FieldInput</code> control is used to render an input field inside a control based on {@link sap.ui.mdc.field.FieldBase FieldBase}.
 	 * It enhances the {@link sap.m.Input Input} control to add ARIA attributes and other {@link sap.ui.mdc.field.FieldBase FieldBase}-specific logic.
 	 * @extends sap.m.Input
-	 * @version 1.141.2
+	 * @version 1.143.0
 	 * @constructor
 	 * @abstract
 	 * @private

package/src/sap/ui/mdc/field/FieldInputRenderUtil.js

@@ -16,7 +16,7 @@ sap.ui.define([
 		 * @class Functions uses in <code>FieldInputRenderer</code> and <code>FieldMultiInputRenderer</code> to adjust aria attributes.
 		 *
 		 * @author SAP SE
-		 * @version 1.141.2
+		 * @version 1.143.0
 		 * @since 1.86.0
 		 * @alias sap.ui.mdc.field.FieldInputRenderUtil
 		 *

package/src/sap/ui/mdc/field/FieldMultiInput.js

@@ -31,7 +31,7 @@ sap.ui.define([
 	 * The <code>FieldMultiInput</code> control is used to render a multi-input field inside a control based on {@link sap.ui.mdc.field.FieldBase FieldBase}.
 	 * It enhances the {@link sap.m.MultiInput MultiInput} control to add ARIA attributes and other {@link sap.ui.mdc.field.FieldBase FieldBase}-specific logic.
 	 * @extends sap.m.MultiInput
-	 * @version 1.141.2
+	 * @version 1.143.0
 	 * @constructor
 	 * @abstract
 	 * @private

package/src/sap/ui/mdc/field/FieldSelect.js

@@ -31,7 +31,7 @@ sap.ui.define([
 	 * The <code>FieldSelect</code> control is used to render an select field inside a control based on {@link sap.ui.mdc.field.FieldBase FieldBase}.
 	 * It enhances the {@link sap.m.Select Select} control to allow {@link sap.ui.mdc.field.FieldBase FieldBase}-specific ValueHelp logic.
 	 * @extends sap.m.Input
-	 * @version 1.141.2
+	 * @version 1.143.0
 	 * @constructor
 	 * @abstract
 	 * @private
@@ -145,6 +145,9 @@ sap.ui.define([
 
 	function _formatConditions(aConditions) {
 
+		/**
+		 * @type {sap.ui.mdc.field.FieldBase}
+		 */
 		const oField = this.getParent();
 
 		if (!oField?.isA("sap.ui.mdc.field.FieldBase")) { // called from generic tests
@@ -438,6 +441,9 @@ sap.ui.define([
 
 	function _getValueHelp() {
 
+		/**
+		 * @type {sap.ui.mdc.field.FieldBase}
+		 */
 		const oField = this.getParent();
 		let sId = oField?._getValueHelp();
 		let oValueHelp;

package/src/sap/ui/mdc/field/ListFieldHelpItem.js

@@ -23,7 +23,7 @@ sap.ui.define([
 	 * @extends sap.ui.mdc.valuehelp.content.FixedListItem
 	 *
 	 * @author SAP SE
-	 * @version 1.141.2
+	 * @version 1.143.0
 	 *
 	 * @private
 	 * @ui5-restricted sap.fe

package/src/sap/ui/mdc/field/MultiValueFieldDelegate.js

@@ -38,11 +38,33 @@ sap.ui.define([
 	 * @param {sap.ui.mdc.MultiValueField} oMultiValueField Current <code>MultiValueField</code> control to determine binding information to update the values of the related model
 	 * @public
 	 * @experimental
+	 * @deprecated As of version 1.142, replaced by {@link module:sap/ui/mdc/field/MultiValueFieldDelegate.updateItemsFromConditions updateItemsFromConditions}.
 	 */
 	MultiValueFieldDelegate.updateItems = function(oPayload, aConditions, oMultiValueField) {
 
 	};
 
+
+	/**
+	 * Implements the model-specific logic to update items after conditions have been updated.
+	 *
+	 * Items can be removed, updated, or added.
+	 * Use the binding information of the <code>MultiValueField</code> control to update the data in the related model.
+	 *
+	 * @param {sap.ui.mdc.MultiValueField} oMultiValueField Current <code>MultiValueField</code> control to determine binding information to update the values of the related model
+	 * @param {sap.ui.mdc.condition.ConditionObject[]} aConditions Current conditions of the <code>MultiValueField</code> control
+	 * @public
+	 * @experimental
+	 * @since 1.142
+	 */
+	MultiValueFieldDelegate.updateItemsFromConditions = function(oMultiValueField, aConditions) {
+		/**
+		 *  @deprecated As of version 1.142
+		 */
+		this.updateItems.apply(this, [oMultiValueField.getPayload(), aConditions, oMultiValueField]);
+	};
+
+
 	MultiValueFieldDelegate.indexOfCondition = function(oMultiValueField, oValueHelp, oCondition, aConditions) {
 
 		// as all conditions belongs to items and therefore get state "Validated" compare conditions from manual user input with validated conditions

package/src/sap/ui/mdc/field/MultiValueFieldItem.js

@@ -20,7 +20,7 @@ sap.ui.define([
 	 * Base type for <code>MultiValueFieldItem</code> control.
 	 * The {@link sap.ui.mdc.MultiValueField MultiValueField} holds its values as items. The <code>MultiValueFieldItem</code> element defines these items.
 	 * @extends sap.ui.core.Element
-	 * @version 1.141.2
+	 * @version 1.143.0
 	 * @constructor
 	 * @since 1.93.0
 	 * @public

package/src/sap/ui/mdc/field/TokenDisplay.js

@@ -22,7 +22,7 @@ sap.ui.define([
 	 * The <code>TokenDisplay</code> control is used to render a field inside a control based on {@link sap.ui.mdc.field.FieldBase FieldBase}.
 	 * It enhances the {@link sap.m.Token Token} control to add ARIA attributes and other {@link sap.ui.mdc.field.FieldBase FieldBase}-specific logic.
 	 * @extends sap.m.Token
-	 * @version 1.141.2
+	 * @version 1.143.0
 	 * @constructor
 	 * @abstract
 	 * @private

package/src/sap/ui/mdc/field/TokenizerDisplay.js

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * It enhances the {@link sap.m.Tokenizer Tokenizer} control to support display only tokens.
 	 * @extends sap.m.Tokenizer
 	 * @implements sap.ui.core.ILabelable
-	 * @version 1.141.2
+	 * @version 1.143.0
 	 * @constructor
 	 * @abstract
 	 *

package/src/sap/ui/mdc/field/content/ContentFactory.js

@@ -324,6 +324,9 @@ sap.ui.define([
 		return sEditMode === FieldEditMode.Editable;
 	};
 
+	/**
+	 * @returns {sap.ui.mdc.field.FieldBase}
+	 */
 	ContentFactory.prototype.getField = function() {
 		return this._oField;
 	};