@sapui5/sap.fe.base 1.130.6 → 1.132.0

package/src/sap/fe/base/BindingToolkit.ts

@@ -28,7 +28,8 @@ import type {
 	PathAnnotationExpression,
 	PathConditionExpression,
 	Property,
-	PropertyAnnotationValue
+	PropertyAnnotationValue,
+	ConstantExpression as VocabConstantExpression
 } from "@sap-ux/vocabularies-types";
 import { CommonAnnotationTerms } from "@sap-ux/vocabularies-types/vocabularies/Common";
 import { resolveEnumValue } from "sap/fe/base/AnnotationEnum";
@@ -714,22 +715,17 @@ export function ref(reference: string | null): ReferenceExpression {
  * Wrap a state object into a path in model expression.
  * @template T
  * @param stateObjectProp The object to evaluate, if it's a constant it will be wrapped in a constant expression, if it's a state property it will be bound
+ * @param key The key of the state object to bind
  * @returns The correct binding toolkit expression
  */
-export function bindState<T extends PrimitiveType>(
-	stateObjectProp?: T | BindingInfoHolder<T>
-): PathInModelExpression<T> | ConstantExpression<T>;
-export function bindState<T extends readonly unknown[]>(stateObjectProp?: T | BindingInfoHolder<T>): PathInModelExpression<T>;
-export function bindState<T extends PrimitiveType | readonly PrimitiveType[]>(
-	stateObjectProp?: T | BindingInfoHolder<T>
-): PathInModelExpression<T> | ConstantExpression<T> {
+export function bindState<T extends object, K extends PrimitiveType>(
+	stateObjectProp: T,
+	key: keyof T
+): PathInModelExpression<K> | ConstantExpression<K> {
 	if (typeof stateObjectProp === "object" && (stateObjectProp as BindingInfoHolder<T>).__bindingInfo) {
-		return pathInModel(
-			(stateObjectProp as BindingInfoHolder<T>).__bindingInfo.path,
-			(stateObjectProp as BindingInfoHolder<T>).__bindingInfo.model
-		);
+		return pathInModel("/" + key.toString(), (stateObjectProp as BindingInfoHolder<T>).__bindingInfo.model);
 	} else {
-		return constant(stateObjectProp as T);
+		return constant(stateObjectProp) as unknown as ConstantExpression<K>;
 	}
 }
 /**
@@ -852,7 +848,8 @@ type ComplexAnnotationExpression<P> =
 	| GtAnnotationExpression<P>
 	| GeAnnotationExpression<P>
 	| LeAnnotationExpression<P>
-	| LtAnnotationExpression<P>;
+	| LtAnnotationExpression<P>
+	| VocabConstantExpression<P>;
 
 function isPrimitiveObject(objectType: object): boolean {
 	switch (objectType.constructor.name) {
@@ -956,6 +953,9 @@ export function getExpressionFromAnnotation<T extends PrimitiveType>(
 				visitedNavigationPaths,
 				pathVisitor
 			) as BindingToolkitExpression<PrimitiveTypeCast<T>>;
+		case "Constant":
+			// Not a real case but the type system needs it
+			return constant(annotationValue.value as PrimitiveTypeCast<T>);
 	}
 	return unresolvableExpression;
 }
@@ -1772,11 +1772,15 @@ export function addTypeInformation<T, U extends Fn<T>>(
 		const uomPath = pathInModel("/##@@requestUnitsOfMeasure");
 		uomPath.targetType = "any";
 		uomPath.mode = "OneTime";
+		oFormatOptions ??= {};
+		oFormatOptions.preserveDecimals = false; // default value since we don't have a CLDR
 		parameterExpressions.push(uomPath);
 	} else if (type === "sap.ui.model.odata.type.Currency") {
 		const currencyPath = pathInModel("/##@@requestCurrencyCodes");
 		currencyPath.targetType = "any";
 		currencyPath.mode = "OneTime";
+		oFormatOptions ??= {};
+		oFormatOptions.preserveDecimals = false; // default value since we don't have a CLDR
 		parameterExpressions.push(currencyPath);
 	}
 
@@ -1799,6 +1803,7 @@ type ComplexTypeFormatOptions = {
 	showTime?: boolean;
 	showDate?: boolean;
 	showTimezone?: boolean;
+	preserveDecimals?: boolean;
 };
 
 export type ComplexTypeConstraintOptions = {

package/src/sap/fe/base/BuildingBlockBase.js

@@ -0,0 +1,184 @@
+/*!
+ * SAP UI development toolkit for HTML5 (SAPUI5)
+ *      (c) Copyright 2009-2024 SAP SE. All rights reserved
+ */
+sap.ui.define(["sap/fe/base/BindingToolkit", "sap/fe/base/ClassSupport", "sap/ui/core/Control", "sap/ui/core/InvisibleRenderer"], function (BindingToolkit, ClassSupport, Control, InvisibleRenderer) {
+  "use strict";
+
+  var _dec, _dec2, _dec3, _dec4, _class, _class2, _descriptor, _descriptor2, _descriptor3;
+  var defineUI5Class = ClassSupport.defineUI5Class;
+  var defineState = ClassSupport.defineState;
+  var association = ClassSupport.association;
+  var aggregation = ClassSupport.aggregation;
+  function _initializerDefineProperty(e, i, r, l) { r && Object.defineProperty(e, i, { enumerable: r.enumerable, configurable: r.configurable, writable: r.writable, value: r.initializer ? r.initializer.call(l) : void 0 }); }
+  function _inheritsLoose(t, o) { t.prototype = Object.create(o.prototype), t.prototype.constructor = t, _setPrototypeOf(t, o); }
+  function _setPrototypeOf(t, e) { return _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function (t, e) { return t.__proto__ = e, t; }, _setPrototypeOf(t, e); }
+  function _applyDecoratedDescriptor(i, e, r, n, l) { var a = {}; return Object.keys(n).forEach(function (i) { a[i] = n[i]; }), a.enumerable = !!a.enumerable, a.configurable = !!a.configurable, ("value" in a || a.initializer) && (a.writable = !0), a = r.slice().reverse().reduce(function (r, n) { return n(i, e, r) || r; }, a), l && void 0 !== a.initializer && (a.value = a.initializer ? a.initializer.call(l) : void 0, a.initializer = void 0), void 0 === a.initializer ? (Object.defineProperty(i, e, a), null) : a; }
+  function _initializerWarningHelper(r, e) { throw Error("Decorating class property failed. Please ensure that transform-class-properties is enabled and runs after the decorators transform."); }
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  /**
+   * Base class for building blocks.
+   * This contains the low level functionality of having a content aggregation and handling the rendering of the content without an actual DOM element.
+   * The building block also defines a state object that can be used to store the state of the building block.
+   * Accessibility and classes information are forwarded to the content control.
+   * @experimental
+   * @public
+   */
+  let BuildingBlockBase = (_dec = defineUI5Class("sap.fe.base.BuildingBlockBase"), _dec2 = aggregation({
+    type: "sap.ui.core.Element",
+    multiple: false,
+    isDefault: true
+  }), _dec3 = association({
+    type: "sap.ui.core.Control",
+    multiple: true,
+    singularName: "ariaLabelledBy"
+  }), _dec4 = defineState(), _dec(_class = (_class2 = /*#__PURE__*/function (_Control) {
+    function BuildingBlockBase(settings, others) {
+      var _this;
+      if (typeof settings === "string") {
+        others ??= {};
+        others.id = settings;
+      }
+      _this = _Control.call(this, settings, others) || this;
+      _initializerDefineProperty(_this, "content", _descriptor, _this);
+      /**
+       * Association to controls / IDs that label this control (see WAI-ARIA attribute aria-labelledby).
+       */
+      _initializerDefineProperty(_this, "ariaLabelledBy", _descriptor2, _this);
+      _initializerDefineProperty(_this, "state", _descriptor3, _this);
+      _this._oldDomRef = null;
+      return _this;
+    }
+    _inheritsLoose(BuildingBlockBase, _Control);
+    BuildingBlockBase.render = function render(oRm, oControl) {
+      if (!oControl.content || oControl.getVisible() === false) {
+        InvisibleRenderer.render(oRm, oControl);
+      } else {
+        oRm.renderControl(oControl.content);
+      }
+    }
+
+    /**
+     * Override the bindProperty to deal with the case where the property is a binding info.
+     * @param name The name of te property
+     * @param bindingInfo The binding info
+     * @returns The instance of the building block for chaining
+     */;
+    var _proto = BuildingBlockBase.prototype;
+    _proto.bindProperty = function bindProperty(name, bindingInfo) {
+      const propertyMetadata = this.getMetadata().getProperty(name);
+      if (propertyMetadata?.bindable === false && propertyMetadata.group === "Data") {
+        this[name] = bindingInfo;
+      } else {
+        _Control.prototype.bindProperty.call(this, name, bindingInfo);
+      }
+      return this;
+    }
+
+    //set the old dom ref
+    ;
+    _proto.onAfterRendering = function onAfterRendering(event) {
+      const domRef = this.getDomRef();
+      if (domRef) {
+        this._oldDomRef = new WeakRef(domRef);
+      } else {
+        this._oldDomRef = null;
+      }
+      _Control.prototype.onAfterRendering.call(this, event);
+    };
+    _proto.getDomRef = function getDomRef() {
+      const oContent = this.content;
+      let domRef = oContent?.getDomRef() ?? _Control.prototype.getDomRef.call(this);
+      if (!domRef) {
+        domRef = this._oldDomRef?.deref() ?? null;
+        if (domRef) {
+          return document.getElementById(domRef.id);
+        }
+      }
+      return domRef;
+    };
+    _proto.getFocusDomRef = function getFocusDomRef() {
+      const oContent = this.content;
+      return oContent ? oContent.getFocusDomRef() : _Control.prototype.getFocusDomRef.call(this);
+    }
+
+    /**
+     * This function asks up the control tree to enhance the accessibility state of the control.
+     * @param _oElement The element to enhance
+     * @param mAriaProps The current aria properties
+     * @returns The enhanced aria properties
+     */;
+    _proto.enhanceAccessibilityState = function enhanceAccessibilityState(_oElement, mAriaProps) {
+      const oParent = this.getParent();
+      if (oParent && oParent.enhanceAccessibilityState) {
+        // forward  enhanceAccessibilityState call to the parent
+        oParent.enhanceAccessibilityState(_oElement, mAriaProps);
+      }
+      return mAriaProps;
+    }
+
+    /**
+     * This function (if available on the concrete control) provides the current accessibility state of the control.
+     * @returns The accessibility information for the control.
+     */;
+    _proto.getAccessibilityInfo = function getAccessibilityInfo() {
+      let accessibilityInfo = {};
+      if (this.content?.isA("sap.ui.core.Control")) {
+        accessibilityInfo = this.content.getAccessibilityInfo();
+      }
+      return accessibilityInfo;
+    }
+
+    /**
+     * Returns the DOMNode ID to be used for the "labelFor" attribute.
+     *
+     * We forward the call of this method to the content control.
+     * @returns ID to be used for the <code>labelFor</code>
+     */;
+    _proto.getIdForLabel = function getIdForLabel() {
+      if (this.content?.isA("sap.ui.core.Control")) {
+        return this.content.getIdForLabel();
+      }
+      return "";
+    };
+    _proto.addStyleClass = function addStyleClass(styleClass) {
+      this.content?.addStyleClass(styleClass);
+      _Control.prototype.addStyleClass.call(this, styleClass);
+      return this;
+    };
+    _proto.removeStyleClass = function removeStyleClass(styleClass) {
+      this.content?.removeStyleClass(styleClass);
+      _Control.prototype.removeStyleClass.call(this, styleClass);
+      return this;
+    }
+
+    /**
+     * Shorthand for the BindingToolkit.bindState function with the current state object.
+     * @param path A property in the state object
+     * @returns The binding toolkit expression for the state
+     */;
+    _proto.bindState = function bindState(path) {
+      return BindingToolkit.bindState(this.state, path);
+    };
+    return BuildingBlockBase;
+  }(Control), _descriptor = _applyDecoratedDescriptor(_class2.prototype, "content", [_dec2], {
+    configurable: true,
+    enumerable: true,
+    writable: true,
+    initializer: null
+  }), _descriptor2 = _applyDecoratedDescriptor(_class2.prototype, "ariaLabelledBy", [_dec3], {
+    configurable: true,
+    enumerable: true,
+    writable: true,
+    initializer: null
+  }), _descriptor3 = _applyDecoratedDescriptor(_class2.prototype, "state", [_dec4], {
+    configurable: true,
+    enumerable: true,
+    writable: true,
+    initializer: function () {
+      return {};
+    }
+  }), _class2)) || _class);
+  return BuildingBlockBase;
+}, false);
+//# sourceMappingURL=data:application/json;charset=utf-8;base64,eyJ2ZXJzaW9uIjozLCJuYW1lcyI6WyJCdWlsZGluZ0Jsb2NrQmFzZSIsIl9kZWMiLCJkZWZpbmVVSTVDbGFzcyIsIl9kZWMyIiwiYWdncmVnYXRpb24iLCJ0eXBlIiwibXVsdGlwbGUiLCJpc0RlZmF1bHQiLCJfZGVjMyIsImFzc29jaWF0aW9uIiwic2luZ3VsYXJOYW1lIiwiX2RlYzQiLCJkZWZpbmVTdGF0ZSIsIl9jbGFzcyIsIl9jbGFzczIiLCJfQ29udHJvbCIsInNldHRpbmdzIiwib3RoZXJzIiwiX3RoaXMiLCJpZCIsImNhbGwiLCJfaW5pdGlhbGl6ZXJEZWZpbmVQcm9wZXJ0eSIsIl9kZXNjcmlwdG9yIiwiX2Rlc2NyaXB0b3IyIiwiX2Rlc2NyaXB0b3IzIiwiX29sZERvbVJlZiIsIl9pbmhlcml0c0xvb3NlIiwicmVuZGVyIiwib1JtIiwib0NvbnRyb2wiLCJjb250ZW50IiwiZ2V0VmlzaWJsZSIsIkludmlzaWJsZVJlbmRlcmVyIiwicmVuZGVyQ29udHJvbCIsIl9wcm90byIsInByb3RvdHlwZSIsImJpbmRQcm9wZXJ0eSIsIm5hbWUiLCJiaW5kaW5nSW5mbyIsInByb3BlcnR5TWV0YWRhdGEiLCJnZXRNZXRhZGF0YSIsImdldFByb3BlcnR5IiwiYmluZGFibGUiLCJncm91cCIsIm9uQWZ0ZXJSZW5kZXJpbmciLCJldmVudCIsImRvbVJlZiIsImdldERvbVJlZiIsIldlYWtSZWYiLCJvQ29udGVudCIsImRlcmVmIiwiZG9jdW1lbnQiLCJnZXRFbGVtZW50QnlJZCIsImdldEZvY3VzRG9tUmVmIiwiZW5oYW5jZUFjY2Vzc2liaWxpdHlTdGF0ZSIsIl9vRWxlbWVudCIsIm1BcmlhUHJvcHMiLCJvUGFyZW50IiwiZ2V0UGFyZW50IiwiZ2V0QWNjZXNzaWJpbGl0eUluZm8iLCJhY2Nlc3NpYmlsaXR5SW5mbyIsImlzQSIsImdldElkRm9yTGFiZWwiLCJhZGRTdHlsZUNsYXNzIiwic3R5bGVDbGFzcyIsInJlbW92ZVN0eWxlQ2xhc3MiLCJiaW5kU3RhdGUiLCJwYXRoIiwiQmluZGluZ1Rvb2xraXQiLCJzdGF0ZSIsIkNvbnRyb2wiLCJfYXBwbHlEZWNvcmF0ZWREZXNjcmlwdG9yIiwiY29uZmlndXJhYmxlIiwiZW51bWVyYWJsZSIsIndyaXRhYmxlIiwiaW5pdGlhbGl6ZXIiXSwic291cmNlUm9vdCI6Ii4iLCJzb3VyY2VzIjpbIkJ1aWxkaW5nQmxvY2tCYXNlLnRzIl0sInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB0eXBlIHsgQ29uc3RhbnRFeHByZXNzaW9uLCBQYXRoSW5Nb2RlbEV4cHJlc3Npb24sIFByaW1pdGl2ZVR5cGUgfSBmcm9tIFwic2FwL2ZlL2Jhc2UvQmluZGluZ1Rvb2xraXRcIjtcbmltcG9ydCAqIGFzIEJpbmRpbmdUb29sa2l0IGZyb20gXCJzYXAvZmUvYmFzZS9CaW5kaW5nVG9vbGtpdFwiO1xuaW1wb3J0IHR5cGUgeyBQcm9wZXJ0aWVzT2YsIFN0YXRlT2YgfSBmcm9tIFwic2FwL2ZlL2Jhc2UvQ2xhc3NTdXBwb3J0XCI7XG5pbXBvcnQgeyBhZ2dyZWdhdGlvbiwgYXNzb2NpYXRpb24sIGRlZmluZVN0YXRlLCBkZWZpbmVVSTVDbGFzcyB9IGZyb20gXCJzYXAvZmUvYmFzZS9DbGFzc1N1cHBvcnRcIjtcbmltcG9ydCB0eXBlIE1hbmFnZWRPYmplY3QgZnJvbSBcInNhcC91aS9iYXNlL01hbmFnZWRPYmplY3RcIjtcbmltcG9ydCB0eXBlIHsgUHJvcGVydHlCaW5kaW5nSW5mbyB9IGZyb20gXCJzYXAvdWkvYmFzZS9NYW5hZ2VkT2JqZWN0XCI7XG5pbXBvcnQgQ29udHJvbCBmcm9tIFwic2FwL3VpL2NvcmUvQ29udHJvbFwiO1xuaW1wb3J0IHR5cGUgVUk1RWxlbWVudCBmcm9tIFwic2FwL3VpL2NvcmUvRWxlbWVudFwiO1xuaW1wb3J0IEludmlzaWJsZVJlbmRlcmVyIGZyb20gXCJzYXAvdWkvY29yZS9JbnZpc2libGVSZW5kZXJlclwiO1xuaW1wb3J0IHR5cGUgUmVuZGVyTWFuYWdlciBmcm9tIFwic2FwL3VpL2NvcmUvUmVuZGVyTWFuYWdlclwiO1xuXG4vLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgQHR5cGVzY3JpcHQtZXNsaW50L25vLXVudXNlZC12YXJzXG5pbnRlcmZhY2UgQnVpbGRpbmdCbG9ja0Jhc2U8VCBleHRlbmRzIFVJNUVsZW1lbnQgPSBDb250cm9sLCBLIGV4dGVuZHMgb2JqZWN0ID0ge30+IHtcblx0Ly8gRm9yY2UgYSBzdGF0ZSB1cGRhdGVcblx0X3VwZGF0ZVN0YXRlKCk6IFByb21pc2U8dm9pZD47XG59XG5cbi8qKlxuICogQmFzZSBjbGFzcyBmb3IgYnVpbGRpbmcgYmxvY2tzLlxuICogVGhpcyBjb250YWlucyB0aGUgbG93IGxldmVsIGZ1bmN0aW9uYWxpdHkgb2YgaGF2aW5nIGEgY29udGVudCBhZ2dyZWdhdGlvbiBhbmQgaGFuZGxpbmcgdGhlIHJlbmRlcmluZyBvZiB0aGUgY29udGVudCB3aXRob3V0IGFuIGFjdHVhbCBET00gZWxlbWVudC5cbiAqIFRoZSBidWlsZGluZyBibG9jayBhbHNvIGRlZmluZXMgYSBzdGF0ZSBvYmplY3QgdGhhdCBjYW4gYmUgdXNlZCB0byBzdG9yZSB0aGUgc3RhdGUgb2YgdGhlIGJ1aWxkaW5nIGJsb2NrLlxuICogQWNjZXNzaWJpbGl0eSBhbmQgY2xhc3NlcyBpbmZvcm1hdGlvbiBhcmUgZm9yd2FyZGVkIHRvIHRoZSBjb250ZW50IGNvbnRyb2wuXG4gKiBAZXhwZXJpbWVudGFsXG4gKiBAcHVibGljXG4gKi9cbkBkZWZpbmVVSTVDbGFzcyhcInNhcC5mZS5iYXNlLkJ1aWxkaW5nQmxvY2tCYXNlXCIpXG5jbGFzcyBCdWlsZGluZ0Jsb2NrQmFzZTxUIGV4dGVuZHMgVUk1RWxlbWVudCA9IENvbnRyb2wsIEsgZXh0ZW5kcyBvYmplY3QgPSB7fT4gZXh0ZW5kcyBDb250cm9sIHtcblx0QGFnZ3JlZ2F0aW9uKHsgdHlwZTogXCJzYXAudWkuY29yZS5FbGVtZW50XCIsIG11bHRpcGxlOiBmYWxzZSwgaXNEZWZhdWx0OiB0cnVlIH0pXG5cdGNvbnRlbnQ/OiBUO1xuXG5cdC8qKlxuXHQgKiBBc3NvY2lhdGlvbiB0byBjb250cm9scyAvIElEcyB0aGF0IGxhYmVsIHRoaXMgY29udHJvbCAoc2VlIFdBSS1BUklBIGF0dHJpYnV0ZSBhcmlhLWxhYmVsbGVkYnkpLlxuXHQgKi9cblx0QGFzc29jaWF0aW9uKHsgdHlwZTogXCJzYXAudWkuY29yZS5Db250cm9sXCIsIG11bHRpcGxlOiB0cnVlLCBzaW5ndWxhck5hbWU6IFwiYXJpYUxhYmVsbGVkQnlcIiB9KVxuXHRhcmlhTGFiZWxsZWRCeSE6IHN0cmluZ1tdO1xuXG5cdEBkZWZpbmVTdGF0ZSgpXG5cdHByb3RlY3RlZCBzdGF0ZTogU3RhdGVPZjxLPiA9IHt9IGFzIFN0YXRlT2Y8Sz47XG5cblx0Y29uc3RydWN0b3Ioc2V0dGluZ3M/OiBzdHJpbmcgfCBQcm9wZXJ0aWVzT2Y8QnVpbGRpbmdCbG9ja0Jhc2U8VD4+LCBvdGhlcnM/OiBQcm9wZXJ0aWVzT2Y8QnVpbGRpbmdCbG9ja0Jhc2U8VD4+KSB7XG5cdFx0aWYgKHR5cGVvZiBzZXR0aW5ncyA9PT0gXCJzdHJpbmdcIikge1xuXHRcdFx0b3RoZXJzID8/PSB7fTtcblx0XHRcdG90aGVycy5pZCA9IHNldHRpbmdzO1xuXHRcdH1cblx0XHRzdXBlcihzZXR0aW5ncyBhcyB1bmtub3duIGFzIHN0cmluZywgb3RoZXJzKTtcblx0fVxuXG5cdHByaXZhdGUgX29sZERvbVJlZjogV2Vha1JlZjxFbGVtZW50PiB8IG51bGwgPSBudWxsO1xuXG5cdHN0YXRpYyByZW5kZXI8VCBleHRlbmRzIENvbnRyb2w+KG9SbTogUmVuZGVyTWFuYWdlciwgb0NvbnRyb2w6IEJ1aWxkaW5nQmxvY2tCYXNlPFQ+KTogdm9pZCB7XG5cdFx0aWYgKCFvQ29udHJvbC5jb250ZW50IHx8IG9Db250cm9sLmdldFZpc2libGUoKSA9PT0gZmFsc2UpIHtcblx0XHRcdEludmlzaWJsZVJlbmRlcmVyLnJlbmRlcihvUm0sIG9Db250cm9sKTtcblx0XHR9IGVsc2Uge1xuXHRcdFx0b1JtLnJlbmRlckNvbnRyb2wob0NvbnRyb2wuY29udGVudCk7XG5cdFx0fVxuXHR9XG5cblx0LyoqXG5cdCAqIE92ZXJyaWRlIHRoZSBiaW5kUHJvcGVydHkgdG8gZGVhbCB3aXRoIHRoZSBjYXNlIHdoZXJlIHRoZSBwcm9wZXJ0eSBpcyBhIGJpbmRpbmcgaW5mby5cblx0ICogQHBhcmFtIG5hbWUgVGhlIG5hbWUgb2YgdGUgcHJvcGVydHlcblx0ICogQHBhcmFtIGJpbmRpbmdJbmZvIFRoZSBiaW5kaW5nIGluZm9cblx0ICogQHJldHVybnMgVGhlIGluc3RhbmNlIG9mIHRoZSBidWlsZGluZyBibG9jayBmb3IgY2hhaW5pbmdcblx0ICovXG5cdG92ZXJyaWRlIGJpbmRQcm9wZXJ0eShuYW1lOiBzdHJpbmcsIGJpbmRpbmdJbmZvOiBQcm9wZXJ0eUJpbmRpbmdJbmZvKTogdGhpcyB7XG5cdFx0Y29uc3QgcHJvcGVydHlNZXRhZGF0YSA9IHRoaXMuZ2V0TWV0YWRhdGEoKS5nZXRQcm9wZXJ0eShuYW1lKTtcblx0XHRpZiAocHJvcGVydHlNZXRhZGF0YT8uYmluZGFibGUgPT09IGZhbHNlICYmIHByb3BlcnR5TWV0YWRhdGEuZ3JvdXAgPT09IFwiRGF0YVwiKSB7XG5cdFx0XHQodGhpcyBhcyBSZWNvcmQ8c3RyaW5nLCB1bmtub3duPilbbmFtZV0gPSBiaW5kaW5nSW5mbztcblx0XHR9IGVsc2Uge1xuXHRcdFx0c3VwZXIuYmluZFByb3BlcnR5KG5hbWUsIGJpbmRpbmdJbmZvKTtcblx0XHR9XG5cdFx0cmV0dXJuIHRoaXM7XG5cdH1cblxuXHQvL3NldCB0aGUgb2xkIGRvbSByZWZcblx0b3ZlcnJpZGUgb25BZnRlclJlbmRlcmluZyhldmVudDogSlF1ZXJ5LkV2ZW50KTogdm9pZCB7XG5cdFx0Y29uc3QgZG9tUmVmID0gdGhpcy5nZXREb21SZWYoKTtcblx0XHRpZiAoZG9tUmVmKSB7XG5cdFx0XHR0aGlzLl9vbGREb21SZWYgPSBuZXcgV2Vha1JlZihkb21SZWYpO1xuXHRcdH0gZWxzZSB7XG5cdFx0XHR0aGlzLl9vbGREb21SZWYgPSBudWxsO1xuXHRcdH1cblx0XHRzdXBlci5vbkFmdGVyUmVuZGVyaW5nKGV2ZW50KTtcblx0fVxuXG5cdG92ZXJyaWRlIGdldERvbVJlZigpOiBFbGVtZW50IHwgbnVsbCB7XG5cdFx0Y29uc3Qgb0NvbnRlbnQgPSB0aGlzLmNvbnRlbnQ7XG5cdFx0bGV0IGRvbVJlZjogRWxlbWVudCB8IG51bGwgPSBvQ29udGVudD8uZ2V0RG9tUmVmKCkgPz8gc3VwZXIuZ2V0RG9tUmVmKCk7XG5cdFx0aWYgKCFkb21SZWYpIHtcblx0XHRcdGRvbVJlZiA9IHRoaXMuX29sZERvbVJlZj8uZGVyZWYoKSA/PyBudWxsO1xuXHRcdFx0aWYgKGRvbVJlZikge1xuXHRcdFx0XHRyZXR1cm4gZG9jdW1lbnQuZ2V0RWxlbWVudEJ5SWQoZG9tUmVmLmlkKTtcblx0XHRcdH1cblx0XHR9XG5cdFx0cmV0dXJuIGRvbVJlZjtcblx0fVxuXG5cdG92ZXJyaWRlIGdldEZvY3VzRG9tUmVmKCk6IEVsZW1lbnQgfCBudWxsIHtcblx0XHRjb25zdCBvQ29udGVudCA9IHRoaXMuY29udGVudDtcblx0XHRyZXR1cm4gb0NvbnRlbnQgPyBvQ29udGVudC5nZXRGb2N1c0RvbVJlZigpIDogc3VwZXIuZ2V0Rm9jdXNEb21SZWYoKTtcblx0fVxuXG5cdC8qKlxuXHQgKiBUaGlzIGZ1bmN0aW9uIGFza3MgdXAgdGhlIGNvbnRyb2wgdHJlZSB0byBlbmhhbmNlIHRoZSBhY2Nlc3NpYmlsaXR5IHN0YXRlIG9mIHRoZSBjb250cm9sLlxuXHQgKiBAcGFyYW0gX29FbGVtZW50IFRoZSBlbGVtZW50IHRvIGVuaGFuY2Vcblx0ICogQHBhcmFtIG1BcmlhUHJvcHMgVGhlIGN1cnJlbnQgYXJpYSBwcm9wZXJ0aWVzXG5cdCAqIEByZXR1cm5zIFRoZSBlbmhhbmNlZCBhcmlhIHByb3BlcnRpZXNcblx0ICovXG5cdG92ZXJyaWRlIGVuaGFuY2VBY2Nlc3NpYmlsaXR5U3RhdGUoX29FbGVtZW50OiBvYmplY3QsIG1BcmlhUHJvcHM6IG9iamVjdCk6IG9iamVjdCB7XG5cdFx0Y29uc3Qgb1BhcmVudCA9IHRoaXMuZ2V0UGFyZW50KCk7XG5cblx0XHRpZiAob1BhcmVudCAmJiAob1BhcmVudCBhcyBNYW5hZ2VkT2JqZWN0ICYgeyBlbmhhbmNlQWNjZXNzaWJpbGl0eVN0YXRlPzogRnVuY3Rpb24gfSkuZW5oYW5jZUFjY2Vzc2liaWxpdHlTdGF0ZSkge1xuXHRcdFx0Ly8gZm9yd2FyZCAgZW5oYW5jZUFjY2Vzc2liaWxpdHlTdGF0ZSBjYWxsIHRvIHRoZSBwYXJlbnRcblx0XHRcdChvUGFyZW50IGFzIE1hbmFnZWRPYmplY3QgJiB7IGVuaGFuY2VBY2Nlc3NpYmlsaXR5U3RhdGU6IEZ1bmN0aW9uIH0pLmVuaGFuY2VBY2Nlc3NpYmlsaXR5U3RhdGUoX29FbGVtZW50LCBtQXJpYVByb3BzKTtcblx0XHR9XG5cblx0XHRyZXR1cm4gbUFyaWFQcm9wcztcblx0fVxuXG5cdC8qKlxuXHQgKiBUaGlzIGZ1bmN0aW9uIChpZiBhdmFpbGFibGUgb24gdGhlIGNvbmNyZXRlIGNvbnRyb2wpIHByb3ZpZGVzIHRoZSBjdXJyZW50IGFjY2Vzc2liaWxpdHkgc3RhdGUgb2YgdGhlIGNvbnRyb2wuXG5cdCAqIEByZXR1cm5zIFRoZSBhY2Nlc3NpYmlsaXR5IGluZm9ybWF0aW9uIGZvciB0aGUgY29udHJvbC5cblx0ICovXG5cdG92ZXJyaWRlIGdldEFjY2Vzc2liaWxpdHlJbmZvKCk6IE9iamVjdCB7XG5cdFx0bGV0IGFjY2Vzc2liaWxpdHlJbmZvID0ge307XG5cdFx0aWYgKHRoaXMuY29udGVudD8uaXNBPENvbnRyb2w+KFwic2FwLnVpLmNvcmUuQ29udHJvbFwiKSkge1xuXHRcdFx0YWNjZXNzaWJpbGl0eUluZm8gPSB0aGlzLmNvbnRlbnQuZ2V0QWNjZXNzaWJpbGl0eUluZm8oKTtcblx0XHR9XG5cdFx0cmV0dXJuIGFjY2Vzc2liaWxpdHlJbmZvO1xuXHR9XG5cblx0LyoqXG5cdCAqIFJldHVybnMgdGhlIERPTU5vZGUgSUQgdG8gYmUgdXNlZCBmb3IgdGhlIFwibGFiZWxGb3JcIiBhdHRyaWJ1dGUuXG5cdCAqXG5cdCAqIFdlIGZvcndhcmQgdGhlIGNhbGwgb2YgdGhpcyBtZXRob2QgdG8gdGhlIGNvbnRlbnQgY29udHJvbC5cblx0ICogQHJldHVybnMgSUQgdG8gYmUgdXNlZCBmb3IgdGhlIDxjb2RlPmxhYmVsRm9yPC9jb2RlPlxuXHQgKi9cblx0b3ZlcnJpZGUgZ2V0SWRGb3JMYWJlbCgpOiBzdHJpbmcge1xuXHRcdGlmICh0aGlzLmNvbnRlbnQ/LmlzQTxDb250cm9sPihcInNhcC51aS5jb3JlLkNvbnRyb2xcIikpIHtcblx0XHRcdHJldHVybiB0aGlzLmNvbnRlbnQuZ2V0SWRGb3JMYWJlbCgpO1xuXHRcdH1cblx0XHRyZXR1cm4gXCJcIjtcblx0fVxuXG5cdG92ZXJyaWRlIGFkZFN0eWxlQ2xhc3Moc3R5bGVDbGFzczogc3RyaW5nKTogdGhpcyB7XG5cdFx0KHRoaXMuY29udGVudCBhcyB1bmtub3duIGFzIENvbnRyb2wpPy5hZGRTdHlsZUNsYXNzKHN0eWxlQ2xhc3MpO1xuXHRcdHN1cGVyLmFkZFN0eWxlQ2xhc3Moc3R5bGVDbGFzcyk7XG5cdFx0cmV0dXJuIHRoaXM7XG5cdH1cblxuXHRvdmVycmlkZSByZW1vdmVTdHlsZUNsYXNzKHN0eWxlQ2xhc3M6IHN0cmluZyk6IHRoaXMge1xuXHRcdCh0aGlzLmNvbnRlbnQgYXMgdW5rbm93biBhcyBDb250cm9sKT8ucmVtb3ZlU3R5bGVDbGFzcyhzdHlsZUNsYXNzKTtcblx0XHRzdXBlci5yZW1vdmVTdHlsZUNsYXNzKHN0eWxlQ2xhc3MpO1xuXHRcdHJldHVybiB0aGlzO1xuXHR9XG5cblx0LyoqXG5cdCAqIFNob3J0aGFuZCBmb3IgdGhlIEJpbmRpbmdUb29sa2l0LmJpbmRTdGF0ZSBmdW5jdGlvbiB3aXRoIHRoZSBjdXJyZW50IHN0YXRlIG9iamVjdC5cblx0ICogQHBhcmFtIHBhdGggQSBwcm9wZXJ0eSBpbiB0aGUgc3RhdGUgb2JqZWN0XG5cdCAqIEByZXR1cm5zIFRoZSBiaW5kaW5nIHRvb2xraXQgZXhwcmVzc2lvbiBmb3IgdGhlIHN0YXRlXG5cdCAqL1xuXHRwcm90ZWN0ZWQgYmluZFN0YXRlKHBhdGg6IGtleW9mIEspOiBQYXRoSW5Nb2RlbEV4cHJlc3Npb248UHJpbWl0aXZlVHlwZT4gfCBDb25zdGFudEV4cHJlc3Npb248UHJpbWl0aXZlVHlwZT4ge1xuXHRcdHJldHVybiBCaW5kaW5nVG9vbGtpdC5iaW5kU3RhdGUodGhpcy5zdGF0ZSBhcyBLLCBwYXRoKTtcblx0fVxufVxuXG5leHBvcnQgZGVmYXVsdCBCdWlsZGluZ0Jsb2NrQmFzZTtcbiJdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7RUFXQTtFQU1BO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7QUFDQTtBQUNBO0FBQ0E7RUFQQSxJQVNNQSxpQkFBaUIsSUFBQUMsSUFBQSxHQUR0QkMsY0FBYyxDQUFDLCtCQUErQixDQUFDLEVBQUFDLEtBQUEsR0FFOUNDLFdBQVcsQ0FBQztJQUFFQyxJQUFJLEVBQUUscUJBQXFCO0lBQUVDLFFBQVEsRUFBRSxLQUFLO0lBQUVDLFNBQVMsRUFBRTtFQUFLLENBQUMsQ0FBQyxFQUFBQyxLQUFBLEdBTTlFQyxXQUFXLENBQUM7SUFBRUosSUFBSSxFQUFFLHFCQUFxQjtJQUFFQyxRQUFRLEVBQUUsSUFBSTtJQUFFSSxZQUFZLEVBQUU7RUFBaUIsQ0FBQyxDQUFDLEVBQUFDLEtBQUEsR0FHNUZDLFdBQVcsQ0FBQyxDQUFDLEVBQUFYLElBQUEsQ0FBQVksTUFBQSxJQUFBQyxPQUFBLDBCQUFBQyxRQUFBO0lBR2QsU0FBQWYsa0JBQVlnQixRQUFzRCxFQUFFQyxNQUEyQyxFQUFFO01BQUEsSUFBQUMsS0FBQTtNQUNoSCxJQUFJLE9BQU9GLFFBQVEsS0FBSyxRQUFRLEVBQUU7UUFDakNDLE1BQU0sS0FBSyxDQUFDLENBQUM7UUFDYkEsTUFBTSxDQUFDRSxFQUFFLEdBQUdILFFBQVE7TUFDckI7TUFDQUUsS0FBQSxHQUFBSCxRQUFBLENBQUFLLElBQUEsT0FBTUosUUFBUSxFQUF1QkMsTUFBTSxDQUFDO01BQUNJLDBCQUFBLENBQUFILEtBQUEsYUFBQUksV0FB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

package/src/sap/fe/base/BuildingBlockBase.ts

@@ -0,0 +1,166 @@
+import type { ConstantExpression, PathInModelExpression, PrimitiveType } from "sap/fe/base/BindingToolkit";
+import * as BindingToolkit from "sap/fe/base/BindingToolkit";
+import type { PropertiesOf, StateOf } from "sap/fe/base/ClassSupport";
+import { aggregation, association, defineState, defineUI5Class } from "sap/fe/base/ClassSupport";
+import type ManagedObject from "sap/ui/base/ManagedObject";
+import type { PropertyBindingInfo } from "sap/ui/base/ManagedObject";
+import Control from "sap/ui/core/Control";
+import type UI5Element from "sap/ui/core/Element";
+import InvisibleRenderer from "sap/ui/core/InvisibleRenderer";
+import type RenderManager from "sap/ui/core/RenderManager";
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+interface BuildingBlockBase<T extends UI5Element = Control, K extends object = {}> {
+	// Force a state update
+	_updateState(): Promise<void>;
+}
+
+/**
+ * Base class for building blocks.
+ * This contains the low level functionality of having a content aggregation and handling the rendering of the content without an actual DOM element.
+ * The building block also defines a state object that can be used to store the state of the building block.
+ * Accessibility and classes information are forwarded to the content control.
+ * @experimental
+ * @public
+ */
+@defineUI5Class("sap.fe.base.BuildingBlockBase")
+class BuildingBlockBase<T extends UI5Element = Control, K extends object = {}> extends Control {
+	@aggregation({ type: "sap.ui.core.Element", multiple: false, isDefault: true })
+	content?: T;
+
+	/**
+	 * Association to controls / IDs that label this control (see WAI-ARIA attribute aria-labelledby).
+	 */
+	@association({ type: "sap.ui.core.Control", multiple: true, singularName: "ariaLabelledBy" })
+	ariaLabelledBy!: string[];
+
+	@defineState()
+	protected state: StateOf<K> = {} as StateOf<K>;
+
+	constructor(settings?: string | PropertiesOf<BuildingBlockBase<T>>, others?: PropertiesOf<BuildingBlockBase<T>>) {
+		if (typeof settings === "string") {
+			others ??= {};
+			others.id = settings;
+		}
+		super(settings as unknown as string, others);
+	}
+
+	private _oldDomRef: WeakRef<Element> | null = null;
+
+	static render<T extends Control>(oRm: RenderManager, oControl: BuildingBlockBase<T>): void {
+		if (!oControl.content || oControl.getVisible() === false) {
+			InvisibleRenderer.render(oRm, oControl);
+		} else {
+			oRm.renderControl(oControl.content);
+		}
+	}
+
+	/**
+	 * Override the bindProperty to deal with the case where the property is a binding info.
+	 * @param name The name of te property
+	 * @param bindingInfo The binding info
+	 * @returns The instance of the building block for chaining
+	 */
+	override bindProperty(name: string, bindingInfo: PropertyBindingInfo): this {
+		const propertyMetadata = this.getMetadata().getProperty(name);
+		if (propertyMetadata?.bindable === false && propertyMetadata.group === "Data") {
+			(this as Record<string, unknown>)[name] = bindingInfo;
+		} else {
+			super.bindProperty(name, bindingInfo);
+		}
+		return this;
+	}
+
+	//set the old dom ref
+	override onAfterRendering(event: JQuery.Event): void {
+		const domRef = this.getDomRef();
+		if (domRef) {
+			this._oldDomRef = new WeakRef(domRef);
+		} else {
+			this._oldDomRef = null;
+		}
+		super.onAfterRendering(event);
+	}
+
+	override getDomRef(): Element | null {
+		const oContent = this.content;
+		let domRef: Element | null = oContent?.getDomRef() ?? super.getDomRef();
+		if (!domRef) {
+			domRef = this._oldDomRef?.deref() ?? null;
+			if (domRef) {
+				return document.getElementById(domRef.id);
+			}
+		}
+		return domRef;
+	}
+
+	override getFocusDomRef(): Element | null {
+		const oContent = this.content;
+		return oContent ? oContent.getFocusDomRef() : super.getFocusDomRef();
+	}
+
+	/**
+	 * This function asks up the control tree to enhance the accessibility state of the control.
+	 * @param _oElement The element to enhance
+	 * @param mAriaProps The current aria properties
+	 * @returns The enhanced aria properties
+	 */
+	override enhanceAccessibilityState(_oElement: object, mAriaProps: object): object {
+		const oParent = this.getParent();
+
+		if (oParent && (oParent as ManagedObject & { enhanceAccessibilityState?: Function }).enhanceAccessibilityState) {
+			// forward  enhanceAccessibilityState call to the parent
+			(oParent as ManagedObject & { enhanceAccessibilityState: Function }).enhanceAccessibilityState(_oElement, mAriaProps);
+		}
+
+		return mAriaProps;
+	}
+
+	/**
+	 * This function (if available on the concrete control) provides the current accessibility state of the control.
+	 * @returns The accessibility information for the control.
+	 */
+	override getAccessibilityInfo(): Object {
+		let accessibilityInfo = {};
+		if (this.content?.isA<Control>("sap.ui.core.Control")) {
+			accessibilityInfo = this.content.getAccessibilityInfo();
+		}
+		return accessibilityInfo;
+	}
+
+	/**
+	 * Returns the DOMNode ID to be used for the "labelFor" attribute.
+	 *
+	 * We forward the call of this method to the content control.
+	 * @returns ID to be used for the <code>labelFor</code>
+	 */
+	override getIdForLabel(): string {
+		if (this.content?.isA<Control>("sap.ui.core.Control")) {
+			return this.content.getIdForLabel();
+		}
+		return "";
+	}
+
+	override addStyleClass(styleClass: string): this {
+		(this.content as unknown as Control)?.addStyleClass(styleClass);
+		super.addStyleClass(styleClass);
+		return this;
+	}
+
+	override removeStyleClass(styleClass: string): this {
+		(this.content as unknown as Control)?.removeStyleClass(styleClass);
+		super.removeStyleClass(styleClass);
+		return this;
+	}
+
+	/**
+	 * Shorthand for the BindingToolkit.bindState function with the current state object.
+	 * @param path A property in the state object
+	 * @returns The binding toolkit expression for the state
+	 */
+	protected bindState(path: keyof K): PathInModelExpression<PrimitiveType> | ConstantExpression<PrimitiveType> {
+		return BindingToolkit.bindState(this.state as K, path);
+	}
+}
+
+export default BuildingBlockBase;