@depup/react-native 0.85.0-depup.1 → 0.86.2-depup.0

package/ReactCommon/react/renderer/viewtransition/CMakeLists.txt

@@ -0,0 +1,22 @@
+# Copyright (c) Meta Platforms, Inc. and affiliates.
+#
+# This source code is licensed under the MIT license found in the
+# LICENSE file in the root directory of this source tree.
+
+cmake_minimum_required(VERSION 3.13)
+set(CMAKE_VERBOSE_MAKEFILE on)
+
+include(${REACT_COMMON_DIR}/cmake-utils/react-native-flags.cmake)
+
+file(GLOB react_renderer_viewtransition_SRC CONFIGURE_DEPENDS *.cpp)
+add_library(react_renderer_viewtransition STATIC ${react_renderer_viewtransition_SRC})
+
+target_include_directories(react_renderer_viewtransition PUBLIC ${REACT_COMMON_DIR})
+
+target_link_libraries(react_renderer_viewtransition
+        glog
+        react_renderer_core
+        react_renderer_mounting
+        react_renderer_uimanager
+)
+target_compile_reactnative_options(react_renderer_viewtransition PRIVATE)

package/ReactCommon/react/renderer/viewtransition/ViewTransitionModule.cpp

@@ -0,0 +1,520 @@
+/*
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#include "ViewTransitionModule.h"
+
+#include <glog/logging.h>
+#include <react/renderer/components/root/RootShadowNode.h>
+#include <react/renderer/core/LayoutableShadowNode.h>
+#include <react/renderer/core/RawProps.h>
+#include <react/renderer/mounting/MountingTransaction.h>
+#include <react/renderer/mounting/ShadowTree.h>
+#include <react/renderer/uimanager/UIManager.h>
+
+namespace facebook::react {
+
+ViewTransitionModule::~ViewTransitionModule() {
+  if (uiManager_ != nullptr) {
+    if (uiManager_->getViewTransitionDelegate() == this) {
+      uiManager_->setViewTransitionDelegate(nullptr);
+    }
+    uiManager_->unregisterCommitHook(*this);
+    uiManager_ = nullptr;
+  }
+}
+
+void ViewTransitionModule::initialize(
+    UIManager* uiManager,
+    std::weak_ptr<ViewTransitionModule> weakThis) {
+  if (uiManager_ != nullptr) {
+    uiManager_->unregisterCommitHook(*this);
+  }
+  uiManager_ = uiManager;
+  if (uiManager_ != nullptr) {
+    uiManager_->registerCommitHook(*this);
+
+    // Register as MountingOverrideDelegate on existing surfaces
+    uiManager_->getShadowTreeRegistry().enumerate(
+        [weakThis](const ShadowTree& shadowTree, bool& /*stop*/) {
+          shadowTree.getMountingCoordinator()->setMountingOverrideDelegate(
+              weakThis);
+        });
+
+    // Register on surfaces started in the future
+    uiManager_->setOnSurfaceStartCallback(
+        [weakThis](const ShadowTree& shadowTree) {
+          shadowTree.getMountingCoordinator()->setMountingOverrideDelegate(
+              weakThis);
+        });
+
+    uiManager_->setViewTransitionDelegate(this);
+  }
+}
+
+void ViewTransitionModule::applyViewTransitionName(
+    const ShadowNode& shadowNode,
+    const std::string& name,
+    const std::string& /*className*/) {
+  auto tag = shadowNode.getTag();
+  auto surfaceId = shadowNode.getSurfaceId();
+
+  auto layoutMetrics = captureLayoutMetricsFromRoot(shadowNode);
+  if (layoutMetrics == EmptyLayoutMetrics) {
+    return;
+  }
+
+  // Convert LayoutMetrics to AnimationKeyFrameViewLayoutMetrics
+  AnimationKeyFrameViewLayoutMetrics keyframeMetrics{
+      .originFromRoot = layoutMetrics.frame.origin,
+      .size = layoutMetrics.frame.size,
+      .pointScaleFactor = layoutMetrics.pointScaleFactor};
+
+  nameRegistry_[tag].insert(name);
+
+  // If applyViewTransitionName is called after transition started, this is the
+  // "new" state (end snapshot). Otherwise, this is the "old" state (start
+  // snapshot)
+  if (!transitionStarted_) {
+    AnimationKeyFrameView oldView{
+        .layoutMetrics = keyframeMetrics, .tag = tag, .surfaceId = surfaceId};
+    oldLayout_[name] = oldView;
+
+    // Request the platform to capture a bitmap snapshot of the old view
+    // while it's still mounted. The platform stores the bitmap keyed by tag.
+    if (uiManager_ != nullptr) {
+      auto* delegate = uiManager_->getDelegate();
+      if (delegate != nullptr) {
+        delegate->uiManagerDidCaptureViewSnapshot(tag, surfaceId);
+      }
+    }
+
+    if (auto it = oldPseudoElementNodesRepository_.find(name);
+        it != oldPseudoElementNodesRepository_.end()) {
+      // Find the pseudo element created from this specific source tag
+      auto& pseudoElementsBySourceTag = it->second;
+      auto innerIt = pseudoElementsBySourceTag.find(tag);
+
+      if (innerIt != pseudoElementsBySourceTag.end()) {
+        // Only clone the pseudo-element if the layout metrics changed
+        // since it was last created/refreshed (e.g. due to scrolling or
+        // React updates).
+        auto& cachedMetrics = innerIt->second.lastAppliedLayoutMetrics;
+        if (cachedMetrics.originFromRoot.x !=
+                keyframeMetrics.originFromRoot.x ||
+            cachedMetrics.originFromRoot.y !=
+                keyframeMetrics.originFromRoot.y ||
+            cachedMetrics.size.width != keyframeMetrics.size.width ||
+            cachedMetrics.size.height != keyframeMetrics.size.height) {
+          auto updatedRawProps = RawProps(
+              folly::dynamic::object("left", keyframeMetrics.originFromRoot.x)(
+                  "top", keyframeMetrics.originFromRoot.y)(
+                  "width", keyframeMetrics.size.width)(
+                  "height", keyframeMetrics.size.height)(
+                  "pointerEvents", "none")("opacity", 0)("collapsable", false)(
+                  "position", "absolute"));
+
+          auto updatedNode = uiManager_->cloneNode(
+              *innerIt->second.node,
+              nullptr /* children */,
+              std::move(updatedRawProps));
+          if (updatedNode != nullptr) {
+            innerIt->second.node = updatedNode;
+            cachedMetrics = keyframeMetrics;
+          }
+        }
+        oldPseudoElementNodes_[name] = innerIt->second.node;
+      } else {
+        LOG(WARNING)
+            << "applyViewTransitionName: old pseudo element shadow node doesn't exist for source tag "
+            << tag << " with name " << name;
+      }
+    } else {
+      LOG(WARNING)
+          << "applyViewTransitionName: old pseudo element shadow node doesn't exist for name "
+          << name;
+    }
+
+  } else {
+    AnimationKeyFrameView newView{
+        .layoutMetrics = keyframeMetrics, .tag = tag, .surfaceId = surfaceId};
+    newLayout_[name] = newView;
+  }
+}
+
+void ViewTransitionModule::createViewTransitionInstance(
+    const std::string& name,
+    Tag pseudoElementTag) {
+  if (uiManager_ == nullptr) {
+    return;
+  }
+
+  // if createViewTransitionInstance is called before transition started, it
+  // creates the old pseudo elements for exiting nodes that potentially
+  // participate in current transition that's about to happen; if called after
+  // transition started, it creates old pseudo elements for entering nodes, and
+  // will be used in next transition when these node are exiting
+  bool forNextTransition = false;
+  AnimationKeyFrameView view = {};
+  auto it = oldLayout_.find(name);
+  if (it == oldLayout_.end()) {
+    forNextTransition = true;
+    if (auto newIt = newLayout_.find(name); newIt != newLayout_.end()) {
+      view = newIt->second;
+    }
+  } else {
+    view = it->second;
+  }
+
+  // Build props: absolute position matching old element, non-interactive
+  if (pseudoElementTag > 0 && view.tag > 0) {
+    // Create a base node with layout props via createNode
+    // TODO: T262559684 created dedicated shadow node type for old pseudo
+    // element
+    auto rawProps = RawProps(
+        folly::dynamic::object("position", "absolute")(
+            "left", view.layoutMetrics.originFromRoot.x)(
+            "top", view.layoutMetrics.originFromRoot.y)(
+            "width", view.layoutMetrics.size.width)(
+            "height", view.layoutMetrics.size.height)("pointerEvents", "none")(
+            "opacity", 0)("collapsable", false));
+
+    auto baseNode = uiManager_->createNode(
+        pseudoElementTag,
+        "View",
+        view.surfaceId,
+        std::move(rawProps),
+        nullptr /* instanceHandle */);
+
+    if (baseNode == nullptr) {
+      return;
+    }
+
+    // Clone the shadow node — bitmap will be set by platform
+    auto pseudoElementNode = baseNode->clone({});
+
+    if (pseudoElementNode != nullptr) {
+      if (!forNextTransition) {
+        oldPseudoElementNodes_[name] = pseudoElementNode;
+      }
+      oldPseudoElementNodesRepository_[name][view.tag] = InactivePseudoElement{
+          .node = pseudoElementNode,
+          .sourceTag = view.tag,
+          .lastAppliedLayoutMetrics = view.layoutMetrics};
+    }
+  }
+}
+
+RootShadowNode::Unshared ViewTransitionModule::shadowTreeWillCommit(
+    const ShadowTree& shadowTree,
+    const RootShadowNode::Shared& /*oldRootShadowNode*/,
+    const RootShadowNode::Unshared& newRootShadowNode,
+    const ShadowTreeCommitOptions& /*commitOptions*/) noexcept {
+  if (oldPseudoElementNodes_.empty()) {
+    return newRootShadowNode;
+  }
+
+  auto surfaceId = shadowTree.getSurfaceId();
+
+  // Collect pseudo-element nodes for this surface, skipping any that are
+  // already present in the children list (from a previous commit hook run).
+  const auto& existingChildren = newRootShadowNode->getChildren();
+  std::unordered_set<Tag> existingTags;
+  existingTags.reserve(existingChildren.size());
+  for (const auto& child : existingChildren) {
+    existingTags.insert(child->getTag());
+  }
+
+  auto newChildren =
+      std::make_shared<std::vector<std::shared_ptr<const ShadowNode>>>(
+          existingChildren);
+  bool appended = false;
+  for (const auto& [name, node] : oldPseudoElementNodes_) {
+    if (node->getSurfaceId() == surfaceId &&
+        existingTags.find(node->getTag()) == existingTags.end()) {
+      newChildren->push_back(node);
+      appended = true;
+    }
+  }
+
+  if (!appended) {
+    return newRootShadowNode;
+  }
+
+  return std::make_shared<RootShadowNode>(
+      *newRootShadowNode,
+      ShadowNodeFragment{
+          .props = ShadowNodeFragment::propsPlaceholder(),
+          .children = newChildren,
+      });
+}
+
+bool ViewTransitionModule::shouldOverridePullTransaction() const {
+  return !oldPseudoElementNodesRepository_.empty();
+}
+
+std::optional<MountingTransaction> ViewTransitionModule::pullTransaction(
+    SurfaceId surfaceId,
+    MountingTransaction::Number number,
+    const TransactionTelemetry& telemetry,
+    ShadowViewMutationList mutations) const {
+  for (const auto& mutation : mutations) {
+    if (mutation.type == ShadowViewMutation::Delete) {
+      auto tag = mutation.oldChildShadowView.tag;
+      for (auto it = oldPseudoElementNodesRepository_.begin();
+           it != oldPseudoElementNodesRepository_.end();) {
+        auto& pseudoElementsBySourceTag = it->second;
+        if (auto innerIt = pseudoElementsBySourceTag.find(tag);
+            innerIt != pseudoElementsBySourceTag.end()) {
+          pseudoElementsBySourceTag.erase(innerIt);
+        }
+        if (pseudoElementsBySourceTag.empty()) {
+          it = oldPseudoElementNodesRepository_.erase(it);
+        } else {
+          ++it;
+        }
+      }
+    }
+  }
+  return MountingTransaction{
+      surfaceId, number, std::move(mutations), telemetry};
+}
+
+std::shared_ptr<const ShadowNode>
+ViewTransitionModule::findPseudoElementShadowNodeByTag(Tag tag) const {
+  if (uiManager_ == nullptr) {
+    return nullptr;
+  }
+
+  auto shadowNode = std::shared_ptr<const ShadowNode>{};
+
+  uiManager_->getShadowTreeRegistry().enumerate(
+      [&](const ShadowTree& shadowTree, bool& stop) {
+        const auto rootShadowNode =
+            shadowTree.getCurrentRevision().rootShadowNode;
+
+        if (rootShadowNode != nullptr) {
+          const auto& children = rootShadowNode->getChildren();
+          // Pseudo element nodes are appended after the first child (the main
+          // React tree), so iterate from index 1 onwards.
+          for (size_t i = 1; i < children.size(); ++i) {
+            if (children[i]->getTag() == tag) {
+              shadowNode = children[i];
+              stop = true;
+              return;
+            }
+          }
+        }
+      });
+
+  return shadowNode;
+}
+
+void ViewTransitionModule::cancelViewTransitionName(
+    const ShadowNode& shadowNode,
+    const std::string& name) {
+  oldLayout_.erase(name);
+  newLayout_.erase(name);
+  cancelledNameRegistry_[shadowNode.getTag()].insert(name);
+}
+
+void ViewTransitionModule::restoreViewTransitionName(
+    const ShadowNode& shadowNode) {
+  nameRegistry_[shadowNode.getTag()].merge(
+      cancelledNameRegistry_[shadowNode.getTag()]);
+  cancelledNameRegistry_.erase(shadowNode.getTag());
+}
+
+void ViewTransitionModule::applySnapshotsOnPseudoElementShadowNodes() {
+  if (oldPseudoElementNodes_.empty() || uiManager_ == nullptr) {
+    return;
+  }
+
+  // Set view snapshots — the pseudo-element nodes themselves will be committed
+  // through the normal completeRoot flow via getPseudoElementNodes().
+  auto* delegate = uiManager_->getDelegate();
+  if (delegate != nullptr) {
+    for (const auto& [name, node] : oldPseudoElementNodes_) {
+      auto layoutIt = oldLayout_.find(name);
+      if (layoutIt != oldLayout_.end()) {
+        delegate->uiManagerDidSetViewSnapshot(
+            layoutIt->second.tag, node->getTag(), node->getSurfaceId());
+      }
+    }
+  }
+}
+
+LayoutMetrics ViewTransitionModule::captureLayoutMetricsFromRoot(
+    const ShadowNode& shadowNode) {
+  if (uiManager_ == nullptr) {
+    return EmptyLayoutMetrics;
+  }
+
+  // Get the current revision (root node) for this surface
+  auto currentRevision =
+      uiManager_->getShadowTreeRevisionProvider()->getCurrentRevision(
+          shadowNode.getSurfaceId());
+
+  if (currentRevision == nullptr) {
+    return EmptyLayoutMetrics;
+  }
+
+  // Cast root to LayoutableShadowNode
+  auto layoutableRoot =
+      dynamic_cast<const LayoutableShadowNode*>(currentRevision.get());
+  if (layoutableRoot == nullptr) {
+    return EmptyLayoutMetrics;
+  }
+
+  return LayoutableShadowNode::computeLayoutMetricsFromRoot(
+      shadowNode.getFamily(), *layoutableRoot, {});
+}
+
+void ViewTransitionModule::startViewTransition(
+    std::function<void()> mutationCallback,
+    std::function<void()> onReadyCallback,
+    std::function<void()> onCompleteCallback) {
+  // If the reconciler signalled suspension and a transition is still active,
+  // queue this transition to run after the current one finishes.
+  // Only queue if the previous transition is still running; if it already
+  // finished, the flag is stale and we should run normally.
+  if (suspendNextTransition_ && transitionStarted_) {
+    suspendNextTransition_ = false;
+    pendingTransitions_.push(
+        PendingTransition{
+            std::move(mutationCallback),
+            std::move(onReadyCallback),
+            std::move(onCompleteCallback)});
+    return;
+  }
+  suspendNextTransition_ = false;
+
+  // Mark transition as started
+  transitionStarted_ = true;
+  pendingAnimationIds_.clear();
+  onCompleteCallback_ = onCompleteCallback;
+
+  // Call mutation callback (including commitRoot, measureInstance,
+  // applyViewTransitionName, createViewTransitionInstance for old & new)
+  if (mutationCallback) {
+    mutationCallback();
+  }
+
+  applySnapshotsOnPseudoElementShadowNodes();
+
+  transitionReadyFinished_ = false;
+  // onReadyCallback starts the animations. Any animation registered via
+  // waitForTransitionAnimation during this callback is part of this transition.
+  if (onReadyCallback) {
+    onReadyCallback();
+  }
+}
+
+void ViewTransitionModule::waitForTransitionAnimation(int animationId) {
+  if (!transitionReadyFinished_) {
+    pendingAnimationIds_.insert(animationId);
+  }
+}
+
+void ViewTransitionModule::transitionAnimationFinished(int animationId) {
+  pendingAnimationIds_.erase(animationId);
+  if (transitionReadyFinished_ && pendingAnimationIds_.empty() &&
+      onCompleteCallback_) {
+    auto callback = std::move(onCompleteCallback_);
+    onCompleteCallback_ = nullptr;
+    callback();
+  }
+}
+
+void ViewTransitionModule::startViewTransitionReadyFinished() {
+  transitionReadyFinished_ = true;
+
+  if (pendingAnimationIds_.empty() && onCompleteCallback_) {
+    auto callback = std::move(onCompleteCallback_);
+    onCompleteCallback_ = nullptr;
+    callback();
+  }
+}
+
+void ViewTransitionModule::suspendOnActiveViewTransition() {
+  // Signal that the next transition should be suspended until the current
+  // one finishes. The actual queueing happens in startViewTransition.
+  if (transitionStarted_) {
+    // if there's no active transition, suspendOnActiveViewTransition is no-op
+    suspendNextTransition_ = true;
+  }
+}
+
+void ViewTransitionModule::startViewTransitionEnd() {
+  for (const auto& [tag, names] : nameRegistry_) {
+    for (const auto& name : names) {
+      oldLayout_.erase(name);
+      newLayout_.erase(name);
+    }
+  }
+  nameRegistry_.clear();
+  oldPseudoElementNodes_.clear();
+
+  // Clear any pending bitmap snapshots that were captured but never consumed.
+  if (uiManager_ != nullptr) {
+    auto* delegate = uiManager_->getDelegate();
+    if (delegate != nullptr) {
+      delegate->uiManagerDidClearPendingSnapshots();
+    }
+  }
+
+  transitionStarted_ = false;
+
+  if (!pendingTransitions_.empty()) {
+    auto pendingTransition = pendingTransitions_.front();
+    pendingTransitions_.pop();
+    startViewTransition(
+        std::move(pendingTransition.mutationCallback),
+        std::move(pendingTransition.onReadyCallback),
+        std::move(pendingTransition.onCompleteCallback));
+    // when this transition finishes, it'll call startViewTransitionEnd
+    // during its complete callback and pendingTransitions_ will be processed
+    // again
+  }
+}
+
+std::optional<UIManagerViewTransitionDelegate::ViewTransitionInstance>
+ViewTransitionModule::getViewTransitionInstance(
+    const std::string& name,
+    const std::string& pseudo) {
+  // Look up layout based on pseudo type ("old" or "new")
+  if (pseudo == "new") {
+    auto it = newLayout_.find(name);
+    if (it != newLayout_.end()) {
+      const auto& view = it->second;
+      return ViewTransitionInstance{
+          .x = view.layoutMetrics.originFromRoot.x,
+          .y = view.layoutMetrics.originFromRoot.y,
+          .width = view.layoutMetrics.size.width,
+          .height = view.layoutMetrics.size.height,
+          .nativeTag = view.tag};
+    }
+  } else if (pseudo == "old") {
+    auto it = oldLayout_.find(name);
+    if (it != oldLayout_.end()) {
+      const auto& view = it->second;
+      auto pseudoElementIt = oldPseudoElementNodes_.find(name);
+      auto nativeTag = pseudoElementIt != oldPseudoElementNodes_.end()
+          ? pseudoElementIt->second->getTag()
+          : -1;
+      return ViewTransitionInstance{
+          .x = view.layoutMetrics.originFromRoot.x,
+          .y = view.layoutMetrics.originFromRoot.y,
+          .width = view.layoutMetrics.size.width,
+          .height = view.layoutMetrics.size.height,
+          .nativeTag = nativeTag};
+    }
+  }
+
+  return std::nullopt;
+}
+
+} // namespace facebook::react

package/ReactCommon/react/renderer/viewtransition/ViewTransitionModule.h

@@ -0,0 +1,161 @@
+/*
+ * Copyright (c) Meta Platforms, Inc. and affiliates.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+
+#pragma once
+
+#include <queue>
+#include <unordered_set>
+
+#include <react/renderer/core/LayoutMetrics.h>
+#include <react/renderer/core/ShadowNode.h>
+#include <react/renderer/mounting/MountingOverrideDelegate.h>
+#include <react/renderer/mounting/ShadowViewMutation.h>
+#include <react/renderer/uimanager/UIManagerCommitHook.h>
+#include <react/renderer/uimanager/UIManagerViewTransitionDelegate.h>
+
+namespace facebook::react {
+
+class ShadowTree;
+class UIManager;
+
+class ViewTransitionModule : public UIManagerViewTransitionDelegate,
+                             public UIManagerCommitHook,
+                             public MountingOverrideDelegate {
+ public:
+  ~ViewTransitionModule() override;
+
+  void initialize(UIManager *uiManager, std::weak_ptr<ViewTransitionModule> weakThis);
+
+#pragma mark - UIManagerViewTransitionDelegate
+
+  // will be called when a view will transition. if a view already has a view-transition-name, it may not be called
+  // again until it's removed
+  void applyViewTransitionName(const ShadowNode &shadowNode, const std::string &name, const std::string &className)
+      override;
+
+  // creates a pseudo-element shadow node for a given transition name using the
+  // captured old layout metrics
+  void createViewTransitionInstance(const std::string &name, Tag pseudoElementTag) override;
+
+  // if a viewTransitionName is cancelled, the element doesn't have view-transition-name and browser won't be taking
+  // snapshot
+  void cancelViewTransitionName(const ShadowNode &shadowNode, const std::string &name) override;
+
+  // restore cancellation
+  void restoreViewTransitionName(const ShadowNode &shadowNode) override;
+
+  void startViewTransition(
+      std::function<void()> mutationCallback,
+      std::function<void()> onReadyCallback,
+      std::function<void()> onCompleteCallback) override;
+
+  void startViewTransitionReadyFinished() override;
+
+  void startViewTransitionEnd() override;
+
+  std::optional<ViewTransitionInstance> getViewTransitionInstance(const std::string &name, const std::string &pseudo)
+      override;
+
+#pragma mark - UIManagerCommitHook
+
+  void commitHookWasRegistered(const UIManager & /*uiManager*/) noexcept override {}
+  void commitHookWasUnregistered(const UIManager & /*uiManager*/) noexcept override {}
+  RootShadowNode::Unshared shadowTreeWillCommit(
+      const ShadowTree &shadowTree,
+      const RootShadowNode::Shared &oldRootShadowNode,
+      const RootShadowNode::Unshared &newRootShadowNode,
+      const ShadowTreeCommitOptions &commitOptions) noexcept override;
+
+#pragma mark - MountingOverrideDelegate
+
+  bool shouldOverridePullTransaction() const override;
+  std::optional<MountingTransaction> pullTransaction(
+      SurfaceId surfaceId,
+      MountingTransaction::Number number,
+      const TransactionTelemetry &telemetry,
+      ShadowViewMutationList mutations) const override;
+
+  std::shared_ptr<const ShadowNode> findPseudoElementShadowNodeByTag(Tag tag) const override;
+
+  void suspendOnActiveViewTransition() override;
+
+  void waitForTransitionAnimation(int animationId) override;
+
+  void transitionAnimationFinished(int animationId) override;
+
+  // Animation state structure for storing minimal view data
+  struct AnimationKeyFrameViewLayoutMetrics {
+    Point originFromRoot;
+    Size size;
+    Float pointScaleFactor{};
+  };
+
+  struct AnimationKeyFrameView {
+    AnimationKeyFrameViewLayoutMetrics layoutMetrics;
+    Tag tag{0};
+    SurfaceId surfaceId{0};
+  };
+
+ private:
+  // registry of layout of old/new views
+  std::unordered_map<std::string, AnimationKeyFrameView> oldLayout_{};
+  std::unordered_map<std::string, AnimationKeyFrameView> newLayout_{};
+  // tag -> names registry, populated during applyViewTransitionName
+  // Note that tag and name are not 1:1 mapping
+  // - In some nested composition 2 names are mappped to the same tag
+  // - tags of old and new views are mapped to the same name(s)
+  std::unordered_map<Tag, std::unordered_set<std::string>> nameRegistry_{};
+
+  // used for cancel/restore viewTransitionName
+  std::unordered_map<Tag, std::unordered_set<std::string>> cancelledNameRegistry_{};
+
+  // pseudo-element nodes keyed by transition name, appended to root children via UIManagerCommitHook
+  // TODO: T262559264 pseudo elements should be cleaned up as soon as transition animation ends
+  std::unordered_map<std::string, std::shared_ptr<const ShadowNode>> oldPseudoElementNodes_{};
+
+  struct InactivePseudoElement {
+    std::shared_ptr<const ShadowNode> node;
+    // tag of the original view this was created from
+    Tag sourceTag{0};
+    // Layout metrics last applied to the pseudo-element node's props.
+    AnimationKeyFrameViewLayoutMetrics lastAppliedLayoutMetrics{};
+  };
+  // pseudo-element nodes created for entering nodes, to be copied into
+  // oldPseudoElementNodes_ during the next applyViewTransitionName call.
+  // Mutable because pullTransaction (const) needs to erase unmounted entries.
+  mutable std::unordered_map<std::string, std::unordered_map<Tag /* sourceTag */, InactivePseudoElement>>
+      oldPseudoElementNodesRepository_{};
+
+  LayoutMetrics captureLayoutMetricsFromRoot(const ShadowNode &shadowNode);
+
+  void applySnapshotsOnPseudoElementShadowNodes();
+
+  UIManager *uiManager_{nullptr};
+
+  bool transitionStarted_{false};
+
+  bool transitionReadyFinished_{false};
+
+  // When suspendNextTransition_ is true and a transition is active, the next
+  // startViewTransition calls are queued instead of running immediately.
+  bool suspendNextTransition_{false};
+
+  struct PendingTransition {
+    std::function<void()> mutationCallback;
+    std::function<void()> onReadyCallback;
+    std::function<void()> onCompleteCallback;
+  };
+  std::queue<PendingTransition> pendingTransitions_{};
+
+  // Tracks animation IDs that must complete before onCompleteCallback_ fires.
+  // Animations are registered via waitForTransitionAnimation (called from JS
+  // after connectAnimatedNodeToView) and removed via transitionAnimationFinished.
+  std::unordered_set<int> pendingAnimationIds_{};
+  std::function<void()> onCompleteCallback_{nullptr};
+};
+
+} // namespace facebook::react