feat(virtual-core): Optimize scroll adjustments with batching and add backward scroll option

[dpwls02142]

🎯 Changes

1. problem

• During heavy scrolling with dynamic item sizes, frequent scroll adjustments can cause:
  • Layout thrashing due to multiple synchronous scroll position updates
  • Stuttering during backward scrolling because already-measured items are remeasured unnecessarily
• Related issue: Scrolling up with dynamic heights stutters and jumps #659

2. Solution

• Batching Scroll Adjustments

  • Collect multiple adjustment deltas in pendingAdjustmentDeltas array
  • Use requestAnimationFrame to batch-apply all adjustments in a single frame
  • Reduces layout thrashing and improves scrolling performance

• Backward Scroll Optimization

  • Add disableScrollAdjustmentOnBackwardScroll option
  • Skip remeasuring items that are already in cache during backward scroll
  • Prevents stuttering while maintaining measurement accuracy

✅ Checklist

• I have followed the steps in the Contributing guide.
• I have tested this code locally with pnpm run test:pr.

🚀 Release Impact

• This change affects published code, and I have generated a changeset.
• This change is docs/CI/dev-only (no release).

[changeset-bot]

🦋 Changeset detected

Latest commit: f14d223

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 7 packages

Name	Type
@tanstack/virtual-core	Minor
@tanstack/angular-virtual	Patch
@tanstack/lit-virtual	Patch
@tanstack/react-virtual	Patch
@tanstack/solid-virtual	Patch
@tanstack/svelte-virtual	Patch
@tanstack/vue-virtual	Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[piecyk]

@dpwls02142 Thanks for the PR, this is addressing a very real problem. I think there are actually two distinct changes here:

1. Skipping re-measurement when scrolling backward
2. Batching scroll adjustments via requestAnimationFrame

I’d strongly suggest splitting these into two separate PRs:

1. Backward scroll optimization
   The option name reads like it disables scroll adjustment, but in reality it skips measurement under certain conditions. It might be worth either renaming it or being very explicit about this behavior in the docs.
   There’s also an open question around how we guarantee that the layout eventually settles correctly after scrolling stops (i.e. when isScrolling flips back to false).

2. Scroll adjustment batching
   There is no scroll adjustment batching implemented as by designed as when scrolling quickly, you see more visible white space. Because the scroll adjustments are delayed to the next requestAnimationFrame, the content height changes while the scroll offset isn’t corrected immediately, so during fast scrolling you get gaps until the batch flushes. The faster you scroll, the more noticeable this becomes.
   This isn’t a trivial issue to solve, it’s the fundamental trade-off between less thrashing vs. more lag. With dynamic heights and fast scrolling, you really feel that lag.