@nectary/components 2.4.0

package/checkbox/types.d.ts

@@ -0,0 +1,49 @@
+import type { TSinchElementReact } from '../types';
+export type TSinchCheckboxElement = HTMLElement & {
+    /** Value */
+    checked: boolean;
+    /** Indeterminate */
+    indeterminate: boolean;
+    /** Disabled */
+    disabled: boolean;
+    /** Invalid */
+    invalid: boolean;
+    /** Text */
+    text: string | null;
+    /** Change value event */
+    addEventListener(type: '-change', listener: (e: CustomEvent<boolean>) => void): void;
+    /** Focus event */
+    addEventListener(type: '-focus', listener: (e: CustomEvent<void>) => void): void;
+    /** Blur event */
+    addEventListener(type: '-blur', listener: (e: CustomEvent<void>) => void): void;
+    /** Checked */
+    setAttribute(name: 'checked', value: ''): void;
+    /** Indeterminate */
+    setAttribute(name: 'indeterminate', value: ''): void;
+    /** Disabled */
+    setAttribute(name: 'disabled', value: ''): void;
+    /** Invalid */
+    setAttribute(name: 'invalid', value: ''): void;
+    /** Text */
+    setAttribute(name: 'text', value: string): void;
+};
+export type TSinchCheckboxReact = TSinchElementReact<TSinchCheckboxElement> & {
+    /** Checked */
+    checked?: boolean;
+    /** Indeterminate */
+    indeterminate?: boolean;
+    /** Disabled */
+    disabled?: boolean;
+    /** Invalid */
+    invalid?: boolean;
+    /** Text */
+    text?: string;
+    /** Label that is used for a11y – might be different from `label` */
+    'aria-label': string;
+    /** Change value handler */
+    'on-change'?: (e: CustomEvent<boolean>) => void;
+    /** Focus handler */
+    'on-focus'?: (e: CustomEvent<void>) => void;
+    /** Blur handler */
+    'on-blur'?: (e: CustomEvent<void>) => void;
+};

package/checkbox/types.js

@@ -0,0 +1 @@
+export {};

package/chip/index.d.ts

@@ -0,0 +1,13 @@
+import '../text';
+import '../icon';
+import type { TSinchChipElement, TSinchChipReact } from './types';
+declare global {
+    namespace JSX {
+        interface IntrinsicElements {
+            'sinch-chip': TSinchChipReact;
+        }
+    }
+    interface HTMLElementTagNameMap {
+        'sinch-chip': TSinchChipElement;
+    }
+}

package/chip/index.js

@@ -0,0 +1,144 @@
+import '../text';
+import '../icon';
+import { defineCustomElement, getBooleanAttribute, getAttribute, updateBooleanAttribute, updateAttribute, NectaryElement, getReactEventHandler, isAttrTrue, isAttrEqual } from '../utils';
+const templateHTML = '<style>:host{display:inline-block;vertical-align:middle;outline:0;cursor:pointer}#button{all:initial;position:relative;display:flex;flex-direction:row;align-items:center;gap:4px;width:100%;height:var(--sinch-comp-chip-size-container-m);padding:0 5px 0 9px;border-radius:var(--sinch-comp-chip-shape-radius);background-color:var(--sinch-comp-chip-color-neutral-default-background-initial);box-sizing:border-box;--sinch-global-color-text:var(--sinch-comp-chip-color-neutral-default-foreground-initial);--sinch-global-color-icon:var(--sinch-comp-chip-color-neutral-default-foreground-initial);--sinch-global-size-icon:var(--sinch-comp-chip-size-icon-m)}:host(:focus-visible)>#button::after{content:"";position:absolute;inset:-4px;border-radius:calc(var(--sinch-comp-chip-shape-radius) + 4px);border:2px solid var(--sinch-comp-chip-color-outiline-focus);pointer-events:none}#text{flex:1;--sinch-comp-text-font:var(--sinch-comp-chip-font-size-m-label)}:host([small]) #button{height:var(--sinch-comp-chip-size-container-s);padding:0 3px 0 7px;--sinch-global-size-icon:var(--sinch-comp-chip-size-icon-s)}:host([small]) #text{--sinch-comp-text-font:var(--sinch-comp-chip-font-size-s-label)}::slotted([slot=icon]){margin-left:-4px}</style><div id="button" inert><slot name="icon"></slot><sinch-text id="text" type="xs" ellipsis></sinch-text><slot name="right-icon"><sinch-icon id="icon-close" name="cancel"></sinch-icon></slot></div>';
+import { getChipColorBg, getChipColorFg } from './utils';
+const template = document.createElement('template');
+template.innerHTML = templateHTML;
+defineCustomElement('sinch-chip', class extends NectaryElement {
+  #$text;
+  #$button;
+  #controller = null;
+  constructor() {
+    super();
+    const shadowRoot = this.attachShadow();
+    shadowRoot.appendChild(template.content.cloneNode(true));
+    this.#$button = shadowRoot.querySelector('#button');
+    this.#$text = shadowRoot.querySelector('#text');
+  }
+  connectedCallback() {
+    super.connectedCallback();
+    this.#controller = new AbortController();
+    const {
+      signal
+    } = this.#controller;
+    this.role = 'button';
+    this.tabIndex = 0;
+    this.addEventListener('click', this.#onClick, {
+      signal
+    });
+    this.addEventListener('focus', this.#onFocus, {
+      signal
+    });
+    this.addEventListener('blur', this.#onBlur, {
+      signal
+    });
+    this.addEventListener('keydown', this.#onKeydown, {
+      signal
+    });
+    this.addEventListener('-click', this.#onClickReactHandler, {
+      signal
+    });
+    this.addEventListener('-focus', this.#onFocusReactHandler, {
+      signal
+    });
+    this.addEventListener('-blur', this.#onBlurReactHandler, {
+      signal
+    });
+    this.#updateColor();
+  }
+  disconnectedCallback() {
+    super.disconnectedCallback();
+    this.#controller.abort();
+    this.#controller = null;
+  }
+  static get observedAttributes() {
+    return ['text', 'color', 'small'];
+  }
+  attributeChangedCallback(name, oldVal, newVal) {
+    if (isAttrEqual(oldVal, newVal)) {
+      return;
+    }
+    switch (name) {
+      case 'color':
+        {
+          this.#updateColor();
+          break;
+        }
+      case 'text':
+        {
+          this.#$text.textContent = newVal;
+          break;
+        }
+      case 'small':
+        {
+          updateBooleanAttribute(this, name, isAttrTrue(newVal));
+          break;
+        }
+    }
+  }
+  get color() {
+    return getAttribute(this, 'color');
+  }
+  set color(value) {
+    updateAttribute(this, 'color', value);
+  }
+  get text() {
+    return getAttribute(this, 'text', '');
+  }
+  set text(value) {
+    updateAttribute(this, 'text', value);
+  }
+  get small() {
+    return getBooleanAttribute(this, 'small');
+  }
+  set small(isSmall) {
+    updateBooleanAttribute(this, 'small', isSmall);
+  }
+  #updateColor() {
+    if (!this.isDomConnected) {
+      return;
+    }
+    const colorName = this.color;
+    if (colorName !== null && colorName.length > 0) {
+      const bg = getChipColorBg(colorName);
+      const fg = getChipColorFg(colorName);
+      this.#$button.style.setProperty('background-color', bg);
+      this.#$button.style.setProperty('--sinch-global-color-text', fg);
+      this.#$button.style.setProperty('--sinch-global-color-icon', fg);
+    } else {
+      this.#$button.style.removeProperty('background-color');
+      this.#$button.style.removeProperty('--sinch-global-color-text');
+      this.#$button.style.removeProperty('--sinch-global-color-icon');
+    }
+  }
+  get focusable() {
+    return true;
+  }
+  #onKeydown = e => {
+    switch (e.code) {
+      case 'Space':
+        {
+          this.click();
+        }
+    }
+  };
+  #onClick = () => {
+    this.dispatchEvent(new CustomEvent('-click'));
+  };
+  #onFocus = () => {
+    this.dispatchEvent(new CustomEvent('-focus'));
+  };
+  #onBlur = () => {
+    this.dispatchEvent(new CustomEvent('-blur'));
+  };
+  #onFocusReactHandler = () => {
+    getReactEventHandler(this, 'on-focus')?.();
+  };
+  #onBlurReactHandler = () => {
+    getReactEventHandler(this, 'on-blur')?.();
+  };
+  #onClickReactHandler = e => {
+    getReactEventHandler(this, 'on-click')?.(e);
+  };
+});

package/chip/types.d.ts

@@ -0,0 +1,37 @@
+import type { TSinchElementReact } from '../types';
+export type TSinchChipElement = HTMLElement & {
+    /** Text */
+    text: string;
+    /** Color, gray by default */
+    color: string | null;
+    /** Small */
+    small: boolean;
+    /** Click event */
+    addEventListener(type: '-click', listener: (e: CustomEvent<void>) => void): void;
+    /** Focus event */
+    addEventListener(type: '-focus', listener: (e: CustomEvent<void>) => void): void;
+    /** Blur event */
+    addEventListener(type: '-blur', listener: (e: CustomEvent<void>) => void): void;
+    /** Text */
+    setAttribute(name: 'text', value: string): void;
+    /** Color, gray by default */
+    setAttribute(name: 'color', value: string): void;
+    /** Small */
+    setAttribute(name: 'small', value: ''): void;
+};
+export type TSinchChipReact = TSinchElementReact<TSinchChipElement> & {
+    /** Text */
+    text: string;
+    /** Color, gray by default */
+    color?: string;
+    /** Small */
+    small?: boolean;
+    /** Click event handler */
+    'on-click'?: (e: CustomEvent<void>) => void;
+    /** Focus event handler */
+    'on-focus'?: (e: CustomEvent<void>) => void;
+    /** Blur event handler */
+    'on-blur'?: (e: CustomEvent<void>) => void;
+    /** Label that is used for a11y` */
+    'aria-label': string;
+};

package/chip/types.js

@@ -0,0 +1 @@
+export {};

package/chip/utils.d.ts

@@ -0,0 +1,2 @@
+export declare const getChipColorBg: (id: string) => string;
+export declare const getChipColorFg: (id: string) => string;

package/chip/utils.js

@@ -0,0 +1,6 @@
+export const getChipColorBg = id => {
+  return `var(--sinch-comp-chip-color-${id}-default-background-initial)`;
+};
+export const getChipColorFg = id => {
+  return `var(--sinch-comp-chip-color-${id}-default-foreground-initial)`;
+};

package/code-tag/index.d.ts

@@ -0,0 +1,11 @@
+import type { TSinchCodeTagElement, TSinchCodeTagReact } from './types';
+declare global {
+    namespace JSX {
+        interface IntrinsicElements {
+            'sinch-code-tag': TSinchCodeTagReact;
+        }
+    }
+    interface HTMLElementTagNameMap {
+        'sinch-code-tag': TSinchCodeTagElement;
+    }
+}

package/code-tag/index.js

@@ -0,0 +1,31 @@
+import { defineCustomElement, getAttribute, updateAttribute, NectaryElement } from '../utils';
+const templateHTML = '<style>:host{display:inline}#content{font:var(--sinch-comp-code-tag-font-text);font-size:inherit;line-height:inherit;color:var(--sinch-comp-code-tag-color-default-text-initial);border:1px solid var(--sinch-comp-code-tag-color-default-border-initial);background-color:var(--sinch-comp-code-tag-color-default-background-initial);padding:0 .25em;border-radius:var(--sinch-comp-code-tag-shape-radius);white-space:var(--sinch-global-text-white-space,normal)}</style><span id="content"></span>';
+const template = document.createElement('template');
+template.innerHTML = templateHTML;
+defineCustomElement('sinch-code-tag', class extends NectaryElement {
+  #$text;
+  constructor() {
+    super();
+    const shadowRoot = this.attachShadow();
+    shadowRoot.appendChild(template.content.cloneNode(true));
+    this.#$text = shadowRoot.querySelector('#content');
+  }
+  static get observedAttributes() {
+    return ['text'];
+  }
+  attributeChangedCallback(name, oldVal, newVal) {
+    switch (name) {
+      case 'text':
+        {
+          this.#$text.textContent = newVal;
+          break;
+        }
+    }
+  }
+  get text() {
+    return getAttribute(this, 'text', '');
+  }
+  set text(value) {
+    updateAttribute(this, 'text', value);
+  }
+});

package/code-tag/types.d.ts

@@ -0,0 +1,11 @@
+import type { TSinchElementReact } from '../types';
+export type TSinchCodeTagElement = HTMLElement & {
+    /** Text content of hyperlink */
+    text: string;
+    /** Text content of hyperlink */
+    setAttribute(name: 'text', value: string): void;
+};
+export type TSinchCodeTagReact = TSinchElementReact<TSinchCodeTagElement> & {
+    /** Text content of hyperlink */
+    text: string;
+};

package/code-tag/types.js

@@ -0,0 +1 @@
+export {};

package/color-menu/index.d.ts

@@ -0,0 +1,11 @@
+import type { TSinchColorMenuElement, TSinchColorMenuReact } from './types';
+declare global {
+    namespace JSX {
+        interface IntrinsicElements {
+            'sinch-color-menu': TSinchColorMenuReact;
+        }
+    }
+    interface HTMLElementTagNameMap {
+        'sinch-color-menu': TSinchColorMenuElement;
+    }
+}

package/color-menu/index.js

@@ -0,0 +1,308 @@
+import { attrValueToPixels, defineCustomElement, getAttribute, getBooleanAttribute, getIntegerAttribute, getReactEventHandler, getRect, NectaryElement, updateAttribute, updateBooleanAttribute, updateExplicitBooleanAttribute, updateIntegerAttribute, subscribeContext, getTargetByAttribute } from '../utils';
+const templateHTML = '<style>:host{display:block;outline:0}#listbox{display:flex;flex-direction:row;flex-wrap:wrap;padding:4px 10px;overflow-y:auto}#listbox.empty{display:none}</style><div id="listbox" role="presentation"><slot id="options"></slot></div>';
+const NUM_COLS_DEFAULT = 5;
+const ITEM_WIDTH = 44;
+const ITEM_HEIGHT = 56;
+const template = document.createElement('template');
+template.innerHTML = templateHTML;
+defineCustomElement('sinch-color-menu', class extends NectaryElement {
+  #$listbox;
+  #$optionsSlot;
+  #controller = null;
+  constructor() {
+    super();
+    const shadowRoot = this.attachShadow();
+    shadowRoot.appendChild(template.content.cloneNode(true));
+    this.#$listbox = shadowRoot.querySelector('#listbox');
+    this.#$optionsSlot = shadowRoot.querySelector('#options');
+  }
+  connectedCallback() {
+    super.connectedCallback();
+    this.#controller = new AbortController();
+    const {
+      signal
+    } = this.#controller;
+    const options = {
+      signal
+    };
+    this.role = 'listbox';
+    this.tabIndex = 0;
+    this.addEventListener('keydown', this.#onListboxKeyDown, options);
+    this.addEventListener('blur', this.#onListboxBlur, options);
+    this.#$listbox.addEventListener('click', this.#onListboxClick, options);
+    this.#$optionsSlot.addEventListener('slotchange', this.#onSlotChange, options);
+    this.addEventListener('-change', this.#onChangeReactHandler, options);
+    subscribeContext(this, 'keydown', this.#onContextKeyDown, signal);
+    subscribeContext(this, 'visibility', this.#onContextVisibility, signal);
+    this.#onSlotChange();
+  }
+  disconnectedCallback() {
+    super.disconnectedCallback();
+    this.#controller.abort();
+    this.#controller = null;
+  }
+  static get observedAttributes() {
+    return ['value', 'rows', 'cols'];
+  }
+  attributeChangedCallback(name) {
+    switch (name) {
+      case 'value':
+        {
+          if (this.isDomConnected) {
+            this.#onValueChange();
+          }
+          break;
+        }
+      case 'rows':
+        {
+          this.#updateRows();
+          break;
+        }
+      case 'cols':
+        {
+          if (this.isDomConnected) {
+            this.#updateColumns();
+          }
+          break;
+        }
+    }
+  }
+  set value(value) {
+    updateAttribute(this, 'value', value);
+  }
+  get value() {
+    return getAttribute(this, 'value', '');
+  }
+  set colors(value) {
+    updateAttribute(this, 'colors', value);
+  }
+  get colors() {
+    return getAttribute(this, 'colors');
+  }
+  set rows(value) {
+    updateIntegerAttribute(this, 'rows', value);
+  }
+  get rows() {
+    return getIntegerAttribute(this, 'rows', null);
+  }
+  set cols(value) {
+    updateIntegerAttribute(this, 'cols', value);
+  }
+  get cols() {
+    return getIntegerAttribute(this, 'cols', null);
+  }
+  get focusable() {
+    return true;
+  }
+  nthItemRect(index) {
+    const $item = this.#getOptionElements()[index];
+    if ($item != null) {
+      return getRect($item);
+    }
+    return null;
+  }
+  #onSlotChange = () => {
+    this.#updateColumns();
+    this.#onValueChange();
+  };
+  #updateRows() {
+    const rowsValue = getAttribute(this, 'rows');
+    this.#$listbox.style.maxHeight = attrValueToPixels(rowsValue, {
+      min: 2,
+      itemSizeMultiplier: ITEM_HEIGHT
+    });
+  }
+  #updateColumns() {
+    const colsValue = getAttribute(this, 'cols');
+    const numItems = this.#getOptionElements().length;
+    this.#$listbox.style.width = attrValueToPixels(colsValue, {
+      min: 1,
+      max: numItems,
+      defaultValue: Math.min(numItems, NUM_COLS_DEFAULT),
+      itemSizeMultiplier: ITEM_WIDTH
+    });
+  }
+  #onListboxBlur = () => {
+    this.#selectOption(null);
+  };
+  #onListboxClick = e => {
+    const target = getTargetByAttribute(e, 'value');
+    if (target === null) {
+      return;
+    }
+    this.focus();
+    this.#dispatchChangeEvent(target);
+  };
+  #onContextVisibility = e => {
+    if (e.detail) {
+      this.#selectOption(this.#findCheckedOption());
+    } else {
+      this.#selectOption(null);
+    }
+  };
+  #onContextKeyDown = e => {
+    this.#handleKeydown(e.detail);
+  };
+  #onListboxKeyDown = e => {
+    this.#handleKeydown(e);
+  };
+  #handleKeydown(e) {
+    switch (e.code) {
+      case 'Space':
+      case 'Enter':
+        {
+          e.preventDefault();
+          const $option = this.#findSelectedOption();
+          if ($option !== null) {
+            this.#dispatchChangeEvent($option);
+          }
+          break;
+        }
+      case 'ArrowLeft':
+        {
+          e.preventDefault();
+          this.#selectOption(this.#getPrevOption());
+          break;
+        }
+      case 'ArrowRight':
+        {
+          e.preventDefault();
+          this.#selectOption(this.#getNextOption());
+          break;
+        }
+      case 'ArrowDown':
+        {
+          e.preventDefault();
+          this.#selectOption(this.#getNextRowOption());
+          break;
+        }
+      case 'ArrowUp':
+        {
+          e.preventDefault();
+          this.#selectOption(this.#getPrevRowOption());
+          break;
+        }
+    }
+  }
+  #onValueChange() {
+    const value = this.value;
+    for (const $option of this.#getOptionElements()) {
+      const isChecked = value === getAttribute($option, 'value', '');
+      updateBooleanAttribute($option, 'data-checked', isChecked);
+      updateBooleanAttribute($option, 'data-selected', isChecked);
+      updateExplicitBooleanAttribute($option, 'aria-selected', isChecked);
+    }
+  }
+  #getFirstOption() {
+    const $options = this.#getOptionElements();
+    return $options[0] ?? null;
+  }
+  #getLastOption() {
+    const $options = this.#getOptionElements();
+    return $options[$options.length - 1] ?? null;
+  }
+  #getNextOption() {
+    const index = this.#getSelectedOptionIndex();
+    if (index !== null) {
+      const $options = this.#getOptionElements();
+      return $options[(1 + index) % $options.length];
+    }
+    return this.#getFirstOption();
+  }
+  #getPrevOption() {
+    const index = this.#getSelectedOptionIndex();
+    if (index !== null) {
+      const $options = this.#getOptionElements();
+      return $options[(index - 1 + $options.length) % $options.length];
+    }
+    return this.#getLastOption();
+  }
+  #getNextRowOption() {
+    const selectedIndex = this.#getSelectedOptionIndex();
+    if (selectedIndex !== null) {
+      const $options = this.#getOptionElements();
+      const numCols = Math.min(this.cols ?? NUM_COLS_DEFAULT, $options.length);
+      const numColsInLastRow = $options.length % numCols;
+      if (numColsInLastRow > 0) {
+        if (selectedIndex < $options.length - numCols) {
+          return $options[selectedIndex + numCols];
+        }
+        if (numColsInLastRow > 0 && selectedIndex < $options.length - numColsInLastRow) {
+          return $options[$options.length - 1];
+        }
+        return $options[selectedIndex + numColsInLastRow - $options.length];
+      }
+      return $options[(selectedIndex + numCols) % $options.length];
+    }
+    return this.#getFirstOption();
+  }
+  #getPrevRowOption() {
+    const selectedIndex = this.#getSelectedOptionIndex();
+    if (selectedIndex !== null) {
+      const $options = this.#getOptionElements();
+      const numCols = Math.min(this.cols ?? NUM_COLS_DEFAULT, $options.length);
+      const numColsInLastRow = $options.length % numCols;
+      if (selectedIndex < numColsInLastRow) {
+        return $options[(selectedIndex - numColsInLastRow + $options.length) % $options.length];
+      }
+      if (selectedIndex < numCols) {
+        return $options[(selectedIndex - numCols - numColsInLastRow + $options.length) % $options.length];
+      }
+      return $options[(selectedIndex - numCols + $options.length) % $options.length];
+    }
+    return this.#getFirstOption();
+  }
+  #selectOption($option) {
+    const hasRows = this.hasAttribute('rows');
+    for (const $op of this.#getOptionElements()) {
+      const isSelected = $op === $option;
+      updateBooleanAttribute($op, 'data-selected', isSelected);
+      if (isSelected && hasRows) {
+        $op.scrollIntoView?.({
+          block: 'nearest'
+        });
+      }
+    }
+  }
+  #getOptionElements() {
+    return this.#$optionsSlot.assignedElements();
+  }
+  #getSelectedOptionIndex() {
+    const elements = this.#getOptionElements();
+    for (let i = 0; i < elements.length; i++) {
+      const el = elements[i];
+      if (getBooleanAttribute(el, 'data-selected')) {
+        return i;
+      }
+    }
+    return null;
+  }
+  #findSelectedOption() {
+    const elements = this.#getOptionElements();
+    for (const el of elements) {
+      if (getBooleanAttribute(el, 'data-selected')) {
+        return el;
+      }
+    }
+    return null;
+  }
+  #findCheckedOption() {
+    const elements = this.#getOptionElements();
+    const value = this.value;
+    for (const $el of elements) {
+      if (getAttribute($el, 'value') === value) {
+        return $el;
+      }
+    }
+    return null;
+  }
+  #dispatchChangeEvent($opt) {
+    const value = getAttribute($opt, 'value', '');
+    this.dispatchEvent(new CustomEvent('-change', {
+      detail: value
+    }));
+  }
+  #onChangeReactHandler = e => {
+    getReactEventHandler(this, 'on-change')?.(e);
+  };
+});

package/color-menu/types.d.ts

@@ -0,0 +1,32 @@
+import type { TRect, TSinchElementReact } from '../types';
+export type TSinchColorMenuElement = HTMLElement & {
+    /** Value */
+    value: string;
+    /** How many rows to show and scroll the rest */
+    rows: number | null;
+    /** How many cols to show and scroll the rest */
+    cols: number | null;
+    nthItemRect(index: number): TRect | null;
+    /** Change event */
+    addEventListener(type: '-change', listener: (e: CustomEvent<string>) => void): void;
+    /** Comma-separated color names, all colors by default */
+    setAttribute(name: 'colors', value: string): void;
+    /** Value */
+    setAttribute(name: 'value', value: string): void;
+    /** How many rows to show and scroll the rest */
+    setAttribute(name: 'rows', value: string): void;
+    /** How many cols to show and scroll the rest */
+    setAttribute(name: 'cols', value: string): void;
+};
+export type TSinchColorMenuReact = TSinchElementReact<TSinchColorMenuElement> & {
+    /** Value */
+    value: string;
+    /** How many rows to show and scroll the rest */
+    rows?: number;
+    /** How many cols to show and scroll the rest */
+    cols?: number;
+    /** Label that is used for a11y */
+    'aria-label': string;
+    /** Change event handler */
+    'on-change'?: (e: CustomEvent<string>) => void;
+};

package/color-menu/types.js

@@ -0,0 +1 @@
+export {};

package/color-menu/utils.d.ts

@@ -0,0 +1 @@
+export declare const getParentOption: ($element: Element) => Element | null;