@motion-proto/live-tokens 0.97.0 → 0.98.2

package/src/system/components/ImageLightbox.svelte

@@ -21,6 +21,7 @@
 <script lang="ts">
   import { onMount, tick, type Snippet } from 'svelte';
   import { portal } from '../internal/portal';
+  import { trapTab } from '../internal/focusTrap';
 
   interface GalleryImage {
     src: string;
@@ -45,6 +46,8 @@
     thumbSrc?: string | undefined;
     /** Closed-thumbnail object-fit. `cover` crops the thumbnail to fill its box;
         the expanded modal always uses `contain` so the whole image stays visible.
+        Unset, it follows the theme's `--imagelightbox-tile-object-fit`, which
+        defaults to `contain`.
         `cover` only crops when the thumbnail box differs from the image's shape
         (a `thumbAspect`, or a CSS-constrained container). */
     fit?: 'contain' | 'cover';
@@ -111,7 +114,7 @@
     maxWidth = undefined,
     thumbAspect = undefined,
     thumbSrc = undefined,
-    fit = 'contain',
+    fit = undefined,
     shadow = 'box',
     surface = undefined,
     border = undefined,
@@ -607,29 +610,12 @@
     if (!isGallery && scale <= MIN_SCALE) closeLightbox();
   }
 
-  // Keep Tab inside the open dialog. The stage (tabindex -1) is excluded, so an
-  // image-only lightbox holds focus on its close button.
-  function trapTab(e: KeyboardEvent) {
-    if (!modalEl) return;
-    const f = [
-      ...modalEl.querySelectorAll<HTMLElement>('button:not([disabled]), [href], [tabindex]:not([tabindex="-1"])'),
-    ];
-    if (f.length === 0) {
-      e.preventDefault();
-      stageEl?.focus();
-      return;
-    }
-    const first = f[0];
-    const last = f[f.length - 1];
-    const active = document.activeElement as HTMLElement | null;
-    const inside = active && modalEl.contains(active);
-    if (e.shiftKey && (!inside || active === first)) {
-      e.preventDefault();
-      last.focus();
-    } else if (!e.shiftKey && (!inside || active === last)) {
-      e.preventDefault();
-      first.focus();
-    }
+  // The stage (tabindex -1) is no tab stop, so an image-only lightbox holds
+  // focus on its close button.
+  function onTab(e: KeyboardEvent) {
+    if (!modalEl || trapTab(modalEl, e)) return;
+    e.preventDefault();
+    stageEl?.focus();
   }
 
   onMount(() => {
@@ -638,7 +624,7 @@
       if (e.key === 'Escape') {
         closeLightbox();
       } else if (e.key === 'Tab') {
-        trapTab(e);
+        onTab(e);
       } else if (isGallery && e.key === 'ArrowRight') {
         e.preventDefault();
         next();
@@ -920,6 +906,13 @@
     transition: none;
   }
 
+  @media (prefers-reduced-motion: reduce) {
+    .image-lightbox-thumb,
+    .image-lightbox-attached {
+      transition: none;
+    }
+  }
+
   .image-lightbox-thumb:focus-visible {
     outline: 2px solid var(--border-brand-medium);
     outline-offset: 2px;

package/src/system/components/Input.svelte

@@ -165,7 +165,7 @@
 
     /* Default */
     --input-default-surface: var(--surface-neutral-lower);
-    --input-default-border: var(--border-neutral);
+    --input-default-border: var(--border-neutral-medium);
     --input-default-text: var(--text-primary);
     --input-default-text-font-family: var(--font-sans);
     --input-default-text-font-size: var(--font-size-sm);
@@ -305,6 +305,13 @@
     outline: var(--input-error-border-width) solid var(--input-error-border);
   }
 
+  /* The red outline stays put on focus, so focus adds a neutral ring outside
+     it. The spread covers the outline's width, which paints over the shadow. */
+  .input-field.invalid .input-control:focus,
+  .input-field.invalid.force-focus .input-control {
+    box-shadow: 0 0 0 calc(var(--input-error-border-width) + var(--border-width-2)) var(--border-neutral-strong);
+  }
+
   .input-icon {
     color: var(--input-default-icon);
     font-size: var(--input-default-icon-size);

package/src/system/components/MenuSelect.svelte

@@ -40,6 +40,8 @@
     minWidth?: string;
     /** ARIA role on the wrapper. `listbox` for select-like menus; `menu` for command menus. */
     role?: 'listbox' | 'menu';
+    /** The list's accessible name, such as the text of the Button that opens it. */
+    ariaLabel?: string;
     /** Selection callback. */
     onchange?: (value: string) => void;
   }
@@ -51,6 +53,7 @@
     forceHoverValue = null,
     minWidth = undefined,
     role = 'listbox',
+    ariaLabel = undefined,
     onchange,
   }: Props = $props();
 
@@ -67,16 +70,38 @@
     onchange?.(v);
     dispatch('change', v);
   }
+
+  const buttons: HTMLButtonElement[] = $state([]);
+
+  // Roving tab stop: the list takes one Tab press, on the selected item.
+  let tabStop = $derived(
+    items.find((i) => i.value === value && !i.disabled)?.value ?? items.find((i) => !i.disabled)?.value,
+  );
+
+  function moveFocus(event: KeyboardEvent, from: number) {
+    const enabled = items.flatMap((item, i) => (item.disabled ? [] : [i]));
+    const at = enabled.indexOf(from);
+    const to = {
+      ArrowDown: enabled[(at + 1) % enabled.length],
+      ArrowUp: enabled[(at - 1 + enabled.length) % enabled.length],
+      Home: enabled[0],
+      End: enabled[enabled.length - 1],
+    }[event.key];
+    if (to === undefined) return;
+    event.preventDefault();
+    buttons[to].focus();
+  }
 </script>
 
 <ul
   style:--menuselect-hover-tint-enabled={hoverTintValue}
   class="menuselect"
   {role}
+  aria-label={ariaLabel}
   style:min-width={minWidth}
 >
-  {#each items as item (item.value)}
-    <li>
+  {#each items as item, i (item.value)}
+    <li role="none">
       <button
         type="button"
         class="menuselect-item"
@@ -85,7 +110,10 @@
         disabled={item.disabled}
         role={role === 'listbox' ? 'option' : 'menuitem'}
         aria-selected={role === 'listbox' ? value === item.value : undefined}
+        tabindex={item.value === tabStop ? 0 : -1}
+        bind:this={buttons[i]}
         onclick={() => select(item.value)}
+        onkeydown={(event) => moveFocus(event, i)}
       >
         {#if item.icon}<i class="menuselect-icon {item.icon}" aria-hidden="true"></i>{/if}
         <span class="menuselect-label">{item.label}</span>

package/src/system/components/Notification.svelte

@@ -188,7 +188,7 @@
       --notification-warning-text-line-height: var(--line-height-normal);
 
       /* Danger */
-      --notification-danger-surface: var(--surface-danger);
+      --notification-danger-surface: var(--surface-danger-low);
       --notification-danger-action-surface: var(--surface-neutral-lowest);
       --notification-danger-border: var(--border-danger);
       --notification-danger-border-width: var(--border-width-1);

package/src/system/components/ProgressBar.svelte

@@ -135,4 +135,10 @@
     border-radius: var(--progressbar-radius);
     transition: width 0.4s ease;
   }
+
+  @media (prefers-reduced-motion: reduce) {
+    .progress-fill {
+      transition: none;
+    }
+  }
 </style>

package/src/system/components/RadioButton.svelte

@@ -38,13 +38,46 @@
     onclick?.();
     dispatch('click');
   }
+
+  let button: HTMLButtonElement;
+
+  // Each option renders alone, so the group is read from the DOM: the nearest
+  // radiogroup, else the parent the options share.
+  function groupOf(radio: HTMLButtonElement): HTMLButtonElement[] {
+    const scope = radio.closest('[role="radiogroup"]') ?? radio.parentElement;
+    return scope ? [...scope.querySelectorAll<HTMLButtonElement>('.radio-button')] : [radio];
+  }
+
+  // Roving tab stop: the group takes one Tab press, on the checked option.
+  $effect(() => {
+    void selected;
+    const group = groupOf(button);
+    const stop = group.find((radio) => radio.getAttribute('aria-checked') === 'true') ?? group[0];
+    for (const radio of group) radio.tabIndex = radio === stop ? 0 : -1;
+  });
+
+  const ARROW_STEPS: Record<string, number> = { ArrowRight: 1, ArrowDown: 1, ArrowLeft: -1, ArrowUp: -1 };
+
+  function moveSelection(event: KeyboardEvent) {
+    const step = ARROW_STEPS[event.key];
+    if (step === undefined) return;
+    event.preventDefault();
+    const group = groupOf(button);
+    const next = group[(group.indexOf(button) + step + group.length) % group.length];
+    next.focus();
+    next.click();
+  }
 </script>
 
 <button
   class="radio-button {className}"
   class:selected
+  role="radio"
+  aria-checked={selected}
   style={color ? `--radiobutton-color: ${color};` : ''}
+  bind:this={button}
   onclick={fireClick}
+  onkeydown={moveSelection}
 >
   <span class="radio-dot"><span class="radio-dot-fill"></span></span>
   <span class="radio-label">{label}</span>
@@ -53,7 +86,7 @@
 <style lang="scss">
   :global(:root) {
     /* Default */
-    --radiobutton-default-dot-border-color: var(--border-neutral);
+    --radiobutton-default-dot-border-color: var(--border-neutral-medium);
     --radiobutton-default-dot-border-width: var(--border-width-2);
     --radiobutton-default-dot-fill: var(--text-secondary);
     --radiobutton-default-dot-size: var(--dot-size-0);
@@ -64,7 +97,7 @@
     --radiobutton-default-label-line-height: var(--line-height-none);
 
     /* Hover */
-    --radiobutton-hover-dot-border-color: var(--border-neutral);
+    --radiobutton-hover-dot-border-color: var(--border-neutral-medium);
     --radiobutton-hover-dot-border-width: var(--border-width-2);
     --radiobutton-hover-dot-fill: var(--text-secondary);
     --radiobutton-hover-dot-size: var(--dot-size-50);
@@ -75,7 +108,7 @@
     --radiobutton-hover-label-line-height: var(--line-height-none);
 
     /* Selected */
-    --radiobutton-selected-dot-border-color: var(--border-neutral);
+    --radiobutton-selected-dot-border-color: var(--border-neutral-medium);
     --radiobutton-selected-dot-border-width: var(--border-width-2);
     --radiobutton-selected-dot-fill: var(--text-secondary);
     --radiobutton-selected-dot-size: var(--dot-size-50);

package/src/system/components/SegmentedControl.svelte

@@ -59,6 +59,29 @@
     onchange?.(v);
     dispatch('change', v);
   }
+
+  const buttons: HTMLButtonElement[] = $state([]);
+
+  // Roving tab stop: the group takes one Tab press, on the checked segment.
+  let tabStop = $derived(
+    segments.find((s) => s.value === value && !s.disabled)?.value ?? segments.find((s) => !s.disabled)?.value,
+  );
+
+  const ARROW_STEPS: Record<string, number> = { ArrowRight: 1, ArrowDown: 1, ArrowLeft: -1, ArrowUp: -1 };
+
+  function moveSelection(event: KeyboardEvent, from: number) {
+    const step = ARROW_STEPS[event.key];
+    if (step === undefined) return;
+    event.preventDefault();
+    const count = segments.length;
+    for (let n = 1; n < count; n++) {
+      const i = (((from + step * n) % count) + count) % count;
+      if (segments[i].disabled) continue;
+      buttons[i].focus();
+      select(segments[i].value);
+      return;
+    }
+  }
 </script>
 
 <div
@@ -77,7 +100,10 @@
       disabled={disabled || seg.disabled}
       role="radio"
       aria-checked={value === seg.value}
+      tabindex={seg.value === tabStop ? 0 : -1}
+      bind:this={buttons[i]}
       onclick={() => select(seg.value)}
+      onkeydown={(event) => moveSelection(event, i)}
     >
       {#if seg.icon}<i class={seg.icon}></i>{/if}
       <span>{seg.label}</span>
@@ -96,7 +122,7 @@
 
     /* Bar (outer wrapper) */
     --segmentedcontrol-bar-surface: color-mix(in srgb, var(--surface-neutral-lowest) 75%, transparent);
-    --segmentedcontrol-bar-border: var(--border-neutral);
+    --segmentedcontrol-bar-border: var(--border-neutral-medium);
     --segmentedcontrol-bar-border-width: var(--border-width-1);
     --segmentedcontrol-bar-radius: var(--radius-lg);
     --segmentedcontrol-bar-padding: var(--space-4);
@@ -138,7 +164,7 @@
     --segmentedcontrol-selected-text-font-weight: var(--font-weight-normal);
     --segmentedcontrol-selected-text-line-height: var(--line-height-normal);
     --segmentedcontrol-selected-icon: var(--text-secondary);
-    --segmentedcontrol-selected-border: var(--border-brand);
+    --segmentedcontrol-selected-border: var(--border-brand-medium);
     --segmentedcontrol-selected-border-width: var(--border-width-1);
     --segmentedcontrol-selected-radius: var(--radius-md);
 
@@ -245,6 +271,7 @@
     @include themed-padding(--segmentedcontrol-option-padding, $h: 2);
     background: transparent;
     border: 0;
+    outline: none;
     border-radius: var(--segmentedcontrol-selected-radius);
     color: var(--_text-color);
     font-family: var(--_text-family);
@@ -308,6 +335,13 @@
     outline-offset: calc(var(--segmentedcontrol-selected-border-width) * -1);
   }
 
+  /* A ring outside the box, in a neutral that reads apart from the selected
+     option's brand outline. It is a shadow because the selected option
+     already owns the outline. */
+  .segment:focus-visible {
+    box-shadow: 0 0 0 var(--border-width-2) var(--border-neutral-strong);
+  }
+
   .segment:disabled {
     --_text-color: var(--segmentedcontrol-disabled-text);
     --_text-family: var(--segmentedcontrol-disabled-text-font-family);

package/src/system/components/SlidePager.svelte

@@ -357,7 +357,7 @@
 
   .slidepager-stage:focus-visible {
     outline: none;
-    box-shadow: var(--ring-focus-md);
+    box-shadow: 0 0 0 var(--border-width-2) var(--border-neutral-strong);
   }
 
   .slidepager-stage img {
@@ -438,7 +438,7 @@
 
   .slidepager-control:focus-visible {
     outline: none;
-    box-shadow: var(--ring-focus-md);
+    box-shadow: 0 0 0 var(--border-width-2) var(--border-neutral-strong);
   }
 
   .slidepager-counter {

package/src/system/components/Slider.svelte

@@ -131,13 +131,13 @@
        to one moves the other until the designer unlinks it. */
     /* Single: one thumb. */
     --slider-single-track-surface: var(--surface-neutral-lowest);
-    --slider-single-track-border: var(--border-neutral-subtle);
+    --slider-single-track-border: var(--border-neutral-medium);
     --slider-single-track-border-width: var(--border-width-1);
     --slider-single-track-height: var(--space-8);
     --slider-single-track-radius: var(--radius-full);
     --slider-single-fill: var(--surface-brand-high);
     --slider-single-thumb-surface: var(--surface-neutral-highest);
-    --slider-single-thumb-border: var(--border-brand);
+    --slider-single-thumb-border: var(--border-brand-medium);
     --slider-single-thumb-border-width: var(--border-width-2);
     --slider-single-thumb-size: var(--font-size-lg);
     --slider-single-thumb-radius: var(--radius-full);
@@ -151,13 +151,13 @@
 
     /* Range: two thumbs bounding a fill. */
     --slider-range-track-surface: var(--surface-neutral-lowest);
-    --slider-range-track-border: var(--border-neutral-subtle);
+    --slider-range-track-border: var(--border-neutral-medium);
     --slider-range-track-border-width: var(--border-width-1);
     --slider-range-track-height: var(--space-8);
     --slider-range-track-radius: var(--radius-full);
     --slider-range-fill: var(--surface-brand-high);
     --slider-range-thumb-surface: var(--surface-neutral-highest);
-    --slider-range-thumb-border: var(--border-brand);
+    --slider-range-thumb-border: var(--border-brand-medium);
     --slider-range-thumb-border-width: var(--border-width-2);
     --slider-range-thumb-size: var(--font-size-lg);
     --slider-range-thumb-radius: var(--radius-full);
@@ -224,6 +224,10 @@
     margin-block: calc((var(--_thumb-size) - var(--_track-height)) / 2);
     border-style: solid;
     transition: background var(--duration-150), border-color var(--duration-150);
+    /* WCAG 2.2 SC 2.5.8: the native thumb takes the pointer over 24px or
+       more. A cap smaller than that sits up to half the difference off the
+       native thumb's centre at either end of the travel. */
+    --_hit-size: max(var(--_thumb-size), var(--space-24));
     --_origin: calc(var(--_thumb-size) / 2 - var(--_track-border-width));
     --_travel: calc(100% + var(--_track-border-width) * 2 - var(--_thumb-size));
   }
@@ -287,7 +291,7 @@
     top: 50%;
     left: calc(-1 * var(--_track-border-width));
     width: calc(100% + var(--_track-border-width) * 2);
-    height: var(--_thumb-size);
+    height: var(--_hit-size);
     margin: 0;
     padding: 0;
     transform: translateY(-50%);
@@ -299,14 +303,14 @@
   .thumb:disabled { cursor: not-allowed; }
   .thumb::-webkit-slider-thumb {
     appearance: none;
-    width: var(--_thumb-size);
-    height: var(--_thumb-size);
+    width: var(--_hit-size);
+    height: var(--_hit-size);
     opacity: 0;
     pointer-events: auto;
   }
   .thumb::-moz-range-thumb {
-    width: var(--_thumb-size);
-    height: var(--_thumb-size);
+    width: var(--_hit-size);
+    height: var(--_hit-size);
     border: 0;
     opacity: 0;
     pointer-events: auto;

package/src/system/components/TabBar.svelte

@@ -58,22 +58,52 @@
       dispatch('tabChange', tab.id);
     }
   }
+
+  const buttons: HTMLButtonElement[] = $state([]);
+
+  // Roving tab stop: the bar takes one Tab press, on the selected tab.
+  let tabStop = $derived(
+    tabs.find((t) => t.id === value && !t.disabled)?.id ?? tabs.find((t) => !t.disabled)?.id,
+  );
+
+  // Arrows move focus alone; Enter or Space selects, since a consumer's
+  // onchange may load the panel.
+  function moveFocus(event: KeyboardEvent, from: number) {
+    const enabled = tabs.flatMap((t, i) => (t.disabled ? [] : [i]));
+    const at = enabled.indexOf(from);
+    const to = {
+      ArrowRight: enabled[(at + 1) % enabled.length],
+      ArrowLeft: enabled[(at - 1 + enabled.length) % enabled.length],
+      Home: enabled[0],
+      End: enabled[enabled.length - 1],
+    }[event.key];
+    if (to === undefined) return;
+    event.preventDefault();
+    buttons[to].focus();
+  }
 </script>
 
 <div
   class="tab-bar {className}"
+  role="tablist"
   style:--tabbar-hover-tint-enabled={hoverTintValue}
 >
-  {#each tabs as tab}
+  {#each tabs as tab, i}
     <button
       class="tab"
       class:selected={value === tab.id}
       class:icon-only={iconOnly}
+      role="tab"
+      aria-selected={value === tab.id}
+      aria-label={iconOnly ? tab.label : undefined}
+      tabindex={tab.id === tabStop ? 0 : -1}
       disabled={tab.disabled}
+      bind:this={buttons[i]}
       onclick={() => selectTab(tab)}
+      onkeydown={(event) => moveFocus(event, i)}
     >
       {#if tab.icon}
-        <i class={tab.icon}></i>
+        <i class={tab.icon} aria-hidden="true"></i>
       {/if}
       {#if !iconOnly}
         <span>{tab.label}</span>
@@ -133,7 +163,7 @@
 
     /* Selected tab */
     --tabbar-selected-text: var(--text-primary);
-    --tabbar-selected-border: var(--color-brand-500);
+    --tabbar-selected-border: var(--border-brand-medium);
     --tabbar-selected-surface: var(--tint-low);
     --tabbar-selected-text-font-family: var(--font-sans);
     --tabbar-selected-text-font-size: var(--font-size-md);

package/src/system/components/Toggle.svelte

@@ -59,7 +59,7 @@
   :global(:root) {
     /* Default (off resting) — also carries all geometry + label typography. */
     --toggle-track-surface: var(--surface-neutral);
-    --toggle-track-border: var(--border-neutral);
+    --toggle-track-border: var(--border-neutral-medium);
     --toggle-track-border-width: var(--border-width-1);
     --toggle-track-radius: var(--radius-full);
     --toggle-track-padding: var(--space-2);
@@ -78,7 +78,7 @@
 
     /* On (selected — toggle is checked). */
     --toggle-on-track-surface: var(--surface-brand-high);
-    --toggle-on-track-border: var(--border-brand);
+    --toggle-on-track-border: var(--border-brand-medium);
     --toggle-on-thumb-surface: var(--text-primary);
     --toggle-on-thumb-border: var(--border-brand-strong);
 

package/src/system/components/VideoFrame.svelte

@@ -225,7 +225,7 @@
 
   .videoframe-trigger:focus-visible {
     outline: none;
-    box-shadow: var(--ring-focus-md);
+    box-shadow: 0 0 0 var(--border-width-2) var(--border-neutral-strong);
     border-radius: var(--sketch-radius, var(--videoframe-frame-radius));
   }
 

package/src/system/components/VideoLightbox.svelte

@@ -318,7 +318,7 @@
 
   .videolightbox-trigger:focus-visible {
     outline: none;
-    box-shadow: var(--ring-focus-md);
+    box-shadow: 0 0 0 var(--border-width-2) var(--border-neutral-strong);
   }
 
   .videolightbox-trigger img,
@@ -436,7 +436,7 @@
 
   .videolightbox-close:focus-visible {
     outline: none;
-    box-shadow: var(--ring-focus-md);
+    box-shadow: 0 0 0 var(--border-width-2) var(--border-neutral-strong);
   }
 
   @media (prefers-reduced-motion: reduce) {

package/src/system/internal/focusTrap.ts

@@ -0,0 +1,35 @@
+const TABBABLE = [
+  '[href]',
+  'button:not([disabled])',
+  'input:not([disabled]):not([type="hidden"])',
+  'select:not([disabled])',
+  'textarea:not([disabled])',
+  '[tabindex]',
+]
+  .map((selector) => `${selector}:not([tabindex="-1"])`)
+  .join(', ');
+
+export function tabbables(container: HTMLElement): HTMLElement[] {
+  return [...container.querySelectorAll<HTMLElement>(TABBABLE)];
+}
+
+/** Keeps Tab and Shift+Tab cycling through `container`'s tabbable elements.
+ *  Focus on the container itself or outside it enters at the near end.
+ *  Returns false when the container holds none, so the caller picks where
+ *  focus rests. */
+export function trapTab(container: HTMLElement, e: KeyboardEvent): boolean {
+  const stops = tabbables(container);
+  if (stops.length === 0) return false;
+  const first = stops[0];
+  const last = stops[stops.length - 1];
+  const active = document.activeElement as HTMLElement | null;
+  const inside = active !== null && active !== container && container.contains(active);
+  if (e.shiftKey && (!inside || active === first)) {
+    e.preventDefault();
+    last.focus();
+  } else if (!e.shiftKey && (!inside || active === last)) {
+    e.preventDefault();
+    first.focus();
+  }
+  return true;
+}

package/src/testing-js/__aria__/badge.yml

@@ -0,0 +1,40 @@
+"Brand / base": |
+  - text: Brand With Icon
+"Brand / colors": |
+  - text: Brand With Icon
+"Accent / base": |
+  - text: Accent With Icon
+"Accent / colors": |
+  - text: Accent With Icon
+"Neutral / base": |
+  - text: Neutral With Icon
+"Neutral / colors": |
+  - text: Neutral With Icon
+"Alternate / base": |
+  - text: Alternate With Icon
+"Alternate / colors": |
+  - text: Alternate With Icon
+"Canvas / base": |
+  - text: Canvas With Icon
+"Canvas / colors": |
+  - text: Canvas With Icon
+"Special / base": |
+  - text: Special With Icon
+"Special / colors": |
+  - text: Special With Icon
+"Success / base": |
+  - text: Success With Icon
+"Success / colors": |
+  - text: Success With Icon
+"Warning / base": |
+  - text: Warning With Icon
+"Warning / colors": |
+  - text: Warning With Icon
+"Danger / base": |
+  - text: Danger With Icon
+"Danger / colors": |
+  - text: Danger With Icon
+"Info / base": |
+  - text: Info With Icon
+"Info / colors": |
+  - text: Info With Icon