@nectary/components 0.39.0 → 0.41.0

package/color-menu/index.js

@@ -0,0 +1,450 @@
+import '../color-swatch';
+import '../tooltip';
+import '../icons/check';
+import { attrValueToPixels, defineCustomElement, getAttribute, getBooleanAttribute, getCsvSet, getIntegerAttribute, getReactEventHandler, getRect, NectaryElement, updateAttribute, updateBooleanAttribute, updateExplicitBooleanAttribute, updateIntegerAttribute } from '../utils';
+import { lightColorNames, darkColorNames, vibrantColorNames, NO_COLOR } from '../utils/colors';
+import { dispatchContextConnectEvent, dispatchContextDisconnectEvent } from '../utils/context';
+const optionTemplateHTML = '<div class="option" role="option"><sinch-tooltip inverted class="tooltip"><div class="swatch-wrapper"><sinch-color-swatch class="swatch"></sinch-color-swatch><sinch-icon-check class="check"></sinch-icon-check></div></sinch-tooltip></div>';
+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}.option{padding:12px 6px;--sinch-color-icon:var(--sinch-color-stormy-500)}.swatch-wrapper{position:relative;cursor:pointer;width:32px;height:32px}.swatch-wrapper::after{content:"";position:absolute;width:34px;height:34px;inset:-3px;border:2px solid transparent;border-radius:50%;pointer-events:none}.option[data-selected]:not([data-checked]) .swatch-wrapper::after{border-color:var(--sinch-color-border-focus)}.check{display:none;position:absolute;left:4px;top:4px;pointer-events:none;--sinch-size-icon:24px}.option[data-checked] .check{display:block}</style><div id="listbox" role="presentation"></div>';
+import { getParentOption } from './utils';
+const NUM_COLS_DEFAULT = 5;
+const ITEM_WIDTH = 44;
+const ITEM_HEIGHT = 56;
+const template = document.createElement('template');
+const optionTemplate = document.createElement('template');
+template.innerHTML = templateHTML;
+optionTemplate.innerHTML = optionTemplateHTML;
+defineCustomElement('sinch-color-menu', class extends NectaryElement {
+  #$listbox;
+  #controller = null;
+  #prevColorsValue = '';
+  #isConnected = false;
+
+  constructor() {
+    super();
+    const shadowRoot = this.attachShadow();
+    shadowRoot.appendChild(template.content.cloneNode(true));
+    this.#$listbox = shadowRoot.querySelector('#listbox');
+  }
+
+  connectedCallback() {
+    this.#controller = new AbortController();
+    const {
+      signal
+    } = this.#controller;
+    this.setAttribute('role', 'listbox');
+    this.setAttribute('tabindex', '0');
+    this.addEventListener('keydown', this.#onListboxKeyDown, {
+      signal
+    });
+    this.addEventListener('-keydown', this.#onContexKeydown, {
+      signal
+    });
+    this.addEventListener('blur', this.#onListboxBlur, {
+      signal
+    });
+    this.#$listbox.addEventListener('click', this.#onListboxClick, {
+      signal
+    });
+    this.addEventListener('-change', this.#onChangeReactHandler, {
+      signal
+    });
+    this.addEventListener('-visibility', this.#onContextVisibility, {
+      signal
+    });
+    dispatchContextConnectEvent(this, 'visibility');
+    dispatchContextConnectEvent(this, 'keydown');
+    requestAnimationFrame(this.#onMount);
+  }
+
+  disconnectedCallback() {
+    this.#isConnected = false;
+    this.#prevColorsValue = null;
+    dispatchContextDisconnectEvent(this, 'visibility');
+    dispatchContextDisconnectEvent(this, 'keydown');
+    this.#controller.abort();
+  }
+
+  static get observedAttributes() {
+    return ['value', 'rows', 'cols', 'colors'];
+  }
+
+  set value(value) {
+    updateAttribute(this, 'value', value);
+  }
+
+  get value() {
+    return getAttribute(this, 'value', NO_COLOR);
+  }
+
+  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.#$listbox.children[index];
+
+    if ($item != null) {
+      return getRect($item);
+    }
+
+    return null;
+  }
+
+  attributeChangedCallback(name, oldVal, newVal) {
+    if (oldVal === newVal) {
+      return;
+    }
+
+    switch (name) {
+      case 'value':
+        {
+          if (this.#isConnected) {
+            this.#onValueChange();
+          }
+
+          break;
+        }
+
+      case 'colors':
+        {
+          if (this.#isConnected) {
+            this.#updateColors();
+          }
+
+          break;
+        }
+
+      case 'rows':
+        {
+          this.#updateRows();
+          break;
+        }
+
+      case 'cols':
+        {
+          if (this.#isConnected) {
+            this.#updateColumns();
+          }
+
+          break;
+        }
+    }
+  }
+
+  #updateColors() {
+    const colorsValue = this.colors;
+
+    if (colorsValue === this.#prevColorsValue) {
+      return;
+    }
+
+    this.#prevColorsValue = colorsValue;
+    const colorNames = getCsvSet(colorsValue ?? `${lightColorNames},${vibrantColorNames},${darkColorNames}`);
+    const fragment = document.createDocumentFragment();
+
+    for (const color of colorNames) {
+      if (color === NO_COLOR) {
+        continue;
+      }
+
+      const optFrag = optionTemplate.content.cloneNode(true);
+      const $option = optFrag.querySelector('.option');
+      const $swatch = optFrag.querySelector('.swatch');
+      const $tooltip = optFrag.querySelector('.tooltip');
+      updateAttribute($option, 'data-value', color);
+      updateAttribute($tooltip, 'text', color);
+      updateAttribute($swatch, 'name', color);
+      $option.style.setProperty('--sinch-color-icon', `var(--sinch-color-map-${color}-fg)`);
+      fragment.appendChild(optFrag);
+    }
+
+    this.#$listbox.replaceChildren(fragment);
+    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.#$listbox.children.length;
+    this.#$listbox.style.width = attrValueToPixels(colsValue, {
+      min: 1,
+      max: numItems,
+      defaultValue: Math.min(numItems, NUM_COLS_DEFAULT),
+      itemSizeMultiplier: ITEM_WIDTH
+    });
+  }
+
+  #onMount = () => {
+    this.#updateColors();
+    this.#isConnected = true;
+  };
+  #onListboxBlur = () => {
+    this.#selectOption(null);
+  };
+  #onListboxClick = e => {
+    const $elem = e.target;
+
+    if ($elem === this.#$listbox) {
+      return;
+    }
+
+    const $option = getParentOption($elem);
+    this.#dispatchChangeEvent($option);
+    this.#selectOption($option);
+  };
+  #onContextVisibility = e => {
+    if (e.detail) {
+      this.#selectOption(this.#findCheckedOption());
+    } else {
+      this.#selectOption(null);
+    }
+  };
+  #onContexKeydown = e => {
+    this.#handleKeydown(e.detail);
+  };
+  #onListboxKeyDown = e => {
+    this.#handleKeydown(e);
+  };
+
+  #handleKeydown(e) {
+    switch (e.code) {
+      case 'Space':
+      case 'Enter':
+        {
+          const $option = this.#findSelectedOption();
+
+          if ($option !== null) {
+            e.preventDefault();
+            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, 'data-value', '');
+      updateBooleanAttribute($option, 'data-checked', 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 Array.from(this.#$listbox.children);
+  }
+
+  #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, 'data-value') === value) {
+        return $el;
+      }
+    }
+
+    return null;
+  }
+
+  #dispatchChangeEvent($opt) {
+    if ($opt === null) {
+      return;
+    }
+
+    if ($opt !== null) {
+      this.dispatchEvent(new CustomEvent('-change', {
+        detail: getAttribute($opt, 'data-value')
+      }));
+    }
+  }
+
+  #onChangeReactHandler = e => {
+    getReactEventHandler(this, 'on-change')?.(e);
+  };
+});

package/color-menu/types.d.ts

@@ -0,0 +1,36 @@
+import type { TRect, TSinchElementReact } from '../types';
+export declare type TSinchSelectMenuElement = 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;
+    /** Comma-separated color names, all colors by default */
+    colors: string | 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 declare type TSinchSelectMenuReact = TSinchElementReact<TSinchSelectMenuElement> & {
+    /** 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;
+    /** Comma-separated color names, all colors by default */
+    colors?: string;
+    /** Label that is used for a11y */
+    'aria-label': string;
+    /** Change event handler */
+    'on-change'?: (e: CustomEvent<string>) => void;
+};

package/color-menu/utils.d.ts

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

package/color-menu/utils.js

@@ -0,0 +1,15 @@
+export const getParentOption = $element => {
+  let $el = $element;
+
+  while (!$el.hasAttribute('data-value')) {
+    const parent = $el.parentElement;
+
+    if (parent === null) {
+      return null;
+    }
+
+    $el = parent;
+  }
+
+  return $el;
+};

package/color-swatch/index.d.ts

@@ -0,0 +1,13 @@
+import '../icons/cancel';
+import '../text';
+import type { TSinchColorSwatchElement, TSinchColorSwatchReact } from './types';
+declare global {
+    namespace JSX {
+        interface IntrinsicElements {
+            'sinch-color-swatch': TSinchColorSwatchReact;
+        }
+    }
+    interface HTMLElementTagNameMap {
+        'sinch-color-swatch': TSinchColorSwatchElement;
+    }
+}

package/color-swatch/index.js

@@ -0,0 +1,60 @@
+import '../icons/cancel';
+import '../text';
+import { defineCustomElement, NectaryElement, setClass, getAttribute, updateAttribute } from '../utils';
+import { NO_COLOR } from '../utils/colors';
+const templateHTML = '<style>:host{display:inline-block;vertical-align:middle}#wrapper{width:var(--sinch-size-icon,32px);height:var(--sinch-size-icon,32px);border-radius:50%}#wrapper.no-color{background:linear-gradient(45deg,var(--sinch-color-map-light-orange-bg),var(--sinch-color-map-light-yellow-bg),var(--sinch-color-map-light-green-bg),var(--sinch-color-map-light-blue-bg),var(--sinch-color-map-light-violet-bg))}</style><div id="wrapper"></div>';
+const template = document.createElement('template');
+template.innerHTML = templateHTML;
+defineCustomElement('sinch-color-swatch', class extends NectaryElement {
+  #$wrapper;
+
+  constructor() {
+    super();
+    const shadowRoot = this.attachShadow();
+    shadowRoot.appendChild(template.content.cloneNode(true));
+    this.#$wrapper = shadowRoot.querySelector('#wrapper');
+  }
+
+  connectedCallback() {
+    this.#updateColor();
+  }
+
+  get name() {
+    return getAttribute(this, 'name', NO_COLOR);
+  }
+
+  set name(value) {
+    updateAttribute(this, 'name', value);
+  }
+
+  static get observedAttributes() {
+    return ['name'];
+  }
+
+  attributeChangedCallback(name, oldValue, newVal) {
+    if (oldValue === newVal) {
+      return;
+    }
+
+    switch (name) {
+      case 'name':
+        {
+          this.#updateColor();
+          break;
+        }
+    }
+  }
+
+  #updateColor() {
+    const colorName = this.name;
+
+    if (colorName !== NO_COLOR) {
+      this.#$wrapper.style.setProperty('background-color', `var(--sinch-color-map-${colorName}-bg)`);
+    } else {
+      this.#$wrapper.style.removeProperty('background-color');
+    }
+
+    setClass(this.#$wrapper, 'no-color', colorName === NO_COLOR);
+  }
+
+});

package/color-swatch/types.d.ts

@@ -0,0 +1,11 @@
+import type { TSinchElementReact } from '../types';
+export declare type TSinchColorSwatchElement = HTMLElement & {
+    /** Color name */
+    name: string;
+    /** Color name */
+    setAttribute(name: 'name', value: string): void;
+};
+export declare type TSinchColorSwatchReact = TSinchElementReact<TSinchColorSwatchElement> & {
+    /** Color name */
+    name: string;
+};