@redvars/peacock 3.3.1 → 3.3.3

package/src/radio/radio.ts

@@ -0,0 +1,362 @@
+import { html, LitElement } from 'lit';
+import { property, query, state } from 'lit/decorators.js';
+import { classMap } from 'lit/directives/class-map.js';
+import { spread } from '../spread.js';
+import styles from './radio.scss';
+
+/**
+ * @label Radio
+ * @tag wc-radio
+ * @rawTag radio
+ * @summary Allows selection of a single option from a set.
+ * @overview
+ * <p>Radio buttons follow the Material Design 3 specifications with clear focus, hover, and selected states.</p>
+ *
+ * @cssprop --radio-size: Size of the outer radio circle.
+ * @cssprop --radio-dot-size: Size of the inner dot when selected.
+ * @cssprop --radio-selected-color: Color of the radio when selected.
+ * @cssprop --radio-unselected-color: Color of the radio outline when unselected.
+ * @cssprop --radio-state-layer-size: Size of the state layer for touch target.
+ * @cssprop --radio-disabled-opacity: Opacity applied when the radio is disabled.
+ *
+ * @fires {CustomEvent} change - Dispatched when the radio selection changes.
+ * @fires {CustomEvent} blur - Dispatched when the radio loses focus.
+ * @fires {CustomEvent} focus - Dispatched when the radio receives focus.
+ *
+ * @example
+ * ```html
+ * <wc-radio name="fruits" value="apple" label="Apple"></wc-radio>
+ * ```
+ * @tags input, form
+ */
+type RadioDirection = 1 | -1;
+
+export class Radio extends LitElement {
+  private static readonly DIRECTION_NEXT: RadioDirection = 1;
+  private static readonly DIRECTION_PREVIOUS: RadioDirection = -1;
+
+  static styles = [styles];
+
+  /**
+   * The input field name for grouping radios.
+   */
+  @property({ type: String })
+  name: string = '';
+
+  /**
+   * The submitted value when this radio is selected.
+   */
+  @property({ type: String })
+  value: string = '';
+
+  /**
+   * The radio label.
+   */
+  @property({ type: String })
+  label: string = '';
+
+  /**
+   * Whether the radio is selected.
+   */
+  @property({ type: Boolean, reflect: true })
+  checked: boolean = false;
+
+  /**
+   * If true, required icon is shown. Defaults to `false`.
+   */
+  @property({ type: Boolean, reflect: true })
+  required: boolean = false;
+
+  /**
+   * If true, the radio is readonly. Defaults to `false`.
+   */
+  @property({ type: Boolean, reflect: true })
+  readonly: boolean = false;
+
+  /**
+   * If true, the user cannot interact with the radio. Defaults to `false`.
+   */
+  @property({ type: Boolean, reflect: true })
+  disabled: boolean = false;
+
+  /**
+   * Configuration object for aria attributes.
+   */
+  @property({ type: Object })
+  configAria: Record<string, string> = {};
+
+  @state()
+  private hasFocus = false;
+
+  @state()
+  private isActive = false;
+
+  @state()
+  private slotHasContent = false;
+
+  @state()
+  private isGroupFocusTarget = false;
+
+  @query('.container')
+  private containerElement?: HTMLElement;
+
+  @query('.input-native')
+  private nativeElement?: HTMLInputElement;
+
+  private tabindex?: number;
+
+  connectedCallback() {
+    super.connectedCallback();
+    this.handleInitialAttributes();
+    window.addEventListener('mouseup', this.windowMouseUp);
+    window.addEventListener('keyup', this.windowKeyUp);
+  }
+
+  disconnectedCallback() {
+    super.disconnectedCallback();
+    window.removeEventListener('mouseup', this.windowMouseUp);
+    window.removeEventListener('keyup', this.windowKeyUp);
+  }
+
+  firstUpdated() {
+    this.slotHasContent = this.hasChildNodes() || !!this.label;
+    this.updateGroupFocusTarget();
+  }
+
+  updated(changedProps: Map<string, unknown>) {
+    if (changedProps.has('label')) {
+      this.slotHasContent = this.hasChildNodes() || !!this.label;
+    }
+
+    if (changedProps.has('checked') && this.checked) {
+      this.uncheckSiblings();
+    }
+
+    if (changedProps.has('checked') || changedProps.has('name')) {
+      this.updateGroupFocusTarget();
+    }
+  }
+
+  private handleInitialAttributes() {
+    if (this.hasAttribute('tabindex')) {
+      const attrValue = this.getAttribute('tabindex');
+      if (attrValue !== null) {
+        this.tabindex = parseInt(attrValue, 10);
+      }
+      this.removeAttribute('tabindex');
+    }
+
+    Array.from(this.attributes).forEach(attr => {
+      if (attr.name.startsWith('aria-')) {
+        this.configAria[attr.name] = attr.value;
+        this.removeAttribute(attr.name);
+      }
+    });
+  }
+
+  private windowMouseUp = () => {
+    if (this.isActive) {
+      this.isActive = false;
+    }
+  };
+
+  private windowKeyUp = (evt: KeyboardEvent) => {
+    if (this.isActive && evt.key === ' ') {
+      evt.preventDefault();
+      this.isActive = false;
+    }
+  };
+
+  private mouseDownHandler = () => {
+    this.isActive = true;
+  };
+
+  private keyDownHandler = (evt: KeyboardEvent) => {
+    if (evt.key === ' ') {
+      evt.preventDefault();
+      this.isActive = true;
+      this.selectRadio(evt);
+    } else if (evt.key === 'ArrowRight' || evt.key === 'ArrowDown') {
+      evt.preventDefault();
+      this.navigateGroup(Radio.DIRECTION_NEXT);
+    } else if (evt.key === 'ArrowLeft' || evt.key === 'ArrowUp') {
+      evt.preventDefault();
+      this.navigateGroup(Radio.DIRECTION_PREVIOUS);
+    }
+  };
+
+  private clickHandler = (ev: MouseEvent | KeyboardEvent) => {
+    this.selectRadio(ev);
+  };
+
+  private blurHandler = (ev: FocusEvent) => {
+    this.hasFocus = false;
+    this.dispatchEvent(
+      new CustomEvent('blur', {
+        detail: ev,
+        bubbles: true,
+        composed: true,
+      }),
+    );
+  };
+
+  private focusHandler = (ev: FocusEvent) => {
+    this.hasFocus = true;
+    this.dispatchEvent(
+      new CustomEvent('focus', {
+        detail: ev,
+        bubbles: true,
+        composed: true,
+      }),
+    );
+  };
+
+  private selectRadio(ev?: Event) {
+    if (this.disabled || this.readonly) return;
+
+    if (!this.checked) {
+      this.checked = true;
+      this.uncheckSiblings();
+      this.dispatchChange(ev);
+    }
+
+    this.containerElement?.focus();
+  }
+
+  private dispatchChange(ev?: Event) {
+    this.dispatchEvent(
+      new CustomEvent('change', {
+        detail: { value: this.value, checked: this.checked, originalEvent: ev },
+        bubbles: true,
+        composed: true,
+      }),
+    );
+  }
+
+  private uncheckSiblings() {
+    if (!this.name || !this.checked) return;
+    const radios = this.getGroupRadios();
+
+    radios.forEach(radio => {
+      if (radio === this) return;
+      radio.checked = false;
+    });
+  }
+
+  private getGroupRadios(): Radio[] {
+    if (!this.name) return [this];
+    const scopeRoot = this.closest('form') ?? document;
+    return Array.from(
+      scopeRoot.querySelectorAll<Radio>(`wc-radio[name="${this.name}"]`),
+    );
+  }
+
+  private isRadioEnabled(radio: Radio) {
+    return !radio.disabled && !radio.readonly;
+  }
+
+  private updateGroupFocusTarget() {
+    const group = this.getGroupRadios();
+    if (!group.length) return;
+
+    const enabledGroup = group.filter(radio => this.isRadioEnabled(radio));
+    if (!enabledGroup.length) {
+      group.forEach(radio => {
+        radio.isGroupFocusTarget = false;
+      });
+      return;
+    }
+
+    const target =
+      enabledGroup.find(radio => radio.checked) || enabledGroup[0];
+
+    group.forEach(radio => {
+      radio.isGroupFocusTarget = radio === target;
+    });
+  }
+
+  private navigateGroup(direction: RadioDirection) {
+    const group = this.getGroupRadios().filter(radio =>
+      this.isRadioEnabled(radio),
+    );
+    if (!group.length) return;
+
+    const currentIndex = group.indexOf(this);
+    const startIndex = currentIndex >= 0 ? currentIndex : 0;
+    const nextIndex = (startIndex + direction + group.length) % group.length;
+    const target = group[nextIndex];
+
+    target.selectRadio();
+    target.containerElement?.focus();
+  }
+
+  /**
+   * Sets focus on the radio.
+   */
+  focus() {
+    this.containerElement?.focus();
+  }
+
+  /**
+   * Removes focus from the radio.
+   */
+  blur() {
+    this.containerElement?.blur();
+  }
+
+  render() {
+    const cssClasses = {
+      radio: true,
+      'state-checked': this.checked,
+      'has-focus': this.hasFocus,
+      active: this.isActive,
+      disabled: this.disabled,
+      readonly: this.readonly,
+      required: this.required,
+      'has-content': this.slotHasContent,
+    };
+
+    return html`
+      <label class=${classMap(cssClasses)}>
+        <div
+          class="container"
+          tabindex=${this.isGroupFocusTarget
+            ? this.tabindex !== undefined
+              ? this.tabindex
+              : 0
+            : -1}
+          role="radio"
+          aria-disabled=${this.disabled}
+          aria-required=${this.required}
+          aria-checked=${this.checked}
+          @click=${this.clickHandler}
+          @mousedown=${this.mouseDownHandler}
+          @keydown=${this.keyDownHandler}
+          @blur=${this.blurHandler}
+          @focus=${this.focusHandler}
+          ${spread(this.configAria)}
+        >
+          <div class="state-layer"></div>
+          <div class="outer-circle"></div>
+          <div class="inner-circle"></div>
+        </div>
+
+        <input
+          type="radio"
+          class="input-native"
+          name=${this.name}
+          .value=${this.value}
+          .checked=${this.checked}
+          aria-hidden="true"
+          ?required=${this.required}
+          ?disabled=${this.disabled}
+          tabindex="-1"
+        />
+
+        ${this.label
+          ? html`<div class="label">${this.label}</div>`
+          : html`<div class="label slot-container"><slot></slot></div>`}
+      </label>
+    `;
+  }
+}

package/src/snackbar/demo/index.html

@@ -0,0 +1,29 @@
+<!doctype html>
+<html lang='en-GB'>
+<head>
+  <meta charset='utf-8'>
+  <meta name='viewport' content='width=device-width, initial-scale=1.0, viewport-fit=cover' />
+  <link rel='stylesheet' href='/dist/assets/styles/tokens.css' />
+  <style>
+    body {
+      background: #fafafa;
+      padding: 2rem;
+      display: grid;
+      gap: 1rem;
+    }
+  </style>
+</head>
+<body>
+  <wc-snackbar open message="File archived" action-label="Undo"></wc-snackbar>
+  <wc-snackbar open multiline show-close-icon>
+    Network connection was lost. Please try again when you are back online.
+  </wc-snackbar>
+
+  <script type='module'>
+    import { Snackbar, Icon } from '/dist/index.js';
+
+    window.customElements.define('wc-snackbar', Snackbar);
+    window.customElements.define('wc-icon', Icon);
+  </script>
+</body>
+</html>

package/src/snackbar/index.ts

@@ -0,0 +1 @@
+export { Snackbar } from './snackbar.js';

package/src/snackbar/snackbar.scss

@@ -0,0 +1,73 @@
+@use "../../scss/mixin";
+
+@include mixin.base-styles;
+
+:host {
+  display: inline-flex;
+  max-width: 42rem;
+  min-width: 21.5rem;
+
+  --snackbar-container-color: var(--color-inverse-surface);
+  --snackbar-label-text-color: var(--color-inverse-on-surface);
+  --snackbar-action-text-color: var(--color-inverse-primary);
+  --snackbar-close-icon-color: var(--color-inverse-on-surface);
+  --snackbar-border-radius: var(--shape-corner-extra-small);
+}
+
+.snackbar {
+  @include mixin.get-typography(body-medium);
+  align-items: center;
+  background-color: var(--snackbar-container-color);
+  border-radius: var(--snackbar-border-radius);
+  color: var(--snackbar-label-text-color);
+  display: inline-flex;
+  gap: var(--spacing-100);
+  min-height: 3rem;
+  opacity: 0;
+  padding: var(--spacing-100) var(--spacing-200);
+  pointer-events: none;
+  transform: translateY(0.5rem);
+  transition: opacity var(--duration-short2) var(--easing-standard),
+    transform var(--duration-short2) var(--easing-standard);
+}
+
+.snackbar.open {
+  opacity: 1;
+  pointer-events: auto;
+  transform: translateY(0);
+}
+
+.label {
+  flex: 1 1 auto;
+  color: inherit;
+}
+
+.action,
+.close {
+  @include mixin.get-typography(label-large);
+  align-items: center;
+  background: transparent;
+  border: none;
+  color: var(--snackbar-action-text-color);
+  cursor: pointer;
+  display: inline-flex;
+  justify-content: center;
+  margin: 0;
+  min-height: 2rem;
+  min-width: 2rem;
+  padding: 0 var(--spacing-100);
+}
+
+.close {
+  color: var(--snackbar-close-icon-color);
+  padding: 0;
+}
+
+.close wc-icon {
+  --icon-size: 1.125rem;
+  color: inherit;
+}
+
+.snackbar.multiline {
+  align-items: flex-start;
+}

package/src/snackbar/snackbar.ts

@@ -0,0 +1,151 @@
+import { LitElement, html, nothing } from 'lit';
+import { property } from 'lit/decorators.js';
+import { classMap } from 'lit/directives/class-map.js';
+import styles from './snackbar.scss';
+
+type SnackbarCloseReason = 'timeout' | 'dismiss' | 'action' | 'programmatic';
+
+/**
+ * @label Snackbar
+ * @tag wc-snackbar
+ * @rawTag snackbar
+ * @summary Snackbars provide brief messages about app processes at the bottom of the screen.
+ *
+ * @cssprop --snackbar-container-color - Container color for the snackbar.
+ * @cssprop --snackbar-label-text-color - Label text color for the snackbar.
+ * @cssprop --snackbar-action-text-color - Action text color.
+ * @cssprop --snackbar-close-icon-color - Close icon color.
+ * @cssprop --snackbar-border-radius - Border radius of the snackbar surface.
+ *
+ * @example
+ * ```html
+ * <wc-snackbar open message="Message archived" action-label="Undo"></wc-snackbar>
+ * ```
+ * @tags display, feedback
+ */
+export class Snackbar extends LitElement {
+  static styles = [styles];
+
+  @property({ type: Boolean, reflect: true }) open = false;
+
+  @property({ type: String }) message = '';
+
+  @property({ type: String, attribute: 'action-label' }) actionLabel = '';
+
+  @property({ type: Boolean, attribute: 'show-close-icon' })
+  showCloseIcon = false;
+
+  @property({ type: Number }) duration = 4000;
+
+  @property({ type: Boolean, reflect: true }) multiline = false;
+
+  private hideTimer: ReturnType<typeof setTimeout> | null = null;
+
+  show() {
+    this.open = true;
+  }
+
+  hide() {
+    this.close('programmatic');
+  }
+
+  private close(reason: SnackbarCloseReason) {
+    if (!this.open) {
+      return;
+    }
+
+    this.open = false;
+    this.dispatchEvent(
+      new CustomEvent('snackbar-close', {
+        detail: { reason },
+        bubbles: true,
+        composed: true,
+      }),
+    );
+  }
+
+  private dispatchActionEvent() {
+    this.dispatchEvent(
+      new CustomEvent('snackbar-action', {
+        bubbles: true,
+        composed: true,
+      }),
+    );
+  }
+
+  private handleActionClick() {
+    this.dispatchActionEvent();
+    this.close('action');
+  }
+
+  private handleCloseClick() {
+    this.close('dismiss');
+  }
+
+  private clearTimer() {
+    if (this.hideTimer !== null) {
+      clearTimeout(this.hideTimer);
+      this.hideTimer = null;
+    }
+  }
+
+  private scheduleAutoHide() {
+    this.clearTimer();
+    if (!this.open || this.duration <= 0) {
+      return;
+    }
+
+    this.hideTimer = setTimeout(() => {
+      this.close('timeout');
+    }, this.duration);
+  }
+
+  protected updated(changedProperties: Map<string, unknown>) {
+    if (changedProperties.has('open')) {
+      this.scheduleAutoHide();
+    }
+  }
+
+  disconnectedCallback() {
+    this.clearTimer();
+    super.disconnectedCallback();
+  }
+
+  render() {
+    const liveRole =
+      this.actionLabel || this.showCloseIcon ? 'alert' : 'status';
+
+    return html`
+      <div
+        class=${classMap({
+          snackbar: true,
+          open: this.open,
+          multiline: this.multiline,
+        })}
+        role=${liveRole}
+        aria-live="polite"
+      >
+        <div class="label">
+          <slot>${this.message}</slot>
+        </div>
+
+        ${this.actionLabel
+          ? html`<button class="action" type="button" @click=${this.handleActionClick}>
+              ${this.actionLabel}
+            </button>`
+          : nothing}
+
+        ${this.showCloseIcon
+          ? html`<button
+              class="close"
+              type="button"
+              aria-label="Dismiss notification"
+              @click=${this.handleCloseClick}
+            >
+              <wc-icon name="close"></wc-icon>
+            </button>`
+          : nothing}
+      </div>
+    `;
+  }
+}