@redvars/peacock 3.3.3 → 3.5.0

package/src/select/option.ts

@@ -0,0 +1,109 @@
+import { css, html, LitElement, nothing } from 'lit';
+import { property, query } from 'lit/decorators.js';
+import type { MenuItem } from '../menu/menu-item/menu-item.js';
+
+/**
+ * @label Select Option
+ * @tag wc-option
+ * @rawTag option
+ * @parentRawTag select
+ *
+ * @summary A declarative option element for use inside wc-select.
+ *
+ * @example
+ * ```html
+ * <wc-select label="Fruit">
+ *   <wc-option value="apple">Apple</wc-option>
+ *   <wc-option value="banana">Banana</wc-option>
+ * </wc-select>
+ * ```
+ */
+export class SelectOptionElement extends LitElement {
+  static override styles = [
+    css`
+      :host {
+        display: contents;
+      }
+      :host([filtered]) {
+        display: none;
+      }
+    `,
+  ];
+
+  /**
+   * The option's submitted value.
+   */
+  @property({ type: String, reflect: true })
+  value: string = '';
+
+  /**
+   * Optional Material Symbol icon name shown before the label.
+   */
+  @property({ type: String, reflect: true })
+  icon: string = '';
+
+  /**
+   * Disables the option so it cannot be selected.
+   */
+  @property({ type: Boolean, reflect: true })
+  disabled: boolean = false;
+
+  // ── Managed by wc-select ──────────────────────────────────────────────────
+
+  /** Reflects whether this option is currently selected. Set by wc-select. */
+  @property({ type: Boolean, reflect: true })
+  selected: boolean = false;
+
+  /**
+   * When true the menu stays open after selection (used for multi-select).
+   * Set by wc-select.
+   */
+  @property({ type: Boolean, attribute: 'keep-open' })
+  keepOpen: boolean = false;
+
+  /**
+   * When true the option is hidden and excluded from keyboard navigation
+   * because it does not match the current typeahead search query.
+   * Set by wc-select.
+   */
+  @property({ type: Boolean, reflect: true })
+  filtered: boolean = false;
+
+  @query('wc-menu-item')
+  private readonly _menuItemEl?: HTMLElement;
+
+  /**
+   * Returns the inner `wc-menu-item` element.
+   * `wc-menu` discovers this via its `items` getter which checks `el.item`
+   * as a `MenuItem` proxy, so keyboard navigation and activation work
+   * without `wc-option` extending `MenuItem` directly.
+   */
+  get item(): MenuItem | null {
+    const el = this._menuItemEl;
+    // Narrow to MenuItem — the shadow DOM only ever contains a wc-menu-item
+    // (a MenuItem subclass), so this cast is safe by construction.
+    return el != null ? (el as unknown as MenuItem) : null;
+  }
+
+  override render() {
+    return html`
+      <wc-menu-item
+        value=${this.value}
+        ?disabled=${this.disabled || this.filtered}
+        ?selected=${this.selected}
+        ?keep-open=${this.keepOpen}
+      >
+        ${this.icon
+          ? html`<wc-icon name=${this.icon} slot="leading-icon"></wc-icon>`
+          : nothing}
+        <slot>${this.value === '' ? 'None' : ''}</slot>
+        ${this.selected && this.keepOpen
+          ? html`<wc-icon
+              name="check"
+              slot="trailing-supporting-text"
+            ></wc-icon>`
+          : nothing}
+      </wc-menu-item>
+    `;
+  }
+}

package/src/select/select.scss

@@ -0,0 +1,125 @@
+@use '../../scss/mixin';
+
+@include mixin.base-styles;
+
+:host {
+  display: block;
+  width: 100%;
+}
+
+/* Make the field wrapper behave as a select (pointer cursor) */
+.select-field {
+  cursor: pointer;
+}
+
+.select-trigger {
+  flex: 1;
+  display: flex;
+  align-items: center;
+  min-height: 1.5rem;
+  outline: none;
+  cursor: pointer;
+  user-select: none;
+  overflow: hidden;
+  min-width: 0;
+
+  &:focus-visible {
+    outline: none;
+  }
+}
+
+.display-value {
+  @include mixin.get-typography(body-large);
+  color: var(--color-on-surface);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+.placeholder {
+  @include mixin.get-typography(body-large);
+  color: var(--color-on-surface-variant);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+
+/* Typeahead search input */
+.search-input {
+  flex: 1;
+  width: 100%;
+  border: none;
+  outline: none;
+  background: transparent;
+  margin: 0;
+  padding: 0;
+  @include mixin.get-typography(body-large);
+  color: var(--color-on-surface);
+  cursor: pointer;
+
+  &::placeholder {
+    color: var(--color-on-surface-variant);
+  }
+
+  &:focus {
+    cursor: text;
+  }
+}
+
+/* Field end slot wrapper */
+.field-end-wrapper {
+  display: flex;
+  align-items: center;
+  gap: var(--spacing-050);
+}
+
+.select-empty-state {
+  display: block;
+  inline-size: min(22rem, 100%);
+}
+
+/* Dropdown chevron icon */
+.dropdown-icon {
+  --icon-size: 1.5rem;
+  --icon-color: var(--color-on-surface-variant);
+  transition: transform 200ms ease;
+  flex-shrink: 0;
+
+  &.dropdown-icon--open {
+    transform: rotate(180deg);
+  }
+}
+
+/* Clear button */
+.clear-btn {
+  --button-container-shape: var(--shape-corner-full);
+}
+
+/* Multi-select chips area — single scrollable row, no vertical growth */
+.chips-container {
+  display: flex;
+  flex-wrap: nowrap;
+  overflow-x: auto;
+  scrollbar-width: none;
+  gap: var(--spacing-050);
+  padding-block: var(--spacing-050);
+  align-items: center;
+  flex: 1;
+  min-width: 0;
+
+  &::-webkit-scrollbar {
+    display: none;
+  }
+}
+
+/* Disabled state */
+:host([disabled]) .select-trigger,
+:host([disabled]) .select-field {
+  cursor: not-allowed;
+}
+
+/* Readonly state */
+:host([readonly]) .select-trigger,
+:host([readonly]) .select-field {
+  cursor: default;
+}