@userflow-tech/react-native 0.1.0

package/lib/module/anchors/fiber/findAnchorFiber.js

@@ -0,0 +1,210 @@
+"use strict";
+
+import { MAX_ANCESTOR_WALK, getChild, getMemoizedProps, getReturn, getSibling, isHostFiber } from "./fiberInternals.js";
+import { coveredScreenBranches, isScreenContainerFiber } from "./visibleScreens.js";
+
+/**
+ * Soft cap so a dense screen cannot stall the JS thread. One modest Expo Router
+ * screen measures ~2,700 fibers, and a navigation stack keeps earlier screens
+ * mounted, so this has to allow for several screens at once.
+ */
+const MAX_NODES = 60_000;
+
+/** One production warning per process — truncation must not look like "missing". */
+let maxNodesWarned = false;
+const TIER_ORDER = ['testID', 'nativeID', 'accessibilityLabel'];
+/**
+ * Bounded DFS under `rootFiber` looking for fibers whose memoizedProps match
+ * `id` on testID, then nativeID, then accessibilityLabel. Uses the highest
+ * tier that has any match so a testID hit is never made ambiguous by an
+ * unrelated accessibilityLabel.
+ *
+ * Composite matches descend to the shallowest host descendant. Multiple
+ * matches on a single root-to-leaf chain (e.g. Pressable forwarding testID to
+ * its inner View) collapse to the outermost host. Disjoint matches fail closed
+ * as ambiguous.
+ *
+ * The walk never follows `rootFiber.sibling` so the Userflow overlay (a sibling
+ * of {@link FiberScanRoot} in UserflowProvider) cannot self-match SDK testIDs.
+ */
+export function findAnchorFiber(rootFiber, id) {
+  if (!rootFiber || !id) return {
+    status: 'missing'
+  };
+  try {
+    const byTier = {
+      testID: [],
+      nativeID: [],
+      accessibilityLabel: []
+    };
+    const stack = [rootFiber];
+    // Branches belonging to screens the user cannot see. Their siblings are
+    // still walked, so only the covered subtree is skipped.
+    const covered = new Set();
+    let visited = 0;
+    while (stack.length > 0 && visited < MAX_NODES) {
+      const fiber = stack.pop();
+      if (!fiber) continue;
+      visited += 1;
+      if (covered.has(fiber)) {
+        // Keep following the chain, but do not match or descend here.
+        if (fiber !== rootFiber) {
+          const sibling = getSibling(fiber);
+          if (sibling) stack.push(sibling);
+        }
+        continue;
+      }
+      const props = getMemoizedProps(fiber);
+      if (props) {
+        if (typeof props.testID === 'string' && props.testID === id) {
+          byTier.testID.push(fiber);
+        }
+        if (typeof props.nativeID === 'string' && props.nativeID === id) {
+          byTier.nativeID.push(fiber);
+        }
+        if (typeof props.accessibilityLabel === 'string' && props.accessibilityLabel === id) {
+          byTier.accessibilityLabel.push(fiber);
+        }
+      }
+
+      // Descend into children. Do NOT follow the seed root's sibling — in
+      // UserflowProvider the overlay (with SDK testIDs) is a sibling of
+      // FiberScanRoot and must stay outside the scan.
+      if (fiber !== rootFiber) {
+        const sibling = getSibling(fiber);
+        if (sibling) stack.push(sibling);
+      }
+      if (isScreenContainerFiber(fiber)) {
+        for (const branch of coveredScreenBranches(fiber)) {
+          covered.add(branch);
+        }
+      }
+      const child = getChild(fiber);
+      if (child) stack.push(child);
+    }
+    if (visited >= MAX_NODES) {
+      // Truncation would otherwise look exactly like "the anchor isn't there".
+      // eslint-disable-next-line no-console -- actionable: the anchor may exist but was not reached
+      const warn = message => console.warn(message);
+      if (__DEV__) {
+        warn(`[Userflow] Anchor scan for "${id}" stopped after ${MAX_NODES} nodes. ` + `The element may exist but was not reached. Register it explicitly with ` + `useUserflowAnchor("${id}") to skip the scan.`);
+      } else if (!maxNodesWarned) {
+        maxNodesWarned = true;
+        warn(`[Userflow] Anchor scan stopped after ${MAX_NODES} nodes; some anchors may ` + `be missed. Prefer useUserflowAnchor for deep or dense trees.`);
+      }
+    }
+    for (const tier of TIER_ORDER) {
+      const matches = byTier[tier];
+      if (matches.length === 0) continue;
+      const hosts = uniqueHosts(matches);
+      if (hosts.length === 0) continue;
+      if (hosts.length === 1) {
+        return {
+          status: 'found',
+          fiber: hosts[0],
+          tier
+        };
+      }
+      const collapsed = collapseToChains(hosts);
+      if (collapsed.length === 1) {
+        return {
+          status: 'found',
+          fiber: collapsed[0],
+          tier
+        };
+      }
+      return {
+        status: 'ambiguous',
+        tier
+      };
+    }
+    return {
+      status: 'missing'
+    };
+  } catch {
+    return {
+      status: 'missing'
+    };
+  }
+}
+
+/**
+ * For each matched fiber, resolve the shallowest host descendant (or itself
+ * when already a host). Deduplicate by identity / alternate.
+ */
+function uniqueHosts(matches) {
+  const seen = new Set();
+  const out = [];
+  for (const match of matches) {
+    const host = nearestHostDescendant(match) ?? (isHostFiber(match) ? match : null);
+    if (!host) continue;
+    const identity = host.alternate ?? host;
+    if (seen.has(host) || seen.has(identity)) continue;
+    seen.add(host);
+    seen.add(identity);
+    if (host.alternate) seen.add(host.alternate);
+    out.push(host);
+  }
+  return out;
+}
+
+/**
+ * BFS under `fiber` for the shallowest host descendant. Returns `fiber` itself
+ * when it is already a host.
+ */
+export function nearestHostDescendant(fiber, maxNodes = 2_000) {
+  if (!fiber) return null;
+  if (isHostFiber(fiber)) return fiber;
+  const queue = [fiber];
+  let visited = 0;
+  while (queue.length > 0 && visited < maxNodes) {
+    const f = queue.shift();
+    if (!f) continue;
+    visited += 1;
+    if (f !== fiber && isHostFiber(f)) return f;
+    let child = getChild(f);
+    while (child) {
+      queue.push(child);
+      child = getSibling(child);
+    }
+  }
+  return null;
+}
+
+/**
+ * Collapse hosts that all lie on one ancestor chain into the outermost
+ * (closest to the root). Disjoint subtrees remain as separate entries.
+ */
+function collapseToChains(hosts) {
+  if (hosts.length <= 1) return hosts;
+
+  // Prefer the outermost host when A is an ancestor of B.
+  const survivors = [];
+  for (const candidate of hosts) {
+    let dominated = false;
+    for (let i = survivors.length - 1; i >= 0; i -= 1) {
+      const other = survivors[i];
+      if (isAncestorOf(other, candidate)) {
+        // other is outer — drop candidate
+        dominated = true;
+        break;
+      }
+      if (isAncestorOf(candidate, other)) {
+        // candidate is outer — replace other
+        survivors.splice(i, 1);
+      }
+    }
+    if (!dominated) survivors.push(candidate);
+  }
+  return survivors;
+}
+function isAncestorOf(ancestor, descendant) {
+  let cur = descendant;
+  for (let depth = 0; cur && depth < MAX_ANCESTOR_WALK; depth += 1) {
+    if (cur === ancestor) return true;
+    if (ancestor.alternate && cur === ancestor.alternate) return true;
+    cur = getReturn(cur);
+  }
+  return false;
+}
+//# sourceMappingURL=findAnchorFiber.js.map

package/lib/module/anchors/fiber/findAnchorFiber.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MAX_ANCESTOR_WALK","getChild","getMemoizedProps","getReturn","getSibling","isHostFiber","coveredScreenBranches","isScreenContainerFiber","MAX_NODES","maxNodesWarned","TIER_ORDER","findAnchorFiber","rootFiber","id","status","byTier","testID","nativeID","accessibilityLabel","stack","covered","Set","visited","length","fiber","pop","has","sibling","push","props","branch","add","child","warn","message","console","__DEV__","tier","matches","hosts","uniqueHosts","collapsed","collapseToChains","seen","out","match","host","nearestHostDescendant","identity","alternate","maxNodes","queue","f","shift","survivors","candidate","dominated","i","other","isAncestorOf","splice","ancestor","descendant","cur","depth"],"sourceRoot":"../../../../src","sources":["anchors/fiber/findAnchorFiber.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/anchors/fiber/findScrollAncestors.js

@@ -0,0 +1,172 @@
+"use strict";
+
+/**
+ * Walk the fiber `return` chain from an anchor host upward and collect
+ * scrollable ancestors (innermost first). Used to scroll tooltip targets into
+ * view without requiring the host app to register ScrollViews.
+ *
+ * Detection is duck-typed on `stateNode` (ScrollView → `scrollTo`,
+ * FlatList/VirtualizedList → `scrollToOffset`, SectionList → `scrollToLocation`)
+ * so an RN rename degrades to "no scroll ancestor" rather than crashing.
+ */
+
+import { MAX_ANCESTOR_WALK, getChild, getHostTypeName, getMemoizedProps, getReturn, getSibling, getStateNode, isHostFiber } from "./fiberInternals.js";
+import { nearestHostDescendant } from "./findAnchorFiber.js";
+const SCROLL_METHODS = ['scrollTo', 'scrollToOffset', 'scrollToLocation'];
+
+/** Native host types that own the scroll viewport. */
+const SCROLL_HOST_TYPES = new Set(['RCTScrollView', 'AndroidHorizontalScrollView']);
+
+/** Native host type for the scroll content (moves with contentOffset). */
+const SCROLL_CONTENT_TYPES = new Set(['RCTScrollContentView', 'AndroidHorizontalScrollContentView']);
+/**
+ * Collect scrollable ancestors of `fiber`, innermost first.
+ * Never throws — missing / renamed internals simply yield an empty list.
+ */
+export function findScrollAncestors(fiber) {
+  const out = [];
+  if (!fiber) return out;
+  try {
+    let current = fiber;
+    for (let depth = 0; current && depth < MAX_ANCESTOR_WALK; depth += 1) {
+      const instance = asScrollableInstance(getStateNode(current));
+      if (instance) {
+        const {
+          containerFiber,
+          contentFiber
+        } = resolveScrollGeometry(current, instance);
+        out.push({
+          instance,
+          containerFiber,
+          contentFiber,
+          horizontal: isHorizontal(instance, current)
+        });
+      }
+      current = getReturn(current);
+    }
+  } catch {
+    // Feature-detection must itself never throw.
+  }
+  return out;
+}
+function asScrollableInstance(node) {
+  if (!node || typeof node !== 'object') return null;
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  const n = node;
+  for (const method of SCROLL_METHODS) {
+    if (typeof n[method] === 'function') {
+      return n;
+    }
+  }
+  // FlatList/SectionList often expose the list via `_listRef`.
+  if (n._listRef && typeof n._listRef === 'object') {
+    return asScrollableInstance(n._listRef);
+  }
+  return null;
+}
+function isHorizontal(instance, fiber) {
+  try {
+    if (instance.props && typeof instance.props.horizontal === 'boolean') {
+      return instance.props.horizontal;
+    }
+    const props = getMemoizedProps(fiber);
+    if (props && typeof props.horizontal === 'boolean') {
+      return props.horizontal;
+    }
+  } catch {
+    // Best-effort.
+  }
+  return false;
+}
+
+/**
+ * Resolve the viewport host + content host for offset-from-measure.
+ *
+ * Prefers imperative refs on the ScrollView instance when present; otherwise
+ * walks descendants looking for RCTScrollView / RCTScrollContentView.
+ */
+function resolveScrollGeometry(scrollFiber, instance) {
+  // Prefer live refs when the instance is a ScrollView (bind `this`).
+  const nativeRef = safeCall(instance, instance.getNativeScrollRef);
+  const innerRef = safeCall(instance, instance.getInnerViewRef);
+  let containerFiber = fiberFromMaybeInstance(nativeRef) ?? findDescendantByHostType(scrollFiber, SCROLL_HOST_TYPES);
+  let contentFiber = fiberFromMaybeInstance(innerRef) ?? (containerFiber ? findDescendantByHostType(containerFiber, SCROLL_CONTENT_TYPES) : findDescendantByHostType(scrollFiber, SCROLL_CONTENT_TYPES));
+
+  // Fall back: nearest host under the scroll composite = viewport; its first
+  // host child is typically the content wrapper.
+  if (!containerFiber) {
+    containerFiber = nearestHostDescendant(scrollFiber);
+  }
+  if (!contentFiber && containerFiber) {
+    contentFiber = firstHostChild(containerFiber);
+  }
+  return {
+    containerFiber,
+    contentFiber
+  };
+}
+function fiberFromMaybeInstance(instance) {
+  if (!instance || typeof instance === 'number') return null;
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const inst = instance;
+    const handle = inst._reactInternals ?? inst._reactInternalFiber ?? inst.__internalInstanceHandle ?? inst._internalInstanceHandle;
+    if (handle) return handle;
+    // Fabric public instance may itself be a host stateNode with a fiber link.
+    if (isHostFiber({
+      stateNode: instance,
+      tag: 5
+    })) {
+      // No fiber pointer — caller will measure via stateNode directly if needed.
+      return null;
+    }
+  } catch {
+    // Best-effort.
+  }
+  return null;
+}
+function findDescendantByHostType(fiber, types, maxNodes = 2_000) {
+  if (!fiber) return null;
+  const queue = [fiber];
+  let visited = 0;
+  while (queue.length > 0 && visited < maxNodes) {
+    const f = queue.shift();
+    if (!f) continue;
+    visited += 1;
+    if (f !== fiber && isHostFiber(f)) {
+      const name = getHostTypeName(f);
+      if (name && types.has(name)) return f;
+    }
+    let child = getChild(f);
+    while (child) {
+      queue.push(child);
+      child = getSibling(child);
+    }
+  }
+  return null;
+}
+function firstHostChild(fiber) {
+  let child = getChild(fiber);
+  let guard = 0;
+  while (child && guard < 200) {
+    if (isHostFiber(child)) return child;
+    // Prefer descending into the first child before siblings.
+    const grandchild = getChild(child);
+    if (grandchild) {
+      child = grandchild;
+    } else {
+      child = getSibling(child);
+    }
+    guard += 1;
+  }
+  return null;
+}
+function safeCall(self, fn) {
+  if (typeof fn !== 'function') return null;
+  try {
+    return fn.call(self);
+  } catch {
+    return null;
+  }
+}
+//# sourceMappingURL=findScrollAncestors.js.map

package/lib/module/anchors/fiber/findScrollAncestors.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MAX_ANCESTOR_WALK","getChild","getHostTypeName","getMemoizedProps","getReturn","getSibling","getStateNode","isHostFiber","nearestHostDescendant","SCROLL_METHODS","SCROLL_HOST_TYPES","Set","SCROLL_CONTENT_TYPES","findScrollAncestors","fiber","out","current","depth","instance","asScrollableInstance","containerFiber","contentFiber","resolveScrollGeometry","push","horizontal","isHorizontal","node","n","method","_listRef","props","scrollFiber","nativeRef","safeCall","getNativeScrollRef","innerRef","getInnerViewRef","fiberFromMaybeInstance","findDescendantByHostType","firstHostChild","inst","handle","_reactInternals","_reactInternalFiber","__internalInstanceHandle","_internalInstanceHandle","stateNode","tag","types","maxNodes","queue","visited","length","f","shift","name","has","child","guard","grandchild","self","fn","call"],"sourceRoot":"../../../../src","sources":["anchors/fiber/findScrollAncestors.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,SAEEA,iBAAiB,EACjBC,QAAQ,EACRC,eAAe,EACfC,gBAAgB,EAChBC,SAAS,EACTC,UAAU,EACVC,YAAY,EACZC,WAAW,QACN,qBAAkB;AACzB,SAASC,qBAAqB,QAAQ,sBAAmB;AAEzD,MAAMC,cAAc,GAAG,CAAC,UAAU,EAAE,gBAAgB,EAAE,kBAAkB,CAAU;;AAElF;AACA,MAAMC,iBAAiB,GAAG,IAAIC,GAAG,CAAC,CAAC,eAAe,EAAE,6BAA6B,CAAC,CAAC;;AAEnF;AACA,MAAMC,oBAAoB,GAAG,IAAID,GAAG,CAAC,CACnC,sBAAsB,EACtB,oCAAoC,CACrC,CAAC;AA8BF;AACA;AACA;AACA;AACA,OAAO,SAASE,mBAAmBA,CAACC,KAAe,EAAoB;EACrE,MAAMC,GAAqB,GAAG,EAAE;EAChC,IAAI,CAACD,KAAK,EAAE,OAAOC,GAAG;EAEtB,IAAI;IACF,IAAIC,OAAiB,GAAGF,KAAK;IAC7B,KAAK,IAAIG,KAAK,GAAG,CAAC,EAAED,OAAO,IAAIC,KAAK,GAAGjB,iBAAiB,EAAEiB,KAAK,IAAI,CAAC,EAAE;MACpE,MAAMC,QAAQ,GAAGC,oBAAoB,CAACb,YAAY,CAACU,OAAO,CAAC,CAAC;MAC5D,IAAIE,QAAQ,EAAE;QACZ,MAAM;UAAEE,cAAc;UAAEC;QAAa,CAAC,GAAGC,qBAAqB,CAACN,OAAO,EAAEE,QAAQ,CAAC;QACjFH,GAAG,CAACQ,IAAI,CAAC;UACPL,QAAQ;UACRE,cAAc;UACdC,YAAY;UACZG,UAAU,EAAEC,YAAY,CAACP,QAAQ,EAAEF,OAAO;QAC5C,CAAC,CAAC;MACJ;MACAA,OAAO,GAAGZ,SAAS,CAACY,OAAO,CAAC;IAC9B;EACF,CAAC,CAAC,MAAM;IACN;EAAA;EAGF,OAAOD,GAAG;AACZ;AAEA,SAASI,oBAAoBA,CAACO,IAAa,EAA6B;EACtE,IAAI,CAACA,IAAI,IAAI,OAAOA,IAAI,KAAK,QAAQ,EAAE,OAAO,IAAI;EAClD;EACA,MAAMC,CAAC,GAAGD,IAAW;EACrB,KAAK,MAAME,MAAM,IAAInB,cAAc,EAAE;IACnC,IAAI,OAAOkB,CAAC,CAACC,MAAM,CAAC,KAAK,UAAU,EAAE;MACnC,OAAOD,CAAC;IACV;EACF;EACA;EACA,IAAIA,CAAC,CAACE,QAAQ,IAAI,OAAOF,CAAC,CAACE,QAAQ,KAAK,QAAQ,EAAE;IAChD,OAAOV,oBAAoB,CAACQ,CAAC,CAACE,QAAQ,CAAC;EACzC;EACA,OAAO,IAAI;AACb;AAEA,SAASJ,YAAYA,CAACP,QAA4B,EAAEJ,KAAe,EAAW;EAC5E,IAAI;IACF,IAAII,QAAQ,CAACY,KAAK,IAAI,OAAOZ,QAAQ,CAACY,KAAK,CAACN,UAAU,KAAK,SAAS,EAAE;MACpE,OAAON,QAAQ,CAACY,KAAK,CAACN,UAAU;IAClC;IACA,MAAMM,KAAK,GAAG3B,gBAAgB,CAACW,KAAK,CAAC;IACrC,IAAIgB,KAAK,IAAI,OAAOA,KAAK,CAACN,UAAU,KAAK,SAAS,EAAE;MAClD,OAAOM,KAAK,CAACN,UAAU;IACzB;EACF,CAAC,CAAC,MAAM;IACN;EAAA;EAEF,OAAO,KAAK;AACd;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,SAASF,qBAAqBA,CAC5BS,WAAqB,EACrBb,QAA4B,EACwC;EACpE;EACA,MAAMc,SAAS,GAAGC,QAAQ,CAACf,QAAQ,EAAEA,QAAQ,CAACgB,kBAAkB,CAAC;EACjE,MAAMC,QAAQ,GAAGF,QAAQ,CAACf,QAAQ,EAAEA,QAAQ,CAACkB,eAAe,CAAC;EAE7D,IAAIhB,cAAc,GAChBiB,sBAAsB,CAACL,SAAS,CAAC,IAAIM,wBAAwB,CAACP,WAAW,EAAErB,iBAAiB,CAAC;EAC/F,IAAIW,YAAY,GACdgB,sBAAsB,CAACF,QAAQ,CAAC,KAC/Bf,cAAc,GACXkB,wBAAwB,CAAClB,cAAc,EAAER,oBAAoB,CAAC,GAC9D0B,wBAAwB,CAACP,WAAW,EAAEnB,oBAAoB,CAAC,CAAC;;EAElE;EACA;EACA,IAAI,CAACQ,cAAc,EAAE;IACnBA,cAAc,GAAGZ,qBAAqB,CAACuB,WAAW,CAAC;EACrD;EACA,IAAI,CAACV,YAAY,IAAID,cAAc,EAAE;IACnCC,YAAY,GAAGkB,cAAc,CAACnB,cAAc,CAAC;EAC/C;EAEA,OAAO;IAAEA,cAAc;IAAEC;EAAa,CAAC;AACzC;AAEA,SAASgB,sBAAsBA,CAACnB,QAAiB,EAAmB;EAClE,IAAI,CAACA,QAAQ,IAAI,OAAOA,QAAQ,KAAK,QAAQ,EAAE,OAAO,IAAI;EAC1D,IAAI;IACF;IACA,MAAMsB,IAAI,GAAGtB,QAAe;IAC5B,MAAMuB,MAAM,GACVD,IAAI,CAACE,eAAe,IACpBF,IAAI,CAACG,mBAAmB,IACxBH,IAAI,CAACI,wBAAwB,IAC7BJ,IAAI,CAACK,uBAAuB;IAC9B,IAAIJ,MAAM,EAAE,OAAOA,MAAM;IACzB;IACA,IAAIlC,WAAW,CAAC;MAAEuC,SAAS,EAAE5B,QAAQ;MAAE6B,GAAG,EAAE;IAAE,CAAC,CAAC,EAAE;MAChD;MACA,OAAO,IAAI;IACb;EACF,CAAC,CAAC,MAAM;IACN;EAAA;EAEF,OAAO,IAAI;AACb;AAEA,SAAST,wBAAwBA,CAC/BxB,KAAe,EACfkC,KAAkB,EAClBC,QAAQ,GAAG,KAAK,EACC;EACjB,IAAI,CAACnC,KAAK,EAAE,OAAO,IAAI;EACvB,MAAMoC,KAAiB,GAAG,CAACpC,KAAK,CAAC;EACjC,IAAIqC,OAAO,GAAG,CAAC;EACf,OAAOD,KAAK,CAACE,MAAM,GAAG,CAAC,IAAID,OAAO,GAAGF,QAAQ,EAAE;IAC7C,MAAMI,CAAC,GAAGH,KAAK,CAACI,KAAK,CAAC,CAAC;IACvB,IAAI,CAACD,CAAC,EAAE;IACRF,OAAO,IAAI,CAAC;IACZ,IAAIE,CAAC,KAAKvC,KAAK,IAAIP,WAAW,CAAC8C,CAAC,CAAC,EAAE;MACjC,MAAME,IAAI,GAAGrD,eAAe,CAACmD,CAAC,CAAC;MAC/B,IAAIE,IAAI,IAAIP,KAAK,CAACQ,GAAG,CAACD,IAAI,CAAC,EAAE,OAAOF,CAAC;IACvC;IACA,IAAII,KAAK,GAAGxD,QAAQ,CAACoD,CAAC,CAAC;IACvB,OAAOI,KAAK,EAAE;MACZP,KAAK,CAAC3B,IAAI,CAACkC,KAAK,CAAC;MACjBA,KAAK,GAAGpD,UAAU,CAACoD,KAAK,CAAC;IAC3B;EACF;EACA,OAAO,IAAI;AACb;AAEA,SAASlB,cAAcA,CAACzB,KAAe,EAAmB;EACxD,IAAI2C,KAAK,GAAGxD,QAAQ,CAACa,KAAK,CAAC;EAC3B,IAAI4C,KAAK,GAAG,CAAC;EACb,OAAOD,KAAK,IAAIC,KAAK,GAAG,GAAG,EAAE;IAC3B,IAAInD,WAAW,CAACkD,KAAK,CAAC,EAAE,OAAOA,KAAK;IACpC;IACA,MAAME,UAAU,GAAG1D,QAAQ,CAACwD,KAAK,CAAC;IAClC,IAAIE,UAAU,EAAE;MACdF,KAAK,GAAGE,UAAU;IACpB,CAAC,MAAM;MACLF,KAAK,GAAGpD,UAAU,CAACoD,KAAK,CAAC;IAC3B;IACAC,KAAK,IAAI,CAAC;EACZ;EACA,OAAO,IAAI;AACb;AAEA,SAASzB,QAAQA,CAAC2B,IAAwB,EAAEC,EAA+B,EAAW;EACpF,IAAI,OAAOA,EAAE,KAAK,UAAU,EAAE,OAAO,IAAI;EACzC,IAAI;IACF,OAAOA,EAAE,CAACC,IAAI,CAACF,IAAI,CAAC;EACtB,CAAC,CAAC,MAAM;IACN,OAAO,IAAI;EACb;AACF","ignoreList":[]}

package/lib/module/anchors/fiber/measureHostFiber.js

@@ -0,0 +1,70 @@
+"use strict";
+
+import { UIManager } from 'react-native';
+import { getStateNode } from "./fiberInternals.js";
+/**
+ * Feature-detected `measureInWindow` for a host fiber. Tries, in order:
+ *
+ * 1. `stateNode.measureInWindow` — Paper host, or materialized Fabric public instance
+ * 2. `nativeFabricUIManager.measureInWindow(stateNode.node, …)` — Fabric without public instance
+ * 3. `stateNode.canonical.publicInstance.measureInWindow`
+ * 4. `UIManager.measureInWindow(nativeTag, …)` — last resort
+ *
+ * Invokes `callback` with zeros when no measurable path is found (callers treat
+ * zero-size as missing).
+ */
+export function measureHostFiber(fiber, callback) {
+  const fail = () => {
+    callback(0, 0, 0, 0);
+  };
+  if (!fiber) {
+    fail();
+    return;
+  }
+  try {
+    const stateNode = getStateNode(fiber);
+    if (!stateNode || typeof stateNode !== 'object') {
+      fail();
+      return;
+    }
+
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const node = stateNode;
+    if (typeof node.measureInWindow === 'function') {
+      node.measureInWindow(callback);
+      return;
+    }
+
+    // Fabric: measure via the shadow node without materializing a public instance.
+    const fabricNode = node.node;
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const fabricUIManager = globalThis.nativeFabricUIManager;
+    if (fabricNode != null && fabricUIManager && typeof fabricUIManager.measureInWindow === 'function') {
+      fabricUIManager.measureInWindow(fabricNode, callback);
+      return;
+    }
+    const publicInstance = node.canonical?.publicInstance;
+    if (publicInstance && typeof publicInstance.measureInWindow === 'function') {
+      publicInstance.measureInWindow(callback);
+      return;
+    }
+    const nativeTag = node._nativeTag ?? node.__nativeTag ?? node.nativeTag ?? node.canonical?.nativeTag;
+    if (typeof nativeTag === 'number' && Number.isFinite(nativeTag)) {
+      UIManager.measureInWindow(nativeTag, callback);
+      return;
+    }
+  } catch {
+    // Fall through to fail.
+  }
+  fail();
+}
+
+/**
+ * Build an `AnchorHost`-compatible `measureInWindow` bound to a host fiber.
+ */
+export function createFiberMeasureInWindow(fiber) {
+  return callback => {
+    measureHostFiber(fiber, callback);
+  };
+}
+//# sourceMappingURL=measureHostFiber.js.map

package/lib/module/anchors/fiber/measureHostFiber.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["UIManager","getStateNode","measureHostFiber","fiber","callback","fail","stateNode","node","measureInWindow","fabricNode","fabricUIManager","globalThis","nativeFabricUIManager","publicInstance","canonical","nativeTag","_nativeTag","__nativeTag","Number","isFinite","createFiberMeasureInWindow"],"sourceRoot":"../../../../src","sources":["anchors/fiber/measureHostFiber.ts"],"mappings":";;AAAA,SAASA,SAAS,QAAQ,cAAc;AAGxC,SAASC,YAAY,QAAQ,qBAAkB;AAI/C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAACC,KAAe,EAAEC,QAAiC,EAAQ;EACzF,MAAMC,IAAI,GAAGA,CAAA,KAAY;IACvBD,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;EACtB,CAAC;EAED,IAAI,CAACD,KAAK,EAAE;IACVE,IAAI,CAAC,CAAC;IACN;EACF;EAEA,IAAI;IACF,MAAMC,SAAS,GAAGL,YAAY,CAACE,KAAK,CAAC;IACrC,IAAI,CAACG,SAAS,IAAI,OAAOA,SAAS,KAAK,QAAQ,EAAE;MAC/CD,IAAI,CAAC,CAAC;MACN;IACF;;IAEA;IACA,MAAME,IAAI,GAAGD,SAAgB;IAE7B,IAAI,OAAOC,IAAI,CAACC,eAAe,KAAK,UAAU,EAAE;MAC9CD,IAAI,CAACC,eAAe,CAACJ,QAAQ,CAAC;MAC9B;IACF;;IAEA;IACA,MAAMK,UAAU,GAAGF,IAAI,CAACA,IAAI;IAC5B;IACA,MAAMG,eAAe,GAAIC,UAAU,CAASC,qBAAqB;IACjE,IACEH,UAAU,IAAI,IAAI,IAClBC,eAAe,IACf,OAAOA,eAAe,CAACF,eAAe,KAAK,UAAU,EACrD;MACAE,eAAe,CAACF,eAAe,CAACC,UAAU,EAAEL,QAAQ,CAAC;MACrD;IACF;IAEA,MAAMS,cAAc,GAAGN,IAAI,CAACO,SAAS,EAAED,cAAc;IACrD,IAAIA,cAAc,IAAI,OAAOA,cAAc,CAACL,eAAe,KAAK,UAAU,EAAE;MAC1EK,cAAc,CAACL,eAAe,CAACJ,QAAQ,CAAC;MACxC;IACF;IAEA,MAAMW,SAAkB,GACtBR,IAAI,CAACS,UAAU,IAAIT,IAAI,CAACU,WAAW,IAAIV,IAAI,CAACQ,SAAS,IAAIR,IAAI,CAACO,SAAS,EAAEC,SAAS;IACpF,IAAI,OAAOA,SAAS,KAAK,QAAQ,IAAIG,MAAM,CAACC,QAAQ,CAACJ,SAAS,CAAC,EAAE;MAC/Df,SAAS,CAACQ,eAAe,CAACO,SAAS,EAAEX,QAAQ,CAAC;MAC9C;IACF;EACF,CAAC,CAAC,MAAM;IACN;EAAA;EAGFC,IAAI,CAAC,CAAC;AACR;;AAEA;AACA;AACA;AACA,OAAO,SAASe,0BAA0BA,CACxCjB,KAAe,EAC8B;EAC7C,OAAQC,QAAQ,IAAK;IACnBF,gBAAgB,CAACC,KAAK,EAAEC,QAAQ,CAAC;EACnC,CAAC;AACH","ignoreList":[]}

package/lib/module/anchors/fiber/visibleScreens.js

@@ -0,0 +1,159 @@
+"use strict";
+
+/**
+ * Restricts anchor scanning to the screens a user can actually see.
+ *
+ * A navigator keeps earlier screens mounted, so without this a tooltip could
+ * anchor to a view on a covered screen — measured on device: with a screen
+ * pushed on top, an anchor on the screen underneath still resolved and measured
+ * to an on-screen rect. Reusing one `testID` across two stacked screens also
+ * degraded to `ambiguous` and failed closed, even though only one was visible.
+ *
+ * Rules, derived from what react-native-screens actually exposes:
+ *
+ * - Native stack (`RNSScreenStack`): every mounted screen reports
+ *   `activityState === 2`, so it is useless as a discriminator. Sibling order
+ *   is what matters — the **last** branch owning a screen is on top.
+ * - Container-style navigators (tabs, non-native stacks) do vary
+ *   `activityState`, so the active branches win. When every branch is active
+ *   (e.g. multi-pane), all stay scannable — we must not fall back to
+ *   last-sibling there, or visible panes get pruned.
+ *
+ * Branches that own no screen at all (tab bars, headers, other global chrome)
+ * are always kept, so anchors outside the screen stack keep resolving.
+ *
+ * Everything is feature-detected: an app without react-native-screens, or a
+ * renamed native component, prunes nothing and behaves as before.
+ */
+import { MAX_ANCESTOR_WALK, getAlternate, getChild, getHostTypeName, getMemoizedProps, getReturn, getSibling } from "./fiberInternals.js";
+
+/** Host screen types (push screens and iOS modal presentations). */
+const SCREEN_TYPES = new Set(['RNSScreen', 'RNSModalScreen']);
+
+/** Host components that own a set of sibling screen branches. */
+const SCREEN_CONTAINER_TYPES = new Set(['RNSScreenStack', 'RNSScreenContainer', 'RNSScreenNavigationContainer']);
+
+/** Native stacks cannot use activityState; last sibling branch is on top. */
+const STACK_CONTAINER_TYPES = new Set(['RNSScreenStack']);
+
+/** `activityState === 2` is react-native-screens' "on screen" value. */
+const ACTIVITY_STATE_ACTIVE = 2;
+
+/** Bound for the per-branch search for the screen it owns. */
+const MAX_BRANCH_NODES = 400;
+export function isScreenContainerFiber(fiber) {
+  const type = getHostTypeName(fiber);
+  return type !== undefined && SCREEN_CONTAINER_TYPES.has(type);
+}
+function isScreenFiber(fiber) {
+  const type = getHostTypeName(fiber);
+  return type !== undefined && SCREEN_TYPES.has(type);
+}
+function isStackContainer(fiber) {
+  const type = getHostTypeName(fiber);
+  return type !== undefined && STACK_CONTAINER_TYPES.has(type);
+}
+
+/** Nearest screen under `branch`, not crossing into a nested container. */
+function ownedScreen(branch) {
+  const stack = [branch];
+  let visited = 0;
+  while (stack.length > 0 && visited < MAX_BRANCH_NODES) {
+    const fiber = stack.pop();
+    if (!fiber) continue;
+    visited += 1;
+    if (isScreenFiber(fiber)) return fiber;
+    // A nested container's screens belong to that container, not this branch.
+    // Still follow siblings so a screen next to a nested navigator is found.
+    if (fiber !== branch && isScreenContainerFiber(fiber)) {
+      const sibling = getSibling(fiber);
+      if (sibling) stack.push(sibling);
+      continue;
+    }
+    const child = getChild(fiber);
+    if (child) stack.push(child);
+    if (fiber !== branch) {
+      const sibling = getSibling(fiber);
+      if (sibling) stack.push(sibling);
+    }
+  }
+  return null;
+}
+function isActive(screen) {
+  return getMemoizedProps(screen)?.activityState === ACTIVITY_STATE_ACTIVE;
+}
+
+/**
+ * Branches of `container` that are covered by another screen and so must not be
+ * scanned. Empty when there is nothing to prune. Alternates are included so a
+ * fiber captured on a previous render still matches.
+ */
+export function coveredScreenBranches(container) {
+  const branches = [];
+  let child = getChild(container);
+  let guard = 0;
+  while (child && guard < 200) {
+    const screen = ownedScreen(child);
+    if (screen) branches.push({
+      branch: child,
+      screen
+    });
+    child = getSibling(child);
+    guard += 1;
+  }
+  const covered = new Set();
+  if (branches.length <= 1) return covered;
+  let visible;
+  if (isStackContainer(container)) {
+    // Native stack: activityState is always 2 for mounted screens; last branch
+    // owns the top of the stack (including an iOS RNSModalScreen presentation).
+    visible = [branches[branches.length - 1]];
+  } else {
+    const active = branches.filter(entry => isActive(entry.screen));
+    // Keep every active pane (tabs + multi-visible). If none report active
+    // (transition), fall back to last sibling rather than pruning everything.
+    visible = active.length > 0 ? active : [branches[branches.length - 1]];
+  }
+  for (const entry of branches) {
+    if (visible.includes(entry)) continue;
+    covered.add(entry.branch);
+    const alternate = entry.branch.alternate;
+    if (alternate) covered.add(alternate);
+  }
+  return covered;
+}
+
+/**
+ * Whether `fiber` lives on a screen the user can currently see.
+ *
+ * Needed in addition to scan-time pruning: a resolved anchor is cached, and the
+ * cache would otherwise keep serving a host after its screen was covered by a
+ * newly pushed one. Walks outward so nested navigators are handled.
+ */
+export function isFiberOnVisibleScreen(fiber) {
+  if (!fiber) return false;
+  try {
+    let previous = null;
+    let current = fiber;
+    for (let depth = 0; current && depth < MAX_ANCESTOR_WALK; depth += 1) {
+      if (previous) {
+        // A cached fiber's `return` chain can point at the previous render, whose
+        // container still lists the old branches — so consult both alternates.
+        for (const container of [current, getAlternate(current)]) {
+          if (!container || !isScreenContainerFiber(container)) continue;
+          const covered = coveredScreenBranches(container);
+          if (covered.size === 0) continue;
+          if (covered.has(previous)) return false;
+          const previousAlternate = getAlternate(previous);
+          if (previousAlternate && covered.has(previousAlternate)) return false;
+        }
+      }
+      previous = current;
+      current = getReturn(current);
+    }
+  } catch {
+    // Visibility is a refinement; never let it break resolution.
+  }
+  return true;
+}
+//# sourceMappingURL=visibleScreens.js.map

package/lib/module/anchors/fiber/visibleScreens.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["MAX_ANCESTOR_WALK","getAlternate","getChild","getHostTypeName","getMemoizedProps","getReturn","getSibling","SCREEN_TYPES","Set","SCREEN_CONTAINER_TYPES","STACK_CONTAINER_TYPES","ACTIVITY_STATE_ACTIVE","MAX_BRANCH_NODES","isScreenContainerFiber","fiber","type","undefined","has","isScreenFiber","isStackContainer","ownedScreen","branch","stack","visited","length","pop","sibling","push","child","isActive","screen","activityState","coveredScreenBranches","container","branches","guard","covered","visible","active","filter","entry","includes","add","alternate","isFiberOnVisibleScreen","previous","current","depth","size","previousAlternate"],"sourceRoot":"../../../../src","sources":["anchors/fiber/visibleScreens.ts"],"mappings":"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","ignoreList":[]}