@userflow-tech/react-native 0.1.0

package/lib/module/anchors/autoAnchor.js

@@ -0,0 +1,248 @@
+"use strict";
+
+import * as ReactNS from 'react';
+import { autoAnchorRegistry, roleForKind } from "./AutoAnchorRegistry.js";
+import { expandBuildTimeHints, isHintsInput } from "./hintsCodec.js";
+
+/**
+ * Runtime half of build-time auto-anchoring (see `@userflow-tech/babel-plugin`).
+ *
+ * Each mount creates a distinct AutoAnchorRegistry instance. Shared templates
+ * (design-system / list rows) register separately and are marked ambiguous
+ * when they lack a unique manual id or call-site scope.
+ *
+ * Canonical signature (what Babel emits via `__ufRef`):
+ *   __userflowAutoAnchor(id, hints, userRef, kind, runtime?)
+ */
+
+function cacheKey(id, scope) {
+  return scope ? `${id}@@${scope}` : id;
+}
+const cache = new Map();
+
+/**
+ * Legacy string refs (`ref="foo"`) assigned `owner.refs.foo` via React internals.
+ * Best-effort: modern React may not expose an owner; never throws into app code.
+ */
+function assignLegacyStringRef(name, instance) {
+  try {
+    const React = ReactNS;
+    const internals = React.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE ?? React.__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED;
+    const owner = internals?.ReactCurrentOwner?.current;
+    if (!owner) return;
+    if (owner.refs == null) {
+      owner.refs = {};
+    }
+    if (instance) {
+      owner.refs[name] = instance;
+    } else {
+      delete owner.refs[name];
+    }
+  } catch {
+    // String-ref owner unavailable — ignore rather than break the host.
+  }
+}
+function attachUserRef(userRef, instance) {
+  if (userRef == null || userRef === '') return;
+  if (typeof userRef === 'string') {
+    assignLegacyStringRef(userRef, instance);
+    return;
+  }
+  if (typeof userRef === 'function') {
+    const result = userRef(instance);
+    if (typeof result === 'function') {
+      return result;
+    }
+    return;
+  }
+  try {
+    userRef.current = instance;
+  } catch {
+    // Read-only ref object — nothing to do.
+  }
+}
+function detachUserRef(userRef, reg) {
+  if (reg.userRefCleanup) {
+    try {
+      reg.userRefCleanup();
+    } catch {
+      // App cleanup must not break unmount.
+    }
+    reg.userRefCleanup = null;
+    return;
+  }
+  attachUserRef(userRef, null);
+}
+function teardownRegistration(entry, reg) {
+  detachUserRef(entry.userRef, reg);
+  reg.dispose();
+}
+function isRefLike(value) {
+  return typeof value === 'function' || typeof value === 'object' && value !== null && 'current' in value;
+}
+function isUserRef(value) {
+  if (typeof value === 'string') return value.length > 0;
+  return isRefLike(value);
+}
+function isRuntime(value) {
+  return typeof value === 'object' && value !== null && !isRefLike(value) && !isHintsInput(value);
+}
+function resolveHints(raw, kind) {
+  if (raw == null) return raw;
+  return expandBuildTimeHints(raw, kind);
+}
+export function __userflowAutoAnchor(id, hintsOrUserRef, userRefOrKind, kindOrRuntime, maybeRuntime) {
+  let hints;
+  let userRef;
+  let elementKind;
+  let runtime;
+  if (isHintsInput(hintsOrUserRef)) {
+    userRef = isUserRef(userRefOrKind) ? userRefOrKind : null;
+    if (typeof kindOrRuntime === 'string') {
+      elementKind = kindOrRuntime;
+      runtime = maybeRuntime;
+    } else if (isRuntime(kindOrRuntime)) {
+      runtime = kindOrRuntime;
+    }
+    hints = resolveHints(hintsOrUserRef, elementKind);
+  } else {
+    hints = undefined;
+    userRef = isUserRef(hintsOrUserRef) ? hintsOrUserRef : null;
+    elementKind = typeof userRefOrKind === 'string' ? userRefOrKind : undefined;
+    if (isRuntime(kindOrRuntime)) runtime = kindOrRuntime;else if (maybeRuntime) runtime = maybeRuntime;
+  }
+  const resolvedId = typeof id === 'string' && id.length > 0 ? id : hints?.nativeId ?? hints?.ufid ?? 'uf_unknown';
+  const scope = runtime?.scope;
+  const key = cacheKey(resolvedId, scope);
+  const existing = cache.get(key);
+  if (existing) {
+    existing.userRef = userRef;
+    existing.hints = hints;
+    existing.kind = elementKind ?? existing.kind;
+    existing.runtime = runtime ?? existing.runtime;
+    if (existing.registrations.size === 1 && (hints || runtime)) {
+      const [reg] = existing.registrations.values();
+      const patch = {};
+      if (runtime?.childText !== undefined) patch.childText = runtime.childText;
+      if (runtime?.accessibilityLabel !== undefined) {
+        patch.accessibilityLabel = runtime.accessibilityLabel;
+      }
+      if (runtime?.scope) patch.instanceScope = runtime.scope;
+      if (runtime?.userflowId) patch.userflowId = runtime.userflowId;
+      if (runtime?.testID) patch.testID = runtime.testID;
+      if (runtime?.nativeID) patch.nativeID = runtime.nativeID;
+      if (runtime?.manualId || runtime?.userflowId || runtime?.testID) {
+        const mid = runtime.manualId ?? runtime.userflowId ?? runtime.testID ?? existing.runtime?.manualId;
+        if (mid) patch.manualId = mid;
+      }
+      autoAnchorRegistry.updateInstance(reg.instanceId, patch);
+    }
+    return existing.callback;
+  }
+  const entry = {
+    userRef,
+    hints,
+    kind: elementKind,
+    runtime,
+    registrations: new Map(),
+    callback: instance => {
+      if (instance) {
+        if (entry.registrations.has(instance)) return undefined;
+        const cleanup = attachUserRef(entry.userRef, instance);
+        const holder = {
+          current: instance
+        };
+        const kind = entry.kind ?? 'View';
+        const rt = entry.runtime;
+        const composedPath = rt?.scope && entry.hints?.templatePath ? `${rt.scope} :: ${entry.hints.templatePath}` : entry.hints?.structuralPath ?? entry.hints?.ufid;
+        const hintsForReg = entry.hints ? {
+          ...entry.hints,
+          ...(composedPath ? {
+            structuralPath: composedPath,
+            ufid: composedPath
+          } : {}),
+          role: entry.hints.role ?? roleForKind(kind)
+        } : {
+          ufid: resolvedId,
+          nativeId: resolvedId,
+          role: roleForKind(kind)
+        };
+        const {
+          instanceId,
+          dispose
+        } = autoAnchorRegistry.registerInstance({
+          registryKey: resolvedId,
+          ref: holder,
+          kind,
+          hints: hintsForReg,
+          ...(rt?.scope ? {
+            instanceScope: rt.scope
+          } : {}),
+          runtime: {
+            ...(rt?.manualId ? {
+              manualId: rt.manualId
+            } : {}),
+            ...(rt?.userflowId ? {
+              userflowId: rt.userflowId
+            } : {}),
+            ...(rt?.testID ? {
+              testID: rt.testID
+            } : {}),
+            ...(rt?.nativeID ? {
+              nativeID: rt.nativeID
+            } : {}),
+            ...(rt?.childText ? {
+              childText: rt.childText
+            } : {}),
+            ...(rt?.accessibilityLabel ? {
+              accessibilityLabel: rt.accessibilityLabel
+            } : {}),
+            ...(rt?.iconName ? {
+              iconName: rt.iconName
+            } : {}),
+            ...(rt?.imageSrc ? {
+              imageSrc: rt.imageSrc
+            } : {}),
+            ...(rt?.reactKey ? {
+              reactKey: rt.reactKey
+            } : {}),
+            ...(!rt?.manualId && !rt?.userflowId && !rt?.testID && !resolvedId.startsWith('uf_') ? {
+              manualId: resolvedId
+            } : {})
+          }
+        });
+        const reg = {
+          holder,
+          instanceId,
+          dispose,
+          userRefCleanup: typeof cleanup === 'function' ? cleanup : null
+        };
+        entry.registrations.set(instance, reg);
+        return () => {
+          const r = entry.registrations.get(instance);
+          if (!r) return;
+          entry.registrations.delete(instance);
+          teardownRegistration(entry, r);
+        };
+      }
+      const first = entry.registrations.keys().next();
+      if (!first.done) {
+        const inst = first.value;
+        const r = entry.registrations.get(inst);
+        entry.registrations.delete(inst);
+        teardownRegistration(entry, r);
+      }
+      return undefined;
+    }
+  };
+  cache.set(key, entry);
+  return entry.callback;
+}
+
+/** Test helper — drop factory cache and registry instances. */
+export function __resetAutoAnchorForTests() {
+  cache.clear();
+  autoAnchorRegistry.clear();
+}
+globalThis.__userflowAutoAnchor = __userflowAutoAnchor;
+//# sourceMappingURL=autoAnchor.js.map

package/lib/module/anchors/autoAnchor.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["ReactNS","autoAnchorRegistry","roleForKind","expandBuildTimeHints","isHintsInput","cacheKey","id","scope","cache","Map","assignLegacyStringRef","name","instance","React","internals","__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE","__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED","owner","ReactCurrentOwner","current","refs","attachUserRef","userRef","result","detachUserRef","reg","userRefCleanup","teardownRegistration","entry","dispose","isRefLike","value","isUserRef","length","isRuntime","resolveHints","raw","kind","__userflowAutoAnchor","hintsOrUserRef","userRefOrKind","kindOrRuntime","maybeRuntime","hints","elementKind","runtime","undefined","resolvedId","nativeId","ufid","key","existing","get","registrations","size","values","patch","childText","accessibilityLabel","instanceScope","userflowId","testID","nativeID","manualId","mid","updateInstance","instanceId","callback","has","cleanup","holder","rt","composedPath","templatePath","structuralPath","hintsForReg","role","registerInstance","registryKey","ref","iconName","imageSrc","reactKey","startsWith","set","r","delete","first","keys","next","done","inst","__resetAutoAnchorForTests","clear","globalThis"],"sourceRoot":"../../../src","sources":["anchors/autoAnchor.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/anchors/elementConditionEvaluator.js

@@ -0,0 +1,79 @@
+"use strict";
+
+import { anchorChangeTicker } from "./anchorChangeTicker.js";
+import { resolveAnchorHost } from "./resolveAnchorHost.js";
+import { resolveManualAnchorId } from "./resolveManualAnchorId.js";
+
+/** ELEMENT states the mobile SDK can evaluate today. */
+const SUPPORTED_ELEMENT_STATES = new Set(['PRESENT', 'NOT_PRESENT']);
+
+/**
+ * Evaluate ELEMENT client conditions against manual anchors and fiber-resolved
+ * `testID` / `nativeID` / `accessibilityLabel` targets.
+ *
+ * Supports PRESENT / NOT_PRESENT for MANUAL selectors (`css` → anchor id).
+ * AUTO / codeless selectors and web-interaction states (CLICK, DISABLED, …)
+ * report unknown (`null`) so gated flows stay blocked rather than inventing
+ * a truth value.
+ *
+ * "Present" means `resolveAnchorHost` finds a unique host. That already skips
+ * screens covered by another navigator screen, so an id on a pushed-under
+ * screen counts as absent. Pixel visibility (off-screen inside a ScrollView,
+ * opacity 0, etc.) would need async `measureInWindow` and is out of scope.
+ *
+ * Note: compares string literals rather than importing protocol enums so Jest
+ * (which cannot resolve the ESM-only `@userflow-tech/protocol` package) stays
+ * hermetic. Wire values match `FlowConditionElementState` / `FlowSelectorType`.
+ */
+export function createElementConditionEvaluator(warn = message => {
+  if (__DEV__) {
+    // eslint-disable-next-line no-console -- intentional development diagnostic
+    console.warn(message);
+  }
+}) {
+  const warnedConditionIds = new Set();
+  const warnOnce = (conditionId, message) => {
+    if (warnedConditionIds.has(conditionId)) return;
+    warnedConditionIds.add(conditionId);
+    warn(message);
+  };
+  return (condition, report) => {
+    const evaluate = () => {
+      const result = evaluateElementCondition(condition, warnOnce);
+      report(result);
+    };
+    evaluate();
+    return anchorChangeTicker.subscribe(evaluate);
+  };
+}
+function evaluateElementCondition(condition, warnOnce) {
+  const elementState = condition.elementState;
+  if (elementState == null || !SUPPORTED_ELEMENT_STATES.has(elementState)) {
+    warnOnce(condition.id, `[Userflow] ELEMENT condition ${condition.id} uses unsupported elementState ` + `"${elementState ?? 'null'}" (only PRESENT / NOT_PRESENT are supported); ` + 'leaving unknown');
+    return null;
+  }
+  const selector = condition.selector;
+  if (selector == null) {
+    warnOnce(condition.id, `[Userflow] ELEMENT condition ${condition.id} has no selector; leaving unknown`);
+    return null;
+  }
+  if (selector.type === 'AUTO') {
+    warnOnce(condition.id, `[Userflow] ELEMENT condition ${condition.id} uses an AUTO (codeless) selector; ` + 'manual anchors only are supported today — leaving unknown');
+    return null;
+  }
+  const anchorId = resolveManualAnchorId(selector.css);
+  if (anchorId == null) {
+    warnOnce(condition.id, `[Userflow] ELEMENT condition ${condition.id} has no resolvable manual anchor id; ` + 'leaving unknown');
+    return null;
+  }
+  const resolution = resolveAnchorHost(anchorId);
+  // Ambiguous counts as not present for PRESENT (fail closed) and as "present"
+  // for NOT_PRESENT would be wrong — treat ambiguous as unknown so gated flows
+  // stay blocked rather than inventing a truth value.
+  if (resolution.status === 'ambiguous') {
+    return null;
+  }
+  const present = resolution.status === 'found';
+  return elementState === 'PRESENT' ? present : !present;
+}
+//# sourceMappingURL=elementConditionEvaluator.js.map

package/lib/module/anchors/elementConditionEvaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["anchorChangeTicker","resolveAnchorHost","resolveManualAnchorId","SUPPORTED_ELEMENT_STATES","Set","createElementConditionEvaluator","warn","message","__DEV__","console","warnedConditionIds","warnOnce","conditionId","has","add","condition","report","evaluate","result","evaluateElementCondition","subscribe","elementState","id","selector","type","anchorId","css","resolution","status","present"],"sourceRoot":"../../../src","sources":["anchors/elementConditionEvaluator.ts"],"mappings":";;AAGA,SAASA,kBAAkB,QAAQ,yBAAsB;AACzD,SAASC,iBAAiB,QAAQ,wBAAqB;AACvD,SAASC,qBAAqB,QAAQ,4BAAyB;;AAE/D;AACA,MAAMC,wBAAwB,GAAG,IAAIC,GAAG,CAAC,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;;AAEpE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,+BAA+BA,CAC7CC,IAA+B,GAAIC,OAAO,IAAK;EAC7C,IAAIC,OAAO,EAAE;IACX;IACAC,OAAO,CAACH,IAAI,CAACC,OAAO,CAAC;EACvB;AACF,CAAC,EACmB;EACpB,MAAMG,kBAAkB,GAAG,IAAIN,GAAG,CAAS,CAAC;EAE5C,MAAMO,QAAQ,GAAGA,CAACC,WAAmB,EAAEL,OAAe,KAAW;IAC/D,IAAIG,kBAAkB,CAACG,GAAG,CAACD,WAAW,CAAC,EAAE;IACzCF,kBAAkB,CAACI,GAAG,CAACF,WAAW,CAAC;IACnCN,IAAI,CAACC,OAAO,CAAC;EACf,CAAC;EAED,OAAO,CAACQ,SAAS,EAAEC,MAAM,KAAK;IAC5B,MAAMC,QAAQ,GAAGA,CAAA,KAAY;MAC3B,MAAMC,MAAM,GAAGC,wBAAwB,CAACJ,SAAS,EAAEJ,QAAQ,CAAC;MAC5DK,MAAM,CAACE,MAAM,CAAC;IAChB,CAAC;IAEDD,QAAQ,CAAC,CAAC;IACV,OAAOjB,kBAAkB,CAACoB,SAAS,CAACH,QAAQ,CAAC;EAC/C,CAAC;AACH;AAEA,SAASE,wBAAwBA,CAC/BJ,SAAgC,EAChCJ,QAAwD,EACxC;EAChB,MAAMU,YAAY,GAAGN,SAAS,CAACM,YAA6B;EAC5D,IAAIA,YAAY,IAAI,IAAI,IAAI,CAAClB,wBAAwB,CAACU,GAAG,CAACQ,YAAY,CAAC,EAAE;IACvEV,QAAQ,CACNI,SAAS,CAACO,EAAE,EACZ,gCAAgCP,SAAS,CAACO,EAAE,iCAAiC,GAC3E,IAAID,YAAY,IAAI,MAAM,gDAAgD,GAC1E,iBACJ,CAAC;IACD,OAAO,IAAI;EACb;EAEA,MAAME,QAAQ,GAAGR,SAAS,CAACQ,QAAQ;EACnC,IAAIA,QAAQ,IAAI,IAAI,EAAE;IACpBZ,QAAQ,CACNI,SAAS,CAACO,EAAE,EACZ,gCAAgCP,SAAS,CAACO,EAAE,mCAC9C,CAAC;IACD,OAAO,IAAI;EACb;EAEA,IAAKC,QAAQ,CAACC,IAAI,KAAuB,MAAM,EAAE;IAC/Cb,QAAQ,CACNI,SAAS,CAACO,EAAE,EACZ,gCAAgCP,SAAS,CAACO,EAAE,qCAAqC,GAC/E,2DACJ,CAAC;IACD,OAAO,IAAI;EACb;EAEA,MAAMG,QAAQ,GAAGvB,qBAAqB,CAACqB,QAAQ,CAACG,GAAG,CAAC;EACpD,IAAID,QAAQ,IAAI,IAAI,EAAE;IACpBd,QAAQ,CACNI,SAAS,CAACO,EAAE,EACZ,gCAAgCP,SAAS,CAACO,EAAE,uCAAuC,GACjF,iBACJ,CAAC;IACD,OAAO,IAAI;EACb;EAEA,MAAMK,UAAU,GAAG1B,iBAAiB,CAACwB,QAAQ,CAAC;EAC9C;EACA;EACA;EACA,IAAIE,UAAU,CAACC,MAAM,KAAK,WAAW,EAAE;IACrC,OAAO,IAAI;EACb;EACA,MAAMC,OAAO,GAAGF,UAAU,CAACC,MAAM,KAAK,OAAO;EAC7C,OAAOP,YAAY,KAAK,SAAS,GAAGQ,OAAO,GAAG,CAACA,OAAO;AACxD","ignoreList":[]}

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

@@ -0,0 +1,84 @@
+"use strict";
+
+import * as React from 'react';
+import { StyleSheet, View } from 'react-native';
+import { fiberFromPublicInstance, resolveCurrentFiber } from "./fiberInternals.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Module singleton holding the fiber under which testID / nativeID /
+ * accessibilityLabel scans run. Seeded by {@link FiberScanRoot}.
+ */
+class FiberScanRootStore {
+  instance = null;
+  listeners = new Set();
+  set(instance) {
+    this.instance = instance;
+    this.emit();
+  }
+  clear() {
+    this.instance = null;
+    this.emit();
+  }
+
+  /** Current (resolved) fiber under the scan root, or null when unmounted. */
+  getFiber() {
+    if (!this.instance) return null;
+    const fiber = fiberFromPublicInstance(this.instance);
+    if (!fiber) return null;
+    return resolveCurrentFiber(fiber);
+  }
+  subscribe(listener) {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  }
+
+  /** Test helper. */
+  resetForTests() {
+    this.instance = null;
+    this.listeners.clear();
+  }
+  emit() {
+    for (const listener of this.listeners) {
+      listener();
+    }
+  }
+}
+export const fiberScanRoot = new FiberScanRootStore();
+/**
+ * Class component that publishes its own `_reactInternals` fiber as the scan
+ * root for testID-based anchoring. Class instances expose `_reactInternals` in
+ * both Paper and Fabric production builds (unlike host refs, which null out
+ * `_internalFiberInstanceHandleDEV` on Paper release).
+ *
+ * Renders the same content-root `View` that {@link UserflowProvider} previously
+ * owned so the layout tree is unchanged. The Userflow overlay sits as a
+ * *sibling*, so SDK-owned `testID`s never self-match.
+ */
+export class FiberScanRoot extends React.Component {
+  componentDidMount() {
+    fiberScanRoot.set(this);
+  }
+  componentDidUpdate() {
+    // Re-publish after updates so a remount-without-unmount still has a live
+    // pointer (defensive; normally the instance identity is stable).
+    fiberScanRoot.set(this);
+  }
+  componentWillUnmount() {
+    fiberScanRoot.clear();
+  }
+  render() {
+    return /*#__PURE__*/_jsx(View, {
+      style: styles.contentRoot,
+      collapsable: false,
+      children: this.props.children
+    });
+  }
+}
+const styles = StyleSheet.create({
+  contentRoot: {
+    flex: 1
+  }
+});
+//# sourceMappingURL=FiberScanRoot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["React","StyleSheet","View","fiberFromPublicInstance","resolveCurrentFiber","jsx","_jsx","FiberScanRootStore","instance","listeners","Set","set","emit","clear","getFiber","fiber","subscribe","listener","add","delete","resetForTests","fiberScanRoot","FiberScanRoot","Component","componentDidMount","componentDidUpdate","componentWillUnmount","render","style","styles","contentRoot","collapsable","children","props","create","flex"],"sourceRoot":"../../../../src","sources":["anchors/fiber/FiberScanRoot.tsx"],"mappings":";;AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAC9B,SAASC,UAAU,EAAEC,IAAI,QAAQ,cAAc;AAE/C,SAAwBC,uBAAuB,EAAEC,mBAAmB,QAAQ,qBAAkB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAI/F;AACA;AACA;AACA;AACA,MAAMC,kBAAkB,CAAC;EACfC,QAAQ,GAAY,IAAI;EACfC,SAAS,GAAG,IAAIC,GAAG,CAAW,CAAC;EAEhDC,GAAGA,CAACH,QAAiB,EAAQ;IAC3B,IAAI,CAACA,QAAQ,GAAGA,QAAQ;IACxB,IAAI,CAACI,IAAI,CAAC,CAAC;EACb;EAEAC,KAAKA,CAAA,EAAS;IACZ,IAAI,CAACL,QAAQ,GAAG,IAAI;IACpB,IAAI,CAACI,IAAI,CAAC,CAAC;EACb;;EAEA;EACAE,QAAQA,CAAA,EAAoB;IAC1B,IAAI,CAAC,IAAI,CAACN,QAAQ,EAAE,OAAO,IAAI;IAC/B,MAAMO,KAAK,GAAGZ,uBAAuB,CAAC,IAAI,CAACK,QAAQ,CAAC;IACpD,IAAI,CAACO,KAAK,EAAE,OAAO,IAAI;IACvB,OAAOX,mBAAmB,CAACW,KAAK,CAAC;EACnC;EAEAC,SAASA,CAACC,QAAkB,EAAc;IACxC,IAAI,CAACR,SAAS,CAACS,GAAG,CAACD,QAAQ,CAAC;IAC5B,OAAO,MAAM;MACX,IAAI,CAACR,SAAS,CAACU,MAAM,CAACF,QAAQ,CAAC;IACjC,CAAC;EACH;;EAEA;EACAG,aAAaA,CAAA,EAAS;IACpB,IAAI,CAACZ,QAAQ,GAAG,IAAI;IACpB,IAAI,CAACC,SAAS,CAACI,KAAK,CAAC,CAAC;EACxB;EAEQD,IAAIA,CAAA,EAAS;IACnB,KAAK,MAAMK,QAAQ,IAAI,IAAI,CAACR,SAAS,EAAE;MACrCQ,QAAQ,CAAC,CAAC;IACZ;EACF;AACF;AAEA,OAAO,MAAMI,aAAa,GAAG,IAAId,kBAAkB,CAAC,CAAC;AAMrD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMe,aAAa,SAAStB,KAAK,CAACuB,SAAS,CAAqB;EAC5DC,iBAAiBA,CAAA,EAAS;IACjCH,aAAa,CAACV,GAAG,CAAC,IAAI,CAAC;EACzB;EAESc,kBAAkBA,CAAA,EAAS;IAClC;IACA;IACAJ,aAAa,CAACV,GAAG,CAAC,IAAI,CAAC;EACzB;EAESe,oBAAoBA,CAAA,EAAS;IACpCL,aAAa,CAACR,KAAK,CAAC,CAAC;EACvB;EAESc,MAAMA,CAAA,EAAuB;IACpC,oBACErB,IAAA,CAACJ,IAAI;MAAC0B,KAAK,EAAEC,MAAM,CAACC,WAAY;MAACC,WAAW,EAAE,KAAM;MAAAC,QAAA,EACjD,IAAI,CAACC,KAAK,CAACD;IAAQ,CAChB,CAAC;EAEX;AACF;AAEA,MAAMH,MAAM,GAAG5B,UAAU,CAACiC,MAAM,CAAC;EAC/BJ,WAAW,EAAE;IACXK,IAAI,EAAE;EACR;AACF,CAAC,CAAC","ignoreList":[]}

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

@@ -0,0 +1,164 @@
+"use strict";
+
+/**
+ * Compatibility layer for the React Native / React **internals** that
+ * testID-based anchoring depends on. Every accessor is feature-detected and
+ * **never throws** (returns `undefined`/`false`/`null` on a missing or renamed
+ * field) so an RN shape change degrades to not-found rather than crashing the
+ * host app.
+ *
+ * Explicitly **no** `__REACT_DEVTOOLS_GLOBAL_HOOK__`. Fibers are reached only
+ * through production-present pointers on class instances (`_reactInternals`).
+ */
+
+// The fiber shape we touch is intentionally permissive; we never mutate.
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+
+/** React reconciler `HostComponent` fiber tag. */
+const HOST_COMPONENT_TAG = 5;
+
+/** React reconciler `HostRoot` fiber tag. */
+const HOST_ROOT_TAG = 3;
+
+/**
+ * Bound for `return`-pointer walks. Only a loop guard, not a real limit:
+ * measured fiber depth in a modest Expo Router app is already ~150 from a
+ * tagged view to the provider, and ~80 from the provider to the HostRoot, so a
+ * small cap silently disables the walk instead of protecting anything.
+ */
+export const MAX_ANCESTOR_WALK = 10_000;
+
+/** Keys/methods that mark a `stateNode` as a measurable native view instance. */
+const HOST_STATE_NODE_KEYS = ['viewConfig', '_nativeTag', '__nativeTag', 'nativeTag', '_internalInstanceHandle', 'node', 'canonical'];
+export function getChild(fiber) {
+  return fiber?.child ?? null;
+}
+export function getSibling(fiber) {
+  return fiber?.sibling ?? null;
+}
+export function getReturn(fiber) {
+  return fiber?.return ?? null;
+}
+export function getAlternate(fiber) {
+  return fiber?.alternate ?? null;
+}
+export function getMemoizedProps(fiber) {
+  const p = fiber?.memoizedProps;
+  return p && typeof p === 'object' ? p : undefined;
+}
+export function getStateNode(fiber) {
+  return fiber?.stateNode ?? null;
+}
+export function getFiberTag(fiber) {
+  const t = fiber?.tag;
+  return typeof t === 'number' ? t : undefined;
+}
+
+/** Native component name for a host fiber (e.g. `RNSScreen`), else undefined. */
+export function getHostTypeName(fiber) {
+  const t = fiber?.type;
+  return typeof t === 'string' ? t : undefined;
+}
+
+/**
+ * True when `fiber` is a host component. Checks both Paper/Fabric stateNode
+ * markers and the HostComponent tag (react-test-renderer host fibers often
+ * have `tag === 5` without native keys).
+ */
+export function isHostFiber(fiber) {
+  const node = fiber?.stateNode;
+  if (node && typeof node === 'object') {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const n = node;
+    for (const k of HOST_STATE_NODE_KEYS) {
+      if (k in node) return true;
+    }
+    if (typeof n.measure === 'function' || typeof n.measureInWindow === 'function' || typeof n.measureLayout === 'function') {
+      return true;
+    }
+  }
+  return getFiberTag(fiber) === HOST_COMPONENT_TAG;
+}
+
+/**
+ * Ordered pointer names a class / public instance uses to reference its fiber.
+ * `_internalFiberInstanceHandleDEV` is intentionally omitted — DEV-only.
+ */
+const INSTANCE_FIBER_KEYS = ['_reactInternals',
+// class / pre-19 / Fabric & Paper prod
+'_reactInternalFiber',
+// legacy
+'__internalInstanceHandle',
+// Fabric public instance (RN 0.7x+)
+'_internalInstanceHandle' // older Fabric / Paper bridge
+];
+
+/** Resolve a fiber from a class or host public instance. Returns null when unavailable. */
+export function fiberFromPublicInstance(instance) {
+  if (!instance || typeof instance !== 'object') return null;
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const inst = instance;
+    for (const key of INSTANCE_FIBER_KEYS) {
+      const handle = inst[key];
+      if (handle) return handle;
+    }
+  } catch {
+    // Feature-detection must itself never throw.
+  }
+  return null;
+}
+
+/**
+ * Pick the "current" tree fiber between `fiber` and its alternate by walking
+ * to the HostRoot and comparing against `root.stateNode.current`.
+ *
+ * Returns the input fiber when the root cannot be resolved (best-effort).
+ */
+export function resolveCurrentFiber(fiber) {
+  if (!fiber) return fiber;
+  try {
+    const alternate = getAlternate(fiber);
+    if (!alternate) return fiber;
+    let cur = fiber;
+    for (let depth = 0; cur && depth < MAX_ANCESTOR_WALK; depth += 1) {
+      if (getFiberTag(cur) === HOST_ROOT_TAG) {
+        const rootState = getStateNode(cur);
+        const currentRoot = rootState?.current;
+        if (!currentRoot) return fiber;
+        // Walk both candidates upward; whichever lands on currentRoot is live.
+        if (isInTree(fiber, currentRoot)) return fiber;
+        if (isInTree(alternate, currentRoot)) return alternate;
+        return fiber;
+      }
+      cur = getReturn(cur);
+    }
+  } catch {
+    // Best-effort.
+  }
+  return fiber;
+}
+function isInTree(fiber, root) {
+  let cur = fiber;
+  for (let depth = 0; cur && depth < MAX_ANCESTOR_WALK; depth += 1) {
+    if (cur === root) return true;
+    cur = getReturn(cur);
+  }
+  return false;
+}
+
+/**
+ * True when a previously-resolved fiber is still attached to a live tree
+ * (has a return path, or is itself a HostRoot).
+ */
+export function isFiberMounted(fiber) {
+  if (!fiber) return false;
+  try {
+    if (getFiberTag(fiber) === HOST_ROOT_TAG) return true;
+    // A fiber with no return is detached (unless HostRoot, handled above).
+    return getReturn(fiber) != null;
+  } catch {
+    return false;
+  }
+}
+//# sourceMappingURL=fiberInternals.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["HOST_COMPONENT_TAG","HOST_ROOT_TAG","MAX_ANCESTOR_WALK","HOST_STATE_NODE_KEYS","getChild","fiber","child","getSibling","sibling","getReturn","return","getAlternate","alternate","getMemoizedProps","p","memoizedProps","undefined","getStateNode","stateNode","getFiberTag","t","tag","getHostTypeName","type","isHostFiber","node","n","k","measure","measureInWindow","measureLayout","INSTANCE_FIBER_KEYS","fiberFromPublicInstance","instance","inst","key","handle","resolveCurrentFiber","cur","depth","rootState","currentRoot","current","isInTree","root","isFiberMounted"],"sourceRoot":"../../../../src","sources":["anchors/fiber/fiberInternals.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA;AACA;;AAGA;AACA,MAAMA,kBAAkB,GAAG,CAAC;;AAE5B;AACA,MAAMC,aAAa,GAAG,CAAC;;AAEvB;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,iBAAiB,GAAG,MAAM;;AAEvC;AACA,MAAMC,oBAAoB,GAAG,CAC3B,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,WAAW,EACX,yBAAyB,EACzB,MAAM,EACN,WAAW,CACH;AAEV,OAAO,SAASC,QAAQA,CAACC,KAAe,EAAmB;EACzD,OAAOA,KAAK,EAAEC,KAAK,IAAI,IAAI;AAC7B;AAEA,OAAO,SAASC,UAAUA,CAACF,KAAe,EAAmB;EAC3D,OAAOA,KAAK,EAAEG,OAAO,IAAI,IAAI;AAC/B;AAEA,OAAO,SAASC,SAASA,CAACJ,KAAe,EAAmB;EAC1D,OAAOA,KAAK,EAAEK,MAAM,IAAI,IAAI;AAC9B;AAEA,OAAO,SAASC,YAAYA,CAACN,KAAe,EAAmB;EAC7D,OAAOA,KAAK,EAAEO,SAAS,IAAI,IAAI;AACjC;AAEA,OAAO,SAASC,gBAAgBA,CAACR,KAAe,EAAuC;EACrF,MAAMS,CAAC,GAAGT,KAAK,EAAEU,aAAa;EAC9B,OAAOD,CAAC,IAAI,OAAOA,CAAC,KAAK,QAAQ,GAAIA,CAAC,GAA+BE,SAAS;AAChF;AAEA,OAAO,SAASC,YAAYA,CAACZ,KAAe,EAAW;EACrD,OAAOA,KAAK,EAAEa,SAAS,IAAI,IAAI;AACjC;AAEA,OAAO,SAASC,WAAWA,CAACd,KAAe,EAAsB;EAC/D,MAAMe,CAAC,GAAGf,KAAK,EAAEgB,GAAG;EACpB,OAAO,OAAOD,CAAC,KAAK,QAAQ,GAAGA,CAAC,GAAGJ,SAAS;AAC9C;;AAEA;AACA,OAAO,SAASM,eAAeA,CAACjB,KAAe,EAAsB;EACnE,MAAMe,CAAC,GAAGf,KAAK,EAAEkB,IAAI;EACrB,OAAO,OAAOH,CAAC,KAAK,QAAQ,GAAGA,CAAC,GAAGJ,SAAS;AAC9C;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASQ,WAAWA,CAACnB,KAAe,EAAW;EACpD,MAAMoB,IAAI,GAAGpB,KAAK,EAAEa,SAAS;EAC7B,IAAIO,IAAI,IAAI,OAAOA,IAAI,KAAK,QAAQ,EAAE;IACpC;IACA,MAAMC,CAAC,GAAGD,IAAW;IACrB,KAAK,MAAME,CAAC,IAAIxB,oBAAoB,EAAE;MACpC,IAAIwB,CAAC,IAAIF,IAAI,EAAE,OAAO,IAAI;IAC5B;IACA,IACE,OAAOC,CAAC,CAACE,OAAO,KAAK,UAAU,IAC/B,OAAOF,CAAC,CAACG,eAAe,KAAK,UAAU,IACvC,OAAOH,CAAC,CAACI,aAAa,KAAK,UAAU,EACrC;MACA,OAAO,IAAI;IACb;EACF;EACA,OAAOX,WAAW,CAACd,KAAK,CAAC,KAAKL,kBAAkB;AAClD;;AAEA;AACA;AACA;AACA;AACA,MAAM+B,mBAAmB,GAAG,CAC1B,iBAAiB;AAAE;AACnB,qBAAqB;AAAE;AACvB,0BAA0B;AAAE;AAC5B,yBAAyB,CAAE;AAAA,CACnB;;AAEV;AACA,OAAO,SAASC,uBAAuBA,CAACC,QAAiB,EAAmB;EAC1E,IAAI,CAACA,QAAQ,IAAI,OAAOA,QAAQ,KAAK,QAAQ,EAAE,OAAO,IAAI;EAC1D,IAAI;IACF;IACA,MAAMC,IAAI,GAAGD,QAAe;IAC5B,KAAK,MAAME,GAAG,IAAIJ,mBAAmB,EAAE;MACrC,MAAMK,MAAM,GAAGF,IAAI,CAACC,GAAG,CAAC;MACxB,IAAIC,MAAM,EAAE,OAAOA,MAAM;IAC3B;EACF,CAAC,CAAC,MAAM;IACN;EAAA;EAEF,OAAO,IAAI;AACb;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,mBAAmBA,CAAChC,KAAe,EAAY;EAC7D,IAAI,CAACA,KAAK,EAAE,OAAOA,KAAK;EACxB,IAAI;IACF,MAAMO,SAAS,GAAGD,YAAY,CAACN,KAAK,CAAC;IACrC,IAAI,CAACO,SAAS,EAAE,OAAOP,KAAK;IAE5B,IAAIiC,GAAa,GAAGjC,KAAK;IACzB,KAAK,IAAIkC,KAAK,GAAG,CAAC,EAAED,GAAG,IAAIC,KAAK,GAAGrC,iBAAiB,EAAEqC,KAAK,IAAI,CAAC,EAAE;MAChE,IAAIpB,WAAW,CAACmB,GAAG,CAAC,KAAKrC,aAAa,EAAE;QACtC,MAAMuC,SAAS,GAAGvB,YAAY,CAACqB,GAAG,CAAkC;QACpE,MAAMG,WAAW,GAAGD,SAAS,EAAEE,OAAO;QACtC,IAAI,CAACD,WAAW,EAAE,OAAOpC,KAAK;QAC9B;QACA,IAAIsC,QAAQ,CAACtC,KAAK,EAAEoC,WAAW,CAAC,EAAE,OAAOpC,KAAK;QAC9C,IAAIsC,QAAQ,CAAC/B,SAAS,EAAE6B,WAAW,CAAC,EAAE,OAAO7B,SAAS;QACtD,OAAOP,KAAK;MACd;MACAiC,GAAG,GAAG7B,SAAS,CAAC6B,GAAG,CAAC;IACtB;EACF,CAAC,CAAC,MAAM;IACN;EAAA;EAEF,OAAOjC,KAAK;AACd;AAEA,SAASsC,QAAQA,CAACtC,KAAe,EAAEuC,IAAc,EAAW;EAC1D,IAAIN,GAAa,GAAGjC,KAAK;EACzB,KAAK,IAAIkC,KAAK,GAAG,CAAC,EAAED,GAAG,IAAIC,KAAK,GAAGrC,iBAAiB,EAAEqC,KAAK,IAAI,CAAC,EAAE;IAChE,IAAID,GAAG,KAAKM,IAAI,EAAE,OAAO,IAAI;IAC7BN,GAAG,GAAG7B,SAAS,CAAC6B,GAAG,CAAC;EACtB;EACA,OAAO,KAAK;AACd;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASO,cAAcA,CAACxC,KAAe,EAAW;EACvD,IAAI,CAACA,KAAK,EAAE,OAAO,KAAK;EACxB,IAAI;IACF,IAAIc,WAAW,CAACd,KAAK,CAAC,KAAKJ,aAAa,EAAE,OAAO,IAAI;IACrD;IACA,OAAOQ,SAAS,CAACJ,KAAK,CAAC,IAAI,IAAI;EACjC,CAAC,CAAC,MAAM;IACN,OAAO,KAAK;EACd;AACF","ignoreList":[]}