@userflow-tech/react-native 0.2.0 → 0.3.0

package/lib/module/runtime/SdkErrorBoundary.js

@@ -0,0 +1,55 @@
+"use strict";
+
+import * as React from 'react';
+import { reportSdkError } from "./reportSdkError.js";
+/**
+ * Contains React render/lifecycle errors in SDK UI so they cannot unmount the
+ * host app tree. Event handlers and async work are not covered — those use
+ * {@link isolateSync} / {@link isolateAsync}.
+ */
+export class SdkErrorBoundary extends React.Component {
+  state = {
+    hasError: false,
+    resetKey: this.props.resetKey,
+    failedKeys: []
+  };
+  static getDerivedStateFromError() {
+    return {
+      hasError: true
+    };
+  }
+  static getDerivedStateFromProps(props, state) {
+    if (props.resetKey === state.resetKey) {
+      return null;
+    }
+    const nextKey = props.resetKey ?? '';
+    if (nextKey !== '' && state.failedKeys.includes(nextKey)) {
+      return {
+        hasError: true,
+        resetKey: props.resetKey
+      };
+    }
+    return {
+      hasError: false,
+      resetKey: props.resetKey
+    };
+  }
+  componentDidCatch(error, info) {
+    reportSdkError(this.props.scope, error, info.componentStack);
+    this.props.onError?.(error);
+    const key = this.props.resetKey;
+    if (!key) {
+      return;
+    }
+    this.setState(prev => prev.failedKeys.includes(key) ? null : {
+      failedKeys: [...prev.failedKeys, key]
+    });
+  }
+  render() {
+    if (this.state.hasError) {
+      return null;
+    }
+    return this.props.children;
+  }
+}
+//# sourceMappingURL=SdkErrorBoundary.js.map

package/lib/module/runtime/SdkErrorBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","reportSdkError","SdkErrorBoundary","Component","state","hasError","resetKey","props","failedKeys","getDerivedStateFromError","getDerivedStateFromProps","nextKey","includes","componentDidCatch","error","info","scope","componentStack","onError","key","setState","prev","render","children"],"sourceRoot":"../../../src","sources":["runtime/SdkErrorBoundary.tsx"],"mappings":";;AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAE9B,SAASC,cAAc,QAAQ,qBAAkB;AAuBjD;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,gBAAgB,SAASF,KAAK,CAACG,SAAS,CAGnD;EACSC,KAAK,GAA0B;IACtCC,QAAQ,EAAE,KAAK;IACfC,QAAQ,EAAE,IAAI,CAACC,KAAK,CAACD,QAAQ;IAC7BE,UAAU,EAAE;EACd,CAAC;EAED,OAAOC,wBAAwBA,CAAA,EAAmC;IAChE,OAAO;MAAEJ,QAAQ,EAAE;IAAK,CAAC;EAC3B;EAEA,OAAOK,wBAAwBA,CAC7BH,KAA4B,EAC5BH,KAA4B,EACW;IACvC,IAAIG,KAAK,CAACD,QAAQ,KAAKF,KAAK,CAACE,QAAQ,EAAE;MACrC,OAAO,IAAI;IACb;IACA,MAAMK,OAAO,GAAGJ,KAAK,CAACD,QAAQ,IAAI,EAAE;IACpC,IAAIK,OAAO,KAAK,EAAE,IAAIP,KAAK,CAACI,UAAU,CAACI,QAAQ,CAACD,OAAO,CAAC,EAAE;MACxD,OAAO;QAAEN,QAAQ,EAAE,IAAI;QAAEC,QAAQ,EAAEC,KAAK,CAACD;MAAS,CAAC;IACrD;IACA,OAAO;MAAED,QAAQ,EAAE,KAAK;MAAEC,QAAQ,EAAEC,KAAK,CAACD;IAAS,CAAC;EACtD;EAESO,iBAAiBA,CAACC,KAAY,EAAEC,IAAqB,EAAQ;IACpEd,cAAc,CAAC,IAAI,CAACM,KAAK,CAACS,KAAK,EAAEF,KAAK,EAAEC,IAAI,CAACE,cAAc,CAAC;IAC5D,IAAI,CAACV,KAAK,CAACW,OAAO,GAAGJ,KAAK,CAAC;IAC3B,MAAMK,GAAG,GAAG,IAAI,CAACZ,KAAK,CAACD,QAAQ;IAC/B,IAAI,CAACa,GAAG,EAAE;MACR;IACF;IACA,IAAI,CAACC,QAAQ,CAAEC,IAAI,IACjBA,IAAI,CAACb,UAAU,CAACI,QAAQ,CAACO,GAAG,CAAC,GAAG,IAAI,GAAG;MAAEX,UAAU,EAAE,CAAC,GAAGa,IAAI,CAACb,UAAU,EAAEW,GAAG;IAAE,CACjF,CAAC;EACH;EAESG,MAAMA,CAAA,EAAoB;IACjC,IAAI,IAAI,CAAClB,KAAK,CAACC,QAAQ,EAAE;MACvB,OAAO,IAAI;IACb;IACA,OAAO,IAAI,CAACE,KAAK,CAACgB,QAAQ;EAC5B;AACF","ignoreList":[]}

package/lib/module/runtime/TargetPressBridge.js

@@ -4,6 +4,7 @@ import * as React from 'react';
 import { StyleSheet, View } from 'react-native';
 import { targetPressMonitor } from "../anchors/targetPressMonitor.js";
 import { changedTouchPoints, forEachChangedTouch } from "./changedTouchPoints.js";
+import { isolateSync } from "./isolateCall.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * Wraps app content so tooltip target taps can be observed without stealing
@@ -23,24 +24,30 @@ export function TargetPressBridge({
   children
 }) {
   const onTouchStart = React.useCallback(event => {
-    forEachChangedTouch(event, (identifier, pageX, pageY) => {
-      targetPressMonitor.handleTouchStart(identifier, pageX, pageY);
+    isolateSync('target-press', () => {
+      forEachChangedTouch(event, (identifier, pageX, pageY) => {
+        targetPressMonitor.handleTouchStart(identifier, pageX, pageY);
+      });
     });
   }, []);
   const onTouchEnd = React.useCallback(event => {
-    forEachChangedTouch(event, (identifier, pageX, pageY) => {
-      targetPressMonitor.handleTouchEnd(identifier, pageX, pageY);
+    isolateSync('target-press', () => {
+      forEachChangedTouch(event, (identifier, pageX, pageY) => {
+        targetPressMonitor.handleTouchEnd(identifier, pageX, pageY);
+      });
     });
   }, []);
   const onTouchCancel = React.useCallback(event => {
-    const points = changedTouchPoints(event);
-    if (points.length === 0) {
-      targetPressMonitor.cancelTouch();
-      return;
-    }
-    for (const touch of points) {
-      targetPressMonitor.cancelTouch(touch.identifier);
-    }
+    isolateSync('target-press', () => {
+      const points = changedTouchPoints(event);
+      if (points.length === 0) {
+        targetPressMonitor.cancelTouch();
+        return;
+      }
+      for (const touch of points) {
+        targetPressMonitor.cancelTouch(touch.identifier);
+      }
+    });
   }, []);
   return /*#__PURE__*/_jsx(View, {
     style: styles.root,

package/lib/module/runtime/TargetPressBridge.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","StyleSheet","View","targetPressMonitor","changedTouchPoints","forEachChangedTouch","jsx","_jsx","TargetPressBridge","children","onTouchStart","useCallback","event","identifier","pageX","pageY","handleTouchStart","onTouchEnd","handleTouchEnd","onTouchCancel","points","length","cancelTouch","touch","style","styles","root","collapsable","testID","create","flex"],"sourceRoot":"../../../src","sources":["runtime/TargetPressBridge.tsx"],"mappings":";;AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAC9B,SAASC,UAAU,EAAEC,IAAI,QAAoC,cAAc;AAE3E,SAASC,kBAAkB,QAAQ,kCAA+B;AAElE,SAASC,kBAAkB,EAAEC,mBAAmB,QAAQ,yBAAsB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAM/E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAAC;EAAEC;AAAiC,CAAC,EAAsB;EAC1F,MAAMC,YAAY,GAAGV,KAAK,CAACW,WAAW,CAAEC,KAA4B,IAAK;IACvEP,mBAAmB,CAACO,KAAK,EAAE,CAACC,UAAU,EAAEC,KAAK,EAAEC,KAAK,KAAK;MACvDZ,kBAAkB,CAACa,gBAAgB,CAACH,UAAU,EAAEC,KAAK,EAAEC,KAAK,CAAC;IAC/D,CAAC,CAAC;EACJ,CAAC,EAAE,EAAE,CAAC;EAEN,MAAME,UAAU,GAAGjB,KAAK,CAACW,WAAW,CAAEC,KAA4B,IAAK;IACrEP,mBAAmB,CAACO,KAAK,EAAE,CAACC,UAAU,EAAEC,KAAK,EAAEC,KAAK,KAAK;MACvDZ,kBAAkB,CAACe,cAAc,CAACL,UAAU,EAAEC,KAAK,EAAEC,KAAK,CAAC;IAC7D,CAAC,CAAC;EACJ,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMI,aAAa,GAAGnB,KAAK,CAACW,WAAW,CAAEC,KAA4B,IAAK;IACxE,MAAMQ,MAAM,GAAGhB,kBAAkB,CAACQ,KAAK,CAAC;IACxC,IAAIQ,MAAM,CAACC,MAAM,KAAK,CAAC,EAAE;MACvBlB,kBAAkB,CAACmB,WAAW,CAAC,CAAC;MAChC;IACF;IACA,KAAK,MAAMC,KAAK,IAAIH,MAAM,EAAE;MAC1BjB,kBAAkB,CAACmB,WAAW,CAACC,KAAK,CAACV,UAAU,CAAC;IAClD;EACF,CAAC,EAAE,EAAE,CAAC;EAEN,oBACEN,IAAA,CAACL,IAAI;IACHsB,KAAK,EAAEC,MAAM,CAACC,IAAK;IACnBC,WAAW,EAAE,KAAM;IACnBjB,YAAY,EAAEA,YAAa;IAC3BO,UAAU,EAAEA,UAAW;IACvBE,aAAa,EAAEA,aAAc;IAC7BS,MAAM,EAAC,8BAA8B;IAAAnB,QAAA,EAEpCA;EAAQ,CACL,CAAC;AAEX;AAEA,MAAMgB,MAAM,GAAGxB,UAAU,CAAC4B,MAAM,CAAC;EAC/BH,IAAI,EAAE;IACJI,IAAI,EAAE;EACR;AACF,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["React","StyleSheet","View","targetPressMonitor","changedTouchPoints","forEachChangedTouch","isolateSync","jsx","_jsx","TargetPressBridge","children","onTouchStart","useCallback","event","identifier","pageX","pageY","handleTouchStart","onTouchEnd","handleTouchEnd","onTouchCancel","points","length","cancelTouch","touch","style","styles","root","collapsable","testID","create","flex"],"sourceRoot":"../../../src","sources":["runtime/TargetPressBridge.tsx"],"mappings":";;AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAC9B,SAASC,UAAU,EAAEC,IAAI,QAAoC,cAAc;AAE3E,SAASC,kBAAkB,QAAQ,kCAA+B;AAElE,SAASC,kBAAkB,EAAEC,mBAAmB,QAAQ,yBAAsB;AAC9E,SAASC,WAAW,QAAQ,kBAAe;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAM5C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAAC;EAAEC;AAAiC,CAAC,EAAsB;EAC1F,MAAMC,YAAY,GAAGX,KAAK,CAACY,WAAW,CAAEC,KAA4B,IAAK;IACvEP,WAAW,CAAC,cAAc,EAAE,MAAM;MAChCD,mBAAmB,CAACQ,KAAK,EAAE,CAACC,UAAU,EAAEC,KAAK,EAAEC,KAAK,KAAK;QACvDb,kBAAkB,CAACc,gBAAgB,CAACH,UAAU,EAAEC,KAAK,EAAEC,KAAK,CAAC;MAC/D,CAAC,CAAC;IACJ,CAAC,CAAC;EACJ,CAAC,EAAE,EAAE,CAAC;EAEN,MAAME,UAAU,GAAGlB,KAAK,CAACY,WAAW,CAAEC,KAA4B,IAAK;IACrEP,WAAW,CAAC,cAAc,EAAE,MAAM;MAChCD,mBAAmB,CAACQ,KAAK,EAAE,CAACC,UAAU,EAAEC,KAAK,EAAEC,KAAK,KAAK;QACvDb,kBAAkB,CAACgB,cAAc,CAACL,UAAU,EAAEC,KAAK,EAAEC,KAAK,CAAC;MAC7D,CAAC,CAAC;IACJ,CAAC,CAAC;EACJ,CAAC,EAAE,EAAE,CAAC;EAEN,MAAMI,aAAa,GAAGpB,KAAK,CAACY,WAAW,CAAEC,KAA4B,IAAK;IACxEP,WAAW,CAAC,cAAc,EAAE,MAAM;MAChC,MAAMe,MAAM,GAAGjB,kBAAkB,CAACS,KAAK,CAAC;MACxC,IAAIQ,MAAM,CAACC,MAAM,KAAK,CAAC,EAAE;QACvBnB,kBAAkB,CAACoB,WAAW,CAAC,CAAC;QAChC;MACF;MACA,KAAK,MAAMC,KAAK,IAAIH,MAAM,EAAE;QAC1BlB,kBAAkB,CAACoB,WAAW,CAACC,KAAK,CAACV,UAAU,CAAC;MAClD;IACF,CAAC,CAAC;EACJ,CAAC,EAAE,EAAE,CAAC;EAEN,oBACEN,IAAA,CAACN,IAAI;IACHuB,KAAK,EAAEC,MAAM,CAACC,IAAK;IACnBC,WAAW,EAAE,KAAM;IACnBjB,YAAY,EAAEA,YAAa;IAC3BO,UAAU,EAAEA,UAAW;IACvBE,aAAa,EAAEA,aAAc;IAC7BS,MAAM,EAAC,8BAA8B;IAAAnB,QAAA,EAEpCA;EAAQ,CACL,CAAC;AAEX;AAEA,MAAMgB,MAAM,GAAGzB,UAAU,CAAC6B,MAAM,CAAC;EAC/BH,IAAI,EAAE;IACJI,IAAI,EAAE;EACR;AACF,CAAC,CAAC","ignoreList":[]}

package/lib/module/runtime/UserflowOverlay.js

@@ -0,0 +1,92 @@
+"use strict";
+
+import * as React from 'react';
+import { ElementPickerOverlay } from "../authoring/ElementPickerOverlay.js";
+import { elementPickerController } from "../authoring/elementPickerController.js";
+import { EvalJsHost } from "../evalJs/EvalJsHost.js";
+import { PreviewModeBanner } from "../pairing/PreviewModeBanner.js";
+import { getPairingController } from "../pairing/pairingRuntime.js";
+import { usePairingState } from "../pairing/usePairingState.js";
+import { usePreviewBarHold } from "../pairing/usePreviewBarHold.js";
+import { BannerHost } from "./BannerHost.js";
+import { FlowRenderer } from "./FlowRenderer.js";
+import { useFlowSessionState } from "./useFlowSessionState.js";
+import { getUserflowCore } from "./userflowCore.js";
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * SDK overlay chrome: preview banner, active flow surface, element picker.
+ * Mounted inside {@link SdkErrorBoundary} so a render throw here cannot
+ * unmount host children of {@link UserflowProvider}.
+ */
+export function UserflowOverlay({
+  engine,
+  bannerEngine,
+  onTrapChange
+}) {
+  const pairingState = usePairingState();
+  const {
+    session,
+    currentStep
+  } = useFlowSessionState(engine);
+  const [previewConfirming, setPreviewConfirming] = React.useState(false);
+  const [pickerActive, setPickerActive] = React.useState(() => elementPickerController.getState().active);
+  React.useEffect(() => {
+    return elementPickerController.subscribe(next => {
+      setPickerActive(next.active);
+    });
+  }, []);
+  const previewHeld = usePreviewBarHold(pairingState, pickerActive);
+  const trapHostAccessibility = React.useMemo(() => {
+    // Picking hides flow chrome, so the host must stay in the accessibility tree.
+    if (pickerActive) {
+      return false;
+    }
+    if (previewConfirming) {
+      return true;
+    }
+    if (!session || !currentStep) {
+      return false;
+    }
+    const appearance = String(currentStep.appearance).toUpperCase();
+    if (appearance === 'HIDDEN') {
+      return false;
+    }
+    if (appearance !== 'TOOLTIP') {
+      return true;
+    }
+    return currentStep.tooltipTargetBlocked;
+  }, [pickerActive, previewConfirming, session, currentStep]);
+  React.useLayoutEffect(() => {
+    onTrapChange(trapHostAccessibility);
+    return () => {
+      // Release whenever this overlay unmounts — including when
+      // SdkErrorBoundary replaces it with null and onError never runs.
+      onTrapChange(false);
+    };
+  }, [onTrapChange, trapHostAccessibility]);
+  const onExitPreview = React.useCallback(() => {
+    void getPairingController(getUserflowCore()).exitPreview();
+  }, []);
+  const onRestartPreview = React.useCallback(() => {
+    void getPairingController(getUserflowCore()).restartPreview();
+  }, []);
+  return /*#__PURE__*/_jsxs(_Fragment, {
+    children: [/*#__PURE__*/_jsx(EvalJsHost, {
+      suppressed: pickerActive
+    }), /*#__PURE__*/_jsx(PreviewModeBanner, {
+      onConfirmingChange: setPreviewConfirming,
+      onExit: onExitPreview,
+      held: previewHeld,
+      onRestart: onRestartPreview,
+      state: pairingState,
+      suppressed: pickerActive
+    }), /*#__PURE__*/_jsx(BannerHost, {
+      engine: bannerEngine,
+      hidden: pickerActive
+    }), pickerActive ? null : /*#__PURE__*/_jsx(FlowRenderer, {
+      engine: engine,
+      previewRestartGeneration: pairingState.previewRestartGeneration
+    }), /*#__PURE__*/_jsx(ElementPickerOverlay, {})]
+  });
+}
+//# sourceMappingURL=UserflowOverlay.js.map

package/lib/module/runtime/UserflowOverlay.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","ElementPickerOverlay","elementPickerController","EvalJsHost","PreviewModeBanner","getPairingController","usePairingState","usePreviewBarHold","BannerHost","FlowRenderer","useFlowSessionState","getUserflowCore","jsx","_jsx","Fragment","_Fragment","jsxs","_jsxs","UserflowOverlay","engine","bannerEngine","onTrapChange","pairingState","session","currentStep","previewConfirming","setPreviewConfirming","useState","pickerActive","setPickerActive","getState","active","useEffect","subscribe","next","previewHeld","trapHostAccessibility","useMemo","appearance","String","toUpperCase","tooltipTargetBlocked","useLayoutEffect","onExitPreview","useCallback","exitPreview","onRestartPreview","restartPreview","children","suppressed","onConfirmingChange","onExit","held","onRestart","state","hidden","previewRestartGeneration"],"sourceRoot":"../../../src","sources":["runtime/UserflowOverlay.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/runtime/UserflowProvider.js

@@ -3,21 +3,62 @@
 import * as React from 'react';
 import { StyleSheet, View } from 'react-native';
 import { FiberScanRoot } from "../anchors/fiber/FiberScanRoot.js";
-import { ElementPickerOverlay } from "../authoring/ElementPickerOverlay.js";
 import { DoubleTapBridge } from "../authoring/chrome/DoubleTapBridge.js";
 import { elementPickerController } from "../authoring/elementPickerController.js";
-import { PreviewModeBanner } from "../pairing/PreviewModeBanner.js";
-import { getPairingController } from "../pairing/pairingRuntime.js";
-import { usePairingState } from "../pairing/usePairingState.js";
 import { ABSOLUTE_FILL } from "../surfaces/absoluteFill.js";
+import { getSafeAreaInsetsContext, useUserflowSafeAreaInsets } from "../surfaces/safeArea.js";
 import { SurfaceLayoutInsetsProvider } from "../surfaces/surfaceLayoutInsets.js";
-import { FlowRenderer } from "./FlowRenderer.js";
+import { BannerHost } from "./BannerHost.js";
+import { SdkErrorBoundary } from "./SdkErrorBoundary.js";
 import { TargetPressBridge } from "./TargetPressBridge.js";
+import { UserflowOverlay } from "./UserflowOverlay.js";
+import { getBannerSessionEngine } from "./bannerEngine.js";
+import { BannerEngineContext } from "./bannerEngineContext.js";
+import { bannerEdge } from "./bannerPlacement.js";
 import { getFlowSessionEngine } from "./flowEngine.js";
-import { useFlowSessionState } from "./useFlowSessionState.js";
+import { isolateSync } from "./isolateCall.js";
+import { useBannerSession } from "./useBannerSession.js";
 import { getUserflowCore } from "./userflowCore.js";
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 const UserflowContext = /*#__PURE__*/React.createContext(null);
+function overlayResetKeyFromEngine(engine) {
+  const session = engine.getFlowSession();
+  if (!session) {
+    return '';
+  }
+  // `ForceGoToStep` updates displayedStepId without rewriting session.currentStep.
+  return `${session.id}:${engine.getCurrentStep()?.id ?? ''}`;
+}
+
+/**
+ * Session/step identity for retrying a crashed overlay. Lives in an effect so a
+ * throw cannot unmount host children (session hooks run inside the overlay
+ * boundary instead).
+ */
+function useOverlayErrorBoundaryResetKey(engine) {
+  const [resetKey, setResetKey] = React.useState(() => {
+    try {
+      return overlayResetKeyFromEngine(engine);
+    } catch {
+      return '';
+    }
+  });
+  React.useEffect(() => {
+    const apply = next => {
+      setResetKey(next);
+    };
+    isolateSync('overlay-reset-key', () => {
+      apply(overlayResetKeyFromEngine(engine));
+    });
+    return engine.on(() => {
+      isolateSync('overlay-reset-key', () => {
+        apply(overlayResetKeyFromEngine(engine));
+      });
+    });
+  }, [engine]);
+  return resetKey;
+}
+
 /**
  * Mount once at the application root, above the navigation container
  * (for example the root `_layout.tsx` or `App` component), after
@@ -29,6 +70,10 @@ const UserflowContext = /*#__PURE__*/React.createContext(null);
  * We deliberately do not use RN `<Modal>` — it is the wrong primitive for
  * non-modal tooltips (WS6).
  *
+ * Overlay render errors are contained by {@link SdkErrorBoundary}; host
+ * children are never inside that boundary. See
+ * `packages/react-native/docs/isolation.md`.
+ *
  * **Expo Router:** also mount `UserflowExpoRouterScreenTracker` from
  * `@userflow-tech/react-native/expo-router` under this provider so pathname and
  * navigation-state changes and path-like NAVIGATE actions are wired. The tracker
@@ -40,82 +85,107 @@ const UserflowContext = /*#__PURE__*/React.createContext(null);
  */
 export function UserflowProvider({
   children,
-  engine: engineProp
+  engine: engineProp,
+  bannerEngine: bannerEngineProp
 }) {
   const engine = engineProp ?? getFlowSessionEngine(getUserflowCore());
+  const bannerEngine = bannerEngineProp ?? getBannerSessionEngine(getUserflowCore());
   const contextValue = React.useMemo(() => ({
     engine
   }), [engine]);
-  const pairingState = usePairingState();
-  const {
-    session,
-    currentStep
-  } = useFlowSessionState(engine);
-  const [previewConfirming, setPreviewConfirming] = React.useState(false);
+  const overlayResetKey = useOverlayErrorBoundaryResetKey(engine);
+  const [trapHostAccessibility, setTrapHostAccessibility] = React.useState(false);
+  const onTrapChange = React.useCallback(trap => {
+    setTrapHostAccessibility(trap);
+  }, []);
+  const onOverlayError = React.useCallback(() => {
+    setTrapHostAccessibility(false);
+  }, []);
+  const bannerSession = useBannerSession(bannerEngine);
+  const safeInsets = useUserflowSafeAreaInsets();
   const [pickerActive, setPickerActive] = React.useState(() => elementPickerController.getState().active);
   React.useEffect(() => {
     return elementPickerController.subscribe(next => {
       setPickerActive(next.active);
     });
   }, []);
-  const trapHostAccessibility = React.useMemo(() => {
-    if (previewConfirming) {
-      return true;
-    }
-    if (!session || !currentStep) {
-      return false;
-    }
-    const appearance = String(currentStep.appearance).toUpperCase();
-    if (appearance === 'HIDDEN') {
-      return false;
-    }
-    if (appearance !== 'TOOLTIP') {
-      return true;
-    }
-    return currentStep.tooltipTargetBlocked;
-  }, [previewConfirming, session, currentStep]);
-  const onExitPreview = React.useCallback(() => {
-    void getPairingController(getUserflowCore()).exitPreview();
-  }, []);
-  const onRestartPreview = React.useCallback(() => {
-    void getPairingController(getUserflowCore()).restartPreview();
-  }, []);
-  return /*#__PURE__*/_jsx(UserflowContext.Provider, {
-    value: contextValue,
-    children: /*#__PURE__*/_jsx(SurfaceLayoutInsetsProvider, {
-      children: /*#__PURE__*/_jsx(DoubleTapBridge, {
-        children: /*#__PURE__*/_jsxs(View, {
-          style: styles.root,
-          collapsable: false,
-          children: [/*#__PURE__*/_jsx(View, {
-            style: styles.appContent,
-            testID: "userflow-app-content",
-            importantForAccessibility: trapHostAccessibility ? 'no-hide-descendants' : undefined,
-            accessibilityElementsHidden: trapHostAccessibility ? true : undefined,
-            children: /*#__PURE__*/_jsx(TargetPressBridge, {
-              children: /*#__PURE__*/_jsx(FiberScanRoot, {
-                children: children
+  const banner = bannerSession?.version.banner ?? null;
+  const flowEdge = banner && banner.overlay === false && !pickerActive ? bannerEdge(banner.embedMode) : null;
+  const hostInsets = flowEdge === 'top' || flowEdge === 'bottom' ? {
+    ...safeInsets,
+    top: flowEdge === 'top' ? 0 : safeInsets.top,
+    bottom: flowEdge === 'bottom' ? 0 : safeInsets.bottom
+  } : null;
+  const appContent = /*#__PURE__*/_jsx(View, {
+    style: styles.appContent,
+    testID: "userflow-app-content",
+    importantForAccessibility: trapHostAccessibility ? 'no-hide-descendants' : undefined,
+    accessibilityElementsHidden: trapHostAccessibility ? true : undefined,
+    children: /*#__PURE__*/_jsx(TargetPressBridge, {
+      children: /*#__PURE__*/_jsx(FiberScanRoot, {
+        children: children
+      })
+    })
+  });
+  return /*#__PURE__*/_jsx(BannerEngineContext.Provider, {
+    value: bannerEngine,
+    children: /*#__PURE__*/_jsx(UserflowContext.Provider, {
+      value: contextValue,
+      children: /*#__PURE__*/_jsx(SurfaceLayoutInsetsProvider, {
+        children: /*#__PURE__*/_jsx(DoubleTapBridge, {
+          children: /*#__PURE__*/_jsxs(View, {
+            style: styles.root,
+            collapsable: false,
+            testID: "userflow-root",
+            children: [/*#__PURE__*/_jsx(BannerHost, {
+              engine: bannerEngine,
+              placement: "flow",
+              edge: "top",
+              hidden: pickerActive
+            }), /*#__PURE__*/_jsx(HostSafeArea, {
+              insets: hostInsets,
+              children: appContent
+            }), /*#__PURE__*/_jsx(BannerHost, {
+              engine: bannerEngine,
+              placement: "flow",
+              edge: "bottom",
+              hidden: pickerActive
+            }), /*#__PURE__*/_jsx(View, {
+              style: styles.overlay,
+              pointerEvents: "box-none",
+              children: /*#__PURE__*/_jsx(SdkErrorBoundary, {
+                scope: "overlay",
+                resetKey: overlayResetKey,
+                onError: onOverlayError,
+                children: /*#__PURE__*/_jsx(UserflowOverlay, {
+                  engine: engine,
+                  bannerEngine: bannerEngine,
+                  onTrapChange: onTrapChange
+                })
               })
-            })
-          }), /*#__PURE__*/_jsxs(View, {
-            style: styles.overlay,
-            pointerEvents: "box-none",
-            children: [/*#__PURE__*/_jsx(PreviewModeBanner, {
-              onConfirmingChange: setPreviewConfirming,
-              onExit: onExitPreview,
-              onRestart: onRestartPreview,
-              state: pairingState,
-              suppressed: pickerActive
-            }), /*#__PURE__*/_jsx(FlowRenderer, {
-              engine: engine,
-              previewRestartGeneration: pairingState.previewRestartGeneration
-            }), /*#__PURE__*/_jsx(ElementPickerOverlay, {})]
-          })]
+            })]
+          })
         })
       })
     })
   });
 }
+function HostSafeArea({
+  insets,
+  children
+}) {
+  const Context = getSafeAreaInsetsContext();
+  const defaultInsets = useUserflowSafeAreaInsets();
+  if (!Context) {
+    return /*#__PURE__*/_jsx(_Fragment, {
+      children: children
+    });
+  }
+  return /*#__PURE__*/_jsx(Context.Provider, {
+    value: insets ?? defaultInsets,
+    children: children
+  });
+}
 
 /** Access the flow session engine from inside {@link UserflowProvider}. */
 export function useUserflow() {

package/lib/module/runtime/UserflowProvider.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","StyleSheet","View","FiberScanRoot","ElementPickerOverlay","DoubleTapBridge","elementPickerController","PreviewModeBanner","getPairingController","usePairingState","ABSOLUTE_FILL","SurfaceLayoutInsetsProvider","FlowRenderer","TargetPressBridge","getFlowSessionEngine","useFlowSessionState","getUserflowCore","jsx","_jsx","jsxs","_jsxs","UserflowContext","createContext","UserflowProvider","children","engine","engineProp","contextValue","useMemo","pairingState","session","currentStep","previewConfirming","setPreviewConfirming","useState","pickerActive","setPickerActive","getState","active","useEffect","subscribe","next","trapHostAccessibility","appearance","String","toUpperCase","tooltipTargetBlocked","onExitPreview","useCallback","exitPreview","onRestartPreview","restartPreview","Provider","value","style","styles","root","collapsable","appContent","testID","importantForAccessibility","undefined","accessibilityElementsHidden","overlay","pointerEvents","onConfirmingChange","onExit","onRestart","state","suppressed","previewRestartGeneration","useUserflow","ctx","useContext","Error","create","flex"],"sourceRoot":"../../../src","sources":["runtime/UserflowProvider.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["React","StyleSheet","View","FiberScanRoot","DoubleTapBridge","elementPickerController","ABSOLUTE_FILL","getSafeAreaInsetsContext","useUserflowSafeAreaInsets","SurfaceLayoutInsetsProvider","BannerHost","SdkErrorBoundary","TargetPressBridge","UserflowOverlay","getBannerSessionEngine","BannerEngineContext","bannerEdge","getFlowSessionEngine","isolateSync","useBannerSession","getUserflowCore","jsx","_jsx","jsxs","_jsxs","Fragment","_Fragment","UserflowContext","createContext","overlayResetKeyFromEngine","engine","session","getFlowSession","id","getCurrentStep","useOverlayErrorBoundaryResetKey","resetKey","setResetKey","useState","useEffect","apply","next","on","UserflowProvider","children","engineProp","bannerEngine","bannerEngineProp","contextValue","useMemo","overlayResetKey","trapHostAccessibility","setTrapHostAccessibility","onTrapChange","useCallback","trap","onOverlayError","bannerSession","safeInsets","pickerActive","setPickerActive","getState","active","subscribe","banner","version","flowEdge","overlay","embedMode","hostInsets","top","bottom","appContent","style","styles","testID","importantForAccessibility","undefined","accessibilityElementsHidden","Provider","value","root","collapsable","placement","edge","hidden","HostSafeArea","insets","pointerEvents","scope","onError","Context","defaultInsets","useUserflow","ctx","useContext","Error","create","flex"],"sourceRoot":"../../../src","sources":["runtime/UserflowProvider.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/runtime/bannerEngine.js

@@ -0,0 +1,55 @@
+"use strict";
+
+import { BannerSessionEngine } from '@userflow-tech/core';
+import { evalJsController } from "../evalJs/evalJsController.js";
+import { openFlowNavigateUrl } from "../navigation/openFlowNavigateUrl.js";
+import { getFlowSessionEngine } from "./flowEngine.js";
+import { isolateAsync } from "./isolateCall.js";
+let bannerEngine = null;
+
+/** Build (once) the module-level banner session engine over a {@link UserflowCore} transport. */
+export function getBannerSessionEngine(core) {
+  if (!bannerEngine) {
+    bannerEngine = new BannerSessionEngine({
+      transport: {
+        send: message => core.send(message),
+        onServerMessage: handler => core.onServerMessage(handler),
+        setBannerSessionId: id => core.setBannerSessionId(id)
+      },
+      flowActions: () => getFlowSessionEngine(core),
+      onOpenExternalUrl: url => {
+        void isolateAsync('navigate', () => openFlowNavigateUrl(url), {
+          rethrowHostContract: false
+        });
+      },
+      onEvalJs: request => {
+        evalJsController.enqueue(request);
+      }
+    });
+  }
+  return bannerEngine;
+}
+
+/** Subscribe the engine to inbound server messages. Call after identify. */
+export function attachBannerSessionEngine(core) {
+  const engine = getBannerSessionEngine(core);
+  engine.attach();
+  return engine;
+}
+
+/** Clear the banner session and detach. Call from {@link Userflow.reset}. */
+export function resetBannerSessionEngine() {
+  bannerEngine?.reset();
+}
+
+/** Drop the local banner without detaching (preview exit, user switch). */
+export function clearBannerSessionEngineLocalSession() {
+  bannerEngine?.clearLocalSession();
+}
+
+/** Test helper: drop the singleton so the next get recreates it. */
+export function __resetBannerSessionEngineForTests() {
+  bannerEngine?.reset();
+  bannerEngine = null;
+}
+//# sourceMappingURL=bannerEngine.js.map

package/lib/module/runtime/bannerEngine.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["BannerSessionEngine","evalJsController","openFlowNavigateUrl","getFlowSessionEngine","isolateAsync","bannerEngine","getBannerSessionEngine","core","transport","send","message","onServerMessage","handler","setBannerSessionId","id","flowActions","onOpenExternalUrl","url","rethrowHostContract","onEvalJs","request","enqueue","attachBannerSessionEngine","engine","attach","resetBannerSessionEngine","reset","clearBannerSessionEngineLocalSession","clearLocalSession","__resetBannerSessionEngineForTests"],"sourceRoot":"../../../src","sources":["runtime/bannerEngine.ts"],"mappings":";;AAAA,SAASA,mBAAmB,QAA2B,qBAAqB;AAE5E,SAASC,gBAAgB,QAAQ,+BAA4B;AAC7D,SAASC,mBAAmB,QAAQ,sCAAmC;AAEvE,SAASC,oBAAoB,QAAQ,iBAAc;AACnD,SAASC,YAAY,QAAQ,kBAAe;AAE5C,IAAIC,YAAwC,GAAG,IAAI;;AAEnD;AACA,OAAO,SAASC,sBAAsBA,CAACC,IAAkB,EAAuB;EAC9E,IAAI,CAACF,YAAY,EAAE;IACjBA,YAAY,GAAG,IAAIL,mBAAmB,CAAC;MACrCQ,SAAS,EAAE;QACTC,IAAI,EAAGC,OAAO,IAAKH,IAAI,CAACE,IAAI,CAACC,OAAO,CAAC;QACrCC,eAAe,EAAGC,OAAO,IAAKL,IAAI,CAACI,eAAe,CAACC,OAAO,CAAC;QAC3DC,kBAAkB,EAAGC,EAAE,IAAKP,IAAI,CAACM,kBAAkB,CAACC,EAAE;MACxD,CAAC;MACDC,WAAW,EAAEA,CAAA,KAAMZ,oBAAoB,CAACI,IAAI,CAAC;MAC7CS,iBAAiB,EAAGC,GAAG,IAAK;QAC1B,KAAKb,YAAY,CAAC,UAAU,EAAE,MAAMF,mBAAmB,CAACe,GAAG,CAAC,EAAE;UAC5DC,mBAAmB,EAAE;QACvB,CAAC,CAAC;MACJ,CAAC;MACDC,QAAQ,EAAGC,OAAO,IAAK;QACrBnB,gBAAgB,CAACoB,OAAO,CAACD,OAAO,CAAC;MACnC;IACF,CAAC,CAAC;EACJ;EACA,OAAOf,YAAY;AACrB;;AAEA;AACA,OAAO,SAASiB,yBAAyBA,CAACf,IAAkB,EAAuB;EACjF,MAAMgB,MAAM,GAAGjB,sBAAsB,CAACC,IAAI,CAAC;EAC3CgB,MAAM,CAACC,MAAM,CAAC,CAAC;EACf,OAAOD,MAAM;AACf;;AAEA;AACA,OAAO,SAASE,wBAAwBA,CAAA,EAAS;EAC/CpB,YAAY,EAAEqB,KAAK,CAAC,CAAC;AACvB;;AAEA;AACA,OAAO,SAASC,oCAAoCA,CAAA,EAAS;EAC3DtB,YAAY,EAAEuB,iBAAiB,CAAC,CAAC;AACnC;;AAEA;AACA,OAAO,SAASC,kCAAkCA,CAAA,EAAS;EACzDxB,YAAY,EAAEqB,KAAK,CAAC,CAAC;EACrBrB,YAAY,GAAG,IAAI;AACrB","ignoreList":[]}

package/lib/module/runtime/bannerEngineContext.js

@@ -0,0 +1,7 @@
+"use strict";
+
+import * as React from 'react';
+
+/** Banner engine for host slots. Null outside {@link UserflowProvider}. */
+export const BannerEngineContext = /*#__PURE__*/React.createContext(null);
+//# sourceMappingURL=bannerEngineContext.js.map

package/lib/module/runtime/bannerEngineContext.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","BannerEngineContext","createContext"],"sourceRoot":"../../../src","sources":["runtime/bannerEngineContext.ts"],"mappings":";;AACA,OAAO,KAAKA,KAAK,MAAM,OAAO;;AAE9B;AACA,OAAO,MAAMC,mBAAmB,gBAAGD,KAAK,CAACE,aAAa,CAA6B,IAAI,CAAC","ignoreList":[]}

package/lib/module/runtime/bannerPlacement.js

@@ -0,0 +1,30 @@
+"use strict";
+
+import { resolveManualAnchorId } from "../anchors/resolveManualAnchorId.js";
+const warned = new Set();
+
+/** Body-first is the top edge; body-last is the bottom. Element modes use a placeholder. */
+export function bannerEdge(mode) {
+  if (mode === 'BODY_FIRST') return 'top';
+  if (mode === 'BODY_LAST') return 'bottom';
+  return null;
+}
+
+/**
+ * Id of the {@link EmbedBannerPlaceholder} an element-mode banner fills.
+ * Manual selectors use `#welcome-banner` or `welcome-banner`. Body modes
+ * return null so a top/bottom bar never occupies a host slot.
+ */
+export function embedBannerPlaceholderId(banner) {
+  if (bannerEdge(banner.embedMode)) return null;
+  return resolveManualAnchorId(banner.embedSelector?.css);
+}
+export function warnBannerOnce(key, message, warn = console.warn) {
+  if (warned.has(key)) return;
+  warned.add(key);
+  warn(message);
+}
+export function resetBannerWarningsForTests() {
+  warned.clear();
+}
+//# sourceMappingURL=bannerPlacement.js.map

package/lib/module/runtime/bannerPlacement.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["resolveManualAnchorId","warned","Set","bannerEdge","mode","embedBannerPlaceholderId","banner","embedMode","embedSelector","css","warnBannerOnce","key","message","warn","console","has","add","resetBannerWarningsForTests","clear"],"sourceRoot":"../../../src","sources":["runtime/bannerPlacement.ts"],"mappings":";;AAEA,SAASA,qBAAqB,QAAQ,qCAAkC;AAExE,MAAMC,MAAM,GAAG,IAAIC,GAAG,CAAS,CAAC;;AAEhC;AACA,OAAO,SAASC,UAAUA,CAACC,IAA8B,EAA2B;EAClF,IAAIA,IAAI,KAAK,YAAY,EAAE,OAAO,KAAK;EACvC,IAAIA,IAAI,KAAK,WAAW,EAAE,OAAO,QAAQ;EACzC,OAAO,IAAI;AACb;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,wBAAwBA,CAACC,MAAsB,EAAiB;EAC9E,IAAIH,UAAU,CAACG,MAAM,CAACC,SAAS,CAAC,EAAE,OAAO,IAAI;EAC7C,OAAOP,qBAAqB,CAACM,MAAM,CAACE,aAAa,EAAEC,GAAG,CAAC;AACzD;AAEA,OAAO,SAASC,cAAcA,CAC5BC,GAAW,EACXC,OAAe,EACfC,IAA+B,GAAGC,OAAO,CAACD,IAAI,EACxC;EACN,IAAIZ,MAAM,CAACc,GAAG,CAACJ,GAAG,CAAC,EAAE;EACrBV,MAAM,CAACe,GAAG,CAACL,GAAG,CAAC;EACfE,IAAI,CAACD,OAAO,CAAC;AACf;AAEA,OAAO,SAASK,2BAA2BA,CAAA,EAAS;EAClDhB,MAAM,CAACiB,KAAK,CAAC,CAAC;AAChB","ignoreList":[]}