humanspeak / svelte-motion / 26311895102

72%

main: 3%

push

github

feat(hooks): port Tier 2 motion-value hooks to motion-dom primitives (#375)

* refactor(hooks): port useMotionValue to motion-dom MotionValue + .current

- Replace the hand-rolled Readable + .set/.get wrapper with a real
  motion-dom MotionValue, augmented with a $state-backed .current
  getter and a Svelte readable .subscribe shim. Same shape as useSpring.
- Extract the augmentation pattern into augmentMotionValue.svelte.ts so
  every Wave 3 hook (useTransform, useScroll, useTime, useVelocity,
  useMotionTemplate) plus useSpring shares one implementation.
- Refactor useSpring to consume the shared helper. SSR path and the
  Svelte-readable-source bridge now route through sampleSource +
  isSvelteReadable from the same module.
- Lift the lifecycle to $effect (cleanup on unmount); tests run inside
  $effect.root, mirroring spring's spec.
- Update the motion-values overview docs: useMotionValue moved from
  Tier-1 readable to Tier-2 augmented MotionValue.

Closes #366

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

* refactor(hooks): port useTransform to MotionValue + .current

- Replace the Svelte `derived`/`readable` result with a real motion-dom
  `MotionValue<T>` driven by source-subscription writes, augmented via
  the shared `augmentMotionValue` helper. Returns the same shape as
  `useMotionValue` and `useSpring`: real MotionValue + `.current` getter
  + `.subscribe` shim.
- Mapping form: source accepts both MotionValue and Svelte readable
  (both implement subscribe). Initial value seeded from `sampleSource`;
  the synchronous initial subscribe emit is skipped so the value isn't
  re-set redundantly.
- Function form: deps accept mixed MotionValue / Readable arrays; each
  dep's initial emit is skipped on subscribe for the same reason. Empty
  deps array still yields a single computed value.
- Range-mapping math (linearMix, findSegment, easing, clamp, mixer)
  unchanged; lifted into a `buildMapper` helper for clarity.
- Test... (continued)

497 of 640 branches covered (77.66%)

Branch coverage included in aggregate %.

264 of 314 new or added lines in 10 files covered. (84.08%)

1964 of 2794 relevant lines covered (70.29%)

12.39 hits per line