[renovate]

This PR contains the following updates:

Package	Change	Age	Confidence
@legendapp/list	3.0.0-beta.44 → 3.6.0

---

Release Notes

LegendApp/legend-list (@​legendapp/list)

v3.6.0

Compare Source

• Feat: Add viewPositionFallback to align oversized items to the start or end of the viewport during initial or programmatic scrolling, while keeping viewPosition alignment for items that fit.

v3.5.0

Compare Source

• Feat: Add scrollElement so web lists can share an ancestor element's scrollbar
• Fix: Stopping scrolling keeps rows prepared in the last scroll direction instead of shifting the render buffer backward.
• Perf: Single-column lists do less layout work during initial rendering and scrolling when item sizes and data are unchanged.

v3.4.0

Compare Source

• Feat: Add onReady, called after each initial placement and scroll cycle completes, including cycles restarted by a dataKey change.
• Fix: End-following and animated programmatic scrolling now stay aligned through footer, viewport, and native layout changes, while user dragging cancels queued follow requests.
• Fix: onStartReached and onEndReached callbacks now fire reliably after layout and dataset resets, including short lists and gestures that cross a threshold over multiple events.
• Fix: Numeric initialScrollIndex values that target the last row now include the footer when opening at the end.
• Perf: Fast scrolling now prepares rows in the direction you are moving, including upward and end-aligned scrolling, so the next content is ready sooner.

v3.3.11

Compare Source

• Fix: scrollToEnd and maintainScrollAtEnd keep reaching the end as content changes, while scrolling away or requesting another position cancels automatic following.
• Fix: Switching datasets cancels old scroll requests so they cannot override the new dataset's initial position.
• Fix: anchoredEndSpace shrinks excess blank space as rows are measured instead of waiting for every remaining row.
• Fix: Resizing the chat composer preserves the combined keyboard and composer spacing.
• Fix: Web scroll adjustments no longer leave extra padding at the end of the list.
• Fix: Web row reordering happens sooner when idle and preserves focus, animations, and embedded content state in browsers that support state-preserving moves.

v3.3.10

Compare Source

• Fix: Changing dataKey no longer loses the new dataset's initial scroll position when React retries a render.

v3.3.9

Compare Source

• Fix: Rows after an item that changes size stay in the correct positions while scrolling

v3.3.8

Compare Source

• Feat: Add experimental_hideItemsUntilMeasured to make items never display at provisional layouts and wait for correct sizing, at the cost of an extra render per recycled row. This fixes cases where slow item renders could display with gaps/overlaps when scrolling up quickly on slow phones.

v3.3.7

Compare Source

• Fix: Recycled rows no longer briefly show content from the wrong item when data is prepended.

v3.3.6

Compare Source

• Fix: Animated maintainScrollAtEnd follows rapid and first-load content growth, including short alignItemsAtEnd lists, and stops when the user scrolls away.
• Fix: Item size changes no longer interrupt momentum scrolling when maintainVisibleContentPosition adjusts the scroll position.
• Fix: A numeric initialScrollIndex targeting the last item stays at the end when the viewport is measured or resized, while object targets and explicit offsets keep their requested alignment.

v3.3.5

Compare Source

• Fix: Changing dataKey no longer leaves the new dataset invisible. #​519
• Fix: maintainScrollAtEnd stays pinned as newly inserted rows are measured, and scroll corrections preserve anchoredEndSpace padding. #​520
• Fix: Programmatic scrolls no longer throw in browsers, get lost when they replace unfinished initial scrolling, or stop working after a previous request is canceled. #​518

v3.3.4

Compare Source

v3.3.3

Compare Source

• Fix: Row measurements are applied together in a batch, so item positions don't sometimes move after rendering.
• Fix: onStartReached and onEndReached no longer bounce between opposite edges during the same scroll gesture after data changes, MVCP adjustments, or residual scroll events.
• Fix: Prepending items with maintainVisibleContentPosition was sometimes flashing the wrong items for one frame
• Fix: SectionList sticky headers follow their current positions after section data changes. #​445
• Fix: LegendList can now be wrapped with Animated.createAnimatedComponent.
• Fix: Horizontal web lists keep their calculated content width, so item containers do not shrink when the content is wider than the viewport.
• Perf: Lists reuse inactive containers across item types before creating more, preventing the container pool from growing for every previously seen item type.
• Perf: Reanimated lists skip scroll-offset tracking when neither shared scroll values nor sticky headers need it.

v3.3.2

Compare Source

• Perf: Recycled rows update their current item without changing the container context, so recycling hooks avoid extra rerenders during scroll.
• Perf: Internal signal hooks recreate subscriptions less often

v3.3.1

Compare Source

• Fix: scrollToEnd and maintainScrollAtEnd keep reaching the end as content changes, while scrolling away or requesting another position cancels automatic following.
• Fix: Switching datasets cancels old scroll requests so they cannot override the new dataset's initial position.
• Fix: anchoredEndSpace shrinks excess blank space as rows are measured instead of waiting for every remaining row.
• Fix: Resizing the chat composer preserves the combined keyboard and composer spacing.
• Fix: Web scroll adjustments no longer leave extra padding at the end of the list.
• Fix: Web row reordering happens sooner when idle and preserves focus, animations, and embedded content state in browsers that support state-preserving moves.

v3.3.0

Compare Source

• Feat: Add dataKey so apps can tell the list when the current array represents a different dataset, such as switching conversations or feeds without remounting LegendList.
• Feat: experimental_adaptiveRender.onChange now receives a reason (initial, ready, or scroll) so item components can tell why the render mode changed.
• Fix: Large user scroll jumps render the visible rows first and fill the normal draw distance on the next frame, making long jumps less likely to land on a blank range.
• Fix: maintainScrollAtEnd reruns a pending keep-at-end request after the current one settles, so a footer resize and a new message arriving together keep chat-style lists pinned to the end.
• Fix: Replacing data after clearing the list, or changing dataKey for a non-empty replacement, resets layout readiness and uses the latest initial scroll target for the new dataset.

v3.2.0

Compare Source

• Feat: Add onFirstVisibleItemChanged so apps can track the item at the top of the viewport without setting up full viewability callbacks.
• Feat: Add experimental_adaptiveRender.initialMode for choosing whether adaptive rendering starts in normal or light mode before the list is ready.
• Perf: On Fabric, replacement container measurements are batched into the same layout pass, so scroll anchoring and item positioning recalculate once instead of once per pending row.

v3.1.2

Compare Source

• Fix: On Android, end-aligned lists could double apply scroll clamping during MVCP and be slightly underscrolled

v3.1.1

Compare Source

• Fix: maintainScrollAtEnd now stays pinned when a ListFooterComponent appears, disappears, or changes size, so chat typing indicators and other dynamic footers do not leave the list slightly above the end. If you use an explicit maintainScrollAtEnd.on config, add footerLayout to opt into footer size changes.

v3.1.0

Compare Source

• Feat: Add experimental_adaptiveRender prop, with useAdaptiveRender and useAdaptiveRenderChange hooks, so item components can render a lighter version while the list is moving quickly and return to normal after scrolling slows.
• Feat: Add setItemSize to the list ref for updating a known item's measured size directly when its content changes outside normal layout measurement.
• Fix: Web maintainVisibleContentPosition keeps the intended anchor when headers change, browser scroll anchoring runs, or an animated scrollToEnd is already in progress. #​468 #​463
• Fix: initialScrollIndex and initialScrollAtEnd use the latest initial scroll props when data starts empty and loads later, so lists do not scroll to an old startup target.
• Fix: Changing gap now refreshes cached item measurements, and fixed-size rows include the gap in their positions.
• Fix: SectionList sticky headers update after the section data changes. #​445
• Fix: Horizontal lists with end alignment now place items at the end instead of ignoring the alignment. #​472
• Fix: Lists clear scheduled timers on unmount, preventing delayed adaptive-render or scroll work from running after the list is gone.
• Perf: The first render starts with a smaller draw distance and expands shortly after, reducing offscreen work before the initial content appears.
• Perf: alignItemsAtEnd spacer updates cause fewer ScrollView rerenders.
• Types: Export AdaptiveRender and AdaptiveRenderConfig from the React Native and web type entrypoints.

v3.0.6

Compare Source

• Fix: KeyboardAwareLegendList now accounts for bottom insets when alignItemsAtEnd is used, so short chat-style lists stay pinned above the keyboard or safe area instead of being pushed too low or leaving extra scroll space.

v3.0.5

Compare Source

• Fix: clearCaches now rechecks the rows that are already on screen, so resetting the size cache does not leave items stuck in old positions.
• Perf: Scrolling through content that is already rendered now updates viewability with less work.
• Perf: Trimmed repeated work during scrolls, especially around recycled containers, sticky headers, size checks, and viewability.
• Perf: Large and fast scrolls now reuse more of the same scroll state instead of recalculating it in multiple places.

v3.0.4

Compare Source

• Fix: scrollToEnd now waits for newly committed data before targeting the final item, improving chat-style append-and-scroll flows.
• Fix: Anchored end space waits for measured or fixed tail sizes before reporting readiness, avoiding stale end-space values during append flows.
• Feat: Add anchoredEndSpace.onReady to notify when the anchored tail has authoritative sizing.

v3.0.3

Compare Source

• Fix: MVCP was getting batched to improve big jumps, but was making scroll worse
• Fix: On native, ignore one-physical-pixel layout measurement noise, preventing unnecessary item size updates from Fabric and native onLayout rounding differences.
• Fix: Average item sizes update correctly when getFixedItemSize returns undefined for only some item types.

v3.0.2

Compare Source

• Fix: Using viewability was causing scrolling to end to sometimes not update items in view if the JS thread was slammed

v3.0.1

Compare Source

• Feat: SectionList now supports getFixedItemSize for items, headers, footers, and separators.
• Fix: Non-animated scrollTo calls now precompute the target range before scrolling, preventing temporary blank content around the destination.
• Fix: scrollToIndex was landing at the wrong location on iOS in some scenarios

v3.0.0

Compare Source

• Feat: Web support
• Breaking: Some of the maintainVisibleContentPosition behavior for preventing jumping while scrolling is now core behavior, and the behavior for maintaining scroll position when adding data is controlled by the prop, which is now disabled by default.
• See https://legendapp.com/open-source/list/v3/migration/

v3.0.0-beta.56

Compare Source

v3.0.0-beta.55

Compare Source

v3.0.0-beta.54

Compare Source

v3.0.0-beta.53

Compare Source

v3.0.0-beta.52

Compare Source

v3.0.0-beta.51

Compare Source

v3.0.0-beta.50

Compare Source

v3.0.0-beta.49

Compare Source

v3.0.0-beta.48

Compare Source

v3.0.0-beta.47

Compare Source

v3.0.0-beta.46

Compare Source

v3.0.0-beta.45

Compare Source

---

Configuration

📅 Schedule: (UTC)

• Branch creation
  • At any time (no schedule defined)
• Automerge
  • At any time (no schedule defined)

🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.

♻ Rebasing: Whenever PR is behind base branch, or you tick the rebase/retry checkbox.

🔕 Ignore: Close this PR and you won't be reminded about this update again.

---

• If you want to rebase/retry this PR, check this box

---

This PR was generated by Mend Renovate. View the repository job log.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[mergify]

This pull request does not currently match the merge queue conditions, so it cannot be queued from here. The box comes back if it matches again.

[coderabbitai]

Important

Review skipped

Bot user detected.

To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Advanced

Run ID: f4545d72-1c45-4bef-a950-40c484bdb199

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

• Autopilot · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Autopilot is currently an internal CodeRabbit preview.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}