@noxlovette/material 0.5.0 → 0.6.0

package/dist/components/forms/search/theme.js

@@ -1,15 +1,20 @@
 import { tv } from 'tailwind-variants';
+/**
+ * M3 Expressive contained search bar (https://m3.material.io/components/search/specs):
+ * 56dp, circular, surface-container-high, flat. 48dp leading/trailing targets at a 4dp inset,
+ * 4dp between the leading element and the label, 0 between trailing actions; 16dp at an edge
+ * with no action. Hover 8% / pressed 10% on-surface; focus 3dp secondary outline, 2dp offset.
+ */
 export const search = tv({
     slots: {
-        base: 'group grow cursor-text focus-inside:ring-3 focus-inside:ring-inset-2 focus-inside:ring-md-sys-color-secondary relative bg-md-sys-color-surface-container-high  rounded-full h-14 state-layer before:rounded-full hover:before:bg-md-sys-color-on-surface/8 items-center flex w-full max-w-[720px] px-4',
-        leadingIcon: 'text-md-sys-color-on-surface text-[24px] size-6 mr-4',
-        trailingIcon: 'text-md-sys-color-on-surface-variant text-[24px] size-6 ml-4',
-        input: ' placeholder:text-md-sys-color-on-surface-variant placeholder:md-sys-typescale-body-large z-50 md-sys-typescale-body-large text-md-sys-color-on-surface outline-none w-full'
+        base: 'state-layer relative flex h-spacing-700 w-full max-w-[720px] grow cursor-text items-center rounded-full bg-md-sys-color-surface-container-high ps-spacing-50 pe-spacing-50 before:rounded-full hover:before:bg-md-sys-color-on-surface/8 active:before:bg-md-sys-color-on-surface/10 has-[input:focus-visible]:outline-3 has-[input:focus-visible]:outline-offset-2 has-[input:focus-visible]:outline-md-sys-color-secondary',
+        leading: 'text-md-sys-color-on-surface relative flex shrink-0 items-center',
+        leadingIcon: 'text-md-sys-color-on-surface grid size-spacing-600 shrink-0 place-items-center',
+        input: 'md-sys-typescale-body-large text-md-sys-color-on-surface placeholder:text-md-sys-color-on-surface-variant relative ms-spacing-50 me-spacing-50 w-full min-w-spacing-0 bg-transparent outline-none [&::-webkit-search-cancel-button]:hidden',
+        trailing: 'text-md-sys-color-on-surface-variant relative flex shrink-0 items-center'
     },
     variants: {
-        shadow: {
-            true: 'shadow-elevation-3',
-            false: ''
-        }
+        hasLeading: { true: '', false: { input: 'ms-spacing-150' } },
+        hasTrailing: { true: '', false: { input: 'me-spacing-150' } }
     }
 });

package/dist/components/forms/search/types.d.ts

@@ -1,15 +1,10 @@
 import type { IconProps } from '../../../utils/index.js';
 import type { Snippet } from 'svelte';
 import type { HTMLInputAttributes } from 'svelte/elements';
-import type { SearchVariants } from './theme.js';
 /**
  * Props for the Search component.
  */
-export interface SearchProps extends SearchVariants, Omit<HTMLInputAttributes, 'size'> {
-    /**
-     * The content of the search bar, typically used for custom layouts.
-     */
-    children?: Snippet;
+export interface SearchProps extends Omit<HTMLInputAttributes, 'size'> {
     /**
      * The current value of the search input.
      */
@@ -19,16 +14,27 @@ export interface SearchProps extends SearchVariants, Omit<HTMLInputAttributes, '
      */
     elementRef?: HTMLInputElement;
     /**
-     * Callback function when the trailing icon is clicked.
-     * Default behavior clears the search value.
+     * A leading action, e.g. a menu or back icon button. Replaces the leading icon.
+     */
+    leading?: Snippet;
+    /**
+     * Trailing actions and/or an avatar, e.g. a mic icon button. Rendered after the clear button.
+     */
+    trailing?: Snippet;
+    /**
+     * Called by the clear button. Defaults to clearing the value and refocusing the input.
      */
     trailingClick?: () => void;
     /**
-     * Props for the leading icon (typically a search icon).
+     * Props for the leading icon (a search icon by default); `null` removes it.
+     */
+    leadingIconProps?: IconProps | null;
+    /**
+     * Props for the clear button's icon, shown while there is a value; `null` removes the button.
      */
-    leadingIconProps?: IconProps;
+    trailingIconProps?: IconProps | null;
     /**
-     * Props for the trailing icon (typically a clear/close icon).
+     * Accessible label for the clear button.
      */
-    trailingIconProps?: IconProps;
+    clearLabel?: string;
 }

package/dist/components/forms/select/Select.mdx

@@ -0,0 +1,53 @@
+import { Meta, Title, Subtitle, Canvas, Controls } from '@storybook/addon-docs/blocks';
+import * as SelectStories from './Select.stories.svelte';
+
+<Meta of={SelectStories} />
+
+<Title />
+
+<Subtitle>Select lets users choose one option from a list.</Subtitle>
+
+[M3 spec (menus)](https://m3.material.io/components/menus/specs) ·
+`import { Select } from '@noxlovette/material';`
+
+<Canvas of={SelectStories.Playground} />
+
+<Controls of={SelectStories.Playground} />
+
+## Options
+
+M3 specifies dropdown selection as part of menus, so `Select` pairs a text-field-style trigger
+with a menu panel. The panel is built entirely from the `options` array; it takes no children.
+
+Each entry is either an item (bits-ui's `Select.ItemProps`: `value`, `label`, `disabled`…) or a
+group, `{ type: 'group', heading?, items }`, which renders a labelled section:
+
+```svelte
+<script lang="ts">
+  import { Select, type SelectOption } from '@noxlovette/material';
+
+  let fruit = $state<string | undefined>();
+  const options: SelectOption[] = [
+    { value: 'apple', label: 'Apple' },
+    { value: 'banana', label: 'Banana' }
+  ];
+</script>
+
+<Select type="single" placeholder="Choose a fruit" {options} bind:value={fruit} />
+```
+
+<Canvas of={SelectStories.GroupedOptions} />
+
+<Canvas of={SelectStories.States} />
+
+## Styled primitives
+
+`SelectItem`, `SelectGroup`, `SelectLabel` and `SelectSeparator` carry the same styling. Use them
+only when building your own dropdown directly on bits-ui's `Select.Root`; `Select` itself doesn't
+accept them.
+
+## Accessibility
+
+- **Keyboard.** Arrow keys move through options, Enter and Space select, and Escape closes.
+- **Selection** shows a check icon as well as a color.
+- **Disabled options** are skipped by keyboard navigation.

package/dist/components/forms/select/Select.stories.svelte

@@ -57,20 +57,20 @@
 
 <Story name="Playground">
   {#snippet template(args)}
-    <div class="max-w-sm p-6">
+    <div class="p-spacing-300 max-w-sm">
       <Select {...args} />
     </div>
   {/snippet}
 </Story>
 
 <Story name="Grouped Options" asChild>
-  <div class="max-w-sm p-6">
+  <div class="p-spacing-300 max-w-sm">
     <Select type="single" placeholder="Choose a fruit" options={groupedOptions} />
   </div>
 </Story>
 
 <Story name="With Leading Icon" asChild>
-  <div class="max-w-sm p-6">
+  <div class="p-spacing-300 max-w-sm">
     <Select
       type="single"
       placeholder="Choose a fruit"
@@ -81,7 +81,7 @@
 </Story>
 
 <Story name="States" asChild>
-  <div class="flex max-w-sm flex-col gap-6 p-6">
+  <div class="gap-spacing-300 p-spacing-300 flex max-w-sm flex-col">
     <Select type="single" placeholder="Default" options={fruitOptions} />
     <Select type="single" placeholder="Error" options={fruitOptions} error value="apple" />
     <Select type="single" placeholder="Disabled" options={fruitOptions} disabled />

package/dist/components/forms/select/Select.svelte

@@ -94,7 +94,11 @@ Powered by bits-ui for accessibility and behavior.
                                 {#snippet children({ selected })}
                                   <span class="flex-1 truncate">{innerItem.label}</span>
                                   {#if selected}
-                                    <Icon aria-hidden="true" name="check" class="size-5 shrink-0" />
+                                    <Icon
+                                      aria-hidden="true"
+                                      name="check"
+                                      class="size-spacing-250 shrink-0"
+                                    />
                                   {/if}
                                 {/snippet}
                               </Select.Item>
@@ -106,7 +110,11 @@ Powered by bits-ui for accessibility and behavior.
                           {#snippet children({ selected })}
                             <span class="flex-1 truncate">{item.label}</span>
                             {#if selected}
-                              <Icon aria-hidden="true" name="check" class="size-5 shrink-0" />
+                              <Icon
+                                aria-hidden="true"
+                                name="check"
+                                class="size-spacing-250 shrink-0"
+                              />
                             {/if}
                           {/snippet}
                         </Select.Item>

package/dist/components/forms/select/SelectItem.svelte

@@ -28,7 +28,7 @@
     {:else}
       <span class="flex-1 truncate">{label ?? value}</span>
       {#if selected}
-        <Icon name="check" class="size-5 shrink-0" />
+        <Icon name="check" class="size-spacing-250 shrink-0" />
       {/if}
     {/if}
   {/snippet}

package/dist/components/forms/select/theme.js

@@ -3,14 +3,14 @@ export const select = tv({
     slots: {
         root: 'relative w-full',
         base: `
-      group w-full h-14 px-0 relative flex items-center
+      group w-full h-spacing-700 px-spacing-0 relative flex items-center
     `,
         trigger: `
       group peer w-full h-full flex items-center justify-between bg-transparent outline-none
       cursor-pointer
     `,
         inputWrapper: `
-      relative flex-1 h-full px-4 flex items-center
+      relative flex-1 h-full px-spacing-200 flex items-center
     `,
         value: `
       w-full bg-transparent outline-none
@@ -20,12 +20,12 @@ export const select = tv({
       truncate text-left
     `,
         leadingIcon: `
-      text-md-sys-color-on-surface-variant size-6
+      text-md-sys-color-on-surface-variant size-spacing-300
       group-has-[[data-state=open]]:text-md-sys-color-primary
-      group-data-[invalid]:text-md-sys-color-error ml-3 text-[24px]
+      group-data-[invalid]:text-md-sys-color-error ml-spacing-150 text-[24px]
     `,
         dropdownIcon: `
-      mr-3 text-md-sys-color-on-surface-variant size-6
+      mr-spacing-150 text-md-sys-color-on-surface-variant size-spacing-300
       group-data-[state=open]:text-md-sys-color-primary
       group-data-[invalid]:text-md-sys-color-error z-20 text-[24px]
       transition-transform md-sys-motion-fast-spatial
@@ -33,12 +33,12 @@ export const select = tv({
     `,
         content: `
       z-[100] min-w-[var(--bits-select-anchor-width)] max-h-96 overflow-y-auto
-      rounded-lg gap-1 bg-md-sys-color-surface-container-high
-      shadow-elevation-3 ring-md-sys-color-outline/10 px-2 py-1 outline-none
+      rounded-lg gap-spacing-50 bg-md-sys-color-surface-container-high
+      shadow-elevation-3 ring-md-sys-color-outline/10 px-spacing-100 py-spacing-50 outline-none
     `,
         item: `
       rounded-sm relative flex w-full cursor-pointer select-none items-center
-      px-3 py-2 outline-none
+      px-spacing-150 py-spacing-100 outline-none
       md-sys-typescale-body-large text-md-sys-color-on-surface
       hover:bg-md-sys-color-on-surface/8
       data-[highlighted]:bg-md-sys-color-on-surface/8
@@ -48,14 +48,14 @@ export const select = tv({
       transition-colors md-sys-motion-fast-effects
     `,
         groupLabel: `
-      px-3 pt-2 pb-1 md-sys-typescale-label-medium
+      px-spacing-150 pt-spacing-100 pb-spacing-50 md-sys-typescale-label-medium
       text-md-sys-color-primary
     `,
         separator: `
-      my-1 h-px bg-md-sys-color-outline-variant
+      my-spacing-50 h-px bg-md-sys-color-outline-variant
     `,
         supportingText: `
-      px-4 pt-1 flex justify-between
+      px-spacing-200 pt-spacing-50 flex justify-between
       md-sys-typescale-body-small
       text-md-sys-color-on-surface-variant
       group-data-[invalid]:text-md-sys-color-error
@@ -67,7 +67,7 @@ export const select = tv({
                 base: `
           bg-md-sys-color-surface-container-highest
           rounded-t-xs state-layer before:rounded-xs hover:before:bg-md-sys-color-on-surface/8
-          after:absolute after:bottom-0 after:left-0 after:right-0 after:h-px after:bg-md-sys-color-on-surface-variant
+          after:absolute after:bottom-spacing-0 after:left-spacing-0 after:right-spacing-0 after:h-px after:bg-md-sys-color-on-surface-variant
           after:transition-[height,background-color] after:md-sys-motion-fast-spatial
           hover:after:bg-md-sys-color-on-surface
           has-[[data-state=open]]:after:bg-md-sys-color-primary

package/dist/components/forms/slider/Slider.mdx

@@ -0,0 +1,85 @@
+import { Meta, Title, Subtitle, Canvas, Controls } from '@storybook/addon-docs/blocks';
+import * as SliderStories from './Slider.stories.svelte';
+
+<Meta of={SliderStories} />
+
+<Title />
+
+<Subtitle>Sliders allow users to make selections from a range of values.</Subtitle>
+
+[M3 spec](https://m3.material.io/components/sliders/specs) ·
+`import { Slider } from '@noxlovette/material';`
+
+<Canvas of={SliderStories.Playground} />
+
+<Controls of={SliderStories.Playground} />
+
+This is the M3 Expressive slider. It has two tracks, active and inactive, with a 6dp gap on each
+side of a 4dp bar handle. Bind `value` to read and set it:
+
+```svelte
+<script lang="ts">
+  let volume = $state(40);
+</script>
+
+<Slider bind:value={volume} min={0} max={100} />
+```
+
+## Choosing a size
+
+`xs` is the default. Go larger when the slider is the main control on the screen, or when it needs
+inset icons.
+
+| Size | Track | Handle | Outer corner | Inset icon   |
+| ---- | ----- | ------ | ------------ | ------------ |
+| `xs` | 16dp  | 44dp   | 8dp          | —            |
+| `s`  | 24dp  | 44dp   | 8dp          | —            |
+| `m`  | 40dp  | 52dp   | 12dp         | 24dp, 6dp in |
+| `l`  | 56dp  | 68dp   | 16dp         | 24dp, 6dp in |
+| `xl` | 96dp  | 108dp  | 28dp         | 32dp, 8dp in |
+
+The corners next to the handle are always 2dp.
+
+<Canvas of={SliderStories.Sizes} />
+
+## Inset icons
+
+`leadingIconProps` and `trailingIconProps` put an icon inside the track. M3 defines inset icons
+only for `m`, `l` and `xl`, so they're ignored on `xs` and `s`. When the handle gets too close for
+the icon to fit in its track, the icon moves across the handle into the other track. It also takes
+that track's color.
+
+<Canvas of={SliderStories.WithIcons} />
+
+## Continuous or discrete
+
+Leave `step="any"` for a continuous slider. Set a numeric `step` to make it discrete, and add
+`stops` to show a 4dp stop indicator at each step. With or without `stops`, `endStops` marks the
+end of the track 4dp from its edge. Stops hide within 6dp of the handle, and wherever an inset
+icon covers them.
+
+<Canvas of={SliderStories.DiscreteWithStops} />
+
+## Value indicator
+
+With `showValue`, a 48×44dp indicator shows above the handle while it's dragged or has keyboard
+focus. It sits 12dp above the handle, on inverse-surface. Use `format` to add units or localize
+the number.
+
+## States
+
+- **Pressed and focused:** the handle narrows from 4dp to 2dp on a fast spatial spring, and the
+  6dp gaps follow its edge.
+- **Disabled:** the active track is on-surface at 38% opacity, the inactive track 12%, and the
+  handle 38%.
+
+<Canvas of={SliderStories.Disabled} />
+
+## Accessibility
+
+- **Keyboard:** the arrow keys move by one step, and Home/End jump to `min`/`max` (via bits-ui's
+  `Slider.Root`).
+- **Focus:** keyboard focus narrows the handle, draws an outline around it, and reveals the value
+  indicator.
+- **Labelling:** give the slider an accessible name, such as `aria-label="Volume"`. Inset icons
+  are decorative and don't label it.

package/dist/components/forms/slider/Slider.stories.svelte

@@ -36,14 +36,14 @@
 
 <Story name="Playground">
   {#snippet template(args)}
-    <div class="max-w-sm p-10">
+    <div class="p-spacing-500 max-w-sm">
       <Slider {...args} />
     </div>
   {/snippet}
 </Story>
 
 <Story name="Sizes" asChild>
-  <div class="flex max-w-sm flex-col gap-8 p-10">
+  <div class="gap-spacing-400 p-spacing-500 flex max-w-sm flex-col">
     <Slider value={30} size="xs" />
     <Slider value={30} size="s" />
     <Slider value={30} size="m" />
@@ -52,8 +52,8 @@
   </div>
 </Story>
 
-<Story name="With Icons" asChild>
-  <div class="max-w-sm p-10">
+<Story name="With Icons" exportName="WithIcons" asChild>
+  <div class="p-spacing-500 max-w-sm">
     <Slider
       value={60}
       size="m"
@@ -63,14 +63,14 @@
   </div>
 </Story>
 
-<Story name="Discrete With Stops" asChild>
-  <div class="max-w-sm p-10">
+<Story name="Discrete With Stops" exportName="DiscreteWithStops" asChild>
+  <div class="p-spacing-500 max-w-sm">
     <Slider value={40} step={20} stops />
   </div>
 </Story>
 
 <Story name="Disabled" asChild>
-  <div class="max-w-sm p-10">
+  <div class="p-spacing-500 max-w-sm">
     <Slider value={40} disabled />
   </div>
 </Story>

package/dist/components/forms/slider/Slider.svelte

@@ -41,13 +41,18 @@ the track, a new `value` from outside) springs to it on the fast spatial spring.
 
   /* M3 slider geometry, in px. */
   const HANDLE_PX = 4;
+  /* Pressed and focused handles narrow to 2dp. */
+  const HANDLE_NARROW_PX = 2;
   const GAP_PX = 6;
-  const ICON_PADDING_PX = 8;
-  /* Stops closer than this to the handle's center are hidden under its gap. */
-  const STOP_CLEARANCE_PX = HANDLE_PX / 2 + GAP_PX;
+  /* Stop indicators are 4dp with 4dp trailing space, so their centers sit 6dp in from each end. */
+  const STOP_INSET_PX = 6;
 
-  const iconSize = $derived(size === 'xl' ? 'lg' : 'md');
-  const iconPx = $derived(size === 'xl' ? 40 : 24);
+  /* Inset icons exist only on M, L and XL: 24dp/6dp padding, 32dp/8dp on XL. */
+  const hasIcons = $derived(size === 'm' || size === 'l' || size === 'xl');
+  const iconPx = $derived(size === 'xl' ? 32 : 24);
+  const iconPaddingPx = $derived(size === 'xl' ? 8 : 6);
+  const leadingIcon = $derived(hasIcons ? leadingIconProps : undefined);
+  const trailingIcon = $derived(hasIcons ? trailingIconProps : undefined);
 
   const stepValue = $derived(typeof step === 'number' ? step : undefined);
   const range = $derived(max - min);
@@ -60,17 +65,21 @@ the track, a new `value` from outside) springs to it on the fast spatial spring.
     pressed, the handle is being dragged and tracks it directly.
   */
   let dragging = $state(false);
+  let pressed = $state(false);
+  let focusVisible = $state(false);
 
   const trackDrag: Attachment<HTMLElement> = (node) => {
     const move = () => (dragging = true);
     const release = () => {
       dragging = false;
+      pressed = false;
       window.removeEventListener('pointermove', move);
       window.removeEventListener('pointerup', release);
       window.removeEventListener('pointercancel', release);
     };
     const press = () => {
       if (disabled) return;
+      pressed = true;
       window.addEventListener('pointermove', move);
       window.addEventListener('pointerup', release);
       window.addEventListener('pointercancel', release);
@@ -92,6 +101,15 @@ the track, a new `value` from outside) springs to it on the fast spatial spring.
   /* The spring may overshoot the ends; the track can't. */
   const pos = $derived(Math.min(1, Math.max(0, fraction.current)));
 
+  /** Handle thickness: 4dp at rest, 2dp while pressed or keyboard-focused. */
+  const handleThickness = new SpringValue(
+    () => (pressed || focusVisible ? HANDLE_NARROW_PX : HANDLE_PX),
+    springTokens.fastSpatial
+  );
+  const handlePx = $derived(Math.max(1, handleThickness.current));
+  /* The gap is measured from the handle's current edge, so it stays 6dp as the handle narrows. */
+  const clearPx = $derived(handlePx / 2 + GAP_PX);
+
   /* ---- geometry -------------------------------------------------------------------------- */
 
   let trackWidth = $state(0);
@@ -101,21 +119,19 @@ the track, a new `value` from outside) springs to it on the fast spatial spring.
   const start = $derived(vertical ? 'bottom' : 'left');
   const extent = $derived(vertical ? 'height' : 'width');
 
-  /** Handle center: travels the track inset by half a handle so it never overhangs the ends. */
+  /** Handle center: travels the track inset by half a resting handle so it never overhangs the ends. */
   const center = (f: number) => `calc(${HANDLE_PX / 2}px + ${f} * (100% - ${HANDLE_PX}px))`;
   const centerPx = $derived(HANDLE_PX / 2 + pos * (length - HANDLE_PX));
 
-  const activePx = $derived(centerPx - HANDLE_PX / 2 - GAP_PX);
-  const inactivePx = $derived(length - centerPx - HANDLE_PX / 2 - GAP_PX);
+  const activePx = $derived(centerPx - clearPx);
+  const inactivePx = $derived(length - centerPx - clearPx);
 
-  const activeStyle = $derived(
-    `${extent}: max(0px, calc(${pos} * (100% - ${HANDLE_PX}px) - ${GAP_PX}px))`
-  );
-  const inactiveStyle = $derived(
-    `${extent}: max(0px, calc(${1 - pos} * (100% - ${HANDLE_PX}px) - ${GAP_PX}px))`
-  );
+  const trackStyle = (f: number) =>
+    `${extent}: max(0px, calc(${f} * (100% - ${HANDLE_PX}px) + ${HANDLE_PX / 2 - clearPx}px))`;
+  const activeStyle = $derived(trackStyle(pos));
+  const inactiveStyle = $derived(trackStyle(1 - pos));
 
-  /* Stops sit inset by half the track thickness so the end stops land in the rounded caps. */
+  /* Stops span the track inset by STOP_INSET_PX, so the end stops keep their 4dp trailing space. */
   const stopList = $derived.by(() => {
     const output: number[] = [];
     if (stops && stepValue && range > 0) {
@@ -124,24 +140,24 @@ the track, a new `value` from outside) springs to it on the fast spatial spring.
       output.push(1);
     }
     return output.filter((s) => {
-      if (leadingIconProps && s === 0) return false;
-      if (trailingIconProps && s === 1) return false;
-      return !length || Math.abs(s - pos) * length > STOP_CLEARANCE_PX;
+      if (leadingIcon && s === 0) return false;
+      if (trailingIcon && s === 1) return false;
+      return !length || Math.abs(s - pos) * length > clearPx;
     });
   });
 
   /* Icons ride inside their track; when it gets too short they hop across the handle. */
-  const iconFits = (trackPx: number) => trackPx >= iconPx + ICON_PADDING_PX * 2;
+  const iconFits = (trackPx: number) => trackPx >= iconPx + iconPaddingPx * 2;
   const leadingOnActive = $derived(!length || iconFits(activePx));
   const trailingOnInactive = $derived(!length || iconFits(inactivePx));
 
   const leadingOffset = $derived(
-    leadingOnActive ? ICON_PADDING_PX : centerPx + HANDLE_PX / 2 + GAP_PX + ICON_PADDING_PX
+    leadingOnActive ? iconPaddingPx : centerPx + clearPx + iconPaddingPx
   );
   const trailingOffset = $derived(
     trailingOnInactive
-      ? length - ICON_PADDING_PX - iconPx
-      : centerPx - HANDLE_PX / 2 - GAP_PX - ICON_PADDING_PX - iconPx
+      ? length - iconPaddingPx - iconPx
+      : centerPx - clearPx - iconPaddingPx - iconPx
   );
 
   const sliderDir = $derived(dir === null || dir === 'auto' ? undefined : dir);
@@ -175,26 +191,26 @@ the track, a new `value` from outside) springs to it on the fast spatial spring.
       {#each stopList as s (s)}
         <div
           class={cls.stop({ class: s < pos ? cls.stopOnActive() : cls.stopOnInactive() })}
-          style="{start}: calc(var(--track) / 2 + {s} * (100% - var(--track)))"
+          style="{start}: calc({STOP_INSET_PX}px + {s} * (100% - {STOP_INSET_PX * 2}px))"
         ></div>
       {/each}
 
-      {#if leadingIconProps}
+      {#if leadingIcon}
         <span
           class={cls.icon({ class: leadingOnActive ? cls.iconOnActive() : cls.iconOnInactive() })}
           style="{start}: {leadingOffset}px"
         >
-          <Icon size={iconSize} {...leadingIconProps} />
+          <Icon {...leadingIcon} class={cls.iconGlyph({ class: clsx(leadingIcon.class) })} />
         </span>
       {/if}
-      {#if trailingIconProps}
+      {#if trailingIcon}
         <span
           class={cls.icon({
             class: trailingOnInactive ? cls.iconOnInactive() : cls.iconOnActive()
           })}
           style="{start}: {trailingOffset}px"
         >
-          <Icon size={iconSize} {...trailingIconProps} />
+          <Icon {...trailingIcon} class={cls.iconGlyph({ class: clsx(trailingIcon.class) })} />
         </span>
       {/if}
 
@@ -204,7 +220,9 @@ the track, a new `value` from outside) springs to it on the fast spatial spring.
             {...thumbProps}
             class={cls.handle()}
             data-active={active || undefined}
-            style="{start}: {center(pos)}"
+            style="{start}: {center(pos)}; {extent}: {handlePx}px"
+            onfocus={(e) => (focusVisible = e.currentTarget.matches(':focus-visible'))}
+            onblur={() => (focusVisible = false)}
           ></div>
         {/snippet}
       </Slider.Thumb>

package/dist/components/forms/slider/theme.d.ts

@@ -1,6 +1,8 @@
 import { type VariantProps } from 'tailwind-variants';
 /**
  * M3 Expressive slider: an active and an inactive track separated from a bar handle by a 6dp gap.
+ * Per-size tokens (track / handle / outer corner / inset icon): XS 16/44/8/–, S 24/44/8/–,
+ * M 40/52/12/24, L 56/68/16/24, XL 96/108/28/32. The value indicator sits 12dp above the handle.
  * Track/handle positions are set inline by `Slider.svelte` from one animated value; these slots
  * only carry size, shape and color.
  *
@@ -16,12 +18,15 @@ export declare const slider: import("tailwind-variants").TVReturnType<{
         };
         m: {
             root: string;
+            iconGlyph: string;
         };
         l: {
             root: string;
+            iconGlyph: string;
         };
         xl: {
             root: string;
+            iconGlyph: string;
         };
     };
     vertical: {
@@ -60,6 +65,7 @@ export declare const slider: import("tailwind-variants").TVReturnType<{
     stopOnActive: string;
     stopOnInactive: string;
     icon: string;
+    iconGlyph: string;
     iconOnActive: string;
     iconOnInactive: string;
     handle: string;
@@ -74,12 +80,15 @@ export declare const slider: import("tailwind-variants").TVReturnType<{
         };
         m: {
             root: string;
+            iconGlyph: string;
         };
         l: {
             root: string;
+            iconGlyph: string;
         };
         xl: {
             root: string;
+            iconGlyph: string;
         };
     };
     vertical: {
@@ -118,6 +127,7 @@ export declare const slider: import("tailwind-variants").TVReturnType<{
     stopOnActive: string;
     stopOnInactive: string;
     icon: string;
+    iconGlyph: string;
     iconOnActive: string;
     iconOnInactive: string;
     handle: string;
@@ -132,12 +142,15 @@ export declare const slider: import("tailwind-variants").TVReturnType<{
         };
         m: {
             root: string;
+            iconGlyph: string;
         };
         l: {
             root: string;
+            iconGlyph: string;
         };
         xl: {
             root: string;
+            iconGlyph: string;
         };
     };
     vertical: {
@@ -176,6 +189,7 @@ export declare const slider: import("tailwind-variants").TVReturnType<{
     stopOnActive: string;
     stopOnInactive: string;
     icon: string;
+    iconGlyph: string;
     iconOnActive: string;
     iconOnInactive: string;
     handle: string;