@userflow-tech/react-native 0.1.0

package/lib/module/surfaces/tooltip/TooltipCutout.js

@@ -0,0 +1,98 @@
+"use strict";
+
+import * as React from 'react';
+import { Dimensions, StyleSheet, View } from 'react-native';
+import { ABSOLUTE_FILL } from "../absoluteFill.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Four-block dimmed cutout around the padded target (web tooltip backdrop).
+ *
+ * Dim bands use `pointerEvents="none"` so touches reach the app — React Native
+ * cannot block taps while allowing scroll the way web's `mousedown`-only
+ * swallow does. When `targetBlocked`, only the hole (target) is covered with a
+ * transparent `pointerEvents="auto"` layer.
+ *
+ * MVP note: each block uses its own translucent opacity. That matches non-overlapping
+ * tiles well, but can look slightly uneven vs web’s single shadow-hole when other
+ * translucent overlays stack. Acceptable for Phase 3; a single masked layer can come later.
+ */
+export function TooltipCutout({
+  targetRect,
+  backdropColor,
+  backdropOpacity,
+  targetBlocked
+}) {
+  const {
+    width: sw,
+    height: sh
+  } = Dimensions.get('window');
+  const {
+    top,
+    left,
+    width,
+    height
+  } = targetRect;
+  const right = left + width;
+  const bottom = top + height;
+  const blockStyle = {
+    backgroundColor: backdropColor,
+    opacity: backdropOpacity
+  };
+  return /*#__PURE__*/_jsxs(View, {
+    style: ABSOLUTE_FILL,
+    pointerEvents: "box-none",
+    testID: "userflow-tooltip-cutout",
+    children: [/*#__PURE__*/_jsx(View, {
+      pointerEvents: "none",
+      testID: "userflow-tooltip-cutout-top",
+      style: [styles.block, blockStyle, {
+        top: 0,
+        left: 0,
+        width: sw,
+        height: Math.max(0, top)
+      }]
+    }), /*#__PURE__*/_jsx(View, {
+      pointerEvents: "none",
+      testID: "userflow-tooltip-cutout-left",
+      style: [styles.block, blockStyle, {
+        top: Math.max(0, top),
+        left: 0,
+        width: Math.max(0, left),
+        height: Math.max(0, height)
+      }]
+    }), /*#__PURE__*/_jsx(View, {
+      pointerEvents: "none",
+      testID: "userflow-tooltip-cutout-right",
+      style: [styles.block, blockStyle, {
+        top: Math.max(0, top),
+        left: Math.max(0, right),
+        width: Math.max(0, sw - right),
+        height: Math.max(0, height)
+      }]
+    }), /*#__PURE__*/_jsx(View, {
+      pointerEvents: "none",
+      testID: "userflow-tooltip-cutout-bottom",
+      style: [styles.block, blockStyle, {
+        top: Math.max(0, bottom),
+        left: 0,
+        width: sw,
+        height: Math.max(0, sh - bottom)
+      }]
+    }), targetBlocked ? /*#__PURE__*/_jsx(View, {
+      pointerEvents: "auto",
+      testID: "userflow-tooltip-target-block",
+      style: [styles.block, {
+        top,
+        left,
+        width: Math.max(0, width),
+        height: Math.max(0, height)
+      }]
+    }) : null]
+  });
+}
+const styles = StyleSheet.create({
+  block: {
+    position: 'absolute'
+  }
+});
+//# sourceMappingURL=TooltipCutout.js.map

package/lib/module/surfaces/tooltip/TooltipCutout.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","Dimensions","StyleSheet","View","ABSOLUTE_FILL","jsx","_jsx","jsxs","_jsxs","TooltipCutout","targetRect","backdropColor","backdropOpacity","targetBlocked","width","sw","height","sh","get","top","left","right","bottom","blockStyle","backgroundColor","opacity","style","pointerEvents","testID","children","styles","block","Math","max","create","position"],"sourceRoot":"../../../../src","sources":["surfaces/tooltip/TooltipCutout.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/surfaces/tooltip/TooltipNotch.js

@@ -0,0 +1,55 @@
+"use strict";
+
+import * as React from 'react';
+import { StyleSheet, View } from 'react-native';
+import { tooltipNotchDiamondSide } from "./computeTooltipPosition.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+export { tooltipNotchDiamondSide };
+
+/**
+ * Tooltip arrow as a rotated square half-hidden under the opaque card fill.
+ *
+ * Web uses a CSS border-triangle under `filter: drop-shadow`, so the notch and
+ * card share one silhouette. RN box-shadow can't follow alpha, and border
+ * triangles render poorly — a diamond behind the card reads as a real tooltip
+ * pointer and joins the fill without a seam.
+ */
+export function TooltipNotch({
+  notchSize,
+  notchColor,
+  inset = 0,
+  style,
+  top,
+  bottom,
+  left,
+  right,
+  testID = 'userflow-tooltip-notch'
+}) {
+  const side = Math.max(0, tooltipNotchDiamondSide(notchSize) - inset * 2);
+  return /*#__PURE__*/_jsx(View, {
+    pointerEvents: "none",
+    testID: testID,
+    style: [styles.notch, {
+      width: side,
+      height: side,
+      backgroundColor: notchColor
+    }, top !== undefined ? {
+      top: top + inset
+    } : null, bottom !== undefined ? {
+      bottom: bottom + inset
+    } : null, left !== undefined ? {
+      left: left + inset
+    } : null, right !== undefined ? {
+      right: right + inset
+    } : null, style]
+  });
+}
+const styles = StyleSheet.create({
+  notch: {
+    position: 'absolute',
+    transform: [{
+      rotate: '45deg'
+    }]
+  }
+});
+//# sourceMappingURL=TooltipNotch.js.map

package/lib/module/surfaces/tooltip/TooltipNotch.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","StyleSheet","View","tooltipNotchDiamondSide","jsx","_jsx","TooltipNotch","notchSize","notchColor","inset","style","top","bottom","left","right","testID","side","Math","max","pointerEvents","styles","notch","width","height","backgroundColor","undefined","create","position","transform","rotate"],"sourceRoot":"../../../../src","sources":["surfaces/tooltip/TooltipNotch.tsx"],"mappings":";;AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAC9B,SAASC,UAAU,EAAEC,IAAI,QAAwC,cAAc;AAE/E,SAASC,uBAAuB,QAAQ,6BAA0B;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAkBnE,SAASF,uBAAuB;;AAEhC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASG,YAAYA,CAAC;EAC3BC,SAAS;EACTC,UAAU;EACVC,KAAK,GAAG,CAAC;EACTC,KAAK;EACLC,GAAG;EACHC,MAAM;EACNC,IAAI;EACJC,KAAK;EACLC,MAAM,GAAG;AACQ,CAAC,EAAsB;EACxC,MAAMC,IAAI,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEf,uBAAuB,CAACI,SAAS,CAAC,GAAGE,KAAK,GAAG,CAAC,CAAC;EAExE,oBACEJ,IAAA,CAACH,IAAI;IACHiB,aAAa,EAAC,MAAM;IACpBJ,MAAM,EAAEA,MAAO;IACfL,KAAK,EAAE,CACLU,MAAM,CAACC,KAAK,EACZ;MAAEC,KAAK,EAAEN,IAAI;MAAEO,MAAM,EAAEP,IAAI;MAAEQ,eAAe,EAAEhB;IAAW,CAAC,EAC1DG,GAAG,KAAKc,SAAS,GAAG;MAAEd,GAAG,EAAEA,GAAG,GAAGF;IAAM,CAAC,GAAG,IAAI,EAC/CG,MAAM,KAAKa,SAAS,GAAG;MAAEb,MAAM,EAAEA,MAAM,GAAGH;IAAM,CAAC,GAAG,IAAI,EACxDI,IAAI,KAAKY,SAAS,GAAG;MAAEZ,IAAI,EAAEA,IAAI,GAAGJ;IAAM,CAAC,GAAG,IAAI,EAClDK,KAAK,KAAKW,SAAS,GAAG;MAAEX,KAAK,EAAEA,KAAK,GAAGL;IAAM,CAAC,GAAG,IAAI,EACrDC,KAAK;EACL,CACH,CAAC;AAEN;AAEA,MAAMU,MAAM,GAAGnB,UAAU,CAACyB,MAAM,CAAC;EAC/BL,KAAK,EAAE;IACLM,QAAQ,EAAE,UAAU;IACpBC,SAAS,EAAE,CAAC;MAAEC,MAAM,EAAE;IAAQ,CAAC;EACjC;AACF,CAAC,CAAC","ignoreList":[]}

package/lib/module/surfaces/tooltip/computeTooltipPosition.js

@@ -0,0 +1,97 @@
+"use strict";
+
+import { VIEWPORT_PADDING } from "./inferTooltipPlacement.js";
+/**
+ * Side length of the axis-aligned square that, when rotated 45°, yields a
+ * tip that protrudes `notchSize` beyond the card edge (half-diagonal = N).
+ */
+export function tooltipNotchDiamondSide(notchSize) {
+  return notchSize * Math.SQRT2;
+}
+
+/**
+ * TOOLTIP card + notch layout. Port of FlowChrome.tsx placement/clamp.
+ *
+ * The notch is a square of side `N√2` rotated 45° whose center sits on the card
+ * edge, so a tip of length `N` points at the target. When the card has a border,
+ * pull the diamond toward the card by `borderWidth` so the tip still clears the
+ * stroke without leaving a seam.
+ */
+export function computeTooltipPosition(opts) {
+  const {
+    target,
+    bubbleSize,
+    placement,
+    notchSize,
+    backdropPadding = 0,
+    windowSize,
+    bubbleBorderRadius,
+    bubbleBorderWidth = 0,
+    viewportPadding = VIEWPORT_PADDING
+  } = opts;
+  const {
+    width: cw,
+    height: ch
+  } = windowSize;
+  const {
+    width: bw,
+    height: bh
+  } = bubbleSize;
+  const targetRect = {
+    top: target.y - backdropPadding,
+    right: target.x + target.width + backdropPadding,
+    bottom: target.y + target.height + backdropPadding,
+    left: target.x - backdropPadding,
+    width: target.width + backdropPadding * 2,
+    height: target.height + backdropPadding * 2
+  };
+  let cx = 0;
+  let cy = 0;
+  const notch = {};
+  const side = tooltipNotchDiamondSide(notchSize);
+  const half = side / 2;
+  const edgeOffset = -half + Math.max(0, bubbleBorderWidth) + 1;
+  if (placement === 'BELOW' || placement === 'ABOVE') {
+    cx = targetRect.left + targetRect.width / 2 - bw / 2;
+    cx = Math.max(viewportPadding, Math.min(cw - bw - viewportPadding, cx));
+    const rawLeft = targetRect.left + targetRect.width / 2 - half - cx;
+    notch.left = Math.max(bubbleBorderRadius, Math.min(bw - bubbleBorderRadius - side, rawLeft));
+    if (placement === 'BELOW') {
+      cy = targetRect.bottom + notchSize;
+      cy = Math.max(notchSize, Math.min(ch - bh, cy));
+      notch.top = edgeOffset;
+    } else {
+      cy = targetRect.top - notchSize - bh;
+      cy = Math.max(0, Math.min(ch - bh - notchSize, cy));
+      notch.bottom = edgeOffset;
+    }
+  } else {
+    cy = targetRect.top + targetRect.height / 2 - bh / 2;
+    cy = Math.max(viewportPadding, Math.min(ch - bh - viewportPadding, cy));
+    const rawTop = targetRect.top + targetRect.height / 2 - half - cy;
+    notch.top = Math.max(bubbleBorderRadius, Math.min(bh - bubbleBorderRadius - side, rawTop));
+    if (placement === 'RIGHT') {
+      cx = targetRect.right + notchSize;
+      cx = Math.max(notchSize, Math.min(cw - bw, cx));
+      notch.left = edgeOffset;
+    } else {
+      cx = targetRect.left - notchSize - bw;
+      cx = Math.max(0, Math.min(cw - bw - notchSize, cx));
+      notch.right = edgeOffset;
+    }
+  }
+  return {
+    cardPosition: {
+      x: cx,
+      y: cy
+    },
+    notchPosition: notch,
+    targetHighlightRect: {
+      top: target.y - backdropPadding,
+      left: target.x - backdropPadding,
+      width: target.width + backdropPadding * 2,
+      height: target.height + backdropPadding * 2
+    }
+  };
+}
+//# sourceMappingURL=computeTooltipPosition.js.map

package/lib/module/surfaces/tooltip/computeTooltipPosition.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["VIEWPORT_PADDING","tooltipNotchDiamondSide","notchSize","Math","SQRT2","computeTooltipPosition","opts","target","bubbleSize","placement","backdropPadding","windowSize","bubbleBorderRadius","bubbleBorderWidth","viewportPadding","width","cw","height","ch","bw","bh","targetRect","top","y","right","x","bottom","left","cx","cy","notch","side","half","edgeOffset","max","min","rawLeft","rawTop","cardPosition","notchPosition","targetHighlightRect"],"sourceRoot":"../../../../src","sources":["surfaces/tooltip/computeTooltipPosition.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/surfaces/tooltip/inferTooltipPlacement.js

@@ -0,0 +1,95 @@
+"use strict";
+
+/** Placement sides — string union so Jest protocol mocks stay empty. */
+
+import { TOOLTIP_VIEWPORT_PADDING } from "../resolveTooltipLayout.js";
+export const VIEWPORT_PADDING = TOOLTIP_VIEWPORT_PADDING;
+
+/**
+ * Port of web FlowChrome `inferTooltipPlacement` with distance-sorted flip
+ * (not the prototype's fixed BELOW→ABOVE→RIGHT→LEFT priority).
+ */
+export function inferTooltipPlacement({
+  target,
+  bubbleSize,
+  notchSize,
+  windowSize,
+  currentPlacement,
+  desiredPlacement
+}) {
+  const {
+    width: cw,
+    height: ch
+  } = windowSize;
+  const {
+    width: bw,
+    height: bh
+  } = bubbleSize;
+  const clip = {
+    top: 0,
+    right: cw,
+    bottom: ch,
+    left: 0
+  };
+  const targetRect = {
+    top: target.y,
+    right: target.x + target.width,
+    bottom: target.y + target.height,
+    left: target.x,
+    width: target.width,
+    height: target.height
+  };
+  if (targetRect.bottom <= clip.top) {
+    return ch - clip.top > bh + notchSize ? 'BELOW' : 'ABOVE';
+  }
+  if (targetRect.top >= clip.bottom) {
+    return clip.bottom > bh + notchSize ? 'ABOVE' : 'BELOW';
+  }
+  if (targetRect.right <= clip.left) {
+    return cw - clip.left > bw + notchSize ? 'RIGHT' : 'LEFT';
+  }
+  if (targetRect.left >= clip.right) {
+    return clip.right > bw + notchSize ? 'LEFT' : 'RIGHT';
+  }
+  const fits = p => {
+    const midX = targetRect.left + targetRect.width / 2;
+    const midY = targetRect.top + targetRect.height / 2;
+    const midXIn = midX >= clip.left && midX <= clip.right;
+    const midYIn = midY >= clip.top && midY <= clip.bottom;
+    switch (p) {
+      case 'BELOW':
+        return ch - targetRect.bottom > bh + notchSize && midXIn;
+      case 'ABOVE':
+        return targetRect.top > bh + notchSize && midXIn;
+      case 'RIGHT':
+        return cw - targetRect.right > bw + notchSize && midYIn;
+      case 'LEFT':
+        return targetRect.left > bw + notchSize && midYIn;
+      default:
+        return false;
+    }
+  };
+  if (desiredPlacement && fits(desiredPlacement)) return desiredPlacement;
+  if (currentPlacement && fits(currentPlacement)) return currentPlacement;
+  const options = [{
+    placement: 'BELOW',
+    dist: targetRect.top
+  }, {
+    placement: 'ABOVE',
+    dist: ch - targetRect.bottom
+  }, {
+    placement: 'RIGHT',
+    dist: targetRect.left
+  }, {
+    placement: 'LEFT',
+    dist: cw - targetRect.right
+  }];
+  options.sort((a, b) => a.dist - b.dist);
+  for (const {
+    placement
+  } of options) {
+    if (fits(placement)) return placement;
+  }
+  return desiredPlacement ?? 'BELOW';
+}
+//# sourceMappingURL=inferTooltipPlacement.js.map

package/lib/module/surfaces/tooltip/inferTooltipPlacement.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TOOLTIP_VIEWPORT_PADDING","VIEWPORT_PADDING","inferTooltipPlacement","target","bubbleSize","notchSize","windowSize","currentPlacement","desiredPlacement","width","cw","height","ch","bw","bh","clip","top","right","bottom","left","targetRect","y","x","fits","p","midX","midY","midXIn","midYIn","options","placement","dist","sort","a","b"],"sourceRoot":"../../../../src","sources":["surfaces/tooltip/inferTooltipPlacement.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/surfaces/tooltip/parseBackdropPadding.js

@@ -0,0 +1,11 @@
+"use strict";
+
+/** Parse step `backdropPadding` (px). Web accepts CSS shorthand; MVP: first number. */
+export function parseBackdropPadding(value) {
+  if (value == null || value === '') return 0;
+  const match = String(value).match(/-?\d+(\.\d+)?/);
+  if (!match) return 0;
+  const n = parseFloat(match[0]);
+  return Number.isFinite(n) ? Math.max(0, n) : 0;
+}
+//# sourceMappingURL=parseBackdropPadding.js.map

package/lib/module/surfaces/tooltip/parseBackdropPadding.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["parseBackdropPadding","value","match","String","n","parseFloat","Number","isFinite","Math","max"],"sourceRoot":"../../../../src","sources":["surfaces/tooltip/parseBackdropPadding.ts"],"mappings":";;AAAA;AACA,OAAO,SAASA,oBAAoBA,CAACC,KAAgC,EAAU;EAC7E,IAAIA,KAAK,IAAI,IAAI,IAAIA,KAAK,KAAK,EAAE,EAAE,OAAO,CAAC;EAC3C,MAAMC,KAAK,GAAGC,MAAM,CAACF,KAAK,CAAC,CAACC,KAAK,CAAC,eAAe,CAAC;EAClD,IAAI,CAACA,KAAK,EAAE,OAAO,CAAC;EACpB,MAAME,CAAC,GAAGC,UAAU,CAACH,KAAK,CAAC,CAAC,CAAC,CAAC;EAC9B,OAAOI,MAAM,CAACC,QAAQ,CAACH,CAAC,CAAC,GAAGI,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEL,CAAC,CAAC,GAAG,CAAC;AAChD","ignoreList":[]}

package/lib/module/surfaces/tooltip/rect.js

@@ -0,0 +1,44 @@
+"use strict";
+
+/** True when two rects are identical (used to avoid redundant setState). */
+export function rectsEqual(a, b) {
+  if (a === b) return true;
+  if (a == null || b == null) return false;
+  return a.x === b.x && a.y === b.y && a.width === b.width && a.height === b.height;
+}
+
+/** Fully outside the window (no intersection). Kept for callers that need it. */
+export function isRectOffScreen(rect, windowSize) {
+  return rect.y + rect.height <= 0 || rect.y >= windowSize.height || rect.x + rect.width <= 0 || rect.x >= windowSize.width;
+}
+
+/**
+ * Viewport used for scroll-into-view / visibility checks. May be smaller than
+ * the raw window (keyboard, safe-area, sticky chrome via scroll padding).
+ */
+
+/**
+ * True when every edge of `rect` lies inside `viewport` (inclusive).
+ * Partially clipped targets return false — matching web `block: 'nearest'`
+ * scroll-into-view gating.
+ */
+export function isRectFullyVisible(rect, viewport) {
+  if (rect.width <= 0 || rect.height <= 0) return false;
+  if (viewport.width <= 0 || viewport.height <= 0) return false;
+  return rect.x >= viewport.x && rect.y >= viewport.y && rect.x + rect.width <= viewport.x + viewport.width && rect.y + rect.height <= viewport.y + viewport.height;
+}
+
+/** Build an effective viewport from window size + optional insets. */
+export function buildEffectiveViewport(windowSize, insets) {
+  const top = Math.max(0, insets?.top ?? 0);
+  const right = Math.max(0, insets?.right ?? 0);
+  const bottom = Math.max(0, insets?.bottom ?? 0);
+  const left = Math.max(0, insets?.left ?? 0);
+  return {
+    x: left,
+    y: top,
+    width: Math.max(0, windowSize.width - left - right),
+    height: Math.max(0, windowSize.height - top - bottom)
+  };
+}
+//# sourceMappingURL=rect.js.map

package/lib/module/surfaces/tooltip/rect.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["rectsEqual","a","b","x","y","width","height","isRectOffScreen","rect","windowSize","isRectFullyVisible","viewport","buildEffectiveViewport","insets","top","Math","max","right","bottom","left"],"sourceRoot":"../../../../src","sources":["surfaces/tooltip/rect.ts"],"mappings":";;AAEA;AACA,OAAO,SAASA,UAAUA,CAACC,CAAc,EAAEC,CAAc,EAAW;EAClE,IAAID,CAAC,KAAKC,CAAC,EAAE,OAAO,IAAI;EACxB,IAAID,CAAC,IAAI,IAAI,IAAIC,CAAC,IAAI,IAAI,EAAE,OAAO,KAAK;EACxC,OAAOD,CAAC,CAACE,CAAC,KAAKD,CAAC,CAACC,CAAC,IAAIF,CAAC,CAACG,CAAC,KAAKF,CAAC,CAACE,CAAC,IAAIH,CAAC,CAACI,KAAK,KAAKH,CAAC,CAACG,KAAK,IAAIJ,CAAC,CAACK,MAAM,KAAKJ,CAAC,CAACI,MAAM;AACnF;;AAEA;AACA,OAAO,SAASC,eAAeA,CAACC,IAAU,EAAEC,UAAsB,EAAW;EAC3E,OACED,IAAI,CAACJ,CAAC,GAAGI,IAAI,CAACF,MAAM,IAAI,CAAC,IACzBE,IAAI,CAACJ,CAAC,IAAIK,UAAU,CAACH,MAAM,IAC3BE,IAAI,CAACL,CAAC,GAAGK,IAAI,CAACH,KAAK,IAAI,CAAC,IACxBG,IAAI,CAACL,CAAC,IAAIM,UAAU,CAACJ,KAAK;AAE9B;;AAEA;AACA;AACA;AACA;;AAQA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASK,kBAAkBA,CAACF,IAAU,EAAEG,QAA2B,EAAW;EACnF,IAAIH,IAAI,CAACH,KAAK,IAAI,CAAC,IAAIG,IAAI,CAACF,MAAM,IAAI,CAAC,EAAE,OAAO,KAAK;EACrD,IAAIK,QAAQ,CAACN,KAAK,IAAI,CAAC,IAAIM,QAAQ,CAACL,MAAM,IAAI,CAAC,EAAE,OAAO,KAAK;EAC7D,OACEE,IAAI,CAACL,CAAC,IAAIQ,QAAQ,CAACR,CAAC,IACpBK,IAAI,CAACJ,CAAC,IAAIO,QAAQ,CAACP,CAAC,IACpBI,IAAI,CAACL,CAAC,GAAGK,IAAI,CAACH,KAAK,IAAIM,QAAQ,CAACR,CAAC,GAAGQ,QAAQ,CAACN,KAAK,IAClDG,IAAI,CAACJ,CAAC,GAAGI,IAAI,CAACF,MAAM,IAAIK,QAAQ,CAACP,CAAC,GAAGO,QAAQ,CAACL,MAAM;AAExD;;AAEA;AACA,OAAO,SAASM,sBAAsBA,CACpCH,UAAsB,EACtBI,MAAyE,EACtD;EACnB,MAAMC,GAAG,GAAGC,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEH,MAAM,EAAEC,GAAG,IAAI,CAAC,CAAC;EACzC,MAAMG,KAAK,GAAGF,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEH,MAAM,EAAEI,KAAK,IAAI,CAAC,CAAC;EAC7C,MAAMC,MAAM,GAAGH,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEH,MAAM,EAAEK,MAAM,IAAI,CAAC,CAAC;EAC/C,MAAMC,IAAI,GAAGJ,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEH,MAAM,EAAEM,IAAI,IAAI,CAAC,CAAC;EAC3C,OAAO;IACLhB,CAAC,EAAEgB,IAAI;IACPf,CAAC,EAAEU,GAAG;IACNT,KAAK,EAAEU,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEP,UAAU,CAACJ,KAAK,GAAGc,IAAI,GAAGF,KAAK,CAAC;IACnDX,MAAM,EAAES,IAAI,CAACC,GAAG,CAAC,CAAC,EAAEP,UAAU,CAACH,MAAM,GAAGQ,GAAG,GAAGI,MAAM;EACtD,CAAC;AACH","ignoreList":[]}

package/lib/module/useUserflowScreen.js

@@ -0,0 +1,21 @@
+"use strict";
+
+import { useEffect } from 'react';
+import { handleScreenChange } from "./screenTracker.js";
+
+/**
+ * Reports the active React Navigation (or manual) screen name to Userflow when
+ * it changes. Sent to the backend as `clientContext.screen`.
+ *
+ * Prefer {@link UserflowProvider} + {@link WithUserflowReactNavigation} when
+ * using React Navigation. For Expo Router pathnames, prefer
+ * {@link UserflowProvider} (it wires pathname tracking automatically).
+ */
+export function useUserflowScreen(screenName) {
+  useEffect(() => {
+    handleScreenChange(screenName ? {
+      screen: screenName
+    } : undefined);
+  }, [screenName]);
+}
+//# sourceMappingURL=useUserflowScreen.js.map

package/lib/module/useUserflowScreen.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","handleScreenChange","useUserflowScreen","screenName","screen","undefined"],"sourceRoot":"../../src","sources":["useUserflowScreen.ts"],"mappings":";;AAAA,SAASA,SAAS,QAAQ,OAAO;AAEjC,SAASC,kBAAkB,QAAQ,oBAAiB;;AAEpD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAACC,UAA8B,EAAQ;EACtEH,SAAS,CAAC,MAAM;IACdC,kBAAkB,CAACE,UAAU,GAAG;MAAEC,MAAM,EAAED;IAAW,CAAC,GAAGE,SAAS,CAAC;EACrE,CAAC,EAAE,CAACF,UAAU,CAAC,CAAC;AAClB","ignoreList":[]}

package/lib/module/version.js

@@ -0,0 +1,5 @@
+"use strict";
+
+/** Generated by scripts/write-version.mjs — do not edit. */
+export const SDK_VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/lib/module/version.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["SDK_VERSION"],"sourceRoot":"../../src","sources":["version.ts"],"mappings":";;AAAA;AACA,OAAO,MAAMA,WAAW,GAAG,OAAO","ignoreList":[]}

package/lib/typescript/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/typescript/commonjs/src/anchors/AnchorRegistry.d.ts

@@ -0,0 +1,32 @@
+/** Host view that can be measured in window coordinates. */
+export interface AnchorHost {
+    measureInWindow: (callback: (x: number, y: number, width: number, height: number) => void) => void;
+    /**
+     * Optional best-effort: scroll ancestors so this host enters the viewport.
+     * Called when the measured rect is not fully visible (bounded retries per step).
+     */
+    scrollIntoView?: () => void;
+}
+type Listener = () => void;
+/**
+ * Manual-anchor registry for Phase 3 (WS6). Codeless resolution is Phase 4.
+ * Multiple mounts of the same id keep a set; {@link get} returns the most
+ * recently registered host.
+ */
+export declare class AnchorRegistry {
+    private readonly anchors;
+    private readonly listeners;
+    register(id: string, host: AnchorHost): void;
+    unregister(id: string, host: AnchorHost): void;
+    get(id: string): AnchorHost | null;
+    /** True when more than one host is registered for the same id. */
+    isAmbiguous(id: string): boolean;
+    subscribe(listener: Listener): () => void;
+    /** Test helper — clear all anchors. */
+    clear(): void;
+    private emit;
+}
+/** Module singleton used by {@link useUserflowAnchor} and TooltipSurface. */
+export declare const anchorRegistry: AnchorRegistry;
+export {};
+//# sourceMappingURL=AnchorRegistry.d.ts.map

package/lib/typescript/commonjs/src/anchors/AnchorRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnchorRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/anchors/AnchorRegistry.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,WAAW,UAAU;IACzB,eAAe,EAAE,CACf,QAAQ,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,KACpE,IAAI,CAAC;IACV;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,KAAK,QAAQ,GAAG,MAAM,IAAI,CAAC;AAE3B;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;IAC9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuB;IAEjD,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAW5C,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAU9C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAUlC,kEAAkE;IAClE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIhC,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI;IAOzC,uCAAuC;IACvC,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,IAAI;CAKb;AAED,6EAA6E;AAC7E,eAAO,MAAM,cAAc,gBAAuB,CAAC"}

package/lib/typescript/commonjs/src/anchors/AutoAnchorRegistry.d.ts

@@ -0,0 +1,113 @@
+import type { SemanticRole, SemanticSegment, SiblingDescriptor } from '@userflow-tech/protocol';
+import type { MutableRefObject, RefObject } from 'react';
+/**
+ * Multi-instance auto-anchor registry for Stage 3.
+ *
+ * Separate from {@link AnchorRegistry} (manual `useUserflowAnchor` / Tier 0).
+ * Each mounted host is a distinct instance indexed by registry key, template
+ * path, and developer ids so a later scored matcher can rank candidates.
+ */
+export type AutoAnchorRef = RefObject<unknown> | MutableRefObject<unknown>;
+export type AutoAnchorListener = () => void;
+/** Build-time descriptor stamped by `@userflow-tech/babel-plugin` (full or expanded compact). */
+export interface BuildTimeHints {
+    /** Canonical structural path (IDs replace ordinals when present). */
+    ufid: string;
+    /** Build-local alias key (`uf_<hash>` of templatePath). */
+    nativeId: string;
+    structuralPath?: string;
+    templatePath?: string;
+    childText?: string;
+    childShape?: string;
+    iconName?: string;
+    imageSrc?: string;
+    literalTestId?: string;
+    literalLabel?: string;
+    literalUserflowId?: string;
+    ordinal?: number;
+    siblingIndex?: number;
+    role?: SemanticRole;
+    ancestors?: SemanticSegment[];
+}
+export interface AutoAnchorInstance {
+    instanceId: string;
+    registryKey: string;
+    ref: AutoAnchorRef;
+    kind: string;
+    role: SemanticRole;
+    isPressable: boolean;
+    templatePath: string;
+    structuralPath: string;
+    instanceScope?: string;
+    manualId?: string;
+    userflowId?: string;
+    testID?: string;
+    nativeID?: string;
+    childText?: string;
+    accessibilityLabel?: string;
+    childShape?: string;
+    iconName?: string;
+    imageSrc?: string;
+    ancestors: SemanticSegment[];
+    ordinal?: number;
+    siblingIndex?: number;
+    parentInstanceId?: string;
+    childInstanceIds: string[];
+    ambiguous: boolean;
+}
+export interface RegisterInstanceInput {
+    registryKey: string;
+    ref: AutoAnchorRef;
+    kind: string;
+    hints?: BuildTimeHints | null;
+    instanceScope?: string | null;
+    runtime?: {
+        manualId?: string;
+        userflowId?: string;
+        testID?: string;
+        nativeID?: string;
+        childText?: string;
+        accessibilityLabel?: string;
+        iconName?: string;
+        imageSrc?: string;
+        reactKey?: string;
+    };
+    parentInstanceId?: string;
+}
+export declare function roleForKind(kind: string): SemanticRole;
+export declare class AutoAnchorRegistry {
+    private readonly instances;
+    private readonly byRegistryKey;
+    private readonly byManualId;
+    private readonly byTemplatePath;
+    private readonly listeners;
+    private notifyScheduled;
+    registerInstance(input: RegisterInstanceInput): {
+        instanceId: string;
+        dispose: () => void;
+    };
+    updateInstance(instanceId: string, patch: Partial<Pick<AutoAnchorInstance, 'childText' | 'accessibilityLabel' | 'childShape' | 'manualId' | 'userflowId' | 'testID' | 'nativeID' | 'instanceScope' | 'structuralPath' | 'ancestors' | 'ordinal' | 'siblingIndex' | 'parentInstanceId'>>): void;
+    getInstance(instanceId: string): AutoAnchorInstance | undefined;
+    getInstancesByRegistryKey(key: string): AutoAnchorInstance[];
+    getInstancesByManualId(id: string): AutoAnchorInstance[];
+    getInstancesByTemplatePath(path: string): AutoAnchorInstance[];
+    allInstances(): AutoAnchorInstance[];
+    orderedSiblingsIncludingSelf(instanceId: string): AutoAnchorInstance[];
+    siblingWindow(instanceId: string, windowSize?: number): {
+        previous: SiblingDescriptor[];
+        next: SiblingDescriptor[];
+    };
+    subscribe(listener: AutoAnchorListener): () => void;
+    isAmbiguousKey(key: string): boolean;
+    /** Test helper — drop every instance and reset ids. */
+    clear(): void;
+    private unregisterInstance;
+    private refreshManualIndexes;
+    private recomputeAmbiguity;
+    private addIndex;
+    private removeIndex;
+    private idsToInstances;
+    private notify;
+}
+export declare const autoAnchorRegistry: AutoAnchorRegistry;
+//# sourceMappingURL=AutoAnchorRegistry.d.ts.map

package/lib/typescript/commonjs/src/anchors/AutoAnchorRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoAnchorRegistry.d.ts","sourceRoot":"","sources":["../../../../../src/anchors/AutoAnchorRegistry.ts"],"names":[],"mappings":"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"}