@ui5/webcomponents-base 0.0.0-b0b835975 → 0.0.0-b3a4f8020

package/dist/UI5Element.js

@@ -1,26 +1,58 @@
+// eslint-disable-next-line import/no-extraneous-dependencies
+import "@ui5/webcomponents-base/dist/ssr-dom.js";
 import merge from "./thirdparty/merge.js";
 import { boot } from "./Boot.js";
 import UI5ElementMetadata from "./UI5ElementMetadata.js";
 import EventProvider from "./EventProvider.js";
-import getSingletonElementInstance from "./util/getSingletonElementInstance.js";
-import StaticAreaItem from "./StaticAreaItem.js";
 import updateShadowRoot from "./updateShadowRoot.js";
 import { shouldIgnoreCustomElement } from "./IgnoreCustomElements.js";
-import { renderDeferred, renderImmediately, cancelRender } from "./Render.js";
+import { renderDeferred, renderImmediately, cancelRender, } from "./Render.js";
 import { registerTag, isTagRegistered, recordTagRegistrationFailure } from "./CustomElementsRegistry.js";
 import { observeDOMNode, unobserveDOMNode } from "./DOMObserver.js";
 import { skipOriginalEvent } from "./config/NoConflict.js";
 import getEffectiveDir from "./locale/getEffectiveDir.js";
-import { kebabToCamelCase, camelToKebabCase } from "./util/StringHelper.js";
+import { kebabToCamelCase, camelToKebabCase, kebabToPascalCase } from "./util/StringHelper.js";
 import isValidPropertyName from "./util/isValidPropertyName.js";
 import { getSlotName, getSlottedNodesList } from "./util/SlotsHelper.js";
 import arraysAreEqual from "./util/arraysAreEqual.js";
 import { markAsRtlAware } from "./locale/RTLAwareRegistry.js";
-import preloadLinks from "./theming/preloadLinks.js";
 import executeTemplate from "./renderer/executeTemplate.js";
+import { shouldScopeCustomElement } from "./CustomElementsScopeUtils.js";
+import { updateFormValue, setFormValue } from "./features/InputElementsFormSupport.js";
+import { getI18nBundle } from "./i18nBundle.js";
+import { fetchCldr } from "./asset-registries/LocaleData.js";
+import getLocale from "./locale/getLocale.js";
+import { getLanguageChangePending } from "./config/Language.js";
+import createInstanceChecker from "./util/createInstanceChecker.js";
+const DEV_MODE = true;
 let autoId = 0;
 const elementTimeouts = new Map();
 const uniqueDependenciesCache = new Map();
+const defaultConverter = {
+    fromAttribute(value, type) {
+        if (type === Boolean) {
+            return value !== null;
+        }
+        if (type === Number) {
+            return value === null ? undefined : parseFloat(value);
+        }
+        return value;
+    },
+    toAttribute(value, type) {
+        if (type === Boolean) {
+            return value ? "" : null;
+        }
+        // don't set attributes for arrays and objects
+        if (type === Object || type === Array) {
+            return null;
+        }
+        // object, array, other
+        if (value === null || value === undefined) {
+            return null;
+        }
+        return String(value);
+    },
+};
 /**
  * Triggers re-rendering of a UI5Element instance due to state change.
  * @param {ChangeInfo} changeInfo An object with information about the change that caused invalidation.
@@ -32,25 +64,50 @@ function _invalidate(changeInfo) {
     if (this._suppressInvalidation) {
         return;
     }
+    const ctor = this.constructor;
+    // Skip re-rendering of language-aware components while language-specific data (e.g., CLDR, language bundles) is still loading.
+    // Once all necessary language data has been loaded, the language change
+    // will trigger a re-render of all language-aware components.
+    if (ctor.getMetadata().isLanguageAware() && getLanguageChangePending()) {
+        return;
+    }
     // Call the onInvalidation hook
     this.onInvalidation(changeInfo);
     this._changedState.push(changeInfo);
     renderDeferred(this);
-    this._eventProvider.fireEvent("invalidate", { ...changeInfo, target: this });
+    this._invalidationEventProvider.fireEvent("invalidate", { ...changeInfo, target: this });
+}
+/**
+ * looks up a property descsriptor including in the prototype chain
+ * @param proto the starting prototype
+ * @param name the property to look for
+ * @returns the property descriptor if found directly or in the prototype chaing, undefined if not found
+ */
+function getPropertyDescriptor(proto, name) {
+    do {
+        const descriptor = Object.getOwnPropertyDescriptor(proto, name);
+        if (descriptor) {
+            return descriptor;
+        }
+        // go up the prototype chain
+        proto = Object.getPrototypeOf(proto);
+    } while (proto && proto !== HTMLElement.prototype);
 }
 /**
+ * @class
  * Base class for all UI5 Web Components
  *
- * @class
- * @constructor
- * @author SAP SE
- * @alias sap.ui.webc.base.UI5Element
  * @extends HTMLElement
  * @public
  */
 class UI5Element extends HTMLElement {
     constructor() {
         super();
+        this.__shouldHydrate = false;
+        // used to differentiate whether a setter is called from the constructor (from an initializer) or later
+        // setters from the constructor should not set attributes, this is delegated after the first rendering but is async
+        // setters after the constructor can set attributes synchronously for more convinient development
+        this._rendered = false;
         const ctor = this.constructor;
         this._changedState = []; // Filled on each invalidation, cleared on re-render (used for debugging)
         this._suppressInvalidation = true; // A flag telling whether all invalidations should be ignored. Initialized with "true" because a UI5Element can not be invalidated until it is rendered for the first time
@@ -58,23 +115,57 @@ class UI5Element extends HTMLElement {
         this._fullyConnected = false; // A flag telling whether the UI5Element's onEnterDOM hook was called (since it's possible to have the element removed from DOM before that)
         this._childChangeListeners = new Map(); // used to store lazy listeners per slot for the child change event of every child inside that slot
         this._slotChangeListeners = new Map(); // used to store lazy listeners per slot for the slotchange event of all slot children inside that slot
-        this._eventProvider = new EventProvider(); // used by parent components for listening to changes to child components
+        this._invalidationEventProvider = new EventProvider(); // used by parent components for listening to changes to child components
+        this._componentStateFinalizedEventProvider = new EventProvider(); // used by friend classes for synchronization
         let deferredResolve;
         this._domRefReadyPromise = new Promise(resolve => {
             deferredResolve = resolve;
         });
         this._domRefReadyPromise._deferredResolve = deferredResolve;
         this._doNotSyncAttributes = new Set(); // attributes that are excluded from attributeChangedCallback synchronization
+        this._slotsAssignedNodes = new WeakMap(); // map of all nodes, slotted (directly or transitively) per component slot
         this._state = { ...ctor.getMetadata().getInitialState() };
-        this._upgradeAllProperties();
+        // save properties set before element is upgraded, as they will be overriden by the field initializers in the constructor
+        this.initializedProperties = new Map();
+        const allProps = this.constructor.getMetadata().getPropertiesList();
+        allProps.forEach(propertyName => {
+            if (this.hasOwnProperty(propertyName)) { // eslint-disable-line
+                const value = this[propertyName];
+                this.initializedProperties.set(propertyName, value);
+            }
+        });
+        this._internals = this.attachInternals();
+        this._initShadowRoot();
+    }
+    _initShadowRoot() {
+        const ctor = this.constructor;
         if (ctor._needsShadowDOM()) {
-            this.attachShadow({ mode: "open" });
+            const defaultOptions = { mode: "open" };
+            if (!this.shadowRoot) {
+                this.attachShadow({ ...defaultOptions, ...ctor.getMetadata().getShadowRootOptions() });
+            }
+            else {
+                // The shadow root is initially rendered. This applies to case where the component's template
+                // is inserted into the DOM declaratively using a <template> tag.
+                this.__shouldHydrate = true;
+            }
+            const slotsAreManaged = ctor.getMetadata().slotsAreManaged();
+            if (slotsAreManaged) {
+                this.shadowRoot.addEventListener("slotchange", this._onShadowRootSlotChange.bind(this));
+            }
         }
     }
     /**
-     * Returns a unique ID for this UI5 Element
-     *
-     * @deprecated - This property is not guaranteed in future releases
+     * Note: this "slotchange" listener is for slots, rendered in the component's shadow root
+     */
+    _onShadowRootSlotChange(e) {
+        const targetShadowRoot = e.target?.getRootNode(); // the "slotchange" event target is always a slot element
+        if (targetShadowRoot === this.shadowRoot) { // only for slotchange events that originate from slots, belonging to the component's shadow root
+            this._processChildren();
+        }
+    }
+    /**
+     * Returns a unique ID for this UI5 Element.
      * @protected
      */
     get _id() {
@@ -87,18 +178,24 @@ class UI5Element extends HTMLElement {
         const template = this.constructor.template;
         return executeTemplate(template, this);
     }
-    renderStatic() {
-        const template = this.constructor.staticAreaTemplate;
-        return executeTemplate(template, this);
-    }
     /**
      * Do not call this method from derivatives of UI5Element, use "onEnterDOM" only
      * @private
      */
     async connectedCallback() {
+        if (DEV_MODE) {
+            const props = this.constructor.getMetadata().getProperties();
+            for (const [prop, propData] of Object.entries(props)) { // eslint-disable-line
+                if (Object.hasOwn(this, prop) && !this.initializedProperties.has(prop)) {
+                    // initialized properties should not trigger this error as they will be reassigned, only property initializers will trigger this in case unsupported TS mode
+                    // eslint-disable-next-line no-console
+                    console.error(`[UI5-FWK] ${this.constructor.getMetadata().getTag()} has a property [${prop}] that is shadowed by the instance. Updates to this property will not invalidate the component. Possible reason is TS target ES2022 or TS useDefineForClassFields`);
+                }
+            }
+        }
         const ctor = this.constructor;
         this.setAttribute(ctor.getMetadata().getPureTag(), "");
-        if (ctor.getMetadata().supportsF6FastNavigation()) {
+        if (ctor.getMetadata().supportsF6FastNavigation() && !this.hasAttribute("data-sap-ui-fastnavgroup")) {
             this.setAttribute("data-sap-ui-fastnavgroup", "true");
         }
         const slotsAreManaged = ctor.getMetadata().slotsAreManaged();
@@ -108,6 +205,9 @@ class UI5Element extends HTMLElement {
             this._startObservingDOMChildren();
             await this._processChildren();
         }
+        if (!ctor.asyncFinished) {
+            await ctor._definePromise;
+        }
         if (!this._inDOM) { // Component removed from DOM while _processChildren was running
             return;
         }
@@ -116,6 +216,13 @@ class UI5Element extends HTMLElement {
         this._fullyConnected = true;
         this.onEnterDOM();
     }
+    get definePromise() {
+        const ctor = this.constructor;
+        if (!ctor.asyncFinished && ctor._definePromise) {
+            return ctor._definePromise;
+        }
+        return Promise.resolve();
+    }
     /**
      * Do not call this method from derivatives of UI5Element, use "onExitDOM" only
      * @private
@@ -131,9 +238,7 @@ class UI5Element extends HTMLElement {
             this.onExitDOM();
             this._fullyConnected = false;
         }
-        if (this.staticAreaItem && this.staticAreaItem.parentElement) {
-            this.staticAreaItem.parentElement.removeChild(this.staticAreaItem);
-        }
+        this._domRefReadyPromise._deferredResolve();
         cancelRender(this);
     }
     /**
@@ -161,11 +266,12 @@ class UI5Element extends HTMLElement {
      */
     _startObservingDOMChildren() {
         const ctor = this.constructor;
-        const shouldObserveChildren = ctor.getMetadata().hasSlots();
+        const metadata = ctor.getMetadata();
+        const shouldObserveChildren = metadata.hasSlots();
         if (!shouldObserveChildren) {
             return;
         }
-        const canSlotText = ctor.getMetadata().canSlotText();
+        const canSlotText = metadata.canSlotText();
         const mutationObserverOptions = {
             childList: true,
             subtree: canSlotText,
@@ -208,7 +314,7 @@ class UI5Element extends HTMLElement {
         }
         const autoIncrementMap = new Map();
         const slottedChildrenMap = new Map();
-        const allChildrenUpgraded = domChildren.map(async (child, idx) => {
+        domChildren.forEach((child, idx) => {
             // Determine the type of the child (mainly by the slot attribute)
             const slotName = getSlotName(child);
             const slotData = slotsMap[slotName];
@@ -220,6 +326,28 @@ class UI5Element extends HTMLElement {
                 }
                 return;
             }
+            const propertyName = slotData.propertyName || slotName;
+            if (slottedChildrenMap.has(propertyName)) {
+                slottedChildrenMap.get(propertyName).push({ child, idx });
+            }
+            else {
+                slottedChildrenMap.set(propertyName, [{ child, idx }]);
+            }
+        });
+        // Distribute the child in the _state object, keeping the Light DOM order,
+        // not the order elements are defined.
+        slottedChildrenMap.forEach((children, propertyName) => {
+            this._state[propertyName] = children.sort((a, b) => a.idx - b.idx).map(_ => _.child);
+            this._state[kebabToCamelCase(propertyName)] = this._state[propertyName];
+        });
+        const allChildrenUpgraded = domChildren.map(async (child) => {
+            // Determine the type of the child (mainly by the slot attribute)
+            const slotName = getSlotName(child);
+            const slotData = slotsMap[slotName];
+            // Check if the slotName is supported
+            if (slotData === undefined) {
+                return;
+            }
             // For children that need individual slots, calculate them
             if (slotData.individualSlots) {
                 const nextIndex = (autoIncrementMap.get(slotName) || 0) + 1;
@@ -231,9 +359,9 @@ class UI5Element extends HTMLElement {
                 const localName = child.localName;
                 const shouldWaitForCustomElement = localName.includes("-") && !shouldIgnoreCustomElement(localName);
                 if (shouldWaitForCustomElement) {
-                    const isDefined = window.customElements.get(localName);
+                    const isDefined = customElements.get(localName);
                     if (!isDefined) {
-                        const whenDefinedPromise = window.customElements.whenDefined(localName); // Class registered, but instances not upgraded yet
+                        const whenDefinedPromise = customElements.whenDefined(localName); // Class registered, but instances not upgraded yet
                         let timeoutPromise = elementTimeouts.get(localName);
                         if (!timeoutPromise) {
                             timeoutPromise = new Promise(resolve => setTimeout(resolve, 1000));
@@ -241,35 +369,21 @@ class UI5Element extends HTMLElement {
                         }
                         await Promise.race([whenDefinedPromise, timeoutPromise]);
                     }
-                    window.customElements.upgrade(child);
+                    customElements.upgrade(child);
                 }
             }
             child = ctor.getMetadata().constructor.validateSlotValue(child, slotData);
             // Listen for any invalidation on the child if invalidateOnChildChange is true or an object (ignore when false or not set)
             if (instanceOfUI5Element(child) && slotData.invalidateOnChildChange) {
                 const childChangeListener = this._getChildChangeListener(slotName);
-                if (childChangeListener) {
-                    child.attachInvalidate.call(child, childChangeListener);
-                }
+                child.attachInvalidate.call(child, childChangeListener);
             }
             // Listen for the slotchange event if the child is a slot itself
             if (child instanceof HTMLSlotElement) {
-                this._attachSlotChange(child, slotName);
-            }
-            const propertyName = slotData.propertyName || slotName;
-            if (slottedChildrenMap.has(propertyName)) {
-                slottedChildrenMap.get(propertyName).push({ child, idx });
-            }
-            else {
-                slottedChildrenMap.set(propertyName, [{ child, idx }]);
+                this._attachSlotChange(child, slotName, !!slotData.invalidateOnChildChange);
             }
         });
         await Promise.all(allChildrenUpgraded);
-        // Distribute the child in the _state object, keeping the Light DOM order,
-        // not the order elements are defined.
-        slottedChildrenMap.forEach((children, propertyName) => {
-            this._state[propertyName] = children.sort((a, b) => a.idx - b.idx).map(_ => _.child);
-        });
         // Compare the content of each slot with the cached values and invalidate for the ones that changed
         let invalidated = false;
         for (const [slotName, slotData] of Object.entries(slotsMap)) { // eslint-disable-line
@@ -281,6 +395,9 @@ class UI5Element extends HTMLElement {
                     reason: "children",
                 });
                 invalidated = true;
+                if (ctor.getMetadata().isFormAssociated()) {
+                    setFormValue(this);
+                }
             }
         }
         // If none of the slots had an invalidation due to changes to immediate children,
@@ -303,39 +420,38 @@ class UI5Element extends HTMLElement {
         children.forEach(child => {
             if (instanceOfUI5Element(child)) {
                 const childChangeListener = this._getChildChangeListener(slotName);
-                if (childChangeListener) {
-                    child.detachInvalidate.call(child, childChangeListener);
-                }
+                child.detachInvalidate.call(child, childChangeListener);
             }
             if (child instanceof HTMLSlotElement) {
                 this._detachSlotChange(child, slotName);
             }
         });
         this._state[propertyName] = [];
+        this._state[kebabToCamelCase(propertyName)] = this._state[propertyName];
     }
     /**
      * Attach a callback that will be executed whenever the component is invalidated
      *
-     * @param {InvalidationInfo} callback
+     * @param callback
      * @public
      */
     attachInvalidate(callback) {
-        this._eventProvider.attachEvent("invalidate", callback);
+        this._invalidationEventProvider.attachEvent("invalidate", callback);
     }
     /**
      * Detach the callback that is executed whenever the component is invalidated
      *
-     * @param {InvalidationInfo} callback
+     * @param callback
      * @public
      */
     detachInvalidate(callback) {
-        this._eventProvider.detachEvent("invalidate", callback);
+        this._invalidationEventProvider.detachEvent("invalidate", callback);
     }
     /**
      * Callback that is executed whenever a monitored child changes its state
      *
-     * @param {sting} slotName the slot in which a child was invalidated
-     * @param { ChangeInfo } childChangeInfo the changeInfo object for the child in the given slot
+     * @param slotName the slot in which a child was invalidated
+     * @param childChangeInfo the changeInfo object for the child in the given slot
      * @private
      */
     _onChildChange(slotName, childChangeInfo) {
@@ -365,23 +481,21 @@ class UI5Element extends HTMLElement {
         const nameInCamelCase = kebabToCamelCase(realName);
         if (properties.hasOwnProperty(nameInCamelCase)) { // eslint-disable-line
             const propData = properties[nameInCamelCase];
-            const propertyType = propData.type;
-            let propertyValidator = propData.validator;
-            if (propertyType && propertyType.isDataTypeClass) {
-                propertyValidator = propertyType;
-            }
-            if (propertyValidator) {
-                newPropertyValue = propertyValidator.attributeToProperty(newValue);
-            }
-            else if (propertyType === Boolean) {
-                newPropertyValue = newValue !== null;
-            }
-            else {
-                newPropertyValue = newValue;
-            }
+            const converter = propData.converter ?? defaultConverter;
+            newPropertyValue = converter.fromAttribute(newValue, propData.type);
             this[nameInCamelCase] = newPropertyValue;
         }
     }
+    formAssociatedCallback() {
+        const ctor = this.constructor;
+        if (!ctor.getMetadata().isFormAssociated()) {
+            return;
+        }
+        updateFormValue(this);
+    }
+    static get formAssociated() {
+        return this.getMetadata().isFormAssociated();
+    }
     /**
      * @private
      */
@@ -392,60 +506,37 @@ class UI5Element extends HTMLElement {
         }
         const properties = ctor.getMetadata().getProperties();
         const propData = properties[name];
-        const propertyType = propData.type;
-        let propertyValidator = propData.validator;
         const attrName = camelToKebabCase(name);
-        const attrValue = this.getAttribute(attrName);
-        if (propertyType && propertyType.isDataTypeClass) {
-            propertyValidator = propertyType;
-        }
-        if (propertyValidator) {
-            const newAttrValue = propertyValidator.propertyToAttribute(newValue);
-            if (newAttrValue === null) { // null means there must be no attribute for the current value of the property
-                this._doNotSyncAttributes.add(attrName); // skip the attributeChangedCallback call for this attribute
-                this.removeAttribute(attrName); // remove the attribute safely (will not trigger synchronization to the property value due to the above line)
-                this._doNotSyncAttributes.delete(attrName); // enable synchronization again for this attribute
+        const converter = propData.converter || defaultConverter;
+        if (DEV_MODE) {
+            const tag = this.constructor.getMetadata().getTag();
+            if (typeof newValue === "boolean" && propData.type !== Boolean) {
+                // eslint-disable-next-line
+                console.error(`[UI5-FWK] boolean value for property [${name}] of component [${tag}] is missing "{ type: Boolean }" in its property decorator. Attribute conversion will treat it as a string. If this is intended, pass the value converted to string, otherwise add the type to the property decorator`);
             }
-            else {
-                this.setAttribute(attrName, newAttrValue);
+            if (typeof newValue === "number" && propData.type !== Number) {
+                // eslint-disable-next-line
+                console.error(`[UI5-FWK] numeric value for property [${name}] of component [${tag}] is missing "{ type: Number }" in its property decorator. Attribute conversion will treat it as a string. If this is intended, pass the value converted to string, otherwise add the type to the property decorator`);
             }
-        }
-        else if (propertyType === Boolean) {
-            if (newValue === true && attrValue === null) {
-                this.setAttribute(attrName, "");
-            }
-            else if (newValue === false && attrValue !== null) {
-                this.removeAttribute(attrName);
+            if (typeof newValue === "string" && propData.type && propData.type !== String) {
+                // eslint-disable-next-line
+                console.error(`[UI5-FWK] string value for property [${name}] of component [${tag}] which has a non-string type [${propData.type}] in its property decorator. Attribute conversion will stop and keep the string value in the property.`);
             }
         }
-        else if (typeof newValue !== "object") {
-            if (attrValue !== newValue) {
-                this.setAttribute(attrName, newValue);
-            }
-        } // else { return; } // old object handling
-    }
-    /**
-     * @private
-     */
-    _upgradeProperty(propertyName) {
-        if (this.hasOwnProperty(propertyName)) { // eslint-disable-line
-            const value = this[propertyName];
-            delete this[propertyName];
-            this[propertyName] = value;
+        const newAttrValue = converter.toAttribute(newValue, propData.type);
+        this._doNotSyncAttributes.add(attrName); // skip the attributeChangedCallback call for this attribute
+        if (newAttrValue === null || newAttrValue === undefined) { // null means there must be no attribute for the current value of the property
+            this.removeAttribute(attrName); // remove the attribute safely (will not trigger synchronization to the property value due to the above line)
         }
-    }
-    /**
-     * @private
-     */
-    _upgradeAllProperties() {
-        const allProps = this.constructor.getMetadata().getPropertiesList();
-        allProps.forEach(this._upgradeProperty.bind(this));
+        else {
+            this.setAttribute(attrName, newAttrValue); // setting attributes from properties should not trigger the property setter again
+        }
+        this._doNotSyncAttributes.delete(attrName); // enable synchronization again for this attribute
     }
     /**
      * Returns a singleton event listener for the "change" event of a child in a given slot
      *
      * @param slotName the name of the slot, where the child is
-     * @returns {ChildChangeListener}
      * @private
      */
     _getChildChangeListener(slotName) {
@@ -458,7 +549,6 @@ class UI5Element extends HTMLElement {
      * Returns a singleton slotchange event listener that invalidates the component due to changes in the given slot
      *
      * @param slotName the name of the slot, where the slot element (whose slotchange event we're listening to) is
-     * @returns {SlotChangeListener}
      * @private
      */
     _getSlotChangeListener(slotName) {
@@ -470,11 +560,32 @@ class UI5Element extends HTMLElement {
     /**
      * @private
      */
-    _attachSlotChange(child, slotName) {
+    _attachSlotChange(slot, slotName, invalidateOnChildChange) {
         const slotChangeListener = this._getSlotChangeListener(slotName);
-        if (slotChangeListener) {
-            child.addEventListener("slotchange", slotChangeListener);
-        }
+        slot.addEventListener("slotchange", (e) => {
+            slotChangeListener.call(slot, e);
+            if (invalidateOnChildChange) {
+                // Detach listeners for UI5 Elements that used to be in this slot
+                const previousChildren = this._slotsAssignedNodes.get(slot);
+                if (previousChildren) {
+                    previousChildren.forEach(child => {
+                        if (instanceOfUI5Element(child)) {
+                            const childChangeListener = this._getChildChangeListener(slotName);
+                            child.detachInvalidate.call(child, childChangeListener);
+                        }
+                    });
+                }
+                // Attach listeners for UI5 Elements that are now in this slot
+                const newChildren = getSlottedNodesList([slot]);
+                this._slotsAssignedNodes.set(slot, newChildren);
+                newChildren.forEach(child => {
+                    if (instanceOfUI5Element(child)) {
+                        const childChangeListener = this._getChildChangeListener(slotName);
+                        child.attachInvalidate.call(child, childChangeListener);
+                    }
+                });
+            }
+        });
     }
     /**
      * @private
@@ -484,6 +595,7 @@ class UI5Element extends HTMLElement {
     }
     /**
      * Whenever a slot element is slotted inside a UI5 Web Component, its slotchange event invalidates the component
+     * Note: this "slotchange" listener is for slots that are children of the component (in the light dom, as opposed to slots rendered by the component in the shadow root)
      *
      * @param slotName the name of the slot, where the slot element (whose slotchange event we're listening to) is
      * @private
@@ -510,9 +622,9 @@ class UI5Element extends HTMLElement {
      *   1) children: immediate children (HTML elements or text nodes) were added, removed or reordered in the slot
      *   2) textcontent: text nodes in the slot changed value (or nested text nodes were added or changed value). Can only trigger for slots of "type: Node"
      *   3) slotchange: a slot element, slotted inside that slot had its "slotchange" event listener called. This practically means that transitively slotted children changed.
-     *      Can only trigger if the child of a slot is a slot element itself.
+     *	  Can only trigger if the child of a slot is a slot element itself.
      *   4) childchange: indicates that a UI5Element child in that slot was invalidated and in turn invalidated the component.
-     *      Can only trigger for slots with "invalidateOnChildChange" metadata descriptor
+     *	  Can only trigger for slots with "invalidateOnChildChange" metadata descriptor
      *
      *  - newValue: the new value of the property (for type="property" only)
      *
@@ -523,6 +635,13 @@ class UI5Element extends HTMLElement {
      * @public
      */
     onInvalidation(changeInfo) { } // eslint-disable-line
+    updateAttributes() {
+        const ctor = this.constructor;
+        const props = ctor.getMetadata().getProperties();
+        for (const [prop, propData] of Object.entries(props)) { // eslint-disable-line
+            this._updateAttribute(prop, this[prop]);
+        }
+    }
     /**
      * Do not call this method directly, only intended to be called by js
      * @protected
@@ -530,15 +649,29 @@ class UI5Element extends HTMLElement {
     _render() {
         const ctor = this.constructor;
         const hasIndividualSlots = ctor.getMetadata().hasIndividualSlots();
+        // restore properties that were initialized before `define` by calling the setter
+        if (this.initializedProperties.size > 0) {
+            Array.from(this.initializedProperties.entries()).forEach(([prop, value]) => {
+                delete this[prop];
+                this[prop] = value;
+            });
+            this.initializedProperties.clear();
+        }
         // suppress invalidation to prevent state changes scheduling another rendering
         this._suppressInvalidation = true;
-        this.onBeforeRendering();
-        // Intended for framework usage only. Currently ItemNavigation updates tab indexes after the component has updated its state but before the template is rendered
-        if (this._onComponentStateFinalized) {
-            this._onComponentStateFinalized();
+        try {
+            this.onBeforeRendering();
+            if (!this._rendered) {
+                // first time rendering, previous setters might have been initializers from the constructor - update attributes here
+                this.updateAttributes();
+            }
+            // Intended for framework usage only. Currently ItemNavigation updates tab indexes after the component has updated its state but before the template is rendered
+            this._componentStateFinalizedEventProvider.fireEvent("componentStateFinalized");
+        }
+        finally {
+            // always resume normal invalidation handling
+            this._suppressInvalidation = false;
         }
-        // resume normal invalidation handling
-        this._suppressInvalidation = false;
         // Update the shadow root with the render result
         /*
         if (this._changedState.length) {
@@ -561,13 +694,11 @@ class UI5Element extends HTMLElement {
         }
         */
         this._changedState = [];
-        // Update shadow root and static area item
+        // Update shadow root
         if (ctor._needsShadowDOM()) {
             updateShadowRoot(this);
         }
-        if (this.staticAreaItem) {
-            this.staticAreaItem.update();
-        }
+        this._rendered = true;
         // Safari requires that children get the slot attribute only after the slot tags have been rendered in the shadow DOM
         if (hasIndividualSlots) {
             this._assignIndividualSlotsToChildren();
@@ -607,11 +738,7 @@ class UI5Element extends HTMLElement {
         if (!this.shadowRoot || this.shadowRoot.children.length === 0) {
             return;
         }
-        const children = [...this.shadowRoot.children].filter(child => !["link", "style"].includes(child.localName));
-        if (children.length !== 1) {
-            console.warn(`The shadow DOM for ${this.constructor.getMetadata().getTag()} does not have a top level element, the getDomRef() method might not work as expected`); // eslint-disable-line
-        }
-        return children[0];
+        return this.shadowRoot.children[0];
     }
     /**
      * Returns the DOM Element marked with "data-sap-focus-ref" inside the template.
@@ -636,13 +763,16 @@ class UI5Element extends HTMLElement {
     }
     /**
      * Set the focus to the element, returned by "getFocusDomRef()" (marked by "data-sap-focus-ref")
-     * @param {FocusOptions} focusOptions additional options for the focus
+     * @param focusOptions additional options for the focus
      * @public
      */
     async focus(focusOptions) {
         await this._waitForDomRef();
         const focusDomRef = this.getFocusDomRef();
-        if (focusDomRef && typeof focusDomRef.focus === "function") {
+        if (focusDomRef === this || !this.isConnected) {
+            HTMLElement.prototype.focus.call(this, focusOptions);
+        }
+        else if (focusDomRef && typeof focusDomRef.focus === "function") {
             focusDomRef.focus(focusOptions);
         }
     }
@@ -653,13 +783,40 @@ class UI5Element extends HTMLElement {
      * @param data - additional data for the event
      * @param cancelable - true, if the user can call preventDefault on the event object
      * @param bubbles - true, if the event bubbles
-     * @returns {boolean} false, if the event was cancelled (preventDefault called), true otherwise
+     * @returns false, if the event was cancelled (preventDefault called), true otherwise
+     * @deprecated use fireDecoratorEvent instead
      */
     fireEvent(name, data, cancelable = false, bubbles = true) {
         const eventResult = this._fireEvent(name, data, cancelable, bubbles);
-        const camelCaseEventName = kebabToCamelCase(name);
-        if (camelCaseEventName !== name) {
-            return eventResult && this._fireEvent(camelCaseEventName, data, cancelable);
+        const pascalCaseEventName = kebabToPascalCase(name);
+        // pascal events are more convinient for native react usage
+        // live-change:
+        //	 Before: onlive-change
+        //	 After: onLiveChange
+        if (pascalCaseEventName !== name) {
+            return eventResult && this._fireEvent(pascalCaseEventName, data, cancelable, bubbles);
+        }
+        return eventResult;
+    }
+    /**
+     * Fires a custom event, configured via the "event" decorator.
+     * @public
+     * @param name - name of the event
+     * @param data - additional data for the event
+     * @returns false, if the event was cancelled (preventDefault called), true otherwise
+     */
+    fireDecoratorEvent(name, data) {
+        const eventData = this.getEventData(name);
+        const cancellable = eventData ? eventData.cancelable : false;
+        const bubbles = eventData ? eventData.bubbles : false;
+        const eventResult = this._fireEvent(name, data, cancellable, bubbles);
+        const pascalCaseEventName = kebabToPascalCase(name);
+        // pascal events are more convinient for native react usage
+        // live-change:
+        //	 Before: onlive-change
+        //	 After: onLiveChange
+        if (pascalCaseEventName !== name) {
+            return eventResult && this._fireEvent(pascalCaseEventName, data, cancellable, bubbles);
         }
         return eventResult;
     }
@@ -686,6 +843,11 @@ class UI5Element extends HTMLElement {
         // Return false if any of the two events was prevented (its result was false).
         return normalEventResult && noConflictEventResult;
     }
+    getEventData(name) {
+        const ctor = this.constructor;
+        const eventMap = ctor.getMetadata().getEvents();
+        return eventMap[name];
+    }
     /**
      * Returns the actual children, associated with a slot.
      * Useful when there are transitive slots in nested component scenarios and you don't want to get a list of the slots, but rather of their content.
@@ -694,12 +856,30 @@ class UI5Element extends HTMLElement {
     getSlottedNodes(slotName) {
         return getSlottedNodesList(this[slotName]);
     }
+    /**
+     * Attach a callback that will be executed whenever the component's state is finalized
+     *
+     * @param callback
+     * @public
+     */
+    attachComponentStateFinalized(callback) {
+        this._componentStateFinalizedEventProvider.attachEvent("componentStateFinalized", callback);
+    }
+    /**
+     * Detach the callback that is executed whenever the component's state is finalized
+     *
+     * @param callback
+     * @public
+     */
+    detachComponentStateFinalized(callback) {
+        this._componentStateFinalizedEventProvider.detachEvent("componentStateFinalized", callback);
+    }
     /**
      * Determines whether the component should be rendered in RTL mode or not.
      * Returns: "rtl", "ltr" or undefined
      *
      * @public
-     * @returns {String|undefined}
+     * @default undefined
      */
     get effectiveDir() {
         markAsRtlAware(this.constructor); // if a UI5 Element calls this method, it's considered to be rtl-aware
@@ -707,49 +887,61 @@ class UI5Element extends HTMLElement {
     }
     /**
      * Used to duck-type UI5 elements without using instanceof
-     * @returns {boolean}
      * @public
+     * @default true
      */
     get isUI5Element() {
         return true;
     }
+    get isUI5AbstractElement() {
+        return !this.constructor._needsShadowDOM();
+    }
     get classes() {
         return {};
     }
     /**
-     * Do not override this method in derivatives of UI5Element, use metadata properties instead
+     * Provides the accessibility information for the component.
+     *
+     * **Note:** The default implementation returns `undefined`, indicating that
+     * the component does not provide any accessibility metadata by default. In such cases,
+     * consumers of this API may apply their own fallback if needed.
+     *
+     * Subclasses overriding this getter must return an object of type `AccessibilityInfo`
+     * describing the component's accessible name, role, description, and other relevant properties.
+     *
+     * If the component is intentionally decorative and should be ignored by assistive
+     * technologies, return an empty object `{}`.
+     *
      * @private
      */
-    static get observedAttributes() {
-        return this.getMetadata().getAttributesList();
+    get accessibilityInfo() {
+        return undefined;
     }
     /**
+     * Do not override this method in derivatives of UI5Element, use metadata properties instead
      * @private
      */
-    static _needsShadowDOM() {
-        return !!this.template || Object.prototype.hasOwnProperty.call(this.prototype, "render");
+    static get observedAttributes() {
+        return this.getMetadata().getAttributesList();
     }
     /**
+     * Returns all tags, used inside component's template subject to scoping.
+     * returns {Array[]} // TODO add @
      * @private
      */
-    static _needsStaticArea() {
-        return !!this.staticAreaTemplate || Object.prototype.hasOwnProperty.call(this.prototype, "renderStatic");
+    static get tagsToScope() {
+        const componentTag = this.getMetadata().getPureTag();
+        const tagsToScope = this.getUniqueDependencies().map((dep) => dep.getMetadata().getPureTag()).filter(shouldScopeCustomElement);
+        if (shouldScopeCustomElement(componentTag)) {
+            tagsToScope.push(componentTag);
+        }
+        return tagsToScope;
     }
     /**
-     * @public
+     * @private
      */
-    getStaticAreaItemDomRef() {
-        if (!this.constructor._needsStaticArea()) {
-            throw new Error("This component does not use the static area");
-        }
-        if (!this.staticAreaItem) {
-            this.staticAreaItem = StaticAreaItem.createInstance();
-            this.staticAreaItem.setOwnerElement(this);
-        }
-        if (!this.staticAreaItem.parentElement) {
-            getSingletonElementInstance("ui5-static-area").appendChild(this.staticAreaItem);
-        }
-        return this.staticAreaItem.getDomRef();
+    static _needsShadowDOM() {
+        return !!this.template || Object.prototype.hasOwnProperty.call(this.prototype, "render");
     }
     /**
      * @private
@@ -763,66 +955,56 @@ class UI5Element extends HTMLElement {
             if (!isValidPropertyName(prop)) {
                 console.warn(`"${prop}" is not a valid property name. Use a name that does not collide with DOM APIs`); /* eslint-disable-line */
             }
-            if (propData.type === Boolean && propData.defaultValue) {
-                throw new Error(`Cannot set a default value for property "${prop}". All booleans are false by default.`);
-            }
-            if (propData.type === Array) {
-                throw new Error(`Wrong type for property "${prop}". Properties cannot be of type Array - use "multiple: true" and set "type" to the single value type, such as "String", "Object", etc...`);
-            }
-            if (propData.type === Object && propData.defaultValue) {
-                throw new Error(`Cannot set a default value for property "${prop}". All properties of type "Object" are empty objects by default.`);
+            const descriptor = getPropertyDescriptor(proto, prop);
+            // if the decorator is on a setter, proxy the new setter to it
+            let origSet;
+            if (descriptor?.set) {
+                // eslint-disable-next-line @typescript-eslint/unbound-method
+                origSet = descriptor.set;
             }
-            if (propData.multiple && propData.defaultValue) {
-                throw new Error(`Cannot set a default value for property "${prop}". All multiple properties are empty arrays by default.`);
+            // if the decorator is on a setter, there will be a corresponding getter - proxy the new getter to it
+            let origGet;
+            if (descriptor?.get) {
+                // eslint-disable-next-line @typescript-eslint/unbound-method
+                origGet = descriptor.get;
             }
             Object.defineProperty(proto, prop, {
                 get() {
-                    if (this._state[prop] !== undefined) {
-                        return this._state[prop];
-                    }
-                    const propDefaultValue = propData.defaultValue;
-                    if (propData.type === Boolean) {
-                        return false;
-                    }
-                    else if (propData.type === String) { // eslint-disable-line
-                        return propDefaultValue;
-                    }
-                    else if (propData.multiple) { // eslint-disable-line
-                        return [];
-                    }
-                    else {
-                        return propDefaultValue;
+                    // proxy the getter to the original accessor if there was one
+                    if (origGet) {
+                        return origGet.call(this);
                     }
+                    return this._state[prop];
                 },
                 set(value) {
-                    let isDifferent;
                     const ctor = this.constructor;
-                    const metadataCtor = ctor.getMetadata().constructor;
-                    value = metadataCtor.validatePropertyValue(value, propData);
-                    const propertyType = propData.type;
-                    let propertyValidator = propData.validator;
-                    const oldState = this._state[prop];
-                    if (propertyType && propertyType.isDataTypeClass) {
-                        propertyValidator = propertyType;
-                    }
-                    if (propertyValidator) {
-                        isDifferent = !propertyValidator.valuesAreEqual(oldState, value);
-                    }
-                    else if (Array.isArray(oldState) && Array.isArray(value) && propData.multiple && propData.compareValues) { // compareValues is added for IE, test if needed now
-                        isDifferent = !arraysAreEqual(oldState, value);
-                    }
-                    else {
-                        isDifferent = oldState !== value;
-                    }
+                    const oldState = origGet ? origGet.call(this) : this._state[prop];
+                    const isDifferent = oldState !== value;
                     if (isDifferent) {
-                        this._state[prop] = value;
+                        // if the decorator is on a setter, use it for storage
+                        if (origSet) {
+                            origSet.call(this, value);
+                        }
+                        else {
+                            this._state[prop] = value;
+                        }
                         _invalidate.call(this, {
                             type: "property",
                             name: prop,
                             newValue: value,
                             oldValue: oldState,
                         });
-                        this._updateAttribute(prop, value);
+                        if (this._rendered) {
+                            // the component is already rendered, indicating it is not the constructor -
+                            // therefore the attribute can be set synchronously.
+                            // get the effective value of the property,
+                            // as it might differ from the provided value
+                            const newValue = origGet ? origGet.call(this) : this._state[prop];
+                            this._updateAttribute(prop, newValue);
+                        }
+                        if (ctor.getMetadata().isFormAssociated()) {
+                            setFormValue(this);
+                        }
                     }
                 },
             });
@@ -835,7 +1017,7 @@ class UI5Element extends HTMLElement {
                     console.warn(`"${slotName}" is not a valid property name. Use a name that does not collide with DOM APIs`); /* eslint-disable-line */
                 }
                 const propertyName = slotData.propertyName || slotName;
-                Object.defineProperty(proto, propertyName, {
+                const propertyDescriptor = {
                     get() {
                         if (this._state[propertyName] !== undefined) {
                             return this._state[propertyName];
@@ -845,34 +1027,29 @@ class UI5Element extends HTMLElement {
                     set() {
                         throw new Error("Cannot set slot content directly, use the DOM APIs (appendChild, removeChild, etc...)");
                     },
-                });
+                };
+                Object.defineProperty(proto, propertyName, propertyDescriptor);
+                if (propertyName !== kebabToCamelCase(propertyName)) {
+                    Object.defineProperty(proto, kebabToCamelCase(propertyName), propertyDescriptor);
+                }
             }
         }
     }
-    /**
-     * Returns the CSS for this UI5 Web Component Class
-     * @protected
-     */
-    static get styles() {
-        return "";
-    }
-    /**
-     * Returns the Static Area CSS for this UI5 Web Component Class
-     * @protected
-     */
-    static get staticAreaStyles() {
-        return "";
-    }
     /**
      * Returns an array with the dependencies for this UI5 Web Component, which could be:
-     *  - composed components (used in its shadow root or static area item)
+     *  - composed components (used in its shadow root)
      *  - slotted components that the component may need to communicate with
      *
+     * @deprecated no longer necessary for jsxRenderer-enabled components
      * @protected
      */
     static get dependencies() {
         return [];
     }
+    static cacheUniqueDependencies() {
+        const filtered = this.dependencies.filter((dep, index, deps) => deps.indexOf(dep) === index);
+        uniqueDependenciesCache.set(this, filtered);
+    }
     /**
      * Returns a list of the unique dependencies for this UI5 Web Component
      *
@@ -880,39 +1057,54 @@ class UI5Element extends HTMLElement {
      */
     static getUniqueDependencies() {
         if (!uniqueDependenciesCache.has(this)) {
-            const filtered = this.dependencies.filter((dep, index, deps) => deps.indexOf(dep) === index);
-            uniqueDependenciesCache.set(this, filtered);
+            this.cacheUniqueDependencies();
         }
         return uniqueDependenciesCache.get(this) || [];
     }
-    /**
-     * Returns a promise that resolves whenever all dependencies for this UI5 Web Component have resolved
-     *
-     * @returns {Promise}
-     */
-    static whenDependenciesDefined() {
-        return Promise.all(this.getUniqueDependencies().map(dep => dep.define()));
-    }
     /**
      * Hook that will be called upon custom element definition
      *
      * @protected
-     * @returns {Promise<void>}
+     * @deprecated use the "i18n" decorator for fetching message bundles and the "cldr" option in the "customElements" decorator for fetching CLDR
      */
     static async onDefine() {
         return Promise.resolve();
     }
+    static fetchI18nBundles() {
+        return Promise.all(Object.entries(this.getMetadata().getI18n()).map(pair => {
+            const { bundleName } = pair[1];
+            return getI18nBundle(bundleName);
+        }));
+    }
+    static fetchCLDR() {
+        if (this.getMetadata().needsCLDR()) {
+            return fetchCldr(getLocale().getLanguage(), getLocale().getRegion(), getLocale().getScript());
+        }
+        return Promise.resolve();
+    }
+    static get i18nBundles() {
+        return this.i18nBundleStorage;
+    }
     /**
      * Registers a UI5 Web Component in the browser window object
      * @public
-     * @returns {Promise<UI5Element>}
-     */
-    static async define() {
-        await boot();
-        await Promise.all([
-            this.whenDependenciesDefined(),
-            this.onDefine(),
-        ]);
+     */
+    static define() {
+        const defineSequence = async () => {
+            await boot(); // boot must finish first, because it initializes configuration
+            const result = await Promise.all([
+                this.fetchI18nBundles(), // uses configuration
+                this.fetchCLDR(),
+                this.onDefine(),
+            ]);
+            const [i18nBundles] = result;
+            Object.entries(this.getMetadata().getI18n()).forEach((pair, index) => {
+                const bundleName = pair[1].bundleName;
+                this.i18nBundleStorage[bundleName] = i18nBundles[index];
+            });
+            this.asyncFinished = true;
+        };
+        this._definePromise = defineSequence();
         const tag = this.getMetadata().getTag();
         const definedLocally = isTagRegistered(tag);
         const definedGlobally = customElements.get(tag);
@@ -922,8 +1114,7 @@ class UI5Element extends HTMLElement {
         else if (!definedGlobally) {
             this._generateAccessors();
             registerTag(tag);
-            window.customElements.define(tag, this);
-            preloadLinks(this);
+            customElements.define(tag, this);
         }
         return this;
     }
@@ -931,7 +1122,6 @@ class UI5Element extends HTMLElement {
      * Returns an instance of UI5ElementMetadata.js representing this UI5 Web Component's full metadata (its and its parents')
      * Note: not to be confused with the "get metadata()" method, which returns an object for this class's metadata only
      * @public
-     * @returns {UI5ElementMetadata}
      */
     static getMetadata() {
         if (this.hasOwnProperty("_metadata")) { // eslint-disable-line
@@ -947,19 +1137,26 @@ class UI5Element extends HTMLElement {
         this._metadata = new UI5ElementMetadata(mergedMetadata);
         return this._metadata;
     }
+    get validity() { return this._internals.validity; }
+    get validationMessage() { return this._internals.validationMessage; }
+    checkValidity() { return this._internals.checkValidity(); }
+    reportValidity() { return this._internals.reportValidity(); }
 }
 /**
  * Returns the metadata object for this UI5 Web Component Class
  * @protected
  */
 UI5Element.metadata = {};
+/**
+ * Returns the CSS for this UI5 Web Component Class
+ * @protected
+ */
+UI5Element.styles = "";
+UI5Element.i18nBundleStorage = {};
 /**
  * Always use duck-typing to cover all runtimes on the page.
- * @returns {boolean}
  */
-const instanceOfUI5Element = (object) => {
-    return "isUI5Element" in object;
-};
+const instanceOfUI5Element = createInstanceChecker("isUI5Element");
 export default UI5Element;
-export { instanceOfUI5Element };
+export { instanceOfUI5Element, };
 //# sourceMappingURL=UI5Element.js.map