@helixui/library 1.0.1 → 1.1.2-next.1

package/dist/shared/hx-select-4-nHL0vd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-select-4-nHL0vd.js","sources":["../../src/components/hx-select/hx-select.styles.ts","../../src/components/hx-select/hx-select.ts"],"sourcesContent":["import { css } from 'lit';\n\nexport const helixSelectStyles = css`\n  :host {\n    display: block;\n  }\n\n  :host([disabled]) {\n    opacity: var(--hx-opacity-disabled, 0.5);\n    pointer-events: none;\n  }\n\n  * {\n    box-sizing: border-box;\n  }\n\n  .field {\n    display: flex;\n    flex-direction: column;\n    gap: var(--hx-space-1, 0.25rem);\n    font-family: var(--hx-select-font-family, var(--hx-font-family-sans, sans-serif));\n    position: relative;\n  }\n\n  .field__label {\n    display: flex;\n    align-items: baseline;\n    gap: var(--hx-space-1, 0.25rem);\n    font-size: var(--hx-font-size-sm, 0.875rem);\n    font-weight: var(--hx-font-weight-medium, 500);\n    color: var(--hx-select-label-color, var(--hx-color-neutral-700, #343a40));\n    line-height: var(--hx-line-height-normal, 1.5);\n  }\n\n  .field__required-marker {\n    color: var(--hx-select-error-color, var(--hx-color-error-text, #b91c1c));\n    font-weight: var(--hx-font-weight-bold, 700);\n  }\n\n  .field__select-wrapper {\n    position: relative;\n    display: block;\n  }\n\n  .field__trigger {\n    display: flex;\n    align-items: center;\n    justify-content: space-between;\n    gap: var(--hx-space-2, 0.5rem);\n    width: 100%;\n    min-height: var(--hx-input-height-md, var(--hx-size-10, 2.5rem));\n    border: var(--hx-border-width-thin, 1px) solid\n      var(--hx-select-border-color, var(--hx-color-neutral-300, #ced4da));\n    border-radius: var(--hx-select-border-radius, var(--hx-border-radius-md, 0.375rem));\n    background-color: var(--hx-select-bg, var(--hx-color-neutral-0, #ffffff));\n    color: var(--hx-select-color, var(--hx-color-neutral-800, #212529));\n    font-family: inherit;\n    font-size: var(--hx-font-size-md, 1rem);\n    line-height: var(--hx-line-height-normal, 1.5);\n    padding: var(--hx-space-2, 0.5rem) var(--hx-space-3, 0.75rem);\n    cursor: pointer;\n    text-align: start;\n    transition:\n      border-color var(--hx-transition-fast, 150ms ease),\n      box-shadow var(--hx-transition-fast, 150ms ease);\n    outline: none;\n  }\n\n  .field__trigger:focus,\n  .field__trigger:focus-visible {\n    border-color: var(\n      --hx-select-focus-ring-color,\n      var(--hx-focus-ring-color, var(--hx-color-primary-400, #60a5fa))\n    );\n    box-shadow: 0 0 0 var(--hx-focus-ring-width, 2px)\n      color-mix(\n        in srgb,\n        var(\n            --hx-select-focus-ring-color,\n            var(--hx-focus-ring-color, var(--hx-color-primary-400, #60a5fa))\n          )\n          calc(var(--hx-focus-ring-opacity, 0.25) * 100%),\n        transparent\n      );\n  }\n\n  .field__trigger[aria-disabled='true'] {\n    cursor: not-allowed;\n  }\n\n  .field__trigger--sm {\n    min-height: var(--hx-input-height-sm, var(--hx-size-8, 2rem));\n    font-size: var(--hx-font-size-sm, 0.875rem);\n    padding: var(--hx-space-1, 0.25rem) var(--hx-space-3, 0.75rem);\n  }\n\n  .field__trigger--lg {\n    min-height: var(--hx-input-height-lg, var(--hx-size-12, 3rem));\n    font-size: var(--hx-font-size-lg, 1.125rem);\n    padding: var(--hx-space-3, 0.75rem) var(--hx-space-4, 1rem);\n  }\n\n  .field__trigger-value {\n    flex: 1;\n    min-width: 0;\n    white-space: nowrap;\n    overflow: hidden;\n    text-overflow: ellipsis;\n  }\n\n  .field__trigger--placeholder .field__trigger-value {\n    color: var(--hx-select-placeholder-color, var(--hx-color-neutral-400, #adb5bd));\n  }\n\n  .field__chevron {\n    flex-shrink: 0;\n    width: 12px;\n    height: 8px;\n    position: relative;\n    color: var(--hx-select-chevron-color, var(--hx-color-neutral-500, #6c757d));\n    pointer-events: none;\n    transition: transform var(--hx-transition-fast, 150ms ease);\n  }\n\n  .field__chevron::after {\n    content: '';\n    position: absolute;\n    top: 0;\n    left: 2px;\n    width: 7px;\n    height: 7px;\n    border-inline-end: 1.5px solid currentColor;\n    border-bottom: 1.5px solid currentColor;\n    transform: rotate(45deg);\n  }\n\n  .field--open .field__chevron {\n    transform: rotate(180deg);\n  }\n\n  .field--error .field__trigger {\n    border-color: var(--hx-select-error-color, var(--hx-color-error-500, #dc3545));\n  }\n\n  .field--error .field__trigger:focus,\n  .field--error .field__trigger:focus-visible {\n    border-color: var(--hx-select-error-color, var(--hx-color-error-500, #dc3545));\n    box-shadow: 0 0 0 var(--hx-focus-ring-width, 2px)\n      color-mix(\n        in srgb,\n        var(--hx-select-error-color, var(--hx-color-error-500, #dc3545))\n          calc(var(--hx-focus-ring-opacity, 0.25) * 100%),\n        transparent\n      );\n  }\n\n  .field__listbox {\n    position: absolute;\n    top: calc(100% + var(--hx-space-1, 0.25rem));\n    left: 0;\n    right: 0;\n    z-index: var(--hx-z-index-dropdown, 1000);\n    background-color: var(--hx-select-listbox-bg, var(--hx-color-neutral-0, #ffffff));\n    border: var(--hx-border-width-thin, 1px) solid\n      var(--hx-select-border-color, var(--hx-color-neutral-300, #ced4da));\n    border-radius: var(--hx-select-border-radius, var(--hx-border-radius-md, 0.375rem));\n    box-shadow: var(\n      --hx-select-listbox-shadow,\n      0 4px 16px var(--hx-overlay-neutral-12, rgba(13, 17, 23, 0.12))\n    );\n    max-height: var(--hx-select-listbox-max-height, 16rem);\n    overflow: hidden;\n    display: flex;\n    flex-direction: column;\n  }\n\n  .field__listbox[hidden] {\n    display: none;\n  }\n\n  .field__options {\n    overflow-y: auto;\n    flex: 1;\n    padding: var(--hx-space-1, 0.25rem) 0;\n  }\n\n  .field__option {\n    display: flex;\n    align-items: center;\n    gap: var(--hx-space-2, 0.5rem);\n    padding: var(--hx-space-2, 0.5rem) var(--hx-space-3, 0.75rem);\n    font-size: var(--hx-font-size-md, 1rem);\n    color: var(--hx-select-color, var(--hx-color-neutral-800, #212529));\n    cursor: pointer;\n    user-select: none;\n    -webkit-user-select: none;\n    transition: background-color var(--hx-transition-fast, 150ms ease);\n  }\n\n  .field__option:hover {\n    background-color: var(--hx-select-option-hover-bg, var(--hx-color-primary-50, #eff6ff));\n  }\n\n  .field__option--selected {\n    background-color: var(--hx-select-option-selected-bg, var(--hx-color-primary-100, #dbeafe));\n    font-weight: var(--hx-font-weight-medium, 500);\n  }\n\n  .field__option--focused {\n    background-color: var(--hx-select-option-hover-bg, var(--hx-color-primary-50, #eff6ff));\n    outline: var(--hx-focus-ring-width, 2px) solid\n      var(--hx-select-focus-ring-color, var(--hx-focus-ring-color, var(--hx-color-primary-500)));\n    outline-offset: var(--hx-select-option-focus-ring-offset, -2px);\n  }\n\n  .field__option--focused.field__option--selected {\n    background-color: var(--hx-select-option-selected-bg, var(--hx-color-primary-100, #dbeafe));\n  }\n\n  .field__option--disabled {\n    opacity: var(--hx-opacity-disabled, 0.5);\n    cursor: not-allowed;\n    pointer-events: none;\n  }\n\n  .field__option-label {\n    flex: 1;\n    white-space: nowrap;\n    overflow: hidden;\n    text-overflow: ellipsis;\n  }\n\n  .field__no-options {\n    padding: var(--hx-space-3, 0.75rem);\n    text-align: center;\n    color: var(--hx-color-neutral-400, #adb5bd);\n    font-size: var(--hx-font-size-sm, 0.875rem);\n  }\n\n  .field__select {\n    position: absolute;\n    width: 1px;\n    height: 1px;\n    overflow: hidden;\n    opacity: 0;\n    pointer-events: none;\n    clip: rect(0, 0, 0, 0);\n  }\n\n  .field__help-text,\n  .field__error {\n    font-size: var(--hx-font-size-xs, 0.75rem);\n    line-height: var(--hx-line-height-normal, 1.5);\n  }\n\n  .field__help-text {\n    color: var(--hx-color-neutral-500, #6c757d);\n  }\n\n  .field__error {\n    color: var(--hx-select-error-color, var(--hx-color-error-text, #b91c1c));\n  }\n\n  @media (prefers-reduced-motion: reduce) {\n    .field__trigger,\n    .field__chevron,\n    .field__option {\n      transition: none;\n    }\n  }\n`;\n","import { html, nothing, type PropertyValues } from 'lit';\nimport { customElement, property, query, state } from 'lit/decorators.js';\nimport { classMap } from 'lit/directives/class-map.js';\nimport { ifDefined } from 'lit/directives/if-defined.js';\nimport { repeat } from 'lit/directives/repeat.js';\nimport { tokenStyles } from '@helixui/tokens/lit';\nimport { HelixElement, createIdCounter } from '../../base/index.js';\nimport { helixSelectStyles } from './hx-select.styles.js';\nimport { devWarn } from '../../utils/dev-warn.js';\n\n// Module-level counter for stable, SSR-safe IDs (avoids Math.random() hydration mismatch)\nconst _nextSelectId = createIdCounter('hx-select');\n\n// ─── Internal option model ───\n\ninterface SelectOption {\n  value: string;\n  label: string;\n  disabled: boolean;\n}\n\n/**\n * A form-associated select component with custom styling, label, error, and\n * help text. Options are provided via slotted `<option>` (and `<optgroup>`)\n * elements in the light DOM. The component wraps a hidden native `<select>`\n * for form participation and provides a combobox trigger for consistent\n * cross-browser styling.\n *\n * @remarks Multi-select is intentionally not supported. This component\n * implements a single-value select (combobox) pattern only. For multi-value\n * selection use a separate multi-select component.\n *\n * @remarks The listbox panel uses `position: absolute` and may be clipped by\n * ancestor elements with `overflow: hidden` or `overflow: auto`. This is a\n * known limitation when embedding the component inside cards, tables, or\n * dialogs. Use the CSS custom property `--hx-select-listbox-shadow` or\n * restructure the containing layout to avoid clipping.\n *\n * @summary Form-associated custom select with label, error, and help text.\n *\n * @tag hx-select\n *\n * @slot - Default slot for `<option>` and `<optgroup>` elements.\n * @slot label - Custom label content (overrides the label property).\n * @slot error - Custom error content (overrides the error property).\n * @slot help-text - Custom help text content (overrides the helpText property).\n *\n * @fires {CustomEvent<{value: string}>} hx-change - Dispatched when the selected option changes.\n *\n * @csspart field - The outer field container.\n * @csspart label - The label element.\n * @csspart select-wrapper - The wrapper containing the trigger and listbox.\n * @csspart select - The hidden native select element (kept for form participation).\n * @csspart trigger - The button that opens/closes the dropdown.\n * @csspart listbox - The dropdown panel containing options.\n * @csspart option - Individual option items in the listbox.\n * @csspart help-text - The help text container.\n * @csspart error - The error message container.\n *\n * @cssprop [--hx-select-bg=var(--hx-color-neutral-0)] - Select background color.\n * @cssprop [--hx-select-color=var(--hx-color-neutral-800)] - Select text color.\n * @cssprop [--hx-select-border-color=var(--hx-color-neutral-300)] - Select border color.\n * @cssprop [--hx-select-border-radius=var(--hx-border-radius-md)] - Select border radius.\n * @cssprop [--hx-select-font-family=var(--hx-font-family-sans)] - Select font family.\n * @cssprop [--hx-select-focus-ring-color=var(--hx-focus-ring-color)] - Focus ring color.\n * @cssprop [--hx-select-error-color=var(--hx-color-error-500)] - Error state color.\n * @cssprop [--hx-select-label-color=var(--hx-color-neutral-700)] - Label text color.\n * @cssprop [--hx-select-chevron-color=var(--hx-color-neutral-500)] - Chevron indicator color.\n * @cssprop [--hx-select-listbox-bg=var(--hx-color-neutral-0)] - Listbox panel background color.\n * @cssprop [--hx-select-option-hover-bg=var(--hx-color-primary-50)] - Option hover background color.\n * @cssprop [--hx-select-option-selected-bg=var(--hx-color-primary-100)] - Selected option background color.\n * @cssprop [--hx-select-placeholder-color=var(--hx-color-neutral-400)] - Placeholder text color.\n */\n@customElement('hx-select')\nexport class HelixSelect extends HelixElement {\n  static override styles = [tokenStyles, helixSelectStyles];\n\n  // ─── Form Association ───\n\n  /** Marks this element as form-associated for ElementInternals support. @internal */\n  static override formAssociated = true;\n\n  // ─── Stable IDs ───\n\n  /** @internal */\n  private _selectId = _nextSelectId();\n  /** @internal */\n  private _listboxId = `${this._selectId}-listbox`;\n  /** @internal */\n  private _labelId = `${this._selectId}-label`;\n  /** @internal */\n  private _helpTextId = `${this._selectId}-help`;\n  /** @internal */\n  private _errorId = `${this._selectId}-error`;\n\n  // ─── Public Properties ───\n\n  /**\n   * The visible label text for the select.\n   * @attr label\n   */\n  @property({ type: String })\n  label = '';\n\n  /**\n   * Placeholder text shown in the trigger when no option is selected.\n   * @attr placeholder\n   */\n  @property({ type: String })\n  placeholder = '';\n\n  /**\n   * The current value of the select.\n   * @attr value\n   */\n  @property({ type: String, reflect: true })\n  value = '';\n\n  /**\n   * Whether the select is required for form submission.\n   * @attr required\n   */\n  @property({ type: Boolean, reflect: true })\n  required = false;\n\n  /**\n   * Whether the select is disabled.\n   * @attr disabled\n   */\n  @property({ type: Boolean, reflect: true })\n  disabled = false;\n\n  /**\n   * The name used for form submission.\n   * @attr name\n   */\n  @property({ type: String })\n  name = '';\n\n  /**\n   * Error message to display. When set, the field enters an error state.\n   * @attr error\n   */\n  @property({ type: String })\n  error = '';\n\n  /**\n   * Help text displayed below the select for guidance.\n   * @attr help-text\n   */\n  @property({ type: String, attribute: 'help-text' })\n  helpText = '';\n\n  /**\n   * Size variant of the select trigger.\n   * @attr hx-size\n   */\n  @property({ type: String, attribute: 'hx-size', reflect: true })\n  size: 'sm' | 'md' | 'lg' = 'md';\n\n  /**\n   * Accessible name for screen readers, if different from the visible label.\n   * @attr aria-label\n   */\n  @property({ type: String, attribute: 'aria-label' })\n  override ariaLabel: string | null = null;\n\n  /**\n   * Controls whether the dropdown listbox is open.\n   * @attr open\n   */\n  @property({ type: Boolean, reflect: true })\n  open = false;\n\n  /**\n   * Validation message when no option is selected. Override for i18n.\n   * @attr label-required\n   */\n  @property({ attribute: 'label-required' }) labelRequired = 'Please select an option.';\n\n  /**\n   * Label shown when no options are available. Override for i18n.\n   * @attr label-no-options\n   */\n  @property({ attribute: 'label-no-options' }) labelNoOptions = 'No options found';\n\n  // ─── Internal State ───\n\n  /** Parsed option models derived from slotted `<option>` and `<optgroup>` elements. @internal */\n  @state() private _options: SelectOption[] = [];\n  /** Whether the named error slot contains projected content. @internal */\n  @state() private _hasErrorSlot = false;\n  /** Zero-based index of the keyboard-focused option in the listbox; -1 means none. @internal */\n  @state() private _focusedOptionIndex = -1;\n\n  // ─── Queries ───\n\n  /** Reference to the hidden native select element used for form participation. @internal */\n  @query('.field__select')\n  private _select: HTMLSelectElement | undefined;\n\n  /** Reference to the visible combobox trigger element that receives keyboard focus. @internal */\n  @query('.field__trigger')\n  private _trigger: HTMLElement | undefined;\n\n  // ─── Computed helpers ───\n\n  /** @internal */\n  private get _displayValue(): string {\n    if (!this.value) return '';\n    const opt = this._options.find((o) => o.value === this.value);\n    return opt ? opt.label : this.value;\n  }\n\n  // ─── Lifecycle ───\n\n  override connectedCallback(): void {\n    super.connectedCallback();\n  }\n\n  override disconnectedCallback(): void {\n    super.disconnectedCallback();\n    // Safety net: remove listener if component is removed while dropdown is open\n    document.removeEventListener('click', this._handleOutsideClick);\n    // Reset open state to prevent persisted open state on reconnect\n    if (this.open) {\n      this.open = false;\n      this._focusedOptionIndex = -1;\n    }\n  }\n\n  override updated(changedProperties: PropertyValues<this>): void {\n    if (changedProperties.has('open')) {\n      if (this.open) {\n        document.addEventListener('click', this._handleOutsideClick);\n      } else {\n        document.removeEventListener('click', this._handleOutsideClick);\n      }\n    }\n    if (changedProperties.has('value')) {\n      this._syncNativeSelect();\n      this._updateFormValue();\n      this._updateValidity();\n    }\n    if (changedProperties.has('size')) {\n      const validSizes: string[] = ['sm', 'md', 'lg'];\n      if (!validSizes.includes(this.size)) {\n        devWarn(\n          'hx-select',\n          `Invalid size \"${this.size}\". Expected one of: ${validSizes.join(', ')}.`,\n        );\n      }\n    }\n  }\n\n  // ─── Form Integration ───\n\n  /** Returns the associated form element, if any. */\n  get form(): HTMLFormElement | null {\n    return this._internals.form;\n  }\n\n  /** Returns the validation message. */\n  get validationMessage(): string {\n    return this._internals.validationMessage;\n  }\n\n  /** Returns the ValidityState object. */\n  get validity(): ValidityState {\n    return this._internals.validity;\n  }\n\n  /** Checks whether the select satisfies its constraints. */\n  checkValidity(): boolean {\n    return this._internals.checkValidity();\n  }\n\n  /** Reports validity and shows the browser's constraint validation UI. */\n  reportValidity(): boolean {\n    return this._internals.reportValidity();\n  }\n\n  /** @internal */\n  private _updateFormValue(): void {\n    this._internals.setFormValue(this.value || null);\n  }\n\n  /** @internal */\n  private _updateValidity(): void {\n    if (this.required && !this.value) {\n      this._internals.setValidity(\n        { valueMissing: true },\n        this.error || this.labelRequired,\n        this._trigger ?? this._select,\n      );\n    } else {\n      this._internals.setValidity({});\n    }\n  }\n\n  // ─── Form Lifecycle Hooks ───\n\n  protected override _onFormReset(): void {\n    this.value = '';\n    this._internals.setFormValue(null);\n  }\n\n  protected override _onFormStateRestore(\n    state: File | string | FormData | null,\n    _mode: 'restore' | 'autocomplete',\n  ): void {\n    if (typeof state === 'string') {\n      this.value = state;\n    }\n  }\n\n  protected override _onFormDisabled(disabled: boolean): void {\n    this.disabled = disabled;\n  }\n\n  // ─── Native Select Sync ───\n\n  /** @internal */\n  private _syncNativeSelect(): void {\n    if (!this._select) return;\n    if (this.value) {\n      this._select.value = this.value;\n    }\n  }\n\n  // ─── Option Syncing from Slot ───\n\n  /** @internal */\n  private _parseOption(el: HTMLOptionElement): SelectOption {\n    return { value: el.value, label: el.textContent?.trim() ?? el.value, disabled: el.disabled };\n  }\n\n  /**\n   * Single-pass slot handler: reads options into _options for the custom\n   * listbox AND clones them into the native <select> for form participation.\n   * Handles both top-level <option> and <optgroup> children.\n   */\n  /** @internal */\n  private _handleSlotChange(): void {\n    const slot = this.shadowRoot?.querySelector<HTMLSlotElement>('slot:not([name])');\n    if (!slot) return;\n\n    const parsed: SelectOption[] = [];\n\n    // Remove previously cloned options from native select\n    if (this._select) {\n      this._select.querySelectorAll('option[data-cloned]').forEach((opt) => opt.remove());\n    }\n\n    const cloneIntoSelect = (optEl: HTMLOptionElement): void => {\n      if (!this._select) return;\n      const clone = optEl.cloneNode(true) as HTMLOptionElement;\n      clone.setAttribute('data-cloned', '');\n      this._select.appendChild(clone);\n    };\n\n    for (const el of slot.assignedElements({ flatten: true })) {\n      if (el instanceof HTMLOptionElement) {\n        parsed.push(this._parseOption(el));\n        cloneIntoSelect(el);\n      } else if (el instanceof HTMLOptGroupElement) {\n        for (const child of Array.from(el.children)) {\n          if (child instanceof HTMLOptionElement) {\n            parsed.push(this._parseOption(child));\n            cloneIntoSelect(child);\n          }\n        }\n      }\n    }\n\n    this._options = parsed;\n\n    if (parsed.length === 0) {\n      devWarn(\n        'hx-select',\n        'hx-select has no options — add <option> or <optgroup> elements as children.',\n      );\n    }\n\n    if (this._select) {\n      if (this.value) {\n        this._select.value = this.value;\n      } else if (!this.placeholder && parsed.length > 0) {\n        this.value = this._select.value;\n        this._updateFormValue();\n      }\n    }\n  }\n\n  // ─── Slot Change Handlers ───\n\n  /** @internal */\n  private _handleErrorSlotChange(e: Event): void {\n    const slot = e.target as HTMLSlotElement;\n    this._hasErrorSlot = slot.assignedNodes({ flatten: true }).length > 0;\n  }\n\n  // ─── Dropdown Control ───\n\n  /** @internal */\n  private _toggleDropdown(): void {\n    if (!this.disabled) {\n      this.open = !this.open;\n      if (this.open) {\n        // Pre-focus the currently selected option (or first enabled) when opening\n        const selectedIndex = this._options.findIndex((o) => o.value === this.value);\n        this._focusedOptionIndex = selectedIndex >= 0 ? selectedIndex : 0;\n      } else {\n        this._focusedOptionIndex = -1;\n      }\n    }\n  }\n\n  // ─── Keyboard Navigation ───\n\n  /** @internal */\n  private _handleKeydown(e: KeyboardEvent): void {\n    if (this.disabled) return;\n\n    const enabledIndices = this._options\n      .map((o, i) => ({ o, i }))\n      .filter(({ o }) => !o.disabled)\n      .map(({ i }) => i);\n\n    switch (e.key) {\n      case 'ArrowDown': {\n        e.preventDefault();\n        if (!this.open) {\n          this.open = true;\n          this._focusedOptionIndex = enabledIndices.length > 0 ? (enabledIndices[0] ?? 0) : 0;\n          break;\n        }\n        const nextDown = enabledIndices.find((i) => i > this._focusedOptionIndex);\n        this._focusedOptionIndex =\n          nextDown !== undefined ? nextDown : (enabledIndices[0] ?? this._focusedOptionIndex);\n        break;\n      }\n      case 'ArrowUp': {\n        e.preventDefault();\n        if (!this.open) {\n          this.open = true;\n          const lastEnabled = enabledIndices[enabledIndices.length - 1];\n          this._focusedOptionIndex = lastEnabled !== undefined ? lastEnabled : 0;\n          break;\n        }\n        const prevUp = [...enabledIndices].reverse().find((i) => i < this._focusedOptionIndex);\n        const lastEnabledUp = enabledIndices[enabledIndices.length - 1];\n        this._focusedOptionIndex =\n          prevUp !== undefined ? prevUp : (lastEnabledUp ?? this._focusedOptionIndex);\n        break;\n      }\n      case 'Home': {\n        e.preventDefault();\n        if (!this.open) {\n          this.open = true;\n        }\n        this._focusedOptionIndex = enabledIndices.length > 0 ? (enabledIndices[0] ?? 0) : 0;\n        break;\n      }\n      case 'End': {\n        e.preventDefault();\n        if (!this.open) {\n          this.open = true;\n        }\n        const lastEnabled = enabledIndices[enabledIndices.length - 1];\n        this._focusedOptionIndex = lastEnabled !== undefined ? lastEnabled : 0;\n        break;\n      }\n      case 'Enter':\n      case ' ': {\n        e.preventDefault();\n        if (!this.open) {\n          this.open = true;\n          const selIdx = this._options.findIndex((o) => o.value === this.value);\n          this._focusedOptionIndex = selIdx >= 0 ? selIdx : (enabledIndices[0] ?? 0);\n          break;\n        }\n        if (this._focusedOptionIndex >= 0 && this._focusedOptionIndex < this._options.length) {\n          const opt = this._options[this._focusedOptionIndex];\n          if (opt) this._selectOption(opt);\n        }\n        break;\n      }\n      case 'Escape': {\n        e.preventDefault();\n        this.open = false;\n        this._focusedOptionIndex = -1;\n        this._trigger?.focus();\n        break;\n      }\n      case 'Tab': {\n        // Close the dropdown but allow Tab to move focus naturally\n        if (this.open) {\n          this.open = false;\n          this._focusedOptionIndex = -1;\n        }\n        break;\n      }\n      default: {\n        // Typeahead: single printable character jumps to first matching option\n        if (!e.ctrlKey && !e.metaKey && !e.altKey && e.key.length === 1) {\n          const char = e.key.toLowerCase();\n          const startIndex = this.open ? this._focusedOptionIndex + 1 : 0;\n          const matching = this._options\n            .map((o, i) => ({ o, i }))\n            .filter(({ o }) => !o.disabled && o.label.toLowerCase().startsWith(char));\n          const afterCurrent = matching.find(({ i }) => i >= startIndex);\n          const target = afterCurrent ?? matching[0];\n          if (target) {\n            if (!this.open) {\n              this.open = true;\n            }\n            this._focusedOptionIndex = target.i;\n            e.preventDefault();\n          }\n        }\n        break;\n      }\n    }\n  }\n\n  // ─── Selection ───\n\n  /** @internal */\n  private _selectOption(option: SelectOption): void {\n    if (option.disabled) return;\n    this.value = option.value; // triggers updated() → sync + formValue + validity\n    this._dispatchChange();\n    this.open = false;\n    this._focusedOptionIndex = -1;\n  }\n\n  // ─── Event Dispatchers ───\n\n  /** @internal */\n  private _dispatchChange(): void {\n    this.dispatchEvent(\n      new CustomEvent<{ value: string }>('hx-change', {\n        bubbles: true,\n        composed: true,\n        detail: { value: this.value },\n      }),\n    );\n  }\n\n  /** @internal */\n  private _handleNativeChange(e: Event): void {\n    this.value = (e.target as HTMLSelectElement).value; // triggers updated()\n    this._dispatchChange();\n  }\n\n  // ─── Outside Click Handler ───\n\n  /** @internal */\n  private _handleOutsideClick = (e: MouseEvent): void => {\n    if (this.open && !e.composedPath().includes(this)) {\n      this.open = false;\n    }\n  };\n\n  // ─── Public Methods ───\n\n  /** Moves focus to the visible trigger button. */\n  override focus(options?: FocusOptions): void {\n    this._trigger?.focus(options);\n  }\n\n  // ─── Render Helpers ───\n\n  /** @internal */\n  private _optionId(index: number): string {\n    return `hx-select-option-${this._selectId}-${index}`;\n  }\n\n  /** @internal */\n  private _renderOptions() {\n    if (this._options.length === 0) {\n      return html`<div class=\"field__no-options\">${this.labelNoOptions}</div>`;\n    }\n\n    return repeat(\n      this._options,\n      (opt) => opt.value,\n      (opt, index) => {\n        const isSelected = opt.value === this.value;\n        const isFocused = index === this._focusedOptionIndex;\n\n        return html`\n          <div\n            id=${this._optionId(index)}\n            part=\"option\"\n            role=\"option\"\n            class=${classMap({\n              field__option: true,\n              'field__option--selected': isSelected,\n              'field__option--focused': isFocused,\n              'field__option--disabled': opt.disabled,\n            })}\n            aria-selected=${isSelected ? 'true' : nothing}\n            aria-disabled=${opt.disabled ? 'true' : nothing}\n            @click=${() => this._selectOption(opt)}\n          >\n            <span class=\"field__option-label\">${opt.label}</span>\n          </div>\n        `;\n      },\n    );\n  }\n\n  // ─── Main Render ───\n\n  override render() {\n    const hasError = !!this.error || this._hasErrorSlot;\n\n    const fieldClasses = {\n      field: true,\n      'field--error': hasError,\n      'field--disabled': this.disabled,\n      'field--required': this.required,\n      'field--open': this.open,\n    };\n\n    const triggerClasses = {\n      field__trigger: true,\n      [`field__trigger--${this.size}`]: true,\n      'field__trigger--placeholder': !this.value,\n    };\n\n    const selectClasses = {\n      field__select: true,\n      [`field__select--${this.size}`]: true,\n    };\n\n    const describedBy =\n      [\n        hasError || this._hasErrorSlot ? this._errorId : null,\n        this.helpText ? this._helpTextId : null,\n      ]\n        .filter(Boolean)\n        .join(' ') || undefined;\n\n    return html`\n      <div part=\"field\" class=${classMap(fieldClasses)}>\n        <!-- Label -->\n        <slot name=\"label\">\n          ${this.label\n            ? html`<label\n                part=\"label\"\n                class=\"field__label\"\n                id=${this._labelId}\n                for=${this._selectId}\n              >\n                ${this.label}\n                ${this.required\n                  ? html`<span class=\"field__required-marker\" aria-hidden=\"true\">*</span>`\n                  : nothing}\n              </label>`\n            : nothing}\n        </slot>\n\n        <!-- Select Wrapper: trigger + listbox -->\n        <div part=\"select-wrapper\" class=\"field__select-wrapper\">\n          <!-- Custom Trigger (combobox — div to avoid native role conflicts per APG) -->\n          <div\n            part=\"trigger\"\n            id=${this._selectId}\n            class=${classMap(triggerClasses)}\n            role=\"combobox\"\n            tabindex=${this.disabled ? '-1' : '0'}\n            aria-expanded=${this.open ? 'true' : 'false'}\n            aria-haspopup=\"listbox\"\n            aria-controls=${this._listboxId}\n            aria-activedescendant=${this.open && this._focusedOptionIndex >= 0\n              ? this._optionId(this._focusedOptionIndex)\n              : nothing}\n            aria-invalid=${hasError ? 'true' : nothing}\n            aria-describedby=${ifDefined(describedBy)}\n            aria-required=${this.required ? 'true' : nothing}\n            aria-disabled=${this.disabled ? 'true' : nothing}\n            aria-labelledby=${ifDefined(this.label ? this._labelId : undefined)}\n            aria-label=${ifDefined(this.ariaLabel ?? undefined)}\n            @click=${this._toggleDropdown}\n            @keydown=${this._handleKeydown}\n          >\n            <span class=\"field__trigger-value\"\n              >${this._displayValue || this.placeholder || nothing}</span\n            >\n            <span class=\"field__chevron\" aria-hidden=\"true\"></span>\n          </div>\n\n          <!-- Custom Listbox Panel -->\n          <div\n            part=\"listbox\"\n            role=\"listbox\"\n            id=${this._listboxId}\n            class=\"field__listbox\"\n            aria-label=${ifDefined(this.label || this.ariaLabel || undefined)}\n            ?hidden=${!this.open}\n          >\n            <div class=\"field__options\">${this._renderOptions()}</div>\n          </div>\n\n          <!-- Hidden native select (form participation + test compat) -->\n          <select\n            part=\"select\"\n            class=${classMap(selectClasses)}\n            tabindex=\"-1\"\n            aria-hidden=\"true\"\n            ?required=${this.required}\n            ?disabled=${this.disabled}\n            name=${ifDefined(this.name || undefined)}\n            aria-label=${ifDefined(this.ariaLabel ?? undefined)}\n            aria-invalid=${hasError ? 'true' : nothing}\n            aria-describedby=${ifDefined(describedBy)}\n            aria-required=${this.required ? 'true' : nothing}\n            @change=${this._handleNativeChange}\n          >\n            ${this.placeholder\n              ? html`<option value=\"\" disabled selected>${this.placeholder}</option>`\n              : nothing}\n          </select>\n        </div>\n\n        <!-- Hidden slot (options are read from here) -->\n        <slot @slotchange=${this._handleSlotChange} style=\"display:none;\"></slot>\n\n        <!-- Error -->\n        <slot name=\"error\" @slotchange=${this._handleErrorSlotChange}>\n          ${hasError\n            ? html`<div part=\"error\" class=\"field__error\" id=${this._errorId} role=\"alert\">\n                ${this.error}\n              </div>`\n            : nothing}\n        </slot>\n\n        <!-- Help Text -->\n        ${this.helpText && !hasError\n          ? html`\n              <div part=\"help-text\" class=\"field__help-text\" id=${this._helpTextId}>\n                <slot name=\"help-text\">${this.helpText}</slot>\n              </div>\n            `\n          : nothing}\n      </div>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'hx-select': HelixSelect;\n  }\n}\n\nexport type { HelixSelect as HxSelect };\n/** @deprecated Use HxSelect instead */\nexport type { HelixSelect as WcSelect };\n"],"names":["helixSelectStyles","css","_nextSelectId","createIdCounter","HelixSelect","HelixElement","opt","o","changedProperties","validSizes","devWarn","state","_mode","disabled","el","_a","slot","parsed","cloneIntoSelect","optEl","clone","child","selectedIndex","enabledIndices","i","nextDown","lastEnabled","prevUp","lastEnabledUp","selIdx","char","startIndex","matching","target","option","options","index","html","repeat","isSelected","isFocused","classMap","nothing","hasError","fieldClasses","triggerClasses","selectClasses","describedBy","ifDefined","tokenStyles","__decorateClass","property","query","customElement"],"mappings":";;;;;;;;AAEO,MAAMA,IAAoBC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA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"}

package/dist/shared/hx-skeleton-BHvALyd7.js.map

@@ -1 +1 @@
-{"version":3,"file":"hx-skeleton-BHvALyd7.js","sources":["../../src/components/hx-skeleton/hx-skeleton.styles.ts","../../src/components/hx-skeleton/hx-skeleton.ts"],"sourcesContent":["import { css } from 'lit';\n\nexport const helixSkeletonStyles = css`\n  :host {\n    display: block;\n  }\n\n  :host([loaded]) {\n    display: none;\n  }\n\n  /* ─── Base ─── */\n\n  .skeleton {\n    display: block;\n    background-color: var(--hx-skeleton-bg, var(--hx-color-neutral-200, #e2e8f0));\n    overflow: hidden;\n    position: relative;\n    width: var(--_width, 100%);\n    height: var(--_height, auto);\n  }\n\n  /* ─── Variant Shapes ─── */\n\n  .skeleton--text {\n    border-radius: var(--hx-skeleton-text-radius, var(--hx-border-radius-full, 9999px));\n    height: var(--_height, 1em);\n  }\n\n  .skeleton--circle {\n    border-radius: var(--hx-skeleton-circle-radius, 50%);\n    aspect-ratio: var(--_circle-aspect-ratio, 1);\n    width: var(--_width, 2.5rem);\n    height: var(--_height, var(--_width, 2.5rem));\n  }\n\n  .skeleton--rect {\n    border-radius: var(--hx-skeleton-rect-radius, var(--hx-border-radius-sm, 0.25rem));\n    height: var(--_height, 1rem);\n  }\n\n  .skeleton--button {\n    border-radius: var(--hx-skeleton-button-radius, var(--hx-border-radius-md, 0.375rem));\n    height: var(--_height, 2.5rem);\n  }\n\n  .skeleton--paragraph {\n    border-radius: var(--hx-skeleton-text-radius, var(--hx-border-radius-full, 9999px));\n    height: var(--_height, auto);\n    display: flex;\n    flex-direction: column;\n    gap: 0.5em;\n  }\n\n  /* ─── Shimmer Animation ─── */\n\n  .skeleton--animated::after {\n    content: '';\n    position: absolute;\n    inset: 0;\n    background: linear-gradient(\n      90deg,\n      transparent 0%,\n      var(--hx-skeleton-shimmer-color, var(--hx-overlay-white-40, rgba(255, 255, 255, 0.4))) 50%,\n      transparent 100%\n    );\n    background-size: var(--hx-skeleton-shimmer-width, 200%) 100%;\n    animation: hx-skeleton-shimmer var(--hx-skeleton-duration, 1.5s) ease-in-out infinite;\n  }\n\n  @keyframes hx-skeleton-shimmer {\n    from {\n      background-position: 200% center;\n    }\n    to {\n      background-position: -200% center;\n    }\n  }\n\n  @media (prefers-reduced-motion: reduce) {\n    .skeleton--animated::after {\n      display: none;\n    }\n  }\n`;\n","import { LitElement, html } from 'lit';\nimport { customElement, property } from 'lit/decorators.js';\nimport { classMap } from 'lit/directives/class-map.js';\nimport { styleMap } from 'lit/directives/style-map.js';\nimport { tokenStyles } from '@helixui/tokens/lit';\nimport { helixSkeletonStyles } from './hx-skeleton.styles.js';\n\n/**\n * An animated placeholder used to indicate loading content.\n * Purely decorative — hidden from assistive technology.\n * Supports a `loaded` state that announces content availability to screen readers.\n *\n * @summary Animated shimmer placeholder for loading states.\n *\n * @tag hx-skeleton\n *\n * @csspart base - The inner skeleton element.\n *\n * @cssprop [--hx-skeleton-bg=var(--hx-color-neutral-200)] - Skeleton background color.\n * @cssprop [--hx-skeleton-shimmer-color=rgba(255,255,255,0.4)] - Shimmer highlight color.\n * @cssprop [--hx-skeleton-shimmer-width=200%] - Shimmer sweep width (background-size X axis).\n * @cssprop [--hx-skeleton-duration=1.5s] - Shimmer animation duration.\n * @cssprop [--hx-skeleton-text-radius=var(--hx-border-radius-full)] - Border radius for text variant.\n * @cssprop [--hx-skeleton-rect-radius=var(--hx-border-radius-sm)] - Border radius for rect variant.\n * @cssprop [--hx-skeleton-button-radius=var(--hx-border-radius-md)] - Border radius for button variant.\n * @cssprop [--hx-skeleton-circle-radius=50%] - Border radius for circle variant.\n *\n * @fires hx-loaded - Dispatched when `loaded` transitions to `true`. Consumers should use\n *   this event to update an external `aria-live` region announcing content availability.\n */\n@customElement('hx-skeleton')\nexport class HelixSkeleton extends LitElement {\n  static override styles = [tokenStyles, helixSkeletonStyles];\n\n  /**\n   * Shape variant of the skeleton placeholder.\n   * @attr variant\n   */\n  @property({ type: String, reflect: true })\n  variant: 'text' | 'circle' | 'rect' | 'button' | 'paragraph' = 'rect';\n\n  /**\n   * CSS width of the skeleton. Accepts any valid CSS width value.\n   * @attr width\n   */\n  @property({ type: String })\n  width = '100%';\n\n  /**\n   * CSS height of the skeleton. Accepts any valid CSS height value.\n   * Defaults vary by variant when not set.\n   * @attr height\n   */\n  @property({ type: String })\n  height: string | undefined = undefined;\n\n  /**\n   * Whether the shimmer wave animation is active.\n   * Set to false to display a static skeleton.\n   * @attr animated\n   */\n  @property({ type: Boolean, reflect: true })\n  animated = true;\n\n  /**\n   * When true, hides the skeleton and dispatches an `hx-loaded` event.\n   * Consumers should pair this with an external `aria-live` region to\n   * announce loading completion to assistive technology users.\n   *\n   * @example\n   * ```html\n   * <div aria-live=\"polite\" aria-atomic=\"true\" id=\"status\"></div>\n   * <hx-skeleton id=\"sk\"></hx-skeleton>\n   * <script>\n   *   document.getElementById('sk').addEventListener('hx-loaded', () => {\n   *     document.getElementById('status').textContent = 'Content has loaded.';\n   *   });\n   * </script>\n   * ```\n   * @attr loaded\n   */\n  @property({ type: Boolean, reflect: true })\n  loaded = false;\n\n  // ─── Lifecycle ───\n\n  override connectedCallback() {\n    super.connectedCallback();\n    // Hide the skeleton host from the accessibility tree entirely (P1-01).\n    // Some AT + browser combinations traverse shadow hosts even when children\n    // are aria-hidden. Setting on the host ensures full concealment.\n    this.setAttribute('aria-hidden', 'true');\n  }\n\n  override updated(changedProperties: Map<string | symbol, unknown>) {\n    super.updated(changedProperties);\n    if (changedProperties.has('loaded') && this.loaded) {\n      this.dispatchEvent(\n        new CustomEvent('hx-loaded', {\n          bubbles: true,\n          composed: true,\n        }),\n      );\n    }\n  }\n\n  // ─── Render ───\n\n  override render() {\n    // When loaded, render nothing — the skeleton is replaced by real content.\n    if (this.loaded) {\n      return html``;\n    }\n\n    const classes = {\n      skeleton: true,\n      [`skeleton--${this.variant}`]: true,\n      'skeleton--animated': this.animated,\n    };\n\n    const styles: Record<string, string> = {\n      '--_width': this.width,\n    };\n    if (this.height !== undefined) {\n      styles['--_height'] = this.height;\n    }\n\n    return html`\n      <span\n        part=\"base\"\n        class=${classMap(classes)}\n        style=${styleMap(styles)}\n        aria-hidden=\"true\"\n        role=\"presentation\"\n      ></span>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'hx-skeleton': HelixSkeleton;\n  }\n}\n"],"names":["helixSkeletonStyles","css","HelixSkeleton","LitElement","changedProperties","html","classes","styles","classMap","styleMap","tokenStyles","__decorateClass","property","customElement"],"mappings":";;;;;AAEO,MAAMA,IAAsBC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;;;;AC6B5B,IAAMC,IAAN,cAA4BC,EAAW;AAAA,EAAvC,cAAA;AAAA,UAAA,GAAA,SAAA,GAQL,KAAA,UAA+D,QAO/D,KAAA,QAAQ,QAQR,KAAA,SAA6B,QAQ7B,KAAA,WAAW,IAoBX,KAAA,SAAS;AAAA,EAAA;AAAA;AAAA,EAIA,oBAAoB;AAC3B,UAAM,kBAAA,GAIN,KAAK,aAAa,eAAe,MAAM;AAAA,EACzC;AAAA,EAES,QAAQC,GAAkD;AACjE,UAAM,QAAQA,CAAiB,GAC3BA,EAAkB,IAAI,QAAQ,KAAK,KAAK,UAC1C,KAAK;AAAA,MACH,IAAI,YAAY,aAAa;AAAA,QAC3B,SAAS;AAAA,QACT,UAAU;AAAA,MAAA,CACX;AAAA,IAAA;AAAA,EAGP;AAAA;AAAA,EAIS,SAAS;AAEhB,QAAI,KAAK;AACP,aAAOC;AAGT,UAAMC,IAAU;AAAA,MACd,UAAU;AAAA,MACV,CAAC,aAAa,KAAK,OAAO,EAAE,GAAG;AAAA,MAC/B,sBAAsB,KAAK;AAAA,IAAA,GAGvBC,IAAiC;AAAA,MACrC,YAAY,KAAK;AAAA,IAAA;AAEnB,WAAI,KAAK,WAAW,WAClBA,EAAO,WAAW,IAAI,KAAK,SAGtBF;AAAA;AAAA;AAAA,gBAGKG,EAASF,CAAO,CAAC;AAAA,gBACjBG,EAASF,CAAM,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAK9B;AACF;AA1GaL,EACK,SAAS,CAACQ,GAAaV,CAAmB;AAO1DW,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,QAAQ,SAAS,IAAM;AAAA,GAP9BV,EAQX,WAAA,WAAA,CAAA;AAOAS,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,OAAA,CAAQ;AAAA,GAdfV,EAeX,WAAA,SAAA,CAAA;AAQAS,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,OAAA,CAAQ;AAAA,GAtBfV,EAuBX,WAAA,UAAA,CAAA;AAQAS,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,SAAS,SAAS,IAAM;AAAA,GA9B/BV,EA+BX,WAAA,YAAA,CAAA;AAoBAS,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,SAAS,SAAS,IAAM;AAAA,GAlD/BV,EAmDX,WAAA,UAAA,CAAA;AAnDWA,IAANS,EAAA;AAAA,EADNE,EAAc,aAAa;AAAA,GACfX,CAAA;"}
+{"version":3,"file":"hx-skeleton-BHvALyd7.js","sources":["../../src/components/hx-skeleton/hx-skeleton.styles.ts","../../src/components/hx-skeleton/hx-skeleton.ts"],"sourcesContent":["import { css } from 'lit';\n\nexport const helixSkeletonStyles = css`\n  :host {\n    display: block;\n  }\n\n  :host([loaded]) {\n    display: none;\n  }\n\n  /* ─── Base ─── */\n\n  .skeleton {\n    display: block;\n    background-color: var(--hx-skeleton-bg, var(--hx-color-neutral-200, #e2e8f0));\n    overflow: hidden;\n    position: relative;\n    width: var(--_width, 100%);\n    height: var(--_height, auto);\n  }\n\n  /* ─── Variant Shapes ─── */\n\n  .skeleton--text {\n    border-radius: var(--hx-skeleton-text-radius, var(--hx-border-radius-full, 9999px));\n    height: var(--_height, 1em);\n  }\n\n  .skeleton--circle {\n    border-radius: var(--hx-skeleton-circle-radius, 50%);\n    aspect-ratio: var(--_circle-aspect-ratio, 1);\n    width: var(--_width, 2.5rem);\n    height: var(--_height, var(--_width, 2.5rem));\n  }\n\n  .skeleton--rect {\n    border-radius: var(--hx-skeleton-rect-radius, var(--hx-border-radius-sm, 0.25rem));\n    height: var(--_height, 1rem);\n  }\n\n  .skeleton--button {\n    border-radius: var(--hx-skeleton-button-radius, var(--hx-border-radius-md, 0.375rem));\n    height: var(--_height, 2.5rem);\n  }\n\n  .skeleton--paragraph {\n    border-radius: var(--hx-skeleton-text-radius, var(--hx-border-radius-full, 9999px));\n    height: var(--_height, auto);\n    display: flex;\n    flex-direction: column;\n    gap: 0.5em;\n  }\n\n  /* ─── Shimmer Animation ─── */\n\n  .skeleton--animated::after {\n    content: '';\n    position: absolute;\n    inset: 0;\n    background: linear-gradient(\n      90deg,\n      transparent 0%,\n      var(--hx-skeleton-shimmer-color, var(--hx-overlay-white-40, rgba(255, 255, 255, 0.4))) 50%,\n      transparent 100%\n    );\n    background-size: var(--hx-skeleton-shimmer-width, 200%) 100%;\n    animation: hx-skeleton-shimmer var(--hx-skeleton-duration, 1.5s) ease-in-out infinite;\n  }\n\n  @keyframes hx-skeleton-shimmer {\n    from {\n      background-position: 200% center;\n    }\n    to {\n      background-position: -200% center;\n    }\n  }\n\n  @media (prefers-reduced-motion: reduce) {\n    .skeleton--animated::after {\n      display: none;\n    }\n  }\n`;\n","import { LitElement, html, type PropertyValues } from 'lit';\nimport { customElement, property } from 'lit/decorators.js';\nimport { classMap } from 'lit/directives/class-map.js';\nimport { styleMap } from 'lit/directives/style-map.js';\nimport { tokenStyles } from '@helixui/tokens/lit';\nimport { helixSkeletonStyles } from './hx-skeleton.styles.js';\n\n/**\n * An animated placeholder used to indicate loading content.\n * Purely decorative — hidden from assistive technology.\n * Supports a `loaded` state that announces content availability to screen readers.\n *\n * @summary Animated shimmer placeholder for loading states.\n *\n * @tag hx-skeleton\n *\n * @csspart base - The inner skeleton element.\n *\n * @cssprop [--hx-skeleton-bg=var(--hx-color-neutral-200)] - Skeleton background color.\n * @cssprop [--hx-skeleton-shimmer-color=rgba(255,255,255,0.4)] - Shimmer highlight color.\n * @cssprop [--hx-skeleton-shimmer-width=200%] - Shimmer sweep width (background-size X axis).\n * @cssprop [--hx-skeleton-duration=1.5s] - Shimmer animation duration.\n * @cssprop [--hx-skeleton-text-radius=var(--hx-border-radius-full)] - Border radius for text variant.\n * @cssprop [--hx-skeleton-rect-radius=var(--hx-border-radius-sm)] - Border radius for rect variant.\n * @cssprop [--hx-skeleton-button-radius=var(--hx-border-radius-md)] - Border radius for button variant.\n * @cssprop [--hx-skeleton-circle-radius=50%] - Border radius for circle variant.\n *\n * @fires hx-loaded - Dispatched when `loaded` transitions to `true`. Consumers should use\n *   this event to update an external `aria-live` region announcing content availability.\n */\n@customElement('hx-skeleton')\nexport class HelixSkeleton extends LitElement {\n  static override styles = [tokenStyles, helixSkeletonStyles];\n\n  /**\n   * Shape variant of the skeleton placeholder.\n   * @attr variant\n   */\n  @property({ type: String, reflect: true })\n  variant: 'text' | 'circle' | 'rect' | 'button' | 'paragraph' = 'rect';\n\n  /**\n   * CSS width of the skeleton. Accepts any valid CSS width value.\n   * @attr width\n   */\n  @property({ type: String })\n  width = '100%';\n\n  /**\n   * CSS height of the skeleton. Accepts any valid CSS height value.\n   * Defaults vary by variant when not set.\n   * @attr height\n   */\n  @property({ type: String })\n  height: string | undefined = undefined;\n\n  /**\n   * Whether the shimmer wave animation is active.\n   * Set to false to display a static skeleton.\n   * @attr animated\n   */\n  @property({ type: Boolean, reflect: true })\n  animated = true;\n\n  /**\n   * When true, hides the skeleton and dispatches an `hx-loaded` event.\n   * Consumers should pair this with an external `aria-live` region to\n   * announce loading completion to assistive technology users.\n   *\n   * @example\n   * ```html\n   * <div aria-live=\"polite\" aria-atomic=\"true\" id=\"status\"></div>\n   * <hx-skeleton id=\"sk\"></hx-skeleton>\n   * <script>\n   *   document.getElementById('sk').addEventListener('hx-loaded', () => {\n   *     document.getElementById('status').textContent = 'Content has loaded.';\n   *   });\n   * </script>\n   * ```\n   * @attr loaded\n   */\n  @property({ type: Boolean, reflect: true })\n  loaded = false;\n\n  // ─── Lifecycle ───\n\n  override connectedCallback() {\n    super.connectedCallback();\n    // Hide the skeleton host from the accessibility tree entirely (P1-01).\n    // Some AT + browser combinations traverse shadow hosts even when children\n    // are aria-hidden. Setting on the host ensures full concealment.\n    this.setAttribute('aria-hidden', 'true');\n  }\n\n  override updated(changedProperties: PropertyValues<this>) {\n    super.updated(changedProperties);\n    if (changedProperties.has('loaded') && this.loaded) {\n      this.dispatchEvent(\n        new CustomEvent<void>('hx-loaded', {\n          bubbles: true,\n          composed: true,\n        }),\n      );\n    }\n  }\n\n  // ─── Render ───\n\n  override render() {\n    // When loaded, render nothing — the skeleton is replaced by real content.\n    if (this.loaded) {\n      return html``;\n    }\n\n    const classes = {\n      skeleton: true,\n      [`skeleton--${this.variant}`]: true,\n      'skeleton--animated': this.animated,\n    };\n\n    const styles: Record<string, string> = {\n      '--_width': this.width,\n    };\n    if (this.height !== undefined) {\n      styles['--_height'] = this.height;\n    }\n\n    return html`\n      <span\n        part=\"base\"\n        class=${classMap(classes)}\n        style=${styleMap(styles)}\n        aria-hidden=\"true\"\n        role=\"presentation\"\n      ></span>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'hx-skeleton': HelixSkeleton;\n  }\n}\n"],"names":["helixSkeletonStyles","css","HelixSkeleton","LitElement","changedProperties","html","classes","styles","classMap","styleMap","tokenStyles","__decorateClass","property","customElement"],"mappings":";;;;;AAEO,MAAMA,IAAsBC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;;;;AC6B5B,IAAMC,IAAN,cAA4BC,EAAW;AAAA,EAAvC,cAAA;AAAA,UAAA,GAAA,SAAA,GAQL,KAAA,UAA+D,QAO/D,KAAA,QAAQ,QAQR,KAAA,SAA6B,QAQ7B,KAAA,WAAW,IAoBX,KAAA,SAAS;AAAA,EAAA;AAAA;AAAA,EAIA,oBAAoB;AAC3B,UAAM,kBAAA,GAIN,KAAK,aAAa,eAAe,MAAM;AAAA,EACzC;AAAA,EAES,QAAQC,GAAyC;AACxD,UAAM,QAAQA,CAAiB,GAC3BA,EAAkB,IAAI,QAAQ,KAAK,KAAK,UAC1C,KAAK;AAAA,MACH,IAAI,YAAkB,aAAa;AAAA,QACjC,SAAS;AAAA,QACT,UAAU;AAAA,MAAA,CACX;AAAA,IAAA;AAAA,EAGP;AAAA;AAAA,EAIS,SAAS;AAEhB,QAAI,KAAK;AACP,aAAOC;AAGT,UAAMC,IAAU;AAAA,MACd,UAAU;AAAA,MACV,CAAC,aAAa,KAAK,OAAO,EAAE,GAAG;AAAA,MAC/B,sBAAsB,KAAK;AAAA,IAAA,GAGvBC,IAAiC;AAAA,MACrC,YAAY,KAAK;AAAA,IAAA;AAEnB,WAAI,KAAK,WAAW,WAClBA,EAAO,WAAW,IAAI,KAAK,SAGtBF;AAAA;AAAA;AAAA,gBAGKG,EAASF,CAAO,CAAC;AAAA,gBACjBG,EAASF,CAAM,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA,EAK9B;AACF;AA1GaL,EACK,SAAS,CAACQ,GAAaV,CAAmB;AAO1DW,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,QAAQ,SAAS,IAAM;AAAA,GAP9BV,EAQX,WAAA,WAAA,CAAA;AAOAS,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,OAAA,CAAQ;AAAA,GAdfV,EAeX,WAAA,SAAA,CAAA;AAQAS,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,OAAA,CAAQ;AAAA,GAtBfV,EAuBX,WAAA,UAAA,CAAA;AAQAS,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,SAAS,SAAS,IAAM;AAAA,GA9B/BV,EA+BX,WAAA,YAAA,CAAA;AAoBAS,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,SAAS,SAAS,IAAM;AAAA,GAlD/BV,EAmDX,WAAA,UAAA,CAAA;AAnDWA,IAANS,EAAA;AAAA,EADNE,EAAc,aAAa;AAAA,GACfX,CAAA;"}

package/dist/shared/{hx-slider-CprSNrRi.js → hx-slider-7Q-e0_pc.js}

@@ -1,10 +1,11 @@
 import { css as b, LitElement as v, nothing as p, html as h } from "lit";
-import { property as l, state as c, query as _, customElement as x } from "lit/decorators.js";
-import { classMap as f } from "lit/directives/class-map.js";
+import { property as l, state as c, query as _, customElement as f } from "lit/decorators.js";
+import { classMap as x } from "lit/directives/class-map.js";
 import { ifDefined as u } from "lit/directives/if-defined.js";
 import { live as g } from "lit/directives/live.js";
 import { styleMap as m } from "lit/directives/style-map.js";
 import { tokenStyles as y } from "@helixui/tokens/lit";
+import { d as w } from "./dev-warn-YlwPHjtX.js";
 const k = b`
   :host {
     display: block;
@@ -51,7 +52,7 @@ const k = b`
     line-height: var(--hx-line-height-normal, 1.5);
     font-variant-numeric: tabular-nums;
     min-width: var(--hx-size-8, 2rem);
-    text-align: right;
+    text-align: end;
   }
 
   /* ─── Track Container ─── */
@@ -92,11 +93,11 @@ const k = b`
   /* ─── Size: lg ─── */
 
   .slider--lg .slider__track {
-    height: var(--hx-slider-track-height-lg, var(--hx-size-2, 0.5rem));
+    height: var(--hx-slider-track-height-lg, var(--hx-space-2, 0.5rem));
   }
 
   .slider--lg .slider__input {
-    height: var(--hx-slider-track-height-lg, var(--hx-size-2, 0.5rem));
+    height: var(--hx-slider-track-height-lg, var(--hx-space-2, 0.5rem));
   }
 
   /* ─── Fill ─── */
@@ -106,10 +107,13 @@ const k = b`
     top: 0;
     left: 0;
     height: 100%;
+    width: 100%;
     border-radius: var(--hx-border-radius-full, 9999px);
     background-color: var(--hx-slider-fill-bg, var(--hx-color-primary-500, #2563eb));
     pointer-events: none;
-    transition: width var(--hx-transition-fast, 150ms ease);
+    transform-origin: left center;
+    transform: scaleX(var(--_fill-ratio, 0));
+    transition: transform var(--hx-transition-fast, 150ms ease);
   }
 
   /* Suppress fill animation on initial render — only animate on user interaction */
@@ -198,7 +202,10 @@ const k = b`
   .slider__input:focus-visible ~ .slider__thumb-visual {
     box-shadow:
       0 0 0 var(--hx-focus-ring-width, 2px)
-        var(--hx-slider-focus-ring-color, var(--hx-focus-ring-color, #2563eb)),
+        var(
+          --hx-slider-focus-ring-color,
+          var(--hx-focus-ring-color, var(--hx-color-primary-400, #60a5fa))
+        ),
       var(--hx-slider-thumb-shadow, var(--hx-shadow-sm, 0 1px 2px 0 rgb(0 0 0 / 0.05)));
   }
 
@@ -245,7 +252,7 @@ const k = b`
   .slider__ticks {
     position: relative;
     width: 100%;
-    height: var(--hx-size-2, 0.5rem);
+    height: var(--hx-space-2, 0.5rem);
     margin-top: var(--hx-space-1, 0.25rem);
   }
 
@@ -287,23 +294,26 @@ const k = b`
     border-color: var(--hx-color-neutral-400, #adb5bd);
   }
 `;
-var w = Object.defineProperty, S = Object.getOwnPropertyDescriptor, s = (e, t, a, r) => {
-  for (var o = r > 1 ? void 0 : r ? S(t, a) : t, n = e.length - 1, d; n >= 0; n--)
+var S = Object.defineProperty, $ = Object.getOwnPropertyDescriptor, s = (e, t, a, r) => {
+  for (var o = r > 1 ? void 0 : r ? $(t, a) : t, n = e.length - 1, d; n >= 0; n--)
     (d = e[n]) && (o = (r ? d(t, a, o) : d(o)) || o);
-  return r && o && w(t, a, o), o;
+  return r && o && S(t, a, o), o;
 };
 let z = 0, i = class extends v {
   constructor() {
     super(), this.name = "", this.value = 0, this.min = 0, this.max = 100, this.step = 1, this.disabled = !1, this.label = "", this.helpText = "", this.showValue = !1, this.showTicks = !1, this.size = "md", this.valueText = "", this._hasLabelSlot = !1, this._hasMinLabelSlot = !1, this._hasMaxLabelSlot = !1, this._hasHelpSlot = !1, this._sliderId = `hx-slider-${++z}`, this._labelId = `${this._sliderId}-label`, this._helpId = `${this._sliderId}-help`, this._cachedTicks = [], this._internals = this.attachInternals();
   }
   // ─── Computed Values ───
+  /** @internal */
   _clamp(e) {
     return Math.min(Math.max(e, this.min), this.max);
   }
+  /** @internal */
   _fillPercent() {
     const e = this._clamp(this.value), t = this.max - this.min;
     return t === 0 ? 0 : (e - this.min) / t * 100;
   }
+  /** @internal */
   _computeTicks() {
     if (!this.showTicks) return [];
     const e = [], t = this.max - this.min;
@@ -321,7 +331,10 @@ let z = 0, i = class extends v {
     requestAnimationFrame(() => this.setAttribute("data-ready", "")), !this.label && this._hasLabelSlot;
   }
   updated(e) {
-    if (super.updated(e), e.has("value") || e.has("min") || e.has("max")) {
+    if (super.updated(e), (e.has("min") || e.has("max")) && this.min >= this.max && w(
+      "hx-slider",
+      `Invalid configuration: min (${this.min}) must be less than max (${this.max}). Slider behavior is undefined when min >= max.`
+    ), e.has("value") || e.has("min") || e.has("max")) {
       const t = this._clamp(this.value);
       if (t !== this.value) {
         this.value = t;
@@ -352,22 +365,18 @@ let z = 0, i = class extends v {
   reportValidity() {
     return this._internals.reportValidity();
   }
-  /** Called by the form when it resets. Restores to the declared `value` attribute (default value). */
+  /** @internal */
   formResetCallback() {
     const e = this.getAttribute("value"), t = e !== null ? parseFloat(e) : this.min, a = this._clamp(isNaN(t) ? this.min : t);
     this.value = a, this._internals.setFormValue(String(a));
   }
-  /**
-   * Called when the form restores state (e.g., back/forward navigation or autofill).
-   * @param state - The serialized value to restore.
-   * @param _reason - Either "restore" (back/forward) or "autocomplete".
-   */
+  /** @internal */
   formStateRestoreCallback(e, t) {
     if (typeof e != "string" || e === null) return;
     const a = parseFloat(e);
     isNaN(a) || (this.value = this._clamp(a));
   }
-  /** Called when a parent fieldset is disabled/enabled. */
+  /** @internal */
   formDisabledCallback(e) {
     this.disabled = e;
   }
@@ -378,23 +387,28 @@ let z = 0, i = class extends v {
     (t = this._input) == null || t.focus(e);
   }
   // ─── Slot Handlers ───
+  /** @internal */
   _handleLabelSlotChange(e) {
     const t = e.target;
     this._hasLabelSlot = t.assignedNodes({ flatten: !0 }).length > 0;
   }
+  /** @internal */
   _handleHelpSlotChange(e) {
     const t = e.target;
     this._hasHelpSlot = t.assignedNodes({ flatten: !0 }).length > 0;
   }
+  /** @internal */
   _handleMinLabelSlotChange(e) {
     const t = e.target;
     this._hasMinLabelSlot = t.assignedNodes({ flatten: !0 }).length > 0;
   }
+  /** @internal */
   _handleMaxLabelSlotChange(e) {
     const t = e.target;
     this._hasMaxLabelSlot = t.assignedNodes({ flatten: !0 }).length > 0;
   }
   // ─── Event Handling ───
+  /** @internal */
   _handleInput(e) {
     if (this.disabled) return;
     const t = e.target;
@@ -406,6 +420,7 @@ let z = 0, i = class extends v {
       })
     );
   }
+  /** @internal */
   _handleChange(e) {
     if (this.disabled) return;
     const t = e.target;
@@ -426,7 +441,7 @@ let z = 0, i = class extends v {
       "slider--has-ticks": this.showTicks
     }, n = [this.helpText || this._hasHelpSlot ? this._helpId : null].filter(Boolean).join(" ") || void 0;
     return h`
-      <div part="slider" class=${f(o)}>
+      <div part="slider" class=${x(o)}>
         <!-- Label row -->
         <div class="slider__label-row">
           ${a ? h`<label
@@ -443,7 +458,11 @@ let z = 0, i = class extends v {
         <!-- Track -->
         <div class="slider__track-container">
           <div part="track" class="slider__track">
-            <div part="fill" class="slider__fill" style=${m({ width: `${e}%` })}></div>
+            <div
+              part="fill"
+              class="slider__fill"
+              style=${m({ "--_fill-ratio": String(e / 100) })}
+            ></div>
 
             <input
               class="slider__input"
@@ -495,11 +514,13 @@ let z = 0, i = class extends v {
             `}
 
         <!-- Help text -->
-        <slot name="help-text" @slotchange=${this._handleHelpSlotChange}>
-          ${this.helpText ? h`<div part="help-text" class="slider__help-text" id=${this._helpId}>
-                ${this.helpText}
-              </div>` : p}
-        </slot>
+        <!-- WCAG 1.3.1: wrap slot in a persistent container so _helpId stays stable
+             regardless of whether help content comes from the slot or the property. -->
+        <div id=${this._helpId}>
+          <slot name="help-text" @slotchange=${this._handleHelpSlotChange}>
+            ${this.helpText ? h`<div part="help-text" class="slider__help-text">${this.helpText}</div>` : p}
+          </slot>
+        </div>
       </div>
     `;
   }
@@ -558,9 +579,9 @@ s([
   _(".slider__input")
 ], i.prototype, "_input", 2);
 i = s([
-  x("hx-slider")
+  f("hx-slider")
 ], i);
 export {
   i as H
 };
-//# sourceMappingURL=hx-slider-CprSNrRi.js.map
+//# sourceMappingURL=hx-slider-7Q-e0_pc.js.map

package/dist/shared/hx-slider-7Q-e0_pc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-slider-7Q-e0_pc.js","sources":["../../src/components/hx-slider/hx-slider.styles.ts","../../src/components/hx-slider/hx-slider.ts"],"sourcesContent":["import { css } from 'lit';\n\nexport const helixSliderStyles = css`\n  :host {\n    display: block;\n  }\n\n  :host([disabled]) {\n    opacity: var(--hx-opacity-disabled, 0.5);\n    pointer-events: none;\n  }\n\n  * {\n    box-sizing: border-box;\n  }\n\n  /* ─── Container ─── */\n\n  .slider {\n    display: flex;\n    flex-direction: column;\n    gap: var(--hx-space-1, 0.25rem);\n    font-family: var(--hx-font-family-sans, sans-serif);\n  }\n\n  /* ─── Label Row ─── */\n\n  .slider__label-row {\n    display: flex;\n    align-items: baseline;\n    justify-content: space-between;\n    gap: var(--hx-space-2, 0.5rem);\n  }\n\n  .slider__label {\n    font-size: var(--hx-font-size-sm, 0.875rem);\n    font-weight: var(--hx-font-weight-medium, 500);\n    color: var(--hx-slider-label-color, var(--hx-color-neutral-700, #343a40));\n    line-height: var(--hx-line-height-normal, 1.5);\n  }\n\n  .slider__value-display {\n    font-size: var(--hx-font-size-sm, 0.875rem);\n    font-weight: var(--hx-font-weight-medium, 500);\n    color: var(--hx-slider-value-color, var(--hx-color-neutral-600, #6c757d));\n    line-height: var(--hx-line-height-normal, 1.5);\n    font-variant-numeric: tabular-nums;\n    min-width: var(--hx-size-8, 2rem);\n    text-align: end;\n  }\n\n  /* ─── Track Container ─── */\n\n  .slider__track-container {\n    position: relative;\n    width: 100%;\n  }\n\n  .slider__track {\n    position: relative;\n    width: 100%;\n    border-radius: var(--hx-border-radius-full, 9999px);\n    background-color: var(--hx-slider-track-bg, var(--hx-color-neutral-200, #e9ecef));\n    overflow: visible;\n  }\n\n  /* ─── Size: sm ─── */\n\n  .slider--sm .slider__track {\n    height: var(--hx-slider-track-height-sm, var(--hx-size-1, 0.25rem));\n  }\n\n  .slider--sm .slider__input {\n    height: var(--hx-slider-track-height-sm, var(--hx-size-1, 0.25rem));\n  }\n\n  /* ─── Size: md ─── */\n\n  .slider--md .slider__track {\n    height: var(--hx-slider-track-height-md, var(--hx-size-1-5, 0.375rem));\n  }\n\n  .slider--md .slider__input {\n    height: var(--hx-slider-track-height-md, var(--hx-size-1-5, 0.375rem));\n  }\n\n  /* ─── Size: lg ─── */\n\n  .slider--lg .slider__track {\n    height: var(--hx-slider-track-height-lg, var(--hx-space-2, 0.5rem));\n  }\n\n  .slider--lg .slider__input {\n    height: var(--hx-slider-track-height-lg, var(--hx-space-2, 0.5rem));\n  }\n\n  /* ─── Fill ─── */\n\n  .slider__fill {\n    position: absolute;\n    top: 0;\n    left: 0;\n    height: 100%;\n    width: 100%;\n    border-radius: var(--hx-border-radius-full, 9999px);\n    background-color: var(--hx-slider-fill-bg, var(--hx-color-primary-500, #2563eb));\n    pointer-events: none;\n    transform-origin: left center;\n    transform: scaleX(var(--_fill-ratio, 0));\n    transition: transform var(--hx-transition-fast, 150ms ease);\n  }\n\n  /* Suppress fill animation on initial render — only animate on user interaction */\n  :host(:not([data-ready])) .slider__fill {\n    transition: none;\n  }\n\n  @media (prefers-reduced-motion: reduce) {\n    .slider__fill {\n      transition: none;\n    }\n  }\n\n  /* ─── Native Range Input ─── */\n\n  .slider__input {\n    position: absolute;\n    top: 50%;\n    left: 0;\n    transform: translateY(-50%);\n    width: 100%;\n    margin: 0;\n    padding: 0;\n    opacity: 0;\n    cursor: pointer;\n    -webkit-appearance: none;\n    appearance: none;\n    background: transparent;\n    border: none;\n    outline: none;\n    /* Expand the hit area so the thumb is easy to grab */\n    padding-block: var(--hx-slider-input-padding-block, 0.75rem);\n  }\n\n  /* In forced-color mode, restore native outline so the input remains focusable */\n  @media (forced-colors: active) {\n    .slider__input {\n      outline: revert;\n      opacity: 1;\n    }\n    .slider__input:focus-visible {\n      outline: 2px solid ButtonText;\n    }\n  }\n\n  .slider__input:disabled {\n    cursor: not-allowed;\n  }\n\n  /* ─── Thumb (visual, :before on a wrapper or via ::after on track) ─── */\n  /*\n   * The native thumb is hidden (opacity 0 on the input). We render a visible\n   * thumb element positioned by --fill-pct (a raw 0–100 number set in JS).\n   *\n   * Correct alignment formula keeps the thumb centered within the track at\n   * both extremes, preventing the left/right halves from clipping outside:\n   *   left = fillPct% * (1 – thumbSize/100%) + thumbSize * (1 – fillPct/100)\n   * Simplified: left = calc(var(--fill-pct,0)*1% + var(--_thumb-size)*(1 - var(--fill-pct,0)/100))\n   * Combined with translate(-50%,-50%) this places the thumb center correctly\n   * at every position from min to max.\n   */\n\n  .slider__thumb-visual {\n    position: absolute;\n    top: 50%;\n    /* Corrected position: thumb stays within track at all fill values */\n    left: calc(var(--fill-pct, 0) * 1% + var(--_thumb-size, 1rem) * (1 - var(--fill-pct, 0) / 100));\n    transform: translate(-50%, -50%);\n    border-radius: var(--hx-border-radius-full, 9999px);\n    background-color: var(--hx-slider-thumb-bg, var(--hx-color-neutral-0, #ffffff));\n    border: var(--hx-slider-thumb-border-width, 2px) solid\n      var(--hx-slider-thumb-border-color, var(--hx-color-primary-500, #2563eb));\n    box-shadow: var(--hx-slider-thumb-shadow, var(--hx-shadow-sm, 0 1px 2px 0 rgb(0 0 0 / 0.05)));\n    pointer-events: none;\n    transition:\n      box-shadow var(--hx-transition-fast, 150ms ease),\n      transform var(--hx-transition-fast, 150ms ease);\n  }\n\n  @media (prefers-reduced-motion: reduce) {\n    .slider__thumb-visual {\n      transition: none;\n    }\n  }\n\n  .slider__input:focus-visible ~ .slider__thumb-visual {\n    box-shadow:\n      0 0 0 var(--hx-focus-ring-width, 2px)\n        var(\n          --hx-slider-focus-ring-color,\n          var(--hx-focus-ring-color, var(--hx-color-primary-400, #60a5fa))\n        ),\n      var(--hx-slider-thumb-shadow, var(--hx-shadow-sm, 0 1px 2px 0 rgb(0 0 0 / 0.05)));\n  }\n\n  /* ─── Thumb sizes ─── */\n\n  .slider--sm .slider__thumb-visual {\n    --_thumb-size: var(--hx-slider-thumb-size-sm, var(--hx-size-3, 0.75rem));\n    width: var(--_thumb-size);\n    height: var(--_thumb-size);\n  }\n\n  .slider--md .slider__thumb-visual {\n    --_thumb-size: var(--hx-slider-thumb-size-md, var(--hx-size-4, 1rem));\n    width: var(--_thumb-size);\n    height: var(--_thumb-size);\n  }\n\n  .slider--lg .slider__thumb-visual {\n    --_thumb-size: var(--hx-slider-thumb-size-lg, var(--hx-size-5, 1.25rem));\n    width: var(--_thumb-size);\n    height: var(--_thumb-size);\n  }\n\n  /* ─── Forced colors (Windows High Contrast) ─── */\n  @media (forced-colors: active) {\n    .slider__fill {\n      background-color: Highlight;\n    }\n    .slider__track {\n      background-color: ButtonFace;\n      border: 1px solid ButtonText;\n    }\n    .slider__thumb-visual {\n      background-color: ButtonText;\n      border-color: ButtonText;\n    }\n    .slider__input:focus-visible ~ .slider__thumb-visual {\n      outline: 2px solid Highlight;\n    }\n  }\n\n  /* ─── Ticks ─── */\n\n  .slider__ticks {\n    position: relative;\n    width: 100%;\n    height: var(--hx-space-2, 0.5rem);\n    margin-top: var(--hx-space-1, 0.25rem);\n  }\n\n  .slider__tick {\n    position: absolute;\n    top: 0;\n    width: var(--hx-border-width-thin, 1px);\n    height: 100%;\n    background-color: var(--hx-slider-tick-color, var(--hx-color-neutral-400, #adb5bd));\n    transform: translateX(-50%);\n  }\n\n  /* ─── Range Labels ─── */\n\n  .slider__range-labels {\n    display: flex;\n    justify-content: space-between;\n    font-size: var(--hx-font-size-xs, 0.75rem);\n    color: var(--hx-slider-range-label-color, var(--hx-color-neutral-500, #6c757d));\n    line-height: var(--hx-line-height-normal, 1.5);\n    margin-top: var(--hx-space-0-5, 0.125rem);\n  }\n\n  /* ─── Help Text ─── */\n\n  .slider__help-text {\n    font-size: var(--hx-font-size-xs, 0.75rem);\n    color: var(--hx-slider-help-text-color, var(--hx-color-neutral-500, #6c757d));\n    line-height: var(--hx-line-height-normal, 1.5);\n  }\n\n  /* ─── Disabled state ─── */\n\n  .slider--disabled .slider__fill {\n    background-color: var(--hx-color-neutral-400, #adb5bd);\n  }\n\n  .slider--disabled .slider__thumb-visual {\n    border-color: var(--hx-color-neutral-400, #adb5bd);\n  }\n`;\n","import { LitElement, TemplateResult, html, nothing, type PropertyValues } from 'lit';\nimport { customElement, property, query, state } from 'lit/decorators.js';\nimport { classMap } from 'lit/directives/class-map.js';\nimport { ifDefined } from 'lit/directives/if-defined.js';\nimport { live } from 'lit/directives/live.js';\nimport { styleMap } from 'lit/directives/style-map.js';\nimport { tokenStyles } from '@helixui/tokens/lit';\nimport { helixSliderStyles } from './hx-slider.styles.js';\nimport { devWarn } from '../../utils/dev-warn.js';\n\n// Module-level counter for stable, SSR-safe IDs (avoids Math.random() hydration mismatch)\nlet _hxSliderIdCounter = 0;\n\n/**\n * A range slider component for selecting a numeric value within a min/max boundary.\n * Supports tick marks, value display, range labels, and native form participation\n * via ElementInternals.\n *\n * The native `<input type=\"range\">` receives `role=\"slider\"` with `aria-valuenow`,\n * `aria-valuemin`, and `aria-valuemax`. Label association uses `aria-labelledby`\n * when a label is present, or `aria-label` as a fallback. Help text is linked via\n * `aria-describedby`. Keyboard navigation follows the native range behavior:\n * Arrow keys increment/decrement by step, Home jumps to min, End jumps to max.\n *\n * @summary Form-associated range slider with label, ticks, and value display.\n *\n * @tag hx-slider\n *\n * @slot label - Custom label content (overrides the label property).\n * @slot help-text - Custom help text content (overrides the helpText property).\n * @slot min-label - Label rendered at the minimum end of the slider.\n * @slot max-label - Label rendered at the maximum end of the slider.\n *\n * @fires {CustomEvent<{value: number}>} hx-input - Dispatched continuously while the user drags.\n * @fires {CustomEvent<{value: number}>} hx-change - Dispatched when the user releases the thumb.\n *\n * @csspart slider - The outer container element.\n * @csspart track - The track background element.\n * @csspart fill - The filled portion of the track showing progress.\n * @csspart thumb - The draggable thumb overlay element.\n * @csspart label - The label element.\n * @csspart value-display - The element displaying the current numeric value.\n * @csspart tick - Each individual tick mark element.\n *\n * @cssprop [--hx-slider-track-bg=var(--hx-color-neutral-200)] - Track background color.\n * @cssprop [--hx-slider-fill-bg=var(--hx-color-primary-500)] - Fill/progress color.\n * @cssprop [--hx-slider-thumb-bg=var(--hx-color-neutral-0)] - Thumb background color.\n * @cssprop [--hx-slider-thumb-border-color=var(--hx-color-primary-500)] - Thumb border color.\n * @cssprop [--hx-slider-thumb-border-width=2px] - Thumb border width.\n * @cssprop [--hx-slider-thumb-shadow=var(--hx-shadow-sm)] - Thumb box shadow.\n * @cssprop [--hx-slider-focus-ring-color=var(--hx-focus-ring-color)] - Focus ring color.\n * @cssprop [--hx-slider-label-color=var(--hx-color-neutral-700)] - Label text color.\n * @cssprop [--hx-slider-value-color=var(--hx-color-neutral-600)] - Value display text color.\n * @cssprop [--hx-slider-tick-color=var(--hx-color-neutral-400)] - Tick mark color.\n * @cssprop [--hx-slider-range-label-color=var(--hx-color-neutral-500)] - Range label text color.\n * @cssprop [--hx-slider-help-text-color=var(--hx-color-neutral-500)] - Help text color.\n */\n@customElement('hx-slider')\nexport class HelixSlider extends LitElement {\n  static override styles = [tokenStyles, helixSliderStyles];\n\n  // ─── Form Association ───\n\n  /** @internal */\n  static formAssociated = true;\n\n  /** ElementInternals instance for form value, validity, and label association. */\n  /** @internal */\n  private _internals: ElementInternals;\n\n  constructor() {\n    super();\n    /** @internal */\n    this._internals = this.attachInternals();\n  }\n\n  // ─── Properties ───\n\n  /**\n   * The name submitted with the form.\n   * @attr name\n   */\n  @property({ type: String })\n  name = '';\n\n  /**\n   * The current numeric value of the slider.\n   * @attr value\n   */\n  @property({ type: Number })\n  value = 0;\n\n  /**\n   * The minimum allowed value.\n   * @attr min\n   */\n  @property({ type: Number })\n  min = 0;\n\n  /**\n   * The maximum allowed value.\n   * @attr max\n   */\n  @property({ type: Number })\n  max = 100;\n\n  /**\n   * The stepping interval between values.\n   * @attr step\n   */\n  @property({ type: Number })\n  step = 1;\n\n  /**\n   * Whether the slider is disabled.\n   * @attr disabled\n   */\n  @property({ type: Boolean, reflect: true })\n  disabled = false;\n\n  /**\n   * The visible label text for the slider.\n   * @attr label\n   */\n  @property({ type: String })\n  label = '';\n\n  /**\n   * Help text displayed below the slider for guidance.\n   * @attr help-text\n   */\n  @property({ type: String, attribute: 'help-text' })\n  helpText = '';\n\n  /**\n   * When true, the current value is shown next to the label.\n   * @attr show-value\n   */\n  @property({ type: Boolean, attribute: 'show-value' })\n  showValue = false;\n\n  /**\n   * When true, tick marks are rendered at each step interval.\n   * @attr show-ticks\n   */\n  @property({ type: Boolean, attribute: 'show-ticks' })\n  showTicks = false;\n\n  /**\n   * The size variant of the slider.\n   * @attr hx-size\n   */\n  @property({ type: String, reflect: true, attribute: 'hx-size' })\n  size: 'sm' | 'md' | 'lg' = 'md';\n\n  /**\n   * Human-readable text alternative for the current value, announced by screen readers\n   * instead of the numeric value. For example, on a pain scale: \"7 — Moderate-Severe\".\n   * @attr aria-valuetext\n   */\n  @property({ type: String, attribute: 'aria-valuetext' })\n  valueText = '';\n\n  // ─── Internal State ───\n\n  /** Whether the label slot has assigned content. */\n  /** @internal */\n  @state() private _hasLabelSlot = false;\n  /** Whether the min-label slot has assigned content. */\n  /** @internal */\n  @state() private _hasMinLabelSlot = false;\n  /** Whether the max-label slot has assigned content. */\n  /** @internal */\n  @state() private _hasMaxLabelSlot = false;\n  /** Whether the help slot has assigned content. */\n  /** @internal */\n  @state() private _hasHelpSlot = false;\n\n  // ─── Internal References ───\n\n  /**\n   * Reference to the native range `<input>` inside shadow DOM.\n   * @internal\n   */\n  @query('.slider__input')\n  declare private _input: HTMLInputElement | null;\n\n  // ─── Unique IDs ───\n\n  /** Unique ID for the native range input element. */\n  /** @internal */\n  private readonly _sliderId = `hx-slider-${++_hxSliderIdCounter}`;\n  /** Unique ID for the label element, derived from _sliderId. */\n  /** @internal */\n  private readonly _labelId = `${this._sliderId}-label`;\n  /** Unique ID for the help text element, derived from _sliderId. */\n  /** @internal */\n  private readonly _helpId = `${this._sliderId}-help`;\n\n  // ─── Computed Values ───\n\n  /** @internal */\n  private _clamp(v: number): number {\n    return Math.min(Math.max(v, this.min), this.max);\n  }\n\n  /** @internal */\n  private _fillPercent(): number {\n    const clamped = this._clamp(this.value);\n    const range = this.max - this.min;\n    if (range === 0) return 0;\n    return ((clamped - this.min) / range) * 100;\n  }\n\n  // Cached tick array — recomputed only when showTicks, min, max, or step change.\n  // Avoids redundant array allocation on every render during continuous drag updates.\n  /** @internal */\n  private _cachedTicks: number[] = [];\n\n  /** @internal */\n  private _computeTicks(): number[] {\n    if (!this.showTicks) return [];\n    const ticks: number[] = [];\n    const range = this.max - this.min;\n    if (range <= 0 || this.step <= 0) return ticks;\n    const count = Math.round(range / this.step);\n    for (let i = 0; i <= count; i++) {\n      ticks.push((i / count) * 100);\n    }\n    return ticks;\n  }\n\n  // ─── Lifecycle ───\n\n  override willUpdate(changedProperties: PropertyValues<this>): void {\n    super.willUpdate(changedProperties);\n    if (\n      changedProperties.has('showTicks') ||\n      changedProperties.has('min') ||\n      changedProperties.has('max') ||\n      changedProperties.has('step')\n    ) {\n      this._cachedTicks = this._computeTicks();\n    }\n  }\n\n  override firstUpdated(): void {\n    // Enable fill transition after initial render to suppress animation on mount\n    requestAnimationFrame(() => this.setAttribute('data-ready', ''));\n    // WCAG 4.1.2: warn when no accessible name is available for the range input\n    if (!this.label && !this._hasLabelSlot) {\n      devWarn(\n        'hx-slider',\n        'No accessible label provided. Set the `label` attribute or use the label slot. An unlabeled slider violates WCAG 2.1 AA (4.1.2 Name, Role, Value).',\n      );\n    }\n  }\n\n  override updated(changedProperties: PropertyValues<this>): void {\n    super.updated(changedProperties);\n    // Guard: min must be less than max\n    if (changedProperties.has('min') || changedProperties.has('max')) {\n      if (this.min >= this.max) {\n        devWarn(\n          'hx-slider',\n          `Invalid configuration: min (${this.min}) must be less than max (${this.max}). Slider behavior is undefined when min >= max.`,\n        );\n      }\n    }\n    // Clamp value to [min, max] after any relevant property change\n    if (\n      changedProperties.has('value') ||\n      changedProperties.has('min') ||\n      changedProperties.has('max')\n    ) {\n      const clamped = this._clamp(this.value);\n      if (clamped !== this.value) {\n        this.value = clamped;\n        return;\n      }\n      this._internals.setFormValue(String(this.value));\n    } else if (changedProperties.has('name')) {\n      this._internals.setFormValue(String(this.value));\n    }\n    // Reflect aria-disabled on host for AT traversal\n    if (changedProperties.has('disabled')) {\n      if (this.disabled) {\n        this.setAttribute('aria-disabled', 'true');\n      } else {\n        this.removeAttribute('aria-disabled');\n      }\n    }\n  }\n\n  // ─── Form Integration ───\n\n  /** Returns the associated form element, if any. */\n  get form(): HTMLFormElement | null {\n    return this._internals.form;\n  }\n\n  /** Returns the validation message. */\n  get validationMessage(): string {\n    return this._internals.validationMessage;\n  }\n\n  /** Returns the ValidityState object. */\n  get validity(): ValidityState {\n    return this._internals.validity;\n  }\n\n  /** Checks whether the slider satisfies its constraints. */\n  checkValidity(): boolean {\n    return this._internals.checkValidity();\n  }\n\n  /** Reports validity and shows the browser's constraint validation UI. */\n  reportValidity(): boolean {\n    return this._internals.reportValidity();\n  }\n\n  /** @internal */\n  formResetCallback(): void {\n    const attrValue = this.getAttribute('value');\n    const defaultValue = attrValue !== null ? parseFloat(attrValue) : this.min;\n    const resetTo = this._clamp(!isNaN(defaultValue) ? defaultValue : this.min);\n    this.value = resetTo;\n    this._internals.setFormValue(String(resetTo));\n  }\n\n  /** @internal */\n  formStateRestoreCallback(state: string | File | FormData | null, _reason: string): void {\n    if (typeof state !== 'string' || state === null) return;\n    const parsed = parseFloat(state);\n    if (!isNaN(parsed)) {\n      this.value = this._clamp(parsed);\n    }\n  }\n\n  /** @internal */\n  formDisabledCallback(disabled: boolean): void {\n    this.disabled = disabled;\n  }\n\n  // ─── Public Methods ───\n\n  /** Moves focus to the native range input. */\n  override focus(options?: FocusOptions): void {\n    this._input?.focus(options);\n  }\n\n  // ─── Slot Handlers ───\n\n  /** @internal */\n  private _handleLabelSlotChange(e: Event): void {\n    const slot = e.target as HTMLSlotElement;\n    this._hasLabelSlot = slot.assignedNodes({ flatten: true }).length > 0;\n  }\n\n  /** @internal */\n  private _handleHelpSlotChange(e: Event): void {\n    const slot = e.target as HTMLSlotElement;\n    this._hasHelpSlot = slot.assignedNodes({ flatten: true }).length > 0;\n  }\n\n  /** @internal */\n  private _handleMinLabelSlotChange(e: Event): void {\n    const slot = e.target as HTMLSlotElement;\n    this._hasMinLabelSlot = slot.assignedNodes({ flatten: true }).length > 0;\n  }\n\n  /** @internal */\n  private _handleMaxLabelSlotChange(e: Event): void {\n    const slot = e.target as HTMLSlotElement;\n    this._hasMaxLabelSlot = slot.assignedNodes({ flatten: true }).length > 0;\n  }\n\n  // ─── Event Handling ───\n\n  /** @internal */\n  private _handleInput(e: Event): void {\n    if (this.disabled) return;\n    const target = e.target as HTMLInputElement;\n    this.value = parseFloat(target.value);\n    this._internals.setFormValue(String(this.value));\n\n    /**\n     * Dispatched continuously while the user drags the thumb.\n     * @event hx-input\n     */\n    this.dispatchEvent(\n      new CustomEvent<{ value: number }>('hx-input', {\n        bubbles: true,\n        composed: true,\n        detail: { value: this.value },\n      }),\n    );\n  }\n\n  /** @internal */\n  private _handleChange(e: Event): void {\n    if (this.disabled) return;\n    const target = e.target as HTMLInputElement;\n    this.value = parseFloat(target.value);\n    this._internals.setFormValue(String(this.value));\n\n    /**\n     * Dispatched when the user releases the thumb after dragging.\n     * @event hx-change\n     */\n    this.dispatchEvent(\n      new CustomEvent<{ value: number }>('hx-change', {\n        bubbles: true,\n        composed: true,\n        detail: { value: this.value },\n      }),\n    );\n  }\n\n  // ─── Render ───\n\n  override render(): TemplateResult {\n    const fillPct = this._fillPercent();\n    const ticks = this._cachedTicks;\n    const hasLabel = !!this.label || this._hasLabelSlot;\n    const showRangeLabels = this._hasMinLabelSlot || this._hasMaxLabelSlot;\n\n    const containerClasses = {\n      slider: true,\n      [`slider--${this.size}`]: true,\n      'slider--disabled': this.disabled,\n      'slider--has-ticks': this.showTicks,\n    };\n\n    const describedBy =\n      [this.helpText || this._hasHelpSlot ? this._helpId : null].filter(Boolean).join(' ') ||\n      undefined;\n\n    return html`\n      <div part=\"slider\" class=${classMap(containerClasses)}>\n        <!-- Label row -->\n        <div class=\"slider__label-row\">\n          ${hasLabel\n            ? html`<label\n                part=\"label\"\n                class=\"slider__label\"\n                id=${this._labelId}\n                for=${this._sliderId}\n              >\n                <slot name=\"label\" @slotchange=${this._handleLabelSlotChange}>${this.label}</slot>\n              </label>`\n            : html`<slot name=\"label\" @slotchange=${this._handleLabelSlotChange}></slot>`}\n          ${this.showValue\n            ? html`<span part=\"value-display\" class=\"slider__value-display\"> ${this.value} </span>`\n            : nothing}\n        </div>\n\n        <!-- Track -->\n        <div class=\"slider__track-container\">\n          <div part=\"track\" class=\"slider__track\">\n            <div\n              part=\"fill\"\n              class=\"slider__fill\"\n              style=${styleMap({ '--_fill-ratio': String(fillPct / 100) })}\n            ></div>\n\n            <input\n              class=\"slider__input\"\n              id=${this._sliderId}\n              type=\"range\"\n              .value=${live(String(this.value))}\n              min=${this.min}\n              max=${this.max}\n              step=${this.step}\n              ?disabled=${this.disabled}\n              name=${ifDefined(this.name || undefined)}\n              aria-labelledby=${ifDefined(hasLabel ? this._labelId : undefined)}\n              aria-label=${ifDefined(!hasLabel ? 'Slider' : undefined)}\n              aria-valuetext=${ifDefined(this.valueText || undefined)}\n              aria-describedby=${ifDefined(describedBy)}\n              @input=${this._handleInput}\n              @change=${this._handleChange}\n            />\n\n            <!-- Visual thumb positioned by fill percentage (--fill-pct drives CSS calc) -->\n            <span\n              part=\"thumb\"\n              class=\"slider__thumb-visual\"\n              style=${styleMap({ '--fill-pct': String(fillPct) })}\n              aria-hidden=\"true\"\n            ></span>\n          </div>\n        </div>\n\n        <!-- Tick marks -->\n        ${this.showTicks && ticks.length > 0\n          ? html`<div class=\"slider__ticks\">\n              ${ticks.map(\n                (pct) =>\n                  html`<span\n                    part=\"tick\"\n                    class=\"slider__tick\"\n                    style=${styleMap({ left: `${pct}%` })}\n                  ></span>`,\n              )}\n            </div>`\n          : nothing}\n\n        <!-- Range labels -->\n        ${showRangeLabels\n          ? html`<div class=\"slider__range-labels\">\n              <slot name=\"min-label\" @slotchange=${this._handleMinLabelSlotChange}></slot>\n              <slot name=\"max-label\" @slotchange=${this._handleMaxLabelSlotChange}></slot>\n            </div>`\n          : html`\n              <!-- Always observe slot changes even when not rendered -->\n              <slot name=\"min-label\" hidden @slotchange=${this._handleMinLabelSlotChange}></slot>\n              <slot name=\"max-label\" hidden @slotchange=${this._handleMaxLabelSlotChange}></slot>\n            `}\n\n        <!-- Help text -->\n        <!-- WCAG 1.3.1: wrap slot in a persistent container so _helpId stays stable\n             regardless of whether help content comes from the slot or the property. -->\n        <div id=${this._helpId}>\n          <slot name=\"help-text\" @slotchange=${this._handleHelpSlotChange}>\n            ${this.helpText\n              ? html`<div part=\"help-text\" class=\"slider__help-text\">${this.helpText}</div>`\n              : nothing}\n          </slot>\n        </div>\n      </div>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'hx-slider': HelixSlider;\n  }\n}\n"],"names":["helixSliderStyles","css","_hxSliderIdCounter","HelixSlider","LitElement","v","clamped","range","ticks","count","i","changedProperties","devWarn","attrValue","defaultValue","resetTo","state","_reason","parsed","disabled","options","_a","slot","target","fillPct","hasLabel","showRangeLabels","containerClasses","describedBy","html","classMap","nothing","styleMap","live","ifDefined","pct","tokenStyles","__decorateClass","property","query","customElement"],"mappings":";;;;;;;;AAEO,MAAMA,IAAoBC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA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"}

package/dist/shared/{hx-spinner-BOApJ-g9.js → hx-spinner-DEgrKsUo.js}

@@ -1,5 +1,5 @@
-import { css as h, LitElement as f, html as v } from "lit";
-import { property as a, customElement as d } from "lit/decorators.js";
+import { css as h, LitElement as f, html as d } from "lit";
+import { property as a, customElement as v } from "lit/decorators.js";
 import { styleMap as p } from "lit/directives/style-map.js";
 import { ifDefined as m } from "lit/directives/if-defined.js";
 import { tokenStyles as u } from "@helixui/tokens/lit";
@@ -37,7 +37,8 @@ const x = h`
        Adjust both proportionally if r or viewBox dimensions change. */
     stroke-dasharray: 56;
     stroke-dashoffset: 14;
-    animation: hx-spinner-dash 1.5s ease-in-out infinite;
+    animation: hx-spinner-dash var(--hx-duration-spinner, 750ms)
+      var(--hx-easing-in-out, ease-in-out) infinite;
     transform-origin: center;
   }
 
@@ -119,27 +120,34 @@ const x = h`
     }
   }
 `;
-var _ = Object.defineProperty, y = Object.getOwnPropertyDescriptor, s = (n, t, i, o) => {
-  for (var e = o > 1 ? void 0 : o ? y(t, i) : t, l = n.length - 1, c; l >= 0; l--)
-    (c = n[l]) && (e = (o ? c(t, i, e) : c(e)) || e);
-  return o && e && _(t, i, e), e;
+var _ = Object.defineProperty, y = Object.getOwnPropertyDescriptor, n = (e, i, s, o) => {
+  for (var r = o > 1 ? void 0 : o ? y(i, s) : i, l = e.length - 1, c; l >= 0; l--)
+    (c = e[l]) && (r = (o ? c(i, s, r) : c(r)) || r);
+  return o && r && _(i, s, r), r;
 };
-let r = class extends f {
+let t = class extends f {
   constructor() {
     super(...arguments), this.size = "md", this.variant = "default", this.label = "Loading", this.decorative = !1;
   }
+  // ─── Lifecycle ───
+  connectedCallback() {
+    super.connectedCallback();
+    const e = this.getAttribute("size");
+    e !== null && !this.hasAttribute("hx-size") && (this.size = e);
+  }
+  /** @internal */
   _isTokenSize() {
     return this.size === "sm" || this.size === "md" || this.size === "lg";
   }
   render() {
-    const n = !this._isTokenSize() && this.size ? p({ "--_spinner-size": this.size }) : p({}), t = this.decorative ? "presentation" : "status", i = this.decorative ? void 0 : this.label || void 0;
-    return v`
+    const e = !this._isTokenSize() && this.size ? p({ "--_spinner-size": this.size }) : p({}), i = this.decorative ? "presentation" : "status", s = this.decorative ? void 0 : this.label || void 0;
+    return d`
       <div
         class="spinner"
         part="base"
-        style=${n}
-        role=${t}
-        aria-label=${m(i)}
+        style=${e}
+        role=${i}
+        aria-label=${m(s)}
       >
         <svg
           class="spinner__svg"
@@ -161,23 +169,23 @@ let r = class extends f {
     `;
   }
 };
-r.styles = [u, x];
-s([
-  a({ type: String, reflect: !0 })
-], r.prototype, "size", 2);
-s([
+t.styles = [u, x];
+n([
+  a({ type: String, reflect: !0, attribute: "hx-size" })
+], t.prototype, "size", 2);
+n([
   a({ type: String, reflect: !0 })
-], r.prototype, "variant", 2);
-s([
+], t.prototype, "variant", 2);
+n([
   a({ type: String, reflect: !0 })
-], r.prototype, "label", 2);
-s([
+], t.prototype, "label", 2);
+n([
   a({ type: Boolean, reflect: !0 })
-], r.prototype, "decorative", 2);
-r = s([
-  d("hx-spinner")
-], r);
+], t.prototype, "decorative", 2);
+t = n([
+  v("hx-spinner")
+], t);
 export {
-  r as H
+  t as H
 };
-//# sourceMappingURL=hx-spinner-BOApJ-g9.js.map
+//# sourceMappingURL=hx-spinner-DEgrKsUo.js.map

package/dist/shared/hx-spinner-DEgrKsUo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hx-spinner-DEgrKsUo.js","sources":["../../src/components/hx-spinner/hx-spinner.styles.ts","../../src/components/hx-spinner/hx-spinner.ts"],"sourcesContent":["import { css } from 'lit';\n\nexport const helixSpinnerStyles = css`\n  :host {\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n  }\n\n  .spinner {\n    display: inline-flex;\n    align-items: center;\n    justify-content: center;\n    width: var(--_spinner-size);\n    height: var(--_spinner-size);\n    flex-shrink: 0;\n  }\n\n  .spinner__svg {\n    width: 100%;\n    height: 100%;\n    animation: hx-spinner-rotate var(--hx-duration-spinner, 750ms) linear infinite;\n  }\n\n  .spinner__track {\n    stroke: var(--_spinner-track-color);\n  }\n\n  .spinner__arc {\n    stroke: var(--_spinner-color);\n    /* SVG arc math: viewBox is 24×24, r=10, circumference = 2π × 10 ≈ 62.83.\n       stroke-dasharray: 56 creates a visible arc of ~89% of circumference.\n       stroke-dashoffset: 14 shifts the arc start to produce the ~75% visible gap aesthetic.\n       Adjust both proportionally if r or viewBox dimensions change. */\n    stroke-dasharray: 56;\n    stroke-dashoffset: 14;\n    animation: hx-spinner-dash var(--hx-duration-spinner, 750ms)\n      var(--hx-easing-in-out, ease-in-out) infinite;\n    transform-origin: center;\n  }\n\n  @keyframes hx-spinner-rotate {\n    to {\n      transform: rotate(360deg);\n    }\n  }\n\n  @keyframes hx-spinner-dash {\n    0% {\n      stroke-dashoffset: 50;\n    }\n    50% {\n      stroke-dashoffset: 14;\n    }\n    100% {\n      stroke-dashoffset: 50;\n    }\n  }\n\n  @media (prefers-reduced-motion: reduce) {\n    .spinner__svg {\n      animation: none;\n    }\n\n    .spinner__arc {\n      animation: none;\n      /* Maintain the static partial arc at full opacity so the loading state remains\n         clearly communicated without motion. A faded arc looks broken; full opacity\n         alongside the track ring unambiguously signals \"in progress\". */\n      stroke-dashoffset: 14;\n      opacity: 1;\n    }\n  }\n\n  /* ─── Size Variants ─── */\n\n  :host([size='sm']) {\n    --_spinner-size: var(--hx-size-4, 1rem);\n  }\n\n  :host([size='md']) {\n    --_spinner-size: var(--hx-size-6, 1.5rem);\n  }\n\n  :host([size='lg']) {\n    --_spinner-size: var(--hx-size-8, 2rem);\n  }\n\n  /* ─── Variant Colors ─── */\n\n  :host([variant='default']) {\n    --_spinner-color: var(--hx-spinner-color, var(--hx-color-neutral-600, #475569));\n    --_spinner-track-color: var(--hx-spinner-track-color, var(--hx-color-neutral-200, #e2e8f0));\n  }\n\n  :host([variant='primary']) {\n    --_spinner-color: var(--hx-spinner-color, var(--hx-color-primary-500, #2563eb));\n    --_spinner-track-color: var(--hx-spinner-track-color, var(--hx-color-primary-100, #dbeafe));\n  }\n\n  :host([variant='inverted']) {\n    --_spinner-color: var(--hx-spinner-color, var(--hx-color-neutral-0, #ffffff));\n    /* Fallback for browsers without color-mix() support (Chrome < 111, Firefox < 113, Safari < 16.2).\n       rgba(255, 255, 255, 0.3) approximates the intended 30% white track color. */\n    --_spinner-track-color: var(\n      --hx-spinner-track-color,\n      var(--hx-overlay-white-30, rgba(255, 255, 255, 0.3))\n    );\n  }\n\n  @supports (color: color-mix(in srgb, white 30%, transparent)) {\n    :host([variant='inverted']) {\n      --_spinner-track-color: var(\n        --hx-spinner-track-color,\n        color-mix(in srgb, var(--hx-color-neutral-0, #ffffff) 30%, transparent)\n      );\n    }\n  }\n`;\n","import { LitElement, html } from 'lit';\nimport { customElement, property } from 'lit/decorators.js';\nimport { styleMap } from 'lit/directives/style-map.js';\nimport { ifDefined } from 'lit/directives/if-defined.js';\nimport { tokenStyles } from '@helixui/tokens/lit';\nimport { devWarn } from '../../utils/dev-warn.js';\nimport { helixSpinnerStyles } from './hx-spinner.styles.js';\n\n/**\n * Token size values for the spinner. Use these for standard sizing.\n * The `size` property also accepts any valid CSS size string (e.g. \"3rem\", \"48px\")\n * for custom sizes — the type widens to `string` in that usage.\n */\nexport type SpinnerSize = 'sm' | 'md' | 'lg';\n\n/**\n * A circular loading indicator for inline and overlay loading states.\n * Purely visual — no slots. Announces loading state to screen readers via\n * `role=\"status\"` and an `aria-label` (customizable via the `label` prop).\n *\n * When used alongside visible loading text, set `decorative` to suppress\n * duplicate AT announcements.\n *\n * **WCAG 4.1.2 — `aria-busy` pattern for consumers:**\n * When this spinner indicates that a region of the page is loading, set\n * `aria-busy=\"true\"` on the container element that wraps the loading content\n * and remove it (or set `aria-busy=\"false\"`) once loading completes. This\n * communicates the loading state to assistive technologies at the region level,\n * complementing the spinner's own `role=\"status\"` announcement.\n *\n * ```html\n * <section aria-busy=\"true\" aria-label=\"Patient records\">\n *   <hx-spinner label=\"Loading patient records\"></hx-spinner>\n * </section>\n * ```\n *\n * @summary Circular loading indicator component.\n *\n * @tag hx-spinner\n *\n * @csspart base - The SVG spinner element.\n *\n * @cssprop [--hx-spinner-color] - Spinner arc color. Defaults per variant.\n * @cssprop [--hx-spinner-track-color] - Spinner track color. Defaults per variant.\n * @cssprop [--hx-duration-spinner] - Duration of the rotation animation. Defaults to 750ms.\n */\n@customElement('hx-spinner')\nexport class HelixSpinner extends LitElement {\n  static override styles = [tokenStyles, helixSpinnerStyles];\n\n  /**\n   * Size of the spinner. Accepts `SpinnerSize` token values ('sm' | 'md' | 'lg'),\n   * or any valid CSS size string (e.g. \"3rem\", \"48px\") for custom dimensions.\n   *\n   * The type is `SpinnerSize | string` which widens to `string` at the TypeScript\n   * level — this is intentional to support CSS size overrides. Use `SpinnerSize`\n   * values for standard sizing; custom strings bypass token-based scaling.\n   * @attr hx-size\n   */\n  @property({ type: String, reflect: true, attribute: 'hx-size' })\n  size: 'sm' | 'md' | 'lg' | (string & Record<never, never>) = 'md';\n\n  /**\n   * Visual variant of the spinner.\n   * @attr variant\n   */\n  @property({ type: String, reflect: true })\n  variant: 'default' | 'primary' | 'inverted' = 'default';\n\n  /**\n   * Accessible label announced to screen readers. Defaults to \"Loading\".\n   * Reflected as an attribute for Drupal/Twig compatibility.\n   * @attr label\n   */\n  @property({ type: String, reflect: true })\n  label = 'Loading';\n\n  /**\n   * When true, the spinner is decorative and suppresses all ARIA announcements.\n   * Use this when the spinner appears alongside visible loading text to prevent\n   * duplicate announcements. Sets `role=\"presentation\"` and removes `aria-label`.\n   * @attr decorative\n   */\n  @property({ type: Boolean, reflect: true })\n  decorative = false;\n\n  // ─── Lifecycle ───\n\n  override connectedCallback(): void {\n    super.connectedCallback();\n    // Backward compat: accept legacy `size` attribute. When present and `hx-size`\n    // is not set, map the value and emit a deprecation warning.\n    const legacySize = this.getAttribute('size');\n    if (legacySize !== null && !this.hasAttribute('hx-size')) {\n      devWarn('hx-spinner', 'The \"size\" attribute is deprecated. Use \"hx-size\" instead.');\n      this.size = legacySize;\n    }\n  }\n\n  /** @internal */\n  private _isTokenSize(): this is { size: SpinnerSize } {\n    return this.size === 'sm' || this.size === 'md' || this.size === 'lg';\n  }\n\n  override render() {\n    const customSizeStyle =\n      !this._isTokenSize() && this.size ? styleMap({ '--_spinner-size': this.size }) : styleMap({});\n\n    // Decorative spinners use role=\"presentation\" to suppress AT announcements.\n    // Non-decorative spinners use role=\"status\" with aria-label for accessible naming.\n    // Guard against empty label (aria-label=\"\" is a WCAG failure).\n    const role = this.decorative ? 'presentation' : 'status';\n    const ariaLabel = this.decorative ? undefined : this.label || undefined;\n\n    return html`\n      <div\n        class=\"spinner\"\n        part=\"base\"\n        style=${customSizeStyle}\n        role=${role}\n        aria-label=${ifDefined(ariaLabel)}\n      >\n        <svg\n          class=\"spinner__svg\"\n          viewBox=\"0 0 24 24\"\n          fill=\"none\"\n          aria-hidden=\"true\"\n          focusable=\"false\"\n        >\n          <circle class=\"spinner__track\" cx=\"12\" cy=\"12\" r=\"10\" stroke-width=\"2.5\" fill=\"none\" />\n          <path\n            class=\"spinner__arc\"\n            d=\"M12 2a10 10 0 0 1 10 10\"\n            stroke-width=\"2.5\"\n            stroke-linecap=\"round\"\n            fill=\"none\"\n          />\n        </svg>\n      </div>\n    `;\n  }\n}\n\ndeclare global {\n  interface HTMLElementTagNameMap {\n    'hx-spinner': HelixSpinner;\n  }\n}\n"],"names":["helixSpinnerStyles","css","HelixSpinner","LitElement","legacySize","customSizeStyle","styleMap","role","ariaLabel","html","ifDefined","tokenStyles","__decorateClass","property","customElement"],"mappings":";;;;;AAEO,MAAMA,IAAqBC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;;;;AC6C3B,IAAMC,IAAN,cAA2BC,EAAW;AAAA,EAAtC,cAAA;AAAA,UAAA,GAAA,SAAA,GAaL,KAAA,OAA6D,MAO7D,KAAA,UAA8C,WAQ9C,KAAA,QAAQ,WASR,KAAA,aAAa;AAAA,EAAA;AAAA;AAAA,EAIJ,oBAA0B;AACjC,UAAM,kBAAA;AAGN,UAAMC,IAAa,KAAK,aAAa,MAAM;AAC3C,IAAIA,MAAe,QAAQ,CAAC,KAAK,aAAa,SAAS,MAErD,KAAK,OAAOA;AAAA,EAEhB;AAAA;AAAA,EAGQ,eAA8C;AACpD,WAAO,KAAK,SAAS,QAAQ,KAAK,SAAS,QAAQ,KAAK,SAAS;AAAA,EACnE;AAAA,EAES,SAAS;AAChB,UAAMC,IACJ,CAAC,KAAK,aAAA,KAAkB,KAAK,OAAOC,EAAS,EAAE,mBAAmB,KAAK,KAAA,CAAM,IAAIA,EAAS,CAAA,CAAE,GAKxFC,IAAO,KAAK,aAAa,iBAAiB,UAC1CC,IAAY,KAAK,aAAa,SAAY,KAAK,SAAS;AAE9D,WAAOC;AAAA;AAAA;AAAA;AAAA,gBAIKJ,CAAe;AAAA,eAChBE,CAAI;AAAA,qBACEG,EAAUF,CAAS,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBvC;AACF;AA9FaN,EACK,SAAS,CAACS,GAAaX,CAAkB;AAYzDY,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,QAAQ,SAAS,IAAM,WAAW,WAAW;AAAA,GAZpDX,EAaX,WAAA,QAAA,CAAA;AAOAU,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,QAAQ,SAAS,IAAM;AAAA,GAnB9BX,EAoBX,WAAA,WAAA,CAAA;AAQAU,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,QAAQ,SAAS,IAAM;AAAA,GA3B9BX,EA4BX,WAAA,SAAA,CAAA;AASAU,EAAA;AAAA,EADCC,EAAS,EAAE,MAAM,SAAS,SAAS,IAAM;AAAA,GApC/BX,EAqCX,WAAA,cAAA,CAAA;AArCWA,IAANU,EAAA;AAAA,EADNE,EAAc,YAAY;AAAA,GACdZ,CAAA;"}