humanspeak / svelte-motion

69%

main: 3%

push

github

feat(variants): variant string keys + arrays on whileX props (#349) (#355)

* feat(variants): variant string keys + arrays on whileX props (#349)

Widen `whileHover` / `whileTap` / `whileFocus` / `whileDrag` /
`whileInView` to accept a variant key string or an array of keys,
matching framer-motion's `VariantLabels = string | string[]` surface.
Inline keyframes still work — this is purely additive.

Array form merges variants left-to-right, with later entries
overriding earlier ones on key collisions. Missing keys are silently
skipped (no-op).

While here, also extend `initial` / `animate` / `exit` to accept array
form — the same upstream contract applies and the existing
single-string support generalised cleanly.

- New `resolveVariantList` + `resolveWhile` helpers in
  `src/lib/utils/variants.ts`. The existing `resolveInitial` /
  `resolveAnimate` / `resolveExit` delegate to `resolveVariantList`,
  so array-form support comes through for free.
- Type widening in `src/lib/types.ts` for all eight affected props.
- Five `$derived` resolved values in `_MotionContainer.svelte`
  feeding the five attach helpers + drag opts.
- 14 new unit tests in `variants.spec.ts` covering single-string,
  array, missing-key, mixed-missing, function-form + custom.
- 3 new component tests in `_MotionContainer.spec.ts` driving
  whileHover via single string, array form, and unknown-key no-op.
- Regression route `/tests/motion/while-string-variants/` exercising
  all five whileX with variant keys; wired into the root nav.
- Playwright e2e drives whileHover with both single-string and
  array form, verifying scale + the later-wins backgroundColor
  merge.
- Docs: `VariantsWhileHoverExample` + new `/examples/variants-while-hover`
  route, examples catalog entry, expanded variants docs page with
  the new "Variant keys on gesture props" section.
- README + llms.txt + llms-full.txt updated to reflect the broadened
  surface.

Closes #349

* docs(test): address CodeRabbit feedbac... (continued)

481 of 634 branches covered (75.87%)

Branch coverage included in aggregate %.

32 of 33 new or added lines in 2 files covered. (96.97%)

1812 of 2686 relevant lines covered (67.46%)

10.92 hits per line