@svgrid/grid 1.2.21 → 1.2.23

package/src/SvListBox.svelte

@@ -0,0 +1,122 @@
+<script lang="ts">
+  /**
+   * SvListBox - an inline single/multi-select list (WAI-ARIA listbox) with
+   * roving highlight + full keyboard. Parity: Smart `smart-list-box`. Controlled
+   * via `value` (scalar or array) + `onChange`.
+   */
+  import type { ListOption } from './list-option'
+
+  type Props = {
+    options: ReadonlyArray<ListOption>
+    value?: string | number | Array<string | number> | null
+    onChange?: (value: any) => void
+    multiple?: boolean
+    disabled?: boolean
+    /** Visible height in rows before scrolling. */
+    rows?: number
+    ariaLabel?: string
+  }
+
+  let { options, value = null, onChange, multiple = false, disabled = false, rows = 7, ariaLabel }: Props = $props()
+
+  const selected = $derived<Array<string | number>>(
+    multiple ? (Array.isArray(value) ? value : value == null ? [] : [value]) : value == null ? [] : [value as string | number],
+  )
+  const enabledIdx = $derived(options.map((o, i) => (o.disabled ? -1 : i)).filter((i) => i >= 0))
+  let active = $state(0)
+  $effect(() => {
+    // Keep the active index on an enabled option.
+    if (!options[active] || options[active]!.disabled) active = enabledIdx[0] ?? 0
+  })
+
+  function isSel(o: ListOption) { return selected.includes(o.value) }
+
+  function pick(i: number) {
+    const o = options[i]
+    if (!o || o.disabled || disabled) return
+    active = i
+    if (multiple) {
+      const set = new Set(selected)
+      set.has(o.value) ? set.delete(o.value) : set.add(o.value)
+      onChange?.([...set])
+    } else {
+      onChange?.(o.value)
+    }
+  }
+
+  function move(delta: number) {
+    const pos = enabledIdx.indexOf(active)
+    const next = enabledIdx[(pos + delta + enabledIdx.length) % enabledIdx.length]
+    if (next != null) { active = next; scrollActive() }
+  }
+
+  let listEl: HTMLUListElement | null = null
+  function scrollActive() {
+    queueMicrotask(() => listEl?.querySelector<HTMLElement>(`[data-idx="${active}"]`)?.scrollIntoView({ block: 'nearest' }))
+  }
+
+  function onKeydown(e: KeyboardEvent) {
+    if (disabled) return
+    switch (e.key) {
+      case 'ArrowDown': e.preventDefault(); move(1); break
+      case 'ArrowUp': e.preventDefault(); move(-1); break
+      case 'Home': e.preventDefault(); active = enabledIdx[0] ?? 0; scrollActive(); break
+      case 'End': e.preventDefault(); active = enabledIdx.at(-1) ?? 0; scrollActive(); break
+      case ' ':
+      case 'Enter': e.preventDefault(); pick(active); break
+    }
+  }
+</script>
+
+<ul
+  bind:this={listEl}
+  class="sv-listbox"
+  role="listbox"
+  aria-multiselectable={multiple}
+  aria-label={ariaLabel}
+  aria-disabled={disabled}
+  tabindex={disabled ? -1 : 0}
+  style:--sv-rows={rows}
+  onkeydown={onKeydown}
+>
+  {#each options as opt, i (opt.value)}
+    <!-- svelte-ignore a11y_click_events_have_key_events a11y_interactive_supports_focus -->
+    <li
+      class="sv-listbox__opt"
+      class:is-selected={isSel(opt)}
+      class:is-active={i === active}
+      class:is-disabled={opt.disabled}
+      role="option"
+      aria-selected={isSel(opt)}
+      aria-disabled={opt.disabled}
+      data-idx={i}
+      onclick={() => pick(i)}
+      onpointermove={() => { if (!opt.disabled) active = i }}
+    >
+      {#if multiple}<span class="sv-listbox__check" aria-hidden="true">{isSel(opt) ? '✓' : ''}</span>{/if}
+      <span class="sv-listbox__label">{opt.label}</span>
+    </li>
+  {/each}
+</ul>
+
+<style>
+  .sv-listbox {
+    --_accent: var(--sg-accent, #2563eb);
+    margin: 0; padding: 4px; list-style: none;
+    max-height: calc(var(--sv-rows, 7) * 32px + 8px); overflow-y: auto;
+    background: var(--sg-input-bg, #fff); color: var(--sg-fg, #0f172a);
+    border: 1px solid var(--sg-input-border, var(--sg-border, #cbd5e1)); border-radius: var(--sg-radius, 8px);
+    width: 220px; outline: none;
+  }
+  .sv-listbox:focus-visible { border-color: var(--_accent); box-shadow: 0 0 0 2px color-mix(in srgb, var(--_accent) 22%, transparent); }
+  .sv-listbox__opt {
+    display: flex; align-items: center; gap: 8px; height: 32px; padding: 0 10px;
+    border-radius: 6px; cursor: pointer; font-size: 13px;
+  }
+  .sv-listbox__opt.is-active { background: var(--sg-row-hover-bg, #f1f5f9); }
+  .sv-listbox__opt.is-selected { background: color-mix(in srgb, var(--_accent) 14%, transparent); color: var(--_accent); font-weight: 600; }
+  .sv-listbox__opt.is-selected.is-active { background: color-mix(in srgb, var(--_accent) 22%, transparent); }
+  .sv-listbox__opt.is-disabled { opacity: 0.4; cursor: not-allowed; }
+  .sv-listbox__check { width: 14px; text-align: center; color: var(--_accent); }
+  .sv-listbox__label { flex: 1; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+</style>

package/src/SvPasswordInput.svelte

@@ -0,0 +1,110 @@
+<script lang="ts">
+  /**
+   * SvPasswordInput - a password field with a reveal toggle and an optional
+   * strength meter. Parity: Smart `smart-password-input`. Emits the string value.
+   */
+  type Props = {
+    value?: string
+    onChange?: (value: string) => void
+    placeholder?: string
+    disabled?: boolean
+    readonly?: boolean
+    /** Show the show/hide eye toggle. */
+    revealable?: boolean
+    /** Show a 4-level strength meter. */
+    showStrength?: boolean
+    name?: string
+    size?: 'sm' | 'md' | 'lg'
+    ariaLabel?: string
+    autocomplete?: string
+  }
+
+  let {
+    value = '',
+    onChange,
+    placeholder,
+    disabled = false,
+    readonly = false,
+    revealable = true,
+    showStrength = false,
+    name,
+    size = 'md',
+    ariaLabel,
+    autocomplete = 'current-password',
+  }: Props = $props()
+
+  let revealed = $state(false)
+
+  // Simple strength heuristic: length + character-class variety (0-4).
+  const strength = $derived.by(() => {
+    const v = value
+    if (!v) return 0
+    let score = 0
+    if (v.length >= 8) score++
+    if (/[a-z]/.test(v) && /[A-Z]/.test(v)) score++
+    if (/\d/.test(v)) score++
+    if (/[^a-zA-Z0-9]/.test(v)) score++
+    return score
+  })
+  const strengthLabel = ['', 'Weak', 'Fair', 'Good', 'Strong']
+</script>
+
+<div class="sv-pw sv-pw--{size}" class:is-disabled={disabled}>
+  <div class="sv-pw__field">
+    <input
+      class="sv-pw__input"
+      type={revealed ? 'text' : 'password'}
+      value={value}
+      {placeholder}
+      {disabled}
+      {readonly}
+      autocomplete={autocomplete as AutoFill}
+      aria-label={ariaLabel}
+      oninput={(e) => onChange?.((e.currentTarget as HTMLInputElement).value)}
+    />
+    {#if revealable}
+      <button type="button" class="sv-pw__eye" aria-label={revealed ? 'Hide password' : 'Show password'} aria-pressed={revealed} onclick={() => (revealed = !revealed)} disabled={disabled} tabindex="-1">
+        {#if revealed}
+          <svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M17.94 17.94A10.07 10.07 0 0 1 12 20c-7 0-11-8-11-8a18.45 18.45 0 0 1 5.06-5.94M9.9 4.24A9.12 9.12 0 0 1 12 4c7 0 11 8 11 8a18.5 18.5 0 0 1-2.16 3.19m-6.72-1.07a3 3 0 1 1-4.24-4.24" /><path d="M1 1l22 22" /></svg>
+        {:else}
+          <svg viewBox="0 0 24 24" width="16" height="16" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M1 12s4-8 11-8 11 8 11 8-4 8-11 8-11-8-11-8z" /><circle cx="12" cy="12" r="3" /></svg>
+        {/if}
+      </button>
+    {/if}
+  </div>
+  {#if showStrength}
+    <div class="sv-pw__meter" aria-hidden="true">
+      {#each Array(4) as _, i (i)}
+        <span class="sv-pw__bar is-lvl{strength}" class:on={i < strength}></span>
+      {/each}
+    </div>
+    <span class="sv-pw__strength is-lvl{strength}">{strengthLabel[strength]}</span>
+  {/if}
+  {#if name}<input type="hidden" {name} value={value} />{/if}
+</div>
+
+<style>
+  .sv-pw { --_accent: var(--sg-accent, #2563eb); display: inline-flex; flex-direction: column; gap: 5px; width: 220px; }
+  .sv-pw.is-disabled { opacity: 0.6; }
+  .sv-pw__field {
+    display: flex; align-items: center;
+    background: var(--sg-input-bg, #fff); color: var(--sg-fg, #0f172a);
+    border: 1px solid var(--sg-input-border, var(--sg-border, #cbd5e1)); border-radius: var(--sg-radius, 8px);
+  }
+  .sv-pw__field:focus-within { border-color: var(--_accent); box-shadow: 0 0 0 2px color-mix(in srgb, var(--_accent) 22%, transparent); }
+  .sv-pw__input { flex: 1; min-width: 0; border: 0; background: none; outline: none; color: inherit; font: inherit; padding: 0 10px; }
+  .sv-pw--sm .sv-pw__field { height: 28px; font-size: 12px; }
+  .sv-pw--md .sv-pw__field { height: 34px; font-size: 13px; }
+  .sv-pw--lg .sv-pw__field { height: 40px; font-size: 15px; }
+  .sv-pw__eye { display: grid; place-items: center; width: 32px; align-self: stretch; background: none; border: 0; color: var(--sg-muted, #64748b); cursor: pointer; }
+  .sv-pw__eye:hover { color: var(--_accent); }
+  .sv-pw__meter { display: flex; gap: 4px; }
+  .sv-pw__bar { flex: 1; height: 4px; border-radius: 2px; background: var(--sg-border, #e2e8f0); transition: background 0.15s; }
+  .sv-pw__bar.on.is-lvl1 { background: #dc2626; }
+  .sv-pw__bar.on.is-lvl2 { background: #f59e0b; }
+  .sv-pw__bar.on.is-lvl3 { background: #eab308; }
+  .sv-pw__bar.on.is-lvl4 { background: #16a34a; }
+  .sv-pw__strength { font-size: 11px; font-weight: 600; color: var(--sg-muted, #64748b); }
+  .sv-pw__strength.is-lvl1 { color: #dc2626; }
+  .sv-pw__strength.is-lvl4 { color: #16a34a; }
+</style>

package/src/SvRadioGroup.svelte

@@ -0,0 +1,108 @@
+<script lang="ts" module>
+  export type RadioOption = { value: string | number; label: string; disabled?: boolean }
+</script>
+
+<script lang="ts">
+  /**
+   * SvRadioGroup - an accessible radio group (WAI-ARIA radiogroup pattern) with
+   * roving tabindex + arrow-key navigation. Parity: Smart `smart-radio-button`
+   * (as a managed group). Controlled via `value` + `onChange`.
+   */
+  type Props = {
+    options: ReadonlyArray<RadioOption>
+    value?: string | number | null
+    onChange?: (value: string | number) => void
+    name?: string
+    disabled?: boolean
+    orientation?: 'vertical' | 'horizontal'
+    size?: 'sm' | 'md' | 'lg'
+    ariaLabel?: string
+  }
+
+  let {
+    options,
+    value = null,
+    onChange,
+    name,
+    disabled = false,
+    orientation = 'vertical',
+    size = 'md',
+    ariaLabel,
+  }: Props = $props()
+
+  const enabledIdx = $derived(options.map((o, i) => (o.disabled ? -1 : i)).filter((i) => i >= 0))
+  const selectedIdx = $derived(options.findIndex((o) => o.value === value))
+  // The roving-tabindex target: the selected option, else the first enabled.
+  const focusIdx = $derived(selectedIdx >= 0 ? selectedIdx : enabledIdx[0] ?? -1)
+
+  function pick(i: number) {
+    const o = options[i]
+    if (!o || o.disabled || disabled) return
+    onChange?.(o.value)
+  }
+
+  function onKeydown(e: KeyboardEvent, i: number) {
+    if (disabled) return
+    const pos = enabledIdx.indexOf(i)
+    if (pos < 0) return
+    let nextPos = pos
+    if (e.key === 'ArrowDown' || e.key === 'ArrowRight') nextPos = (pos + 1) % enabledIdx.length
+    else if (e.key === 'ArrowUp' || e.key === 'ArrowLeft') nextPos = (pos - 1 + enabledIdx.length) % enabledIdx.length
+    else if (e.key === ' ') { e.preventDefault(); pick(i); return }
+    else return
+    e.preventDefault()
+    const target = enabledIdx[nextPos]!
+    pick(target)
+    ;(e.currentTarget as HTMLElement).parentElement?.querySelectorAll<HTMLElement>('.sv-radio')[target]?.focus()
+  }
+</script>
+
+<div
+  class="sv-radiogroup sv-radiogroup--{orientation} sv-radiogroup--{size}"
+  role="radiogroup"
+  aria-label={ariaLabel}
+  aria-disabled={disabled}
+>
+  {#each options as opt, i (opt.value)}
+    <button
+      type="button"
+      role="radio"
+      class="sv-radio"
+      class:is-checked={opt.value === value}
+      aria-checked={opt.value === value}
+      disabled={disabled || opt.disabled}
+      tabindex={i === focusIdx ? 0 : -1}
+      onclick={() => pick(i)}
+      onkeydown={(e) => onKeydown(e, i)}
+    >
+      <span class="sv-radio__dot"></span>
+      <span class="sv-radio__label">{opt.label}</span>
+    </button>
+  {/each}
+  {#if name}<input type="hidden" {name} value={value ?? ''} />{/if}
+</div>
+
+<style>
+  .sv-radiogroup { --_accent: var(--sg-accent, #2563eb); display: flex; gap: 10px; }
+  .sv-radiogroup--vertical { flex-direction: column; }
+  .sv-radiogroup--horizontal { flex-direction: row; flex-wrap: wrap; }
+  .sv-radio {
+    display: inline-flex; align-items: center; gap: 8px; background: none; border: 0; padding: 2px;
+    font: inherit; color: var(--sg-fg, #0f172a); cursor: pointer; user-select: none;
+  }
+  .sv-radiogroup--sm .sv-radio { font-size: 12px; }
+  .sv-radiogroup--md .sv-radio { font-size: 13px; }
+  .sv-radiogroup--lg .sv-radio { font-size: 15px; }
+  .sv-radio[disabled] { opacity: 0.5; cursor: not-allowed; }
+  .sv-radio__dot {
+    width: 17px; height: 17px; flex: none; border-radius: 50%;
+    border: 1.5px solid var(--sg-border, #cbd5e1); background: var(--sg-input-bg, #fff);
+    display: grid; place-items: center; transition: border-color 0.12s;
+  }
+  .sv-radio.is-checked .sv-radio__dot { border-color: var(--_accent); }
+  .sv-radio.is-checked .sv-radio__dot::after {
+    content: ''; width: 9px; height: 9px; border-radius: 50%; background: var(--_accent);
+  }
+  .sv-radio:focus-visible { outline: none; }
+  .sv-radio:focus-visible .sv-radio__dot { outline: 2px solid var(--sg-focus-ring, var(--_accent)); outline-offset: 2px; }
+</style>

package/src/SvRating.svelte

@@ -0,0 +1,111 @@
+<script lang="ts">
+  /**
+   * SvRating - a star rating control (WAI-ARIA slider). Parity: Smart
+   * `smart-rating`. Hover preview, keyboard, optional half steps, readOnly.
+   * Uses the grid's `--sg-rating-*` tokens so it matches the in-grid editor.
+   */
+  type Props = {
+    value?: number
+    onChange?: (value: number) => void
+    max?: number
+    /** Allow half-star precision. */
+    allowHalf?: boolean
+    readOnly?: boolean
+    disabled?: boolean
+    size?: 'sm' | 'md' | 'lg'
+    name?: string
+    ariaLabel?: string
+  }
+
+  let {
+    value = 0,
+    onChange,
+    max = 5,
+    allowHalf = false,
+    readOnly = false,
+    disabled = false,
+    size = 'md',
+    name,
+    ariaLabel,
+  }: Props = $props()
+
+  let hover = $state<number | null>(null)
+  const isInteractive = $derived(!readOnly && !disabled)
+  const shown = $derived(hover ?? value)
+
+  function valueAt(e: MouseEvent, index: number): number {
+    if (!allowHalf) return index + 1
+    const el = e.currentTarget as HTMLElement
+    const rect = el.getBoundingClientRect()
+    return e.clientX - rect.left < rect.width / 2 ? index + 0.5 : index + 1
+  }
+
+  function fillOf(index: number): 'full' | 'half' | 'empty' {
+    if (shown >= index + 1) return 'full'
+    if (shown >= index + 0.5) return 'half'
+    return 'empty'
+  }
+
+  function onKeydown(e: KeyboardEvent) {
+    if (!isInteractive) return
+    const step = allowHalf ? 0.5 : 1
+    if (e.key === 'ArrowRight' || e.key === 'ArrowUp') { e.preventDefault(); onChange?.(Math.min(max, value + step)) }
+    else if (e.key === 'ArrowLeft' || e.key === 'ArrowDown') { e.preventDefault(); onChange?.(Math.max(0, value - step)) }
+    else if (e.key === 'Home') { e.preventDefault(); onChange?.(0) }
+    else if (e.key === 'End') { e.preventDefault(); onChange?.(max) }
+  }
+</script>
+
+<div
+  class="sv-rating sv-rating--{size}"
+  class:is-readonly={readOnly}
+  class:is-disabled={disabled}
+  role="slider"
+  tabindex={isInteractive ? 0 : -1}
+  aria-label={ariaLabel ?? 'Rating'}
+  aria-valuenow={value}
+  aria-valuemin="0"
+  aria-valuemax={max}
+  aria-readonly={readOnly}
+  onkeydown={onKeydown}
+  onpointerleave={() => (hover = null)}
+>
+  {#each Array(max) as _, i (i)}
+    <button
+      type="button"
+      class="sv-rating__star is-{fillOf(i)}"
+      tabindex="-1"
+      disabled={!isInteractive}
+      aria-label={`${i + 1} star${i ? 's' : ''}`}
+      onpointermove={(e) => { if (isInteractive) hover = valueAt(e, i) }}
+      onclick={(e) => { if (isInteractive) onChange?.(valueAt(e, i)) }}
+    >
+      <svg viewBox="0 0 24 24" aria-hidden="true">
+        <defs>
+          <linearGradient id="half-{i}"><stop offset="50%" stop-color="var(--_on)" /><stop offset="50%" stop-color="var(--_off)" /></linearGradient>
+        </defs>
+        <path d="M12 2.5l2.9 6.1 6.6.9-4.8 4.6 1.2 6.6L12 18.6 6.1 21.7l1.2-6.6L2.5 9.5l6.6-.9z"
+          fill={fillOf(i) === 'full' ? 'var(--_on)' : fillOf(i) === 'half' ? `url(#half-${i})` : 'var(--_off)'} />
+      </svg>
+    </button>
+  {/each}
+  {#if name}<input type="hidden" {name} value={value} />{/if}
+</div>
+
+<style>
+  .sv-rating {
+    --_on: var(--sg-rating-on, #f59e0b);
+    --_off: var(--sg-rating-empty, #d1d5db);
+    --_sz: 22px;
+    display: inline-flex; gap: 2px; align-items: center;
+  }
+  .sv-rating--sm { --_sz: 16px; }
+  .sv-rating--lg { --_sz: 30px; }
+  .sv-rating.is-disabled { opacity: 0.5; }
+  .sv-rating__star {
+    width: var(--_sz); height: var(--_sz); padding: 0; border: 0; background: none; cursor: pointer; line-height: 0;
+  }
+  .sv-rating.is-readonly .sv-rating__star, .sv-rating.is-disabled .sv-rating__star { cursor: default; }
+  .sv-rating__star svg { width: 100%; height: 100%; }
+  .sv-rating:focus-visible { outline: 2px solid var(--sg-focus-ring, var(--sg-accent, #2563eb)); outline-offset: 2px; border-radius: 4px; }
+</style>

package/src/SvRepeatButton.svelte

@@ -0,0 +1,89 @@
+<script lang="ts">
+  /**
+   * SvRepeatButton - fires `onclick` repeatedly while held down (after an
+   * initial delay, then at a steady interval). Parity: Smart `smart-repeat-button`.
+   * Used for spinners / steppers.
+   */
+  import type { Snippet } from 'svelte'
+
+  type Props = {
+    onclick?: () => void
+    /** Delay before repeats begin (ms). */
+    delay?: number
+    /** Interval between repeats (ms). */
+    interval?: number
+    disabled?: boolean
+    size?: 'sm' | 'md' | 'lg'
+    variant?: 'primary' | 'secondary' | 'outline' | 'ghost'
+    ariaLabel?: string
+    children?: Snippet
+  }
+
+  let {
+    onclick,
+    delay = 300,
+    interval = 60,
+    disabled = false,
+    size = 'md',
+    variant = 'secondary',
+    ariaLabel,
+    children,
+  }: Props = $props()
+
+  let delayTimer: ReturnType<typeof setTimeout> | null = null
+  let repeatTimer: ReturnType<typeof setInterval> | null = null
+
+  function stop() {
+    if (delayTimer) { clearTimeout(delayTimer); delayTimer = null }
+    if (repeatTimer) { clearInterval(repeatTimer); repeatTimer = null }
+  }
+
+  function start(e: PointerEvent) {
+    if (disabled || e.button !== 0) return
+    onclick?.() // fire once immediately
+    delayTimer = setTimeout(() => {
+      repeatTimer = setInterval(() => onclick?.(), Math.max(16, interval))
+    }, Math.max(0, delay))
+  }
+
+  function onKeydown(e: KeyboardEvent) {
+    if (disabled) return
+    if ((e.key === 'Enter' || e.key === ' ') && !e.repeat) { e.preventDefault(); onclick?.() }
+  }
+</script>
+
+<svelte:window onpointerup={stop} onpointercancel={stop} />
+
+<button
+  type="button"
+  class="sv-btn sv-btn--{variant} sv-btn--{size} sv-repeat"
+  {disabled}
+  aria-label={ariaLabel}
+  onpointerdown={start}
+  onpointerleave={stop}
+  onkeydown={onKeydown}
+>
+  {#if children}{@render children()}{/if}
+</button>
+
+<style>
+  /* Reuses the SvButton visual language (kept local so it works standalone). */
+  .sv-btn {
+    --_accent: var(--sg-accent, #2563eb);
+    --_border: var(--sg-border, #cbd5e1);
+    --_radius: var(--sg-radius, 8px);
+    display: inline-flex; align-items: center; justify-content: center; gap: 6px;
+    font: inherit; font-weight: 600; line-height: 1; border: 1px solid transparent;
+    border-radius: var(--_radius); cursor: pointer; user-select: none; touch-action: none;
+  }
+  .sv-btn--sm { padding: 5px 9px; font-size: 12px; }
+  .sv-btn--md { padding: 8px 12px; font-size: 13px; }
+  .sv-btn--lg { padding: 11px 16px; font-size: 15px; }
+  .sv-btn[disabled] { opacity: 0.55; cursor: not-allowed; }
+  .sv-btn--primary { background: var(--_accent); color: var(--sg-on-accent, #fff); }
+  .sv-btn--secondary { background: var(--sg-header-bg, #f1f5f9); color: var(--sg-fg, #0f172a); border-color: var(--_border); }
+  .sv-btn--outline { background: transparent; color: var(--_accent); border-color: var(--_accent); }
+  .sv-btn--ghost { background: transparent; color: var(--sg-fg, #0f172a); }
+  .sv-btn:focus-visible { outline: 2px solid var(--sg-focus-ring, var(--_accent)); outline-offset: 2px; }
+  .sv-btn:active { transform: translateY(0.5px); }
+</style>