Skip to content

Add bitmap snapshot capture/display delegate plumbing (#56458)#56458

Open
zeyap wants to merge 4 commits intofacebook:mainfrom
zeyap:export-D98354659
Open

Add bitmap snapshot capture/display delegate plumbing (#56458)#56458
zeyap wants to merge 4 commits intofacebook:mainfrom
zeyap:export-D98354659

Conversation

@zeyap
Copy link
Copy Markdown
Contributor

@zeyap zeyap commented Apr 15, 2026

Summary:

Changelog:

[Internal] [Added] - Add bitmap snapshot capture/display delegate plumbing

Wire view transition bitmap snapshot capture and display through the C++
delegate chain so platforms can implement snapshotting old-element views.

ViewTransitionModule.cpp: Call uiManagerDidCaptureViewSnapshot(tag, surfaceId) in applyViewTransitionName to capture a bitmap of the old view
while it is still mounted, and uiManagerDidSetViewSnapshot(sourceTag, targetTag, surfaceId) in applySnapshotsOnPseudoElementShadowNodes to map
captured bitmaps onto pseudo-element views.

UIManagerDelegate / SchedulerDelegate: Add pure virtual
captureViewSnapshot and setViewSnapshot methods.

Scheduler: Forward UIManagerDelegate calls to SchedulerDelegate.

Platform stubs: Empty implementations for iOS (RCTScheduler.mm),
CxxPlatform (SchedulerDelegateImpl), and Android JNI
(FabricUIManagerBinding) — Android implementation follows in D99173446.

Reviewed By: NickGerleman

Differential Revision: D98354659

@meta-cla meta-cla bot added the CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. label Apr 15, 2026
@meta-codesync
Copy link
Copy Markdown

meta-codesync bot commented Apr 15, 2026

@zeyap has exported this pull request. If you are a Meta employee, you can view the originating Diff in D98354659.

Zeya Peng added 3 commits April 15, 2026 11:50
Summary:
Implement `createViewTransitionInstance`, which is invoked by the React reconciler to create pseudo-element shadow nodes that visually represent the old state of elements participating in a view transition.

Key changes:
- Add `createViewTransitionInstance` JSI binding in `UIManagerBinding`, accepting a transition name and pseudo-element tag
- Add virtual `createViewTransitionInstance` method to `UIManagerViewTransitionDelegate`
- Implement the method in `ViewTransitionModule`: creates an absolutely-positioned, non-interactive `View` shadow node matching the old element's layout metrics (position, size)
- Manage two pseudo-element node maps: `oldPseudoElementNodes_` for the current transition and `oldPseudoElementNodesForNextTransition_` for entering nodes that may exit in a future transition
- Update `getOldViewTransitionInstance` to return the pseudo-element's tag (instead of the original element's tag) when a pseudo-element exists
- Add `applySnapshotsOnPseudoElementShadowNodes` stub for future platform-level bitmap snapshot integration

`createViewTransitionInstance` is typically called after `applyViewTransitionName` in the React reconciler. See the diagram below for the full flow.

{F1987481080}

Differential Revision: D98981886
Summary:
Append view transition pseudo-element shadow nodes to the root's children at commit time (`shadowTreeWillCommit`), so they are committed into the shadow tree and rendered by the platform.

Key changes:
- Add `getPseudoElementNodes(surfaceId)` virtual method to `UIManagerViewTransitionDelegate`, returning pseudo-element shadow nodes filtered by surface ID
- Implement the method in `ViewTransitionModule`, iterating over `oldPseudoElementNodes_` and collecting nodes matching the given surface
- In `shadowTreeWillCommit`, when view transitions are enabled, query the delegate for pseudo-element nodes and insert them at the end of `rootChildren` before committing

This ensures pseudo-element nodes (created by `createViewTransitionInstance`) are included in the committed shadow tree and ultimately mounted as platform views that display old-element snapshots during transitions.

Differential Revision: D98982122
Summary:
Add `findPseudoElementShadowNodeByTag` to look up pseudo-element shadow nodes by tag from JS, and update the animation helper to connect animated nodes to pseudo-element shadow nodes for old-element animations.

Key changes:
- Add `findPseudoElementShadowNodeByTag(tag)` virtual method to `UIManagerViewTransitionDelegate` and implement in `ViewTransitionModule` (linear scan over `oldPseudoElementNodes_`)
- Expose the method via `NativeViewTransition` TurboModule so JS can resolve a pseudo-element's shadow node by its native tag
- Add `findPseudoElementShadowNodeByTag` to `NativeViewTransition.js` spec
- Update `ViewTransitionAnimationHelper.js`:
  - `animateInternal` accepts a new `pseudo` parameter (`'old'` | `'new'`)
  - When `pseudo === 'old'`, use `findPseudoElementShadowNodeByTag` instead of `findShadowNodeByTag_DEPRECATED` to connect animated nodes to the correct shadow node family
  - Pass `'new'` for enter animations and propagate `_pseudo` from pseudo-element objects for exit animations

Differential Revision: D98982251
@meta-codesync meta-codesync bot changed the title Add bitmap snapshot capture/display delegate plumbing Add bitmap snapshot capture/display delegate plumbing (#56458) Apr 15, 2026
@zeyap zeyap force-pushed the export-D98354659 branch from 4a51bd1 to 3cf6ac2 Compare April 15, 2026 20:17
zeyap added a commit to zeyap/react-native that referenced this pull request Apr 15, 2026
Summary:

## Changelog:

[Internal] [Added] - Add bitmap snapshot capture/display delegate plumbing

Wire view transition bitmap snapshot capture and display through the C++
delegate chain so platforms can implement snapshotting old-element views.

**ViewTransitionModule.cpp**: Call `uiManagerDidCaptureViewSnapshot(tag,
surfaceId)` in `applyViewTransitionName` to capture a bitmap of the old view
while it is still mounted, and `uiManagerDidSetViewSnapshot(sourceTag,
targetTag, surfaceId)` in `applySnapshotsOnPseudoElementShadowNodes` to map
captured bitmaps onto pseudo-element views.

**UIManagerDelegate / SchedulerDelegate**: Add pure virtual
`captureViewSnapshot` and `setViewSnapshot` methods.

**Scheduler**: Forward `UIManagerDelegate` calls to `SchedulerDelegate`.

**Platform stubs**: Empty implementations for iOS (`RCTScheduler.mm`),
CxxPlatform (`SchedulerDelegateImpl`), and Android JNI
(`FabricUIManagerBinding`) — Android implementation follows in D99173446.

Reviewed By: NickGerleman

Differential Revision: D98354659
@zeyap zeyap force-pushed the export-D98354659 branch from 3cf6ac2 to af049ac Compare April 15, 2026 20:23
zeyap added a commit to zeyap/react-native that referenced this pull request Apr 15, 2026
Summary:

## Changelog:

[Internal] [Added] - Add bitmap snapshot capture/display delegate plumbing

Wire view transition bitmap snapshot capture and display through the C++
delegate chain so platforms can implement snapshotting old-element views.

**ViewTransitionModule.cpp**: Call `uiManagerDidCaptureViewSnapshot(tag,
surfaceId)` in `applyViewTransitionName` to capture a bitmap of the old view
while it is still mounted, and `uiManagerDidSetViewSnapshot(sourceTag,
targetTag, surfaceId)` in `applySnapshotsOnPseudoElementShadowNodes` to map
captured bitmaps onto pseudo-element views.

**UIManagerDelegate / SchedulerDelegate**: Add pure virtual
`captureViewSnapshot` and `setViewSnapshot` methods.

**Scheduler**: Forward `UIManagerDelegate` calls to `SchedulerDelegate`.

**Platform stubs**: Empty implementations for iOS (`RCTScheduler.mm`),
CxxPlatform (`SchedulerDelegateImpl`), and Android JNI
(`FabricUIManagerBinding`) — Android implementation follows in D99173446.

Reviewed By: NickGerleman

Differential Revision: D98354659
Summary:
Pull Request resolved: facebook#56458

## Changelog:

[Internal] [Added] - Add bitmap snapshot capture/display delegate plumbing

Wire view transition bitmap snapshot capture and display through the C++
delegate chain so platforms can implement snapshotting old-element views.

**ViewTransitionModule.cpp**: Call `uiManagerDidCaptureViewSnapshot(tag,
surfaceId)` in `applyViewTransitionName` to capture a bitmap of the old view
while it is still mounted, and `uiManagerDidSetViewSnapshot(sourceTag,
targetTag, surfaceId)` in `applySnapshotsOnPseudoElementShadowNodes` to map
captured bitmaps onto pseudo-element views.

**UIManagerDelegate / SchedulerDelegate**: Add pure virtual
`captureViewSnapshot` and `setViewSnapshot` methods.

**Scheduler**: Forward `UIManagerDelegate` calls to `SchedulerDelegate`.

**Platform stubs**: Empty implementations for iOS (`RCTScheduler.mm`),
CxxPlatform (`SchedulerDelegateImpl`), and Android JNI
(`FabricUIManagerBinding`) — Android implementation follows in D99173446.

Reviewed By: NickGerleman

Differential Revision: D98354659
@zeyap zeyap force-pushed the export-D98354659 branch from af049ac to 408478c Compare April 15, 2026 20:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. fb-exported meta-exported p: Facebook Partner: Facebook Partner

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant