react-native-screen-transitions 3.12.0 → 3.13.0-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (336) hide show
  1. package/lib/commonjs/shared/components/activity/variants/activity-screen.js +1 -1
  2. package/lib/commonjs/shared/components/activity/variants/activity-screen.js.map +1 -1
  3. package/lib/commonjs/shared/components/boundary/components/boundary-lifecycle.js +0 -3
  4. package/lib/commonjs/shared/components/boundary/components/boundary-lifecycle.js.map +1 -1
  5. package/lib/commonjs/shared/components/boundary/hooks/lifecycles/use-boundary-measurement-request.js +69 -0
  6. package/lib/commonjs/shared/components/boundary/hooks/lifecycles/use-boundary-measurement-request.js.map +1 -0
  7. package/lib/commonjs/shared/components/boundary/hooks/lifecycles/use-boundary-presence.js +11 -10
  8. package/lib/commonjs/shared/components/boundary/hooks/lifecycles/use-boundary-presence.js.map +1 -1
  9. package/lib/commonjs/shared/components/boundary/hooks/use-boundary-measurement.js +3 -19
  10. package/lib/commonjs/shared/components/boundary/hooks/use-boundary-measurement.js.map +1 -1
  11. package/lib/commonjs/shared/components/boundary/hooks/use-measurer.js +6 -16
  12. package/lib/commonjs/shared/components/boundary/hooks/use-measurer.js.map +1 -1
  13. package/lib/commonjs/shared/components/boundary/portal/components/boundary-content-portal/helpers/active-handoff-receiver.js +27 -1
  14. package/lib/commonjs/shared/components/boundary/portal/components/boundary-content-portal/helpers/active-handoff-receiver.js.map +1 -1
  15. package/lib/commonjs/shared/components/boundary/portal/components/boundary-content-portal/hooks/use-boundary-content-portal-attachment.js +26 -8
  16. package/lib/commonjs/shared/components/boundary/portal/components/boundary-content-portal/hooks/use-boundary-content-portal-attachment.js.map +1 -1
  17. package/lib/commonjs/shared/components/boundary/portal/components/boundary-portal/components/portal-boundary-host.js +8 -1
  18. package/lib/commonjs/shared/components/boundary/portal/components/boundary-portal/components/portal-boundary-host.js.map +1 -1
  19. package/lib/commonjs/shared/components/boundary/portal/components/boundary-portal/helpers/attachment.js +19 -0
  20. package/lib/commonjs/shared/components/boundary/portal/components/boundary-portal/helpers/attachment.js.map +1 -0
  21. package/lib/commonjs/shared/components/boundary/portal/components/boundary-portal/helpers/host-readiness.js +18 -0
  22. package/lib/commonjs/shared/components/boundary/portal/components/boundary-portal/helpers/host-readiness.js.map +1 -0
  23. package/lib/commonjs/shared/components/boundary/portal/components/boundary-portal/helpers/local-measurement.js +22 -1
  24. package/lib/commonjs/shared/components/boundary/portal/components/boundary-portal/helpers/local-measurement.js.map +1 -1
  25. package/lib/commonjs/shared/components/boundary/portal/components/boundary-portal/hooks/use-active-portal-boundary-host.js +10 -10
  26. package/lib/commonjs/shared/components/boundary/portal/components/boundary-portal/hooks/use-active-portal-boundary-host.js.map +1 -1
  27. package/lib/commonjs/shared/components/boundary/portal/components/boundary-portal/hooks/use-boundary-portal-attachment.js +18 -6
  28. package/lib/commonjs/shared/components/boundary/portal/components/boundary-portal/hooks/use-boundary-portal-attachment.js.map +1 -1
  29. package/lib/commonjs/shared/providers/helpers/measured-bounds-writes.js +4 -0
  30. package/lib/commonjs/shared/providers/helpers/measured-bounds-writes.js.map +1 -1
  31. package/lib/commonjs/shared/providers/screen/animation/animation.provider.js +4 -1
  32. package/lib/commonjs/shared/providers/screen/animation/animation.provider.js.map +1 -1
  33. package/lib/commonjs/shared/providers/screen/animation/helpers/hydrate-transition-state/index.js +5 -1
  34. package/lib/commonjs/shared/providers/screen/animation/helpers/hydrate-transition-state/index.js.map +1 -1
  35. package/lib/commonjs/shared/providers/screen/animation/helpers/interpolator-participation.js +9 -0
  36. package/lib/commonjs/shared/providers/screen/animation/helpers/interpolator-participation.js.map +1 -0
  37. package/lib/commonjs/shared/providers/screen/animation/helpers/pipeline.js +13 -2
  38. package/lib/commonjs/shared/providers/screen/animation/helpers/pipeline.js.map +1 -1
  39. package/lib/commonjs/shared/providers/screen/descriptors/descriptors.provider.js +40 -8
  40. package/lib/commonjs/shared/providers/screen/descriptors/descriptors.provider.js.map +1 -1
  41. package/lib/commonjs/shared/providers/screen/descriptors/helpers/derive-descriptor-derivations.js +2 -0
  42. package/lib/commonjs/shared/providers/screen/descriptors/helpers/derive-descriptor-derivations.js.map +1 -1
  43. package/lib/commonjs/shared/providers/screen/descriptors/helpers/derive-structural-ancestor-keys.js +12 -0
  44. package/lib/commonjs/shared/providers/screen/descriptors/helpers/derive-structural-ancestor-keys.js.map +1 -0
  45. package/lib/commonjs/shared/providers/screen/gestures/pan/behavior/pan-lifecycle.js +1 -0
  46. package/lib/commonjs/shared/providers/screen/gestures/pan/behavior/pan-lifecycle.js.map +1 -1
  47. package/lib/commonjs/shared/providers/screen/gestures/pan/behavior/pan-release.js +9 -2
  48. package/lib/commonjs/shared/providers/screen/gestures/pan/behavior/pan-release.js.map +1 -1
  49. package/lib/commonjs/shared/providers/screen/gestures/pan/behavior/use-pan-behavior.js +1 -0
  50. package/lib/commonjs/shared/providers/screen/gestures/pan/behavior/use-pan-behavior.js.map +1 -1
  51. package/lib/commonjs/shared/providers/screen/styles/constants.js +2 -1
  52. package/lib/commonjs/shared/providers/screen/styles/constants.js.map +1 -1
  53. package/lib/commonjs/shared/providers/screen/styles/helpers/visibility-block-ownership.js +19 -0
  54. package/lib/commonjs/shared/providers/screen/styles/helpers/visibility-block-ownership.js.map +1 -0
  55. package/lib/commonjs/shared/providers/screen/styles/hooks/use-maybe-block-visibility.js +35 -15
  56. package/lib/commonjs/shared/providers/screen/styles/hooks/use-maybe-block-visibility.js.map +1 -1
  57. package/lib/commonjs/shared/providers/screen/styles/slot.provider.js +15 -6
  58. package/lib/commonjs/shared/providers/screen/styles/slot.provider.js.map +1 -1
  59. package/lib/commonjs/shared/stores/bounds/helpers/link-pairs.helpers.js +11 -1
  60. package/lib/commonjs/shared/stores/bounds/helpers/link-pairs.helpers.js.map +1 -1
  61. package/lib/commonjs/shared/stores/bounds/internals/clear.js +6 -0
  62. package/lib/commonjs/shared/stores/bounds/internals/clear.js.map +1 -1
  63. package/lib/commonjs/shared/stores/bounds/internals/coordinator.js +298 -0
  64. package/lib/commonjs/shared/stores/bounds/internals/coordinator.js.map +1 -0
  65. package/lib/commonjs/shared/stores/bounds/internals/entries.js +0 -27
  66. package/lib/commonjs/shared/stores/bounds/internals/entries.js.map +1 -1
  67. package/lib/commonjs/shared/stores/bounds/internals/links.js +22 -32
  68. package/lib/commonjs/shared/stores/bounds/internals/links.js.map +1 -1
  69. package/lib/commonjs/shared/stores/bounds/internals/screen-graph.js +45 -0
  70. package/lib/commonjs/shared/stores/bounds/internals/screen-graph.js.map +1 -0
  71. package/lib/commonjs/shared/stores/bounds/internals/state.js +4 -1
  72. package/lib/commonjs/shared/stores/bounds/internals/state.js.map +1 -1
  73. package/lib/commonjs/shared/utils/bounds/helpers/create-bounds-accessor-core.js +7 -3
  74. package/lib/commonjs/shared/utils/bounds/helpers/create-bounds-accessor-core.js.map +1 -1
  75. package/lib/commonjs/shared/utils/bounds/helpers/create-link-accessor.js +11 -0
  76. package/lib/commonjs/shared/utils/bounds/helpers/create-link-accessor.js.map +1 -1
  77. package/lib/commonjs/shared/utils/bounds/helpers/prepare-bound-styles.js +6 -2
  78. package/lib/commonjs/shared/utils/bounds/helpers/prepare-bound-styles.js.map +1 -1
  79. package/lib/commonjs/shared/utils/bounds/helpers/resolve-bounds-pair-key.js.map +1 -1
  80. package/lib/commonjs/shared/utils/bounds/helpers/styles/compute.js +11 -5
  81. package/lib/commonjs/shared/utils/bounds/helpers/styles/compute.js.map +1 -1
  82. package/lib/module/shared/components/activity/variants/activity-screen.js +1 -1
  83. package/lib/module/shared/components/activity/variants/activity-screen.js.map +1 -1
  84. package/lib/module/shared/components/boundary/components/boundary-lifecycle.js +0 -3
  85. package/lib/module/shared/components/boundary/components/boundary-lifecycle.js.map +1 -1
  86. package/lib/module/shared/components/boundary/hooks/lifecycles/use-boundary-measurement-request.js +64 -0
  87. package/lib/module/shared/components/boundary/hooks/lifecycles/use-boundary-measurement-request.js.map +1 -0
  88. package/lib/module/shared/components/boundary/hooks/lifecycles/use-boundary-presence.js +11 -10
  89. package/lib/module/shared/components/boundary/hooks/lifecycles/use-boundary-presence.js.map +1 -1
  90. package/lib/module/shared/components/boundary/hooks/use-boundary-measurement.js +3 -19
  91. package/lib/module/shared/components/boundary/hooks/use-boundary-measurement.js.map +1 -1
  92. package/lib/module/shared/components/boundary/hooks/use-measurer.js +6 -16
  93. package/lib/module/shared/components/boundary/hooks/use-measurer.js.map +1 -1
  94. package/lib/module/shared/components/boundary/portal/components/boundary-content-portal/helpers/active-handoff-receiver.js +24 -0
  95. package/lib/module/shared/components/boundary/portal/components/boundary-content-portal/helpers/active-handoff-receiver.js.map +1 -1
  96. package/lib/module/shared/components/boundary/portal/components/boundary-content-portal/hooks/use-boundary-content-portal-attachment.js +27 -9
  97. package/lib/module/shared/components/boundary/portal/components/boundary-content-portal/hooks/use-boundary-content-portal-attachment.js.map +1 -1
  98. package/lib/module/shared/components/boundary/portal/components/boundary-portal/components/portal-boundary-host.js +8 -1
  99. package/lib/module/shared/components/boundary/portal/components/boundary-portal/components/portal-boundary-host.js.map +1 -1
  100. package/lib/module/shared/components/boundary/portal/components/boundary-portal/helpers/attachment.js +14 -0
  101. package/lib/module/shared/components/boundary/portal/components/boundary-portal/helpers/attachment.js.map +1 -0
  102. package/lib/module/shared/components/boundary/portal/components/boundary-portal/helpers/host-readiness.js +13 -0
  103. package/lib/module/shared/components/boundary/portal/components/boundary-portal/helpers/host-readiness.js.map +1 -0
  104. package/lib/module/shared/components/boundary/portal/components/boundary-portal/helpers/local-measurement.js +19 -0
  105. package/lib/module/shared/components/boundary/portal/components/boundary-portal/helpers/local-measurement.js.map +1 -1
  106. package/lib/module/shared/components/boundary/portal/components/boundary-portal/hooks/use-active-portal-boundary-host.js +10 -10
  107. package/lib/module/shared/components/boundary/portal/components/boundary-portal/hooks/use-active-portal-boundary-host.js.map +1 -1
  108. package/lib/module/shared/components/boundary/portal/components/boundary-portal/hooks/use-boundary-portal-attachment.js +18 -6
  109. package/lib/module/shared/components/boundary/portal/components/boundary-portal/hooks/use-boundary-portal-attachment.js.map +1 -1
  110. package/lib/module/shared/providers/helpers/measured-bounds-writes.js +4 -0
  111. package/lib/module/shared/providers/helpers/measured-bounds-writes.js.map +1 -1
  112. package/lib/module/shared/providers/screen/animation/animation.provider.js +4 -1
  113. package/lib/module/shared/providers/screen/animation/animation.provider.js.map +1 -1
  114. package/lib/module/shared/providers/screen/animation/helpers/hydrate-transition-state/index.js +5 -1
  115. package/lib/module/shared/providers/screen/animation/helpers/hydrate-transition-state/index.js.map +1 -1
  116. package/lib/module/shared/providers/screen/animation/helpers/interpolator-participation.js +4 -0
  117. package/lib/module/shared/providers/screen/animation/helpers/interpolator-participation.js.map +1 -0
  118. package/lib/module/shared/providers/screen/animation/helpers/pipeline.js +13 -2
  119. package/lib/module/shared/providers/screen/animation/helpers/pipeline.js.map +1 -1
  120. package/lib/module/shared/providers/screen/descriptors/descriptors.provider.js +41 -9
  121. package/lib/module/shared/providers/screen/descriptors/descriptors.provider.js.map +1 -1
  122. package/lib/module/shared/providers/screen/descriptors/helpers/derive-descriptor-derivations.js +2 -0
  123. package/lib/module/shared/providers/screen/descriptors/helpers/derive-descriptor-derivations.js.map +1 -1
  124. package/lib/module/shared/providers/screen/descriptors/helpers/derive-structural-ancestor-keys.js +7 -0
  125. package/lib/module/shared/providers/screen/descriptors/helpers/derive-structural-ancestor-keys.js.map +1 -0
  126. package/lib/module/shared/providers/screen/gestures/pan/behavior/pan-lifecycle.js +1 -0
  127. package/lib/module/shared/providers/screen/gestures/pan/behavior/pan-lifecycle.js.map +1 -1
  128. package/lib/module/shared/providers/screen/gestures/pan/behavior/pan-release.js +9 -2
  129. package/lib/module/shared/providers/screen/gestures/pan/behavior/pan-release.js.map +1 -1
  130. package/lib/module/shared/providers/screen/gestures/pan/behavior/use-pan-behavior.js +1 -0
  131. package/lib/module/shared/providers/screen/gestures/pan/behavior/use-pan-behavior.js.map +1 -1
  132. package/lib/module/shared/providers/screen/styles/constants.js +2 -1
  133. package/lib/module/shared/providers/screen/styles/constants.js.map +1 -1
  134. package/lib/module/shared/providers/screen/styles/helpers/visibility-block-ownership.js +14 -0
  135. package/lib/module/shared/providers/screen/styles/helpers/visibility-block-ownership.js.map +1 -0
  136. package/lib/module/shared/providers/screen/styles/hooks/use-maybe-block-visibility.js +35 -15
  137. package/lib/module/shared/providers/screen/styles/hooks/use-maybe-block-visibility.js.map +1 -1
  138. package/lib/module/shared/providers/screen/styles/slot.provider.js +13 -5
  139. package/lib/module/shared/providers/screen/styles/slot.provider.js.map +1 -1
  140. package/lib/module/shared/stores/bounds/helpers/link-pairs.helpers.js +9 -0
  141. package/lib/module/shared/stores/bounds/helpers/link-pairs.helpers.js.map +1 -1
  142. package/lib/module/shared/stores/bounds/internals/clear.js +7 -1
  143. package/lib/module/shared/stores/bounds/internals/clear.js.map +1 -1
  144. package/lib/module/shared/stores/bounds/internals/coordinator.js +286 -0
  145. package/lib/module/shared/stores/bounds/internals/coordinator.js.map +1 -0
  146. package/lib/module/shared/stores/bounds/internals/entries.js +1 -27
  147. package/lib/module/shared/stores/bounds/internals/entries.js.map +1 -1
  148. package/lib/module/shared/stores/bounds/internals/links.js +24 -32
  149. package/lib/module/shared/stores/bounds/internals/links.js.map +1 -1
  150. package/lib/module/shared/stores/bounds/internals/screen-graph.js +39 -0
  151. package/lib/module/shared/stores/bounds/internals/screen-graph.js.map +1 -0
  152. package/lib/module/shared/stores/bounds/internals/state.js +3 -0
  153. package/lib/module/shared/stores/bounds/internals/state.js.map +1 -1
  154. package/lib/module/shared/utils/bounds/helpers/create-bounds-accessor-core.js +7 -3
  155. package/lib/module/shared/utils/bounds/helpers/create-bounds-accessor-core.js.map +1 -1
  156. package/lib/module/shared/utils/bounds/helpers/create-link-accessor.js +11 -0
  157. package/lib/module/shared/utils/bounds/helpers/create-link-accessor.js.map +1 -1
  158. package/lib/module/shared/utils/bounds/helpers/prepare-bound-styles.js +6 -2
  159. package/lib/module/shared/utils/bounds/helpers/prepare-bound-styles.js.map +1 -1
  160. package/lib/module/shared/utils/bounds/helpers/resolve-bounds-pair-key.js.map +1 -1
  161. package/lib/module/shared/utils/bounds/helpers/styles/compute.js +11 -5
  162. package/lib/module/shared/utils/bounds/helpers/styles/compute.js.map +1 -1
  163. package/lib/typescript/native-stack/views/useHeaderConfigProps.d.ts +1 -1
  164. package/lib/typescript/shared/components/boundary/components/boundary-lifecycle.d.ts.map +1 -1
  165. package/lib/typescript/shared/components/boundary/hooks/lifecycles/{use-initial-source-measurement.d.ts → use-boundary-measurement-request.d.ts} +4 -3
  166. package/lib/typescript/shared/components/boundary/hooks/lifecycles/use-boundary-measurement-request.d.ts.map +1 -0
  167. package/lib/typescript/shared/components/boundary/hooks/lifecycles/use-boundary-presence.d.ts.map +1 -1
  168. package/lib/typescript/shared/components/boundary/hooks/use-boundary-measurement.d.ts +1 -3
  169. package/lib/typescript/shared/components/boundary/hooks/use-boundary-measurement.d.ts.map +1 -1
  170. package/lib/typescript/shared/components/boundary/hooks/use-measurer.d.ts.map +1 -1
  171. package/lib/typescript/shared/components/boundary/portal/components/boundary-content-portal/helpers/active-handoff-receiver.d.ts +12 -0
  172. package/lib/typescript/shared/components/boundary/portal/components/boundary-content-portal/helpers/active-handoff-receiver.d.ts.map +1 -1
  173. package/lib/typescript/shared/components/boundary/portal/components/boundary-content-portal/hooks/use-boundary-content-portal-attachment.d.ts.map +1 -1
  174. package/lib/typescript/shared/components/boundary/portal/components/boundary-portal/components/portal-boundary-host.d.ts.map +1 -1
  175. package/lib/typescript/shared/components/boundary/portal/components/boundary-portal/helpers/attachment.d.ts +8 -0
  176. package/lib/typescript/shared/components/boundary/portal/components/boundary-portal/helpers/attachment.d.ts.map +1 -0
  177. package/lib/typescript/shared/components/boundary/portal/components/boundary-portal/helpers/host-readiness.d.ts +6 -0
  178. package/lib/typescript/shared/components/boundary/portal/components/boundary-portal/helpers/host-readiness.d.ts.map +1 -0
  179. package/lib/typescript/shared/components/boundary/portal/components/boundary-portal/helpers/local-measurement.d.ts +4 -1
  180. package/lib/typescript/shared/components/boundary/portal/components/boundary-portal/helpers/local-measurement.d.ts.map +1 -1
  181. package/lib/typescript/shared/components/boundary/portal/components/boundary-portal/hooks/use-active-portal-boundary-host.d.ts +2 -3
  182. package/lib/typescript/shared/components/boundary/portal/components/boundary-portal/hooks/use-active-portal-boundary-host.d.ts.map +1 -1
  183. package/lib/typescript/shared/components/boundary/portal/components/boundary-portal/hooks/use-boundary-portal-attachment.d.ts.map +1 -1
  184. package/lib/typescript/shared/components/boundary/portal/components/boundary-portal/hooks/use-placeholder-styles.d.ts +2 -2
  185. package/lib/typescript/shared/components/boundary/portal/components/boundary-portal/stores/portal-boundary-host.store.d.ts +1 -1
  186. package/lib/typescript/shared/components/boundary/portal/components/boundary-portal/stores/portal-boundary-host.store.d.ts.map +1 -1
  187. package/lib/typescript/shared/components/boundary/types.d.ts +1 -1
  188. package/lib/typescript/shared/components/boundary/types.d.ts.map +1 -1
  189. package/lib/typescript/shared/components/create-transition-aware-component.d.ts +5 -6
  190. package/lib/typescript/shared/components/create-transition-aware-component.d.ts.map +1 -1
  191. package/lib/typescript/shared/components/overlay/hooks/use-overlay-slot.d.ts +1 -1
  192. package/lib/typescript/shared/index.d.ts +651 -703
  193. package/lib/typescript/shared/index.d.ts.map +1 -1
  194. package/lib/typescript/shared/providers/helpers/measured-bounds-writes.d.ts.map +1 -1
  195. package/lib/typescript/shared/providers/screen/animation/animation.provider.d.ts.map +1 -1
  196. package/lib/typescript/shared/providers/screen/animation/helpers/hydrate-transition-state/index.d.ts.map +1 -1
  197. package/lib/typescript/shared/providers/screen/animation/helpers/interpolator-participation.d.ts +3 -0
  198. package/lib/typescript/shared/providers/screen/animation/helpers/interpolator-participation.d.ts.map +1 -0
  199. package/lib/typescript/shared/providers/screen/animation/helpers/pipeline.d.ts +2 -1
  200. package/lib/typescript/shared/providers/screen/animation/helpers/pipeline.d.ts.map +1 -1
  201. package/lib/typescript/shared/providers/screen/descriptors/descriptors.provider.d.ts.map +1 -1
  202. package/lib/typescript/shared/providers/screen/descriptors/helpers/derive-descriptor-derivations.d.ts +4 -0
  203. package/lib/typescript/shared/providers/screen/descriptors/helpers/derive-descriptor-derivations.d.ts.map +1 -1
  204. package/lib/typescript/shared/providers/screen/descriptors/helpers/derive-structural-ancestor-keys.d.ts +5 -0
  205. package/lib/typescript/shared/providers/screen/descriptors/helpers/derive-structural-ancestor-keys.d.ts.map +1 -0
  206. package/lib/typescript/shared/providers/screen/gestures/pan/behavior/pan-lifecycle.d.ts.map +1 -1
  207. package/lib/typescript/shared/providers/screen/gestures/pan/behavior/pan-release.d.ts.map +1 -1
  208. package/lib/typescript/shared/providers/screen/gestures/pan/behavior/use-pan-behavior.d.ts.map +1 -1
  209. package/lib/typescript/shared/providers/screen/gestures/types.d.ts +1 -0
  210. package/lib/typescript/shared/providers/screen/gestures/types.d.ts.map +1 -1
  211. package/lib/typescript/shared/providers/screen/styles/constants.d.ts.map +1 -1
  212. package/lib/typescript/shared/providers/screen/styles/helpers/visibility-block-ownership.d.ts +10 -0
  213. package/lib/typescript/shared/providers/screen/styles/helpers/visibility-block-ownership.d.ts.map +1 -0
  214. package/lib/typescript/shared/providers/screen/styles/hooks/slot-resolvers.d.ts +4 -4
  215. package/lib/typescript/shared/providers/screen/styles/hooks/slot-resolvers.d.ts.map +1 -1
  216. package/lib/typescript/shared/providers/screen/styles/hooks/use-maybe-block-visibility.d.ts +10 -4
  217. package/lib/typescript/shared/providers/screen/styles/hooks/use-maybe-block-visibility.d.ts.map +1 -1
  218. package/lib/typescript/shared/providers/screen/styles/slot.provider.d.ts +1 -0
  219. package/lib/typescript/shared/providers/screen/styles/slot.provider.d.ts.map +1 -1
  220. package/lib/typescript/shared/stores/bounds/helpers/link-pairs.helpers.d.ts +1 -0
  221. package/lib/typescript/shared/stores/bounds/helpers/link-pairs.helpers.d.ts.map +1 -1
  222. package/lib/typescript/shared/stores/bounds/internals/clear.d.ts.map +1 -1
  223. package/lib/typescript/shared/stores/bounds/internals/coordinator.d.ts +36 -0
  224. package/lib/typescript/shared/stores/bounds/internals/coordinator.d.ts.map +1 -0
  225. package/lib/typescript/shared/stores/bounds/internals/entries.d.ts +1 -2
  226. package/lib/typescript/shared/stores/bounds/internals/entries.d.ts.map +1 -1
  227. package/lib/typescript/shared/stores/bounds/internals/links.d.ts +1 -3
  228. package/lib/typescript/shared/stores/bounds/internals/links.d.ts.map +1 -1
  229. package/lib/typescript/shared/stores/bounds/internals/screen-graph.d.ts +5 -0
  230. package/lib/typescript/shared/stores/bounds/internals/screen-graph.d.ts.map +1 -0
  231. package/lib/typescript/shared/stores/bounds/internals/state.d.ts +3 -1
  232. package/lib/typescript/shared/stores/bounds/internals/state.d.ts.map +1 -1
  233. package/lib/typescript/shared/stores/bounds/types.d.ts +13 -1
  234. package/lib/typescript/shared/stores/bounds/types.d.ts.map +1 -1
  235. package/lib/typescript/shared/types/screen.types.d.ts +9 -0
  236. package/lib/typescript/shared/types/screen.types.d.ts.map +1 -1
  237. package/lib/typescript/shared/utils/bounds/helpers/create-bounds-accessor-core.d.ts.map +1 -1
  238. package/lib/typescript/shared/utils/bounds/helpers/create-link-accessor.d.ts.map +1 -1
  239. package/lib/typescript/shared/utils/bounds/helpers/prepare-bound-styles.d.ts.map +1 -1
  240. package/lib/typescript/shared/utils/bounds/helpers/resolve-bounds-pair-key.d.ts.map +1 -1
  241. package/lib/typescript/shared/utils/bounds/helpers/styles/compute.d.ts.map +1 -1
  242. package/package.json +1 -1
  243. package/src/shared/components/activity/variants/activity-screen.tsx +1 -1
  244. package/src/shared/components/boundary/components/boundary-lifecycle.tsx +0 -6
  245. package/src/shared/components/boundary/hooks/lifecycles/use-boundary-measurement-request.ts +102 -0
  246. package/src/shared/components/boundary/hooks/lifecycles/use-boundary-presence.ts +20 -11
  247. package/src/shared/components/boundary/hooks/use-boundary-measurement.ts +3 -22
  248. package/src/shared/components/boundary/hooks/use-measurer.ts +5 -20
  249. package/src/shared/components/boundary/portal/components/boundary-content-portal/helpers/active-handoff-receiver.ts +40 -0
  250. package/src/shared/components/boundary/portal/components/boundary-content-portal/hooks/use-boundary-content-portal-attachment.ts +68 -20
  251. package/src/shared/components/boundary/portal/components/boundary-portal/components/portal-boundary-host.tsx +10 -1
  252. package/src/shared/components/boundary/portal/components/boundary-portal/helpers/attachment.ts +19 -0
  253. package/src/shared/components/boundary/portal/components/boundary-portal/helpers/host-readiness.ts +14 -0
  254. package/src/shared/components/boundary/portal/components/boundary-portal/helpers/local-measurement.ts +36 -1
  255. package/src/shared/components/boundary/portal/components/boundary-portal/hooks/use-active-portal-boundary-host.ts +22 -13
  256. package/src/shared/components/boundary/portal/components/boundary-portal/hooks/use-boundary-portal-attachment.ts +26 -9
  257. package/src/shared/components/boundary/portal/components/boundary-portal/stores/portal-boundary-host.store.ts +1 -1
  258. package/src/shared/components/boundary/types.ts +1 -1
  259. package/src/shared/providers/helpers/measured-bounds-writes.ts +5 -0
  260. package/src/shared/providers/screen/animation/animation.provider.tsx +7 -1
  261. package/src/shared/providers/screen/animation/helpers/hydrate-transition-state/index.ts +18 -3
  262. package/src/shared/providers/screen/animation/helpers/interpolator-participation.ts +6 -0
  263. package/src/shared/providers/screen/animation/helpers/pipeline.ts +54 -32
  264. package/src/shared/providers/screen/descriptors/descriptors.provider.tsx +80 -14
  265. package/src/shared/providers/screen/descriptors/helpers/derive-descriptor-derivations.ts +6 -0
  266. package/src/shared/providers/screen/descriptors/helpers/derive-structural-ancestor-keys.ts +13 -0
  267. package/src/shared/providers/screen/gestures/pan/behavior/pan-lifecycle.ts +1 -0
  268. package/src/shared/providers/screen/gestures/pan/behavior/pan-release.ts +12 -2
  269. package/src/shared/providers/screen/gestures/pan/behavior/use-pan-behavior.ts +1 -0
  270. package/src/shared/providers/screen/gestures/types.ts +1 -0
  271. package/src/shared/providers/screen/styles/constants.ts +1 -0
  272. package/src/shared/providers/screen/styles/helpers/visibility-block-ownership.ts +16 -0
  273. package/src/shared/providers/screen/styles/hooks/use-maybe-block-visibility.tsx +40 -15
  274. package/src/shared/providers/screen/styles/slot.provider.tsx +19 -5
  275. package/src/shared/stores/bounds/helpers/link-pairs.helpers.ts +12 -0
  276. package/src/shared/stores/bounds/internals/clear.ts +12 -1
  277. package/src/shared/stores/bounds/internals/coordinator.ts +403 -0
  278. package/src/shared/stores/bounds/internals/entries.ts +1 -38
  279. package/src/shared/stores/bounds/internals/links.ts +28 -38
  280. package/src/shared/stores/bounds/internals/screen-graph.ts +45 -0
  281. package/src/shared/stores/bounds/internals/state.ts +10 -1
  282. package/src/shared/stores/bounds/types.ts +19 -1
  283. package/src/shared/types/screen.types.ts +10 -0
  284. package/src/shared/utils/bounds/helpers/create-bounds-accessor-core.ts +8 -3
  285. package/src/shared/utils/bounds/helpers/create-link-accessor.ts +11 -0
  286. package/src/shared/utils/bounds/helpers/prepare-bound-styles.ts +3 -2
  287. package/src/shared/utils/bounds/helpers/resolve-bounds-pair-key.ts +0 -1
  288. package/src/shared/utils/bounds/helpers/styles/compute.ts +12 -5
  289. package/lib/commonjs/shared/components/boundary/hooks/lifecycles/use-initial-destination-measurement.js +0 -177
  290. package/lib/commonjs/shared/components/boundary/hooks/lifecycles/use-initial-destination-measurement.js.map +0 -1
  291. package/lib/commonjs/shared/components/boundary/hooks/lifecycles/use-initial-source-measurement.js +0 -49
  292. package/lib/commonjs/shared/components/boundary/hooks/lifecycles/use-initial-source-measurement.js.map +0 -1
  293. package/lib/commonjs/shared/components/boundary/hooks/lifecycles/use-refresh-boundary.js +0 -69
  294. package/lib/commonjs/shared/components/boundary/hooks/lifecycles/use-refresh-boundary.js.map +0 -1
  295. package/lib/commonjs/shared/components/boundary/utils/destination-signals.js +0 -68
  296. package/lib/commonjs/shared/components/boundary/utils/destination-signals.js.map +0 -1
  297. package/lib/commonjs/shared/components/boundary/utils/refresh-signals.js +0 -97
  298. package/lib/commonjs/shared/components/boundary/utils/refresh-signals.js.map +0 -1
  299. package/lib/commonjs/shared/components/boundary/utils/source-signals.js +0 -43
  300. package/lib/commonjs/shared/components/boundary/utils/source-signals.js.map +0 -1
  301. package/lib/commonjs/shared/providers/screen/descriptors/helpers/get-ancestor-keys.js +0 -29
  302. package/lib/commonjs/shared/providers/screen/descriptors/helpers/get-ancestor-keys.js.map +0 -1
  303. package/lib/module/shared/components/boundary/hooks/lifecycles/use-initial-destination-measurement.js +0 -173
  304. package/lib/module/shared/components/boundary/hooks/lifecycles/use-initial-destination-measurement.js.map +0 -1
  305. package/lib/module/shared/components/boundary/hooks/lifecycles/use-initial-source-measurement.js +0 -44
  306. package/lib/module/shared/components/boundary/hooks/lifecycles/use-initial-source-measurement.js.map +0 -1
  307. package/lib/module/shared/components/boundary/hooks/lifecycles/use-refresh-boundary.js +0 -64
  308. package/lib/module/shared/components/boundary/hooks/lifecycles/use-refresh-boundary.js.map +0 -1
  309. package/lib/module/shared/components/boundary/utils/destination-signals.js +0 -63
  310. package/lib/module/shared/components/boundary/utils/destination-signals.js.map +0 -1
  311. package/lib/module/shared/components/boundary/utils/refresh-signals.js +0 -92
  312. package/lib/module/shared/components/boundary/utils/refresh-signals.js.map +0 -1
  313. package/lib/module/shared/components/boundary/utils/source-signals.js +0 -38
  314. package/lib/module/shared/components/boundary/utils/source-signals.js.map +0 -1
  315. package/lib/module/shared/providers/screen/descriptors/helpers/get-ancestor-keys.js +0 -25
  316. package/lib/module/shared/providers/screen/descriptors/helpers/get-ancestor-keys.js.map +0 -1
  317. package/lib/typescript/shared/components/boundary/hooks/lifecycles/use-initial-destination-measurement.d.ts +0 -10
  318. package/lib/typescript/shared/components/boundary/hooks/lifecycles/use-initial-destination-measurement.d.ts.map +0 -1
  319. package/lib/typescript/shared/components/boundary/hooks/lifecycles/use-initial-source-measurement.d.ts.map +0 -1
  320. package/lib/typescript/shared/components/boundary/hooks/lifecycles/use-refresh-boundary.d.ts +0 -10
  321. package/lib/typescript/shared/components/boundary/hooks/lifecycles/use-refresh-boundary.d.ts.map +0 -1
  322. package/lib/typescript/shared/components/boundary/utils/destination-signals.d.ts +0 -16
  323. package/lib/typescript/shared/components/boundary/utils/destination-signals.d.ts.map +0 -1
  324. package/lib/typescript/shared/components/boundary/utils/refresh-signals.d.ts +0 -19
  325. package/lib/typescript/shared/components/boundary/utils/refresh-signals.d.ts.map +0 -1
  326. package/lib/typescript/shared/components/boundary/utils/source-signals.d.ts +0 -14
  327. package/lib/typescript/shared/components/boundary/utils/source-signals.d.ts.map +0 -1
  328. package/lib/typescript/shared/providers/screen/descriptors/helpers/get-ancestor-keys.d.ts +0 -6
  329. package/lib/typescript/shared/providers/screen/descriptors/helpers/get-ancestor-keys.d.ts.map +0 -1
  330. package/src/shared/components/boundary/hooks/lifecycles/use-initial-destination-measurement.ts +0 -267
  331. package/src/shared/components/boundary/hooks/lifecycles/use-initial-source-measurement.ts +0 -51
  332. package/src/shared/components/boundary/hooks/lifecycles/use-refresh-boundary.ts +0 -90
  333. package/src/shared/components/boundary/utils/destination-signals.ts +0 -75
  334. package/src/shared/components/boundary/utils/refresh-signals.ts +0 -164
  335. package/src/shared/components/boundary/utils/source-signals.ts +0 -51
  336. package/src/shared/providers/screen/descriptors/helpers/get-ancestor-keys.ts +0 -28
@@ -0,0 +1,102 @@
1
+ import { useCallback, useEffect } from "react";
2
+ import {
3
+ cancelAnimation,
4
+ useAnimatedReaction,
5
+ useSharedValue,
6
+ withDelay,
7
+ withTiming,
8
+ } from "react-native-reanimated";
9
+ import {
10
+ abandonBoundaryMeasurement,
11
+ getBoundaryMeasurementRequest,
12
+ } from "../../../../stores/bounds/internals/coordinator";
13
+ import { pairs } from "../../../../stores/bounds/internals/state";
14
+ import type { BoundTag } from "../../../../stores/bounds/types";
15
+ import { logger } from "../../../../utils/logger";
16
+ import type { MeasureBoundary, MeasureTarget } from "../../types";
17
+
18
+ const RETRY_DELAY_MS = 16;
19
+ const MAX_RETRIES = 20;
20
+
21
+ export const useBoundaryMeasurementRequest = (params: {
22
+ enabled: boolean;
23
+ boundTag: BoundTag;
24
+ currentScreenKey: string;
25
+ measureBoundary: MeasureBoundary;
26
+ }) => {
27
+ const { enabled, boundTag, currentScreenKey, measureBoundary } = params;
28
+ const retryClock = useSharedValue(0);
29
+
30
+ const fulfillRequest = useCallback(
31
+ function retry(request: MeasureTarget, attempt: number) {
32
+ "worklet";
33
+ if (!enabled) return;
34
+
35
+ const pending = getBoundaryMeasurementRequest(
36
+ boundTag.tag,
37
+ currentScreenKey,
38
+ pairs.get(),
39
+ );
40
+ if (
41
+ pending?.type !== request.type ||
42
+ pending.pairKey !== request.pairKey
43
+ ) {
44
+ return;
45
+ }
46
+
47
+ if (measureBoundary(request)) return;
48
+
49
+ if (attempt >= MAX_RETRIES) {
50
+ abandonBoundaryMeasurement({ ...request, tag: boundTag.tag });
51
+ logger.warn(
52
+ `Boundary "${boundTag.tag}" on screen "${currentScreenKey}" could not complete its ${request.type} measurement after ${MAX_RETRIES} attempts; continuing without it.`,
53
+ );
54
+ return;
55
+ }
56
+
57
+ cancelAnimation(retryClock);
58
+ retryClock.set(
59
+ withDelay(
60
+ RETRY_DELAY_MS,
61
+ withTiming(retryClock.get() + 1, { duration: 0 }, (finished) => {
62
+ if (finished) retry(request, attempt + 1);
63
+ }),
64
+ ),
65
+ );
66
+ },
67
+ [boundTag.tag, currentScreenKey, enabled, measureBoundary, retryClock],
68
+ );
69
+
70
+ useEffect(() => {
71
+ return () => {
72
+ cancelAnimation(retryClock);
73
+ };
74
+ }, [retryClock]);
75
+
76
+ useAnimatedReaction(
77
+ () => {
78
+ "worklet";
79
+ if (!enabled) return null;
80
+ // Read the mutable in the reaction itself. Hiding this read behind an
81
+ // imported helper prevented the mapper from subscribing to pair changes,
82
+ // so requests were only observed after a React refresh/remount.
83
+ return getBoundaryMeasurementRequest(
84
+ boundTag.tag,
85
+ currentScreenKey,
86
+ pairs.get(),
87
+ );
88
+ },
89
+ (request, previousRequest) => {
90
+ "worklet";
91
+ if (
92
+ !request ||
93
+ (request.type === previousRequest?.type &&
94
+ request.pairKey === previousRequest.pairKey)
95
+ ) {
96
+ return;
97
+ }
98
+
99
+ fulfillRequest(request, 0);
100
+ },
101
+ );
102
+ };
@@ -1,9 +1,9 @@
1
1
  import { useLayoutEffect } from "react";
2
2
  import { runOnUI } from "react-native-reanimated";
3
3
  import {
4
- removeEntry,
5
- setEntry,
6
- } from "../../../../stores/bounds/internals/entries";
4
+ registerBoundary,
5
+ unregisterBoundary,
6
+ } from "../../../../stores/bounds/internals/coordinator";
7
7
  import type { BoundTag } from "../../../../stores/bounds/types";
8
8
  import type { BoundaryConfigProps } from "../../types";
9
9
 
@@ -23,19 +23,28 @@ export const useBoundaryPresence = (params: {
23
23
  handoff,
24
24
  escapeClipping,
25
25
  } = params;
26
- const { tag } = boundTag;
27
-
28
26
  useLayoutEffect(() => {
29
27
  if (!enabled) return;
30
28
 
31
- runOnUI(setEntry)(tag, currentScreenKey, {
32
- boundaryConfig,
33
- handoff: handoff ? true : null,
34
- escapeClipping: escapeClipping ? true : null,
29
+ runOnUI(registerBoundary)({
30
+ boundTag,
31
+ screenKey: currentScreenKey,
32
+ entry: {
33
+ boundaryConfig,
34
+ handoff: handoff ? true : null,
35
+ escapeClipping: escapeClipping ? true : null,
36
+ },
35
37
  });
36
38
 
37
39
  return () => {
38
- runOnUI(removeEntry)(tag, currentScreenKey);
40
+ runOnUI(unregisterBoundary)(boundTag, currentScreenKey);
39
41
  };
40
- }, [enabled, tag, currentScreenKey, boundaryConfig, handoff, escapeClipping]);
42
+ }, [
43
+ enabled,
44
+ boundTag,
45
+ currentScreenKey,
46
+ boundaryConfig,
47
+ handoff,
48
+ escapeClipping,
49
+ ]);
41
50
  };
@@ -7,18 +7,14 @@ import type {
7
7
  BoundaryConfigProps,
8
8
  BoundaryLocalMeasurementValue,
9
9
  } from "../types";
10
+ import { useBoundaryMeasurementRequest } from "./lifecycles/use-boundary-measurement-request";
10
11
  import { useBoundaryPresence } from "./lifecycles/use-boundary-presence";
11
- import { useInitialDestinationMeasurement } from "./lifecycles/use-initial-destination-measurement";
12
- import { useInitialSourceMeasurement } from "./lifecycles/use-initial-source-measurement";
13
- import { useRefreshBoundary } from "./lifecycles/use-refresh-boundary";
14
12
  import { useMeasurer } from "./use-measurer";
15
13
 
16
14
  interface UseBoundaryMeasurementParams {
17
15
  boundTag: BoundTag;
18
16
  /** Raw `enabled` prop — drives the measurer and the passive-source gate. */
19
17
  enabled: boolean;
20
- /** `enabled && hasConfiguredInterpolator` — gates presence + lifecycle. */
21
- runtimeEnabled: boolean;
22
18
  currentScreenKey: string;
23
19
  /** Surface to measure: a nested target's placeholder, else the root. */
24
20
  measuredRef: AnimatedRef<View>;
@@ -38,7 +34,6 @@ interface UseBoundaryMeasurementParams {
38
34
  export const useBoundaryMeasurement = ({
39
35
  boundTag,
40
36
  enabled,
41
- runtimeEnabled,
42
37
  currentScreenKey,
43
38
  measuredRef,
44
39
  style,
@@ -66,9 +61,6 @@ export const useBoundaryMeasurement = ({
66
61
  localMeasurement,
67
62
  });
68
63
 
69
- // Presence and source capture must not depend on this screen owning an
70
- // interpolator: a nested source can participate in a transition owned by a
71
- // different navigator.
72
64
  useBoundaryPresence({
73
65
  enabled,
74
66
  boundTag,
@@ -78,21 +70,10 @@ export const useBoundaryMeasurement = ({
78
70
  escapeClipping,
79
71
  });
80
72
 
81
- useInitialSourceMeasurement({
73
+ useBoundaryMeasurementRequest({
82
74
  enabled,
83
- measureBoundary,
84
- boundTag,
85
- });
86
-
87
- useInitialDestinationMeasurement({
88
- boundTag,
89
- enabled: runtimeEnabled,
90
- measureBoundary,
91
- });
92
-
93
- useRefreshBoundary({
94
- enabled: runtimeEnabled,
95
75
  boundTag,
76
+ currentScreenKey,
96
77
  measureBoundary,
97
78
  });
98
79
  };
@@ -6,7 +6,6 @@ import { applyMeasuredBoundsWrites } from "../../../providers/helpers/measured-b
6
6
  import { useScreenSlots } from "../../../providers/screen/styles";
7
7
  import type { BoundTag } from "../../../stores/bounds/types";
8
8
  import { ScrollStore } from "../../../stores/scroll.store";
9
- import { SystemStore } from "../../../stores/system.store";
10
9
  import { getVisibilityBlockOffset } from "../../../utils/visibility-block-offset";
11
10
  import type { BoundaryLocalMeasurementValue, MeasureBoundary } from "../types";
12
11
  import {
@@ -42,23 +41,19 @@ export const useMeasurer = ({
42
41
 
43
42
  const scrollState = ScrollStore.getValue(currentScreenKey, "coordination");
44
43
  const scrollMetadata = ScrollStore.getValue(currentScreenKey, "metadata");
45
- const pendingLifecycleStartBlockCount = SystemStore.getValue(
46
- currentScreenKey,
47
- "pendingLifecycleStartBlockCount",
48
- );
49
44
  const { visibilityBlocked } = useScreenSlots();
50
45
 
51
46
  return useCallback(
52
47
  (target) => {
53
48
  "worklet";
54
- if (!enabled) return;
49
+ if (!enabled) return false;
55
50
 
56
51
  const measured = measureWithOverscrollAwareness(
57
52
  measuredAnimatedRef,
58
53
  scrollState.get(),
59
54
  );
60
55
 
61
- if (!measured) return;
56
+ if (!measured) return false;
62
57
 
63
58
  const correctedMeasured = correctMeasuredBoundsForVisibilityGate({
64
59
  measured,
@@ -75,26 +70,15 @@ export const useMeasurer = ({
75
70
  });
76
71
  }
77
72
 
78
- /**
79
- * - Destination Pass -
80
- * Be strict while lifecycle start is blocked for destination capture.
81
- * This is the initial attach window: the transition has not started yet,
82
- * and malformed off-screen destination measurements should keep the
83
- * lifecycle blocked until a valid retry lands.
84
- */
85
- const shouldGuardDestinationViewport =
86
- pendingLifecycleStartBlockCount.get() > 0 || !!boundTag.group;
87
-
88
73
  const viewportAllowsDestinationWrite =
89
74
  target.type !== "destination" ||
90
- !shouldGuardDestinationViewport ||
91
75
  isMeasurementInViewport(
92
76
  correctedMeasured,
93
77
  viewportWidth,
94
78
  viewportHeight,
95
79
  );
96
80
 
97
- if (!viewportAllowsDestinationWrite) return;
81
+ if (!viewportAllowsDestinationWrite) return false;
98
82
 
99
83
  const measuredWithScroll = attachScrollSnapshotToMeasuredBounds(
100
84
  correctedMeasured,
@@ -112,6 +96,8 @@ export const useMeasurer = ({
112
96
  handoff,
113
97
  escapeClipping,
114
98
  });
99
+
100
+ return true;
115
101
  },
116
102
  [
117
103
  enabled,
@@ -126,7 +112,6 @@ export const useMeasurer = ({
126
112
  viewportHeight,
127
113
  scrollState,
128
114
  scrollMetadata,
129
- pendingLifecycleStartBlockCount,
130
115
  visibilityBlocked,
131
116
  ],
132
117
  );
@@ -13,6 +13,23 @@ type ResolveActiveHandoffReceiverParams = {
13
13
  scenes: ReceiverScene[];
14
14
  };
15
15
 
16
+ export const hasNestedHandoffTopology = ({
17
+ inheritedSourcePair,
18
+ pairDestinationScreenKey,
19
+ transitionDestinationScreenKey,
20
+ }: {
21
+ inheritedSourcePair: boolean;
22
+ pairDestinationScreenKey: string | null;
23
+ transitionDestinationScreenKey?: string;
24
+ }) => {
25
+ "worklet";
26
+ return (
27
+ inheritedSourcePair ||
28
+ (!!pairDestinationScreenKey &&
29
+ pairDestinationScreenKey !== transitionDestinationScreenKey)
30
+ );
31
+ };
32
+
16
33
  export const resolveActiveHandoffReceiver = ({
17
34
  focusedIndex,
18
35
  routes,
@@ -101,3 +118,26 @@ export const resolveHandoffAttachmentCandidate = ({
101
118
 
102
119
  return activeReceiverScreenKey;
103
120
  };
121
+
122
+ export const resolveNestedHandoffAttachmentCandidate = ({
123
+ attachedReceiverScreenKey,
124
+ currentScreenKey,
125
+ hasActiveCloseFinished,
126
+ interpolatorReady,
127
+ pairDestinationScreenKey,
128
+ }: {
129
+ attachedReceiverScreenKey: string;
130
+ currentScreenKey: string;
131
+ hasActiveCloseFinished: boolean;
132
+ interpolatorReady: boolean;
133
+ pairDestinationScreenKey: string | null;
134
+ }) => {
135
+ "worklet";
136
+
137
+ if (hasActiveCloseFinished) return currentScreenKey;
138
+ if (interpolatorReady && pairDestinationScreenKey) {
139
+ return pairDestinationScreenKey;
140
+ }
141
+
142
+ return attachedReceiverScreenKey;
143
+ };
@@ -11,8 +11,10 @@ import { SystemStore } from "../../../../../../stores/system.store";
11
11
  import { PORTAL_HOST_NAME_RESET_VALUE } from "../../../utils/naming";
12
12
  import { isTeleportEnabled } from "../../../utils/teleport-control";
13
13
  import {
14
+ hasNestedHandoffTopology,
14
15
  resolveActiveHandoffReceiver,
15
16
  resolveHandoffAttachmentCandidate,
17
+ resolveNestedHandoffAttachmentCandidate,
16
18
  resolvePreviousHandoffReceiver,
17
19
  } from "../helpers/active-handoff-receiver";
18
20
  import { createBoundaryContentPortalHostName } from "../helpers/host-name";
@@ -31,7 +33,19 @@ export const useBoundaryContentPortalAttachment = ({
31
33
  );
32
34
  const nextScreenKey = useDescriptorsStore((s) => s.derivations.nextScreenKey);
33
35
  const sourcePairKey = useDescriptorsStore((s) => s.derivations.sourcePairKey);
34
- const destinationSlots = useScreenSlots(nextScreenKey ?? currentScreenKey);
36
+ const transitionSourcePairKey = useDescriptorsStore(
37
+ (s) => s.derivations.transitionSourcePairKey,
38
+ );
39
+ const transitionDestinationScreenKey = useDescriptorsStore(
40
+ (s) => s.derivations.transitionDestinationScreenKey,
41
+ );
42
+ const isNestedSource = !sourcePairKey && !!transitionSourcePairKey;
43
+ const resolvedSourcePairKey = sourcePairKey ?? transitionSourcePairKey;
44
+ const resolvedDestinationScreenKey =
45
+ nextScreenKey ?? transitionDestinationScreenKey;
46
+ const destinationSlots = useScreenSlots(
47
+ resolvedDestinationScreenKey ?? currentScreenKey,
48
+ );
35
49
  const unavailableInterpolatorReady = useSharedValue(0);
36
50
  const interpolatorReady =
37
51
  destinationSlots?.interpolatorReady ?? unavailableInterpolatorReady;
@@ -48,6 +62,18 @@ export const useBoundaryContentPortalAttachment = ({
48
62
  activeReceiverScreenKey ?? currentScreenKey,
49
63
  "closing",
50
64
  );
65
+ const nestedDestinationAnimationProgress = SystemStore.getValue(
66
+ isNestedSource && resolvedDestinationScreenKey
67
+ ? resolvedDestinationScreenKey
68
+ : currentScreenKey,
69
+ "animationProgress",
70
+ );
71
+ const nestedDestinationClosing = AnimationStore.getValue(
72
+ isNestedSource && resolvedDestinationScreenKey
73
+ ? resolvedDestinationScreenKey
74
+ : currentScreenKey,
75
+ "closing",
76
+ );
51
77
 
52
78
  const attachedReceiverScreenKey = useSharedValue(currentScreenKey);
53
79
  const sourcePairBeforeClose = useSharedValue<string | null>(null);
@@ -63,24 +89,30 @@ export const useBoundaryContentPortalAttachment = ({
63
89
  } = slot?.props ?? {};
64
90
 
65
91
  const shouldTeleport = isTeleportEnabled(teleport);
66
- const closing = activeReceiverClosing.get();
67
- const animationProgress = activeReceiverAnimationProgress.get();
92
+ const closing = isNestedSource
93
+ ? nestedDestinationClosing.get()
94
+ : activeReceiverClosing.get();
95
+ const animationProgress = isNestedSource
96
+ ? nestedDestinationAnimationProgress.get()
97
+ : activeReceiverAnimationProgress.get();
68
98
 
69
99
  if (!closing) {
70
- sourcePairBeforeClose.set(sourcePairKey ?? null);
100
+ sourcePairBeforeClose.set(resolvedSourcePairKey ?? null);
71
101
  }
72
102
 
73
103
  const pairChangedDuringClose =
74
104
  !!closing &&
75
- !!sourcePairKey &&
76
- sourcePairKey !== sourcePairBeforeClose.get();
105
+ !!resolvedSourcePairKey &&
106
+ resolvedSourcePairKey !== sourcePairBeforeClose.get();
77
107
 
78
108
  const hasActiveCloseFinished = hasCloseTransitionFinished({
79
109
  closing,
80
110
  animationProgress,
81
111
  });
82
112
 
83
- const pair = sourcePairKey ? pairs.get()[sourcePairKey] : null;
113
+ const pair = resolvedSourcePairKey
114
+ ? pairs.get()[resolvedSourcePairKey]
115
+ : null;
84
116
  const link = pair?.links[getLinkKeyFromTag(boundaryId)];
85
117
 
86
118
  const pairDestination =
@@ -92,18 +124,31 @@ export const useBoundaryContentPortalAttachment = ({
92
124
 
93
125
  const isInterpolatorReady = interpolatorReady.get();
94
126
  const attachedScreenKey = attachedReceiverScreenKey.get();
95
-
96
- const nextReceiverScreenKey = resolveHandoffAttachmentCandidate({
97
- activeReceiverClosing: !!closing,
98
- activeReceiverScreenKey,
99
- attachedReceiverScreenKey: attachedScreenKey,
100
- hasActiveCloseFinished,
101
- interpolatorReady: !!isInterpolatorReady,
102
- pairChangedDuringClose,
127
+ const usesNestedReceiver = hasNestedHandoffTopology({
128
+ inheritedSourcePair: isNestedSource,
103
129
  pairDestinationScreenKey: pairDestination,
104
- previousReceiverScreenKey,
130
+ transitionDestinationScreenKey: resolvedDestinationScreenKey,
105
131
  });
106
132
 
133
+ const nextReceiverScreenKey = usesNestedReceiver
134
+ ? resolveNestedHandoffAttachmentCandidate({
135
+ attachedReceiverScreenKey: attachedScreenKey,
136
+ currentScreenKey,
137
+ hasActiveCloseFinished,
138
+ interpolatorReady: !!isInterpolatorReady,
139
+ pairDestinationScreenKey: pairDestination,
140
+ })
141
+ : resolveHandoffAttachmentCandidate({
142
+ activeReceiverClosing: !!closing,
143
+ activeReceiverScreenKey,
144
+ attachedReceiverScreenKey: attachedScreenKey,
145
+ hasActiveCloseFinished,
146
+ interpolatorReady: !!isInterpolatorReady,
147
+ pairChangedDuringClose,
148
+ pairDestinationScreenKey: pairDestination,
149
+ previousReceiverScreenKey,
150
+ });
151
+
107
152
  const receiverEntry = nextReceiverScreenKey
108
153
  ? getEntry(boundaryId, nextReceiverScreenKey)
109
154
  : null;
@@ -118,10 +163,13 @@ export const useBoundaryContentPortalAttachment = ({
118
163
  !!isInterpolatorReady &&
119
164
  nextReceiverScreenKey === pairDestination;
120
165
 
121
- const canActivateReceiver =
122
- returningFromActiveClose ||
123
- activatingPairDestination ||
124
- animationProgress > 0;
166
+ const canActivateReceiver = usesNestedReceiver
167
+ ? nextReceiverScreenKey === attachedScreenKey ||
168
+ hasActiveCloseFinished ||
169
+ activatingPairDestination
170
+ : returningFromActiveClose ||
171
+ activatingPairDestination ||
172
+ animationProgress > 0;
125
173
 
126
174
  if (nextReceiverScreenKey && receiverReady && canActivateReceiver) {
127
175
  attachedReceiverScreenKey.set(nextReceiverScreenKey);
@@ -13,7 +13,9 @@ import Animated, {
13
13
  } from "react-native-reanimated";
14
14
  import { NO_STYLES } from "../../../../../../constants";
15
15
  import { composeSlotStyleWithLocalTransform } from "../../../../../../providers/screen/styles/helpers/compose-slot-style";
16
+ import { markBoundaryPortalReady } from "../../../../../../stores/bounds/internals/coordinator";
16
17
  import { NativePortalHost, PORTAL_POINTER_EVENTS } from "../../../teleport";
18
+ import { resolveReadyPortalHostName } from "../helpers/host-readiness";
17
19
  import { resolveBoundaryLocalMeasurement } from "../helpers/local-measurement";
18
20
  import { resolvePortalOffsetStyle } from "../helpers/offset-style";
19
21
  import type { ActivePortalBoundaryHost } from "../stores/portal-boundary-host.store";
@@ -57,8 +59,15 @@ export const PortalBoundaryHost = memo(function PortalBoundaryHost({
57
59
  },
58
60
  (ready) => {
59
61
  "worklet";
62
+ host.portalHostReady.set(
63
+ resolveReadyPortalHostName({
64
+ currentReadyHostName: host.portalHostReady.get(),
65
+ hostName: host.portalHostName,
66
+ ready,
67
+ }),
68
+ );
60
69
  if (ready) {
61
- host.portalHostReady.set(true);
70
+ markBoundaryPortalReady(host.pairKey, host.boundaryId);
62
71
  }
63
72
  },
64
73
  );
@@ -0,0 +1,19 @@
1
+ import type { BoundaryTeleportControl } from "../../../../../../types/animation.types";
2
+ import { isTeleportEnabled } from "../../../utils/teleport-control";
3
+
4
+ export const shouldAttachBoundaryPortal = ({
5
+ focused,
6
+ portalHostReady,
7
+ slotActive,
8
+ teleport,
9
+ }: {
10
+ focused: boolean;
11
+ portalHostReady: boolean;
12
+ slotActive: boolean;
13
+ teleport?: BoundaryTeleportControl;
14
+ }) => {
15
+ "worklet";
16
+ return (
17
+ slotActive && !focused && portalHostReady && isTeleportEnabled(teleport)
18
+ );
19
+ };
@@ -0,0 +1,14 @@
1
+ export const resolveReadyPortalHostName = ({
2
+ currentReadyHostName,
3
+ hostName,
4
+ ready,
5
+ }: {
6
+ currentReadyHostName: string | null;
7
+ hostName: string;
8
+ ready: boolean;
9
+ }) => {
10
+ "worklet";
11
+
12
+ if (ready) return hostName;
13
+ return currentReadyHostName === hostName ? null : currentReadyHostName;
14
+ };
@@ -1,5 +1,40 @@
1
- import type { ScreenPairKey } from "../../../../../../stores/bounds/types";
1
+ import {
2
+ getGroupKeyFromTag,
3
+ getLinkKeyFromTag,
4
+ } from "../../../../../../stores/bounds/helpers/link-pairs.helpers";
5
+ import type {
6
+ LinkPairsState,
7
+ ScreenPairKey,
8
+ } from "../../../../../../stores/bounds/types";
9
+ import type { NormalizedTransitionSlotStyle } from "../../../../../../types/animation.types";
2
10
  import type { BoundaryLocalMeasurement } from "../../../../types";
11
+ import { isTeleportEnabled } from "../../../utils/teleport-control";
12
+
13
+ export const resolveBoundaryPortalPairKey = (
14
+ measurement: BoundaryLocalMeasurement | null,
15
+ ): ScreenPairKey | null => {
16
+ "worklet";
17
+ return measurement?.pairKey ?? null;
18
+ };
19
+
20
+ export const resolveActiveBoundaryPortalPairKey = (
21
+ measurement: BoundaryLocalMeasurement | null,
22
+ slot: NormalizedTransitionSlotStyle | undefined,
23
+ boundaryId: string,
24
+ pairsState: LinkPairsState,
25
+ ): ScreenPairKey | null => {
26
+ "worklet";
27
+ if (!measurement) return null;
28
+
29
+ const group = getGroupKeyFromTag(boundaryId);
30
+ if (group) {
31
+ const activeId = pairsState[measurement.pairKey]?.groups[group]?.activeId;
32
+ if (activeId !== getLinkKeyFromTag(boundaryId)) return null;
33
+ }
34
+
35
+ if (slot && !isTeleportEnabled(slot.props?.teleport)) return null;
36
+ return measurement.pairKey;
37
+ };
3
38
 
4
39
  export const resolveBoundaryLocalMeasurement = (
5
40
  measurement: BoundaryLocalMeasurement | null,
@@ -4,11 +4,13 @@ import {
4
4
  type SharedValue,
5
5
  useAnimatedReaction,
6
6
  } from "react-native-reanimated";
7
- import { getPairKeyForSource } from "../../../../../../stores/bounds/internals/links";
7
+ import { pairs } from "../../../../../../stores/bounds/internals/state";
8
8
  import type { ScreenPairKey } from "../../../../../../stores/bounds/types";
9
9
  import type { NormalizedTransitionInterpolatedStyle } from "../../../../../../types/animation.types";
10
10
  import type { BoundaryLocalMeasurementValue } from "../../../../types";
11
11
  import { createBoundaryPortalHostName } from "../../../utils/naming";
12
+ import { isTeleportEnabled } from "../../../utils/teleport-control";
13
+ import { resolveActiveBoundaryPortalPairKey } from "../helpers/local-measurement";
12
14
  import {
13
15
  mountPortalBoundaryHost,
14
16
  unmountPortalBoundaryHostByName,
@@ -16,17 +18,15 @@ import {
16
18
 
17
19
  type UseActivePortalBoundaryHostParams = {
18
20
  boundaryId: string;
19
- currentScreenKey: string;
20
21
  escapeHostKey?: string;
21
22
  localMeasurement: BoundaryLocalMeasurementValue;
22
23
  portalHostName: SharedValue<string | null>;
23
- portalHostReady: SharedValue<boolean>;
24
+ portalHostReady: SharedValue<string | null>;
24
25
  slotsMap: SharedValue<NormalizedTransitionInterpolatedStyle>;
25
26
  };
26
27
 
27
28
  export const useActivePortalBoundaryHost = ({
28
29
  boundaryId,
29
- currentScreenKey,
30
30
  escapeHostKey,
31
31
  localMeasurement,
32
32
  portalHostName,
@@ -44,13 +44,12 @@ export const useActivePortalBoundaryHost = ({
44
44
  useAnimatedReaction(
45
45
  () => {
46
46
  "worklet";
47
- const pairKey = getPairKeyForSource(boundaryId, currentScreenKey);
48
- const measurement = localMeasurement.get();
49
- if (!pairKey || measurement?.pairKey !== pairKey) {
50
- return null;
51
- }
52
-
53
- return pairKey;
47
+ return resolveActiveBoundaryPortalPairKey(
48
+ localMeasurement.get(),
49
+ slotsMap.get()[boundaryId],
50
+ boundaryId,
51
+ pairs.get(),
52
+ );
54
53
  },
55
54
  (pairKey, previousPairKey) => {
56
55
  "worklet";
@@ -58,6 +57,16 @@ export const useActivePortalBoundaryHost = ({
58
57
  return;
59
58
  }
60
59
 
60
+ const slot = slotsMap.get()[boundaryId];
61
+ if (
62
+ pairKey === null &&
63
+ localMeasurement.get() !== null &&
64
+ slot &&
65
+ !isTeleportEnabled(slot.props?.teleport)
66
+ ) {
67
+ localMeasurement.set(null);
68
+ }
69
+
61
70
  runOnJS(updateActivePairKey)(pairKey);
62
71
  },
63
72
  );
@@ -65,7 +74,7 @@ export const useActivePortalBoundaryHost = ({
65
74
  useLayoutEffect(() => {
66
75
  if (!activePairKey || !escapeHostKey) {
67
76
  portalHostName.set(null);
68
- portalHostReady.set(false);
77
+ portalHostReady.set(null);
69
78
  return;
70
79
  }
71
80
 
@@ -88,7 +97,7 @@ export const useActivePortalBoundaryHost = ({
88
97
 
89
98
  return () => {
90
99
  portalHostName.set(null);
91
- portalHostReady.set(false);
100
+ portalHostReady.set(null);
92
101
  unmountPortalBoundaryHostByName(nextPortalHostName);
93
102
  };
94
103
  }, [