@svgrid/grid 3.0.0 → 3.0.2

package/src/SvToggleButton.svelte

@@ -1,85 +1,85 @@
-<script lang="ts">
-  /**
-   * SvToggleButton - a button with a pressed on/off state (aria-pressed).
-   * Parity: Smart `smart-toggle-button`. Controlled via `pressed` + `onChange`.
-   */
-  import type { Snippet } from 'svelte'
-  import SvField from './SvField.svelte'
-  import { nextEditorId, type SvEditorProps } from './editor-contract'
-  import { createToggle } from './createToggle.svelte'
-
-  type Props = SvEditorProps & {
-    pressed?: boolean
-    onChange?: (pressed: boolean) => void
-    children?: Snippet
-  }
-
-  let {
-    pressed = false,
-    onChange,
-    disabled = false,
-    readonly = false,
-    size = 'md',
-    ariaLabel,
-    invalid = false,
-    required = false,
-    error,
-    label,
-    hint,
-    dir,
-    id,
-    children,
-  }: Props = $props()
-
-  const autoId = nextEditorId('sv-toggle')
-  const uid = $derived(id ?? autoId)
-
-  // The styled toggle is just a renderer over the headless core.
-  const t = createToggle({
-    pressed: () => pressed,
-    onChange: (v) => { if (readonly) return; onChange?.(v) },
-    disabled: () => disabled,
-    ariaLabel: () => ariaLabel,
-    id: () => uid,
-    invalid: () => invalid,
-    required: () => required,
-    error: () => error,
-    hint: () => hint,
-  })
-</script>
-
-<SvField id={uid} {label} {hint} {error} {required} {dir}>
-  <button
-    class="sv-toggle sv-toggle--{size}"
-    class:is-pressed={pressed}
-    class:is-invalid={invalid}
-    class:is-readonly={readonly}
-    {...t.buttonProps()}
-  >
-    {#if children}{@render children()}{/if}
-  </button>
-</SvField>
-
-<style>
-  .sv-toggle {
-    --_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;
-    background: var(--sg-bg, #fff); color: var(--sg-fg, #0f172a);
-    border: 1px solid var(--_border); border-radius: var(--_radius); cursor: pointer; user-select: none;
-    transition: background 0.12s, border-color 0.12s, color 0.12s;
-  }
-  .sv-toggle--sm { padding: 5px 10px; font-size: 12px; }
-  .sv-toggle--md { padding: 8px 13px; font-size: 13px; }
-  .sv-toggle--lg { padding: 11px 17px; font-size: 15px; }
-  .sv-toggle:hover:not([disabled]):not(.is-pressed) { background: var(--sg-row-hover-bg, #f1f5f9); }
-  .sv-toggle.is-pressed {
-    background: var(--_accent); color: var(--sg-on-accent, #fff); border-color: var(--_accent);
-  }
-  .sv-toggle[disabled] { opacity: 0.55; cursor: not-allowed; }
-  .sv-toggle.is-readonly { cursor: default; }
-  .sv-toggle.is-invalid { border-color: var(--sg-danger, #dc2626); }
-  .sv-toggle:focus-visible { outline: 2px solid var(--sg-focus-ring, var(--_accent)); outline-offset: 2px; }
-</style>
+<script lang="ts">
+  /**
+   * SvToggleButton - a button with a pressed on/off state (aria-pressed).
+   * Parity: Smart `smart-toggle-button`. Controlled via `pressed` + `onChange`.
+   */
+  import type { Snippet } from 'svelte'
+  import SvField from './SvField.svelte'
+  import { nextEditorId, type SvEditorProps } from './editor-contract'
+  import { createToggle } from './createToggle.svelte'
+
+  type Props = SvEditorProps & {
+    pressed?: boolean
+    onChange?: (pressed: boolean) => void
+    children?: Snippet
+  }
+
+  let {
+    pressed = false,
+    onChange,
+    disabled = false,
+    readonly = false,
+    size = 'md',
+    ariaLabel,
+    invalid = false,
+    required = false,
+    error,
+    label,
+    hint,
+    dir,
+    id,
+    children,
+  }: Props = $props()
+
+  const autoId = nextEditorId('sv-toggle')
+  const uid = $derived(id ?? autoId)
+
+  // The styled toggle is just a renderer over the headless core.
+  const t = createToggle({
+    pressed: () => pressed,
+    onChange: (v) => { if (readonly) return; onChange?.(v) },
+    disabled: () => disabled,
+    ariaLabel: () => ariaLabel,
+    id: () => uid,
+    invalid: () => invalid,
+    required: () => required,
+    error: () => error,
+    hint: () => hint,
+  })
+</script>
+
+<SvField id={uid} {label} {hint} {error} {required} {dir}>
+  <button
+    class="sv-toggle sv-toggle--{size}"
+    class:is-pressed={pressed}
+    class:is-invalid={invalid}
+    class:is-readonly={readonly}
+    {...t.buttonProps()}
+  >
+    {#if children}{@render children()}{/if}
+  </button>
+</SvField>
+
+<style>
+  .sv-toggle {
+    --_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;
+    background: var(--sg-bg, #fff); color: var(--sg-fg, #0f172a);
+    border: 1px solid var(--_border); border-radius: var(--_radius); cursor: pointer; user-select: none;
+    transition: background 0.12s, border-color 0.12s, color 0.12s;
+  }
+  .sv-toggle--sm { padding: 5px 10px; font-size: 12px; }
+  .sv-toggle--md { padding: 8px 13px; font-size: 13px; }
+  .sv-toggle--lg { padding: 11px 17px; font-size: 15px; }
+  .sv-toggle:hover:not([disabled]):not(.is-pressed) { background: var(--sg-row-hover-bg, #f1f5f9); }
+  .sv-toggle.is-pressed {
+    background: var(--_accent); color: var(--sg-on-accent, #fff); border-color: var(--_accent);
+  }
+  .sv-toggle[disabled] { opacity: 0.55; cursor: not-allowed; }
+  .sv-toggle.is-readonly { cursor: default; }
+  .sv-toggle.is-invalid { border-color: var(--sg-danger, #dc2626); }
+  .sv-toggle:focus-visible { outline: 2px solid var(--sg-focus-ring, var(--_accent)); outline-offset: 2px; }
+</style>

package/src/SvTooltip.svelte

@@ -1,161 +1,161 @@
-<script lang="ts">
-  /**
-   * SvTooltip - a small hover/focus tooltip anchored to its child, portalled to
-   * <body> so it is never clipped. Positioned by the shared engine (full placement
-   * matrix + flip + shift + arrow), shows after a short delay, hides on leave /
-   * blur / Escape, and is wired via `aria-describedby` (role="tooltip") onto the
-   * focusable child itself, so AT users get it announced on focus, not just
-   * sighted users on hover.
-   *
-   * Set `group` on several tooltips so scanning between them skips the re-delay,
-   * `closeDelay` + `interactive` for a hoverable tip (e.g. one with a link).
-   *
-   * ```svelte
-   * <SvTooltip text="Delete row"><button aria-label="Delete">🗑</button></SvTooltip>
-   * ```
-   */
-  import type { Snippet } from 'svelte'
-  import { portalToBody, popIn } from './popover'
-  import { computePosition, autoUpdate, type Placement, type ComputePositionResult } from './positioning'
-  import { getFocusable } from './a11y/focus-trap'
-  import { createTooltip } from './createTooltip.svelte'
-
-  type Props = {
-    text: string
-    /** Preferred placement; flips when there is no room. Default `top`. */
-    placement?: Placement
-    /** Show delay in ms. Default 300. */
-    delay?: number
-    /** Hide delay in ms after leave (give it room for an interactive tip). Default 0. */
-    closeDelay?: number
-    /** Delay-group id: grouped tooltips open instantly while the group is warm. */
-    group?: string
-    /** Let the pointer move onto the tip without closing it (e.g. a tip with a link). */
-    interactive?: boolean
-    disabled?: boolean
-    children?: Snippet
-  }
-
-  let {
-    text,
-    placement = 'top',
-    delay = 300,
-    closeDelay = 0,
-    group,
-    interactive = false,
-    disabled = false,
-    children,
-  }: Props = $props()
-
-  const ARROW = 8
-
-  let anchorEl = $state<HTMLSpanElement | null>(null)
-  let tipEl = $state<HTMLDivElement | null>(null)
-  let pos = $state<ComputePositionResult>({
-    x: 0, y: 0, placement, side: 'top', align: 'center', maxWidth: 0, maxHeight: 0, arrow: { x: 12 },
-  })
-
-  // Open state, show/close delay, delay-group and Escape-to-hide live in the
-  // shared headless core; this component owns only the DOM concerns (positioning
-  // + describedby merge). Interactive tips get a small closeDelay by default so
-  // the pointer can travel from anchor to tip.
-  const tip = createTooltip({
-    text: () => text,
-    disabled: () => disabled,
-    delay: () => delay,
-    closeDelay: () => (closeDelay || (interactive ? 120 : 0)),
-    group: () => group,
-  })
-  const tid = tip.tipId
-
-  function place() {
-    if (!anchorEl) return
-    const r = anchorEl.getBoundingClientRect()
-    const floating = { width: tipEl?.offsetWidth || 0, height: tipEl?.offsetHeight || 30 }
-    pos = computePosition(
-      { x: r.left, y: r.top, width: r.width, height: r.height },
-      floating,
-      { placement, offset: 8, padding: 4, arrow: { size: ARROW } },
-    )
-  }
-
-  // Reposition while open (measure the tip after it mounts, then keep in sync).
-  $effect(() => {
-    if (!tip.open || !anchorEl || !tipEl) return
-    queueMicrotask(place)
-    const stop = autoUpdate(anchorEl, tipEl, place)
-    return () => stop()
-  })
-
-  // The wrapper span above is never itself Tab-focusable, so putting
-  // aria-describedby only on it does nothing for keyboard/AT users - they
-  // focus the real interactive child (e.g. the <button> in the doc example),
-  // and that's the element whose accessible description actually gets
-  // announced. Mirror the id onto that child too, merging with (and later
-  // restoring) any aria-describedby it already carries.
-  $effect(() => {
-    if (!tip.open || !anchorEl) return
-    const child = getFocusable(anchorEl)[0]
-    if (!child) return
-    const before = child.getAttribute('aria-describedby')
-    const ids = new Set((before ?? '').split(/\s+/).filter(Boolean))
-    ids.add(tid)
-    child.setAttribute('aria-describedby', [...ids].join(' '))
-    return () => {
-      const remaining = (child.getAttribute('aria-describedby') ?? '')
-        .split(/\s+/)
-        .filter((id) => id && id !== tid)
-      if (remaining.length) child.setAttribute('aria-describedby', remaining.join(' '))
-      else child.removeAttribute('aria-describedby')
-    }
-  })
-</script>
-
-<!-- svelte-ignore a11y_no_static_element_interactions -->
-<span
-  bind:this={anchorEl}
-  class="sv-tip__anchor"
-  {...tip.anchorProps()}
->
-  {@render children?.()}
-</span>
-
-{#if tip.open}
-  <div
-    bind:this={tipEl}
-    id={tid}
-    class="sv-tip sv-tip--{pos.side}"
-    class:sv-tip--interactive={interactive}
-    role="tooltip"
-    use:portalToBody
-    use:popIn={{ up: pos.side === 'top', duration: 110, scale: 0.9 }}
-    style:position="fixed"
-    style:top={`${pos.y}px`}
-    style:left={`${pos.x}px`}
-    style:--tip-arrow-x={pos.arrow?.x != null ? `${pos.arrow.x}px` : undefined}
-    style:--tip-arrow-y={pos.arrow?.y != null ? `${pos.arrow.y}px` : undefined}
-    onpointerenter={interactive ? tip.keepOpen : undefined}
-    onpointerleave={interactive ? tip.scheduleHide : undefined}
-  >{text}<span class="sv-tip__arrow" aria-hidden="true"></span></div>
-{/if}
-
-<style>
-  .sv-tip__anchor { display: inline-flex; }
-  :global(.sv-tip) {
-    z-index: 2147483647; pointer-events: none; position: relative;
-    max-width: 240px; padding: 5px 9px; font-size: 12px; line-height: 1.4; font-weight: 500;
-    background: var(--sg-fg, #0f172a); color: var(--sg-bg, #fff);
-    border-radius: 6px; box-shadow: 0 6px 20px -6px rgba(15, 23, 42, 0.5); white-space: normal;
-  }
-  :global(.sv-tip--interactive) { pointer-events: auto; }
-  :global(.sv-tip__arrow) {
-    position: absolute; width: 8px; height: 8px;
-    background: var(--sg-fg, #0f172a); transform: rotate(45deg);
-  }
-  /* Arrow sits on the edge facing the anchor. top/bottom use --tip-arrow-x,
-     left/right use --tip-arrow-y. */
-  :global(.sv-tip--top .sv-tip__arrow) { bottom: -3px; inset-inline-start: var(--tip-arrow-x, 12px); }
-  :global(.sv-tip--bottom .sv-tip__arrow) { top: -3px; inset-inline-start: var(--tip-arrow-x, 12px); }
-  :global(.sv-tip--left .sv-tip__arrow) { right: -3px; top: var(--tip-arrow-y, 12px); }
-  :global(.sv-tip--right .sv-tip__arrow) { left: -3px; top: var(--tip-arrow-y, 12px); }
-</style>
+<script lang="ts">
+  /**
+   * SvTooltip - a small hover/focus tooltip anchored to its child, portalled to
+   * <body> so it is never clipped. Positioned by the shared engine (full placement
+   * matrix + flip + shift + arrow), shows after a short delay, hides on leave /
+   * blur / Escape, and is wired via `aria-describedby` (role="tooltip") onto the
+   * focusable child itself, so AT users get it announced on focus, not just
+   * sighted users on hover.
+   *
+   * Set `group` on several tooltips so scanning between them skips the re-delay,
+   * `closeDelay` + `interactive` for a hoverable tip (e.g. one with a link).
+   *
+   * ```svelte
+   * <SvTooltip text="Delete row"><button aria-label="Delete">🗑</button></SvTooltip>
+   * ```
+   */
+  import type { Snippet } from 'svelte'
+  import { portalToBody, popIn } from './popover'
+  import { computePosition, autoUpdate, type Placement, type ComputePositionResult } from './positioning'
+  import { getFocusable } from './a11y/focus-trap'
+  import { createTooltip } from './createTooltip.svelte'
+
+  type Props = {
+    text: string
+    /** Preferred placement; flips when there is no room. Default `top`. */
+    placement?: Placement
+    /** Show delay in ms. Default 300. */
+    delay?: number
+    /** Hide delay in ms after leave (give it room for an interactive tip). Default 0. */
+    closeDelay?: number
+    /** Delay-group id: grouped tooltips open instantly while the group is warm. */
+    group?: string
+    /** Let the pointer move onto the tip without closing it (e.g. a tip with a link). */
+    interactive?: boolean
+    disabled?: boolean
+    children?: Snippet
+  }
+
+  let {
+    text,
+    placement = 'top',
+    delay = 300,
+    closeDelay = 0,
+    group,
+    interactive = false,
+    disabled = false,
+    children,
+  }: Props = $props()
+
+  const ARROW = 8
+
+  let anchorEl = $state<HTMLSpanElement | null>(null)
+  let tipEl = $state<HTMLDivElement | null>(null)
+  let pos = $state<ComputePositionResult>({
+    x: 0, y: 0, placement, side: 'top', align: 'center', maxWidth: 0, maxHeight: 0, arrow: { x: 12 },
+  })
+
+  // Open state, show/close delay, delay-group and Escape-to-hide live in the
+  // shared headless core; this component owns only the DOM concerns (positioning
+  // + describedby merge). Interactive tips get a small closeDelay by default so
+  // the pointer can travel from anchor to tip.
+  const tip = createTooltip({
+    text: () => text,
+    disabled: () => disabled,
+    delay: () => delay,
+    closeDelay: () => (closeDelay || (interactive ? 120 : 0)),
+    group: () => group,
+  })
+  const tid = tip.tipId
+
+  function place() {
+    if (!anchorEl) return
+    const r = anchorEl.getBoundingClientRect()
+    const floating = { width: tipEl?.offsetWidth || 0, height: tipEl?.offsetHeight || 30 }
+    pos = computePosition(
+      { x: r.left, y: r.top, width: r.width, height: r.height },
+      floating,
+      { placement, offset: 8, padding: 4, arrow: { size: ARROW } },
+    )
+  }
+
+  // Reposition while open (measure the tip after it mounts, then keep in sync).
+  $effect(() => {
+    if (!tip.open || !anchorEl || !tipEl) return
+    queueMicrotask(place)
+    const stop = autoUpdate(anchorEl, tipEl, place)
+    return () => stop()
+  })
+
+  // The wrapper span above is never itself Tab-focusable, so putting
+  // aria-describedby only on it does nothing for keyboard/AT users - they
+  // focus the real interactive child (e.g. the <button> in the doc example),
+  // and that's the element whose accessible description actually gets
+  // announced. Mirror the id onto that child too, merging with (and later
+  // restoring) any aria-describedby it already carries.
+  $effect(() => {
+    if (!tip.open || !anchorEl) return
+    const child = getFocusable(anchorEl)[0]
+    if (!child) return
+    const before = child.getAttribute('aria-describedby')
+    const ids = new Set((before ?? '').split(/\s+/).filter(Boolean))
+    ids.add(tid)
+    child.setAttribute('aria-describedby', [...ids].join(' '))
+    return () => {
+      const remaining = (child.getAttribute('aria-describedby') ?? '')
+        .split(/\s+/)
+        .filter((id) => id && id !== tid)
+      if (remaining.length) child.setAttribute('aria-describedby', remaining.join(' '))
+      else child.removeAttribute('aria-describedby')
+    }
+  })
+</script>
+
+<!-- svelte-ignore a11y_no_static_element_interactions -->
+<span
+  bind:this={anchorEl}
+  class="sv-tip__anchor"
+  {...tip.anchorProps()}
+>
+  {@render children?.()}
+</span>
+
+{#if tip.open}
+  <div
+    bind:this={tipEl}
+    id={tid}
+    class="sv-tip sv-tip--{pos.side}"
+    class:sv-tip--interactive={interactive}
+    role="tooltip"
+    use:portalToBody
+    use:popIn={{ up: pos.side === 'top', duration: 110, scale: 0.9 }}
+    style:position="fixed"
+    style:top={`${pos.y}px`}
+    style:left={`${pos.x}px`}
+    style:--tip-arrow-x={pos.arrow?.x != null ? `${pos.arrow.x}px` : undefined}
+    style:--tip-arrow-y={pos.arrow?.y != null ? `${pos.arrow.y}px` : undefined}
+    onpointerenter={interactive ? tip.keepOpen : undefined}
+    onpointerleave={interactive ? tip.scheduleHide : undefined}
+  >{text}<span class="sv-tip__arrow" aria-hidden="true"></span></div>
+{/if}
+
+<style>
+  .sv-tip__anchor { display: inline-flex; }
+  :global(.sv-tip) {
+    z-index: 2147483647; pointer-events: none; position: relative;
+    max-width: 240px; padding: 5px 9px; font-size: 12px; line-height: 1.4; font-weight: 500;
+    background: var(--sg-fg, #0f172a); color: var(--sg-bg, #fff);
+    border-radius: 6px; box-shadow: 0 6px 20px -6px rgba(15, 23, 42, 0.5); white-space: normal;
+  }
+  :global(.sv-tip--interactive) { pointer-events: auto; }
+  :global(.sv-tip__arrow) {
+    position: absolute; width: 8px; height: 8px;
+    background: var(--sg-fg, #0f172a); transform: rotate(45deg);
+  }
+  /* Arrow sits on the edge facing the anchor. top/bottom use --tip-arrow-x,
+     left/right use --tip-arrow-y. */
+  :global(.sv-tip--top .sv-tip__arrow) { bottom: -3px; inset-inline-start: var(--tip-arrow-x, 12px); }
+  :global(.sv-tip--bottom .sv-tip__arrow) { top: -3px; inset-inline-start: var(--tip-arrow-x, 12px); }
+  :global(.sv-tip--left .sv-tip__arrow) { right: -3px; top: var(--tip-arrow-y, 12px); }
+  :global(.sv-tip--right .sv-tip__arrow) { left: -3px; top: var(--tip-arrow-y, 12px); }
+</style>