@vonage/vivid 4.22.0 → 4.24.0

package/shared/foundation/vivid-element/vivid-element.d.ts

@@ -1,4 +1,342 @@
 import { FASTElement } from '@microsoft/fast-element';
-export declare class VividElement extends FASTElement {
+declare const VividElement_base: {
+    new (...args: any[]): {
+        specialHandling: boolean;
+        _vividAriaBehaviour: import("../../aria/aria-mixin").VividAriaBehaviour;
+        readonly $fastController: import("@microsoft/fast-element").Controller;
+        $emit(type: string, detail?: any, options?: Omit<CustomEventInit<any>, "detail"> | undefined): boolean | void;
+        connectedCallback(): void;
+        disconnectedCallback(): void;
+        attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+        accessKey: string;
+        readonly accessKeyLabel: string;
+        autocapitalize: string;
+        dir: string;
+        draggable: boolean;
+        hidden: boolean;
+        inert: boolean;
+        innerText: string;
+        lang: string;
+        readonly offsetHeight: number;
+        readonly offsetLeft: number;
+        readonly offsetParent: Element | null;
+        readonly offsetTop: number;
+        readonly offsetWidth: number;
+        outerText: string;
+        spellcheck: boolean;
+        title: string;
+        translate: boolean;
+        attachInternals(): ElementInternals;
+        click(): void;
+        addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions | undefined): void;
+        addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions | undefined): void;
+        removeEventListener<K_1 extends keyof HTMLElementEventMap>(type: K_1, listener: (this: HTMLElement, ev: HTMLElementEventMap[K_1]) => any, options?: boolean | EventListenerOptions | undefined): void;
+        removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions | undefined): void;
+        dropzone: import("dropzone");
+        readonly attributes: NamedNodeMap;
+        readonly classList: DOMTokenList;
+        className: string;
+        readonly clientHeight: number;
+        readonly clientLeft: number;
+        readonly clientTop: number;
+        readonly clientWidth: number;
+        id: string;
+        readonly localName: string;
+        readonly namespaceURI: string | null;
+        onfullscreenchange: ((this: Element, ev: Event) => any) | null;
+        onfullscreenerror: ((this: Element, ev: Event) => any) | null;
+        outerHTML: string;
+        readonly ownerDocument: Document;
+        readonly part: DOMTokenList;
+        readonly prefix: string | null;
+        readonly scrollHeight: number;
+        scrollLeft: number;
+        scrollTop: number;
+        readonly scrollWidth: number;
+        readonly shadowRoot: ShadowRoot | null;
+        slot: string;
+        readonly tagName: string;
+        attachShadow(init: ShadowRootInit): ShadowRoot;
+        checkVisibility(options?: CheckVisibilityOptions | undefined): boolean;
+        closest<K_2 extends keyof HTMLElementTagNameMap>(selector: K_2): HTMLElementTagNameMap[K_2] | null;
+        closest<K_3 extends keyof SVGElementTagNameMap>(selector: K_3): SVGElementTagNameMap[K_3] | null;
+        closest<K_4 extends keyof MathMLElementTagNameMap>(selector: K_4): MathMLElementTagNameMap[K_4] | null;
+        closest<E extends Element = Element>(selectors: string): E | null;
+        getAttribute(qualifiedName: string): string | null;
+        getAttributeNS(namespace: string | null, localName: string): string | null;
+        getAttributeNames(): string[];
+        getAttributeNode(qualifiedName: string): Attr | null;
+        getAttributeNodeNS(namespace: string | null, localName: string): Attr | null;
+        getBoundingClientRect(): DOMRect;
+        getClientRects(): DOMRectList;
+        getElementsByClassName(classNames: string): HTMLCollectionOf<Element>;
+        getElementsByTagName<K_5 extends keyof HTMLElementTagNameMap>(qualifiedName: K_5): HTMLCollectionOf<HTMLElementTagNameMap[K_5]>;
+        getElementsByTagName<K_6 extends keyof SVGElementTagNameMap>(qualifiedName: K_6): HTMLCollectionOf<SVGElementTagNameMap[K_6]>;
+        getElementsByTagName<K_7 extends keyof MathMLElementTagNameMap>(qualifiedName: K_7): HTMLCollectionOf<MathMLElementTagNameMap[K_7]>;
+        getElementsByTagName<K_8 extends keyof HTMLElementDeprecatedTagNameMap>(qualifiedName: K_8): HTMLCollectionOf<HTMLElementDeprecatedTagNameMap[K_8]>;
+        getElementsByTagName(qualifiedName: string): HTMLCollectionOf<Element>;
+        getElementsByTagNameNS(namespaceURI: "http://www.w3.org/1999/xhtml", localName: string): HTMLCollectionOf<HTMLElement>;
+        getElementsByTagNameNS(namespaceURI: "http://www.w3.org/2000/svg", localName: string): HTMLCollectionOf<SVGElement>;
+        getElementsByTagNameNS(namespaceURI: "http://www.w3.org/1998/Math/MathML", localName: string): HTMLCollectionOf<MathMLElement>;
+        getElementsByTagNameNS(namespace: string | null, localName: string): HTMLCollectionOf<Element>;
+        hasAttribute(qualifiedName: string): boolean;
+        hasAttributeNS(namespace: string | null, localName: string): boolean;
+        hasAttributes(): boolean;
+        hasPointerCapture(pointerId: number): boolean;
+        insertAdjacentElement(where: InsertPosition, element: Element): Element | null;
+        insertAdjacentHTML(position: InsertPosition, text: string): void;
+        insertAdjacentText(where: InsertPosition, data: string): void;
+        matches(selectors: string): boolean;
+        releasePointerCapture(pointerId: number): void;
+        removeAttribute(qualifiedName: string): void;
+        removeAttributeNS(namespace: string | null, localName: string): void;
+        removeAttributeNode(attr: Attr): Attr;
+        requestFullscreen(options?: FullscreenOptions | undefined): Promise<void>;
+        requestPointerLock(): void;
+        scroll(options?: ScrollToOptions | undefined): void;
+        scroll(x: number, y: number): void;
+        scrollBy(options?: ScrollToOptions | undefined): void;
+        scrollBy(x: number, y: number): void;
+        scrollIntoView(arg?: boolean | ScrollIntoViewOptions | undefined): void;
+        scrollTo(options?: ScrollToOptions | undefined): void;
+        scrollTo(x: number, y: number): void;
+        setAttribute(qualifiedName: string, value: string): void;
+        setAttributeNS(namespace: string | null, qualifiedName: string, value: string): void;
+        setAttributeNode(attr: Attr): Attr | null;
+        setAttributeNodeNS(attr: Attr): Attr | null;
+        setPointerCapture(pointerId: number): void;
+        toggleAttribute(qualifiedName: string, force?: boolean | undefined): boolean;
+        webkitMatchesSelector(selectors: string): boolean;
+        readonly baseURI: string;
+        readonly childNodes: NodeListOf<ChildNode>;
+        readonly firstChild: ChildNode | null;
+        readonly isConnected: boolean;
+        readonly lastChild: ChildNode | null;
+        readonly nextSibling: ChildNode | null;
+        readonly nodeName: string;
+        readonly nodeType: number;
+        nodeValue: string | null;
+        readonly parentElement: HTMLElement | null;
+        readonly parentNode: ParentNode | null;
+        readonly previousSibling: ChildNode | null;
+        textContent: string | null;
+        appendChild<T extends Node>(node: T): T;
+        cloneNode(deep?: boolean | undefined): Node;
+        compareDocumentPosition(other: Node): number;
+        contains(other: Node | null): boolean;
+        getRootNode(options?: GetRootNodeOptions | undefined): Node;
+        hasChildNodes(): boolean;
+        insertBefore<T_1 extends Node>(node: T_1, child: Node | null): T_1;
+        isDefaultNamespace(namespace: string | null): boolean;
+        isEqualNode(otherNode: Node | null): boolean;
+        isSameNode(otherNode: Node | null): boolean;
+        lookupNamespaceURI(prefix: string | null): string | null;
+        lookupPrefix(namespace: string | null): string | null;
+        normalize(): void;
+        removeChild<T_2 extends Node>(child: T_2): T_2;
+        replaceChild<T_3 extends Node>(node: Node, child: T_3): T_3;
+        readonly ELEMENT_NODE: 1;
+        readonly ATTRIBUTE_NODE: 2;
+        readonly TEXT_NODE: 3;
+        readonly CDATA_SECTION_NODE: 4;
+        readonly ENTITY_REFERENCE_NODE: 5;
+        readonly ENTITY_NODE: 6;
+        readonly PROCESSING_INSTRUCTION_NODE: 7;
+        readonly COMMENT_NODE: 8;
+        readonly DOCUMENT_NODE: 9;
+        readonly DOCUMENT_TYPE_NODE: 10;
+        readonly DOCUMENT_FRAGMENT_NODE: 11;
+        readonly NOTATION_NODE: 12;
+        readonly DOCUMENT_POSITION_DISCONNECTED: 1;
+        readonly DOCUMENT_POSITION_PRECEDING: 2;
+        readonly DOCUMENT_POSITION_FOLLOWING: 4;
+        readonly DOCUMENT_POSITION_CONTAINS: 8;
+        readonly DOCUMENT_POSITION_CONTAINED_BY: 16;
+        readonly DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC: 32;
+        dispatchEvent(event: Event): boolean;
+        ariaAtomic: string | null;
+        ariaAutoComplete: string | null;
+        ariaBusy: string | null;
+        ariaChecked: string | null;
+        ariaColCount: string | null;
+        ariaColIndex: string | null;
+        ariaColSpan: string | null;
+        ariaCurrent: string | null;
+        ariaDisabled: string | null;
+        ariaExpanded: string | null;
+        ariaHasPopup: string | null;
+        ariaHidden: string | null;
+        ariaInvalid: string | null;
+        ariaKeyShortcuts: string | null;
+        ariaLabel: string | null;
+        ariaLevel: string | null;
+        ariaLive: string | null;
+        ariaModal: string | null;
+        ariaMultiLine: string | null;
+        ariaMultiSelectable: string | null;
+        ariaOrientation: string | null;
+        ariaPlaceholder: string | null;
+        ariaPosInSet: string | null;
+        ariaPressed: string | null;
+        ariaReadOnly: string | null;
+        ariaRequired: string | null;
+        ariaRoleDescription: string | null;
+        ariaRowCount: string | null;
+        ariaRowIndex: string | null;
+        ariaRowSpan: string | null;
+        ariaSelected: string | null;
+        ariaSetSize: string | null;
+        ariaSort: string | null;
+        ariaValueMax: string | null;
+        ariaValueMin: string | null;
+        ariaValueNow: string | null;
+        ariaValueText: string | null;
+        role: string | null;
+        animate(keyframes: Keyframe[] | PropertyIndexedKeyframes | null, options?: number | KeyframeAnimationOptions | undefined): Animation;
+        getAnimations(options?: GetAnimationsOptions | undefined): Animation[];
+        after(...nodes: (string | Node)[]): void;
+        before(...nodes: (string | Node)[]): void;
+        remove(): void;
+        replaceWith(...nodes: (string | Node)[]): void;
+        innerHTML: string;
+        readonly nextElementSibling: Element | null;
+        readonly previousElementSibling: Element | null;
+        readonly childElementCount: number;
+        readonly children: HTMLCollection;
+        readonly firstElementChild: Element | null;
+        readonly lastElementChild: Element | null;
+        append(...nodes: (string | Node)[]): void;
+        prepend(...nodes: (string | Node)[]): void;
+        querySelector<K_9 extends keyof HTMLElementTagNameMap>(selectors: K_9): HTMLElementTagNameMap[K_9] | null;
+        querySelector<K_10 extends keyof SVGElementTagNameMap>(selectors: K_10): SVGElementTagNameMap[K_10] | null;
+        querySelector<K_11 extends keyof MathMLElementTagNameMap>(selectors: K_11): MathMLElementTagNameMap[K_11] | null;
+        querySelector<K_12 extends keyof HTMLElementDeprecatedTagNameMap>(selectors: K_12): HTMLElementDeprecatedTagNameMap[K_12] | null;
+        querySelector<E_1 extends Element = Element>(selectors: string): E_1 | null;
+        querySelectorAll<K_13 extends keyof HTMLElementTagNameMap>(selectors: K_13): NodeListOf<HTMLElementTagNameMap[K_13]>;
+        querySelectorAll<K_14 extends keyof SVGElementTagNameMap>(selectors: K_14): NodeListOf<SVGElementTagNameMap[K_14]>;
+        querySelectorAll<K_15 extends keyof MathMLElementTagNameMap>(selectors: K_15): NodeListOf<MathMLElementTagNameMap[K_15]>;
+        querySelectorAll<K_16 extends keyof HTMLElementDeprecatedTagNameMap>(selectors: K_16): NodeListOf<HTMLElementDeprecatedTagNameMap[K_16]>;
+        querySelectorAll<E_2 extends Element = Element>(selectors: string): NodeListOf<E_2>;
+        replaceChildren(...nodes: (string | Node)[]): void;
+        readonly assignedSlot: HTMLSlotElement | null;
+        readonly style: CSSStyleDeclaration;
+        contentEditable: string;
+        enterKeyHint: string;
+        inputMode: string;
+        readonly isContentEditable: boolean;
+        onabort: ((this: GlobalEventHandlers, ev: UIEvent) => any) | null;
+        onanimationcancel: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+        onanimationend: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+        onanimationiteration: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+        onanimationstart: ((this: GlobalEventHandlers, ev: AnimationEvent) => any) | null;
+        onauxclick: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onbeforeinput: ((this: GlobalEventHandlers, ev: InputEvent) => any) | null;
+        onblur: ((this: GlobalEventHandlers, ev: FocusEvent) => any) | null;
+        oncancel: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        oncanplay: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        oncanplaythrough: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onclick: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onclose: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        oncontextmenu: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        oncopy: ((this: GlobalEventHandlers, ev: ClipboardEvent) => any) | null;
+        oncuechange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        oncut: ((this: GlobalEventHandlers, ev: ClipboardEvent) => any) | null;
+        ondblclick: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        ondrag: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragend: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragenter: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragleave: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragover: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondragstart: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondrop: ((this: GlobalEventHandlers, ev: DragEvent) => any) | null;
+        ondurationchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onemptied: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onended: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onerror: OnErrorEventHandler;
+        onfocus: ((this: GlobalEventHandlers, ev: FocusEvent) => any) | null;
+        onformdata: ((this: GlobalEventHandlers, ev: FormDataEvent) => any) | null;
+        ongotpointercapture: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        oninput: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        oninvalid: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onkeydown: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null;
+        onkeypress: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null;
+        onkeyup: ((this: GlobalEventHandlers, ev: KeyboardEvent) => any) | null;
+        onload: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onloadeddata: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onloadedmetadata: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onloadstart: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onlostpointercapture: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onmousedown: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseenter: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseleave: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmousemove: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseout: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseover: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onmouseup: ((this: GlobalEventHandlers, ev: MouseEvent) => any) | null;
+        onpaste: ((this: GlobalEventHandlers, ev: ClipboardEvent) => any) | null;
+        onpause: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onplay: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onplaying: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onpointercancel: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerdown: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerenter: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerleave: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointermove: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerout: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerover: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onpointerup: ((this: GlobalEventHandlers, ev: PointerEvent) => any) | null;
+        onprogress: ((this: GlobalEventHandlers, ev: ProgressEvent<EventTarget>) => any) | null;
+        onratechange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onreset: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onresize: ((this: GlobalEventHandlers, ev: UIEvent) => any) | null;
+        onscroll: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onsecuritypolicyviolation: ((this: GlobalEventHandlers, ev: SecurityPolicyViolationEvent) => any) | null;
+        onseeked: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onseeking: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onselect: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onselectionchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onselectstart: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onslotchange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onstalled: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onsubmit: ((this: GlobalEventHandlers, ev: SubmitEvent) => any) | null;
+        onsuspend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        ontimeupdate: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        ontoggle: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        ontouchcancel?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+        ontouchend?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+        ontouchmove?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+        ontouchstart?: ((this: GlobalEventHandlers, ev: TouchEvent) => any) | null | undefined;
+        ontransitioncancel: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+        ontransitionend: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+        ontransitionrun: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+        ontransitionstart: ((this: GlobalEventHandlers, ev: TransitionEvent) => any) | null;
+        onvolumechange: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwaiting: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwebkitanimationend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwebkitanimationiteration: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwebkitanimationstart: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwebkittransitionend: ((this: GlobalEventHandlers, ev: Event) => any) | null;
+        onwheel: ((this: GlobalEventHandlers, ev: WheelEvent) => any) | null;
+        autofocus: boolean;
+        readonly dataset: DOMStringMap;
+        nonce?: string | undefined;
+        tabIndex: number;
+        blur(): void;
+        focus(options?: FocusOptions | undefined): void;
+        ariaColIndexText: string | null;
+        ariaDescription: string | null;
+        ariaRowIndexText: string | null;
+        ariaRelevant: string | null;
+    };
+} & (new () => HTMLElement & FASTElement) & {
+    from<TBase extends {
+        new (): HTMLElement;
+        prototype: HTMLElement;
+    }>(BaseType: TBase): new () => InstanceType<TBase> & FASTElement;
+    define<TType extends Function>(type: TType, nameOrDef?: string | import("@microsoft/fast-element").PartialFASTElementDefinition | undefined): TType;
+};
+export declare class VividElement extends VividElement_base {
     static VIVID_VERSION: string;
 }
+export {};

package/shared/host-semantics.cjs

@@ -0,0 +1,65 @@
+'use strict';
+
+const vividElement = require('./vivid-element.cjs');
+const attributeBindingBehaviour = require('./attribute-binding-behaviour.cjs');
+
+class HostSemanticsBehavior {
+  constructor(target, params) {
+    this.target = target;
+    this.bindingBehaviours = [];
+    this.boundProperties = params.boundProperties;
+  }
+  bind(source) {
+    if (this.target !== source) {
+      throw new Error("Target element must be the same as the source element");
+    }
+    this.bindPropertiesToTarget(source, this.boundProperties, this.target);
+  }
+  unbind(source) {
+    this.releasePropertyBindings(source);
+  }
+  bindPropertiesToTarget(source, boundProperties, target) {
+    for (const [property, binding] of Object.entries(boundProperties)) {
+      const bindingFn = binding instanceof Function ? binding : (x) => x[property] ?? binding;
+      this.bindingBehaviours.push(
+        new attributeBindingBehaviour.AttributeBindingBehavior(
+          target,
+          bindingFn,
+          true,
+          vividElement.ariaAttributeName(property)
+        )
+      );
+    }
+    source.$fastController.addBehaviors(this.bindingBehaviours);
+  }
+  releasePropertyBindings(source) {
+    source.$fastController.removeBehaviors(this.bindingBehaviours);
+    this.bindingBehaviours = [];
+  }
+}
+
+function applyHostSemantics(boundProperties = {}) {
+  const forwardedProperties = new Set(
+    vividElement.ariaMixinProperties.filter((p) => !(p in boundProperties))
+  );
+  return new vividElement.AttachedBehaviorHTMLDirective(
+    "vvd-host-semantics",
+    HostSemanticsBehavior,
+    {
+      boundProperties,
+      forwardedProperties
+    }
+  );
+}
+const HostSemantics = (Base) => {
+  class HostSemanticsElement extends Base {
+    constructor() {
+      super(...arguments);
+      this._vividAriaBehaviour = "host";
+    }
+  }
+  return HostSemanticsElement;
+};
+
+exports.HostSemantics = HostSemantics;
+exports.applyHostSemantics = applyHostSemantics;

package/shared/host-semantics.js

@@ -0,0 +1,62 @@
+import { d as ariaAttributeName, f as ariaMixinProperties, A as AttachedBehaviorHTMLDirective } from './vivid-element.js';
+import { A as AttributeBindingBehavior } from './attribute-binding-behaviour.js';
+
+class HostSemanticsBehavior {
+  constructor(target, params) {
+    this.target = target;
+    this.bindingBehaviours = [];
+    this.boundProperties = params.boundProperties;
+  }
+  bind(source) {
+    if (this.target !== source) {
+      throw new Error("Target element must be the same as the source element");
+    }
+    this.bindPropertiesToTarget(source, this.boundProperties, this.target);
+  }
+  unbind(source) {
+    this.releasePropertyBindings(source);
+  }
+  bindPropertiesToTarget(source, boundProperties, target) {
+    for (const [property, binding] of Object.entries(boundProperties)) {
+      const bindingFn = binding instanceof Function ? binding : (x) => x[property] ?? binding;
+      this.bindingBehaviours.push(
+        new AttributeBindingBehavior(
+          target,
+          bindingFn,
+          true,
+          ariaAttributeName(property)
+        )
+      );
+    }
+    source.$fastController.addBehaviors(this.bindingBehaviours);
+  }
+  releasePropertyBindings(source) {
+    source.$fastController.removeBehaviors(this.bindingBehaviours);
+    this.bindingBehaviours = [];
+  }
+}
+
+function applyHostSemantics(boundProperties = {}) {
+  const forwardedProperties = new Set(
+    ariaMixinProperties.filter((p) => !(p in boundProperties))
+  );
+  return new AttachedBehaviorHTMLDirective(
+    "vvd-host-semantics",
+    HostSemanticsBehavior,
+    {
+      boundProperties,
+      forwardedProperties
+    }
+  );
+}
+const HostSemantics = (Base) => {
+  class HostSemanticsElement extends Base {
+    constructor() {
+      super(...arguments);
+      this._vividAriaBehaviour = "host";
+    }
+  }
+  return HostSemanticsElement;
+};
+
+export { HostSemantics as H, applyHostSemantics as a };

package/shared/localization/Locale.d.ts

@@ -14,6 +14,7 @@ import type { TabLocale } from '../../lib/tab/locale';
 import type { SearchableSelectLocale } from '../../lib/searchable-select/locale';
 import type { PickerFieldLocale } from '../picker-field/locale';
 import type { DateTimePickerLocale } from '../../lib/date-time-picker/locale';
+import type { RichTextEditorLocale } from '../../lib/rich-text-editor/locale';
 export interface Locale {
     lang: string;
     common: {
@@ -35,4 +36,5 @@ export interface Locale {
     dialPad: DialPadLocale;
     tab: TabLocale;
     searchableSelect: SearchableSelectLocale;
+    richTextEditor: RichTextEditorLocale;
 }

package/shared/option.cjs

@@ -2,6 +2,7 @@
 
 const affix = require('./affix.cjs');
 const vividElement = require('./vivid-element.cjs');
+const hostSemantics = require('./host-semantics.cjs');
 const dom = require('./dom.cjs');
 
 var __defProp = Object.defineProperty;
@@ -17,7 +18,9 @@ var __decorateClass = (decorators, target, key, kind) => {
 function isListboxOption(el) {
   return dom.isHTMLElement(el) && (el.getAttribute("role") === "option" || el instanceof HTMLOptionElement);
 }
-class ListboxOption extends affix.AffixIconWithTrailing(vividElement.VividElement) {
+class ListboxOption extends hostSemantics.HostSemantics(
+  affix.AffixIconWithTrailing(vividElement.VividElement)
+) {
   constructor(text, value, defaultSelected, selected) {
     super();
     this.defaultSelected = false;

package/shared/option.js

@@ -1,5 +1,6 @@
 import { A as AffixIconWithTrailing } from './affix.js';
 import { O as Observable, V as VividElement, o as observable, a as attr, v as volatile } from './vivid-element.js';
+import { H as HostSemantics } from './host-semantics.js';
 import { i as isHTMLElement } from './dom.js';
 
 var __defProp = Object.defineProperty;
@@ -15,7 +16,9 @@ var __decorateClass = (decorators, target, key, kind) => {
 function isListboxOption(el) {
   return isHTMLElement(el) && (el.getAttribute("role") === "option" || el instanceof HTMLOptionElement);
 }
-class ListboxOption extends AffixIconWithTrailing(VividElement) {
+class ListboxOption extends HostSemantics(
+  AffixIconWithTrailing(VividElement)
+) {
   constructor(text, value, defaultSelected, selected) {
     super();
     this.defaultSelected = false;

package/shared/patterns/affix.d.ts

@@ -6,6 +6,13 @@ export declare const AffixIcon: <T extends Constructor<VividElement>>(Base: T) =
     new (...args: any[]): {
         icon?: string | undefined;
         iconSlottedContent?: HTMLElement[] | undefined;
+        specialHandling: boolean;
+        _vividAriaBehaviour: import("../aria/aria-mixin").VividAriaBehaviour;
+        readonly $fastController: import("@microsoft/fast-element").Controller;
+        $emit(type: string, detail?: any, options?: Omit<CustomEventInit<any>, "detail"> | undefined): boolean | void;
+        connectedCallback(): void;
+        disconnectedCallback(): void;
+        attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
         accessKey: string;
         readonly accessKeyLabel: string;
         autocapitalize: string;
@@ -322,11 +329,10 @@ export declare const AffixIcon: <T extends Constructor<VividElement>>(Base: T) =
         tabIndex: number;
         blur(): void;
         focus(options?: FocusOptions | undefined): void;
-        readonly $fastController: import("@microsoft/fast-element").Controller;
-        $emit(type: string, detail?: any, options?: Omit<CustomEventInit<any>, "detail"> | undefined): boolean | void;
-        connectedCallback(): void;
-        disconnectedCallback(): void;
-        attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+        ariaColIndexText: string | null;
+        ariaDescription: string | null;
+        ariaRowIndexText: string | null;
+        ariaRelevant: string | null;
     };
 } & T;
 export type AffixIconElement = MixinType<typeof AffixIcon>;
@@ -335,6 +341,13 @@ export declare const AffixIconWithTrailing: <T extends Constructor<VividElement>
         iconTrailing: boolean;
         icon?: string | undefined;
         iconSlottedContent?: HTMLElement[] | undefined;
+        specialHandling: boolean;
+        _vividAriaBehaviour: import("../aria/aria-mixin").VividAriaBehaviour;
+        readonly $fastController: import("@microsoft/fast-element").Controller;
+        $emit(type: string, detail?: any, options?: Omit<CustomEventInit<any>, "detail"> | undefined): boolean | void;
+        connectedCallback(): void;
+        disconnectedCallback(): void;
+        attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
         accessKey: string;
         readonly accessKeyLabel: string;
         autocapitalize: string;
@@ -651,11 +664,10 @@ export declare const AffixIconWithTrailing: <T extends Constructor<VividElement>
         tabIndex: number;
         blur(): void;
         focus(options?: FocusOptions | undefined): void;
-        readonly $fastController: import("@microsoft/fast-element").Controller;
-        $emit(type: string, detail?: any, options?: Omit<CustomEventInit<any>, "detail"> | undefined): boolean | void;
-        connectedCallback(): void;
-        disconnectedCallback(): void;
-        attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+        ariaColIndexText: string | null;
+        ariaDescription: string | null;
+        ariaRowIndexText: string | null;
+        ariaRelevant: string | null;
     };
 } & T;
 export declare const IconWrapper: {

package/shared/patterns/anchored.d.ts

@@ -14,6 +14,11 @@ export declare const Anchored: <T extends Constructor<VividElement>>(Base: T) =>
         "__#7@#cleanupObserverIfNeeded": () => void;
         connectedCallback(): void;
         disconnectedCallback(): void;
+        specialHandling: boolean;
+        _vividAriaBehaviour: import("../aria/aria-mixin").VividAriaBehaviour;
+        readonly $fastController: import("@microsoft/fast-element").Controller;
+        $emit(type: string, detail?: any, options?: Omit<CustomEventInit<any>, "detail"> | undefined): boolean | void;
+        attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
         accessKey: string;
         readonly accessKeyLabel: string;
         autocapitalize: string;
@@ -330,9 +335,10 @@ export declare const Anchored: <T extends Constructor<VividElement>>(Base: T) =>
         tabIndex: number;
         blur(): void;
         focus(options?: FocusOptions | undefined): void;
-        readonly $fastController: import("@microsoft/fast-element").Controller;
-        $emit(type: string, detail?: any, options?: Omit<CustomEventInit<any>, "detail"> | undefined): boolean | void;
-        attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+        ariaColIndexText: string | null;
+        ariaDescription: string | null;
+        ariaRowIndexText: string | null;
+        ariaRelevant: string | null;
     };
 } & T;
 export type AnchoredElement = MixinType<typeof Anchored>;
@@ -348,6 +354,11 @@ export declare const anchorSlotTemplateFactory: () => import("@microsoft/fast-el
     "__#7@#cleanupObserverIfNeeded": () => void;
     connectedCallback(): void;
     disconnectedCallback(): void;
+    specialHandling: boolean;
+    _vividAriaBehaviour: import("../aria/aria-mixin").VividAriaBehaviour;
+    readonly $fastController: import("@microsoft/fast-element").Controller;
+    $emit(type: string, detail?: any, options?: Omit<CustomEventInit<any>, "detail"> | undefined): boolean | void;
+    attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
     accessKey: string;
     readonly accessKeyLabel: string;
     autocapitalize: string;
@@ -664,8 +675,9 @@ export declare const anchorSlotTemplateFactory: () => import("@microsoft/fast-el
     tabIndex: number;
     blur(): void;
     focus(options?: FocusOptions | undefined): void;
-    readonly $fastController: import("@microsoft/fast-element").Controller;
-    $emit(type: string, detail?: any, options?: Omit<CustomEventInit<any>, "detail"> | undefined): boolean | void;
-    attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+    ariaColIndexText: string | null;
+    ariaDescription: string | null;
+    ariaRowIndexText: string | null;
+    ariaRelevant: string | null;
 } & VividElement, any>;
 export {};

package/shared/patterns/localized.d.ts

@@ -4,6 +4,13 @@ import type { Locale } from '../localization/Locale';
 export declare const Localized: <T extends Constructor<VividElement>>(Base: T) => {
     new (...args: any[]): {
         readonly locale: Locale;
+        specialHandling: boolean;
+        _vividAriaBehaviour: import("../aria/aria-mixin").VividAriaBehaviour;
+        readonly $fastController: import("@microsoft/fast-element").Controller;
+        $emit(type: string, detail?: any, options?: Omit<CustomEventInit<any>, "detail"> | undefined): boolean | void;
+        connectedCallback(): void;
+        disconnectedCallback(): void;
+        attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
         accessKey: string;
         readonly accessKeyLabel: string;
         autocapitalize: string;
@@ -320,10 +327,9 @@ export declare const Localized: <T extends Constructor<VividElement>>(Base: T) =
         tabIndex: number;
         blur(): void;
         focus(options?: FocusOptions | undefined): void;
-        readonly $fastController: import("@microsoft/fast-element").Controller;
-        $emit(type: string, detail?: any, options?: Omit<CustomEventInit<any>, "detail"> | undefined): boolean | void;
-        connectedCallback(): void;
-        disconnectedCallback(): void;
-        attributeChangedCallback(name: string, oldValue: string, newValue: string): void;
+        ariaColIndexText: string | null;
+        ariaDescription: string | null;
+        ariaRowIndexText: string | null;
+        ariaRelevant: string | null;
     };
 } & T;