@flowsterix/react 0.3.0 → 0.4.0

package/dist/{chunk-B6OJ26VH.mjs → chunk-2ZX2Y3JL.mjs}

@@ -1,6 +1,11 @@
 import {
-  useTanStackRouterTourAdapter
-} from "./chunk-LQFOZS4Y.mjs";
+  createPathString,
+  notifyRouteChange
+} from "./chunk-B44EX7YT.mjs";
+
+// src/router/tanstackRouterAdapter.tsx
+import { useRouterState } from "@tanstack/react-router";
+import { useEffect as useEffect2 } from "react";
 
 // src/router/tanstackRouterSync.tsx
 import * as TanStackRouter from "@tanstack/react-router";
@@ -41,10 +46,25 @@ var TanStackRouterSync = ({
   return null;
 };
 
+// src/router/tanstackRouterAdapter.tsx
+var useTanStackRouterTourAdapter = () => {
+  const location = useRouterState({
+    select: (state) => state.location
+  });
+  useEffect2(() => {
+    const resolvedPathname = typeof location.pathname === "string" && location.pathname.length > 0 ? location.pathname : "/";
+    const resolvedSearch = "searchStr" in location && typeof location.searchStr === "string" ? location.searchStr : typeof location.search === "string" ? location.search : "";
+    const resolvedHash = typeof location.hash === "string" ? location.hash : "";
+    const path = typeof location.href === "string" && location.href.length > 0 ? location.href : createPathString(resolvedPathname, resolvedSearch, resolvedHash);
+    notifyRouteChange(path);
+  }, [location]);
+};
+
 export {
   setTourRouter,
   setTanStackRouter,
   getTourRouter,
   getTanStackRouter,
-  TanStackRouterSync
+  TanStackRouterSync,
+  useTanStackRouterTourAdapter
 };

package/dist/{chunk-WTGQUDPT.mjs → chunk-B44EX7YT.mjs}

@@ -222,6 +222,12 @@ var notifyRouteChange = (path) => {
 var subscribeToRouteChanges = (listener) => {
   return routeGatingChannel.subscribe(listener);
 };
+var matchRoute = (params) => {
+  const { pattern, path } = params;
+  if (!pattern) return true;
+  if (typeof pattern === "string") return path === pattern;
+  return pattern.test(path);
+};
 
 // src/router/utils.ts
 var ensurePrefix = (value, prefix) => value.startsWith(prefix) ? value : `${prefix}${value}`;
@@ -278,5 +284,6 @@ export {
   getCurrentRoutePath,
   notifyRouteChange,
   subscribeToRouteChanges,
+  matchRoute,
   createPathString
 };

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":"AAAA,OAAO,KAAK,EACV,uBAAuB,EACvB,QAAQ,EACR,qBAAqB,EACrB,gBAAgB,EAChB,cAAc,EACd,UAAU,EACV,SAAS,EAET,YAAY,EAEZ,gBAAgB,EAChB,IAAI,EACJ,cAAc,EAEd,mBAAmB,EACpB,MAAM,kBAAkB,CAAA;AAUzB,OAAO,KAAK,EACV,QAAQ,EACR,iBAAiB,EACjB,SAAS,EACT,cAAc,EACf,MAAM,OAAO,CAAA;AAUd,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAajE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,KAAK,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAA;IACvC,QAAQ,EAAE,SAAS,CAAA;IACnB,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,gBAAgB,CAAC,EAAE,gBAAgB,CAAA;IACnC,oBAAoB,CAAC,EAAE,gBAAgB,CAAA;IACvC,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC,SAAS,CAAC,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAA;IAC5C,mBAAmB,CAAC,EAAE,uBAAuB,CAAA;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,CAAA;IAC5B,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,IAAI,CAAA;CACxD;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC,CAAA;IAC7C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,KAAK,EAAE,SAAS,GAAG,IAAI,CAAA;IACvB,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAA;IAClC,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,KAAK,YAAY,CAAC,SAAS,CAAC,CAAA;IAClF,IAAI,EAAE,MAAM,YAAY,CAAC,SAAS,CAAC,CAAA;IACnC,IAAI,EAAE,MAAM,YAAY,CAAC,SAAS,CAAC,CAAA;IACnC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,KAAK,YAAY,CAAC,SAAS,CAAC,CAAA;IAC5D,KAAK,EAAE,MAAM,YAAY,CAAC,SAAS,CAAC,CAAA;IACpC,MAAM,EAAE,MAAM,YAAY,CAAC,SAAS,CAAC,CAAA;IACrC,MAAM,EAAE,CAAC,MAAM,CAAC,EAAE,gBAAgB,KAAK,YAAY,CAAC,SAAS,CAAC,CAAA;IAC9D,QAAQ,EAAE,MAAM,YAAY,CAAC,SAAS,CAAC,CAAA;IACvC,MAAM,EAAE,QAAQ,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,GAAG,IAAI,CAAA;IAC9C,YAAY,EAAE,OAAO,CAAA;IACrB,eAAe,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IACzC,WAAW,EAAE,MAAM,IAAI,CAAA;IACvB,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAClC,gBAAgB;IAChB,YAAY,EAAE,QAAQ,CAAC,cAAc,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC,CAAA;IAC/D,mBAAmB,EAAE,uBAAuB,CAAA;IAC5C,cAAc,EAAE,OAAO,CAAA;CACxB;AAeD,eAAO,MAAM,YAAY,GAAI,kTAe1B,iBAAiB,CAAC,iBAAiB,CAAC,4CAmkBtC,CAAA;AAED,eAAO,MAAM,OAAO,QAAO,gBAM1B,CAAA;AAED,eAAO,MAAM,aAAa,GACxB,SAAS,SAAS,OAAO,CAAC,MAAM,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,EAE9D,OAAO,SAAS,EAChB,SAAS,CAAC,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,KAAK,IAAI,SAQ7D,CAAA"}

package/dist/index.cjs

@@ -1,9 +1,7 @@
 "use strict";
-var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -17,14 +15,6 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.tsx
@@ -32,7 +22,6 @@ var index_exports = {};
 __export(index_exports, {
   AnimationAdapterProvider: () => AnimationAdapterProvider,
   OverlayBackdrop: () => OverlayBackdrop,
-  TanStackRouterSync: () => TanStackRouterSync,
   TourFocusManager: () => TourFocusManager,
   TourPopoverPortal: () => TourPopoverPortal,
   TourProvider: () => TourProvider,
@@ -41,12 +30,8 @@ __export(index_exports, {
   defaultAnimationAdapter: () => defaultAnimationAdapter,
   defaultLabels: () => defaultLabels,
   getCurrentRoutePath: () => getCurrentRoutePath,
-  getTanStackRouter: () => getTanStackRouter,
-  getTourRouter: () => getTourRouter,
   notifyRouteChange: () => notifyRouteChange,
   reducedMotionAnimationAdapter: () => reducedMotionAnimationAdapter,
-  setTanStackRouter: () => setTanStackRouter,
-  setTourRouter: () => setTourRouter,
   subscribeToRouteChanges: () => subscribeToRouteChanges,
   useAdvanceRules: () => useAdvanceRules,
   useAnimationAdapter: () => useAnimationAdapter,
@@ -60,7 +45,6 @@ __export(index_exports, {
   useHudTargetIssue: () => useHudTargetIssue,
   usePreferredAnimationAdapter: () => usePreferredAnimationAdapter,
   useRadixDialogAdapter: () => useRadixDialogAdapter,
-  useTanStackRouterTourAdapter: () => useTanStackRouterTourAdapter,
   useTour: () => useTour,
   useTourControls: () => useTourControls,
   useTourEvents: () => useTourEvents,
@@ -321,6 +305,127 @@ var supportsMasking = () => {
   return cachedMaskSupport;
 };
 
+// src/router/routeGating.ts
+var DEFAULT_POLL_MS = 150;
+var normalizePathname = (pathname) => {
+  if (typeof pathname !== "string" || pathname.length === 0) {
+    return "/";
+  }
+  return pathname.startsWith("/") ? pathname : `/${pathname}`;
+};
+var normalizePrefixedSegment = (value, prefix) => {
+  if (typeof value !== "string" || value.length === 0) {
+    return "";
+  }
+  return value.startsWith(prefix) ? value : `${prefix}${value}`;
+};
+var getWindowPath = () => {
+  if (!isBrowser) return "/";
+  const { pathname, search, hash } = window.location;
+  return normalizePathname(pathname) + normalizePrefixedSegment(search, "?") + normalizePrefixedSegment(hash, "#");
+};
+var normalizeExternalPath = (path) => {
+  if (path.length === 0) {
+    return "/";
+  }
+  try {
+    const parsed = new URL(path, "http://flowsterix.local");
+    return normalizePathname(parsed.pathname) + normalizePrefixedSegment(parsed.search, "?") + normalizePrefixedSegment(parsed.hash, "#");
+  } catch {
+    const [withoutHash, hash = ""] = path.split("#");
+    const [base, search = ""] = withoutHash.split("?");
+    return normalizePathname(base) + normalizePrefixedSegment(search ? `?${search}` : "", "?") + normalizePrefixedSegment(hash ? `#${hash}` : "", "#");
+  }
+};
+var RouteGatingChannel = class {
+  #listeners = /* @__PURE__ */ new Set();
+  #currentPath = getWindowPath();
+  #teardown = null;
+  #attachDefaultListeners() {
+    if (!isBrowser) return;
+    if (this.#teardown) return;
+    let lastPath = getWindowPath();
+    const emitIfChanged = () => {
+      const nextPath = getWindowPath();
+      if (nextPath === lastPath) return;
+      lastPath = nextPath;
+      this.notify(nextPath);
+    };
+    const handler = () => emitIfChanged();
+    window.addEventListener("popstate", handler);
+    window.addEventListener("hashchange", handler);
+    const pollId = window.setInterval(emitIfChanged, DEFAULT_POLL_MS);
+    this.#teardown = () => {
+      window.removeEventListener("popstate", handler);
+      window.removeEventListener("hashchange", handler);
+      window.clearInterval(pollId);
+      this.#teardown = null;
+    };
+  }
+  #detachDefaultListeners() {
+    if (this.#listeners.size > 0) return;
+    this.#teardown?.();
+    this.#teardown = null;
+  }
+  getCurrentPath() {
+    if (isBrowser) {
+      this.#currentPath = getWindowPath();
+    }
+    return this.#currentPath;
+  }
+  notify(path) {
+    const resolved = typeof path === "string" && path.length > 0 ? normalizeExternalPath(path) : this.getCurrentPath();
+    if (resolved === this.#currentPath) {
+      this.#currentPath = resolved;
+      return;
+    }
+    this.#currentPath = resolved;
+    for (const listener of Array.from(this.#listeners)) {
+      try {
+        listener(resolved);
+      } catch (error) {
+        console.warn("[tour][route-gating] listener error", error);
+      }
+    }
+  }
+  subscribe(listener) {
+    if (this.#listeners.has(listener)) {
+      return () => {
+        this.#listeners.delete(listener);
+        this.#detachDefaultListeners();
+      };
+    }
+    this.#listeners.add(listener);
+    if (this.#listeners.size === 1) {
+      this.#attachDefaultListeners();
+    }
+    const current = this.getCurrentPath();
+    try {
+      listener(current);
+    } catch (error) {
+      console.warn("[tour][route-gating] listener error", error);
+    }
+    return () => {
+      this.#listeners.delete(listener);
+      this.#detachDefaultListeners();
+    };
+  }
+};
+var routeGatingChannel = new RouteGatingChannel();
+var getCurrentRoutePath = () => routeGatingChannel.getCurrentPath();
+var notifyRouteChange = (path) => {
+  routeGatingChannel.notify(path);
+};
+var subscribeToRouteChanges = (listener) => {
+  return routeGatingChannel.subscribe(listener);
+};
+var matchRoute = (params) => {
+  const { pattern, path } = params;
+  if (!pattern) return true;
+  if (typeof pattern === "string") return path === pattern;
+  return pattern.test(path);
+};
+
 // src/context.tsx
 var import_jsx_runtime2 = require("react/jsx-runtime");
 var TourContext = (0, import_react4.createContext)(void 0);
@@ -368,9 +473,7 @@ var TourProvider = ({
   );
   const [debugEnabled, setDebugEnabled] = (0, import_react4.useState)(defaultDebug);
   const [delayInfo, setDelayInfo] = (0, import_react4.useState)(null);
-  const autoStartFlow = (0, import_react4.useMemo)(() => {
-    return flows.find((flow) => flow.autoStart);
-  }, [flows]);
+  const [eligibleAutoStart, setEligibleAutoStart] = (0, import_react4.useState)(null);
   const teardownStore = (0, import_react4.useCallback)(() => {
     unsubscribeRef.current?.();
     unsubscribeRef.current = null;
@@ -574,48 +677,102 @@ var TourProvider = ({
     [ensureStore, resolveResumeStrategy, runResumeHooks]
   );
   (0, import_react4.useEffect)(() => {
-    if (!autoStartFlow) {
-      autoStartRequestedRef.current = null;
+    const autoStartFlows = flows.filter((f) => f.autoStart);
+    if (autoStartFlows.length === 0) {
+      setEligibleAutoStart(null);
+      return;
+    }
+    if (!storageAdapter && !fallbackStorageRef.current && isBrowser) {
+      fallbackStorageRef.current = (0, import_core.createLocalStorageAdapter)();
+    }
+    const resolvedStorageAdapter = storageAdapter ?? fallbackStorageRef.current;
+    if (!resolvedStorageAdapter) {
+      setEligibleAutoStart({
+        flow: autoStartFlows[0],
+        resolvedState: null,
+        stepIndex: 0
+      });
       return;
     }
-    if (activeFlowId) return;
-    if (autoStartRequestedRef.current === autoStartFlow.id) return;
-    autoStartRequestedRef.current = autoStartFlow.id;
     let cancelled = false;
-    const maybeAutoStart = async () => {
-      if (!storageAdapter && !fallbackStorageRef.current && isBrowser) {
-        fallbackStorageRef.current = (0, import_core.createLocalStorageAdapter)();
-      }
-      const resolvedStorageAdapter = storageAdapter ? storageAdapter : fallbackStorageRef.current;
-      if (!resolvedStorageAdapter) {
-        startFlow(autoStartFlow.id, { resume: true });
-        return;
-      }
-      const storageKey = storageNamespace ? `${storageNamespace}:${autoStartFlow.id}` : `${DEFAULT_STORAGE_PREFIX}:${autoStartFlow.id}`;
-      const snapshot = await (0, import_core.resolveMaybePromise)(
-        resolvedStorageAdapter.get(storageKey)
+    const findEligible = async () => {
+      const storageKeys = autoStartFlows.map(
+        (f) => storageNamespace ? `${storageNamespace}:${f.id}` : `${DEFAULT_STORAGE_PREFIX}:${f.id}`
+      );
+      const snapshots = await Promise.all(
+        storageKeys.map(
+          (key) => (0, import_core.resolveMaybePromise)(resolvedStorageAdapter.get(key))
+        )
       );
       if (cancelled) return;
-      const currentVersionStr = (0, import_core.serializeVersion)(autoStartFlow.version);
-      const storedVersionStr = typeof snapshot?.version === "number" ? (0, import_core.serializeVersion)({ major: snapshot.version, minor: 0 }) : snapshot?.version;
-      if (snapshot && storedVersionStr === currentVersionStr) {
-        const storedState = snapshot.value;
-        const isFinished = storedState.status === "completed";
-        const isSkipped = storedState.status === "cancelled" && storedState.cancelReason === "skipped";
-        if (isFinished || isSkipped) {
+      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;
         }
+        const storedVersionStr = typeof snapshot.version === "number" ? (0, import_core.serializeVersion)({ major: snapshot.version, minor: 0 }) : snapshot.version;
+        const storedVersion = (0, import_core.parseVersion)(storedVersionStr);
+        const stepIdMap = (0, import_core.buildStepIdMap)(flow);
+        const { state: resolvedState } = (0, import_core.handleVersionMismatch)({
+          storedState: snapshot.value,
+          storedVersion,
+          definition: flow,
+          currentVersion: flow.version,
+          stepIdMap,
+          now: () => Date.now()
+        });
+        if (resolvedState.status === "completed") continue;
+        if (resolvedState.status === "cancelled" && resolvedState.cancelReason === "skipped") {
+          continue;
+        }
+        const stepIndex = Math.max(0, resolvedState.stepIndex);
+        setEligibleAutoStart({ flow, resolvedState, stepIndex });
+        return;
       }
-      startFlow(autoStartFlow.id, { resume: true });
+      setEligibleAutoStart(null);
     };
-    void maybeAutoStart();
+    void findEligible();
     return () => {
       cancelled = true;
+    };
+  }, [flows, storageAdapter, storageNamespace]);
+  (0, import_react4.useEffect)(() => {
+    if (!eligibleAutoStart) {
+      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) => {
+      if (activeFlowId) return;
+      if (autoStartRequestedRef.current === flow.id) return;
+      if (matchRoute({ pattern: step.route, path })) {
+        autoStartRequestedRef.current = flow.id;
+        startFlow(flow.id, { resume: true });
+      }
+    });
+    return () => {
+      unsubscribe();
       if (!activeFlowId) {
         autoStartRequestedRef.current = null;
       }
     };
-  }, [activeFlowId, autoStartFlow, startFlow, storageAdapter, storageNamespace]);
+  }, [activeFlowId, eligibleAutoStart, 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)(
@@ -1509,123 +1666,6 @@ var import_react9 = require("react");
 
 // src/hooks/useAdvanceRules.ts
 var import_react6 = require("react");
-
-// src/router/routeGating.ts
-var DEFAULT_POLL_MS = 150;
-var normalizePathname = (pathname) => {
-  if (typeof pathname !== "string" || pathname.length === 0) {
-    return "/";
-  }
-  return pathname.startsWith("/") ? pathname : `/${pathname}`;
-};
-var normalizePrefixedSegment = (value, prefix) => {
-  if (typeof value !== "string" || value.length === 0) {
-    return "";
-  }
-  return value.startsWith(prefix) ? value : `${prefix}${value}`;
-};
-var getWindowPath = () => {
-  if (!isBrowser) return "/";
-  const { pathname, search, hash } = window.location;
-  return normalizePathname(pathname) + normalizePrefixedSegment(search, "?") + normalizePrefixedSegment(hash, "#");
-};
-var normalizeExternalPath = (path) => {
-  if (path.length === 0) {
-    return "/";
-  }
-  try {
-    const parsed = new URL(path, "http://flowsterix.local");
-    return normalizePathname(parsed.pathname) + normalizePrefixedSegment(parsed.search, "?") + normalizePrefixedSegment(parsed.hash, "#");
-  } catch {
-    const [withoutHash, hash = ""] = path.split("#");
-    const [base, search = ""] = withoutHash.split("?");
-    return normalizePathname(base) + normalizePrefixedSegment(search ? `?${search}` : "", "?") + normalizePrefixedSegment(hash ? `#${hash}` : "", "#");
-  }
-};
-var RouteGatingChannel = class {
-  #listeners = /* @__PURE__ */ new Set();
-  #currentPath = getWindowPath();
-  #teardown = null;
-  #attachDefaultListeners() {
-    if (!isBrowser) return;
-    if (this.#teardown) return;
-    let lastPath = getWindowPath();
-    const emitIfChanged = () => {
-      const nextPath = getWindowPath();
-      if (nextPath === lastPath) return;
-      lastPath = nextPath;
-      this.notify(nextPath);
-    };
-    const handler = () => emitIfChanged();
-    window.addEventListener("popstate", handler);
-    window.addEventListener("hashchange", handler);
-    const pollId = window.setInterval(emitIfChanged, DEFAULT_POLL_MS);
-    this.#teardown = () => {
-      window.removeEventListener("popstate", handler);
-      window.removeEventListener("hashchange", handler);
-      window.clearInterval(pollId);
-      this.#teardown = null;
-    };
-  }
-  #detachDefaultListeners() {
-    if (this.#listeners.size > 0) return;
-    this.#teardown?.();
-    this.#teardown = null;
-  }
-  getCurrentPath() {
-    if (isBrowser) {
-      this.#currentPath = getWindowPath();
-    }
-    return this.#currentPath;
-  }
-  notify(path) {
-    const resolved = typeof path === "string" && path.length > 0 ? normalizeExternalPath(path) : this.getCurrentPath();
-    if (resolved === this.#currentPath) {
-      this.#currentPath = resolved;
-      return;
-    }
-    this.#currentPath = resolved;
-    for (const listener of Array.from(this.#listeners)) {
-      try {
-        listener(resolved);
-      } catch (error) {
-        console.warn("[tour][route-gating] listener error", error);
-      }
-    }
-  }
-  subscribe(listener) {
-    if (this.#listeners.has(listener)) {
-      return () => {
-        this.#listeners.delete(listener);
-        this.#detachDefaultListeners();
-      };
-    }
-    this.#listeners.add(listener);
-    if (this.#listeners.size === 1) {
-      this.#attachDefaultListeners();
-    }
-    const current = this.getCurrentPath();
-    try {
-      listener(current);
-    } catch (error) {
-      console.warn("[tour][route-gating] listener error", error);
-    }
-    return () => {
-      this.#listeners.delete(listener);
-      this.#detachDefaultListeners();
-    };
-  }
-};
-var routeGatingChannel = new RouteGatingChannel();
-var getCurrentRoutePath = () => routeGatingChannel.getCurrentPath();
-var notifyRouteChange = (path) => {
-  routeGatingChannel.notify(path);
-};
-var subscribeToRouteChanges = (listener) => {
-  return routeGatingChannel.subscribe(listener);
-};
-
-// src/hooks/useAdvanceRules.ts
 var DEFAULT_POLL_MS2 = 250;
 var isListenerTarget = (value) => {
   return !!value && typeof value.addEventListener === "function" && typeof value.removeEventListener === "function";
@@ -3406,7 +3446,7 @@ var TourPopoverPortal = ({
           padding: FLOATING_OFFSET,
           alignment: autoAlignment
         })
-      ] : [(0, import_dom13.flip)({ padding: FLOATING_OFFSET })],
+      ] : [(0, import_dom13.flip)({ padding: FLOATING_OFFSET, fallbackStrategy: "bestFit" })],
       (0, import_dom13.shift)({ padding: FLOATING_OFFSET })
     ];
     const updatePosition = async () => {
@@ -4128,66 +4168,10 @@ var createPathString = (pathname, search, hash) => {
   const hashPart = toHashString(hash);
   return `${normalizedPath}${searchPart}${hashPart}`;
 };
-
-// src/router/tanstackRouterAdapter.tsx
-var import_react_router = require("@tanstack/react-router");
-var import_react23 = require("react");
-var useTanStackRouterTourAdapter = () => {
-  const location = (0, import_react_router.useRouterState)({
-    select: (state) => state.location
-  });
-  (0, import_react23.useEffect)(() => {
-    const resolvedPathname = typeof location.pathname === "string" && location.pathname.length > 0 ? location.pathname : "/";
-    const resolvedSearch = "searchStr" in location && typeof location.searchStr === "string" ? location.searchStr : typeof location.search === "string" ? location.search : "";
-    const resolvedHash = typeof location.hash === "string" ? location.hash : "";
-    const path = typeof location.href === "string" && location.href.length > 0 ? location.href : createPathString(resolvedPathname, resolvedSearch, resolvedHash);
-    notifyRouteChange(path);
-  }, [location]);
-};
-
-// src/router/tanstackRouterSync.tsx
-var TanStackRouter = __toESM(require("@tanstack/react-router"), 1);
-var import_react24 = require("react");
-var currentRouter = null;
-var setTourRouter = (router) => {
-  currentRouter = router;
-};
-var setTanStackRouter = setTourRouter;
-var getTourRouter = () => {
-  return currentRouter;
-};
-var getTanStackRouter = getTourRouter;
-var TanStackRouterSync = ({
-  onRouterAvailable
-}) => {
-  const useRouter2 = TanStackRouter.useRouter;
-  if (typeof useRouter2 !== "function") {
-    if (typeof console !== "undefined") {
-      console.warn(
-        "[tour][router] TanStackRouterSync requires @tanstack/react-router. Call this component only inside TanStack Router environments."
-      );
-    }
-    return null;
-  }
-  useTanStackRouterTourAdapter();
-  const router = useRouter2();
-  (0, import_react24.useEffect)(() => {
-    setTourRouter(router);
-    onRouterAvailable?.(router);
-    return () => {
-      if (getTourRouter() === router) {
-        setTourRouter(null);
-      }
-      onRouterAvailable?.(null);
-    };
-  }, [router, onRouterAvailable]);
-  return null;
-};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AnimationAdapterProvider,
   OverlayBackdrop,
-  TanStackRouterSync,
   TourFocusManager,
   TourPopoverPortal,
   TourProvider,
@@ -4196,12 +4180,8 @@ var TanStackRouterSync = ({
   defaultAnimationAdapter,
   defaultLabels,
   getCurrentRoutePath,
-  getTanStackRouter,
-  getTourRouter,
   notifyRouteChange,
   reducedMotionAnimationAdapter,
-  setTanStackRouter,
-  setTourRouter,
   subscribeToRouteChanges,
   useAdvanceRules,
   useAnimationAdapter,
@@ -4215,7 +4195,6 @@ var TanStackRouterSync = ({
   useHudTargetIssue,
   usePreferredAnimationAdapter,
   useRadixDialogAdapter,
-  useTanStackRouterTourAdapter,
   useTour,
   useTourControls,
   useTourEvents,

package/dist/index.d.ts

@@ -41,5 +41,6 @@ export type { UseHiddenTargetFallbackConfig, UseHiddenTargetFallbackResult, } fr
 export { useViewportRect } from './hooks/useViewportRect';
 export { createWaitForPredicateController } from './hooks/waitForPredicate';
 export type { WaitForPredicateController, WaitForPredicateControllerOptions, } from './hooks/waitForPredicate';
-export { createPathString, getCurrentRoutePath, getTanStackRouter, getTourRouter, notifyRouteChange, setTanStackRouter, setTourRouter, subscribeToRouteChanges, TanStackRouterSync, useTanStackRouterTourAdapter, } from './router';
+export { getCurrentRoutePath, notifyRouteChange, subscribeToRouteChanges, } from './router/routeGating';
+export { createPathString } from './router/utils';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.mjs

@@ -1,13 +1,3 @@
-import {
-  TanStackRouterSync,
-  getTanStackRouter,
-  getTourRouter,
-  setTanStackRouter,
-  setTourRouter
-} from "./chunk-B6OJ26VH.mjs";
-import {
-  useTanStackRouterTourAdapter
-} from "./chunk-LQFOZS4Y.mjs";
 import {
   createPathString,
   expandRect,
@@ -16,16 +6,20 @@ import {
   getScrollParents,
   getViewportRect,
   isBrowser,
+  matchRoute,
   notifyRouteChange,
   portalHost,
   subscribeToRouteChanges,
   supportsMasking
-} from "./chunk-WTGQUDPT.mjs";
+} from "./chunk-B44EX7YT.mjs";
 
 // src/context.tsx
 import {
+  buildStepIdMap,
   createFlowStore,
   createLocalStorageAdapter,
+  handleVersionMismatch,
+  parseVersion,
   resolveMaybePromise,
   serializeVersion
 } from "@flowsterix/core";
@@ -220,9 +214,7 @@ var TourProvider = ({
   );
   const [debugEnabled, setDebugEnabled] = useState2(defaultDebug);
   const [delayInfo, setDelayInfo] = useState2(null);
-  const autoStartFlow = useMemo2(() => {
-    return flows.find((flow) => flow.autoStart);
-  }, [flows]);
+  const [eligibleAutoStart, setEligibleAutoStart] = useState2(null);
   const teardownStore = useCallback(() => {
     unsubscribeRef.current?.();
     unsubscribeRef.current = null;
@@ -426,48 +418,102 @@ var TourProvider = ({
     [ensureStore, resolveResumeStrategy, runResumeHooks]
   );
   useEffect2(() => {
-    if (!autoStartFlow) {
-      autoStartRequestedRef.current = null;
+    const autoStartFlows = flows.filter((f) => f.autoStart);
+    if (autoStartFlows.length === 0) {
+      setEligibleAutoStart(null);
+      return;
+    }
+    if (!storageAdapter && !fallbackStorageRef.current && isBrowser) {
+      fallbackStorageRef.current = createLocalStorageAdapter();
+    }
+    const resolvedStorageAdapter = storageAdapter ?? fallbackStorageRef.current;
+    if (!resolvedStorageAdapter) {
+      setEligibleAutoStart({
+        flow: autoStartFlows[0],
+        resolvedState: null,
+        stepIndex: 0
+      });
       return;
     }
-    if (activeFlowId) return;
-    if (autoStartRequestedRef.current === autoStartFlow.id) return;
-    autoStartRequestedRef.current = autoStartFlow.id;
     let cancelled = false;
-    const maybeAutoStart = async () => {
-      if (!storageAdapter && !fallbackStorageRef.current && isBrowser) {
-        fallbackStorageRef.current = createLocalStorageAdapter();
-      }
-      const resolvedStorageAdapter = storageAdapter ? storageAdapter : fallbackStorageRef.current;
-      if (!resolvedStorageAdapter) {
-        startFlow(autoStartFlow.id, { resume: true });
-        return;
-      }
-      const storageKey = storageNamespace ? `${storageNamespace}:${autoStartFlow.id}` : `${DEFAULT_STORAGE_PREFIX}:${autoStartFlow.id}`;
-      const snapshot = await resolveMaybePromise(
-        resolvedStorageAdapter.get(storageKey)
+    const findEligible = async () => {
+      const storageKeys = autoStartFlows.map(
+        (f) => storageNamespace ? `${storageNamespace}:${f.id}` : `${DEFAULT_STORAGE_PREFIX}:${f.id}`
+      );
+      const snapshots = await Promise.all(
+        storageKeys.map(
+          (key) => resolveMaybePromise(resolvedStorageAdapter.get(key))
+        )
       );
       if (cancelled) return;
-      const currentVersionStr = serializeVersion(autoStartFlow.version);
-      const storedVersionStr = typeof snapshot?.version === "number" ? serializeVersion({ major: snapshot.version, minor: 0 }) : snapshot?.version;
-      if (snapshot && storedVersionStr === currentVersionStr) {
-        const storedState = snapshot.value;
-        const isFinished = storedState.status === "completed";
-        const isSkipped = storedState.status === "cancelled" && storedState.cancelReason === "skipped";
-        if (isFinished || isSkipped) {
+      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;
         }
+        const storedVersionStr = typeof snapshot.version === "number" ? serializeVersion({ major: snapshot.version, minor: 0 }) : snapshot.version;
+        const storedVersion = parseVersion(storedVersionStr);
+        const stepIdMap = buildStepIdMap(flow);
+        const { state: resolvedState } = handleVersionMismatch({
+          storedState: snapshot.value,
+          storedVersion,
+          definition: flow,
+          currentVersion: flow.version,
+          stepIdMap,
+          now: () => Date.now()
+        });
+        if (resolvedState.status === "completed") continue;
+        if (resolvedState.status === "cancelled" && resolvedState.cancelReason === "skipped") {
+          continue;
+        }
+        const stepIndex = Math.max(0, resolvedState.stepIndex);
+        setEligibleAutoStart({ flow, resolvedState, stepIndex });
+        return;
       }
-      startFlow(autoStartFlow.id, { resume: true });
+      setEligibleAutoStart(null);
     };
-    void maybeAutoStart();
+    void findEligible();
     return () => {
       cancelled = true;
+    };
+  }, [flows, storageAdapter, storageNamespace]);
+  useEffect2(() => {
+    if (!eligibleAutoStart) {
+      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) => {
+      if (activeFlowId) return;
+      if (autoStartRequestedRef.current === flow.id) return;
+      if (matchRoute({ pattern: step.route, path })) {
+        autoStartRequestedRef.current = flow.id;
+        startFlow(flow.id, { resume: true });
+      }
+    });
+    return () => {
+      unsubscribe();
       if (!activeFlowId) {
         autoStartRequestedRef.current = null;
       }
     };
-  }, [activeFlowId, autoStartFlow, startFlow, storageAdapter, storageNamespace]);
+  }, [activeFlowId, eligibleAutoStart, startFlow]);
   const next = useCallback(() => getActiveStore().next(), [getActiveStore]);
   const back = useCallback(() => getActiveStore().back(), [getActiveStore]);
   const goToStep = useCallback(
@@ -3147,7 +3193,7 @@ var TourPopoverPortal = ({
           padding: FLOATING_OFFSET,
           alignment: autoAlignment
         })
-      ] : [flip({ padding: FLOATING_OFFSET })],
+      ] : [flip({ padding: FLOATING_OFFSET, fallbackStrategy: "bestFit" })],
       shift({ padding: FLOATING_OFFSET })
     ];
     const updatePosition = async () => {
@@ -3829,7 +3875,6 @@ var useHudMotion = () => {
 export {
   AnimationAdapterProvider,
   OverlayBackdrop,
-  TanStackRouterSync,
   TourFocusManager,
   TourPopoverPortal,
   TourProvider,
@@ -3838,12 +3883,8 @@ export {
   defaultAnimationAdapter,
   defaultLabels,
   getCurrentRoutePath,
-  getTanStackRouter,
-  getTourRouter,
   notifyRouteChange,
   reducedMotionAnimationAdapter,
-  setTanStackRouter,
-  setTourRouter,
   subscribeToRouteChanges,
   useAdvanceRules,
   useAnimationAdapter,
@@ -3857,7 +3898,6 @@ export {
   useHudTargetIssue,
   usePreferredAnimationAdapter,
   useRadixDialogAdapter,
-  useTanStackRouterTourAdapter,
   useTour,
   useTourControls,
   useTourEvents,

package/dist/router/index.cjs

@@ -35,6 +35,7 @@ __export(router_exports, {
   getCurrentRoutePath: () => getCurrentRoutePath,
   getTanStackRouter: () => getTanStackRouter,
   getTourRouter: () => getTourRouter,
+  matchRoute: () => matchRoute,
   notifyRouteChange: () => notifyRouteChange,
   routeGatingChannel: () => routeGatingChannel,
   setTanStackRouter: () => setTanStackRouter,
@@ -161,6 +162,12 @@ var notifyRouteChange = (path) => {
 var subscribeToRouteChanges = (listener) => {
   return routeGatingChannel.subscribe(listener);
 };
+var matchRoute = (params) => {
+  const { pattern, path } = params;
+  if (!pattern) return true;
+  if (typeof pattern === "string") return path === pattern;
+  return pattern.test(path);
+};
 
 // src/router/utils.ts
 var ensurePrefix = (value, prefix) => value.startsWith(prefix) ? value : `${prefix}${value}`;
@@ -207,23 +214,11 @@ var createPathString = (pathname, search, hash) => {
 
 // src/router/tanstackRouterAdapter.tsx
 var import_react_router = require("@tanstack/react-router");
-var import_react = require("react");
-var useTanStackRouterTourAdapter = () => {
-  const location = (0, import_react_router.useRouterState)({
-    select: (state) => state.location
-  });
-  (0, import_react.useEffect)(() => {
-    const resolvedPathname = typeof location.pathname === "string" && location.pathname.length > 0 ? location.pathname : "/";
-    const resolvedSearch = "searchStr" in location && typeof location.searchStr === "string" ? location.searchStr : typeof location.search === "string" ? location.search : "";
-    const resolvedHash = typeof location.hash === "string" ? location.hash : "";
-    const path = typeof location.href === "string" && location.href.length > 0 ? location.href : createPathString(resolvedPathname, resolvedSearch, resolvedHash);
-    notifyRouteChange(path);
-  }, [location]);
-};
+var import_react2 = require("react");
 
 // src/router/tanstackRouterSync.tsx
 var TanStackRouter = __toESM(require("@tanstack/react-router"), 1);
-var import_react2 = require("react");
+var import_react = require("react");
 var currentRouter = null;
 var setTourRouter = (router) => {
   currentRouter = router;
@@ -247,7 +242,7 @@ var TanStackRouterSync = ({
   }
   useTanStackRouterTourAdapter();
   const router = useRouter2();
-  (0, import_react2.useEffect)(() => {
+  (0, import_react.useEffect)(() => {
     setTourRouter(router);
     onRouterAvailable?.(router);
     return () => {
@@ -259,6 +254,20 @@ var TanStackRouterSync = ({
   }, [router, onRouterAvailable]);
   return null;
 };
+
+// src/router/tanstackRouterAdapter.tsx
+var useTanStackRouterTourAdapter = () => {
+  const location = (0, import_react_router.useRouterState)({
+    select: (state) => state.location
+  });
+  (0, import_react2.useEffect)(() => {
+    const resolvedPathname = typeof location.pathname === "string" && location.pathname.length > 0 ? location.pathname : "/";
+    const resolvedSearch = "searchStr" in location && typeof location.searchStr === "string" ? location.searchStr : typeof location.search === "string" ? location.search : "";
+    const resolvedHash = typeof location.hash === "string" ? location.hash : "";
+    const path = typeof location.href === "string" && location.href.length > 0 ? location.href : createPathString(resolvedPathname, resolvedSearch, resolvedHash);
+    notifyRouteChange(path);
+  }, [location]);
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   TanStackRouterSync,
@@ -266,6 +275,7 @@ var TanStackRouterSync = ({
   getCurrentRoutePath,
   getTanStackRouter,
   getTourRouter,
+  matchRoute,
   notifyRouteChange,
   routeGatingChannel,
   setTanStackRouter,

package/dist/router/index.d.ts

@@ -1,4 +1,4 @@
-export { getCurrentRoutePath, notifyRouteChange, routeGatingChannel, subscribeToRouteChanges, } from './routeGating';
+export { getCurrentRoutePath, matchRoute, notifyRouteChange, routeGatingChannel, subscribeToRouteChanges, } from './routeGating';
 export { createPathString } from './utils';
 export { useTanStackRouterTourAdapter } from './tanstackRouterAdapter';
 export { getTanStackRouter, getTourRouter, setTanStackRouter, setTourRouter, TanStackRouterSync, } from './tanstackRouterSync';

package/dist/router/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE1C,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAA;AAEtE,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,kBAAkB,GACnB,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/router/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,eAAe,CAAA;AAEtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE1C,OAAO,EAAE,4BAA4B,EAAE,MAAM,yBAAyB,CAAA;AAEtE,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,kBAAkB,GACnB,MAAM,sBAAsB,CAAA"}

package/dist/router/index.mjs

@@ -3,24 +3,24 @@ import {
   getTanStackRouter,
   getTourRouter,
   setTanStackRouter,
-  setTourRouter
-} from "../chunk-B6OJ26VH.mjs";
-import {
+  setTourRouter,
   useTanStackRouterTourAdapter
-} from "../chunk-LQFOZS4Y.mjs";
+} from "../chunk-2ZX2Y3JL.mjs";
 import {
   createPathString,
   getCurrentRoutePath,
+  matchRoute,
   notifyRouteChange,
   routeGatingChannel,
   subscribeToRouteChanges
-} from "../chunk-WTGQUDPT.mjs";
+} from "../chunk-B44EX7YT.mjs";
 export {
   TanStackRouterSync,
   createPathString,
   getCurrentRoutePath,
   getTanStackRouter,
   getTourRouter,
+  matchRoute,
   notifyRouteChange,
   routeGatingChannel,
   setTanStackRouter,

package/dist/router/nextAppRouterAdapter.mjs

@@ -1,7 +1,7 @@
 import {
   createPathString,
   notifyRouteChange
-} from "../chunk-WTGQUDPT.mjs";
+} from "../chunk-B44EX7YT.mjs";
 
 // src/router/nextAppRouterAdapter.tsx
 import * as NextNavigation from "next/navigation";

package/dist/router/nextPagesRouterAdapter.mjs

@@ -1,7 +1,7 @@
 import {
   createPathString,
   notifyRouteChange
-} from "../chunk-WTGQUDPT.mjs";
+} from "../chunk-B44EX7YT.mjs";
 
 // src/router/nextPagesRouterAdapter.tsx
 import * as NextRouter from "next/router";

package/dist/router/reactRouterAdapter.mjs

@@ -1,7 +1,7 @@
 import {
   createPathString,
   notifyRouteChange
-} from "../chunk-WTGQUDPT.mjs";
+} from "../chunk-B44EX7YT.mjs";
 
 // src/router/reactRouterAdapter.tsx
 import { useEffect } from "react";

package/dist/router/routeGating.d.ts

@@ -9,5 +9,9 @@ export declare const routeGatingChannel: RouteGatingChannel;
 export declare const getCurrentRoutePath: () => string;
 export declare const notifyRouteChange: (path?: string) => void;
 export declare const subscribeToRouteChanges: (listener: RouteChangeListener) => () => void;
+export declare const matchRoute: (params: {
+    pattern: string | RegExp | undefined;
+    path: string;
+}) => boolean;
 export {};
 //# sourceMappingURL=routeGating.d.ts.map

package/dist/router/routeGating.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routeGating.d.ts","sourceRoot":"","sources":["../../src/router/routeGating.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;AAsDxD,cAAM,kBAAkB;;IAsCtB,cAAc,IAAI,MAAM;IAOxB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM;IAmBpB,SAAS,CAAC,QAAQ,EAAE,mBAAmB;CAyBxC;AAED,eAAO,MAAM,kBAAkB,oBAA2B,CAAA;AAE1D,eAAO,MAAM,mBAAmB,cAA4C,CAAA;AAE5E,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,SAE9C,CAAA;AAED,eAAO,MAAM,uBAAuB,GAAI,UAAU,mBAAmB,eAEpE,CAAA"}
+{"version":3,"file":"routeGating.d.ts","sourceRoot":"","sources":["../../src/router/routeGating.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,mBAAmB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;AAsDxD,cAAM,kBAAkB;;IAsCtB,cAAc,IAAI,MAAM;IAOxB,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM;IAmBpB,SAAS,CAAC,QAAQ,EAAE,mBAAmB;CAyBxC;AAED,eAAO,MAAM,kBAAkB,oBAA2B,CAAA;AAE1D,eAAO,MAAM,mBAAmB,cAA4C,CAAA;AAE5E,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,SAE9C,CAAA;AAED,eAAO,MAAM,uBAAuB,GAAI,UAAU,mBAAmB,eAEpE,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,QAAQ;IACjC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACpC,IAAI,EAAE,MAAM,CAAA;CACb,KAAG,OAKH,CAAA"}

package/dist/router/tanstackRouterAdapter.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,16 +17,29 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/router/tanstackRouterAdapter.tsx
 var tanstackRouterAdapter_exports = {};
 __export(tanstackRouterAdapter_exports, {
+  TanStackRouterSync: () => TanStackRouterSync,
+  getTanStackRouter: () => getTanStackRouter,
+  getTourRouter: () => getTourRouter,
+  setTanStackRouter: () => setTanStackRouter,
+  setTourRouter: () => setTourRouter,
   useTanStackRouterTourAdapter: () => useTanStackRouterTourAdapter
 });
 module.exports = __toCommonJS(tanstackRouterAdapter_exports);
 var import_react_router = require("@tanstack/react-router");
-var import_react = require("react");
+var import_react2 = require("react");
 
 // src/utils/dom.ts
 var isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
@@ -183,12 +198,51 @@ var createPathString = (pathname, search, hash) => {
   return `${normalizedPath}${searchPart}${hashPart}`;
 };
 
+// src/router/tanstackRouterSync.tsx
+var TanStackRouter = __toESM(require("@tanstack/react-router"), 1);
+var import_react = require("react");
+var currentRouter = null;
+var setTourRouter = (router) => {
+  currentRouter = router;
+};
+var setTanStackRouter = setTourRouter;
+var getTourRouter = () => {
+  return currentRouter;
+};
+var getTanStackRouter = getTourRouter;
+var TanStackRouterSync = ({
+  onRouterAvailable
+}) => {
+  const useRouter2 = TanStackRouter.useRouter;
+  if (typeof useRouter2 !== "function") {
+    if (typeof console !== "undefined") {
+      console.warn(
+        "[tour][router] TanStackRouterSync requires @tanstack/react-router. Call this component only inside TanStack Router environments."
+      );
+    }
+    return null;
+  }
+  useTanStackRouterTourAdapter();
+  const router = useRouter2();
+  (0, import_react.useEffect)(() => {
+    setTourRouter(router);
+    onRouterAvailable?.(router);
+    return () => {
+      if (getTourRouter() === router) {
+        setTourRouter(null);
+      }
+      onRouterAvailable?.(null);
+    };
+  }, [router, onRouterAvailable]);
+  return null;
+};
+
 // src/router/tanstackRouterAdapter.tsx
 var useTanStackRouterTourAdapter = () => {
   const location = (0, import_react_router.useRouterState)({
     select: (state) => state.location
   });
-  (0, import_react.useEffect)(() => {
+  (0, import_react2.useEffect)(() => {
     const resolvedPathname = typeof location.pathname === "string" && location.pathname.length > 0 ? location.pathname : "/";
     const resolvedSearch = "searchStr" in location && typeof location.searchStr === "string" ? location.searchStr : typeof location.search === "string" ? location.search : "";
     const resolvedHash = typeof location.hash === "string" ? location.hash : "";
@@ -198,5 +252,10 @@ var useTanStackRouterTourAdapter = () => {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  TanStackRouterSync,
+  getTanStackRouter,
+  getTourRouter,
+  setTanStackRouter,
+  setTourRouter,
   useTanStackRouterTourAdapter
 });

package/dist/router/tanstackRouterAdapter.d.ts

@@ -1,2 +1,4 @@
+export { getTanStackRouter, getTourRouter, setTanStackRouter, setTourRouter, TanStackRouterSync, } from './tanstackRouterSync';
+export type { TanStackRouterSyncProps } from './tanstackRouterSync';
 export declare const useTanStackRouterTourAdapter: () => void;
 //# sourceMappingURL=tanstackRouterAdapter.d.ts.map

package/dist/router/tanstackRouterAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tanstackRouterAdapter.d.ts","sourceRoot":"","sources":["../../src/router/tanstackRouterAdapter.tsx"],"names":[],"mappings":"AAMA,eAAO,MAAM,4BAA4B,YAyBxC,CAAA"}
+{"version":3,"file":"tanstackRouterAdapter.d.ts","sourceRoot":"","sources":["../../src/router/tanstackRouterAdapter.tsx"],"names":[],"mappings":"AAOA,OAAO,EACL,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,kBAAkB,GACnB,MAAM,sBAAsB,CAAA;AAC7B,YAAY,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAA;AAEnE,eAAO,MAAM,4BAA4B,YAyBxC,CAAA"}

package/dist/router/tanstackRouterAdapter.mjs

@@ -1,7 +1,17 @@
 import {
+  TanStackRouterSync,
+  getTanStackRouter,
+  getTourRouter,
+  setTanStackRouter,
+  setTourRouter,
   useTanStackRouterTourAdapter
-} from "../chunk-LQFOZS4Y.mjs";
-import "../chunk-WTGQUDPT.mjs";
+} from "../chunk-2ZX2Y3JL.mjs";
+import "../chunk-B44EX7YT.mjs";
 export {
+  TanStackRouterSync,
+  getTanStackRouter,
+  getTourRouter,
+  setTanStackRouter,
+  setTourRouter,
   useTanStackRouterTourAdapter
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowsterix/react",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "React bindings for Flowsterix - guided tours and onboarding flows",
   "license": "MIT",
   "repository": {
@@ -64,7 +64,7 @@
   ],
   "dependencies": {
     "@floating-ui/dom": "^1.7.4",
-    "@flowsterix/core": "0.3.0"
+    "@flowsterix/core": "0.4.0"
   },
   "peerDependencies": {
     "react": ">=18",

package/dist/chunk-LQFOZS4Y.mjs

@@ -1,24 +0,0 @@
-import {
-  createPathString,
-  notifyRouteChange
-} from "./chunk-WTGQUDPT.mjs";
-
-// src/router/tanstackRouterAdapter.tsx
-import { useRouterState } from "@tanstack/react-router";
-import { useEffect } from "react";
-var useTanStackRouterTourAdapter = () => {
-  const location = useRouterState({
-    select: (state) => state.location
-  });
-  useEffect(() => {
-    const resolvedPathname = typeof location.pathname === "string" && location.pathname.length > 0 ? location.pathname : "/";
-    const resolvedSearch = "searchStr" in location && typeof location.searchStr === "string" ? location.searchStr : typeof location.search === "string" ? location.search : "";
-    const resolvedHash = typeof location.hash === "string" ? location.hash : "";
-    const path = typeof location.href === "string" && location.href.length > 0 ? location.href : createPathString(resolvedPathname, resolvedSearch, resolvedHash);
-    notifyRouteChange(path);
-  }, [location]);
-};
-
-export {
-  useTanStackRouterTourAdapter
-};