npm - @openui5/sap.ui.integration - Versions diffs - 1.102.1 → 1.103.0 - Mend

@openui5/sap.ui.integration 1.102.1 → 1.103.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (129) hide show

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@openui5/sap.ui.integration",
-  "version": "1.102.1",
+  "version": "1.103.0",
   "description": "OpenUI5 UI Library sap.ui.integration",
   "author": "SAP SE (https://www.sap.com)",
   "license": "Apache-2.0",
@@ -14,7 +14,7 @@
     "url": "https://github.com/SAP/openui5.git"
   },
   "dependencies": {
-    "@openui5/sap.ui.core": "1.102.1",
-    "@openui5/sap.f": "1.102.1"
+    "@openui5/sap.ui.core": "1.103.0",
+    "@openui5/sap.f": "1.103.0"
   }
 }

package/src/sap/ui/integration/.library CHANGED Viewed

@@ -6,7 +6,7 @@
   <copyright>OpenUI5
  * (c) Copyright 2009-2022 SAP SE or an SAP affiliate company.
  * Licensed under the Apache License, Version 2.0 - see LICENSE.txt.</copyright>
-  <version>1.102.1</version>
+  <version>1.103.0</version>
   <documentation>SAPUI5 library with integration-related controls.</documentation>

package/src/sap/ui/integration/ActionDefinition.js CHANGED Viewed

@@ -28,7 +28,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Element
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/integration/Designtime.js CHANGED Viewed

@@ -20,7 +20,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.ManagedObject
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/integration/Extension.js CHANGED Viewed

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.ManagedObject
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @public

package/src/sap/ui/integration/Host.js CHANGED Viewed

@@ -25,7 +25,7 @@ sap.ui.define([
 		 * @extends sap.ui.core.Element
 		 *
 		 * @author SAP SE
-		 * @version 1.102.1
+		 * @version 1.103.0
 		 *
 		 * @constructor
 		 * @public

package/src/sap/ui/integration/cards/AdaptiveContent.js CHANGED Viewed

@@ -37,7 +37,7 @@ sap.ui.define([
 		 * @extends sap.ui.integration.cards.BaseContent
 		 *
 		 * @author SAP SE
-		 * @version 1.102.1
+		 * @version 1.103.0
 		 *
 		 * @constructor
 		 * @private

package/src/sap/ui/integration/cards/AnalyticalContent.js CHANGED Viewed

@@ -88,7 +88,7 @@ sap.ui.define([
 	 * @extends sap.ui.integration.cards.BaseContent
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/cards/AnalyticsCloudContent.js CHANGED Viewed

@@ -30,7 +30,7 @@ sap.ui.define([
 	 * @extends sap.ui.integration.cards.BaseContent
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/cards/BaseContent.js CHANGED Viewed

@@ -52,7 +52,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/cards/BaseListContent.js CHANGED Viewed

@@ -35,12 +35,12 @@ sap.ui.define([
 	 * @extends sap.ui.integration.cards.BaseContent
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private
 	 * @since 1.76
-	 * @alias sap.ui.integration.cards.BaseContent
+	 * @alias sap.ui.integration.cards.BaseListContent
 	 */
 	var BaseListContent = BaseContent.extend("sap.ui.integration.cards.BaseListContent", {
 		metadata: {
@@ -103,7 +103,7 @@ sap.ui.define([
 	 *
 	 * @protected
 	 * @virtual
-	 * @returns {sap.ui.core.Control|null} An instance of ListBase or null.
+	 * @returns {sap.ui.core.Control|null} An instance of ListBase or <code>null</code>.
 	 */
 	BaseListContent.prototype.getInnerList = function () {
 		return null;
@@ -184,7 +184,7 @@ sap.ui.define([
 	};
 	/**
-	 * Used to show the illustrated message for no data retrived from server.
+	 * Used to show the illustrated message for no data retrieved from server.
 	 *
 	 * @protected
 	 * @param {Object} mItemConfig The item template.

package/src/sap/ui/integration/cards/CalendarContent.js CHANGED Viewed

@@ -68,7 +68,7 @@ sap.ui.define([
 		 * @extends sap.ui.integration.cards.BaseContent
 		 *
 		 * @author SAP SE
-		 * @version 1.102.1
+		 * @version 1.103.0
 		 *
 		 * @constructor
 		 * @private

package/src/sap/ui/integration/cards/ComponentContent.js CHANGED Viewed

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * @extends sap.ui.integration.cards.BaseContent
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @experimental
 	 * @constructor

package/src/sap/ui/integration/cards/Footer.js CHANGED Viewed

@@ -31,7 +31,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/cards/Header.js CHANGED Viewed

@@ -38,7 +38,7 @@ sap.ui.define([
 	 * @extends sap.f.cards.Header
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/cards/ListContent.js CHANGED Viewed

@@ -66,7 +66,7 @@ sap.ui.define([
 	 * @extends sap.ui.integration.cards.BaseListContent
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private
@@ -302,7 +302,7 @@ sap.ui.define([
 			control: this,
 			actionControl: this._oItemTemplate,
 			enabledPropertyName: "type",
-			enabledPropertyValue: ListType.Navigation,
+			enabledPropertyValue: ListType.Active,
 			disabledPropertyValue: ListType.Inactive
 		});

package/src/sap/ui/integration/cards/NumericHeader.js CHANGED Viewed

@@ -35,12 +35,12 @@ sap.ui.define([
 	 * @extends sap.f.cards.NumericHeader
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private
 	 * @since 1.77
-	 * @alias sap.ui.integration.cards.Header
+	 * @alias sap.ui.integration.cards.NumericHeader
 	 * @ui5-metamodel This control/element also will be described in the UI5 (legacy) designtime metamodel
 	 */
 	var NumericHeader = FNumericHeader.extend("sap.ui.integration.cards.NumericHeader", {
@@ -285,8 +285,8 @@ sap.ui.define([
 	/**
 	 * Gets the card instance of which this element is part of.
-	 * @ui5-restricted
 	 * @private
+	 * @ui5-restricted
 	 * @returns {sap.ui.integration.widgets.Card} The card instance.
 	 */
 	NumericHeader.prototype.getCardInstance = function () {

package/src/sap/ui/integration/cards/ObjectContent.js CHANGED Viewed

@@ -90,7 +90,7 @@ sap.ui.define([
 	 *
 	 * @extends sap.ui.integration.cards.BaseContent
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @since 1.64

package/src/sap/ui/integration/cards/TableContent.js CHANGED Viewed

@@ -77,7 +77,7 @@ sap.ui.define([
 	 * @extends sap.ui.integration.cards.BaseListContent
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private
@@ -183,7 +183,7 @@ sap.ui.define([
 			control: this,
 			actionControl: this._oItemTemplate,
 			enabledPropertyName: "type",
-			enabledPropertyValue: ListType.Navigation,
+			enabledPropertyValue: ListType.Active,
 			disabledPropertyValue: ListType.Inactive
 		});
@@ -229,7 +229,7 @@ sap.ui.define([
 					control: this,
 					actionControl: oItem,
 					enabledPropertyName: "type",
-					enabledPropertyValue: ListType.Navigation,
+					enabledPropertyValue: ListType.Active,
 					disabledPropertyValue: ListType.Inactive
 				});
 			}

package/src/sap/ui/integration/cards/TimelineContent.js CHANGED Viewed

@@ -36,7 +36,7 @@ sap.ui.define([
 	 * @extends sap.ui.integration.cards.BaseListContent
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @experimental

package/src/sap/ui/integration/cards/WebPageContent.js CHANGED Viewed

@@ -32,7 +32,7 @@ sap.ui.define([
 	 * @extends sap.ui.integration.cards.BaseContent
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @experimental

package/src/sap/ui/integration/cards/actions/CardActions.js CHANGED Viewed

@@ -57,7 +57,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.ManagedObject
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/cards/adaptivecards/elements/UI5InputChoiceSet.js CHANGED Viewed

@@ -20,7 +20,7 @@ sap.ui.define([
 	 * <code>ui5-select</code>, or container with <code>ui5-radio-button</code>, or <code>ui5-checkbox</code> web components.
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @private
 	 * @since 1.74

package/src/sap/ui/integration/cards/adaptivecards/elements/UI5InputDate.js CHANGED Viewed

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * <code>ui5-datepicker</code> web component.
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @private
 	 * @since 1.74

package/src/sap/ui/integration/cards/adaptivecards/elements/UI5InputNumber.js CHANGED Viewed

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * <code>ui5-step-input</code> web component.
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @private
 	 * @since 1.74

package/src/sap/ui/integration/cards/adaptivecards/elements/UI5InputText.js CHANGED Viewed

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * <code>ui5-input</code> or <code>ui5-textarea<code> UI5 web component.
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @private
 	 * @since 1.74

package/src/sap/ui/integration/cards/adaptivecards/elements/UI5InputToggle.js CHANGED Viewed

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * <code>ui5-checkbox</code> web component.
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @private
 	 * @since 1.74

package/src/sap/ui/integration/cards/filters/BaseFilter.js CHANGED Viewed

@@ -37,7 +37,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/cards/filters/DateRangeFilter.js CHANGED Viewed

@@ -84,7 +84,7 @@ sap.ui.define([
 	 * @extends sap.ui.integration.cards.filters.BaseFilter
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/cards/filters/FilterBar.js CHANGED Viewed

@@ -21,7 +21,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/cards/filters/FilterBarFactory.js CHANGED Viewed

@@ -36,7 +36,7 @@ sap.ui.define([
 	 * @extends sap.ui.base.Object
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/cards/filters/SearchFilter.js CHANGED Viewed

@@ -23,7 +23,7 @@ sap.ui.define([
 	 * @extends sap.ui.integration.cards.filters.BaseFilter
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/cards/filters/SelectFilter.js CHANGED Viewed

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * @extends sap.ui.integration.cards.filters.BaseFilter
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/controls/ActionsStrip.js CHANGED Viewed

@@ -48,7 +48,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/controls/ActionsToolbar.js CHANGED Viewed

@@ -76,7 +76,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/controls/LinkWithIcon.js CHANGED Viewed

@@ -29,7 +29,7 @@ sap.ui.define([
 	 * @extends sap.m.Link
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/controls/ListContentItem.js CHANGED Viewed

@@ -34,7 +34,7 @@ sap.ui.define([
 	 * @extends sap.m.StandardListItem
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/controls/Microchart.js CHANGED Viewed

@@ -7,11 +7,15 @@
 sap.ui.define([
 	"sap/m/library",
 	"sap/ui/core/Control",
-	"sap/ui/core/Core"
+	"sap/ui/core/Core",
+	"sap/ui/base/DataType",
+	"sap/base/Log"
 ], function (
 	mLibrary,
 	Control,
-	Core
+	Core,
+	DataType,
+	Log
 ) {
 	"use strict";
@@ -20,6 +24,28 @@ sap.ui.define([
 	var ValueColor = mLibrary.ValueColor;
+	/**
+	 * Validates the given bar valueColor against the sap.m.ValueColor type.
+	 * Normally sap.suite.ui.microchart.StackedBarMicroChartBar allows css colors, but for cards we limit this to sap.m.ValueColor.
+	 * That ensures that theming and the mobile rendering can work.
+	 * @param {string} sColor The color to validate.
+	 * @returns {string} The validated color.
+	 */
+	function validateBarValueColor(sColor) {
+		if (!sColor || typeof sColor !== "string") {
+			return sColor;
+		}
+		var bIsValid = DataType.getType("sap.m.ValueColor").isValid(sColor);
+		if (!bIsValid) {
+			Log.error("The value for stacked bar color must be a valid 'sap.m.ValueColor'. Given '" + sColor + "'.", "sap.ui.integration.controls.Microchart");
+			return null;
+		}
+		return sColor;
+	}
 	/**
 	 * Constructor for a new Microchart.
 	 * This is helper item which can visualize Microcharts.
@@ -32,7 +58,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private
@@ -157,10 +183,11 @@ sap.ui.define([
 		if (oChartSettings.type === "StackedBar") {
 			var aBars = oChartSettings.bars.map(function (oBar) {
+				var vColor = validateBarValueColor(oBar.color);
 				return new StackedBarMicroChartBar({
 					value: oBar.value,
 					displayValue: oBar.displayValue,
-					valueColor: oBar.color
+					valueColor: vColor
 				});
 			});

package/src/sap/ui/integration/controls/MicrochartLegend.js CHANGED Viewed

@@ -32,7 +32,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/controls/Paginator.js CHANGED Viewed

@@ -39,7 +39,7 @@ sap.ui.define([
 	 * @extends sap.ui.core.Control
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @constructor
 	 * @private

package/src/sap/ui/integration/designtime/baseEditor/BaseEditor.js CHANGED Viewed

@@ -132,7 +132,7 @@ sap.ui.define([
 	 * @alias sap.ui.integration.designtime.baseEditor.BaseEditor
 	 * @author SAP SE
 	 * @since 1.70.0
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 * @private
 	 * @experimental since 1.70.0
 	 * @ui5-restricted

package/src/sap/ui/integration/designtime/baseEditor/PropertyEditor.js CHANGED Viewed

@@ -37,7 +37,7 @@ sap.ui.define([
 	 * @alias sap.ui.integration.designtime.baseEditor.PropertyEditor
 	 * @author SAP SE
 	 * @since 1.73.0
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 * @private
 	 * @experimental since 1.73.0
 	 * @ui5-restricted

package/src/sap/ui/integration/designtime/baseEditor/PropertyEditors.js CHANGED Viewed

@@ -67,7 +67,7 @@ sap.ui.define([
 	 * @alias sap.ui.integration.designtime.baseEditor.PropertyEditors
 	 * @author SAP SE
 	 * @since 1.73.0
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 * @private
 	 * @experimental since 1.73.0
 	 * @ui5-restricted

package/src/sap/ui/integration/designtime/baseEditor/propertyEditor/BasePropertyEditor.js CHANGED Viewed

@@ -52,7 +52,7 @@ sap.ui.define([
 	 * @alias sap.ui.integration.designtime.baseEditor.propertyEditor.BasePropertyEditor
 	 * @author SAP SE
 	 * @since 1.70
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @private
 	 * @experimental 1.70

package/src/sap/ui/integration/designtime/baseEditor/propertyEditor/PropertyEditorFactory.js CHANGED Viewed

@@ -19,7 +19,7 @@ sap.ui.define([
 	 * @namespace sap.ui.integration.designtime.baseEditor.propertyEditor.PropertyEditorFactory
 	 *
 	 * @author SAP SE
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @static
 	 * @since 1.75

package/src/sap/ui/integration/designtime/baseEditor/propertyEditor/arrayEditor/ArrayEditor.js CHANGED Viewed

@@ -82,7 +82,7 @@ sap.ui.define([
 	 * @alias sap.ui.integration.designtime.baseEditor.propertyEditor.arrayEditor.ArrayEditor
 	 * @author SAP SE
 	 * @since 1.72
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @private
 	 * @experimental 1.72

package/src/sap/ui/integration/designtime/baseEditor/propertyEditor/booleanEditor/BooleanEditor.js CHANGED Viewed

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @alias sap.ui.integration.designtime.baseEditor.propertyEditor.booleanEditor.BooleanEditor
 	 * @author SAP SE
 	 * @since 1.72
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @private
 	 * @experimental 1.72

package/src/sap/ui/integration/designtime/baseEditor/propertyEditor/dateEditor/DateEditor.js CHANGED Viewed

@@ -22,7 +22,7 @@ sap.ui.define([
 	 * @alias sap.ui.integration.designtime.baseEditor.propertyEditor.dateEditor.DateEditor
 	 * @author SAP SE
 	 * @since 1.76
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @private
 	 * @experimental 1.76

package/src/sap/ui/integration/designtime/baseEditor/propertyEditor/dateTimeEditor/DateTimeEditor.js CHANGED Viewed

@@ -24,7 +24,7 @@ sap.ui.define([
 	 * @alias sap.ui.integration.designtime.baseEditor.propertyEditor.dateTimeEditor.DateTimeEditor
 	 * @author SAP SE
 	 * @since 1.76
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @private
 	 * @experimental 1.76

package/src/sap/ui/integration/designtime/baseEditor/propertyEditor/enumStringEditor/EnumStringEditor.js CHANGED Viewed

@@ -47,7 +47,7 @@ sap.ui.define([
 	 * @alias sap.ui.integration.designtime.baseEditor.propertyEditor.enumStringEditor.EnumStringEditor
 	 * @author SAP SE
 	 * @since 1.70
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @private
 	 * @experimental 1.70

package/src/sap/ui/integration/designtime/baseEditor/propertyEditor/groupEditor/GroupEditor.js CHANGED Viewed

@@ -47,7 +47,7 @@ sap.ui.define([
 	 * @alias sap.ui.integration.designtime.baseEditor.propertyEditor.groupEditor.GroupEditor
 	 * @author SAP SE
 	 * @since 1.85
-	 * @version 1.102.1
+	 * @version 1.103.0
 	 *
 	 * @private
 	 * @experimental 1.85