[chrispader]

Before a list is ready, requestAdjust moves state.scroll and the item positions right away but applies the native scroll adjustment on the next frame. setInitialRenderState could mark the list ready before that frame ran, so the items appeared at the unadjusted offset and jumped once the adjustment landed. A native initial scroll dispatched in between also already targets the adjusted offset, so the late anchor move shifted the list a second time, and completion retries reissued the offset recorded at dispatch.

With this change, the list becomes ready only after every adjustment queued before that point has run. A deferred adjustment is skipped when an absolute native scroll was issued after it was requested, and the target of an in-flight native initial scroll moves with each adjustment. Web retargets from the index and is unchanged.

// initialScrollIndex: { index: 37, viewOffset: 40 }; item 37 is at 1618 after the first measurements.
// The initial scroll targets 1578. Then the deferred adjustments for those measurements land: -172.
// Before: native ends at 1406, the fallback reissues 1578, and later rows (-36) leave item 37 at 4 instead of 40.
// After: native stays at 1578, the target follows to 1542, and the list appears with item 37 40 points below the top.

The queued callback now also owns the adjustingFromInitialMount counter. Before, only the regular path decremented it, so the Android old-architecture workaround would have kept the list hidden.

This PR now also contains the deferred-adjustment fix from #604, because both change the same callback. #604 keeps only the silent-retry fix and builds on this PR.

We hit this in Expensify/App#100733, which moves the chat message list to LegendList. On iOS and Android, a chat that opens at a linked message showed the message at the top of the list and then moved it down to its offset. Expensify currently carries this fix as a patch.

Reproduction

1. On iOS or Android, render a list with initialScrollIndex: { index: 37, viewOffset: 40 } whose items above index 37 render smaller than estimatedItemSize.
2. Open the screen with the list.
3. Verify the item at index 37 first appears 40 points below the top and doesn't move afterward.

🤖 Generated with Claude Code

[chatgpt-codex-connector]

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review	Status	Commit	Review trigger
📝 Code Review	⚠️ Failed 2026-11-05T11:34:19.443832Z We couldn’t complete this review. Comment @codex review to try again.	062938a	PR opened

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

[chatgpt-codex-connector]

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Credits must be used to enable repository wide code reviews.