@userflow-tech/react-native 0.1.0

package/lib/module/pairing/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["PREFIX","redactPairingToken","url","replace","defaultPairingLogger","message","console","warn","pairingLinkDeferredMessage","pairingLinkInitFailedMessage","reason","pairingConnectFailedMessage","pairingMissingTokenMessage","pairingForeignSchemeMessage","pairingAttemptRejectionMessage","pairingSchemeShapeMessage","pairingTokenStoreClearFailedMessage","pairingListenerSetupFailedMessage"],"sourceRoot":"../../../src","sources":["pairing/diagnostics.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAIA,MAAMA,MAAM,GAAG,YAAY;;AAE3B;AACA;AACA;AACA;AACA,SAASC,kBAAkBA,CAACC,GAAW,EAAU;EAC/C,OAAOA,GAAG,CAACC,OAAO,CAAC,wBAAwB,EAAE,cAAc,CAAC;AAC9D;;AAEA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,oBAAmC,GAAIC,OAAO,IAAK;EAC9D;EACAC,OAAO,CAACC,IAAI,CAACF,OAAO,CAAC;AACvB,CAAC;;AAED;AACA,OAAO,SAASG,0BAA0BA,CAAA,EAAW;EACnD,OACE,GAAGR,MAAM,kEAAkE,GAC3E,uDAAuD;AAE3D;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASS,4BAA4BA,CAACC,MAAc,EAAU;EACnE,OACE,GAAGV,MAAM,wEAAwE,GACjF,iBAAiBU,MAAM,2DAA2D,GAClF,mEAAmE;AAEvE;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,2BAA2BA,CAACD,MAAc,EAAU;EAClE,OACE,GAAGV,MAAM,uCAAuCU,MAAM,4BAA4B,GAClF,yDAAyD;AAE7D;;AAEA;AACA,OAAO,SAASE,0BAA0BA,CAACV,GAAW,EAAU;EAC9D,OACE,GAAGF,MAAM,mCAAmCC,kBAAkB,CAACC,GAAG,CAAC,QAAQ,GAC3E,8EAA8E,GAC9E,6CAA6C;AAEjD;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASW,2BAA2BA,CAACX,GAAW,EAAU;EAC/D,OACE,GAAGF,MAAM,cAAcC,kBAAkB,CAACC,GAAG,CAAC,+BAA+B,GAC7E,wEAAwE,GACxE,0EAA0E,GAC1E,yEAAyE,GACzE,kFAAkF,GAClF,uDAAuD;AAE3D;;AAEA;AACA,OAAO,SAASY,8BAA8BA,CAC5CJ,MAA+B,EAC/BR,GAAW,EACH;EACR,QAAQQ,MAAM;IACZ,KAAK,gBAAgB;MACnB,OAAOG,2BAA2B,CAACX,GAAG,CAAC;IACzC,KAAK,kBAAkB;MACrB,OAAOa,yBAAyB,CAACb,GAAG,CAAC;IACvC,KAAK,eAAe;MAClB,OAAOU,0BAA0B,CAACV,GAAG,CAAC;EAC1C;AACF;;AAEA;AACA,OAAO,SAASc,mCAAmCA,CAACN,MAAc,EAAU;EAC1E,OACE,GAAGV,MAAM,8CAA8CU,MAAM,iBAAiB,GAC9E,6EAA6E;AAEjF;;AAEA;AACA,OAAO,SAASO,iCAAiCA,CAACP,MAAc,EAAU;EACxE,OACE,GAAGV,MAAM,+CAA+CU,MAAM,iBAAiB,GAC/E,4EAA4E;AAEhF;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASK,yBAAyBA,CAACb,GAAW,EAAU;EAC7D,OACE,GAAGF,MAAM,mCAAmCC,kBAAkB,CAACC,GAAG,CAAC,6BAA6B,GAChG,mFAAmF,GACnF,8DAA8D;AAElE","ignoreList":[]}

package/lib/module/pairing/index.js

@@ -0,0 +1,7 @@
+"use strict";
+
+export { inspectPairingDeepLink, isPairingAttempt, parsePairingDeepLink, isUserflowPairingUrl } from "./deepLink.js";
+export { PairingController } from "./PairingController.js";
+export { PreviewModeBanner } from "./PreviewModeBanner.js";
+export { createMemoryPairingTokenStore, createPairingTokenStore } from "./tokenStorage.js";
+//# sourceMappingURL=index.js.map

package/lib/module/pairing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["inspectPairingDeepLink","isPairingAttempt","parsePairingDeepLink","isUserflowPairingUrl","PairingController","PreviewModeBanner","createMemoryPairingTokenStore","createPairingTokenStore"],"sourceRoot":"../../../src","sources":["pairing/index.ts"],"mappings":";;AAAA,SACEA,sBAAsB,EACtBC,gBAAgB,EAChBC,oBAAoB,EACpBC,oBAAoB,QACf,eAAY;AAQnB,SAASC,iBAAiB,QAAQ,wBAAqB;AAEvD,SAASC,iBAAiB,QAAQ,wBAAqB;AAEvD,SAASC,6BAA6B,EAAEC,uBAAuB,QAAQ,mBAAgB","ignoreList":[]}

package/lib/module/pairing/pairingRuntime.js

@@ -0,0 +1,77 @@
+"use strict";
+
+import { PairingController } from "./PairingController.js";
+let controller = null;
+const installListeners = new Set();
+
+/** Return the singleton if it already exists — never creates one. */
+export function peekPairingController() {
+  return controller;
+}
+export function getPairingController(core) {
+  if (!controller) {
+    controller = new PairingController({
+      core
+    });
+    notifyInstall(controller);
+  }
+  return controller;
+}
+
+/**
+ * Ensure the singleton exists with init-time options. Idempotent once the
+ * controller has started listening — subsequent {@link Userflow.init} calls
+ * reuse it so AppState/Linking listeners are not stacked.
+ *
+ * If a bare controller was created early (e.g. a hook peek race that used
+ * {@link getPairingController}) but has not started yet, it is replaced so
+ * init-time options such as `pairingEndpoint` / `clearLocalSession` apply.
+ */
+export function installPairingController(core, options) {
+  if (!controller) {
+    controller = new PairingController({
+      core,
+      ...options
+    });
+    notifyInstall(controller);
+    return controller;
+  }
+  if (!controller.hasStarted()) {
+    controller.stop();
+    controller = new PairingController({
+      core,
+      ...options
+    });
+    notifyInstall(controller);
+  }
+  return controller;
+}
+
+/**
+ * Subscribe to singleton install/replace. Immediately invokes `listener` when
+ * a controller already exists. Used by hooks that must not create the
+ * singleton before {@link Userflow.init}.
+ */
+export function onPairingController(listener) {
+  if (controller) listener(controller);
+  installListeners.add(listener);
+  return () => {
+    installListeners.delete(listener);
+  };
+}
+function notifyInstall(next) {
+  for (const listener of installListeners) {
+    try {
+      listener(next);
+    } catch {
+      // ignore
+    }
+  }
+}
+
+/** Test helper: drop the singleton. */
+export function __resetPairingControllerForTests() {
+  controller?.stop();
+  controller = null;
+}
+//# sourceMappingURL=pairingRuntime.js.map

package/lib/module/pairing/pairingRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["PairingController","controller","installListeners","Set","peekPairingController","getPairingController","core","notifyInstall","installPairingController","options","hasStarted","stop","onPairingController","listener","add","delete","next","__resetPairingControllerForTests"],"sourceRoot":"../../../src","sources":["pairing/pairingRuntime.ts"],"mappings":";;AAEA,SAASA,iBAAiB,QAAuC,wBAAqB;AAEtF,IAAIC,UAAoC,GAAG,IAAI;AAC/C,MAAMC,gBAAgB,GAAG,IAAIC,GAAG,CAA0C,CAAC;;AAE3E;AACA,OAAO,SAASC,qBAAqBA,CAAA,EAA6B;EAChE,OAAOH,UAAU;AACnB;AAEA,OAAO,SAASI,oBAAoBA,CAACC,IAAkB,EAAqB;EAC1E,IAAI,CAACL,UAAU,EAAE;IACfA,UAAU,GAAG,IAAID,iBAAiB,CAAC;MAAEM;IAAK,CAAC,CAAC;IAC5CC,aAAa,CAACN,UAAU,CAAC;EAC3B;EACA,OAAOA,UAAU;AACnB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASO,wBAAwBA,CACtCF,IAAkB,EAClBG,OAAgD,EAC7B;EACnB,IAAI,CAACR,UAAU,EAAE;IACfA,UAAU,GAAG,IAAID,iBAAiB,CAAC;MAAEM,IAAI;MAAE,GAAGG;IAAQ,CAAC,CAAC;IACxDF,aAAa,CAACN,UAAU,CAAC;IACzB,OAAOA,UAAU;EACnB;EAEA,IAAI,CAACA,UAAU,CAACS,UAAU,CAAC,CAAC,EAAE;IAC5BT,UAAU,CAACU,IAAI,CAAC,CAAC;IACjBV,UAAU,GAAG,IAAID,iBAAiB,CAAC;MAAEM,IAAI;MAAE,GAAGG;IAAQ,CAAC,CAAC;IACxDF,aAAa,CAACN,UAAU,CAAC;EAC3B;EAEA,OAAOA,UAAU;AACnB;;AAEA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASW,mBAAmBA,CAACC,QAAiD,EAAc;EACjG,IAAIZ,UAAU,EAAEY,QAAQ,CAACZ,UAAU,CAAC;EACpCC,gBAAgB,CAACY,GAAG,CAACD,QAAQ,CAAC;EAC9B,OAAO,MAAM;IACXX,gBAAgB,CAACa,MAAM,CAACF,QAAQ,CAAC;EACnC,CAAC;AACH;AAEA,SAASN,aAAaA,CAACS,IAAuB,EAAQ;EACpD,KAAK,MAAMH,QAAQ,IAAIX,gBAAgB,EAAE;IACvC,IAAI;MACFW,QAAQ,CAACG,IAAI,CAAC;IAChB,CAAC,CAAC,MAAM;MACN;IAAA;EAEJ;AACF;;AAEA;AACA,OAAO,SAASC,gCAAgCA,CAAA,EAAS;EACvDhB,UAAU,EAAEU,IAAI,CAAC,CAAC;EAClBV,UAAU,GAAG,IAAI;AACnB","ignoreList":[]}

package/lib/module/pairing/tokenStorage.js

@@ -0,0 +1,65 @@
+"use strict";
+
+/**
+ * Persist the pairing JWT for reconnect within the current app session.
+ * Cleared on SDK init / exit preview / app restart (pairing exits on restart).
+ */
+
+const STORAGE_KEY = 'userflow:pairingToken';
+function tryLoadExpoSecureStore() {
+  try {
+    // Optional peer — absent in bare RN without expo-secure-store.
+    // eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-var-requires -- optional peer at import time
+    return require('expo-secure-store');
+  } catch {
+    return null;
+  }
+}
+
+/** In-memory store used when SecureStore is unavailable (and in tests). */
+export function createMemoryPairingTokenStore() {
+  let value = null;
+  return {
+    async get() {
+      return value;
+    },
+    async set(token) {
+      value = token;
+    },
+    async clear() {
+      value = null;
+    }
+  };
+}
+
+/**
+ * Prefer expo-secure-store (Keychain / Keystore); fall back to memory.
+ */
+export function createPairingTokenStore() {
+  const secure = tryLoadExpoSecureStore();
+  if (!secure) return createMemoryPairingTokenStore();
+  return {
+    async get() {
+      try {
+        return await secure.getItemAsync(STORAGE_KEY);
+      } catch {
+        return null;
+      }
+    },
+    async set(token) {
+      try {
+        await secure.setItemAsync(STORAGE_KEY, token);
+      } catch {
+        // Best-effort; reconnect still works from in-memory PairingEngine token.
+      }
+    },
+    async clear() {
+      try {
+        await secure.deleteItemAsync(STORAGE_KEY);
+      } catch {
+        // ignore
+      }
+    }
+  };
+}
+//# sourceMappingURL=tokenStorage.js.map

package/lib/module/pairing/tokenStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["STORAGE_KEY","tryLoadExpoSecureStore","require","createMemoryPairingTokenStore","value","get","set","token","clear","createPairingTokenStore","secure","getItemAsync","setItemAsync","deleteItemAsync"],"sourceRoot":"../../../src","sources":["pairing/tokenStorage.ts"],"mappings":";;AAAA;AACA;AACA;AACA;;AAEA,MAAMA,WAAW,GAAG,uBAAuB;AAc3C,SAASC,sBAAsBA,CAAA,EAA6B;EAC1D,IAAI;IACF;IACA;IACA,OAAOC,OAAO,CAAC,mBAAmB,CAAC;EACrC,CAAC,CAAC,MAAM;IACN,OAAO,IAAI;EACb;AACF;;AAEA;AACA,OAAO,SAASC,6BAA6BA,CAAA,EAAsB;EACjE,IAAIC,KAAoB,GAAG,IAAI;EAC/B,OAAO;IACL,MAAMC,GAAGA,CAAA,EAAG;MACV,OAAOD,KAAK;IACd,CAAC;IACD,MAAME,GAAGA,CAACC,KAAa,EAAE;MACvBH,KAAK,GAAGG,KAAK;IACf,CAAC;IACD,MAAMC,KAAKA,CAAA,EAAG;MACZJ,KAAK,GAAG,IAAI;IACd;EACF,CAAC;AACH;;AAEA;AACA;AACA;AACA,OAAO,SAASK,uBAAuBA,CAAA,EAAsB;EAC3D,MAAMC,MAAM,GAAGT,sBAAsB,CAAC,CAAC;EACvC,IAAI,CAACS,MAAM,EAAE,OAAOP,6BAA6B,CAAC,CAAC;EAEnD,OAAO;IACL,MAAME,GAAGA,CAAA,EAAG;MACV,IAAI;QACF,OAAO,MAAMK,MAAM,CAACC,YAAY,CAACX,WAAW,CAAC;MAC/C,CAAC,CAAC,MAAM;QACN,OAAO,IAAI;MACb;IACF,CAAC;IACD,MAAMM,GAAGA,CAACC,KAAa,EAAE;MACvB,IAAI;QACF,MAAMG,MAAM,CAACE,YAAY,CAACZ,WAAW,EAAEO,KAAK,CAAC;MAC/C,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ,CAAC;IACD,MAAMC,KAAKA,CAAA,EAAG;MACZ,IAAI;QACF,MAAME,MAAM,CAACG,eAAe,CAACb,WAAW,CAAC;MAC3C,CAAC,CAAC,MAAM;QACN;MAAA;IAEJ;EACF,CAAC;AACH","ignoreList":[]}

package/lib/module/pairing/usePairingState.js

@@ -0,0 +1,35 @@
+"use strict";
+
+import * as React from 'react';
+import { onPairingController, peekPairingController } from "./pairingRuntime.js";
+const IDLE = {
+  status: 'idle',
+  pairingId: null,
+  deviceId: null,
+  previewActive: false,
+  lastError: null,
+  needsRescan: false,
+  awaitingStartCondition: false
+};
+
+/** Subscribe to Builder pairing / preview-mode state (dev builds only). */
+export function usePairingState() {
+  const [state, setState] = React.useState(() => peekPairingController()?.getState() ?? IDLE);
+  React.useEffect(() => {
+    let unsubState;
+    const bind = controller => {
+      unsubState?.();
+      setState(controller.getState());
+      unsubState = controller.onStateChange(setState);
+    };
+    const existing = peekPairingController();
+    if (existing) bind(existing);
+    const unsubInstall = onPairingController(bind);
+    return () => {
+      unsubInstall();
+      unsubState?.();
+    };
+  }, []);
+  return state;
+}
+//# sourceMappingURL=usePairingState.js.map

package/lib/module/pairing/usePairingState.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","onPairingController","peekPairingController","IDLE","status","pairingId","deviceId","previewActive","lastError","needsRescan","awaitingStartCondition","usePairingState","state","setState","useState","getState","useEffect","unsubState","bind","controller","onStateChange","existing","unsubInstall"],"sourceRoot":"../../../src","sources":["pairing/usePairingState.ts"],"mappings":";;AACA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAG9B,SAASC,mBAAmB,EAAEC,qBAAqB,QAAQ,qBAAkB;AAE7E,MAAMC,IAAwB,GAAG;EAC/BC,MAAM,EAAE,MAAM;EACdC,SAAS,EAAE,IAAI;EACfC,QAAQ,EAAE,IAAI;EACdC,aAAa,EAAE,KAAK;EACpBC,SAAS,EAAE,IAAI;EACfC,WAAW,EAAE,KAAK;EAClBC,sBAAsB,EAAE;AAC1B,CAAC;;AAED;AACA,OAAO,SAASC,eAAeA,CAAA,EAAuB;EACpD,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGb,KAAK,CAACc,QAAQ,CACtC,MAAMZ,qBAAqB,CAAC,CAAC,EAAEa,QAAQ,CAAC,CAAC,IAAIZ,IAC/C,CAAC;EAEDH,KAAK,CAACgB,SAAS,CAAC,MAAM;IACpB,IAAIC,UAAoC;IAExC,MAAMC,IAAI,GAAIC,UAA6B,IAAK;MAC9CF,UAAU,GAAG,CAAC;MACdJ,QAAQ,CAACM,UAAU,CAACJ,QAAQ,CAAC,CAAC,CAAC;MAC/BE,UAAU,GAAGE,UAAU,CAACC,aAAa,CAACP,QAAQ,CAAC;IACjD,CAAC;IAED,MAAMQ,QAAQ,GAAGnB,qBAAqB,CAAC,CAAC;IACxC,IAAImB,QAAQ,EAAEH,IAAI,CAACG,QAAQ,CAAC;IAC5B,MAAMC,YAAY,GAAGrB,mBAAmB,CAACiB,IAAI,CAAC;IAE9C,OAAO,MAAM;MACXI,YAAY,CAAC,CAAC;MACdL,UAAU,GAAG,CAAC;IAChB,CAAC;EACH,CAAC,EAAE,EAAE,CAAC;EAEN,OAAOL,KAAK;AACd","ignoreList":[]}

package/lib/module/runtime/FlowRenderer.js

@@ -0,0 +1,52 @@
+"use strict";
+
+import { genSessionDataLookup } from '@userflow-tech/core';
+import * as React from 'react';
+import { ModalSurface } from "../surfaces/ModalSurface.js";
+import { TooltipSurface } from "../surfaces/TooltipSurface.js";
+import { FlowSurfaceFade } from "./FlowSurfaceFade.js";
+import { useFlowSessionState } from "./useFlowSessionState.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+function appearanceOf(step) {
+  return String(step.appearance).toUpperCase();
+}
+
+/**
+ * Renders the active flow step.
+ *
+ * TOOLTIP → {@link TooltipSurface}; everything else → {@link ModalSurface}
+ * (BUBBLE/HIDDEN remain centered-card fallbacks until dedicated surfaces).
+ */
+export function FlowRenderer({
+  engine
+}) {
+  const {
+    session,
+    currentStep
+  } = useFlowSessionState(engine);
+  const lookupAttribute = React.useMemo(() => genSessionDataLookup(session?.data ?? []), [session?.data]);
+  if (!session || !currentStep) {
+    return null;
+  }
+  const theme = currentStep.theme ?? session.version.theme;
+  const appearance = appearanceOf(currentStep);
+  const animationKey = `${session.id}:${currentStep.id}:${appearance}`;
+  const surface = appearance === 'TOOLTIP' ? /*#__PURE__*/_jsx(TooltipSurface, {
+    engine: engine,
+    session: session,
+    currentStep: currentStep,
+    theme: theme,
+    lookupAttribute: lookupAttribute
+  }) : /*#__PURE__*/_jsx(ModalSurface, {
+    engine: engine,
+    session: session,
+    currentStep: currentStep,
+    theme: theme,
+    lookupAttribute: lookupAttribute
+  });
+  return /*#__PURE__*/_jsx(FlowSurfaceFade, {
+    animationKey: animationKey,
+    children: surface
+  });
+}
+//# sourceMappingURL=FlowRenderer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["genSessionDataLookup","React","ModalSurface","TooltipSurface","FlowSurfaceFade","useFlowSessionState","jsx","_jsx","appearanceOf","step","String","appearance","toUpperCase","FlowRenderer","engine","session","currentStep","lookupAttribute","useMemo","data","theme","version","animationKey","id","surface","children"],"sourceRoot":"../../../src","sources":["runtime/FlowRenderer.tsx"],"mappings":";;AAAA,SAASA,oBAAoB,QAAQ,qBAAqB;AAE1D,OAAO,KAAKC,KAAK,MAAM,OAAO;AAE9B,SAASC,YAAY,QAAQ,6BAA0B;AACvD,SAASC,cAAc,QAAQ,+BAA4B;AAE3D,SAASC,eAAe,QAAQ,sBAAmB;AACnD,SAASC,mBAAmB,QAAQ,0BAAuB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAM5D,SAASC,YAAYA,CAACC,IAA6B,EAAU;EAC3D,OAAOC,MAAM,CAACD,IAAI,CAACE,UAAU,CAAC,CAACC,WAAW,CAAC,CAAC;AAC9C;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,YAAYA,CAAC;EAAEC;AAA0B,CAAC,EAA6B;EACrF,MAAM;IAAEC,OAAO;IAAEC;EAAY,CAAC,GAAGX,mBAAmB,CAACS,MAAM,CAAC;EAC5D,MAAMG,eAAe,GAAGhB,KAAK,CAACiB,OAAO,CACnC,MAAMlB,oBAAoB,CAACe,OAAO,EAAEI,IAAI,IAAI,EAAE,CAAC,EAC/C,CAACJ,OAAO,EAAEI,IAAI,CAChB,CAAC;EAED,IAAI,CAACJ,OAAO,IAAI,CAACC,WAAW,EAAE;IAC5B,OAAO,IAAI;EACb;EAEA,MAAMI,KAAK,GAAGJ,WAAW,CAACI,KAAK,IAAIL,OAAO,CAACM,OAAO,CAACD,KAAK;EACxD,MAAMT,UAAU,GAAGH,YAAY,CAACQ,WAAW,CAAC;EAC5C,MAAMM,YAAY,GAAG,GAAGP,OAAO,CAACQ,EAAE,IAAIP,WAAW,CAACO,EAAE,IAAIZ,UAAU,EAAE;EAEpE,MAAMa,OAAO,GACXb,UAAU,KAAK,SAAS,gBACtBJ,IAAA,CAACJ,cAAc;IACbW,MAAM,EAAEA,MAAO;IACfC,OAAO,EAAEA,OAAQ;IACjBC,WAAW,EAAEA,WAAY;IACzBI,KAAK,EAAEA,KAAM;IACbH,eAAe,EAAEA;EAAgB,CAClC,CAAC,gBAEFV,IAAA,CAACL,YAAY;IACXY,MAAM,EAAEA,MAAO;IACfC,OAAO,EAAEA,OAAQ;IACjBC,WAAW,EAAEA,WAAY;IACzBI,KAAK,EAAEA,KAAM;IACbH,eAAe,EAAEA;EAAgB,CAClC,CACF;EAEH,oBAAOV,IAAA,CAACH,eAAe;IAACkB,YAAY,EAAEA,YAAa;IAAAG,QAAA,EAAED;EAAO,CAAkB,CAAC;AACjF","ignoreList":[]}

package/lib/module/runtime/FlowSurfaceFade.js

@@ -0,0 +1,48 @@
+"use strict";
+
+import * as React from 'react';
+import { Animated, StyleSheet, View } from 'react-native';
+import { ABSOLUTE_FILL } from "../surfaces/absoluteFill.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+const FADE_MS = 180;
+/**
+ * Short opacity fade for flow surface entry (FLOW_RENDERING_SPEC minimum).
+ * Exit fades when the keyed surface unmounts via a brief hold are deferred —
+ * step swaps remount with a fresh fade-in.
+ */
+export function FlowSurfaceFade({
+  children,
+  animationKey
+}) {
+  const opacity = React.useRef(new Animated.Value(0)).current;
+  React.useEffect(() => {
+    opacity.setValue(0);
+    const animation = Animated.timing(opacity, {
+      toValue: 1,
+      duration: FADE_MS,
+      useNativeDriver: true
+    });
+    animation.start();
+    return () => {
+      animation.stop();
+    };
+  }, [animationKey, opacity]);
+  return /*#__PURE__*/_jsx(Animated.View, {
+    testID: "userflow-surface-fade",
+    style: [styles.fill, {
+      opacity
+    }],
+    pointerEvents: "box-none",
+    children: /*#__PURE__*/_jsx(View, {
+      style: styles.fill,
+      pointerEvents: "box-none",
+      children: children
+    })
+  });
+}
+const styles = StyleSheet.create({
+  fill: {
+    ...ABSOLUTE_FILL
+  }
+});
+//# sourceMappingURL=FlowSurfaceFade.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["React","Animated","StyleSheet","View","ABSOLUTE_FILL","jsx","_jsx","FADE_MS","FlowSurfaceFade","children","animationKey","opacity","useRef","Value","current","useEffect","setValue","animation","timing","toValue","duration","useNativeDriver","start","stop","testID","style","styles","fill","pointerEvents","create"],"sourceRoot":"../../../src","sources":["runtime/FlowSurfaceFade.tsx"],"mappings":";;AAAA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAC9B,SAASC,QAAQ,EAAEC,UAAU,EAAEC,IAAI,QAAQ,cAAc;AAEzD,SAASC,aAAa,QAAQ,6BAA0B;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAEzD,MAAMC,OAAO,GAAG,GAAG;AAQnB;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,eAAeA,CAAC;EAC9BC,QAAQ;EACRC;AACoB,CAAC,EAAsB;EAC3C,MAAMC,OAAO,GAAGX,KAAK,CAACY,MAAM,CAAC,IAAIX,QAAQ,CAACY,KAAK,CAAC,CAAC,CAAC,CAAC,CAACC,OAAO;EAE3Dd,KAAK,CAACe,SAAS,CAAC,MAAM;IACpBJ,OAAO,CAACK,QAAQ,CAAC,CAAC,CAAC;IACnB,MAAMC,SAAS,GAAGhB,QAAQ,CAACiB,MAAM,CAACP,OAAO,EAAE;MACzCQ,OAAO,EAAE,CAAC;MACVC,QAAQ,EAAEb,OAAO;MACjBc,eAAe,EAAE;IACnB,CAAC,CAAC;IACFJ,SAAS,CAACK,KAAK,CAAC,CAAC;IACjB,OAAO,MAAM;MACXL,SAAS,CAACM,IAAI,CAAC,CAAC;IAClB,CAAC;EACH,CAAC,EAAE,CAACb,YAAY,EAAEC,OAAO,CAAC,CAAC;EAE3B,oBACEL,IAAA,CAACL,QAAQ,CAACE,IAAI;IACZqB,MAAM,EAAC,uBAAuB;IAC9BC,KAAK,EAAE,CAACC,MAAM,CAACC,IAAI,EAAE;MAAEhB;IAAQ,CAAC,CAAE;IAClCiB,aAAa,EAAC,UAAU;IAAAnB,QAAA,eAExBH,IAAA,CAACH,IAAI;MAACsB,KAAK,EAAEC,MAAM,CAACC,IAAK;MAACC,aAAa,EAAC,UAAU;MAAAnB,QAAA,EAC/CA;IAAQ,CACL;EAAC,CACM,CAAC;AAEpB;AAEA,MAAMiB,MAAM,GAAGxB,UAAU,CAAC2B,MAAM,CAAC;EAC/BF,IAAI,EAAE;IACJ,GAAGvB;EACL;AACF,CAAC,CAAC","ignoreList":[]}

package/lib/module/runtime/TargetPressBridge.js

@@ -0,0 +1,91 @@
+"use strict";
+
+import * as React from 'react';
+import { StyleSheet, View } from 'react-native';
+import { targetPressMonitor } from "../anchors/targetPressMonitor.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * 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 the monitor 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
+  }];
+}
+
+/**
+ * Wraps app content so tooltip target taps can be observed without stealing
+ * them from the underlying control (web parity: click listener, no preventDefault).
+ *
+ * The Userflow overlay is a sibling above the app, so hole Pressables would
+ * intercept presses. Instead we hit-test bubbled `onTouchStart` / `onTouchEnd`
+ * against the rect registered by {@link TooltipSurface}.
+ *
+ * Does not claim the gesture responder.
+ */
+export function TargetPressBridge({
+  children
+}) {
+  const onTouchStart = React.useCallback(event => {
+    for (const touch of changedTouchPoints(event)) {
+      targetPressMonitor.handleTouchStart(touch.identifier, touch.pageX, touch.pageY);
+    }
+  }, []);
+  const onTouchEnd = React.useCallback(event => {
+    for (const touch of changedTouchPoints(event)) {
+      targetPressMonitor.handleTouchEnd(touch.identifier, touch.pageX, touch.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);
+    }
+  }, []);
+  return /*#__PURE__*/_jsx(View, {
+    style: styles.root,
+    collapsable: false,
+    onTouchStart: onTouchStart,
+    onTouchEnd: onTouchEnd,
+    onTouchCancel: onTouchCancel,
+    testID: "userflow-target-press-bridge",
+    children: children
+  });
+}
+const styles = StyleSheet.create({
+  root: {
+    flex: 1
+  }
+});
+//# sourceMappingURL=TargetPressBridge.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["React","StyleSheet","View","targetPressMonitor","jsx","_jsx","changedTouchPoints","event","changedTouches","touches","identifier","pageX","pageY","nativeEvent","length","map","touch","TargetPressBridge","children","onTouchStart","useCallback","handleTouchStart","onTouchEnd","handleTouchEnd","onTouchCancel","points","cancelTouch","style","styles","root","collapsable","testID","create","flex"],"sourceRoot":"../../../src","sources":["runtime/TargetPressBridge.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/runtime/UserflowProvider.js

@@ -0,0 +1,85 @@
+"use strict";
+
+import * as React from 'react';
+import { StyleSheet, View } from 'react-native';
+import { FiberScanRoot } from "../anchors/fiber/FiberScanRoot.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 { FlowRenderer } from "./FlowRenderer.js";
+import { TargetPressBridge } from "./TargetPressBridge.js";
+import { getFlowSessionEngine } from "./flowEngine.js";
+import { getUserflowCore } from "./userflowCore.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+const UserflowContext = /*#__PURE__*/React.createContext(null);
+/**
+ * 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.
+ * We deliberately do not use RN `<Modal>` — it is the wrong primitive for
+ * non-modal tooltips (WS6).
+ *
+ * **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.
+ *
+ * **React Navigation:** wrap `NavigationContainer` with
+ * {@link WithUserflowReactNavigation} from `@userflow-tech/react-native/navigation`.
+ */
+export function UserflowProvider({
+  children,
+  engine: engineProp
+}) {
+  const engine = engineProp ?? getFlowSessionEngine(getUserflowCore());
+  const contextValue = React.useMemo(() => ({
+    engine
+  }), [engine]);
+  const pairingState = usePairingState();
+  const onExitPreview = React.useCallback(() => {
+    void getPairingController(getUserflowCore()).exitPreview();
+  }, []);
+  return /*#__PURE__*/_jsx(UserflowContext.Provider, {
+    value: contextValue,
+    children: /*#__PURE__*/_jsxs(View, {
+      style: styles.root,
+      collapsable: false,
+      children: [/*#__PURE__*/_jsx(TargetPressBridge, {
+        children: /*#__PURE__*/_jsx(FiberScanRoot, {
+          children: children
+        })
+      }), /*#__PURE__*/_jsxs(View, {
+        style: styles.overlay,
+        pointerEvents: "box-none",
+        children: [/*#__PURE__*/_jsx(PreviewModeBanner, {
+          state: pairingState,
+          onExit: onExitPreview
+        }), /*#__PURE__*/_jsx(FlowRenderer, {
+          engine: engine
+        })]
+      })]
+    })
+  });
+}
+
+/** Access the flow session engine from inside {@link UserflowProvider}. */
+export function useUserflow() {
+  const ctx = React.useContext(UserflowContext);
+  if (!ctx) {
+    throw new Error('useUserflow() must be called inside <UserflowProvider>');
+  }
+  return ctx;
+}
+const styles = StyleSheet.create({
+  root: {
+    flex: 1
+  },
+  overlay: {
+    ...ABSOLUTE_FILL
+  }
+});
+//# sourceMappingURL=UserflowProvider.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["React","StyleSheet","View","FiberScanRoot","PreviewModeBanner","getPairingController","usePairingState","ABSOLUTE_FILL","FlowRenderer","TargetPressBridge","getFlowSessionEngine","getUserflowCore","jsx","_jsx","jsxs","_jsxs","UserflowContext","createContext","UserflowProvider","children","engine","engineProp","contextValue","useMemo","pairingState","onExitPreview","useCallback","exitPreview","Provider","value","style","styles","root","collapsable","overlay","pointerEvents","state","onExit","useUserflow","ctx","useContext","Error","create","flex"],"sourceRoot":"../../../src","sources":["runtime/UserflowProvider.tsx"],"mappings":";;AACA,OAAO,KAAKA,KAAK,MAAM,OAAO;AAC9B,SAASC,UAAU,EAAEC,IAAI,QAAQ,cAAc;AAE/C,SAASC,aAAa,QAAQ,mCAAgC;AAC9D,SAASC,iBAAiB,QAAQ,iCAA8B;AAChE,SAASC,oBAAoB,QAAQ,8BAA2B;AAChE,SAASC,eAAe,QAAQ,+BAA4B;AAC5D,SAASC,aAAa,QAAQ,6BAA0B;AAExD,SAASC,YAAY,QAAQ,mBAAgB;AAC7C,SAASC,iBAAiB,QAAQ,wBAAqB;AACvD,SAASC,oBAAoB,QAAQ,iBAAc;AACnD,SAASC,eAAe,QAAQ,mBAAgB;AAAC,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAMjD,MAAMC,eAAe,gBAAGhB,KAAK,CAACiB,aAAa,CAA8B,IAAI,CAAC;AAQ9E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAAC;EAC/BC,QAAQ;EACRC,MAAM,EAAEC;AACa,CAAC,EAAsB;EAC5C,MAAMD,MAAM,GAAGC,UAAU,IAAIX,oBAAoB,CAACC,eAAe,CAAC,CAAC,CAAC;EACpE,MAAMW,YAAY,GAAGtB,KAAK,CAACuB,OAAO,CAAuB,OAAO;IAAEH;EAAO,CAAC,CAAC,EAAE,CAACA,MAAM,CAAC,CAAC;EACtF,MAAMI,YAAY,GAAGlB,eAAe,CAAC,CAAC;EAEtC,MAAMmB,aAAa,GAAGzB,KAAK,CAAC0B,WAAW,CAAC,MAAM;IAC5C,KAAKrB,oBAAoB,CAACM,eAAe,CAAC,CAAC,CAAC,CAACgB,WAAW,CAAC,CAAC;EAC5D,CAAC,EAAE,EAAE,CAAC;EAEN,oBACEd,IAAA,CAACG,eAAe,CAACY,QAAQ;IAACC,KAAK,EAAEP,YAAa;IAAAH,QAAA,eAC5CJ,KAAA,CAACb,IAAI;MAAC4B,KAAK,EAAEC,MAAM,CAACC,IAAK;MAACC,WAAW,EAAE,KAAM;MAAAd,QAAA,gBAC3CN,IAAA,CAACJ,iBAAiB;QAAAU,QAAA,eAChBN,IAAA,CAACV,aAAa;UAAAgB,QAAA,EAAEA;QAAQ,CAAgB;MAAC,CACxB,CAAC,eACpBJ,KAAA,CAACb,IAAI;QAAC4B,KAAK,EAAEC,MAAM,CAACG,OAAQ;QAACC,aAAa,EAAC,UAAU;QAAAhB,QAAA,gBACnDN,IAAA,CAACT,iBAAiB;UAACgC,KAAK,EAAEZ,YAAa;UAACa,MAAM,EAAEZ;QAAc,CAAE,CAAC,eACjEZ,IAAA,CAACL,YAAY;UAACY,MAAM,EAAEA;QAAO,CAAE,CAAC;MAAA,CAC5B,CAAC;IAAA,CACH;EAAC,CACiB,CAAC;AAE/B;;AAEA;AACA,OAAO,SAASkB,WAAWA,CAAA,EAAyB;EAClD,MAAMC,GAAG,GAAGvC,KAAK,CAACwC,UAAU,CAACxB,eAAe,CAAC;EAC7C,IAAI,CAACuB,GAAG,EAAE;IACR,MAAM,IAAIE,KAAK,CAAC,wDAAwD,CAAC;EAC3E;EACA,OAAOF,GAAG;AACZ;AAEA,MAAMR,MAAM,GAAG9B,UAAU,CAACyC,MAAM,CAAC;EAC/BV,IAAI,EAAE;IACJW,IAAI,EAAE;EACR,CAAC;EACDT,OAAO,EAAE;IACP,GAAG3B;EACL;AACF,CAAC,CAAC","ignoreList":[]}

package/lib/module/runtime/clientConditions.js

@@ -0,0 +1,43 @@
+"use strict";
+
+import { ClientConditionEngine } from '@userflow-tech/core';
+import { createElementConditionEvaluator } from "../anchors/elementConditionEvaluator.js";
+let clientConditionEngine = null;
+
+/** Build (once) the module-level client-condition engine over a {@link UserflowCore} transport. */
+export function getClientConditionEngine(core) {
+  if (!clientConditionEngine) {
+    clientConditionEngine = new ClientConditionEngine({
+      transport: {
+        send: message => core.send(message),
+        onServerMessage: handler => core.onServerMessage(handler),
+        setClientConditions: list => core.setClientConditions(list)
+      },
+      evaluators: {
+        // String key matches FlowConditionType.ELEMENT; avoid importing the
+        // ESM-only @userflow-tech/protocol package at runtime under Jest.
+        ELEMENT: createElementConditionEvaluator()
+      }
+    });
+  }
+  return clientConditionEngine;
+}
+
+/** Subscribe the engine to inbound server messages. Call after identify. */
+export function attachClientConditionEngine(core) {
+  const engine = getClientConditionEngine(core);
+  engine.attach();
+  return engine;
+}
+
+/** Clear tracked conditions. Call from {@link Userflow.reset}. */
+export function resetClientConditionEngine() {
+  clientConditionEngine?.reset();
+}
+
+/** Test helper: drop the singleton so the next get recreates it. */
+export function __resetClientConditionEngineForTests() {
+  clientConditionEngine?.reset();
+  clientConditionEngine = null;
+}
+//# sourceMappingURL=clientConditions.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["ClientConditionEngine","createElementConditionEvaluator","clientConditionEngine","getClientConditionEngine","core","transport","send","message","onServerMessage","handler","setClientConditions","list","evaluators","ELEMENT","attachClientConditionEngine","engine","attach","resetClientConditionEngine","reset","__resetClientConditionEngineForTests"],"sourceRoot":"../../../src","sources":["runtime/clientConditions.ts"],"mappings":";;AAAA,SAASA,qBAAqB,QAA2B,qBAAqB;AAE9E,SAASC,+BAA+B,QAAQ,yCAAsC;AAEtF,IAAIC,qBAAmD,GAAG,IAAI;;AAE9D;AACA,OAAO,SAASC,wBAAwBA,CAACC,IAAkB,EAAyB;EAClF,IAAI,CAACF,qBAAqB,EAAE;IAC1BA,qBAAqB,GAAG,IAAIF,qBAAqB,CAAC;MAChDK,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,mBAAmB,EAAGC,IAAI,IAAKP,IAAI,CAACM,mBAAmB,CAACC,IAAI;MAC9D,CAAC;MACDC,UAAU,EAAE;QACV;QACA;QACAC,OAAO,EAAEZ,+BAA+B,CAAC;MAC3C;IACF,CAAC,CAAC;EACJ;EACA,OAAOC,qBAAqB;AAC9B;;AAEA;AACA,OAAO,SAASY,2BAA2BA,CAACV,IAAkB,EAAyB;EACrF,MAAMW,MAAM,GAAGZ,wBAAwB,CAACC,IAAI,CAAC;EAC7CW,MAAM,CAACC,MAAM,CAAC,CAAC;EACf,OAAOD,MAAM;AACf;;AAEA;AACA,OAAO,SAASE,0BAA0BA,CAAA,EAAS;EACjDf,qBAAqB,EAAEgB,KAAK,CAAC,CAAC;AAChC;;AAEA;AACA,OAAO,SAASC,oCAAoCA,CAAA,EAAS;EAC3DjB,qBAAqB,EAAEgB,KAAK,CAAC,CAAC;EAC9BhB,qBAAqB,GAAG,IAAI;AAC9B","ignoreList":[]}

package/lib/module/runtime/flowEngine.js

@@ -0,0 +1,54 @@
+"use strict";
+
+import { FlowSessionEngine } from '@userflow-tech/core';
+import { openFlowNavigateUrl } from "../navigation/openFlowNavigateUrl.js";
+let flowEngine = null;
+
+/** Build (once) the module-level flow session engine over a {@link UserflowCore} transport. */
+export function getFlowSessionEngine(core) {
+  if (!flowEngine) {
+    flowEngine = new FlowSessionEngine({
+      transport: {
+        send: message => core.send(message),
+        onServerMessage: handler => core.onServerMessage(handler),
+        setFlowSessionId: id => core.setFlowSessionId(id)
+      },
+      onOpenExternalUrl: url => {
+        void openFlowNavigateUrl(url);
+      }
+    });
+  }
+  return flowEngine;
+}
+
+/** Subscribe the engine to inbound server messages. Call after identify. */
+export function attachFlowSessionEngine(core) {
+  const engine = getFlowSessionEngine(core);
+  engine.attach();
+  return engine;
+}
+
+/** Clear session/clocks/timers. Call from {@link Userflow.reset}. */
+export function resetFlowSessionEngine() {
+  flowEngine?.reset();
+}
+
+/**
+ * Drop the local mid-flow session without detaching the transport subscription.
+ * Used after a long background when mid-flow resume would be stale.
+ */
+export function clearFlowSessionEngineLocalSession() {
+  flowEngine?.clearLocalSession();
+}
+
+/** Whether any mid-flow session (live or draft/preview) is currently on screen. */
+export function hasActiveFlowSession() {
+  return flowEngine?.getFlowSession() != null;
+}
+
+/** Test helper: drop the singleton so the next get recreates it. */
+export function __resetFlowSessionEngineForTests() {
+  flowEngine?.reset();
+  flowEngine = null;
+}
+//# sourceMappingURL=flowEngine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["FlowSessionEngine","openFlowNavigateUrl","flowEngine","getFlowSessionEngine","core","transport","send","message","onServerMessage","handler","setFlowSessionId","id","onOpenExternalUrl","url","attachFlowSessionEngine","engine","attach","resetFlowSessionEngine","reset","clearFlowSessionEngineLocalSession","clearLocalSession","hasActiveFlowSession","getFlowSession","__resetFlowSessionEngineForTests"],"sourceRoot":"../../../src","sources":["runtime/flowEngine.ts"],"mappings":";;AAAA,SAASA,iBAAiB,QAA2B,qBAAqB;AAE1E,SAASC,mBAAmB,QAAQ,sCAAmC;AAEvE,IAAIC,UAAoC,GAAG,IAAI;;AAE/C;AACA,OAAO,SAASC,oBAAoBA,CAACC,IAAkB,EAAqB;EAC1E,IAAI,CAACF,UAAU,EAAE;IACfA,UAAU,GAAG,IAAIF,iBAAiB,CAAC;MACjCK,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,gBAAgB,EAAGC,EAAE,IAAKP,IAAI,CAACM,gBAAgB,CAACC,EAAE;MACpD,CAAC;MACDC,iBAAiB,EAAGC,GAAG,IAAK;QAC1B,KAAKZ,mBAAmB,CAACY,GAAG,CAAC;MAC/B;IACF,CAAC,CAAC;EACJ;EACA,OAAOX,UAAU;AACnB;;AAEA;AACA,OAAO,SAASY,uBAAuBA,CAACV,IAAkB,EAAqB;EAC7E,MAAMW,MAAM,GAAGZ,oBAAoB,CAACC,IAAI,CAAC;EACzCW,MAAM,CAACC,MAAM,CAAC,CAAC;EACf,OAAOD,MAAM;AACf;;AAEA;AACA,OAAO,SAASE,sBAAsBA,CAAA,EAAS;EAC7Cf,UAAU,EAAEgB,KAAK,CAAC,CAAC;AACrB;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,kCAAkCA,CAAA,EAAS;EACzDjB,UAAU,EAAEkB,iBAAiB,CAAC,CAAC;AACjC;;AAEA;AACA,OAAO,SAASC,oBAAoBA,CAAA,EAAY;EAC9C,OAAOnB,UAAU,EAAEoB,cAAc,CAAC,CAAC,IAAI,IAAI;AAC7C;;AAEA;AACA,OAAO,SAASC,gCAAgCA,CAAA,EAAS;EACvDrB,UAAU,EAAEgB,KAAK,CAAC,CAAC;EACnBhB,UAAU,GAAG,IAAI;AACnB","ignoreList":[]}