@ui5/webcomponents-base 0.0.0-9195c41b9 → 0.0.0-9261ac932

package/dist/Runtimes.js

@@ -0,0 +1,97 @@
+import { getAllRegisteredTags } from "./CustomElementsRegistry.js";
+import { getCustomElementsScopingRules, getCustomElementsScopingSuffix } from "./CustomElementsScopeUtils.js";
+import VersionInfo from "./generated/VersionInfo.js";
+import getSharedResource from "./getSharedResource.js";
+let currentRuntimeIndex;
+let currentRuntimeAlias = "";
+const compareCache = new Map();
+/**
+ * Central registry where all runtimes register themselves by pushing an object.
+ * The index in the registry servers as an ID for the runtime.
+ * @type {*}
+ */
+const Runtimes = getSharedResource("Runtimes", []);
+/**
+ * Registers the current runtime in the shared runtimes resource registry
+ */
+const registerCurrentRuntime = () => {
+    if (currentRuntimeIndex === undefined) {
+        currentRuntimeIndex = Runtimes.length;
+        const versionInfo = VersionInfo;
+        Runtimes.push({
+            ...versionInfo,
+            get scopingSuffix() {
+                return getCustomElementsScopingSuffix();
+            },
+            get registeredTags() {
+                return getAllRegisteredTags();
+            },
+            get scopingRules() {
+                return getCustomElementsScopingRules();
+            },
+            alias: currentRuntimeAlias,
+            description: `Runtime ${currentRuntimeIndex} - ver ${versionInfo.version}${currentRuntimeAlias ? ` (${currentRuntimeAlias})` : ""}`,
+        });
+    }
+};
+/**
+ * Returns the index of the current runtime's object in the shared runtimes resource registry
+ * @returns {*}
+ */
+const getCurrentRuntimeIndex = () => {
+    return currentRuntimeIndex;
+};
+/**
+ * Compares two runtimes and returns 1 if the first is of a bigger version, -1 if the second is of a bigger version, and 0 if equal
+ * @param index1 The index of the first runtime to compare
+ * @param index2 The index of the second runtime to compare
+ * @returns {number}
+ */
+const compareRuntimes = (index1, index2) => {
+    const cacheIndex = `${index1},${index2}`;
+    if (compareCache.has(cacheIndex)) {
+        return compareCache.get(cacheIndex);
+    }
+    const runtime1 = Runtimes[index1];
+    const runtime2 = Runtimes[index2];
+    if (!runtime1 || !runtime2) {
+        throw new Error("Invalid runtime index supplied");
+    }
+    // If any of the two is a next version, bigger buildTime wins
+    if (runtime1.isNext || runtime2.isNext) {
+        return runtime1.buildTime - runtime2.buildTime;
+    }
+    // If major versions differ, bigger one wins
+    const majorDiff = runtime1.major - runtime2.major;
+    if (majorDiff) {
+        return majorDiff;
+    }
+    // If minor versions differ, bigger one wins
+    const minorDiff = runtime1.minor - runtime2.minor;
+    if (minorDiff) {
+        return minorDiff;
+    }
+    // If patch versions differ, bigger one wins
+    const patchDiff = runtime1.patch - runtime2.patch;
+    if (patchDiff) {
+        return patchDiff;
+    }
+    // Bigger suffix wins, f.e. rc10 > rc9
+    // Important: suffix is alphanumeric, must use natural compare
+    const collator = new Intl.Collator(undefined, { numeric: true, sensitivity: "base" });
+    const result = collator.compare(runtime1.suffix, runtime2.suffix);
+    compareCache.set(cacheIndex, result);
+    return result;
+};
+/**
+ * Set an alias for the the current app/library/microfrontend which will appear in debug messages and console warnings
+ * @param alias
+ */
+const setRuntimeAlias = (alias) => {
+    currentRuntimeAlias = alias;
+};
+const getAllRuntimes = () => {
+    return Runtimes;
+};
+export { getCurrentRuntimeIndex, registerCurrentRuntime, compareRuntimes, setRuntimeAlias, getAllRuntimes, };
+//# sourceMappingURL=Runtimes.js.map

package/dist/Runtimes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Runtimes.js","sourceRoot":"","sources":["../src/Runtimes.ts"],"names":[],"mappings":"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","sourcesContent":["import { getAllRegisteredTags } from \"./CustomElementsRegistry.js\";\nimport { getCustomElementsScopingRules, getCustomElementsScopingSuffix } from \"./CustomElementsScopeUtils.js\";\nimport VersionInfo from \"./generated/VersionInfo.js\";\nimport getSharedResource from \"./getSharedResource.js\";\n\ntype RuntimeData = VersionInfo & {\n\talias: string,\n\tdescription: string,\n};\n\nlet currentRuntimeIndex: number;\nlet currentRuntimeAlias = \"\";\n\nconst compareCache = new Map<string, number>();\n\n/**\n * Central registry where all runtimes register themselves by pushing an object.\n * The index in the registry servers as an ID for the runtime.\n * @type {*}\n */\nconst Runtimes = getSharedResource<Array<RuntimeData>>(\"Runtimes\", []);\n\n/**\n * Registers the current runtime in the shared runtimes resource registry\n */\nconst registerCurrentRuntime = () => {\n\tif (currentRuntimeIndex === undefined) {\n\t\tcurrentRuntimeIndex = Runtimes.length;\n\t\tconst versionInfo = VersionInfo;\n\n\t\tRuntimes.push({\n\t\t\t...versionInfo,\n\t\t\tget scopingSuffix() {\n\t\t\t\treturn getCustomElementsScopingSuffix();\n\t\t\t},\n\t\t\tget registeredTags() {\n\t\t\t\treturn getAllRegisteredTags();\n\t\t\t},\n\t\t\tget scopingRules() {\n\t\t\t\treturn getCustomElementsScopingRules();\n\t\t\t},\n\t\t\talias: currentRuntimeAlias,\n\t\t\tdescription: `Runtime ${currentRuntimeIndex} - ver ${versionInfo.version}${currentRuntimeAlias ? ` (${currentRuntimeAlias})` : \"\"}`,\n\t\t});\n\t}\n};\n\n/**\n * Returns the index of the current runtime's object in the shared runtimes resource registry\n * @returns {*}\n */\nconst getCurrentRuntimeIndex = () => {\n\treturn currentRuntimeIndex;\n};\n\n/**\n * Compares two runtimes and returns 1 if the first is of a bigger version, -1 if the second is of a bigger version, and 0 if equal\n * @param index1 The index of the first runtime to compare\n * @param index2 The index of the second runtime to compare\n * @returns {number}\n */\nconst compareRuntimes = (index1: number, index2: number) => {\n\tconst cacheIndex = `${index1},${index2}`;\n\tif (compareCache.has(cacheIndex)) {\n\t\treturn compareCache.get(cacheIndex)!;\n\t}\n\n\tconst runtime1 = Runtimes[index1];\n\tconst runtime2 = Runtimes[index2];\n\n\tif (!runtime1 || !runtime2) {\n\t\tthrow new Error(\"Invalid runtime index supplied\");\n\t}\n\n\t// If any of the two is a next version, bigger buildTime wins\n\tif (runtime1.isNext || runtime2.isNext) {\n\t\treturn runtime1.buildTime - runtime2.buildTime;\n\t}\n\n\t// If major versions differ, bigger one wins\n\tconst majorDiff = runtime1.major - runtime2.major;\n\tif (majorDiff) {\n\t\treturn majorDiff;\n\t}\n\n\t// If minor versions differ, bigger one wins\n\tconst minorDiff = runtime1.minor - runtime2.minor;\n\tif (minorDiff) {\n\t\treturn minorDiff;\n\t}\n\n\t// If patch versions differ, bigger one wins\n\tconst patchDiff = runtime1.patch - runtime2.patch;\n\tif (patchDiff) {\n\t\treturn patchDiff;\n\t}\n\n\t// Bigger suffix wins, f.e. rc10 > rc9\n\t// Important: suffix is alphanumeric, must use natural compare\n\tconst collator = new Intl.Collator(undefined, { numeric: true, sensitivity: \"base\" });\n\tconst result = collator.compare(runtime1.suffix, runtime2.suffix);\n\n\tcompareCache.set(cacheIndex, result);\n\treturn result;\n};\n\n/**\n * Set an alias for the the current app/library/microfrontend which will appear in debug messages and console warnings\n * @param alias\n */\nconst setRuntimeAlias = (alias: string) => {\n\tcurrentRuntimeAlias = alias;\n};\n\nconst getAllRuntimes = () => {\n\treturn Runtimes;\n};\n\nexport {\n\tgetCurrentRuntimeIndex,\n\tregisterCurrentRuntime,\n\tcompareRuntimes,\n\tsetRuntimeAlias,\n\tgetAllRuntimes,\n};\n"]}

package/dist/SystemCSSVars.d.ts

@@ -0,0 +1,2 @@
+declare const insertSystemCSSVars: () => void;
+export default insertSystemCSSVars;

package/dist/SystemCSSVars.js

@@ -0,0 +1,9 @@
+import { hasStyle, createStyle } from "./ManagedStyles.js";
+import systemCSSVars from "./generated/css/SystemCSSVars.css.js";
+const insertSystemCSSVars = () => {
+    if (!hasStyle("data-ui5-system-css-vars")) {
+        createStyle(systemCSSVars, "data-ui5-system-css-vars");
+    }
+};
+export default insertSystemCSSVars;
+//# sourceMappingURL=SystemCSSVars.js.map

package/dist/SystemCSSVars.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemCSSVars.js","sourceRoot":"","sources":["../src/SystemCSSVars.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,aAAa,MAAM,sCAAsC,CAAC;AAEjE,MAAM,mBAAmB,GAAG,GAAG,EAAE;IAChC,IAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,CAAC;QAC3C,WAAW,CAAC,aAAa,EAAE,0BAA0B,CAAC,CAAC;IACxD,CAAC;AACF,CAAC,CAAC;AAEF,eAAe,mBAAmB,CAAC","sourcesContent":["import { hasStyle, createStyle } from \"./ManagedStyles.js\";\nimport systemCSSVars from \"./generated/css/SystemCSSVars.css.js\";\n\nconst insertSystemCSSVars = () => {\n\tif (!hasStyle(\"data-ui5-system-css-vars\")) {\n\t\tcreateStyle(systemCSSVars, \"data-ui5-system-css-vars\");\n\t}\n};\n\nexport default insertSystemCSSVars;\n"]}

package/dist/Theming.d.ts

@@ -0,0 +1,3 @@
+import { addCustomCSS } from "./theming/CustomStyle.js";
+import { attachThemeLoaded, detachThemeLoaded } from "./theming/ThemeLoaded.js";
+export { addCustomCSS, attachThemeLoaded, detachThemeLoaded };

package/dist/Theming.js

@@ -1,3 +1,4 @@
 import { addCustomCSS } from "./theming/CustomStyle.js";
-
-export { addCustomCSS }; // eslint-disable-line
+import { attachThemeLoaded, detachThemeLoaded } from "./theming/ThemeLoaded.js";
+export { addCustomCSS, attachThemeLoaded, detachThemeLoaded };
+//# sourceMappingURL=Theming.js.map

package/dist/Theming.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Theming.js","sourceRoot":"","sources":["../src/Theming.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAEhF,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,CAAC","sourcesContent":["import { addCustomCSS } from \"./theming/CustomStyle.js\";\nimport { attachThemeLoaded, detachThemeLoaded } from \"./theming/ThemeLoaded.js\";\n\nexport { addCustomCSS, attachThemeLoaded, detachThemeLoaded };\n"]}

package/dist/UI5Element.d.ts

@@ -0,0 +1,394 @@
+import "@ui5/webcomponents-base/dist/ssr-dom.js";
+import UI5ElementMetadata from "./UI5ElementMetadata.js";
+import type { Slot, SlotValue, State, PropertyValue, Metadata } from "./UI5ElementMetadata.js";
+import EventProvider from "./EventProvider.js";
+import type { TemplateFunction, TemplateFunctionResult } from "./renderer/executeTemplate.js";
+import type { AccessibilityInfo, PromiseResolve, ComponentStylesData, ClassMap } from "./types.js";
+type Renderer = (templateResult: TemplateFunctionResult, container: HTMLElement | DocumentFragment, options: RendererOptions) => void;
+type RendererOptions = {
+    /**
+     * An object to use as the `this` value for event listeners. It's often
+     * useful to set this to the host component rendering a template.
+     */
+    host?: object;
+};
+type ChangeInfo = {
+    type: "property" | "slot";
+    name: string;
+    reason?: string;
+    child?: SlotValue;
+    target?: UI5Element;
+    newValue?: PropertyValue;
+    oldValue?: PropertyValue;
+};
+type InvalidationInfo = ChangeInfo & {
+    target: UI5Element;
+};
+type ChildChangeListener = (param: InvalidationInfo) => void;
+type SlotChangeListener = (this: HTMLSlotElement, ev: Event) => void;
+/**
+ * @class
+ * Base class for all UI5 Web Components
+ *
+ * @extends HTMLElement
+ * @public
+ */
+declare abstract class UI5Element extends HTMLElement {
+    __id?: string;
+    _suppressInvalidation: boolean;
+    _changedState: Array<ChangeInfo>;
+    _invalidationEventProvider: EventProvider<InvalidationInfo, void>;
+    _componentStateFinalizedEventProvider: EventProvider<void, void>;
+    _inDOM: boolean;
+    _fullyConnected: boolean;
+    _childChangeListeners: Map<string, ChildChangeListener>;
+    _slotsAssignedNodes: WeakMap<HTMLSlotElement, Array<SlotValue>>;
+    _slotChangeListeners: Map<string, SlotChangeListener>;
+    _domRefReadyPromise: Promise<void> & {
+        _deferredResolve?: PromiseResolve;
+    };
+    _doNotSyncAttributes: Set<string>;
+    _state: State;
+    _internals: ElementInternals;
+    _getRealDomRef?: () => HTMLElement;
+    static template?: TemplateFunction;
+    static _metadata: UI5ElementMetadata;
+    static renderer: Renderer;
+    initializedProperties: Map<string, unknown>;
+    _rendered: boolean;
+    constructor();
+    _initShadowRoot(): void;
+    /**
+     * Note: this "slotchange" listener is for slots, rendered in the component's shadow root
+     */
+    _onShadowRootSlotChange(e: Event): void;
+    /**
+     * Returns a unique ID for this UI5 Element
+     *
+     * @deprecated - This property is not guaranteed in future releases
+     * @protected
+     */
+    get _id(): string;
+    render(): object;
+    /**
+     * Do not call this method from derivatives of UI5Element, use "onEnterDOM" only
+     * @private
+     */
+    connectedCallback(): Promise<void>;
+    /**
+     * Do not call this method from derivatives of UI5Element, use "onExitDOM" only
+     * @private
+     */
+    disconnectedCallback(): void;
+    /**
+     * Called every time before the component renders.
+     * @public
+     */
+    onBeforeRendering(): void;
+    /**
+     * Called every time after the component renders.
+     * @public
+     */
+    onAfterRendering(): void;
+    /**
+     * Called on connectedCallback - added to the DOM.
+     * @public
+     */
+    onEnterDOM(): void;
+    /**
+     * Called on disconnectedCallback - removed from the DOM.
+     * @public
+     */
+    onExitDOM(): void;
+    /**
+     * @private
+     */
+    _startObservingDOMChildren(): void;
+    /**
+     * @private
+     */
+    _stopObservingDOMChildren(): void;
+    /**
+     * Note: this method is also manually called by "compatibility/patchNodeValue.js"
+     * @private
+     */
+    _processChildren(): Promise<void>;
+    /**
+     * @private
+     */
+    _updateSlots(): Promise<void>;
+    /**
+     * Removes all children from the slot and detaches listeners, if any
+     * @private
+     */
+    _clearSlot(slotName: string, slotData: Slot): void;
+    /**
+     * Attach a callback that will be executed whenever the component is invalidated
+     *
+     * @param callback
+     * @public
+     */
+    attachInvalidate(callback: (param: InvalidationInfo) => void): void;
+    /**
+     * Detach the callback that is executed whenever the component is invalidated
+     *
+     * @param callback
+     * @public
+     */
+    detachInvalidate(callback: (param: InvalidationInfo) => void): void;
+    /**
+     * Callback that is executed whenever a monitored child changes its state
+     *
+     * @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: string, childChangeInfo: ChangeInfo): void;
+    /**
+     * Do not override this method in derivatives of UI5Element
+     * @private
+     */
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    formAssociatedCallback(): void;
+    static get formAssociated(): boolean;
+    /**
+     * @private
+     */
+    _updateAttribute(name: string, newValue: PropertyValue): void;
+    /**
+     * 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
+     * @private
+     */
+    _getChildChangeListener(slotName: string): ChildChangeListener;
+    /**
+     * 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
+     * @private
+     */
+    _getSlotChangeListener(slotName: string): SlotChangeListener;
+    /**
+     * @private
+     */
+    _attachSlotChange(slot: HTMLSlotElement, slotName: string, invalidateOnChildChange: boolean): void;
+    /**
+     * @private
+     */
+    _detachSlotChange(child: HTMLSlotElement, slotName: string): void;
+    /**
+     * 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
+     */
+    _onSlotChange(slotName: string): void;
+    /**
+     * A callback that is executed each time an already rendered component is invalidated (scheduled for re-rendering)
+     *
+     * @param  changeInfo An object with information about the change that caused invalidation.
+     * The object can have the following properties:
+     *  - type: (property|slot) tells what caused the invalidation
+     *   1) property: a property value was changed either directly or as a result of changing the corresponding attribute
+     *   2) slot: a slotted node(nodes) changed in one of several ways (see "reason")
+     *
+     *  - name: the name of the property or slot that caused the invalidation
+     *
+     *  - reason: (children|textcontent|childchange|slotchange) relevant only for type="slot" only and tells exactly what changed in the slot
+     *   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.
+     *   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
+     *
+     *  - newValue: the new value of the property (for type="property" only)
+     *
+     *  - oldValue: the old value of the property (for type="property" only)
+     *
+     *  - child the child that was changed (for type="slot" and reason="childchange" only)
+     *
+     * @public
+     */
+    onInvalidation(changeInfo: ChangeInfo): void;
+    updateAttributes(): void;
+    /**
+     * Do not call this method directly, only intended to be called by js
+     * @protected
+     */
+    _render(): void;
+    /**
+     * @private
+     */
+    _assignIndividualSlotsToChildren(): void;
+    /**
+     * @private
+     */
+    _waitForDomRef(): Promise<void> & {
+        _deferredResolve?: PromiseResolve;
+    };
+    /**
+     * Returns the DOM Element inside the Shadow Root that corresponds to the opening tag in the UI5 Web Component's template
+     * *Note:* For logical (abstract) elements (items, options, etc...), returns the part of the parent's DOM that represents this option
+     * Use this method instead of "this.shadowRoot" to read the Shadow DOM, if ever necessary
+     *
+     * @public
+     */
+    getDomRef(): HTMLElement | undefined;
+    /**
+     * Returns the DOM Element marked with "data-sap-focus-ref" inside the template.
+     * This is the element that will receive the focus by default.
+     * @public
+     */
+    getFocusDomRef(): HTMLElement | undefined;
+    /**
+     * Waits for dom ref and then returns the DOM Element marked with "data-sap-focus-ref" inside the template.
+     * This is the element that will receive the focus by default.
+     * @public
+     */
+    getFocusDomRefAsync(): Promise<HTMLElement | undefined>;
+    /**
+     * Set the focus to the element, returned by "getFocusDomRef()" (marked by "data-sap-focus-ref")
+     * @param focusOptions additional options for the focus
+     * @public
+     */
+    focus(focusOptions?: FocusOptions): Promise<void>;
+    /**
+     *
+     * @public
+     * @param name - name of the event
+     * @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 false, if the event was cancelled (preventDefault called), true otherwise
+     * @deprecated use fireDecoratorEvent instead
+     */
+    fireEvent<T>(name: string, data?: T, cancelable?: boolean, bubbles?: boolean): boolean;
+    /**
+     * 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<T>(name: string, data?: T): boolean;
+    _fireEvent<T>(name: string, data?: T, cancelable?: boolean, bubbles?: boolean): boolean;
+    getEventData(name: string): {
+        detail: Record<string, object>;
+        cancelable: boolean;
+        bubbles: boolean;
+    };
+    /**
+     * 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.
+     * @public
+     */
+    getSlottedNodes<T = Node>(slotName: string): Array<T>;
+    /**
+     * Attach a callback that will be executed whenever the component's state is finalized
+     *
+     * @param callback
+     * @public
+     */
+    attachComponentStateFinalized(callback: () => void): void;
+    /**
+     * Detach the callback that is executed whenever the component's state is finalized
+     *
+     * @param callback
+     * @public
+     */
+    detachComponentStateFinalized(callback: () => void): void;
+    /**
+     * Determines whether the component should be rendered in RTL mode or not.
+     * Returns: "rtl", "ltr" or undefined
+     *
+     * @public
+     * @default undefined
+     */
+    get effectiveDir(): string | undefined;
+    /**
+     * Used to duck-type UI5 elements without using instanceof
+     * @public
+     * @default true
+     */
+    get isUI5Element(): boolean;
+    get classes(): ClassMap;
+    /**
+     * Returns the component accessibility info.
+     * @private
+     */
+    get accessibilityInfo(): AccessibilityInfo;
+    /**
+     * Do not override this method in derivatives of UI5Element, use metadata properties instead
+     * @private
+     */
+    static get observedAttributes(): string[];
+    /**
+     * @private
+     */
+    static _needsShadowDOM(): boolean;
+    /**
+     * @private
+     */
+    static _generateAccessors(): void;
+    /**
+     * Returns the metadata object for this UI5 Web Component Class
+     * @protected
+     */
+    static metadata: Metadata;
+    /**
+     * Returns the CSS for this UI5 Web Component Class
+     * @protected
+     */
+    static styles: ComponentStylesData;
+    /**
+     * 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)
+     *  - slotted components that the component may need to communicate with
+     *
+     * @protected
+     */
+    static get dependencies(): Array<typeof UI5Element>;
+    static cacheUniqueDependencies(this: typeof UI5Element): void;
+    /**
+     * Returns a list of the unique dependencies for this UI5 Web Component
+     *
+     * @public
+     */
+    static getUniqueDependencies(this: typeof UI5Element): Array<typeof UI5Element>;
+    /**
+     * Hook that will be called upon custom element definition
+     *
+     * @protected
+     * @deprecated use the "i18n" decorator for fetching message bundles and the "cldr" option in the "customElements" decorator for fetching CLDR
+     */
+    static onDefine(): Promise<void>;
+    static fetchI18nBundles(): Promise<import("./i18nBundle.js").default[]>;
+    static fetchCLDR(): Promise<void>;
+    static asyncFinished: boolean;
+    static definePromise: Promise<void> | undefined;
+    /**
+     * Registers a UI5 Web Component in the browser window object
+     * @public
+     */
+    static define(): typeof UI5Element;
+    /**
+     * 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
+     */
+    static getMetadata(): UI5ElementMetadata;
+    get validity(): ValidityState;
+    get validationMessage(): string;
+    checkValidity(): boolean;
+    reportValidity(): boolean;
+}
+/**
+ * Always use duck-typing to cover all runtimes on the page.
+ */
+declare const instanceOfUI5Element: (object: any) => object is UI5Element;
+export default UI5Element;
+export { instanceOfUI5Element, };
+export type { ChangeInfo, InvalidationInfo, Renderer, RendererOptions, };