@userflow-tech/react-native 0.1.0

package/lib/module/anchors/hintsCodec.js

@@ -0,0 +1,111 @@
+"use strict";
+
+import { roleForKind } from "./AutoAnchorRegistry.js";
+
+/**
+ * Compact build-time hints wire format (v1) emitted by `@userflow-tech/babel-plugin`.
+ * Expanded once at register time so the auto-anchor registry still sees full paths.
+ */
+export const COMPACT_HINTS_VERSION = 1;
+export function isCompactHints(value) {
+  return typeof value === 'object' && value !== null && value.v === COMPACT_HINTS_VERSION && typeof value.n === 'string' && typeof value.p === 'string';
+}
+export function isLegacyBuildTimeHints(value) {
+  return typeof value === 'object' && value !== null && typeof value.ufid === 'string' && typeof value.nativeId === 'string' && value.v !== COMPACT_HINTS_VERSION;
+}
+
+/** True when the value is either compact v1 or legacy long-key hints. */
+export function isHintsInput(value) {
+  return isCompactHints(value) || isLegacyBuildTimeHints(value);
+}
+
+/**
+ * Parse path segments after `module::Component > …` into ancestor descriptors
+ * (everything except the leaf). Matches Babel `formatSegment` output.
+ */
+export function parseAncestorsFromPath(path) {
+  const parts = path.split(' > ');
+  if (parts.length <= 1) return [];
+  const ancestorParts = parts.slice(1, -1);
+  const out = [];
+  for (const part of ancestorParts) {
+    const seg = parsePathSegment(part);
+    if (seg) out.push(seg);
+  }
+  return out;
+}
+const SEGMENT_RE = /^([A-Za-z_][\w.]*)(?:\{(userflowId|testID|nativeID|key)=([^}]*)\}|#(\d+))?$/;
+export function parsePathSegment(part) {
+  const m = SEGMENT_RE.exec(part.trim());
+  if (!m) return null;
+  const kind = m[1];
+  const role = roleForKind(kind);
+  const idKey = m[2];
+  const idVal = m[3];
+  const ordinalRaw = m[4];
+  const seg = {
+    kind,
+    role
+  };
+  if (idKey === 'userflowId' && idVal !== undefined) seg.userflowId = idVal;else if (idKey === 'testID' && idVal !== undefined) seg.testID = idVal;else if (idKey === 'nativeID' && idVal !== undefined) seg.nativeID = idVal;else if (idKey === 'key' && idVal !== undefined) seg.key = idVal;else if (ordinalRaw !== undefined) seg.ordinal = Number(ordinalRaw);
+  return seg;
+}
+
+/**
+ * Expand compact (or legacy) hints into the full `BuildTimeHints` shape used
+ * by AutoAnchorRegistry.
+ */
+export function expandBuildTimeHints(input, kind) {
+  if (isLegacyBuildTimeHints(input)) {
+    const role = input.role ?? (kind ? roleForKind(kind) : undefined);
+    return {
+      ...input,
+      structuralPath: input.structuralPath ?? input.ufid,
+      templatePath: input.templatePath ?? input.ufid,
+      ...(role ? {
+        role
+      } : {}),
+      ancestors: input.ancestors ?? parseAncestorsFromPath(input.structuralPath ?? input.ufid)
+    };
+  }
+  const path = input.p;
+  const role = kind ? roleForKind(kind) : undefined;
+  return {
+    ufid: path,
+    nativeId: input.n,
+    structuralPath: path,
+    templatePath: path,
+    ...(input.ct !== undefined ? {
+      childText: input.ct
+    } : {}),
+    ...(input.cs !== undefined ? {
+      childShape: input.cs
+    } : {}),
+    ...(input.icn !== undefined ? {
+      iconName: input.icn
+    } : {}),
+    ...(input.img !== undefined ? {
+      imageSrc: input.img
+    } : {}),
+    ...(input.o !== undefined ? {
+      ordinal: input.o
+    } : {}),
+    ...(input.si !== undefined ? {
+      siblingIndex: input.si
+    } : {}),
+    ...(input.tid !== undefined ? {
+      literalTestId: input.tid
+    } : {}),
+    ...(input.uid !== undefined ? {
+      literalUserflowId: input.uid
+    } : {}),
+    ...(input.lid !== undefined ? {
+      literalLabel: input.lid
+    } : {}),
+    ...(role ? {
+      role
+    } : {}),
+    ancestors: parseAncestorsFromPath(path)
+  };
+}
+//# sourceMappingURL=hintsCodec.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["roleForKind","COMPACT_HINTS_VERSION","isCompactHints","value","v","n","p","isLegacyBuildTimeHints","ufid","nativeId","isHintsInput","parseAncestorsFromPath","path","parts","split","length","ancestorParts","slice","out","part","seg","parsePathSegment","push","SEGMENT_RE","m","exec","trim","kind","role","idKey","idVal","ordinalRaw","undefined","userflowId","testID","nativeID","key","ordinal","Number","expandBuildTimeHints","input","structuralPath","templatePath","ancestors","ct","childText","cs","childShape","icn","iconName","img","imageSrc","o","si","siblingIndex","tid","literalTestId","uid","literalUserflowId","lid","literalLabel"],"sourceRoot":"../../../src","sources":["anchors/hintsCodec.ts"],"mappings":";;AAEA,SAASA,WAAW,QAA6B,yBAAsB;;AAEvE;AACA;AACA;AACA;AACA,OAAO,MAAMC,qBAAqB,GAAG,CAAU;AAqB/C,OAAO,SAASC,cAAcA,CAACC,KAAc,EAAkC;EAC7E,OACE,OAAOA,KAAK,KAAK,QAAQ,IACzBA,KAAK,KAAK,IAAI,IACbA,KAAK,CAA2BC,CAAC,KAAKH,qBAAqB,IAC5D,OAAQE,KAAK,CAA2BE,CAAC,KAAK,QAAQ,IACtD,OAAQF,KAAK,CAA2BG,CAAC,KAAK,QAAQ;AAE1D;AAEA,OAAO,SAASC,sBAAsBA,CAACJ,KAAc,EAA2B;EAC9E,OACE,OAAOA,KAAK,KAAK,QAAQ,IACzBA,KAAK,KAAK,IAAI,IACd,OAAQA,KAAK,CAAoBK,IAAI,KAAK,QAAQ,IAClD,OAAQL,KAAK,CAAoBM,QAAQ,KAAK,QAAQ,IACrDN,KAAK,CAA2BC,CAAC,KAAKH,qBAAqB;AAEhE;;AAEA;AACA,OAAO,SAASS,YAAYA,CAACP,KAAc,EAAuB;EAChE,OAAOD,cAAc,CAACC,KAAK,CAAC,IAAII,sBAAsB,CAACJ,KAAK,CAAC;AAC/D;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASQ,sBAAsBA,CAACC,IAAY,EAAqB;EACtE,MAAMC,KAAK,GAAGD,IAAI,CAACE,KAAK,CAAC,KAAK,CAAC;EAC/B,IAAID,KAAK,CAACE,MAAM,IAAI,CAAC,EAAE,OAAO,EAAE;EAChC,MAAMC,aAAa,GAAGH,KAAK,CAACI,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;EACxC,MAAMC,GAAsB,GAAG,EAAE;EACjC,KAAK,MAAMC,IAAI,IAAIH,aAAa,EAAE;IAChC,MAAMI,GAAG,GAAGC,gBAAgB,CAACF,IAAI,CAAC;IAClC,IAAIC,GAAG,EAAEF,GAAG,CAACI,IAAI,CAACF,GAAG,CAAC;EACxB;EACA,OAAOF,GAAG;AACZ;AAEA,MAAMK,UAAU,GAAG,6EAA6E;AAEhG,OAAO,SAASF,gBAAgBA,CAACF,IAAY,EAA0B;EACrE,MAAMK,CAAC,GAAGD,UAAU,CAACE,IAAI,CAACN,IAAI,CAACO,IAAI,CAAC,CAAC,CAAC;EACtC,IAAI,CAACF,CAAC,EAAE,OAAO,IAAI;EACnB,MAAMG,IAAI,GAAGH,CAAC,CAAC,CAAC,CAAE;EAClB,MAAMI,IAAI,GAAG5B,WAAW,CAAC2B,IAAI,CAAiB;EAC9C,MAAME,KAAK,GAAGL,CAAC,CAAC,CAAC,CAAC;EAClB,MAAMM,KAAK,GAAGN,CAAC,CAAC,CAAC,CAAC;EAClB,MAAMO,UAAU,GAAGP,CAAC,CAAC,CAAC,CAAC;EACvB,MAAMJ,GAAoB,GAAG;IAAEO,IAAI;IAAEC;EAAK,CAAC;EAC3C,IAAIC,KAAK,KAAK,YAAY,IAAIC,KAAK,KAAKE,SAAS,EAAEZ,GAAG,CAACa,UAAU,GAAGH,KAAK,CAAC,KACrE,IAAID,KAAK,KAAK,QAAQ,IAAIC,KAAK,KAAKE,SAAS,EAAEZ,GAAG,CAACc,MAAM,GAAGJ,KAAK,CAAC,KAClE,IAAID,KAAK,KAAK,UAAU,IAAIC,KAAK,KAAKE,SAAS,EAAEZ,GAAG,CAACe,QAAQ,GAAGL,KAAK,CAAC,KACtE,IAAID,KAAK,KAAK,KAAK,IAAIC,KAAK,KAAKE,SAAS,EAAEZ,GAAG,CAACgB,GAAG,GAAGN,KAAK,CAAC,KAC5D,IAAIC,UAAU,KAAKC,SAAS,EAAEZ,GAAG,CAACiB,OAAO,GAAGC,MAAM,CAACP,UAAU,CAAC;EACnE,OAAOX,GAAG;AACZ;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASmB,oBAAoBA,CAACC,KAAiB,EAAEb,IAAa,EAAkB;EACrF,IAAIpB,sBAAsB,CAACiC,KAAK,CAAC,EAAE;IACjC,MAAMZ,IAAI,GAAGY,KAAK,CAACZ,IAAI,KAAKD,IAAI,GAAG3B,WAAW,CAAC2B,IAAI,CAAC,GAAGK,SAAS,CAAC;IACjE,OAAO;MACL,GAAGQ,KAAK;MACRC,cAAc,EAAED,KAAK,CAACC,cAAc,IAAID,KAAK,CAAChC,IAAI;MAClDkC,YAAY,EAAEF,KAAK,CAACE,YAAY,IAAIF,KAAK,CAAChC,IAAI;MAC9C,IAAIoB,IAAI,GAAG;QAAEA;MAAK,CAAC,GAAG,CAAC,CAAC,CAAC;MACzBe,SAAS,EAAEH,KAAK,CAACG,SAAS,IAAIhC,sBAAsB,CAAC6B,KAAK,CAACC,cAAc,IAAID,KAAK,CAAChC,IAAI;IACzF,CAAC;EACH;EAEA,MAAMI,IAAI,GAAG4B,KAAK,CAAClC,CAAC;EACpB,MAAMsB,IAAI,GAAGD,IAAI,GAAG3B,WAAW,CAAC2B,IAAI,CAAC,GAAGK,SAAS;EACjD,OAAO;IACLxB,IAAI,EAAEI,IAAI;IACVH,QAAQ,EAAE+B,KAAK,CAACnC,CAAC;IACjBoC,cAAc,EAAE7B,IAAI;IACpB8B,YAAY,EAAE9B,IAAI;IAClB,IAAI4B,KAAK,CAACI,EAAE,KAAKZ,SAAS,GAAG;MAAEa,SAAS,EAAEL,KAAK,CAACI;IAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1D,IAAIJ,KAAK,CAACM,EAAE,KAAKd,SAAS,GAAG;MAAEe,UAAU,EAAEP,KAAK,CAACM;IAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,IAAIN,KAAK,CAACQ,GAAG,KAAKhB,SAAS,GAAG;MAAEiB,QAAQ,EAAET,KAAK,CAACQ;IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,IAAIR,KAAK,CAACU,GAAG,KAAKlB,SAAS,GAAG;MAAEmB,QAAQ,EAAEX,KAAK,CAACU;IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3D,IAAIV,KAAK,CAACY,CAAC,KAAKpB,SAAS,GAAG;MAAEK,OAAO,EAAEG,KAAK,CAACY;IAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,IAAIZ,KAAK,CAACa,EAAE,KAAKrB,SAAS,GAAG;MAAEsB,YAAY,EAAEd,KAAK,CAACa;IAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7D,IAAIb,KAAK,CAACe,GAAG,KAAKvB,SAAS,GAAG;MAAEwB,aAAa,EAAEhB,KAAK,CAACe;IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAChE,IAAIf,KAAK,CAACiB,GAAG,KAAKzB,SAAS,GAAG;MAAE0B,iBAAiB,EAAElB,KAAK,CAACiB;IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACpE,IAAIjB,KAAK,CAACmB,GAAG,KAAK3B,SAAS,GAAG;MAAE4B,YAAY,EAAEpB,KAAK,CAACmB;IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,IAAI/B,IAAI,GAAG;MAAEA;IAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACzBe,SAAS,EAAEhC,sBAAsB,CAACC,IAAI;EACxC,CAAC;AACH","ignoreList":[]}

package/lib/module/anchors/resolveAnchorHost.js

@@ -0,0 +1,105 @@
+"use strict";
+
+import { anchorRegistry } from "./AnchorRegistry.js";
+import { fiberScanRoot } from "./fiber/FiberScanRoot.js";
+import { isFiberMounted } from "./fiber/fiberInternals.js";
+import { findAnchorFiber } from "./fiber/findAnchorFiber.js";
+import { createFiberMeasureInWindow } from "./fiber/measureHostFiber.js";
+import { isFiberOnVisibleScreen } from "./fiber/visibleScreens.js";
+const fiberCache = new Map();
+let currentScreenKey = null;
+
+/** Invalidate fiber-resolved anchors when the active screen changes. */
+export function notifyAnchorScreenChange(screenKey) {
+  if (screenKey === currentScreenKey) return;
+  currentScreenKey = screenKey;
+  fiberCache.clear();
+}
+
+/** Test helper — drop the fiber cache. */
+export function clearFiberAnchorCache() {
+  fiberCache.clear();
+}
+
+/**
+ * Resolve a MANUAL anchor id to a measurable host.
+ *
+ * Tier 0: {@link anchorRegistry} (`useUserflowAnchor`) — higher priority, fails
+ * closed on ambiguous registry keys.
+ * Tier 1+: fiber scan for `testID`, then `nativeID`, then `accessibilityLabel`.
+ *
+ * Synchronous (the walk is pure JS; only measurement is async via the returned
+ * host). Caches the resolved fiber per id and revalidates cheaply before reuse.
+ */
+export function resolveAnchorHost(id) {
+  if (!id) return {
+    status: 'missing'
+  };
+
+  // Tier 0 — explicit manual anchors win.
+  if (anchorRegistry.isAmbiguous(id)) {
+    return {
+      status: 'ambiguous'
+    };
+  }
+  const registered = anchorRegistry.get(id);
+  if (registered) {
+    return {
+      status: 'found',
+      host: registered
+    };
+  }
+
+  // Cached fiber still mounted, on the same screen, and not covered by a screen
+  // pushed on top since it was cached?
+  const cached = fiberCache.get(id);
+  if (cached && cached.screenKey === currentScreenKey && isFiberMounted(cached.fiber) && isFiberOnVisibleScreen(cached.fiber)) {
+    return {
+      status: 'found',
+      host: {
+        measureInWindow: createFiberMeasureInWindow(cached.fiber)
+      },
+      fiber: cached.fiber
+    };
+  }
+  if (cached) {
+    fiberCache.delete(id);
+  }
+  const root = fiberScanRoot.getFiber();
+  if (!root) {
+    return {
+      status: 'missing'
+    };
+  }
+  const result = findAnchorFiber(root, id);
+  if (result.status === 'ambiguous') {
+    return {
+      status: 'ambiguous'
+    };
+  }
+  if (result.status === 'missing') {
+    return {
+      status: 'missing'
+    };
+  }
+  fiberCache.set(id, {
+    fiber: result.fiber,
+    screenKey: currentScreenKey
+  });
+  return {
+    status: 'found',
+    host: {
+      measureInWindow: createFiberMeasureInWindow(result.fiber)
+    },
+    fiber: result.fiber
+  };
+}
+
+/**
+ * Drop a cached fiber entry after a zero-size measure so the next resolve
+ * re-scans (the host may have remounted under a new fiber).
+ */
+export function invalidateFiberAnchor(id) {
+  fiberCache.delete(id);
+}
+//# sourceMappingURL=resolveAnchorHost.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["anchorRegistry","fiberScanRoot","isFiberMounted","findAnchorFiber","createFiberMeasureInWindow","isFiberOnVisibleScreen","fiberCache","Map","currentScreenKey","notifyAnchorScreenChange","screenKey","clear","clearFiberAnchorCache","resolveAnchorHost","id","status","isAmbiguous","registered","get","host","cached","fiber","measureInWindow","delete","root","getFiber","result","set","invalidateFiberAnchor"],"sourceRoot":"../../../src","sources":["anchors/resolveAnchorHost.ts"],"mappings":";;AAAA,SAA0BA,cAAc,QAAQ,qBAAkB;AAClE,SAASC,aAAa,QAAQ,0BAAuB;AAErD,SAASC,cAAc,QAAQ,2BAAwB;AACvD,SAASC,eAAe,QAAQ,4BAAyB;AACzD,SAASC,0BAA0B,QAAQ,6BAA0B;AACrE,SAASC,sBAAsB,QAAQ,2BAAwB;AAY/D,MAAMC,UAAU,GAAG,IAAIC,GAAG,CAA0B,CAAC;AACrD,IAAIC,gBAA+B,GAAG,IAAI;;AAE1C;AACA,OAAO,SAASC,wBAAwBA,CAACC,SAAwB,EAAQ;EACvE,IAAIA,SAAS,KAAKF,gBAAgB,EAAE;EACpCA,gBAAgB,GAAGE,SAAS;EAC5BJ,UAAU,CAACK,KAAK,CAAC,CAAC;AACpB;;AAEA;AACA,OAAO,SAASC,qBAAqBA,CAAA,EAAS;EAC5CN,UAAU,CAACK,KAAK,CAAC,CAAC;AACpB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASE,iBAAiBA,CAACC,EAAU,EAAoB;EAC9D,IAAI,CAACA,EAAE,EAAE,OAAO;IAAEC,MAAM,EAAE;EAAU,CAAC;;EAErC;EACA,IAAIf,cAAc,CAACgB,WAAW,CAACF,EAAE,CAAC,EAAE;IAClC,OAAO;MAAEC,MAAM,EAAE;IAAY,CAAC;EAChC;EACA,MAAME,UAAU,GAAGjB,cAAc,CAACkB,GAAG,CAACJ,EAAE,CAAC;EACzC,IAAIG,UAAU,EAAE;IACd,OAAO;MAAEF,MAAM,EAAE,OAAO;MAAEI,IAAI,EAAEF;IAAW,CAAC;EAC9C;;EAEA;EACA;EACA,MAAMG,MAAM,GAAGd,UAAU,CAACY,GAAG,CAACJ,EAAE,CAAC;EACjC,IACEM,MAAM,IACNA,MAAM,CAACV,SAAS,KAAKF,gBAAgB,IACrCN,cAAc,CAACkB,MAAM,CAACC,KAAK,CAAC,IAC5BhB,sBAAsB,CAACe,MAAM,CAACC,KAAK,CAAC,EACpC;IACA,OAAO;MACLN,MAAM,EAAE,OAAO;MACfI,IAAI,EAAE;QAAEG,eAAe,EAAElB,0BAA0B,CAACgB,MAAM,CAACC,KAAK;MAAE,CAAC;MACnEA,KAAK,EAAED,MAAM,CAACC;IAChB,CAAC;EACH;EACA,IAAID,MAAM,EAAE;IACVd,UAAU,CAACiB,MAAM,CAACT,EAAE,CAAC;EACvB;EAEA,MAAMU,IAAI,GAAGvB,aAAa,CAACwB,QAAQ,CAAC,CAAC;EACrC,IAAI,CAACD,IAAI,EAAE;IACT,OAAO;MAAET,MAAM,EAAE;IAAU,CAAC;EAC9B;EAEA,MAAMW,MAAM,GAAGvB,eAAe,CAACqB,IAAI,EAAEV,EAAE,CAAC;EACxC,IAAIY,MAAM,CAACX,MAAM,KAAK,WAAW,EAAE;IACjC,OAAO;MAAEA,MAAM,EAAE;IAAY,CAAC;EAChC;EACA,IAAIW,MAAM,CAACX,MAAM,KAAK,SAAS,EAAE;IAC/B,OAAO;MAAEA,MAAM,EAAE;IAAU,CAAC;EAC9B;EAEAT,UAAU,CAACqB,GAAG,CAACb,EAAE,EAAE;IAAEO,KAAK,EAAEK,MAAM,CAACL,KAAK;IAAEX,SAAS,EAAEF;EAAiB,CAAC,CAAC;EACxE,OAAO;IACLO,MAAM,EAAE,OAAO;IACfI,IAAI,EAAE;MAAEG,eAAe,EAAElB,0BAA0B,CAACsB,MAAM,CAACL,KAAK;IAAE,CAAC;IACnEA,KAAK,EAAEK,MAAM,CAACL;EAChB,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASO,qBAAqBA,CAACd,EAAU,EAAQ;EACtDR,UAAU,CAACiB,MAAM,CAACT,EAAE,CAAC;AACvB","ignoreList":[]}

package/lib/module/anchors/resolveManualAnchorId.js

@@ -0,0 +1,13 @@
+"use strict";
+
+/**
+ * Resolve a manual tooltip target id from `FlowSelectorFragment.css`.
+ * Web MANUAL fixtures use `#save-button`; strip a leading `#`.
+ */
+export function resolveManualAnchorId(css) {
+  if (css == null) return null;
+  const trimmed = css.trim();
+  if (!trimmed) return null;
+  return trimmed.startsWith('#') ? trimmed.slice(1) : trimmed;
+}
+//# sourceMappingURL=resolveManualAnchorId.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["resolveManualAnchorId","css","trimmed","trim","startsWith","slice"],"sourceRoot":"../../../src","sources":["anchors/resolveManualAnchorId.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA,OAAO,SAASA,qBAAqBA,CAACC,GAA8B,EAAiB;EACnF,IAAIA,GAAG,IAAI,IAAI,EAAE,OAAO,IAAI;EAC5B,MAAMC,OAAO,GAAGD,GAAG,CAACE,IAAI,CAAC,CAAC;EAC1B,IAAI,CAACD,OAAO,EAAE,OAAO,IAAI;EACzB,OAAOA,OAAO,CAACE,UAAU,CAAC,GAAG,CAAC,GAAGF,OAAO,CAACG,KAAK,CAAC,CAAC,CAAC,GAAGH,OAAO;AAC7D","ignoreList":[]}

package/lib/module/anchors/scrollAnchorIntoView.js

@@ -0,0 +1,222 @@
+"use strict";
+
+/**
+ * Scroll a tooltip anchor into view by walking fiber scroll ancestors
+ * (or an explicit scroll-container registry override).
+ *
+ * Content offset is derived from two `measureInWindow` calls — container
+ * origin minus content origin — so the host app does not need to wire
+ * `onScroll`. Semantics match web `scrollIntoView({ block: 'nearest' })`:
+ * the minimal delta that brings the padded target fully inside the viewport.
+ */
+
+import { scrollContainerRegistry } from "./ScrollContainerRegistry.js";
+import { findScrollAncestors } from "./fiber/findScrollAncestors.js";
+import { measureHostFiber } from "./fiber/measureHostFiber.js";
+import { getCustomScrollIntoView, getScrollPadding } from "./scrollConfig.js";
+
+/** Padding applied inside a scroll container when bringing a target into view. */
+const INTO_VIEW_PADDING = 24;
+/**
+ * Best-effort scroll so `opts.rect` becomes fully visible.
+ *
+ * Order:
+ * 1. `setCustomScrollIntoView` override (replaces everything)
+ * 2. Explicit `useUserflowScrollContainer` registry (opt-in override)
+ * 3. Fiber scroll-ancestor walk (automatic for testID anchors)
+ * 4. `host.scrollIntoView` (RN Web / DOM)
+ *
+ * Returns `true` when at least one scroll was attempted.
+ */
+export function scrollAnchorIntoView(opts) {
+  const {
+    rect,
+    host,
+    fiber
+  } = opts;
+  const custom = getCustomScrollIntoView();
+  if (custom) {
+    try {
+      custom({
+        rect,
+        measureInWindow: host.measureInWindow.bind(host)
+      });
+    } catch {
+      // Best-effort.
+    }
+    return true;
+  }
+  let attempted = false;
+
+  // Explicit registry wins over the fiber walk (mirrors anchorRegistry vs scan).
+  if (scrollContainerRegistry.list().length > 0) {
+    try {
+      scrollContainerRegistry.scrollTargetIntoView(rect);
+      attempted = true;
+    } catch {
+      // Fall through.
+    }
+  } else if (fiber) {
+    attempted = scrollFiberAncestors(fiber, rect) || attempted;
+  }
+  if (typeof host.scrollIntoView === 'function') {
+    try {
+      host.scrollIntoView();
+      attempted = true;
+    } catch {
+      // Best-effort.
+    }
+  }
+  return attempted;
+}
+
+/**
+ * Drive every scroll ancestor of `fiber`, innermost first, so nested
+ * scrollers compose correctly.
+ */
+export function scrollFiberAncestors(fiber, target) {
+  const ancestors = findScrollAncestors(fiber);
+  if (ancestors.length === 0) return false;
+  const padding = mergePadding(getScrollPadding());
+  let attempted = false;
+  for (const ancestor of ancestors) {
+    if (scrollOneAncestor(ancestor, target, padding)) {
+      attempted = true;
+    }
+  }
+  return attempted;
+}
+function mergePadding(configured) {
+  return {
+    top: (configured?.top ?? 0) + INTO_VIEW_PADDING,
+    right: (configured?.right ?? 0) + INTO_VIEW_PADDING,
+    bottom: (configured?.bottom ?? 0) + INTO_VIEW_PADDING,
+    left: (configured?.left ?? 0) + INTO_VIEW_PADDING
+  };
+}
+function scrollOneAncestor(ancestor, target, padding) {
+  const {
+    instance,
+    containerFiber,
+    contentFiber,
+    horizontal
+  } = ancestor;
+
+  // Need both fibers to derive offset from measure. Without them, try a
+  // best-effort scrollTo that assumes offset 0 (first paint / unmounted content).
+  if (!containerFiber) {
+    return scrollWithAssumedOffset(instance, target, padding, horizontal, {
+      x: 0,
+      y: 0
+    }, null);
+  }
+
+  // measureInWindow is async on Paper — fire-and-forget; callers treat a
+  // kicked-off measure as an attempted scroll.
+  measureHostFiber(containerFiber, (cx, cy, cw, ch) => {
+    if (cw <= 0 || ch <= 0) return;
+    const finish = (offsetX, offsetY) => {
+      scrollWithAssumedOffset(instance, target, padding, horizontal, {
+        x: Math.max(0, offsetX),
+        y: Math.max(0, offsetY)
+      }, {
+        x: cx,
+        y: cy,
+        width: cw,
+        height: ch
+      });
+    };
+    if (!contentFiber) {
+      finish(0, 0);
+      return;
+    }
+    measureHostFiber(contentFiber, (contentX, contentY) => {
+      // Content is translated up/left by the scroll offset.
+      const offsetY = cy - contentY;
+      const offsetX = cx - contentX;
+      finish(offsetX, offsetY);
+    });
+  });
+  return true;
+}
+function scrollWithAssumedOffset(instance, target, padding, horizontal, offset, container) {
+  // Without a measured container, we can only nudge based on window-space
+  // heuristics via scrollToOffset-style APIs when the target is clearly
+  // off-screen relative to a zero origin — skip rather than guess badly.
+  if (!container) {
+    return false;
+  }
+  const targetContentY = offset.y + (target.y - container.y);
+  const targetContentX = offset.x + (target.x - container.x);
+  let nextY = null;
+  let nextX = null;
+  if (target.y < container.y + padding.top) {
+    nextY = Math.max(0, targetContentY - padding.top);
+  } else if (target.y + target.height > container.y + container.height - padding.bottom) {
+    nextY = Math.max(0, targetContentY + target.height - container.height + padding.bottom);
+  }
+  if (target.x < container.x + padding.left) {
+    nextX = Math.max(0, targetContentX - padding.left);
+  } else if (target.x + target.width > container.x + container.width - padding.right) {
+    nextX = Math.max(0, targetContentX + target.width - container.width + padding.right);
+  }
+  const yChanged = nextY != null && Math.abs(nextY - offset.y) >= 1;
+  const xChanged = nextX != null && Math.abs(nextX - offset.x) >= 1;
+  if (!yChanged && !xChanged) return false;
+  const y = yChanged ? nextY : offset.y;
+  const x = xChanged ? nextX : offset.x;
+  try {
+    if (typeof instance.scrollTo === 'function') {
+      instance.scrollTo({
+        x,
+        y,
+        animated: true
+      });
+      return true;
+    }
+    if (typeof instance.scrollToOffset === 'function') {
+      instance.scrollToOffset({
+        offset: horizontal ? x : y,
+        animated: true
+      });
+      return true;
+    }
+    // SectionList without a numeric offset path — cannot target by testID index.
+  } catch {
+    // Best-effort.
+  }
+  return false;
+}
+
+/**
+ * Pure helper exported for unit tests: compute the next content offset that
+ * brings `target` fully inside `container` with `block: 'nearest'` semantics.
+ */
+export function computeNearestScrollOffset(opts) {
+  const padding = mergePadding(opts.padding ?? null);
+  const {
+    target,
+    container,
+    contentOffset
+  } = opts;
+  const targetContentY = contentOffset.y + (target.y - container.y);
+  const targetContentX = contentOffset.x + (target.x - container.x);
+  let nextY = contentOffset.y;
+  let nextX = contentOffset.x;
+  if (target.y < container.y + padding.top) {
+    nextY = Math.max(0, targetContentY - padding.top);
+  } else if (target.y + target.height > container.y + container.height - padding.bottom) {
+    nextY = Math.max(0, targetContentY + target.height - container.height + padding.bottom);
+  }
+  if (target.x < container.x + padding.left) {
+    nextX = Math.max(0, targetContentX - padding.left);
+  } else if (target.x + target.width > container.x + container.width - padding.right) {
+    nextX = Math.max(0, targetContentX + target.width - container.width + padding.right);
+  }
+  return {
+    x: nextX,
+    y: nextY,
+    changed: Math.abs(nextX - contentOffset.x) >= 1 || Math.abs(nextY - contentOffset.y) >= 1
+  };
+}
+//# sourceMappingURL=scrollAnchorIntoView.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["scrollContainerRegistry","findScrollAncestors","measureHostFiber","getCustomScrollIntoView","getScrollPadding","INTO_VIEW_PADDING","scrollAnchorIntoView","opts","rect","host","fiber","custom","measureInWindow","bind","attempted","list","length","scrollTargetIntoView","scrollFiberAncestors","scrollIntoView","target","ancestors","padding","mergePadding","ancestor","scrollOneAncestor","configured","top","right","bottom","left","instance","containerFiber","contentFiber","horizontal","scrollWithAssumedOffset","x","y","cx","cy","cw","ch","finish","offsetX","offsetY","Math","max","width","height","contentX","contentY","offset","container","targetContentY","targetContentX","nextY","nextX","yChanged","abs","xChanged","scrollTo","animated","scrollToOffset","computeNearestScrollOffset","contentOffset","changed"],"sourceRoot":"../../../src","sources":["anchors/scrollAnchorIntoView.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/anchors/scrollConfig.js

@@ -0,0 +1,40 @@
+"use strict";
+
+/**
+ * Integrator-level scroll configuration, mirroring web userflow.js
+ * `setScrollPadding` / `setCustomScrollIntoView`.
+ */
+
+/** Target passed to a custom scroll-into-view override. */
+
+const config = {
+  scrollPadding: null,
+  customScrollIntoView: null
+};
+
+/** Sticky header/footer insets applied when deciding whether / how far to scroll. */
+export function setScrollPadding(padding) {
+  config.scrollPadding = padding ?? null;
+}
+export function getScrollPadding() {
+  return config.scrollPadding;
+}
+
+/**
+ * Replace the SDK's scroll-into-view behavior entirely. Useful for scroll
+ * libraries the fiber walk cannot drive (some FlashList / Reanimated setups).
+ * Pass `null` to restore the default.
+ */
+export function setCustomScrollIntoView(fn) {
+  config.customScrollIntoView = fn ?? null;
+}
+export function getCustomScrollIntoView() {
+  return config.customScrollIntoView;
+}
+
+/** Test helper — reset to defaults. */
+export function resetScrollConfig() {
+  config.scrollPadding = null;
+  config.customScrollIntoView = null;
+}
+//# sourceMappingURL=scrollConfig.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["config","scrollPadding","customScrollIntoView","setScrollPadding","padding","getScrollPadding","setCustomScrollIntoView","fn","getCustomScrollIntoView","resetScrollConfig"],"sourceRoot":"../../../src","sources":["anchors/scrollConfig.ts"],"mappings":";;AAAA;AACA;AACA;AACA;;AAWA;;AAeA,MAAMA,MAAoB,GAAG;EAC3BC,aAAa,EAAE,IAAI;EACnBC,oBAAoB,EAAE;AACxB,CAAC;;AAED;AACA,OAAO,SAASC,gBAAgBA,CAACC,OAAyC,EAAQ;EAChFJ,MAAM,CAACC,aAAa,GAAGG,OAAO,IAAI,IAAI;AACxC;AAEA,OAAO,SAASC,gBAAgBA,CAAA,EAAyB;EACvD,OAAOL,MAAM,CAACC,aAAa;AAC7B;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASK,uBAAuBA,CAACC,EAA2C,EAAQ;EACzFP,MAAM,CAACE,oBAAoB,GAAGK,EAAE,IAAI,IAAI;AAC1C;AAEA,OAAO,SAASC,uBAAuBA,CAAA,EAAgC;EACrE,OAAOR,MAAM,CAACE,oBAAoB;AACpC;;AAEA;AACA,OAAO,SAASO,iBAAiBA,CAAA,EAAS;EACxCT,MAAM,CAACC,aAAa,GAAG,IAAI;EAC3BD,MAAM,CAACE,oBAAoB,GAAG,IAAI;AACpC","ignoreList":[]}

package/lib/module/anchors/targetPressMonitor.js

@@ -0,0 +1,105 @@
+"use strict";
+
+/**
+ * Active tooltip target-press subscription.
+ *
+ * {@link TooltipSurface} registers while a TOOLTIP step has a measured target,
+ * non-empty `actions`, and `tooltipTargetBlocked === false`. The bridge reads
+ * this at touch time so rAF measure updates do not re-render the provider.
+ */
+
+/** Max finger travel (px) between start and end to count as a tap, not a scroll. */
+export const TARGET_PRESS_TAP_SLOP = 10;
+export function pointInRect(x, y, rect) {
+  return x >= rect.x && x <= rect.x + rect.width && y >= rect.y && y <= rect.y + rect.height;
+}
+/**
+ * True when start and end both land in `rect` and movement stays within tap
+ * slop — mirrors a DOM click on the target without claiming the responder.
+ */
+export function isTargetTap(start, end, rect, slop = TARGET_PRESS_TAP_SLOP) {
+  if (!pointInRect(start.pageX, start.pageY, rect)) return false;
+  if (!pointInRect(end.pageX, end.pageY, rect)) return false;
+  const dx = end.pageX - start.pageX;
+  const dy = end.pageY - start.pageY;
+  return dx * dx + dy * dy <= slop * slop;
+}
+
+/**
+ * Module singleton for the active tooltip target-click listener.
+ * At most one subscription (one visible tooltip step).
+ *
+ * In-progress touches are keyed by native `identifier` so multi-touch start/end
+ * pairs correctly when several fingers are down. RN types `identifier` as
+ * `string`; accept `number | string` for tests and older typings.
+ */
+
+export class TargetPressMonitor {
+  subscription = null;
+  touchStarts = new Map();
+  set(subscription) {
+    this.subscription = subscription;
+    if (!subscription) {
+      this.touchStarts.clear();
+    }
+  }
+  clear() {
+    this.set(null);
+  }
+  get() {
+    return this.subscription;
+  }
+
+  /** Record touch start for `identifier`; ignores when no active subscription. */
+  handleTouchStart(identifier, pageX, pageY) {
+    if (!this.subscription) {
+      this.touchStarts.clear();
+      return;
+    }
+    this.touchStarts.set(identifier, {
+      pageX,
+      pageY
+    });
+  }
+
+  /**
+   * If the gesture for `identifier` is a tap on the registered target, invoke
+   * `onPress`. Never claims the responder — app controls still receive the press.
+   */
+  handleTouchEnd(identifier, pageX, pageY) {
+    const start = this.touchStarts.get(identifier) ?? null;
+    this.touchStarts.delete(identifier);
+    const sub = this.subscription;
+    if (!start || !sub) return;
+    const rect = sub.getRect();
+    if (!rect || rect.width <= 0 || rect.height <= 0) return;
+    if (isTargetTap(start, {
+      pageX,
+      pageY
+    }, rect)) {
+      sub.onPress();
+    }
+  }
+
+  /**
+   * Drop in-progress gesture(s). With `identifier`, cancels that finger only;
+   * otherwise clears all (e.g. blanket `onTouchCancel`).
+   */
+  cancelTouch(identifier) {
+    if (identifier == null) {
+      this.touchStarts.clear();
+      return;
+    }
+    this.touchStarts.delete(identifier);
+  }
+
+  /** Test helper. */
+  resetForTests() {
+    this.subscription = null;
+    this.touchStarts.clear();
+  }
+}
+
+/** Shared singleton used by TooltipSurface and TargetPressBridge. */
+export const targetPressMonitor = new TargetPressMonitor();
+//# sourceMappingURL=targetPressMonitor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["TARGET_PRESS_TAP_SLOP","pointInRect","x","y","rect","width","height","isTargetTap","start","end","slop","pageX","pageY","dx","dy","TargetPressMonitor","subscription","touchStarts","Map","set","clear","get","handleTouchStart","identifier","handleTouchEnd","delete","sub","getRect","onPress","cancelTouch","resetForTests","targetPressMonitor"],"sourceRoot":"../../../src","sources":["anchors/targetPressMonitor.ts"],"mappings":"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","ignoreList":[]}