@nectary/components 0.38.0 → 0.40.0

package/chip/types.d.ts

@@ -0,0 +1,38 @@
+import type { TSinchElementReact } from '../types';
+import type { TSinchColorName } from '../utils/colors';
+export declare type TSinchChipElement = HTMLElement & {
+    /** Text */
+    text: string;
+    /** Color, gray by default */
+    color: TSinchColorName | 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: TSinchColorName): void;
+    /** Small */
+    setAttribute(name: 'small', value: ''): void;
+};
+export declare type TSinchChipReact = TSinchElementReact<TSinchChipElement> & {
+    /** Text */
+    text: string;
+    /** Color, gray by default */
+    color?: TSinchColorName;
+    /** 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/color-menu/index.d.ts

@@ -0,0 +1,13 @@
+import '../color-swatch';
+import '../icons/check';
+import type { TSinchSelectMenuElement, TSinchSelectMenuReact } from './types';
+declare global {
+    namespace JSX {
+        interface IntrinsicElements {
+            'sinch-color-menu': TSinchSelectMenuReact;
+        }
+    }
+    interface HTMLElementTagNameMap {
+        'sinch-color-menu': TSinchSelectMenuElement;
+    }
+}

package/color-menu/index.js

@@ -0,0 +1,464 @@
+import '../color-swatch';
+import '../icons/check';
+import { attrValueToPixels, defineCustomElement, getAttribute, getBooleanAttribute, getCsvSet, getIntegerAttribute, getLiteralAttribute, getReactEventHandler, getRect, NectaryElement, setClass, updateAttribute, updateBooleanAttribute, updateExplicitBooleanAttribute, updateIntegerAttribute, updateLiteralAttribute } from '../utils';
+import { assertColorNameValue, colorMap, colorNameValues, NO_COLOR } from '../utils/colors';
+const optionTemplateHTML = '<div class="option" role="option"><sinch-color-swatch></sinch-color-swatch></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}#check{position:absolute;left:10px;top:16px;--sinch-color-icon:var(--sinch-color-stormy-500);--sinch-size-icon:24px}#check.inverted{--sinch-color-icon:var(--sinch-color-snow-100)}.option{position:relative;cursor:pointer;width:32px;height:32px;padding:12px 6px}.option::after{content:"";position:absolute;width:34px;height:34px;inset:9px 3px;border:2px solid transparent;border-radius:50%;pointer-events:none}.option[data-selected]:not([data-checked])::after{border-color:var(--sinch-color-aqua-400)}.option *{pointer-events:none}</style><sinch-icon-check id="check"></sinch-icon-check><div id="listbox" role="presentation"></div>';
+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;
+  #$checkIcon;
+  #controller = new AbortController();
+  #prevColorsValue = '';
+  #isConnected = false;
+
+  constructor() {
+    super();
+    const shadowRoot = this.attachShadow();
+    shadowRoot.appendChild(template.content.cloneNode(true));
+    this.#$listbox = shadowRoot.querySelector('#listbox');
+    this.#$checkIcon = shadowRoot.querySelector('#check');
+  }
+
+  connectedCallback() {
+    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
+    });
+    this.dispatchEvent(new CustomEvent('-context-connect-keydown', {
+      bubbles: true
+    }));
+    this.dispatchEvent(new CustomEvent('-context-connect-visibility', {
+      bubbles: true
+    }));
+    requestAnimationFrame(this.#onMount);
+  }
+
+  disconnectedCallback() {
+    this.#isConnected = false;
+    this.#prevColorsValue = null;
+    this.#controller.abort();
+    this.dispatchEvent(new CustomEvent('-context-disconnect-keydown', {
+      bubbles: true
+    }));
+    this.dispatchEvent(new CustomEvent('-context-disconnect-visibility', {
+      bubbles: true
+    }));
+  }
+
+  static get observedAttributes() {
+    return ['value', 'rows', 'cols', 'colors'];
+  }
+
+  set value(value) {
+    updateLiteralAttribute(this, colorNameValues, 'value', value);
+  }
+
+  get value() {
+    return getLiteralAttribute(this, colorNameValues, '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);
+  }
+
+  nthItemRect(index) {
+    if (index < 0 || index >= colorNameValues.length) {
+      return null;
+    }
+
+    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) {
+            assertColorNameValue(newVal);
+            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 = colorsValue !== null ? getCsvSet(colorsValue) : colorNameValues;
+    const fragment = document.createDocumentFragment();
+
+    for (const col of colorNames) {
+      if (col === NO_COLOR) {
+        continue;
+      }
+
+      const optFrag = optionTemplate.content.cloneNode(true);
+      const $opt = optFrag.querySelector('.option');
+      const $swatch = optFrag.querySelector('sinch-color-swatch');
+      updateAttribute($opt, 'data-value', col);
+      updateAttribute($opt, 'title', col);
+      updateAttribute($swatch, 'name', col);
+      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;
+    }
+
+    this.#dispatchChangeEvent($elem);
+    this.#selectOption($elem);
+  };
+  #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() {
+    if (!this.hasAttribute('value')) {
+      this.#$checkIcon.remove();
+      return;
+    }
+
+    const value = this.value;
+    this.#$checkIcon.remove();
+
+    for (const $option of this.#getOptionElements()) {
+      const isChecked = value === getAttribute($option, 'data-value', '');
+
+      if (isChecked) {
+        $option.appendChild(this.#$checkIcon);
+        setClass(this.#$checkIcon, 'inverted', colorMap[value].isInverted);
+      }
+
+      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;
+    }
+
+    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,37 @@
+import type { TRect, TSinchElementReact } from '../types';
+import type { TSinchColorName } from '../utils/colors';
+export declare type TSinchSelectMenuElement = HTMLElement & {
+    /** Value */
+    value: TSinchColorName;
+    /** 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<TSinchColorName>) => void): void;
+    /** Comma-separated color names, all colors by default */
+    setAttribute(name: 'colors', value: string): void;
+    /** Value */
+    setAttribute(name: 'value', value: TSinchColorName): 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: TSinchColorName;
+    /** 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<TSinchColorName>) => void;
+};

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,59 @@
+import '../icons/cancel';
+import '../text';
+import { defineCustomElement, getLiteralAttribute, updateLiteralAttribute, NectaryElement, setClass } from '../utils';
+import { assertColorNameValue, colorMap, colorNameValues, 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-berry-200),var(--sinch-color-orange-200),var(--sinch-color-bolt-200),var(--sinch-color-grass-200),var(--sinch-color-aqua-200),var(--sinch-color-night-200),var(--sinch-color-violet-200))}</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 getLiteralAttribute(this, colorNameValues, 'name', NO_COLOR);
+  }
+
+  set name(value) {
+    updateLiteralAttribute(this, colorNameValues, 'name', value);
+  }
+
+  static get observedAttributes() {
+    return ['name'];
+  }
+
+  attributeChangedCallback(name, oldValue, newVal) {
+    if (oldValue === newVal) {
+      return;
+    }
+
+    switch (name) {
+      case 'name':
+        {
+          assertColorNameValue(newVal);
+          this.#updateColor();
+          break;
+        }
+    }
+  }
+
+  #updateColor() {
+    const colorName = this.name;
+
+    if (colorName !== NO_COLOR) {
+      this.#$wrapper.style.backgroundColor = `var(--sinch-color-${colorMap[colorName].value})`;
+    }
+
+    setClass(this.#$wrapper, 'no-color', colorName === NO_COLOR);
+  }
+
+});

package/color-swatch/types.d.ts

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