humanspeak / svelte-motion

57%

main: 57%

push

github

feat(layout): add layoutDependency prop to gate FLIP measurement (#416)

* docs(layout): add JSDoc to layoutIdRegistry export

The exported singleton lacked a doc block (the nearby comment
documents the private entries Map). Adds a Google-style JSDoc
describing the snapshot/consume one-shot contract.

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

* fix(tests): let demo wrappers grow so pages scroll past the viewport

The #405 scroll fix un-clamped html/body, but `.container` and
`#sandbox` stayed fixed at `height: 100vh` / `100%`, so content taller
than the viewport overflowed an unscrollable wrapper. Switch both to
`min-height` + `height: auto` so the wrappers grow with content and the
page scrolls. Short content still centers via flex.

Fixes scrolling app-wide for all test routes, removing the need for the
per-page `.container`/`#sandbox` overrides several demos carry today.

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

* feat(layout): add layoutDependency prop to gate FLIP measurement

Gates `layout` (FLIP) measurement so a frequently-rerendering element
only re-measures when a dependency you control changes, instead of on
every render that touches class/style/layoutId/transition. Mirrors
framer-motion's `layoutDependency`.

- types: `layoutDependency?: unknown` with Google-style JSDoc
- layout: pure `selectLayoutDependencies(dep, fallback)` helper whose
  laziness (fallback thunk) is what keeps the gated props untracked
- _MotionContainer: gated dependency tracker; drag escape hatch that
  bypasses the gate while `drag` is active (upstream MeasureLayout
  parity); presence-driven layout changes still measure via the
  observer path
- unit tests for the gate (incl. falsy-but-defined values + laziness)
- /tests/layout-dependency demo with measure counters + drag/presence
  escape-hatch panels; linked from the test index
- e2e covering gating, dependency change, drag hatch, and presence reflow
- docs ... (continued)

765 of 1567 branches covered (48.82%)

Branch coverage included in aggregate %.

4 of 4 new or added lines in 2 files covered. (100.0%)

2997 of 5018 relevant lines covered (59.72%)

15.13 hits per line