@openui5/sap.ui.mdc 1.112.2 → 1.114.0

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

@@ -72,6 +72,17 @@ sap.ui.define([
 	var TextAlign = coreLibrary.TextAlign;
 	var TextDirection = coreLibrary.TextDirection;
 
+	/**
+	 * Modules for {@link sap.ui.mdc.Field Field} and {@link sap.ui.mdc.FilterField FilterField}
+	 * @namespace
+	 * @name sap.ui.mdc.field
+	 * @since 1.58.0
+	 * @private
+	 * @experimental As of version 1.58
+	 * @ui5-restricted sap.ui.mdc sap.fe
+	 * @MDC_PUBLIC_CANDIDATE
+	 */
+
 	/**
 	 * Constructor for a new <code>FieldBase</code>.
 	 *
@@ -79,22 +90,29 @@ sap.ui.define([
 	 * @param {object} [mSettings] Initial settings for the new control
 	 *
 	 * @class
-	 * The <code>FieldBase</code> control is the basic control to be used within the {@link sap.ui.mdc.Field Field} and {@link sap.ui.mdc.FilterField FilterField} controls.
+	 * The <code>FieldBase</code> control is the basic control to be used within the {@link sap.ui.mdc.Field Field}, {@link sap.ui.mdc.MultiValueField MultiValueField}
+	 * and {@link sap.ui.mdc.FilterField FilterField} controls.
 	 * It must not be used stand-alone.
 	 *
 	 * @extends sap.ui.mdc.Control
-	 * @implements sap.ui.core.IFormContent, sap.ui.core.ISemanticFormContent
+	 * @implements sap.ui.core.IFormContent, sap.ui.core.ISemanticFormContent, sap.m.IOverflowToolbarContent
 	 *
 	 * @author SAP SE
-	 * @version 1.112.2
+	 * @version 1.114.0
 	 *
 	 * @constructor
 	 * @alias sap.ui.mdc.field.FieldBase
 	 * @since 1.58.0
 	 * @abstract
 	 *
+	 * @borrows sap.ui.core.Control#getAccessibilityInfo as #getAccessibilityInfo
+	 * @borrows sap.ui.core.Element.prototype#enhanceAccessibilityState as #enhanceAccessibilityState
+	 * @borrows sap.ui.core.ISemanticFormContent#getFormFormattedValue as #getFormFormattedValue
+	 * @borrows sap.ui.core.ISemanticFormContent#getFormValueProperty as #getFormValueProperty
+	 *
 	 * @private
-	 * @ui5-restricted sap.ui.mdc
+	 * @ui5-restricted sap.fe
+	 * @MDC_PUBLIC_CANDIDATE
 	 * @experimental As of version 1.58
 	 */
 	var FieldBase = Control.extend("sap.ui.mdc.field.FieldBase", /* @lends sap.ui.mdc.field.FieldBase.prototype */ {
@@ -270,7 +288,7 @@ sap.ui.define([
 				 * <ul>
 				 * <li><code>$filters</code> as the name of the condition model</li>
 				 * <li><code>/conditions/</code> as a required static part of the binding</li>
-				 * <li><code>navPath#42;/</code> as the navigation property name</li>
+				 * <li><code>navPath&#42;/</code> as the navigation property name</li>
 				 * <li><code>propertyPath</code> as the property name</li>
 				 * </ul>
 				 * Between <code>navPath</code> and <code>propertyPath</code>, <b>&#42;/</b> is required.
@@ -281,7 +299,8 @@ sap.ui.define([
 					type: "object[]",
 					group: "Data",
 					defaultValue: [],
-					byValue: true
+					byValue: true,
+					bindable: "bindable"
 				},
 
 				/**
@@ -352,6 +371,15 @@ sap.ui.define([
 					defaultValue: {},
 					byValue: true,
 					visibility: "hidden"
+				},
+
+				/**
+				 * Internal property to bind the operators to the internal <code>DynamicDateRange</code> (or other) control.
+				 */
+				_operators: {
+					type: "string[]",
+					defaultValue: [],
+					visibility: "hidden"
 				}
 
 			},
@@ -359,6 +387,10 @@ sap.ui.define([
 				/**
 				 * Optional content that can be rendered.
 				 *
+				 * Per default, depending on <code>editMode</code>, <code>multipleLines</code> and 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.
+				 *
 				 * <b>Note:</b> Bind the value-holding property of the control to <code>'$field>/conditions'</code>
 				 * using {@link sap.ui.mdc.field.ConditionsType ConditionsType} as type.
 				 *
@@ -377,6 +409,9 @@ sap.ui.define([
 				/**
 				 * Optional content to be rendered if the <code>editMode</code> property is not set to <code>Display</code>.
 				 *
+				 * Per default, depending on <code>multipleLines</code> and used data type a content control is rendered in edit mode. For simple string types a {@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.
 				 *
 				 * <b>Note:</b> Bind the value-holding property of the control to <code>'$field>/conditions'</code>
@@ -399,6 +434,9 @@ sap.ui.define([
 				/**
 				 * Optional content to be rendered  if the <code>editMode</code> property is set to <code>Display</code>.
 				 *
+				 * Per default, depending on <code>multipleLines</code> and 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>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.
 				 *
 				 * <b>Note:</b> Bind the value-holding property of the control to <code>'$field>/conditions'</code>
@@ -429,6 +467,7 @@ sap.ui.define([
 
 				/**
 				 * Optional <code>FieldInfo</code> used for detail information. This is only active in display mode.
+				 * Especially {@link sap.ui.mdc.Link} can be used to activate link features.
 				 *
 				 * <b>Note:</b> If a special data type is defined or a content control is set, this is ignored.
 				 */
@@ -441,21 +480,40 @@ sap.ui.define([
 				/**
 				 * Optional <code>FieldHelp</code>.
 				 *
-				 * This is an association that allows the usage of one <code>FieldHelp</code> instance for multiple fields.
+				 * This is an association that allows the usage of one <code>ValueHelp</code> instance for multiple fields.
 				 *
-				 * <b>Note:</b> If the field is inside of a table, do not set the <code>FieldHelp</code> instance as <code>dependent</code>
+				 * <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>FieldHelp</code> instance e.g. as dependent on the table or page.
+				 * 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
 				 * be rendering or update issues.
 				 *
-				 * <b>Note:</b> For <code>Boolean</code> fields, no <code>FieldHelp</code> should be added, but a default <code>FieldHelp</code> used instead.
+				 * <b>Note:</b> For <code>Boolean</code> fields, no <code>ValueHelp</code> should be added, but a default <code>ValueHelp</code> used instead.
+				 * @deprecated as of 1.114.0, replaced by {@link #setValueHelp valueHelp} association
 				 */
 				fieldHelp: {
 					type: "sap.ui.mdc.ValueHelp",
 					multiple: false
 				},
 
+				/**
+				 * Optional <code>ValueHelp</code>.
+				 *
+				 * This is an association that allows the usage of one <code>ValueHelp</code> 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>
+				 * 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
+				 * 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.
+				 */
+				valueHelp: {
+					type: "sap.ui.mdc.ValueHelp",
+					multiple: false
+				},
+
 				/**
 				 * Association to controls / IDs that label this control (see WAI-ARIA attribute aria-labelledby).
 				 */
@@ -586,7 +644,7 @@ sap.ui.define([
 			properties: ["display", "editMode", "dataType", "dataTypeFormatOptions", "dataTypeConstraints",
 				"multipleLines", "maxConditions", "conditions", "delegate"],
 			aggregations: ["fieldInfo", "content", "contentEdit", "contentDisplay"],
-			associations: ["fieldHelp", "ariaLabelledBy"]
+			associations: ["fieldHelp", "valueHelp", "ariaLabelledBy"]
 		});
 
 		this.attachEvent("modelContextChange", this._handleModelContextChange, this);
@@ -631,8 +689,10 @@ sap.ui.define([
 		var oFieldHelp = _getFieldHelp.call(this);
 		if (oFieldHelp && !this._iFocusTimer && oFieldHelp.shouldOpenOnFocus() && !oFieldHelp.isOpen()) {
 			this._iFocusTimer = setTimeout(function () {
-				oFieldHelp.open(true);
-				this._redirectFocus(oEvent, oFieldHelp);
+				if (!this.bIsDestroyed && !oFieldHelp.isOpen()) {
+					_handleValueHelpRequest.call(this, oEvent, true); // open typeahead
+					this._redirectFocus(oEvent, oFieldHelp);
+				}
 				this._iFocusTimer = null;
 			}.bind(this),300);
 		}
@@ -853,7 +913,7 @@ sap.ui.define([
 		var oFieldHelp = _getFieldHelp.call(this);
 		if (oFieldHelp) {
 			if (oFieldHelp.shouldOpenOnClick() && !oFieldHelp.isOpen()) {
-				oFieldHelp.open(true);
+				_handleValueHelpRequest.call(this, oEvent, true); // open typeahead
 			}
 			this._redirectFocus(oEvent, oFieldHelp);
 		}
@@ -1190,7 +1250,7 @@ sap.ui.define([
 			this._getContentFactory().updateConditionType();
 		}
 
-		if (oChanges.name === "fieldHelp" && oChanges.ids) {
+		if ((oChanges.name === "fieldHelp" || oChanges.name === "valueHelp") && oChanges.ids) {
 			_fieldHelpChanged.call(this, oChanges.ids, oChanges.mutation);
 			this._getContentFactory().updateConditionType();
 		}
@@ -1337,7 +1397,11 @@ sap.ui.define([
 	};
 
 	/*
-	 * If Field is inside of a SemanticFormElement return formatted value in display mode
+	 * If Field is inside of a {@link sap.ui.layout.form.SemanticFormElement SemanticFormElement} return formatted value in display mode
+	 *
+	 * @returns {string} formatted value of the field
+	 * @private
+	 * @ui5-restricted sap.ui.layout.form.SemanticFormElement
 	 */
 	FieldBase.prototype.getFormFormattedValue = function() {
 
@@ -1372,7 +1436,11 @@ sap.ui.define([
 	};
 
 	/*
-	 * If Field is inside of a SemanticFormElement return value holding property (don't use "value" property of Field as conditions are updares async)
+	 * If Field is inside of a {@link sap.ui.layout.form.SemanticFormElement SemanticFormElement} return value holding property (don't use "value" property of Field as conditions are updated async)
+	 *
+	 * @returns {string} name of the value holding property
+	 * @private
+	 * @ui5-restricted sap.ui.layout.form.SemanticFormElement
 	 */
 	FieldBase.prototype.getFormValueProperty = function() {
 
@@ -1409,7 +1477,7 @@ sap.ui.define([
 
 	};
 
-	/**
+	/*
 	 * @returns {object} Current accessibility state of the control.
 	 * @see sap.ui.core.Control#getAccessibilityInfo
 	 * @protected
@@ -1491,16 +1559,16 @@ sap.ui.define([
 	}
 
 	/**
-	 * Assigns a <code>Label</code> control to the <code>Field</code> or </code>FilterField</code> controls.
+	 * Assigns a <code>Label</code> control to the {@link sap.ui.mdc.Field Field} or {@link sap.ui.mdc.FilterField FilterField} controls.
 	 *
-	 * The text of the label is taken from the <code>Field</code> or </code>FilterField</code> controls.
-	 * The <code>labelFor</code> association is set to the <code>Field</code> or </code>FilterField</code> control.
+	 * The text of the label is taken from the {@link sap.ui.mdc.Field Field} or {@link sap.ui.mdc.FilterField FilterField} controls.
+	 * The <code>labelFor</code> association is set to the {@link sap.ui.mdc.Field Field} 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
 	 *
 	 * @private
-	 * @ui5-restricted sap.fe
+	 * @ui5-restricted sap.ui.mdc sap.fe
 	 * @MDC_PUBLIC_CANDIDATE
 	 * @experimental As of version 1.62.0
 	 * @since 1.62.0 Disclaimer: this function is in a beta state - incompatible API changes may be done before its official public release. Use at your own discretion.
@@ -1756,7 +1824,7 @@ sap.ui.define([
 		var oContentDisplay = this.getContentDisplay();
 
 		this._getContentFactory()._setUsedConditionType(oContent, oContentEdit, oContentDisplay, sEditMode); // if external content use it's conditionType
-		_checkFieldHelpExist.call(this, this.getFieldHelp()); // as FieldHelp might be created after ID is assigned to Field
+		_checkFieldHelpExist.call(this, this._getValueHelp()); // as ValueHelp might be created after ID is assigned to Field
 		_setAriaAttributes.call(this, false);
 
 
@@ -1815,6 +1883,7 @@ sap.ui.define([
 			var sId = _getIdForInternalControl.call(this);
 			this._oCreateContentPromise = this._getContentFactory().createContent(oContentType, sContentMode, sId);
 			this._oCreateContentPromise.then(function(aControls) {
+				delete this._oCreateContentPromise; // after finished new creation request can be sync again (clear at the beginning as error might break function before end)
 				for (var iIndex = 0; iIndex < aControls.length; iIndex++) {
 					var oControl = aControls[iIndex];
 					oControl.attachEvent("parseError", _handleParseError, this);
@@ -1830,7 +1899,9 @@ sap.ui.define([
 				}
 
 				_refreshLabel.call(this);
-				delete this._oCreateContentPromise; // after finished new creation request can be sync again
+			}.bind(this)).catch(function(oException) {
+				delete this._oCreateContentPromise; // clean up to not run into endless loop
+				throw oException;
 			}.bind(this));
 		}
 	}
@@ -2066,7 +2137,7 @@ sap.ui.define([
 	function _useDefaultFieldHelp(oContentType, aOperators, sEditMode, iMaxConditions) {
 
 		var oUseDefaultFieldHelp = oContentType.getUseDefaultFieldHelp();
-		if (oUseDefaultFieldHelp && !this.getFieldHelp() && sEditMode !== EditMode.Display) {
+		if (oUseDefaultFieldHelp && !this._getValueHelp() && sEditMode !== EditMode.Display) {
 			if ((iMaxConditions === 1 && oUseDefaultFieldHelp.single) || (iMaxConditions !== 1 && oUseDefaultFieldHelp.multi)) {
 				if (aOperators.length === 1) {
 					var bIsSingleValue = _isOnlyOneSingleValue.call(this, aOperators); // if operator not exists unse no field help
@@ -2487,9 +2558,16 @@ sap.ui.define([
 
 	}
 
+	// TODO: remove this function and replace by getValueHelp onde FieldHelp association is completetly removed.
+	FieldBase.prototype._getValueHelp = function() {
+
+		return this.getValueHelp() || (this.getFieldHelp && this.getFieldHelp()); // as getFieldHelp not exist in legacy-free UI5
+
+	};
+
 	function _getFieldHelp() {
 
-		var sId = this.getFieldHelp();
+		var sId = this._getValueHelp();
 		var oFieldHelp;
 
 		if (!sId && this._sDefaultFieldHelp) {
@@ -2533,7 +2611,7 @@ sap.ui.define([
 
 	}
 
-	function _handleValueHelpRequest(oEvent) {
+	function _handleValueHelpRequest(oEvent, bOpenAsTypeahed) { // if triggered by valueHelpRequest event alway open as dialog, if called from Tap or Focus as typeahead
 
 		var oFieldHelp = _getFieldHelp.call(this);
 
@@ -2544,10 +2622,10 @@ sap.ui.define([
 			oFieldHelp.setFilterValue(this._sFilterValue); // use types value for filtering, even if reopening FieldHelp
 			var aConditions = this.getConditions();
 			_setConditionsOnFieldHelp.call(this, aConditions, oFieldHelp);
-			oFieldHelp.toggleOpen(false);
+			oFieldHelp.toggleOpen(!!bOpenAsTypeahed);
 			if (!oFieldHelp.isFocusInHelp()) {
 				// need to reset bValueHelpRequested in Input, otherwise on focusout no change event and navigation don't work
-				var oContent = oEvent.getSource();
+				var oContent = oEvent.srcControl || oEvent.getSource(); // as, if called from Tap or other brwowser event getSource is not available
 				if (oContent.bValueHelpRequested) {
 					oContent.bValueHelpRequested = false; // TODO: need API
 				}
@@ -3003,9 +3081,9 @@ sap.ui.define([
 
 	// TODO: better API?
 	/**
-	 * Provides some internals of the field to be used in the value help.
+	 * Provides some internals of the field to be used in {@link sap.ui.mdc.field.ConditionsType ConditionsType} for format and parse the conditions.
 	 *
-	 * @returns {object} formatOptions of the field
+	 * @returns {object} formatOptions of the field (see {@link sap.ui.mdc.field.ConditionsType ConditionsType})
 	 * @private
 	 */
 	FieldBase.prototype._getFormatOptions = function() {
@@ -3020,7 +3098,7 @@ sap.ui.define([
 			additionalType: this._getContentFactory().getUnitType(), // only set if unit or timezone
 			compositeTypes: this._getContentFactory().getCompositeTypes(), // only set if CompositeType used
 			display: this._getContentFactory().isMeasure() ? FieldDisplay.Value : this.getDisplay(),
-			fieldHelpID: this._getContentFactory().isMeasure() ? undefined : this.getFieldHelp() || this._sDefaultFieldHelp,
+			valueHelpID: this._getContentFactory().isMeasure() ? undefined : this._getValueHelp() || this._sDefaultFieldHelp,
 			operators: this._getOperators(),
 			hideOperator: this._getContentFactory().getHideOperator(),
 			maxConditions: this.getMaxConditions(),
@@ -3085,6 +3163,12 @@ sap.ui.define([
 
 	};
 
+	/**
+	 * Provides some internals of the unit part of the field to be used in {@link sap.ui.mdc.field.ConditionsType ConditionsType} for format and parse the conditions.
+	 *
+	 * @returns {object} formatOptions of the field (see {@link sap.ui.mdc.field.ConditionsType ConditionsType})
+	 * @private
+	 */
 	FieldBase.prototype._getUnitFormatOptions = function() {
 
 		if (!this._asyncParsingCall) { //as variable to have the same function after each update of formatOptions. Otherwise it would be a change on FormatOption in ValueHelpPanel every time
@@ -3097,7 +3181,7 @@ sap.ui.define([
 			additionalType: this._getContentFactory().retrieveDataType(), // use type of measure for currentValue
 			compositeTypes: this._getContentFactory().getCompositeTypes(),
 			display: this.getDisplay(),
-			fieldHelpID: this.getFieldHelp() || this._sDefaultFieldHelp,
+			valueHelpID: this._getValueHelp() || this._sDefaultFieldHelp,
 			operators: ["EQ"],
 			hideOperator: true, // TODO: no operator for units
 			maxConditions: 1, // TODO: only one unit allowed
@@ -3218,19 +3302,23 @@ sap.ui.define([
 	FieldBase.prototype._getOperators = function() {
 
 		var regexp = new RegExp("^\\*(.*)\\*|\\$search$");
+		var aOperators;
 		if (regexp.test(this.getFieldPath()) && this.getMaxConditions() === 1) {
 			// for SearchField use Contains operator
-			return ["Contains"];
-		}
+			aOperators =  ["Contains"];
+		} else {
+			// get default operators for type
+			var sBaseType = this.getBaseType(); // TODO what if delegate not loaded
 
-		// get default operators for type
-		var sBaseType = this.getBaseType(); // TODO what if delegate not loaded
+			if (sBaseType === BaseType.Unit) {
+				sBaseType = BaseType.Numeric;
+			}
 
-		if (sBaseType === BaseType.Unit) {
-			sBaseType = BaseType.Numeric;
+			aOperators = FilterOperatorUtil.getOperatorsForType(sBaseType);
 		}
 
-		return FilterOperatorUtil.getOperatorsForType(sBaseType);
+		this.setProperty("_operators", aOperators, true);
+		return aOperators;
 
 	};
 

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

@@ -9,9 +9,9 @@
 // ---------------------------------------------------------------------------------------
 
 sap.ui.define([
-	'sap/ui/mdc/BaseDelegate', 'sap/ui/mdc/odata/TypeUtil'/* TODO: FieldBase & Field currently expect odata types in default delegate! */, 'sap/ui/model/FormatException', 'sap/ui/mdc/condition/Condition', 'sap/ui/mdc/enum/ConditionValidated'
+	'sap/ui/mdc/BaseDelegate', 'sap/ui/mdc/odata/TypeMap', 'sap/ui/model/FormatException', 'sap/ui/mdc/condition/Condition', 'sap/ui/mdc/enum/ConditionValidated'
 ], function(
-	BaseDelegate, TypeUtil, FormatException, Condition, ConditionValidated
+	BaseDelegate, ODataTypeMap, FormatException, Condition, ConditionValidated
 ) {
 	"use strict";
 
@@ -31,6 +31,10 @@ sap.ui.define([
 	 */
 	var FieldBaseDelegate = Object.assign({}, BaseDelegate);
 
+	FieldBaseDelegate.getTypeMap = function () {
+		return ODataTypeMap;
+	};
+
 	/**
 	 * Provides the possibility to convey custom data in conditions.
 	 * This enables an application to enhance conditions with data relevant for combined key or outparameter scenarios.
@@ -51,7 +55,8 @@ sap.ui.define([
 	/**
 	 * Enables applications to control condition updates based on <code>value</code> / <code>additionalvalue</code> property changes.
 	 *
-	 * <b>Note:</b> Use with care! Custom implementations of this method may lead to intransparency as a field's condition may then differ from the state of the <code>value</code> / <code>additionalvalue</code> properties. Please also avoid expensive operations!
+	 * <b>Note:</b> Use with care! Custom implementations of this method may lead to intransparency as a field's condition may then differ from the state of the <code>value</code> / <code>additionalvalue</code> properties.
+	 * Please also avoid expensive operations, as this can delay the rendering of the output!
 	 *
 	 * @param {object} oPayload Payload for delegate
 	 * @param {sap.ui.core.Control} [oControl] Instance of the calling control
@@ -162,30 +167,20 @@ sap.ui.define([
 	};
 
 	/**
-	 * Determines the key, description, and the in and out parameters of a user input.
+	 * Determines the key, description, and payload of a user input.
 	 *
 	 * If this needs to be determined asynchronously, a <code>Promise</code> is returned.
 	 *
-	 * The result needs to be an object containing the following properties: description, key, and in and out parameters.
-	 * <ul>
-	 * <li><code>key</code>: Key of the item </li>
-	 * <li><code>description</code>: Description of the item </li>
-	 * <li><code>inParameters</code>: Object with in parameters and the corresponding value </li>
-	 * <li><code>outParameters</code>: Object with out parameters and the corresponding value </li>
-	 * </ul>
-	 *
-	 * If the item cannot be determined, a corresponding <code>ParseException<code> is thrown.
-	 *
 	 * @param {object} oPayload Payload for delegate
-	 * @param {sap.ui.mdc.ValueHelp} oValueHelp Field help assigned to the <code>Field</code> or <code>FilterField</code> control
+	 * @param {sap.ui.mdc.ValueHelp} oValueHelp Field help assigned to the {@link sap.ui.mdc.Field Field} or {@link sap.ui.mdc.FilterField FilterField} control
 	 * @param {object} [oConfig] Configuration
 	 * @param {any} oConfig.value Value as entered by user
 	 * @param {any} oConfig.parsedValue Value parsed by data type to fit the data type of the key
-	 * @param {sap.ui.model.Context} oConfig.bindingContext <code>BindingContext</code> of the checked field. Inside a table the <code>FieldHelp</code> element might be connected to a different row.
+	 * @param {sap.ui.model.Context} oConfig.bindingContext <code>BindingContext</code> of the checked field. Inside a table the <code>ValueHelp</code> element might be connected to a different row.
 	 * @param {boolean} oConfig.checkKey If set, it should be checked if there is an item with the given key. This is set to <code>false</code> if the value cannot be a valid key because of type validation.
 	 * @param {boolean} oConfig.checkDescription If set, it should be checked if there is an item with the given description. This is set to <code>false</code> if only the key is used in the field.
 	 * @param {sap.ui.core.Control} oConfig.control Instance if the calling control
-	 * @returns {object|Promise} Object containing description, key, in and out parameters. If it is not available right now (must be requested), a <code>Promise</code> is returned.
+	 * @returns {sap.ui.mdc.valuehelp.ValueHelpItem|Promise<sap.ui.mdc.valuehelp.ValueHelpItem>} Object containing description, key, and payload. If it is not available right now (must be requested), a <code>Promise</code> is returned.
 	 * @throws {sap.ui.model.ParseException} if item cannot be determined
 	 * @since: 1.78.0
 	 * @private
@@ -203,21 +198,19 @@ sap.ui.define([
 	/**
 	 * Determines the description for a given key.
 	 *
-	 * This function is called while formatting the output of a <code>Field</code> or <code>FilterField</code> control
+	 * This function is called while formatting the output of a {@link sap.ui.mdc.Field Field} or {@link sap.ui.mdc.FilterField FilterField} control
 	 * in case a description is to be displayed but only a key is given.
 	 *
 	 * If this needs to be determined asynchronously, a <code>Promise</code> is returned.
 	 *
 	 * As the key might change (uppercase), an object with key and description can be returned.
 	 *
-	 * If the description cannot be determined, a corresponding <code>FormatException<code> is thrown.
-	 *
 	 * @param {object} oPayload Payload for delegate
-	 * @param {sap.ui.mdc.ValueHelp} oValueHelp Field help assigned to the <code>Field</code> or <code>FilterField</code> control
+	 * @param {sap.ui.mdc.ValueHelp} oValueHelp Field help assigned to the {@link sap.ui.mdc.Field Field} or {@link sap.ui.mdc.FilterField FilterField} control
 	 * @param {any} vKey Key
-	 * @param {object} oInParameters In parameters for the key (as a key must not be unique.)
-	 * @param {object} oOutParameters Out parameters for the key (as a key must not be unique.)
-	 * @param {sap.ui.model.Context} oBindingContext <code>BindingContext</code> of the checked field. Inside a table the <code>FieldHelp</code> element might be connected to a different row.
+	 * @param {object} oInParameters In parameters for the key (as a key must not be unique.) (Only filled in conditions of old variants.)
+	 * @param {object} oOutParameters Out parameters for the key (as a key must not be unique.) (Only filled in conditions of old variants.)
+	 * @param {sap.ui.model.Context} oBindingContext <code>BindingContext</code> of the checked field. Inside a table the <code>ValueHelp</code> element might be connected to a different row.
 	 * @param {sap.ui.mdc.condition.ConditionModel} [oConditionModel] <code>ConditionModel</code>, if bound to one - NOT LONGER USED
 	 * @param {string} [sConditionModelName] Name of the <code>ConditionModel</code>, if bound to one - NOT LONGER USED
 	 * @param {object} oConditionPayload Additional context information for this key
@@ -264,9 +257,5 @@ sap.ui.define([
 
 	};
 
-	FieldBaseDelegate.getTypeUtil = function (oPayload) {
-		return TypeUtil;
-	};
-
 	return FieldBaseDelegate;
 });

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

@@ -23,16 +23,19 @@ sap.ui.define([
 	/**
 	 * Constructor for a new <code>FieldInfoBase</code>.
 	 *
+	 * This is the basis for link-features. If the link is pressed a popover might be opened.
+	 *
 	 * @param {string} [sId] ID for the new control, generated automatically if no ID is given
 	 * @param {object} [mSettings] Initial settings for the new control
 	 * @class 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.
 	 * @extends sap.ui.mdc.Element
-	 * @version 1.112.2
+	 * @version 1.114.0
 	 * @constructor
 	 * @private
 	 * @since 1.54.0
 	 * @experimental As of version 1.54
-	 * @ui5-restricted sap.ui.mdc
+	 * @ui5-restricted sap.ui.mdc, sap.fe
+	 * @MDC_PUBLIC_CANDIDATE
 	 * @alias sap.ui.mdc.field.FieldInfoBase
 	 */
 	var FieldInfoBase = Element.extend("sap.ui.mdc.field.FieldInfoBase", /** @lends sap.ui.mdc.field.FieldInfoBase.prototype */
@@ -55,28 +58,35 @@ sap.ui.define([
 	// ----------------------- Field API --------------------------------------------
 
 	/**
-	 * Returns <code>true</code> as a promise result if the control created by <code>Field</code> can be triggered.
-	 * @returns {Promise} Promise
+	 * Returns <code>true</code> as a <code>Promise</code> result if the control created by <code>Field</code> can be triggered.
+	 * @returns {Promise<boolean>} <code>Promise</code> resolving into <code>true</code> if <code>FieldInfo</code> is clickable
 	 * @protected
+	 * @ui5-restricted sap.ui.mdc, sap.fe
+	 * @MDC_PUBLIC_CANDIDATE
 	 */
 	FieldInfoBase.prototype.isTriggerable = function() {
 		throw new Error("sap.ui.mdc.field.FieldInfoBase: method isTriggerable must be redefined");
 	};
 
 	/**
-	 * Returns as a promise result href which defines the target navigation of the <code>Link</code> control created by <code>Field</code>.
-	 * If direct navigation is used, href is returned. If the information panel contains more content than only one link, <code>undefined</code> is returned.
-	 * @returns {Promise<string|undefined>} Result of promise is href with values {string | undefined}
+	 * Returns href as a <code>Promise</code> that defines the target navigation of the <code>Link</code> control created by <code>Field</code>.
+	 * If direct navigation is used, href is returned. If the information panel contains more content than only one link, <code>null</code> is returned.
+	 * @returns {Promise<string|null>} Result of <code>Promise</code> is href with values {string | null}
 	 * @protected
+	 * @ui5-restricted sap.ui.mdc, sap.fe
+	 * @MDC_PUBLIC_CANDIDATE
 	 */
 	FieldInfoBase.prototype.getTriggerHref = function() {
 		throw new Error("sap.ui.mdc.field.FieldInfoBase: method getTriggerHref must be redefined");
 	};
 
 	/**
-	 * Returns a promise resolving in an object containing the <code>href</code> and <code>target</code> of a direct navigation link
-	 * Returns a promise resolving in null if there is no direct link
-	 * @returns {Promise} {Object | null}
+	 * Returns a <code>Promise</code> resolving into an {@link sap.ui.mdc.link.DirectLinkObject} containing the <code>href</code> and <code>target</code> of a direct navigation link.
+	 * Returns a <code>Promise</code> resolving into null if there is no direct link.
+	 * @returns {Promise<sap.ui.mdc.link.DirectLinkObject|null>} <code>Promise</code> resolving into <code>null</code> or a {@link sap.ui.mdc.link.DirectLinkObject}
+	 * @protected
+	 * @ui5-restricted sap.ui.mdc, sap.fe
+	 * @MDC_PUBLIC_CANDIDATE
 	 */
 	FieldInfoBase.prototype.getDirectLinkHrefAndTarget = function() {
 		throw new Error("sap.ui.mdc.field.FieldInfoBase: method getDirectLinkHrefAndTarget must be redefined");
@@ -86,8 +96,10 @@ sap.ui.define([
 	 * Opens the info panel in the control created by <code>Field</code>.
 	 * @param {sap.ui.core.Control} oControl Optional control reference to which the popover is
 	 * attached. By default the parent is used as reference.
-	 * @returns {Promise} Promise which is resolved once the popover has been created
+	 * @returns {Promise} <code>Promise</code> that is resolved once the popover has been created
 	 * @protected
+	 * @ui5-restricted sap.ui.mdc, sap.fe
+	 * @MDC_PUBLIC_CANDIDATE
 	 */
 	FieldInfoBase.prototype.open = function(oControl) {
 		oControl = oControl ? oControl : this.getParent();
@@ -118,8 +130,11 @@ sap.ui.define([
 
 	/**
 	 * Returns the content of the popover.
-	 * @returns {Promise} Promise with a popover content of type sap.ui.Control as result
+	 * @param {Function} [fnGetAutoClosedControl] Function returning the <code>Popover</code> control that is created in <code>createPopover</code>
+	 * @returns {Promise<sap.ui.Control>} <code>Promise</code> with a popover content of type sap.ui.Control as result
 	 * @protected
+	 * @ui5-restricted sap.ui.mdc, sap.fe
+	 * @MDC_PUBLIC_CANDIDATE
 	 */
 	FieldInfoBase.prototype.getContent = function(fnGetAutoClosedControl) {
 		throw new Error("sap.ui.mdc.field.FieldInfoBase: method getContent must be redefined");
@@ -127,7 +142,7 @@ sap.ui.define([
 
 	/**
 	 * Checks if there is a direct navigation or if there is a popover to be opened.
-	 * @returns {Promise} Resolves a Boolean value
+	 * @returns {Promise<boolean>} Resolves a Boolean value
 	 * @protected
 	 */
 	FieldInfoBase.prototype.checkDirectNavigation = function() {
@@ -149,7 +164,7 @@ sap.ui.define([
 
 	/**
 	 * Creates a default popover instance.
-	 * @returns {Promise} Promise with a popover as result
+	 * @returns {Promise} <code>Promise</code> with a popover as result
 	 * @private
 	 */
 	FieldInfoBase.prototype.createPopover = function() {

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

@@ -23,7 +23,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] Initial settings for the new control
 	 * @class The <code>FieldInput</code> control is used to render an input field inside a control based on {@link sap.ui.mdc.field.FieldBase FieldBase}.
 	 * @extends sap.m.Input
-	 * @version 1.112.2
+	 * @version 1.114.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.112.2
+	 * @version 1.114.0
 	 * @since 1.86.0
 	 * @alias sap.ui.mdc.field.FieldInputRenderUtil
 	 *

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

@@ -23,7 +23,7 @@ sap.ui.define([
 	 * @param {object} [mSettings] Initial settings for the new control
 	 * @class 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}.
 	 * @extends sap.m.MultiInput
-	 * @version 1.112.2
+	 * @version 1.114.0
 	 * @constructor
 	 * @abstract
 	 * @private