@flowsterix/react 0.4.0 → 0.4.2

package/dist/context.d.ts.map

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

package/dist/hooks/useHiddenTargetFallback.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useHiddenTargetFallback.d.ts","sourceRoot":"","sources":["../../src/hooks/useHiddenTargetFallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAUrD,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAA;IAC5B,MAAM,EAAE,cAAc,CAAA;IACtB,YAAY,EAAE,cAAc,CAAA;IAC5B,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,cAAc,CAAA;IACtB,mBAAmB,EAAE,OAAO,CAAA;CAC7B;AAED,eAAO,MAAM,uBAAuB,GAAI,yCAKrC,6BAA6B,KAAG,6BAsFlC,CAAA"}
+{"version":3,"file":"useHiddenTargetFallback.d.ts","sourceRoot":"","sources":["../../src/hooks/useHiddenTargetFallback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAMrD,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAA;IAC5B,MAAM,EAAE,cAAc,CAAA;IACtB,YAAY,EAAE,cAAc,CAAA;IAC5B,MAAM,EAAE,MAAM,IAAI,CAAA;CACnB;AAED,MAAM,WAAW,6BAA6B;IAC5C,MAAM,EAAE,cAAc,CAAA;IACtB,mBAAmB,EAAE,OAAO,CAAA;CAC7B;AAED,eAAO,MAAM,uBAAuB,GAAI,yCAKrC,6BAA6B,KAAG,6BAkGlC,CAAA"}

package/dist/index.cjs

@@ -473,7 +473,6 @@ var TourProvider = ({
   );
   const [debugEnabled, setDebugEnabled] = (0, import_react4.useState)(defaultDebug);
   const [delayInfo, setDelayInfo] = (0, import_react4.useState)(null);
-  const [eligibleAutoStart, setEligibleAutoStart] = (0, import_react4.useState)(null);
   const teardownStore = (0, import_react4.useCallback)(() => {
     unsubscribeRef.current?.();
     unsubscribeRef.current = null;
@@ -506,8 +505,7 @@ var TourProvider = ({
     if (!hook) return;
     try {
       const result = hook(context);
-      if (typeof result === "object" && result !== null && typeof result.then === "function") {
-        ;
+      if (result instanceof Promise) {
         result.catch((error) => {
           console.warn(`[tour][step] ${phase} hook rejected`, error);
         });
@@ -676,10 +674,11 @@ var TourProvider = ({
     },
     [ensureStore, resolveResumeStrategy, runResumeHooks]
   );
+  const [eligibleFlows, setEligibleFlows] = (0, import_react4.useState)([]);
   (0, import_react4.useEffect)(() => {
     const autoStartFlows = flows.filter((f) => f.autoStart);
     if (autoStartFlows.length === 0) {
-      setEligibleAutoStart(null);
+      setEligibleFlows([]);
       return;
     }
     if (!storageAdapter && !fallbackStorageRef.current && isBrowser) {
@@ -687,11 +686,13 @@ var TourProvider = ({
     }
     const resolvedStorageAdapter = storageAdapter ?? fallbackStorageRef.current;
     if (!resolvedStorageAdapter) {
-      setEligibleAutoStart({
-        flow: autoStartFlows[0],
-        resolvedState: null,
-        stepIndex: 0
-      });
+      setEligibleFlows(
+        autoStartFlows.map((flow) => ({
+          flow,
+          resolvedState: null,
+          stepIndex: 0
+        }))
+      );
       return;
     }
     let cancelled = false;
@@ -705,12 +706,13 @@ var TourProvider = ({
         )
       );
       if (cancelled) return;
+      const eligible = [];
       for (let i = 0; i < autoStartFlows.length; i++) {
         const flow = autoStartFlows[i];
         const snapshot = snapshots[i];
         if (!snapshot) {
-          setEligibleAutoStart({ flow, resolvedState: null, stepIndex: 0 });
-          return;
+          eligible.push({ flow, resolvedState: null, stepIndex: 0 });
+          continue;
         }
         const storedVersionStr = typeof snapshot.version === "number" ? (0, import_core.serializeVersion)({ major: snapshot.version, minor: 0 }) : snapshot.version;
         const storedVersion = (0, import_core.parseVersion)(storedVersionStr);
@@ -728,10 +730,9 @@ var TourProvider = ({
           continue;
         }
         const stepIndex = Math.max(0, resolvedState.stepIndex);
-        setEligibleAutoStart({ flow, resolvedState, stepIndex });
-        return;
+        eligible.push({ flow, resolvedState, stepIndex });
       }
-      setEligibleAutoStart(null);
+      setEligibleFlows(eligible);
     };
     void findEligible();
     return () => {
@@ -739,32 +740,32 @@ var TourProvider = ({
     };
   }, [flows, storageAdapter, storageNamespace]);
   (0, import_react4.useEffect)(() => {
-    if (!eligibleAutoStart) {
+    if (eligibleFlows.length === 0) {
       autoStartRequestedRef.current = null;
       return;
     }
     if (activeFlowId) return;
-    if (autoStartRequestedRef.current === eligibleAutoStart.flow.id) return;
-    const { flow, stepIndex } = eligibleAutoStart;
-    const step = flow.steps[stepIndex];
-    if (!step?.route) {
-      autoStartRequestedRef.current = flow.id;
-      startFlow(flow.id, { resume: true });
-      return;
-    }
-    const currentPath = getCurrentRoutePath();
-    if (matchRoute({ pattern: step.route, path: currentPath })) {
-      autoStartRequestedRef.current = flow.id;
-      startFlow(flow.id, { resume: true });
-      return;
-    }
-    const unsubscribe = subscribeToRouteChanges((path) => {
+    const findMatchingFlow = (path) => {
+      for (const { flow, stepIndex } of eligibleFlows) {
+        const step = flow.steps[stepIndex];
+        if (!step.route || matchRoute({ pattern: step.route, path })) {
+          return flow;
+        }
+      }
+      return null;
+    };
+    const tryStart = (path) => {
       if (activeFlowId) return;
-      if (autoStartRequestedRef.current === flow.id) return;
-      if (matchRoute({ pattern: step.route, path })) {
+      const flow = findMatchingFlow(path);
+      if (flow && autoStartRequestedRef.current !== flow.id) {
         autoStartRequestedRef.current = flow.id;
         startFlow(flow.id, { resume: true });
       }
+    };
+    const currentPath = getCurrentRoutePath();
+    tryStart(currentPath);
+    const unsubscribe = subscribeToRouteChanges((path) => {
+      tryStart(path);
     });
     return () => {
       unsubscribe();
@@ -772,7 +773,7 @@ var TourProvider = ({
         autoStartRequestedRef.current = null;
       }
     };
-  }, [activeFlowId, eligibleAutoStart, startFlow]);
+  }, [activeFlowId, eligibleFlows, startFlow]);
   const next = (0, import_react4.useCallback)(() => getActiveStore().next(), [getActiveStore]);
   const back = (0, import_react4.useCallback)(() => getActiveStore().back(), [getActiveStore]);
   const goToStep = (0, import_react4.useCallback)(
@@ -1877,10 +1878,6 @@ var useAdvanceRules = (target) => {
 // src/hooks/useHiddenTargetFallback.ts
 var import_react7 = require("react");
 var DEFAULT_DELAY_MS = 900;
-var HIDDEN_VISIBILITIES = [
-  "hidden",
-  "detached"
-];
 var useHiddenTargetFallback = ({
   step,
   target,
@@ -1911,7 +1908,9 @@ var useHiddenTargetFallback = ({
     if (!isBrowser) return void 0;
     if (!step) return void 0;
     clearPendingTimeout();
-    const shouldHandleHiddenTarget = HIDDEN_VISIBILITIES.includes(target.visibility) && !target.isScreen && target.status === "ready";
+    const isHiddenOrDetached = (target.visibility === "hidden" || target.visibility === "detached") && target.status === "ready";
+    const isMissingWithNoRect = target.visibility === "missing" && target.status === "resolving" && target.rect === null && target.lastResolvedRect === null;
+    const shouldHandleHiddenTarget = !target.isScreen && (isHiddenOrDetached || isMissingWithNoRect);
     if (!shouldHandleHiddenTarget) {
       setUsingScreenFallback(false);
       return void 0;
@@ -1935,6 +1934,8 @@ var useHiddenTargetFallback = ({
     target.visibility,
     target.isScreen,
     target.status,
+    target.rect,
+    target.lastResolvedRect,
     hiddenMode,
     hiddenDelayMs,
     onSkip

package/dist/index.mjs

@@ -214,7 +214,6 @@ var TourProvider = ({
   );
   const [debugEnabled, setDebugEnabled] = useState2(defaultDebug);
   const [delayInfo, setDelayInfo] = useState2(null);
-  const [eligibleAutoStart, setEligibleAutoStart] = useState2(null);
   const teardownStore = useCallback(() => {
     unsubscribeRef.current?.();
     unsubscribeRef.current = null;
@@ -247,8 +246,7 @@ var TourProvider = ({
     if (!hook) return;
     try {
       const result = hook(context);
-      if (typeof result === "object" && result !== null && typeof result.then === "function") {
-        ;
+      if (result instanceof Promise) {
         result.catch((error) => {
           console.warn(`[tour][step] ${phase} hook rejected`, error);
         });
@@ -417,10 +415,11 @@ var TourProvider = ({
     },
     [ensureStore, resolveResumeStrategy, runResumeHooks]
   );
+  const [eligibleFlows, setEligibleFlows] = useState2([]);
   useEffect2(() => {
     const autoStartFlows = flows.filter((f) => f.autoStart);
     if (autoStartFlows.length === 0) {
-      setEligibleAutoStart(null);
+      setEligibleFlows([]);
       return;
     }
     if (!storageAdapter && !fallbackStorageRef.current && isBrowser) {
@@ -428,11 +427,13 @@ var TourProvider = ({
     }
     const resolvedStorageAdapter = storageAdapter ?? fallbackStorageRef.current;
     if (!resolvedStorageAdapter) {
-      setEligibleAutoStart({
-        flow: autoStartFlows[0],
-        resolvedState: null,
-        stepIndex: 0
-      });
+      setEligibleFlows(
+        autoStartFlows.map((flow) => ({
+          flow,
+          resolvedState: null,
+          stepIndex: 0
+        }))
+      );
       return;
     }
     let cancelled = false;
@@ -446,12 +447,13 @@ var TourProvider = ({
         )
       );
       if (cancelled) return;
+      const eligible = [];
       for (let i = 0; i < autoStartFlows.length; i++) {
         const flow = autoStartFlows[i];
         const snapshot = snapshots[i];
         if (!snapshot) {
-          setEligibleAutoStart({ flow, resolvedState: null, stepIndex: 0 });
-          return;
+          eligible.push({ flow, resolvedState: null, stepIndex: 0 });
+          continue;
         }
         const storedVersionStr = typeof snapshot.version === "number" ? serializeVersion({ major: snapshot.version, minor: 0 }) : snapshot.version;
         const storedVersion = parseVersion(storedVersionStr);
@@ -469,10 +471,9 @@ var TourProvider = ({
           continue;
         }
         const stepIndex = Math.max(0, resolvedState.stepIndex);
-        setEligibleAutoStart({ flow, resolvedState, stepIndex });
-        return;
+        eligible.push({ flow, resolvedState, stepIndex });
       }
-      setEligibleAutoStart(null);
+      setEligibleFlows(eligible);
     };
     void findEligible();
     return () => {
@@ -480,32 +481,32 @@ var TourProvider = ({
     };
   }, [flows, storageAdapter, storageNamespace]);
   useEffect2(() => {
-    if (!eligibleAutoStart) {
+    if (eligibleFlows.length === 0) {
       autoStartRequestedRef.current = null;
       return;
     }
     if (activeFlowId) return;
-    if (autoStartRequestedRef.current === eligibleAutoStart.flow.id) return;
-    const { flow, stepIndex } = eligibleAutoStart;
-    const step = flow.steps[stepIndex];
-    if (!step?.route) {
-      autoStartRequestedRef.current = flow.id;
-      startFlow(flow.id, { resume: true });
-      return;
-    }
-    const currentPath = getCurrentRoutePath();
-    if (matchRoute({ pattern: step.route, path: currentPath })) {
-      autoStartRequestedRef.current = flow.id;
-      startFlow(flow.id, { resume: true });
-      return;
-    }
-    const unsubscribe = subscribeToRouteChanges((path) => {
+    const findMatchingFlow = (path) => {
+      for (const { flow, stepIndex } of eligibleFlows) {
+        const step = flow.steps[stepIndex];
+        if (!step.route || matchRoute({ pattern: step.route, path })) {
+          return flow;
+        }
+      }
+      return null;
+    };
+    const tryStart = (path) => {
       if (activeFlowId) return;
-      if (autoStartRequestedRef.current === flow.id) return;
-      if (matchRoute({ pattern: step.route, path })) {
+      const flow = findMatchingFlow(path);
+      if (flow && autoStartRequestedRef.current !== flow.id) {
         autoStartRequestedRef.current = flow.id;
         startFlow(flow.id, { resume: true });
       }
+    };
+    const currentPath = getCurrentRoutePath();
+    tryStart(currentPath);
+    const unsubscribe = subscribeToRouteChanges((path) => {
+      tryStart(path);
     });
     return () => {
       unsubscribe();
@@ -513,7 +514,7 @@ var TourProvider = ({
         autoStartRequestedRef.current = null;
       }
     };
-  }, [activeFlowId, eligibleAutoStart, startFlow]);
+  }, [activeFlowId, eligibleFlows, startFlow]);
   const next = useCallback(() => getActiveStore().next(), [getActiveStore]);
   const back = useCallback(() => getActiveStore().back(), [getActiveStore]);
   const goToStep = useCallback(
@@ -1618,10 +1619,6 @@ var useAdvanceRules = (target) => {
 // src/hooks/useHiddenTargetFallback.ts
 import { useEffect as useEffect5, useMemo as useMemo3, useRef as useRef3, useState as useState4 } from "react";
 var DEFAULT_DELAY_MS = 900;
-var HIDDEN_VISIBILITIES = [
-  "hidden",
-  "detached"
-];
 var useHiddenTargetFallback = ({
   step,
   target,
@@ -1652,7 +1649,9 @@ var useHiddenTargetFallback = ({
     if (!isBrowser) return void 0;
     if (!step) return void 0;
     clearPendingTimeout();
-    const shouldHandleHiddenTarget = HIDDEN_VISIBILITIES.includes(target.visibility) && !target.isScreen && target.status === "ready";
+    const isHiddenOrDetached = (target.visibility === "hidden" || target.visibility === "detached") && target.status === "ready";
+    const isMissingWithNoRect = target.visibility === "missing" && target.status === "resolving" && target.rect === null && target.lastResolvedRect === null;
+    const shouldHandleHiddenTarget = !target.isScreen && (isHiddenOrDetached || isMissingWithNoRect);
     if (!shouldHandleHiddenTarget) {
       setUsingScreenFallback(false);
       return void 0;
@@ -1676,6 +1675,8 @@ var useHiddenTargetFallback = ({
     target.visibility,
     target.isScreen,
     target.status,
+    target.rect,
+    target.lastResolvedRect,
     hiddenMode,
     hiddenDelayMs,
     onSkip

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowsterix/react",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "React bindings for Flowsterix - guided tours and onboarding flows",
   "license": "MIT",
   "repository": {