@userflow-tech/react-native 0.1.1 → 0.3.0

package/lib/commonjs/runtime/UserflowOverlay.js

@@ -0,0 +1,97 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.UserflowOverlay = UserflowOverlay;
+var React = _interopRequireWildcard(require("react"));
+var _ElementPickerOverlay = require("../authoring/ElementPickerOverlay.js");
+var _elementPickerController = require("../authoring/elementPickerController.js");
+var _EvalJsHost = require("../evalJs/EvalJsHost.js");
+var _PreviewModeBanner = require("../pairing/PreviewModeBanner.js");
+var _pairingRuntime = require("../pairing/pairingRuntime.js");
+var _usePairingState = require("../pairing/usePairingState.js");
+var _usePreviewBarHold = require("../pairing/usePreviewBarHold.js");
+var _BannerHost = require("./BannerHost.js");
+var _FlowRenderer = require("./FlowRenderer.js");
+var _useFlowSessionState = require("./useFlowSessionState.js");
+var _userflowCore = require("./userflowCore.js");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/**
+ * 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}.
+ */
+function UserflowOverlay({
+  engine,
+  bannerEngine,
+  onTrapChange
+}) {
+  const pairingState = (0, _usePairingState.usePairingState)();
+  const {
+    session,
+    currentStep
+  } = (0, _useFlowSessionState.useFlowSessionState)(engine);
+  const [previewConfirming, setPreviewConfirming] = React.useState(false);
+  const [pickerActive, setPickerActive] = React.useState(() => _elementPickerController.elementPickerController.getState().active);
+  React.useEffect(() => {
+    return _elementPickerController.elementPickerController.subscribe(next => {
+      setPickerActive(next.active);
+    });
+  }, []);
+  const previewHeld = (0, _usePreviewBarHold.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 (0, _pairingRuntime.getPairingController)((0, _userflowCore.getUserflowCore)()).exitPreview();
+  }, []);
+  const onRestartPreview = React.useCallback(() => {
+    void (0, _pairingRuntime.getPairingController)((0, _userflowCore.getUserflowCore)()).restartPreview();
+  }, []);
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_jsxRuntime.Fragment, {
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_EvalJsHost.EvalJsHost, {
+      suppressed: pickerActive
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_PreviewModeBanner.PreviewModeBanner, {
+      onConfirmingChange: setPreviewConfirming,
+      onExit: onExitPreview,
+      held: previewHeld,
+      onRestart: onRestartPreview,
+      state: pairingState,
+      suppressed: pickerActive
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_BannerHost.BannerHost, {
+      engine: bannerEngine,
+      hidden: pickerActive
+    }), pickerActive ? null : /*#__PURE__*/(0, _jsxRuntime.jsx)(_FlowRenderer.FlowRenderer, {
+      engine: engine,
+      previewRestartGeneration: pairingState.previewRestartGeneration
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_ElementPickerOverlay.ElementPickerOverlay, {})]
+  });
+}
+//# sourceMappingURL=UserflowOverlay.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["React","_interopRequireWildcard","require","_ElementPickerOverlay","_elementPickerController","_EvalJsHost","_PreviewModeBanner","_pairingRuntime","_usePairingState","_usePreviewBarHold","_BannerHost","_FlowRenderer","_useFlowSessionState","_userflowCore","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","UserflowOverlay","engine","bannerEngine","onTrapChange","pairingState","usePairingState","session","currentStep","useFlowSessionState","previewConfirming","setPreviewConfirming","useState","pickerActive","setPickerActive","elementPickerController","getState","active","useEffect","subscribe","next","previewHeld","usePreviewBarHold","trapHostAccessibility","useMemo","appearance","String","toUpperCase","tooltipTargetBlocked","useLayoutEffect","onExitPreview","useCallback","getPairingController","getUserflowCore","exitPreview","onRestartPreview","restartPreview","jsxs","Fragment","children","jsx","EvalJsHost","suppressed","PreviewModeBanner","onConfirmingChange","onExit","held","onRestart","state","BannerHost","hidden","FlowRenderer","previewRestartGeneration","ElementPickerOverlay"],"sourceRoot":"../../../src","sources":["runtime/UserflowOverlay.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/runtime/UserflowProvider.js

@@ -8,69 +8,190 @@ exports.useUserflow = useUserflow;
 var React = _interopRequireWildcard(require("react"));
 var _reactNative = require("react-native");
 var _FiberScanRoot = require("../anchors/fiber/FiberScanRoot.js");
-var _PreviewModeBanner = require("../pairing/PreviewModeBanner.js");
-var _pairingRuntime = require("../pairing/pairingRuntime.js");
-var _usePairingState = require("../pairing/usePairingState.js");
+var _DoubleTapBridge = require("../authoring/chrome/DoubleTapBridge.js");
+var _elementPickerController = require("../authoring/elementPickerController.js");
 var _absoluteFill = require("../surfaces/absoluteFill.js");
-var _FlowRenderer = require("./FlowRenderer.js");
+var _safeArea = require("../surfaces/safeArea.js");
+var _surfaceLayoutInsets = require("../surfaces/surfaceLayoutInsets.js");
+var _BannerHost = require("./BannerHost.js");
+var _SdkErrorBoundary = require("./SdkErrorBoundary.js");
 var _TargetPressBridge = require("./TargetPressBridge.js");
+var _UserflowOverlay = require("./UserflowOverlay.js");
+var _bannerEngine = require("./bannerEngine.js");
+var _bannerEngineContext = require("./bannerEngineContext.js");
+var _bannerPlacement = require("./bannerPlacement.js");
 var _flowEngine = require("./flowEngine.js");
+var _isolateCall = require("./isolateCall.js");
+var _useBannerSession = require("./useBannerSession.js");
 var _userflowCore = require("./userflowCore.js");
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 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);
+    };
+    (0, _isolateCall.isolateSync)('overlay-reset-key', () => {
+      apply(overlayResetKeyFromEngine(engine));
+    });
+    return engine.on(() => {
+      (0, _isolateCall.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
  * calling {@link Userflow.init}.
  *
  * Children render normally. An absolute overlay sits above them with
- * `pointerEvents="box-none"` so taps pass through except where flow UI sits.
+ * `pointerEvents="box-none"` so taps pass through except where flow UI blocks
+ * them (modals always; tooltips when interaction blocking is enabled).
  * 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 changes
- * and path-like NAVIGATE actions are wired. The tracker is a separate entry so
- * apps without `expo-router` are not forced to install that peer.
+ * `@userflow-tech/react-native/expo-router` under this provider so pathname and
+ * navigation-state changes and path-like NAVIGATE actions are wired. The tracker
+ * is a separate entry so apps without `expo-router` are not forced to install
+ * that peer.
  *
  * **React Navigation:** wrap `NavigationContainer` with
  * {@link WithUserflowReactNavigation} from `@userflow-tech/react-native/navigation`.
  */
 function UserflowProvider({
   children,
-  engine: engineProp
+  engine: engineProp,
+  bannerEngine: bannerEngineProp
 }) {
   const engine = engineProp ?? (0, _flowEngine.getFlowSessionEngine)((0, _userflowCore.getUserflowCore)());
+  const bannerEngine = bannerEngineProp ?? (0, _bannerEngine.getBannerSessionEngine)((0, _userflowCore.getUserflowCore)());
   const contextValue = React.useMemo(() => ({
     engine
   }), [engine]);
-  const pairingState = (0, _usePairingState.usePairingState)();
-  const onExitPreview = React.useCallback(() => {
-    void (0, _pairingRuntime.getPairingController)((0, _userflowCore.getUserflowCore)()).exitPreview();
+  const overlayResetKey = useOverlayErrorBoundaryResetKey(engine);
+  const [trapHostAccessibility, setTrapHostAccessibility] = React.useState(false);
+  const onTrapChange = React.useCallback(trap => {
+    setTrapHostAccessibility(trap);
+  }, []);
+  const onOverlayError = React.useCallback(() => {
+    setTrapHostAccessibility(false);
   }, []);
-  return /*#__PURE__*/(0, _jsxRuntime.jsx)(UserflowContext.Provider, {
-    value: contextValue,
-    children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
-      style: styles.root,
-      collapsable: false,
-      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_TargetPressBridge.TargetPressBridge, {
-        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_FiberScanRoot.FiberScanRoot, {
-          children: children
+  const bannerSession = (0, _useBannerSession.useBannerSession)(bannerEngine);
+  const safeInsets = (0, _safeArea.useUserflowSafeAreaInsets)();
+  const [pickerActive, setPickerActive] = React.useState(() => _elementPickerController.elementPickerController.getState().active);
+  React.useEffect(() => {
+    return _elementPickerController.elementPickerController.subscribe(next => {
+      setPickerActive(next.active);
+    });
+  }, []);
+  const banner = bannerSession?.version.banner ?? null;
+  const flowEdge = banner && banner.overlay === false && !pickerActive ? (0, _bannerPlacement.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__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+    style: styles.appContent,
+    testID: "userflow-app-content",
+    importantForAccessibility: trapHostAccessibility ? 'no-hide-descendants' : undefined,
+    accessibilityElementsHidden: trapHostAccessibility ? true : undefined,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_TargetPressBridge.TargetPressBridge, {
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_FiberScanRoot.FiberScanRoot, {
+        children: children
+      })
+    })
+  });
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_bannerEngineContext.BannerEngineContext.Provider, {
+    value: bannerEngine,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(UserflowContext.Provider, {
+      value: contextValue,
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_surfaceLayoutInsets.SurfaceLayoutInsetsProvider, {
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_DoubleTapBridge.DoubleTapBridge, {
+          children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+            style: styles.root,
+            collapsable: false,
+            testID: "userflow-root",
+            children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_BannerHost.BannerHost, {
+              engine: bannerEngine,
+              placement: "flow",
+              edge: "top",
+              hidden: pickerActive
+            }), /*#__PURE__*/(0, _jsxRuntime.jsx)(HostSafeArea, {
+              insets: hostInsets,
+              children: appContent
+            }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_BannerHost.BannerHost, {
+              engine: bannerEngine,
+              placement: "flow",
+              edge: "bottom",
+              hidden: pickerActive
+            }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.View, {
+              style: styles.overlay,
+              pointerEvents: "box-none",
+              children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_SdkErrorBoundary.SdkErrorBoundary, {
+                scope: "overlay",
+                resetKey: overlayResetKey,
+                onError: onOverlayError,
+                children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_UserflowOverlay.UserflowOverlay, {
+                  engine: engine,
+                  bannerEngine: bannerEngine,
+                  onTrapChange: onTrapChange
+                })
+              })
+            })]
+          })
         })
-      }), /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
-        style: styles.overlay,
-        pointerEvents: "box-none",
-        children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_PreviewModeBanner.PreviewModeBanner, {
-          state: pairingState,
-          onExit: onExitPreview
-        }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_FlowRenderer.FlowRenderer, {
-          engine: engine
-        })]
-      })]
+      })
     })
   });
 }
+function HostSafeArea({
+  insets,
+  children
+}) {
+  const Context = (0, _safeArea.getSafeAreaInsetsContext)();
+  const defaultInsets = (0, _safeArea.useUserflowSafeAreaInsets)();
+  if (!Context) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_jsxRuntime.Fragment, {
+      children: children
+    });
+  }
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(Context.Provider, {
+    value: insets ?? defaultInsets,
+    children: children
+  });
+}
 
 /** Access the flow session engine from inside {@link UserflowProvider}. */
 function useUserflow() {
@@ -84,6 +205,9 @@ const styles = _reactNative.StyleSheet.create({
   root: {
     flex: 1
   },
+  appContent: {
+    flex: 1
+  },
   overlay: {
     ..._absoluteFill.ABSOLUTE_FILL
   }

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

@@ -1 +1 @@
-{"version":3,"names":["React","_interopRequireWildcard","require","_reactNative","_FiberScanRoot","_PreviewModeBanner","_pairingRuntime","_usePairingState","_absoluteFill","_FlowRenderer","_TargetPressBridge","_flowEngine","_userflowCore","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","UserflowContext","createContext","UserflowProvider","children","engine","engineProp","getFlowSessionEngine","getUserflowCore","contextValue","useMemo","pairingState","usePairingState","onExitPreview","useCallback","getPairingController","exitPreview","jsx","Provider","value","jsxs","View","style","styles","root","collapsable","TargetPressBridge","FiberScanRoot","overlay","pointerEvents","PreviewModeBanner","state","onExit","FlowRenderer","useUserflow","ctx","useContext","Error","StyleSheet","create","flex","ABSOLUTE_FILL"],"sourceRoot":"../../../src","sources":["runtime/UserflowProvider.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["React","_interopRequireWildcard","require","_reactNative","_FiberScanRoot","_DoubleTapBridge","_elementPickerController","_absoluteFill","_safeArea","_surfaceLayoutInsets","_BannerHost","_SdkErrorBoundary","_TargetPressBridge","_UserflowOverlay","_bannerEngine","_bannerEngineContext","_bannerPlacement","_flowEngine","_isolateCall","_useBannerSession","_userflowCore","_jsxRuntime","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","UserflowContext","createContext","overlayResetKeyFromEngine","engine","session","getFlowSession","id","getCurrentStep","useOverlayErrorBoundaryResetKey","resetKey","setResetKey","useState","useEffect","apply","next","isolateSync","on","UserflowProvider","children","engineProp","bannerEngine","bannerEngineProp","getFlowSessionEngine","getUserflowCore","getBannerSessionEngine","contextValue","useMemo","overlayResetKey","trapHostAccessibility","setTrapHostAccessibility","onTrapChange","useCallback","trap","onOverlayError","bannerSession","useBannerSession","safeInsets","useUserflowSafeAreaInsets","pickerActive","setPickerActive","elementPickerController","getState","active","subscribe","banner","version","flowEdge","overlay","bannerEdge","embedMode","hostInsets","top","bottom","appContent","jsx","View","style","styles","testID","importantForAccessibility","undefined","accessibilityElementsHidden","TargetPressBridge","FiberScanRoot","BannerEngineContext","Provider","value","SurfaceLayoutInsetsProvider","DoubleTapBridge","jsxs","root","collapsable","BannerHost","placement","edge","hidden","HostSafeArea","insets","pointerEvents","SdkErrorBoundary","scope","onError","UserflowOverlay","Context","getSafeAreaInsetsContext","defaultInsets","Fragment","useUserflow","ctx","useContext","Error","StyleSheet","create","flex","ABSOLUTE_FILL"],"sourceRoot":"../../../src","sources":["runtime/UserflowProvider.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/runtime/bannerEngine.js

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

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

@@ -0,0 +1 @@
+{"version":3,"names":["_core","require","_evalJsController","_openFlowNavigateUrl","_flowEngine","_isolateCall","bannerEngine","getBannerSessionEngine","core","BannerSessionEngine","transport","send","message","onServerMessage","handler","setBannerSessionId","id","flowActions","getFlowSessionEngine","onOpenExternalUrl","url","isolateAsync","openFlowNavigateUrl","rethrowHostContract","onEvalJs","request","evalJsController","enqueue","attachBannerSessionEngine","engine","attach","resetBannerSessionEngine","reset","clearBannerSessionEngineLocalSession","clearLocalSession","__resetBannerSessionEngineForTests"],"sourceRoot":"../../../src","sources":["runtime/bannerEngine.ts"],"mappings":";;;;;;;;;;AAAA,IAAAA,KAAA,GAAAC,OAAA;AAEA,IAAAC,iBAAA,GAAAD,OAAA;AACA,IAAAE,oBAAA,GAAAF,OAAA;AAEA,IAAAG,WAAA,GAAAH,OAAA;AACA,IAAAI,YAAA,GAAAJ,OAAA;AAEA,IAAIK,YAAwC,GAAG,IAAI;;AAEnD;AACO,SAASC,sBAAsBA,CAACC,IAAkB,EAAuB;EAC9E,IAAI,CAACF,YAAY,EAAE;IACjBA,YAAY,GAAG,IAAIG,yBAAmB,CAAC;MACrCC,SAAS,EAAE;QACTC,IAAI,EAAGC,OAAO,IAAKJ,IAAI,CAACG,IAAI,CAACC,OAAO,CAAC;QACrCC,eAAe,EAAGC,OAAO,IAAKN,IAAI,CAACK,eAAe,CAACC,OAAO,CAAC;QAC3DC,kBAAkB,EAAGC,EAAE,IAAKR,IAAI,CAACO,kBAAkB,CAACC,EAAE;MACxD,CAAC;MACDC,WAAW,EAAEA,CAAA,KAAM,IAAAC,gCAAoB,EAACV,IAAI,CAAC;MAC7CW,iBAAiB,EAAGC,GAAG,IAAK;QAC1B,KAAK,IAAAC,yBAAY,EAAC,UAAU,EAAE,MAAM,IAAAC,wCAAmB,EAACF,GAAG,CAAC,EAAE;UAC5DG,mBAAmB,EAAE;QACvB,CAAC,CAAC;MACJ,CAAC;MACDC,QAAQ,EAAGC,OAAO,IAAK;QACrBC,kCAAgB,CAACC,OAAO,CAACF,OAAO,CAAC;MACnC;IACF,CAAC,CAAC;EACJ;EACA,OAAOnB,YAAY;AACrB;;AAEA;AACO,SAASsB,yBAAyBA,CAACpB,IAAkB,EAAuB;EACjF,MAAMqB,MAAM,GAAGtB,sBAAsB,CAACC,IAAI,CAAC;EAC3CqB,MAAM,CAACC,MAAM,CAAC,CAAC;EACf,OAAOD,MAAM;AACf;;AAEA;AACO,SAASE,wBAAwBA,CAAA,EAAS;EAC/CzB,YAAY,EAAE0B,KAAK,CAAC,CAAC;AACvB;;AAEA;AACO,SAASC,oCAAoCA,CAAA,EAAS;EAC3D3B,YAAY,EAAE4B,iBAAiB,CAAC,CAAC;AACnC;;AAEA;AACO,SAASC,kCAAkCA,CAAA,EAAS;EACzD7B,YAAY,EAAE0B,KAAK,CAAC,CAAC;EACrB1B,YAAY,GAAG,IAAI;AACrB","ignoreList":[]}

package/lib/commonjs/runtime/bannerEngineContext.js

@@ -0,0 +1,11 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.BannerEngineContext = void 0;
+var React = _interopRequireWildcard(require("react"));
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+/** Banner engine for host slots. Null outside {@link UserflowProvider}. */
+const BannerEngineContext = exports.BannerEngineContext = /*#__PURE__*/React.createContext(null);
+//# sourceMappingURL=bannerEngineContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["React","_interopRequireWildcard","require","e","t","WeakMap","r","n","__esModule","o","i","f","__proto__","default","has","get","set","hasOwnProperty","call","Object","defineProperty","getOwnPropertyDescriptor","BannerEngineContext","exports","createContext"],"sourceRoot":"../../../src","sources":["runtime/bannerEngineContext.ts"],"mappings":";;;;;;AACA,IAAAA,KAAA,GAAAC,uBAAA,CAAAC,OAAA;AAA+B,SAAAD,wBAAAE,CAAA,EAAAC,CAAA,6BAAAC,OAAA,MAAAC,CAAA,OAAAD,OAAA,IAAAE,CAAA,OAAAF,OAAA,YAAAJ,uBAAA,YAAAA,CAAAE,CAAA,EAAAC,CAAA,SAAAA,CAAA,IAAAD,CAAA,IAAAA,CAAA,CAAAK,UAAA,SAAAL,CAAA,MAAAM,CAAA,EAAAC,CAAA,EAAAC,CAAA,KAAAC,SAAA,QAAAC,OAAA,EAAAV,CAAA,iBAAAA,CAAA,uBAAAA,CAAA,yBAAAA,CAAA,SAAAQ,CAAA,MAAAF,CAAA,GAAAL,CAAA,GAAAG,CAAA,GAAAD,CAAA,QAAAG,CAAA,CAAAK,GAAA,CAAAX,CAAA,UAAAM,CAAA,CAAAM,GAAA,CAAAZ,CAAA,GAAAM,CAAA,CAAAO,GAAA,CAAAb,CAAA,EAAAQ,CAAA,gBAAAP,CAAA,IAAAD,CAAA,gBAAAC,CAAA,OAAAa,cAAA,CAAAC,IAAA,CAAAf,CAAA,EAAAC,CAAA,OAAAM,CAAA,IAAAD,CAAA,GAAAU,MAAA,CAAAC,cAAA,KAAAD,MAAA,CAAAE,wBAAA,CAAAlB,CAAA,EAAAC,CAAA,OAAAM,CAAA,CAAAK,GAAA,IAAAL,CAAA,CAAAM,GAAA,IAAAP,CAAA,CAAAE,CAAA,EAAAP,CAAA,EAAAM,CAAA,IAAAC,CAAA,CAAAP,CAAA,IAAAD,CAAA,CAAAC,CAAA,WAAAO,CAAA,KAAAR,CAAA,EAAAC,CAAA;AAE/B;AACO,MAAMkB,mBAAmB,GAAAC,OAAA,CAAAD,mBAAA,gBAAGtB,KAAK,CAACwB,aAAa,CAA6B,IAAI,CAAC","ignoreList":[]}

package/lib/commonjs/runtime/bannerPlacement.js

@@ -0,0 +1,37 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.bannerEdge = bannerEdge;
+exports.embedBannerPlaceholderId = embedBannerPlaceholderId;
+exports.resetBannerWarningsForTests = resetBannerWarningsForTests;
+exports.warnBannerOnce = warnBannerOnce;
+var _resolveManualAnchorId = require("../anchors/resolveManualAnchorId.js");
+const warned = new Set();
+
+/** Body-first is the top edge; body-last is the bottom. Element modes use a placeholder. */
+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.
+ */
+function embedBannerPlaceholderId(banner) {
+  if (bannerEdge(banner.embedMode)) return null;
+  return (0, _resolveManualAnchorId.resolveManualAnchorId)(banner.embedSelector?.css);
+}
+function warnBannerOnce(key, message, warn = console.warn) {
+  if (warned.has(key)) return;
+  warned.add(key);
+  warn(message);
+}
+function resetBannerWarningsForTests() {
+  warned.clear();
+}
+//# sourceMappingURL=bannerPlacement.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["_resolveManualAnchorId","require","warned","Set","bannerEdge","mode","embedBannerPlaceholderId","banner","embedMode","resolveManualAnchorId","embedSelector","css","warnBannerOnce","key","message","warn","console","has","add","resetBannerWarningsForTests","clear"],"sourceRoot":"../../../src","sources":["runtime/bannerPlacement.ts"],"mappings":";;;;;;;;;AAEA,IAAAA,sBAAA,GAAAC,OAAA;AAEA,MAAMC,MAAM,GAAG,IAAIC,GAAG,CAAS,CAAC;;AAEhC;AACO,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;AACO,SAASC,wBAAwBA,CAACC,MAAsB,EAAiB;EAC9E,IAAIH,UAAU,CAACG,MAAM,CAACC,SAAS,CAAC,EAAE,OAAO,IAAI;EAC7C,OAAO,IAAAC,4CAAqB,EAACF,MAAM,CAACG,aAAa,EAAEC,GAAG,CAAC;AACzD;AAEO,SAASC,cAAcA,CAC5BC,GAAW,EACXC,OAAe,EACfC,IAA+B,GAAGC,OAAO,CAACD,IAAI,EACxC;EACN,IAAIb,MAAM,CAACe,GAAG,CAACJ,GAAG,CAAC,EAAE;EACrBX,MAAM,CAACgB,GAAG,CAACL,GAAG,CAAC;EACfE,IAAI,CAACD,OAAO,CAAC;AACf;AAEO,SAASK,2BAA2BA,CAAA,EAAS;EAClDjB,MAAM,CAACkB,KAAK,CAAC,CAAC;AAChB","ignoreList":[]}

package/lib/commonjs/runtime/changedTouchPoints.js

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.changedTouchPoints = changedTouchPoints;
+exports.forEachChangedTouch = forEachChangedTouch;
+/**
+ * Touches that just started/ended/cancelled for this event. Prefer
+ * `changedTouches` so multi-touch uses the finger(s) that actually changed —
+ * `touches[0]` may be an already-active finger. Each touch carries `identifier`
+ * so monitors can pair start/end per finger.
+ */
+function changedTouchPoints(event) {
+  const {
+    changedTouches,
+    touches,
+    identifier,
+    pageX,
+    pageY
+  } = event.nativeEvent;
+  if (changedTouches && changedTouches.length > 0) {
+    return changedTouches.map(touch => ({
+      identifier: touch.identifier,
+      pageX: touch.pageX,
+      pageY: touch.pageY
+    }));
+  }
+  if (touches && touches.length > 0) {
+    const touch = touches[touches.length - 1];
+    return [{
+      identifier: touch.identifier,
+      pageX: touch.pageX,
+      pageY: touch.pageY
+    }];
+  }
+  return [{
+    identifier: identifier ?? 0,
+    pageX,
+    pageY
+  }];
+}
+function forEachChangedTouch(event, fn) {
+  for (const touch of changedTouchPoints(event)) {
+    fn(touch.identifier, touch.pageX, touch.pageY);
+  }
+}
+//# sourceMappingURL=changedTouchPoints.js.map

package/lib/commonjs/runtime/changedTouchPoints.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["changedTouchPoints","event","changedTouches","touches","identifier","pageX","pageY","nativeEvent","length","map","touch","forEachChangedTouch","fn"],"sourceRoot":"../../../src","sources":["runtime/changedTouchPoints.ts"],"mappings":";;;;;;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASA,kBAAkBA,CAChCC,KAA4B,EACqC;EACjE,MAAM;IAAEC,cAAc;IAAEC,OAAO;IAAEC,UAAU;IAAEC,KAAK;IAAEC;EAAM,CAAC,GAAGL,KAAK,CAACM,WAAW;EAC/E,IAAIL,cAAc,IAAIA,cAAc,CAACM,MAAM,GAAG,CAAC,EAAE;IAC/C,OAAON,cAAc,CAACO,GAAG,CAAEC,KAAK,KAAM;MACpCN,UAAU,EAAEM,KAAK,CAACN,UAAU;MAC5BC,KAAK,EAAEK,KAAK,CAACL,KAAK;MAClBC,KAAK,EAAEI,KAAK,CAACJ;IACf,CAAC,CAAC,CAAC;EACL;EACA,IAAIH,OAAO,IAAIA,OAAO,CAACK,MAAM,GAAG,CAAC,EAAE;IACjC,MAAME,KAAK,GAAGP,OAAO,CAACA,OAAO,CAACK,MAAM,GAAG,CAAC,CAAE;IAC1C,OAAO,CAAC;MAAEJ,UAAU,EAAEM,KAAK,CAACN,UAAU;MAAEC,KAAK,EAAEK,KAAK,CAACL,KAAK;MAAEC,KAAK,EAAEI,KAAK,CAACJ;IAAM,CAAC,CAAC;EACnF;EACA,OAAO,CAAC;IAAEF,UAAU,EAAEA,UAAU,IAAI,CAAC;IAAEC,KAAK;IAAEC;EAAM,CAAC,CAAC;AACxD;AAEO,SAASK,mBAAmBA,CACjCV,KAA4B,EAC5BW,EAAsF,EAChF;EACN,KAAK,MAAMF,KAAK,IAAIV,kBAAkB,CAACC,KAAK,CAAC,EAAE;IAC7CW,EAAE,CAACF,KAAK,CAACN,UAAU,EAAEM,KAAK,CAACL,KAAK,EAAEK,KAAK,CAACJ,KAAK,CAAC;EAChD;AACF","ignoreList":[]}

package/lib/commonjs/runtime/embedBannerRegistry.js

@@ -0,0 +1,30 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.hasEmbedBannerPlaceholder = hasEmbedBannerPlaceholder;
+exports.registerEmbedBannerPlaceholder = registerEmbedBannerPlaceholder;
+exports.resetEmbedBannerPlaceholdersForTests = resetEmbedBannerPlaceholdersForTests;
+var _bannerPlacement = require("./bannerPlacement.js");
+const counts = new Map();
+
+/** Record a mounted {@link EmbedBannerPlaceholder}. Returns the unregister function. */
+function registerEmbedBannerPlaceholder(id) {
+  const next = (counts.get(id) ?? 0) + 1;
+  counts.set(id, next);
+  if (next > 1) {
+    (0, _bannerPlacement.warnBannerOnce)(`embed-banner-dup:${id}`, `Userflow: more than one EmbedBannerPlaceholder uses id "${id}"`);
+  }
+  return () => {
+    const current = counts.get(id) ?? 0;
+    if (current <= 1) counts.delete(id);else counts.set(id, current - 1);
+  };
+}
+function hasEmbedBannerPlaceholder(id) {
+  return (counts.get(id) ?? 0) > 0;
+}
+function resetEmbedBannerPlaceholdersForTests() {
+  counts.clear();
+}
+//# sourceMappingURL=embedBannerRegistry.js.map

package/lib/commonjs/runtime/embedBannerRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_bannerPlacement","require","counts","Map","registerEmbedBannerPlaceholder","id","next","get","set","warnBannerOnce","current","delete","hasEmbedBannerPlaceholder","resetEmbedBannerPlaceholdersForTests","clear"],"sourceRoot":"../../../src","sources":["runtime/embedBannerRegistry.ts"],"mappings":";;;;;;;;AAAA,IAAAA,gBAAA,GAAAC,OAAA;AAEA,MAAMC,MAAM,GAAG,IAAIC,GAAG,CAAiB,CAAC;;AAExC;AACO,SAASC,8BAA8BA,CAACC,EAAU,EAAc;EACrE,MAAMC,IAAI,GAAG,CAACJ,MAAM,CAACK,GAAG,CAACF,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;EACtCH,MAAM,CAACM,GAAG,CAACH,EAAE,EAAEC,IAAI,CAAC;EACpB,IAAIA,IAAI,GAAG,CAAC,EAAE;IACZ,IAAAG,+BAAc,EACZ,oBAAoBJ,EAAE,EAAE,EACxB,2DAA2DA,EAAE,GAC/D,CAAC;EACH;EACA,OAAO,MAAM;IACX,MAAMK,OAAO,GAAGR,MAAM,CAACK,GAAG,CAACF,EAAE,CAAC,IAAI,CAAC;IACnC,IAAIK,OAAO,IAAI,CAAC,EAAER,MAAM,CAACS,MAAM,CAACN,EAAE,CAAC,CAAC,KAC/BH,MAAM,CAACM,GAAG,CAACH,EAAE,EAAEK,OAAO,GAAG,CAAC,CAAC;EAClC,CAAC;AACH;AAEO,SAASE,yBAAyBA,CAACP,EAAU,EAAW;EAC7D,OAAO,CAACH,MAAM,CAACK,GAAG,CAACF,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;AAClC;AAEO,SAASQ,oCAAoCA,CAAA,EAAS;EAC3DX,MAAM,CAACY,KAAK,CAAC,CAAC;AAChB","ignoreList":[]}