@flowsterix/react 0.13.0 → 0.14.0

package/dist/{chunk-D5LQLRSU.cjs → chunk-7SAJNRGZ.cjs}

@@ -41,8 +41,8 @@ var expandRect = (rect, padding) => {
   const spaceBottom = viewport.height - rect.bottom;
   const spaceLeft = rect.left;
   const spaceRight = viewport.width - rect.right;
-  const verticalPadding = Math.min(padding, spaceTop, spaceBottom);
-  const horizontalPadding = Math.min(padding, spaceLeft, spaceRight);
+  const verticalPadding = Math.max(0, Math.min(padding, spaceTop, spaceBottom));
+  const horizontalPadding = Math.max(0, Math.min(padding, spaceLeft, spaceRight));
   return createRect({
     top: rect.top - verticalPadding,
     left: rect.left - horizontalPadding,

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

@@ -41,8 +41,8 @@ var expandRect = (rect, padding) => {
   const spaceBottom = viewport.height - rect.bottom;
   const spaceLeft = rect.left;
   const spaceRight = viewport.width - rect.right;
-  const verticalPadding = Math.min(padding, spaceTop, spaceBottom);
-  const horizontalPadding = Math.min(padding, spaceLeft, spaceRight);
+  const verticalPadding = Math.max(0, Math.min(padding, spaceTop, spaceBottom));
+  const horizontalPadding = Math.max(0, Math.min(padding, spaceLeft, spaceRight));
   return createRect({
     top: rect.top - verticalPadding,
     left: rect.left - horizontalPadding,

package/dist/context.d.ts

@@ -41,7 +41,7 @@ export interface TourContextValue {
     resume: () => MaybePromise<FlowState>;
     cancel: (reason?: FlowCancelReason) => MaybePromise<FlowState>;
     complete: () => MaybePromise<FlowState>;
-    advanceStep: (stepId: string) => MaybePromise<FlowState>;
+    advanceStep: (stepId: string) => MaybePromise<FlowState | null>;
     events: EventBus<FlowEvents<ReactNode>> | null;
     debugEnabled: boolean;
     setDebugEnabled: (value: boolean) => void;

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/devtools/globalBridge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"globalBridge.d.ts","sourceRoot":"","sources":["../../src/devtools/globalBridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,WAAW,mBAAmB;IAClC,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,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IAC3D,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACvE;AAED,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,KAAK,IAAI,CAAA;AAqB3D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI,CAMzE;AAED,wBAAgB,iBAAiB,IAAI,mBAAmB,GAAG,IAAI,CAE9D;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAMtE"}
+{"version":3,"file":"globalBridge.d.ts","sourceRoot":"","sources":["../../src/devtools/globalBridge.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,MAAM,WAAW,mBAAmB;IAClC,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,MAAM,EAAE,MAAM,IAAI,CAAA;IAClB,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;IAC3D,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;IACpD,iBAAiB,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACvE;AAED,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,KAAK,IAAI,CAAA;AAuB3D,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,GAAG,IAAI,CAMzE;AAED,wBAAgB,iBAAiB,IAAI,mBAAmB,GAAG,IAAI,CAE9D;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,IAAI,CAMtE"}

package/dist/devtools/hooks/useStepStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useStepStore.d.ts","sourceRoot":"","sources":["../../../src/devtools/hooks/useStepStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAoCxE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,OAAO,EAAE,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,KAAK,WAAW,CAAA;IACvD,UAAU,EAAE,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IAC5C,UAAU,EAAE,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;KAAE,KAAK,IAAI,CAAA;IAC3E,YAAY,EAAE,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IACtE,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,WAAW,EAAE,MAAM,cAAc,CAAA;CAClC;AAED,wBAAgB,YAAY,IAAI,kBAAkB,CAmIjD"}
+{"version":3,"file":"useStepStore.d.ts","sourceRoot":"","sources":["../../../src/devtools/hooks/useStepStore.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,UAAU,CAAA;AAsCxE,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,WAAW,EAAE,CAAA;IACpB,OAAO,EAAE,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,KAAK,WAAW,CAAA;IACvD,UAAU,EAAE,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IAC5C,UAAU,EAAE,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;KAAE,KAAK,IAAI,CAAA;IAC3E,YAAY,EAAE,CAAC,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;IACtE,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,WAAW,EAAE,MAAM,cAAc,CAAA;CAClC;AAED,wBAAgB,YAAY,IAAI,kBAAkB,CAmIjD"}

package/dist/devtools/index.cjs

@@ -1469,9 +1469,10 @@ function TabNav(props) {
 
 // src/devtools/globalBridge.ts
 var BRIDGE_KEY = "__FLOWSTERIX_DEVTOOLS_BRIDGE__";
+var SERVER_BRIDGE = { value: null, listeners: /* @__PURE__ */ new Set() };
 function getBridge() {
   if (typeof window === "undefined") {
-    return { value: null, listeners: /* @__PURE__ */ new Set() };
+    return SERVER_BRIDGE;
   }
   const w = window;
   if (!w[BRIDGE_KEY]) {
@@ -2568,8 +2569,9 @@ function subscribe(listener) {
 function getSnapshot() {
   return store.steps;
 }
+var SERVER_SNAPSHOT = [];
 function getServerSnapshot() {
-  return [];
+  return SERVER_SNAPSHOT;
 }
 function generateId() {
   return `step-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;

package/dist/devtools/index.mjs

@@ -1469,9 +1469,10 @@ import { useCallback as useCallback2, useEffect as useEffect4, useState as useSt
 
 // src/devtools/globalBridge.ts
 var BRIDGE_KEY = "__FLOWSTERIX_DEVTOOLS_BRIDGE__";
+var SERVER_BRIDGE = { value: null, listeners: /* @__PURE__ */ new Set() };
 function getBridge() {
   if (typeof window === "undefined") {
-    return { value: null, listeners: /* @__PURE__ */ new Set() };
+    return SERVER_BRIDGE;
   }
   const w = window;
   if (!w[BRIDGE_KEY]) {
@@ -2568,8 +2569,9 @@ function subscribe(listener) {
 function getSnapshot() {
   return store.steps;
 }
+var SERVER_SNAPSHOT = [];
 function getServerSnapshot() {
-  return [];
+  return SERVER_SNAPSHOT;
 }
 function generateId() {
   return `step-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`;

package/dist/hooks/useConstrainedScrollLock.d.ts

@@ -18,6 +18,13 @@ export interface ConstrainedScrollLockOptions {
      * Default: 0
      */
     padding?: number;
+    /**
+     * Bottom inset in pixels (e.g. mobile drawer height) to account for
+     * when calculating scroll bounds. Increases maxY so users can scroll
+     * the target bottom into view above the inset area.
+     * Default: 0
+     */
+    bottomInset?: number;
 }
 /**
  * Enhanced scroll lock that allows constrained scrolling when target is larger than viewport.
@@ -25,5 +32,9 @@ export interface ConstrainedScrollLockOptions {
  * - If target fits in viewport: normal scroll lock (overflow: hidden)
  * - If target > viewport: allow scrolling within target bounds only
  */
-export declare const useConstrainedScrollLock: ({ enabled, targetRect, viewportHeight, padding, }: ConstrainedScrollLockOptions) => void;
+export interface ConstrainedScrollLockResult {
+    /** Whether constrained scroll mode is active (target exceeds effective viewport). */
+    isConstrainedMode: boolean;
+}
+export declare const useConstrainedScrollLock: ({ enabled, targetRect, viewportHeight, padding, bottomInset, }: ConstrainedScrollLockOptions) => ConstrainedScrollLockResult;
 //# sourceMappingURL=useConstrainedScrollLock.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useConstrainedScrollLock.d.ts","sourceRoot":"","sources":["../../src/hooks/useConstrainedScrollLock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAGlD,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB;;;OAGG;IACH,UAAU,EAAE,cAAc,GAAG,IAAI,CAAA;IACjC;;OAEG;IACH,cAAc,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAwBD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GAAI,mDAKtC,4BAA4B,SA6D9B,CAAA"}
+{"version":3,"file":"useConstrainedScrollLock.d.ts","sourceRoot":"","sources":["../../src/hooks/useConstrainedScrollLock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAGlD,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,OAAO,EAAE,OAAO,CAAA;IAChB;;;OAGG;IACH,UAAU,EAAE,cAAc,GAAG,IAAI,CAAA;IACjC;;OAEG;IACH,cAAc,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB;AAwBD;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,qFAAqF;IACrF,iBAAiB,EAAE,OAAO,CAAA;CAC3B;AAED,eAAO,MAAM,wBAAwB,GAAI,gEAMtC,4BAA4B,KAAG,2BAqEjC,CAAA"}

package/dist/hooks/useTourHud.d.ts

@@ -18,6 +18,12 @@ export interface UseTourHudOptions {
      * Enabled by default.
      */
     bodyScrollLock?: boolean;
+    /**
+     * Bottom inset in pixels for constrained scroll lock (e.g. mobile drawer height).
+     * When a target is taller than the viewport, this ensures users can scroll
+     * the target bottom into view above the inset area.
+     */
+    scrollLockBottomInset?: number;
 }
 export interface TourHudOverlayConfig {
     padding?: number;
@@ -59,6 +65,8 @@ export interface UseTourHudResult {
     targetIssue: UseHudTargetIssueResult;
     shouldLockBodyScroll: boolean;
     shortcutsEnabled: boolean;
+    /** Whether constrained scroll mode is active (target taller than viewport). */
+    isConstrainedScrollActive: boolean;
 }
 export declare const useTourHud: (options?: UseTourHudOptions) => UseTourHudResult;
 //# sourceMappingURL=useTourHud.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useTourHud.d.ts","sourceRoot":"","sources":["../../src/hooks/useTourHud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAMtC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAElE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAE/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,sBAAsB,CAAA;IAC5C;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,uBAAuB,CAAA;CACzC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,SAAS,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,CAAA;CACzC;AAED,MAAM,WAAW,kBAAmB,SAAQ,uBAAuB;IACjE;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,cAAc,CAAA;IACtB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;IAC/B,cAAc,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;IAClD,qBAAqB,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,iBAAiB,EAAE,OAAO,CAAA;IAC1B,OAAO,EAAE,oBAAoB,CAAA;IAC7B,OAAO,EAAE,oBAAoB,CAAA;IAC7B,WAAW,EAAE,kBAAkB,CAAA;IAC/B,YAAY,EAAE,wBAAwB,CAAA;IACtC,WAAW,EAAE,uBAAuB,CAAA;IACpC,oBAAoB,EAAE,OAAO,CAAA;IAC7B,gBAAgB,EAAE,OAAO,CAAA;CAC1B;AAKD,eAAO,MAAM,UAAU,GACrB,UAAS,iBAAsB,KAC9B,gBAqGF,CAAA"}
+{"version":3,"file":"useTourHud.d.ts","sourceRoot":"","sources":["../../src/hooks/useTourHud.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAMtC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAElE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAE/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAA;AAEtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAA;AAElE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAErD,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,sBAAsB,CAAA;IAC5C;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,eAAe,EAAE,uBAAuB,CAAA;CACzC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,SAAS,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,CAAC,CAAA;CACzC;AAED,MAAM,WAAW,kBAAmB,SAAQ,uBAAuB;IACjE;;OAEG;IACH,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,cAAc,CAAA;IACtB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;IAC/B,cAAc,EAAE,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,KAAK,IAAI,CAAA;IAClD,qBAAqB,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAA;CAC9C;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,iBAAiB,CAAA;IAC3B,iBAAiB,EAAE,OAAO,CAAA;IAC1B,OAAO,EAAE,oBAAoB,CAAA;IAC7B,OAAO,EAAE,oBAAoB,CAAA;IAC7B,WAAW,EAAE,kBAAkB,CAAA;IAC/B,YAAY,EAAE,wBAAwB,CAAA;IACtC,WAAW,EAAE,uBAAuB,CAAA;IACpC,oBAAoB,EAAE,OAAO,CAAA;IAC7B,gBAAgB,EAAE,OAAO,CAAA;IACzB,+EAA+E;IAC/E,yBAAyB,EAAE,OAAO,CAAA;CACnC;AAKD,eAAO,MAAM,UAAU,GACrB,UAAS,iBAAsB,KAC9B,gBAyGF,CAAA"}

package/dist/index.cjs

@@ -15,7 +15,7 @@ require('./chunk-HPVLOLCD.cjs');
 
 
 
-var _chunkD5LQLRSUcjs = require('./chunk-D5LQLRSU.cjs');
+var _chunk7SAJNRGZcjs = require('./chunk-7SAJNRGZ.cjs');
 
 // src/context.tsx
 
@@ -433,7 +433,7 @@ var TourProvider = ({
       if (!definition) {
         throw new Error(`Flow with id "${flowId}" is not registered.`);
       }
-      if (!storageAdapter && !fallbackStorageRef.current && _chunkD5LQLRSUcjs.isBrowser) {
+      if (!storageAdapter && !fallbackStorageRef.current && _chunk7SAJNRGZcjs.isBrowser) {
         fallbackStorageRef.current = _core.createLocalStorageAdapter.call(void 0, );
       }
       const resolvedStorageAdapter2 = storageAdapter ? storageAdapter : fallbackStorageRef.current;
@@ -589,7 +589,7 @@ var TourProvider = ({
       setEligibleFlows([]);
       return;
     }
-    if (!storageAdapter && !fallbackStorageRef.current && _chunkD5LQLRSUcjs.isBrowser) {
+    if (!storageAdapter && !fallbackStorageRef.current && _chunk7SAJNRGZcjs.isBrowser) {
       fallbackStorageRef.current = _core.createLocalStorageAdapter.call(void 0, );
     }
     const resolvedStorageAdapter2 = _nullishCoalesce(storageAdapter, () => ( fallbackStorageRef.current));
@@ -656,7 +656,7 @@ var TourProvider = ({
     const findMatchingFlow = (path) => {
       for (const { flow, stepIndex } of eligibleFlows) {
         const step = flow.steps[stepIndex];
-        if (!step.route || _chunkD5LQLRSUcjs.matchRoute.call(void 0, { pattern: step.route, path })) {
+        if (!step.route || _chunk7SAJNRGZcjs.matchRoute.call(void 0, { pattern: step.route, path })) {
           return flow;
         }
       }
@@ -670,9 +670,9 @@ var TourProvider = ({
         startFlow(flow.id, { resume: true });
       }
     };
-    const currentPath = _chunkD5LQLRSUcjs.getCurrentRoutePath.call(void 0, );
+    const currentPath = _chunk7SAJNRGZcjs.getCurrentRoutePath.call(void 0, );
     tryStart(currentPath);
-    const unsubscribe = _chunkD5LQLRSUcjs.subscribeToRouteChanges.call(void 0, (path) => {
+    const unsubscribe = _chunk7SAJNRGZcjs.subscribeToRouteChanges.call(void 0, (path) => {
       tryStart(path);
     });
     return () => {
@@ -716,8 +716,12 @@ var TourProvider = ({
     [getActiveStore]
   );
   const advanceStep = _react.useCallback.call(void 0, 
-    (stepId) => getActiveStore().advanceStep(stepId),
-    [getActiveStore]
+    (stepId) => {
+      const store = storeRef.current;
+      if (!store) return null;
+      return store.advanceStep(stepId);
+    },
+    []
   );
   const toggleDebug = _react.useCallback.call(void 0, () => {
     setDebugEnabled((previous) => !previous);
@@ -1133,7 +1137,7 @@ var computeRectSource = (rect, storedRect, isScreen) => {
   return "none";
 };
 var computeVisibilityState = (element, rect, isScreen) => {
-  if (!_chunkD5LQLRSUcjs.isBrowser) return "unknown";
+  if (!_chunk7SAJNRGZcjs.isBrowser) return "unknown";
   if (isScreen) return "visible";
   if (!element) return "missing";
   if (!document.documentElement.contains(element)) return "detached";
@@ -1149,7 +1153,7 @@ var computeVisibilityState = (element, rect, isScreen) => {
   return "visible";
 };
 var scrollContainerBy = (container, topDelta, leftDelta, behavior) => {
-  if (!_chunkD5LQLRSUcjs.isBrowser) return;
+  if (!_chunk7SAJNRGZcjs.isBrowser) return;
   if (Math.abs(topDelta) < 0.5 && Math.abs(leftDelta) < 0.5) {
     return;
   }
@@ -1176,8 +1180,8 @@ var scrollContainerBy = (container, topDelta, leftDelta, behavior) => {
 };
 var alignWithinViewport = (element, margin, behavior, mode) => {
   if (mode === "preserve") return;
-  const viewportRect = _chunkD5LQLRSUcjs.getViewportRect.call(void 0, );
-  const finalRect = _chunkD5LQLRSUcjs.getClientRect.call(void 0, element);
+  const viewportRect = _chunk7SAJNRGZcjs.getViewportRect.call(void 0, );
+  const finalRect = _chunk7SAJNRGZcjs.getClientRect.call(void 0, element);
   const availableHeight = viewportRect.height - (margin.top + margin.bottom);
   if (availableHeight <= 0) return;
   const desiredTop = mode === "center" ? margin.top + (availableHeight - finalRect.height) / 2 : margin.top;
@@ -1191,15 +1195,15 @@ var alignWithinViewport = (element, margin, behavior, mode) => {
 var ensureElementInView = (element, margin, options) => {
   const behavior = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _37 => _37.behavior]), () => ( "auto"));
   const mode = _nullishCoalesce(_optionalChain([options, 'optionalAccess', _38 => _38.mode]), () => ( "preserve"));
-  if (!_chunkD5LQLRSUcjs.isBrowser) return;
-  const scrollParents = _chunkD5LQLRSUcjs.getScrollParents.call(void 0, element);
+  if (!_chunk7SAJNRGZcjs.isBrowser) return;
+  const scrollParents = _chunk7SAJNRGZcjs.getScrollParents.call(void 0, element);
   const rootScroller = document.scrollingElement;
   if (rootScroller && !scrollParents.includes(rootScroller)) {
     scrollParents.push(rootScroller);
   }
   for (const container of scrollParents) {
-    const containerRect = container === rootScroller || container === document.body || container === document.documentElement ? _chunkD5LQLRSUcjs.getViewportRect.call(void 0, ) : _chunkD5LQLRSUcjs.getClientRect.call(void 0, container);
-    const targetRect = _chunkD5LQLRSUcjs.getClientRect.call(void 0, element);
+    const containerRect = container === rootScroller || container === document.body || container === document.documentElement ? _chunk7SAJNRGZcjs.getViewportRect.call(void 0, ) : _chunk7SAJNRGZcjs.getClientRect.call(void 0, container);
+    const targetRect = _chunk7SAJNRGZcjs.getClientRect.call(void 0, element);
     let topDelta = 0;
     if (targetRect.top < containerRect.top + margin.top) {
       topDelta = targetRect.top - (containerRect.top + margin.top);
@@ -1216,8 +1220,8 @@ var ensureElementInView = (element, margin, options) => {
       scrollContainerBy(container, topDelta, leftDelta, behavior);
     }
   }
-  const viewportRect = _chunkD5LQLRSUcjs.getViewportRect.call(void 0, );
-  const finalRect = _chunkD5LQLRSUcjs.getClientRect.call(void 0, element);
+  const viewportRect = _chunk7SAJNRGZcjs.getViewportRect.call(void 0, );
+  const finalRect = _chunk7SAJNRGZcjs.getClientRect.call(void 0, element);
   let viewportTopDelta = 0;
   if (finalRect.top < viewportRect.top + margin.top) {
     viewportTopDelta = finalRect.top - (viewportRect.top + margin.top);
@@ -1240,7 +1244,7 @@ var ensureElementInView = (element, margin, options) => {
   alignWithinViewport(element, margin, behavior, mode);
 };
 var resolveStepTarget = (target) => {
-  if (!_chunkD5LQLRSUcjs.isBrowser) return null;
+  if (!_chunk7SAJNRGZcjs.isBrowser) return null;
   if (target === "screen") {
     return document.body;
   }
@@ -1271,7 +1275,7 @@ var useTourTarget = () => {
   const lastRectRef = _react.useRef.call(void 0, null);
   const initialScrollStepRef = _react.useRef.call(void 0, null);
   const cancelAutoScrollLoop = () => {
-    if (!_chunkD5LQLRSUcjs.isBrowser) return;
+    if (!_chunk7SAJNRGZcjs.isBrowser) return;
     if (autoScrollTimeoutRef.current !== null) {
       globalThis.clearTimeout(autoScrollTimeoutRef.current);
       autoScrollTimeoutRef.current = null;
@@ -1290,7 +1294,7 @@ var useTourTarget = () => {
     };
   }, [_optionalChain([activeStep, 'optionalAccess', _39 => _39.id])]);
   _react.useLayoutEffect.call(void 0, () => {
-    if (!_chunkD5LQLRSUcjs.isBrowser) return;
+    if (!_chunk7SAJNRGZcjs.isBrowser) return;
     if (!activeStep) return;
     if (targetInfo.status !== "ready") return;
     if (targetInfo.isScreen) return;
@@ -1334,7 +1338,7 @@ var useTourTarget = () => {
       cancelAutoScrollLoop();
       return;
     }
-    if (!_chunkD5LQLRSUcjs.isBrowser) {
+    if (!_chunk7SAJNRGZcjs.isBrowser) {
       const storedRect = _nullishCoalesce(lastResolvedRectByStep.get(activeStep.id), () => ( null));
       setTargetInfo({
         element: null,
@@ -1422,7 +1426,7 @@ var useTourTarget = () => {
     };
     function updateTargetState(status, rectOverride) {
       if (cancelled) return;
-      const rect = typeof rectOverride !== "undefined" ? rectOverride : isScreen ? _chunkD5LQLRSUcjs.getViewportRect.call(void 0, ) : element ? _chunkD5LQLRSUcjs.getClientRect.call(void 0, element) : null;
+      const rect = typeof rectOverride !== "undefined" ? rectOverride : isScreen ? _chunk7SAJNRGZcjs.getViewportRect.call(void 0, ) : element ? _chunk7SAJNRGZcjs.getClientRect.call(void 0, element) : null;
       if (status === "ready" && hasWaitForSelector && waitForStartedAt === null) {
         waitForStartedAt = Date.now();
       }
@@ -1490,14 +1494,14 @@ var useTourTarget = () => {
       }
     }
     function startRafMonitor() {
-      if (isScreen || !_chunkD5LQLRSUcjs.isBrowser) return;
+      if (isScreen || !_chunk7SAJNRGZcjs.isBrowser) return;
       stopRaf();
       const tick = () => {
         if (cancelled) return;
         if (!element) {
           updateTargetState("resolving", null);
         } else {
-          const rect = _chunkD5LQLRSUcjs.getClientRect.call(void 0, element);
+          const rect = _chunk7SAJNRGZcjs.getClientRect.call(void 0, element);
           if (rectChanged(rect)) {
             updateTargetState("ready", rect);
           }
@@ -1562,7 +1566,7 @@ var useTourTarget = () => {
           window.removeEventListener("scroll", onReposition, true);
         });
         const onAncestorScroll = () => commitInfo("ready");
-        scrollParents = _chunkD5LQLRSUcjs.getScrollParents.call(void 0, element);
+        scrollParents = _chunk7SAJNRGZcjs.getScrollParents.call(void 0, element);
         if (scrollParents.length > 0) {
           scrollParents.forEach(
             (parent) => parent.addEventListener("scroll", onAncestorScroll, {
@@ -1645,7 +1649,7 @@ var useTourTarget = () => {
     };
   }, [activeStep, activeFlowId, flows, state]);
   _react.useEffect.call(void 0, () => {
-    if (!_chunkD5LQLRSUcjs.isBrowser) return;
+    if (!_chunk7SAJNRGZcjs.isBrowser) return;
     if (!activeStep) {
       cancelAutoScrollLoop();
       return;
@@ -1678,11 +1682,11 @@ var useTourTarget = () => {
     const scrollMode = _nullishCoalesce(_optionalChain([activeStep, 'access', _65 => _65.targetBehavior, 'optionalAccess', _66 => _66.scrollMode]), () => ( "center"));
     const runCheck = () => {
       autoScrollRafRef.current = null;
-      if (!_chunkD5LQLRSUcjs.isBrowser) return;
+      if (!_chunk7SAJNRGZcjs.isBrowser) return;
       if (autoState.stepId !== activeStep.id) return;
       if (!element.isConnected) return;
-      const rect = _chunkD5LQLRSUcjs.getClientRect.call(void 0, element);
-      const viewport = _chunkD5LQLRSUcjs.getViewportRect.call(void 0, );
+      const rect = _chunk7SAJNRGZcjs.getClientRect.call(void 0, element);
+      const viewport = _chunk7SAJNRGZcjs.getViewportRect.call(void 0, );
       const margin = resolveScrollMargin(
         _optionalChain([activeStep, 'access', _67 => _67.targetBehavior, 'optionalAccess', _68 => _68.scrollMargin]),
         DEFAULT_SCROLL_MARGIN
@@ -1734,7 +1738,7 @@ var isListenerTarget = (value) => {
   return !!value && typeof value.addEventListener === "function" && typeof value.removeEventListener === "function";
 };
 var resolveEventTarget = (rule, target) => {
-  if (!_chunkD5LQLRSUcjs.isBrowser) return null;
+  if (!_chunk7SAJNRGZcjs.isBrowser) return null;
   if (!rule.on || rule.on === "target") {
     return _nullishCoalesce(target.element, () => ( null));
   }
@@ -1768,7 +1772,7 @@ var useAdvanceRules = (target) => {
     setDelayInfo
   } = useTour();
   _react.useEffect.call(void 0, () => {
-    if (!_chunkD5LQLRSUcjs.isBrowser) return;
+    if (!_chunk7SAJNRGZcjs.isBrowser) return;
     if (!state || state.status !== "running") return;
     if (!activeStep) return;
     const definition = activeFlowId ? flows.get(activeFlowId) : void 0;
@@ -1901,12 +1905,12 @@ var useAdvanceRules = (target) => {
               finish();
             }
           };
-          const initialPath = _chunkD5LQLRSUcjs.getCurrentRoutePath.call(void 0, );
+          const initialPath = _chunk7SAJNRGZcjs.getCurrentRoutePath.call(void 0, );
           checkRoute(initialPath);
           if (hasResolved()) {
             break;
           }
-          const unsubscribe = _chunkD5LQLRSUcjs.subscribeToRouteChanges.call(void 0, (path) => {
+          const unsubscribe = _chunk7SAJNRGZcjs.subscribeToRouteChanges.call(void 0, (path) => {
             checkRoute(path);
           });
           addCleanup(unsubscribe);
@@ -1983,7 +1987,7 @@ var useHiddenTargetFallback = ({
     };
   }, [_optionalChain([step, 'optionalAccess', _76 => _76.id])]);
   _react.useEffect.call(void 0, () => {
-    if (!_chunkD5LQLRSUcjs.isBrowser) return void 0;
+    if (!_chunk7SAJNRGZcjs.isBrowser) return void 0;
     if (!step) return void 0;
     clearPendingTimeout();
     clearGraceTimeout();
@@ -2063,14 +2067,14 @@ var useHiddenTargetFallback = ({
 // src/hooks/useRouteMismatch.ts
 
 var useRouteMismatch = (step) => {
-  const [currentPath, setCurrentPath] = _react.useState.call(void 0, () => _chunkD5LQLRSUcjs.getCurrentRoutePath.call(void 0, ));
+  const [currentPath, setCurrentPath] = _react.useState.call(void 0, () => _chunk7SAJNRGZcjs.getCurrentRoutePath.call(void 0, ));
   _react.useEffect.call(void 0, () => {
-    return _chunkD5LQLRSUcjs.subscribeToRouteChanges.call(void 0, (path) => {
+    return _chunk7SAJNRGZcjs.subscribeToRouteChanges.call(void 0, (path) => {
       setCurrentPath(path);
     });
   }, []);
   const expectedRoute = _optionalChain([step, 'optionalAccess', _77 => _77.route]);
-  const isRouteMismatch = step !== null && expectedRoute !== void 0 && !_chunkD5LQLRSUcjs.matchRoute.call(void 0, { pattern: expectedRoute, path: currentPath });
+  const isRouteMismatch = step !== null && expectedRoute !== void 0 && !_chunk7SAJNRGZcjs.matchRoute.call(void 0, { pattern: expectedRoute, path: currentPath });
   return {
     isRouteMismatch,
     currentPath,
@@ -2082,14 +2086,14 @@ var useRouteMismatch = (step) => {
 
 var useViewportRect = () => {
   const [viewport, setViewport] = _react.useState.call(void 0, 
-    () => _chunkD5LQLRSUcjs.getViewportRect.call(void 0, )
+    () => _chunk7SAJNRGZcjs.getViewportRect.call(void 0, )
   );
   const rafRef = _react.useRef.call(void 0, null);
   _react.useEffect.call(void 0, () => {
-    if (!_chunkD5LQLRSUcjs.isBrowser) return;
+    if (!_chunk7SAJNRGZcjs.isBrowser) return;
     const updateViewport = () => {
       rafRef.current = null;
-      setViewport(_chunkD5LQLRSUcjs.getViewportRect.call(void 0, ));
+      setViewport(_chunk7SAJNRGZcjs.getViewportRect.call(void 0, ));
     };
     const scheduleUpdate = () => {
       if (rafRef.current !== null) return;
@@ -2395,7 +2399,7 @@ var useHudShortcuts = (target, options) => {
   const { state } = useTour();
   const { cancel, canGoBack, goBack, canGoNext, goNext, isActive } = useTourControls();
   _react.useEffect.call(void 0, () => {
-    if (!_chunkD5LQLRSUcjs.isBrowser) return void 0;
+    if (!_chunk7SAJNRGZcjs.isBrowser) return void 0;
     if (!enabled) return void 0;
     if (!target) return void 0;
     if (!state || state.status !== "running") return void 0;
@@ -2465,7 +2469,7 @@ var useHudShortcuts = (target, options) => {
 var lockCount = 0;
 var previousOverflow = null;
 var acquireHardLock = () => {
-  if (!_chunkD5LQLRSUcjs.isBrowser) return;
+  if (!_chunk7SAJNRGZcjs.isBrowser) return;
   if (lockCount === 0) {
     previousOverflow = document.body.style.overflow;
     document.body.style.overflow = "hidden";
@@ -2473,7 +2477,7 @@ var acquireHardLock = () => {
   lockCount += 1;
 };
 var releaseHardLock = () => {
-  if (!_chunkD5LQLRSUcjs.isBrowser) return;
+  if (!_chunk7SAJNRGZcjs.isBrowser) return;
   if (lockCount === 0) return;
   lockCount -= 1;
   if (lockCount === 0) {
@@ -2485,14 +2489,19 @@ var useConstrainedScrollLock = ({
   enabled,
   targetRect,
   viewportHeight,
-  padding = 0
+  padding = 0,
+  bottomInset = 0
 }) => {
   const isConstrainedModeRef = _react.useRef.call(void 0, false);
   const boundsRef = _react.useRef.call(void 0, { minY: 0, maxY: 0 });
+  const targetHeight = targetRect ? targetRect.height + padding * 2 : 0;
+  const effectiveViewportHeight = viewportHeight - bottomInset;
+  const isConstrainedMode = enabled && Boolean(targetRect) && targetHeight > effectiveViewportHeight;
   _react.useEffect.call(void 0, () => {
-    if (!enabled || !_chunkD5LQLRSUcjs.isBrowser) return;
-    const targetHeight = targetRect ? targetRect.height + padding * 2 : 0;
-    const targetExceedsViewport = targetRect && targetHeight > viewportHeight;
+    if (!enabled || !_chunk7SAJNRGZcjs.isBrowser) return;
+    const targetHeight2 = targetRect ? targetRect.height + padding * 2 : 0;
+    const effectiveViewportHeight2 = viewportHeight - bottomInset;
+    const targetExceedsViewport = targetRect && targetHeight2 > effectiveViewportHeight2;
     if (!targetExceedsViewport) {
       acquireHardLock();
       isConstrainedModeRef.current = false;
@@ -2505,7 +2514,7 @@ var useConstrainedScrollLock = ({
     const targetBottom = targetRect.bottom + padding;
     const currentScroll = window.scrollY;
     const minY = currentScroll + targetTop;
-    const maxY = currentScroll + targetBottom - viewportHeight;
+    const maxY = currentScroll + targetBottom - effectiveViewportHeight2;
     boundsRef.current = {
       minY: Math.max(0, minY),
       maxY: Math.max(0, maxY)
@@ -2525,7 +2534,8 @@ var useConstrainedScrollLock = ({
       window.removeEventListener("scroll", handleScroll);
       isConstrainedModeRef.current = false;
     };
-  }, [enabled, targetRect, viewportHeight, padding]);
+  }, [enabled, targetRect, viewportHeight, padding, bottomInset]);
+  return { isConstrainedMode };
 };
 
 // src/hooks/useHudTargetIssue.ts
@@ -2572,7 +2582,7 @@ var useHudTargetIssue = (target, options) => {
       setArmed(false);
       return;
     }
-    if (!_chunkD5LQLRSUcjs.isBrowser) {
+    if (!_chunk7SAJNRGZcjs.isBrowser) {
       setArmed(true);
       return;
     }
@@ -2595,7 +2605,8 @@ var useTourHud = (options = {}) => {
   const {
     overlayPadding,
     overlayRadius,
-    bodyScrollLock = DEFAULT_BODY_SCROLL_LOCK
+    bodyScrollLock = DEFAULT_BODY_SCROLL_LOCK,
+    scrollLockBottomInset
   } = options;
   const shortcuts = _nullishCoalesce(options.shortcuts, () => ( DEFAULT_SHORTCUTS));
   const { backdropInteraction, lockBodyScroll } = useTour();
@@ -2612,11 +2623,12 @@ var useTourHud = (options = {}) => {
   const shouldLockBodyScroll = Boolean(
     bodyScrollLock && (_nullishCoalesce(_optionalChain([hudState, 'access', _101 => _101.flowHudOptions, 'optionalAccess', _102 => _102.behavior, 'optionalAccess', _103 => _103.lockBodyScroll]), () => ( lockBodyScroll))) && hudState.focusTrapActive
   );
-  useConstrainedScrollLock({
+  const { isConstrainedMode: isConstrainedScrollActive } = useConstrainedScrollLock({
     enabled: shouldLockBodyScroll,
     targetRect: hudState.hudTarget.rect,
     viewportHeight: viewport.height,
-    padding: _nullishCoalesce(overlayPadding, () => ( 12))
+    padding: _nullishCoalesce(overlayPadding, () => ( 12)),
+    bottomInset: scrollLockBottomInset
   });
   const shortcutOptions = typeof shortcuts === "object" ? shortcuts : {};
   const shortcutsEnabled = Boolean(
@@ -2674,7 +2686,8 @@ var useTourHud = (options = {}) => {
     focusManager,
     targetIssue,
     shouldLockBodyScroll,
-    shortcutsEnabled
+    shortcutsEnabled,
+    isConstrainedScrollActive
   };
 };
 
@@ -2695,7 +2708,7 @@ var useTourOverlay = (options) => {
   const hasShownRef = _react.useRef.call(void 0, false);
   const lastReadyTargetRef = _react.useRef.call(void 0, null);
   _react.useEffect.call(void 0, () => {
-    if (!_chunkD5LQLRSUcjs.isBrowser) return;
+    if (!_chunk7SAJNRGZcjs.isBrowser) return;
     if (target.status === "ready") {
       hasShownRef.current = true;
       lastReadyTargetRef.current = {
@@ -2709,12 +2722,12 @@ var useTourOverlay = (options) => {
       lastReadyTargetRef.current = null;
     }
   }, [target, isInGracePeriod]);
-  const viewport = _chunkD5LQLRSUcjs.getViewportRect.call(void 0, );
+  const viewport = _chunk7SAJNRGZcjs.getViewportRect.call(void 0, );
   const cachedTarget = lastReadyTargetRef.current;
   const highlightTarget = target.status === "ready" ? target : cachedTarget;
   const resolvedRect = _nullishCoalesce(_optionalChain([highlightTarget, 'optionalAccess', _122 => _122.rect]), () => ( target.rect));
   const resolvedIsScreen = _nullishCoalesce(_optionalChain([highlightTarget, 'optionalAccess', _123 => _123.isScreen]), () => ( target.isScreen));
-  const expandedRect = resolvedIsScreen || !resolvedRect ? viewport : _chunkD5LQLRSUcjs.expandRect.call(void 0, resolvedRect, padding);
+  const expandedRect = resolvedIsScreen || !resolvedRect ? viewport : _chunk7SAJNRGZcjs.expandRect.call(void 0, resolvedRect, padding);
   const safeBuffer = Math.max(0, edgeBuffer);
   const insetTop = expandedRect.top <= 0 ? Math.min(safeBuffer, Math.max(0, expandedRect.height) / 2) : 0;
   const insetLeft = expandedRect.left <= 0 ? Math.min(safeBuffer, Math.max(0, expandedRect.width) / 2) : 0;
@@ -2744,7 +2757,7 @@ var useTourOverlay = (options) => {
     height: highlightHeight,
     radius: highlightRadius
   } : null;
-  const maskCapable = _react.useMemo.call(void 0, () => _chunkD5LQLRSUcjs.supportsMasking.call(void 0, ), []);
+  const maskCapable = _react.useMemo.call(void 0, () => _chunk7SAJNRGZcjs.supportsMasking.call(void 0, ), []);
   const isActive = target.status === "ready" || target.status === "resolving" && cachedTarget !== null || isInGracePeriod;
   const shouldMask = maskCapable && isActive;
   const maskId = _react.useMemo.call(void 0, 
@@ -3132,7 +3145,7 @@ var useDelayAdvance = () => {
     if (!delayInfo) return;
     if (!activeStep || activeStep.id !== delayInfo.stepId) return;
     if (!state || state.status !== "running") return;
-    if (!_chunkD5LQLRSUcjs.isBrowser) return;
+    if (!_chunk7SAJNRGZcjs.isBrowser) return;
     let frameId = null;
     const tick = () => {
       setNow(getTimestamp());
@@ -3276,8 +3289,8 @@ var OverlayBackdrop = ({
   showInteractionBlocker = true,
   transitionsOverride
 }) => {
-  if (!_chunkD5LQLRSUcjs.isBrowser) return null;
-  const host = _chunkD5LQLRSUcjs.portalHost.call(void 0, );
+  if (!_chunk7SAJNRGZcjs.isBrowser) return null;
+  const host = _chunk7SAJNRGZcjs.portalHost.call(void 0, );
   if (!host) return null;
   const adapter = useAnimationAdapter();
   const {
@@ -3588,8 +3601,8 @@ var TourPopoverPortal = ({
   transitionsOverride,
   isInGracePeriod = false
 }) => {
-  if (!_chunkD5LQLRSUcjs.isBrowser) return null;
-  const host = _chunkD5LQLRSUcjs.portalHost.call(void 0, );
+  if (!_chunk7SAJNRGZcjs.isBrowser) return null;
+  const host = _chunk7SAJNRGZcjs.portalHost.call(void 0, );
   if (!host) return null;
   const adapter = useAnimationAdapter();
   const Container = _nullishCoalesce(containerComponent, () => ( adapter.components.MotionDiv));
@@ -3664,7 +3677,7 @@ var TourPopoverPortal = ({
   });
   const overflowRetryTimeoutRef = _react.useRef.call(void 0, null);
   _react.useLayoutEffect.call(void 0, () => {
-    if (!_chunkD5LQLRSUcjs.isBrowser) return;
+    if (!_chunk7SAJNRGZcjs.isBrowser) return;
     const node = floatingRef.current;
     if (!node) return;
     const updateSize = () => {
@@ -3818,7 +3831,7 @@ var TourPopoverPortal = ({
     };
   }, []);
   _react.useLayoutEffect.call(void 0, () => {
-    if (!_chunkD5LQLRSUcjs.isBrowser) return;
+    if (!_chunk7SAJNRGZcjs.isBrowser) return;
     const floatingEl = floatingRef.current;
     const rectInfo = target.rect;
     if (!floatingEl) return;
@@ -3873,7 +3886,7 @@ var TourPopoverPortal = ({
       });
       if (cancelState.cancelled) return;
       const floatingBox = floatingEl.getBoundingClientRect();
-      const viewportRect = _chunkD5LQLRSUcjs.getViewportRect.call(void 0, );
+      const viewportRect = _chunk7SAJNRGZcjs.getViewportRect.call(void 0, );
       const viewportTop = viewportRect.top;
       const viewportBottom = viewportRect.top + viewportRect.height;
       const viewportLeft = viewportRect.left;
@@ -3968,7 +3981,7 @@ var TourPopoverPortal = ({
     });
   }, [dragPosition, layoutMode]);
   const clampToViewport = (rawLeft, rawTop) => {
-    const rect = _chunkD5LQLRSUcjs.getViewportRect.call(void 0, );
+    const rect = _chunk7SAJNRGZcjs.getViewportRect.call(void 0, );
     const floatingEl = floatingRef.current;
     const floatingElWidth = _nullishCoalesce(_optionalChain([floatingEl, 'optionalAccess', _161 => _161.offsetWidth]), () => ( 0));
     const floatingElHeight = _nullishCoalesce(_optionalChain([floatingEl, 'optionalAccess', _162 => _162.offsetHeight]), () => ( 0));
@@ -4235,7 +4248,7 @@ var TourFocusManager = ({
     }
   };
   _react.useLayoutEffect.call(void 0, () => {
-    if (!_chunkD5LQLRSUcjs.isBrowser) return;
+    if (!_chunk7SAJNRGZcjs.isBrowser) return;
     if (!active) {
       restoreFocus();
       return;
@@ -4251,7 +4264,7 @@ var TourFocusManager = ({
     };
   }, [active, popoverNode, target.element]);
   _react.useEffect.call(void 0, () => {
-    if (!_chunkD5LQLRSUcjs.isBrowser) return;
+    if (!_chunk7SAJNRGZcjs.isBrowser) return;
     if (!active) return;
     const doc = _nullishCoalesce(_nullishCoalesce(_optionalChain([popoverNode, 'optionalAccess', _167 => _167.ownerDocument]), () => ( _optionalChain([target, 'access', _168 => _168.element, 'optionalAccess', _169 => _169.ownerDocument]))), () => ( document));
     const createGuard = (key) => {
@@ -4451,8 +4464,8 @@ var TourFocusManager = ({
       setPopoverRect(null);
     }
   }, [popoverRingActive, popoverNode]);
-  if (!_chunkD5LQLRSUcjs.isBrowser) return null;
-  const host = _chunkD5LQLRSUcjs.portalHost.call(void 0, );
+  if (!_chunk7SAJNRGZcjs.isBrowser) return null;
+  const host = _chunk7SAJNRGZcjs.portalHost.call(void 0, );
   if (!host) return null;
   const boxShadow = _nullishCoalesce(_optionalChain([guardElementFocusRing, 'optionalAccess', _181 => _181.boxShadow]), () => ( DEFAULT_BOX_SHADOW));
   const showTargetRing = targetRingActive && highlightRect;
@@ -4549,7 +4562,7 @@ var useHudMotion = () => {
 var lockCount2 = 0;
 var previousOverflow2 = null;
 var acquireLock = () => {
-  if (!_chunkD5LQLRSUcjs.isBrowser) return;
+  if (!_chunk7SAJNRGZcjs.isBrowser) return;
   if (lockCount2 === 0) {
     previousOverflow2 = document.body.style.overflow;
     document.body.style.overflow = "hidden";
@@ -4557,7 +4570,7 @@ var acquireLock = () => {
   lockCount2 += 1;
 };
 var releaseLock = () => {
-  if (!_chunkD5LQLRSUcjs.isBrowser) return;
+  if (!_chunk7SAJNRGZcjs.isBrowser) return;
   if (lockCount2 === 0) return;
   lockCount2 -= 1;
   if (lockCount2 === 0) {
@@ -4615,4 +4628,4 @@ var useBodyScrollLock = (enabled) => {
 
 
 
-exports.AnimationAdapterProvider = AnimationAdapterProvider; exports.DialogRegistryProvider = DialogRegistryProvider; exports.OverlayBackdrop = OverlayBackdrop; exports.TourFocusManager = TourFocusManager; exports.TourPopoverPortal = TourPopoverPortal; exports.TourProvider = TourProvider; exports.createPathString = _chunkD5LQLRSUcjs.createPathString; exports.createWaitForPredicateController = createWaitForPredicateController; exports.defaultAnimationAdapter = defaultAnimationAdapter; exports.defaultLabels = defaultLabels; exports.getCurrentRoutePath = _chunkD5LQLRSUcjs.getCurrentRoutePath; exports.notifyRouteChange = _chunkD5LQLRSUcjs.notifyRouteChange; exports.reducedMotionAnimationAdapter = reducedMotionAnimationAdapter; exports.subscribeToRouteChanges = _chunkD5LQLRSUcjs.subscribeToRouteChanges; exports.useAdvanceRules = useAdvanceRules; exports.useAnimationAdapter = useAnimationAdapter; exports.useBodyScrollLock = useBodyScrollLock; exports.useConstrainedScrollLock = useConstrainedScrollLock; exports.useDelayAdvance = useDelayAdvance; exports.useDialogRegistry = useDialogRegistry; exports.useDialogRegistryOptional = useDialogRegistryOptional; exports.useHiddenTargetFallback = useHiddenTargetFallback; exports.useHudDescription = useHudDescription; exports.useHudMotion = useHudMotion; exports.useHudShortcuts = useHudShortcuts; exports.useHudState = useHudState; exports.useHudTargetIssue = useHudTargetIssue; exports.usePreferredAnimationAdapter = usePreferredAnimationAdapter; exports.useRadixDialogAdapter = useRadixDialogAdapter; exports.useRadixTourDialog = useRadixTourDialog; exports.useTour = useTour; exports.useTourControls = useTourControls; exports.useTourEvents = useTourEvents; exports.useTourFocusDominance = useTourFocusDominance; exports.useTourHud = useTourHud; exports.useTourLabels = useTourLabels; exports.useTourOverlay = useTourOverlay; exports.useTourTarget = useTourTarget; exports.useViewportRect = useViewportRect; exports.waitForDom = waitForDom;
+exports.AnimationAdapterProvider = AnimationAdapterProvider; exports.DialogRegistryProvider = DialogRegistryProvider; exports.OverlayBackdrop = OverlayBackdrop; exports.TourFocusManager = TourFocusManager; exports.TourPopoverPortal = TourPopoverPortal; exports.TourProvider = TourProvider; exports.createPathString = _chunk7SAJNRGZcjs.createPathString; exports.createWaitForPredicateController = createWaitForPredicateController; exports.defaultAnimationAdapter = defaultAnimationAdapter; exports.defaultLabels = defaultLabels; exports.getCurrentRoutePath = _chunk7SAJNRGZcjs.getCurrentRoutePath; exports.notifyRouteChange = _chunk7SAJNRGZcjs.notifyRouteChange; exports.reducedMotionAnimationAdapter = reducedMotionAnimationAdapter; exports.subscribeToRouteChanges = _chunk7SAJNRGZcjs.subscribeToRouteChanges; exports.useAdvanceRules = useAdvanceRules; exports.useAnimationAdapter = useAnimationAdapter; exports.useBodyScrollLock = useBodyScrollLock; exports.useConstrainedScrollLock = useConstrainedScrollLock; exports.useDelayAdvance = useDelayAdvance; exports.useDialogRegistry = useDialogRegistry; exports.useDialogRegistryOptional = useDialogRegistryOptional; exports.useHiddenTargetFallback = useHiddenTargetFallback; exports.useHudDescription = useHudDescription; exports.useHudMotion = useHudMotion; exports.useHudShortcuts = useHudShortcuts; exports.useHudState = useHudState; exports.useHudTargetIssue = useHudTargetIssue; exports.usePreferredAnimationAdapter = usePreferredAnimationAdapter; exports.useRadixDialogAdapter = useRadixDialogAdapter; exports.useRadixTourDialog = useRadixTourDialog; exports.useTour = useTour; exports.useTourControls = useTourControls; exports.useTourEvents = useTourEvents; exports.useTourFocusDominance = useTourFocusDominance; exports.useTourHud = useTourHud; exports.useTourLabels = useTourLabels; exports.useTourOverlay = useTourOverlay; exports.useTourTarget = useTourTarget; exports.useViewportRect = useViewportRect; exports.waitForDom = waitForDom;

package/dist/index.mjs

@@ -15,7 +15,7 @@ import {
   portalHost,
   subscribeToRouteChanges,
   supportsMasking
-} from "./chunk-B44EX7YT.mjs";
+} from "./chunk-J2JMZXGD.mjs";
 
 // src/context.tsx
 import {
@@ -716,8 +716,12 @@ var TourProvider = ({
     [getActiveStore]
   );
   const advanceStep = useCallback2(
-    (stepId) => getActiveStore().advanceStep(stepId),
-    [getActiveStore]
+    (stepId) => {
+      const store = storeRef.current;
+      if (!store) return null;
+      return store.advanceStep(stepId);
+    },
+    []
   );
   const toggleDebug = useCallback2(() => {
     setDebugEnabled((previous) => !previous);
@@ -2485,14 +2489,19 @@ var useConstrainedScrollLock = ({
   enabled,
   targetRect,
   viewportHeight,
-  padding = 0
+  padding = 0,
+  bottomInset = 0
 }) => {
   const isConstrainedModeRef = useRef8(false);
   const boundsRef = useRef8({ minY: 0, maxY: 0 });
+  const targetHeight = targetRect ? targetRect.height + padding * 2 : 0;
+  const effectiveViewportHeight = viewportHeight - bottomInset;
+  const isConstrainedMode = enabled && Boolean(targetRect) && targetHeight > effectiveViewportHeight;
   useEffect11(() => {
     if (!enabled || !isBrowser) return;
-    const targetHeight = targetRect ? targetRect.height + padding * 2 : 0;
-    const targetExceedsViewport = targetRect && targetHeight > viewportHeight;
+    const targetHeight2 = targetRect ? targetRect.height + padding * 2 : 0;
+    const effectiveViewportHeight2 = viewportHeight - bottomInset;
+    const targetExceedsViewport = targetRect && targetHeight2 > effectiveViewportHeight2;
     if (!targetExceedsViewport) {
       acquireHardLock();
       isConstrainedModeRef.current = false;
@@ -2505,7 +2514,7 @@ var useConstrainedScrollLock = ({
     const targetBottom = targetRect.bottom + padding;
     const currentScroll = window.scrollY;
     const minY = currentScroll + targetTop;
-    const maxY = currentScroll + targetBottom - viewportHeight;
+    const maxY = currentScroll + targetBottom - effectiveViewportHeight2;
     boundsRef.current = {
       minY: Math.max(0, minY),
       maxY: Math.max(0, maxY)
@@ -2525,7 +2534,8 @@ var useConstrainedScrollLock = ({
       window.removeEventListener("scroll", handleScroll);
       isConstrainedModeRef.current = false;
     };
-  }, [enabled, targetRect, viewportHeight, padding]);
+  }, [enabled, targetRect, viewportHeight, padding, bottomInset]);
+  return { isConstrainedMode };
 };
 
 // src/hooks/useHudTargetIssue.ts
@@ -2595,7 +2605,8 @@ var useTourHud = (options = {}) => {
   const {
     overlayPadding,
     overlayRadius,
-    bodyScrollLock = DEFAULT_BODY_SCROLL_LOCK
+    bodyScrollLock = DEFAULT_BODY_SCROLL_LOCK,
+    scrollLockBottomInset
   } = options;
   const shortcuts = options.shortcuts ?? DEFAULT_SHORTCUTS;
   const { backdropInteraction, lockBodyScroll } = useTour();
@@ -2612,11 +2623,12 @@ var useTourHud = (options = {}) => {
   const shouldLockBodyScroll = Boolean(
     bodyScrollLock && (hudState.flowHudOptions?.behavior?.lockBodyScroll ?? lockBodyScroll) && hudState.focusTrapActive
   );
-  useConstrainedScrollLock({
+  const { isConstrainedMode: isConstrainedScrollActive } = useConstrainedScrollLock({
     enabled: shouldLockBodyScroll,
     targetRect: hudState.hudTarget.rect,
     viewportHeight: viewport.height,
-    padding: overlayPadding ?? 12
+    padding: overlayPadding ?? 12,
+    bottomInset: scrollLockBottomInset
   });
   const shortcutOptions = typeof shortcuts === "object" ? shortcuts : {};
   const shortcutsEnabled = Boolean(
@@ -2674,7 +2686,8 @@ var useTourHud = (options = {}) => {
     focusManager,
     targetIssue,
     shouldLockBodyScroll,
-    shortcutsEnabled
+    shortcutsEnabled,
+    isConstrainedScrollActive
   };
 };
 

package/dist/router/index.cjs

@@ -6,7 +6,7 @@
 
 
 
-var _chunkD5LQLRSUcjs = require('../chunk-D5LQLRSU.cjs');
+var _chunk7SAJNRGZcjs = require('../chunk-7SAJNRGZ.cjs');
 
 
 
@@ -14,4 +14,4 @@ var _chunkD5LQLRSUcjs = require('../chunk-D5LQLRSU.cjs');
 
 
 
-exports.createPathString = _chunkD5LQLRSUcjs.createPathString; exports.getCurrentRoutePath = _chunkD5LQLRSUcjs.getCurrentRoutePath; exports.matchRoute = _chunkD5LQLRSUcjs.matchRoute; exports.notifyRouteChange = _chunkD5LQLRSUcjs.notifyRouteChange; exports.routeGatingChannel = _chunkD5LQLRSUcjs.routeGatingChannel; exports.subscribeToRouteChanges = _chunkD5LQLRSUcjs.subscribeToRouteChanges;
+exports.createPathString = _chunk7SAJNRGZcjs.createPathString; exports.getCurrentRoutePath = _chunk7SAJNRGZcjs.getCurrentRoutePath; exports.matchRoute = _chunk7SAJNRGZcjs.matchRoute; exports.notifyRouteChange = _chunk7SAJNRGZcjs.notifyRouteChange; exports.routeGatingChannel = _chunk7SAJNRGZcjs.routeGatingChannel; exports.subscribeToRouteChanges = _chunk7SAJNRGZcjs.subscribeToRouteChanges;

package/dist/router/index.mjs

@@ -6,7 +6,7 @@ import {
   notifyRouteChange,
   routeGatingChannel,
   subscribeToRouteChanges
-} from "../chunk-B44EX7YT.mjs";
+} from "../chunk-J2JMZXGD.mjs";
 export {
   createPathString,
   getCurrentRoutePath,

package/dist/router/nextAppRouterAdapter.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
 
-var _chunkD5LQLRSUcjs = require('../chunk-D5LQLRSU.cjs');
+var _chunk7SAJNRGZcjs = require('../chunk-7SAJNRGZ.cjs');
 
 // src/router/nextAppRouterAdapter.tsx
 var _navigation = require('next/navigation'); var NextNavigation = _interopRequireWildcard(_navigation);
@@ -22,12 +22,12 @@ var useNextAppRouterTourAdapter = () => {
   const searchValue = _nullishCoalesce(_optionalChain([searchParams, 'optionalAccess', _ => _.toString, 'call', _2 => _2()]), () => ( ""));
   _react.useEffect.call(void 0, () => {
     if (typeof pathname !== "string") return;
-    const path = _chunkD5LQLRSUcjs.createPathString.call(void 0, 
+    const path = _chunk7SAJNRGZcjs.createPathString.call(void 0, 
       pathname,
       searchValue.length > 0 ? `?${searchValue}` : "",
       void 0
     );
-    _chunkD5LQLRSUcjs.notifyRouteChange.call(void 0, path);
+    _chunk7SAJNRGZcjs.notifyRouteChange.call(void 0, path);
   }, [pathname, searchValue]);
 };
 

package/dist/router/nextAppRouterAdapter.mjs

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

package/dist/router/nextPagesRouterAdapter.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
 
 
-var _chunkD5LQLRSUcjs = require('../chunk-D5LQLRSU.cjs');
+var _chunk7SAJNRGZcjs = require('../chunk-7SAJNRGZ.cjs');
 
 // src/router/nextPagesRouterAdapter.tsx
 var _router = require('next/router'); var NextRouter = _interopRequireWildcard(_router);
@@ -19,8 +19,8 @@ var useNextPagesRouterTourAdapter = () => {
   const router = useRouter2();
   const pathCandidate = typeof router.asPath === "string" && router.asPath.length > 0 ? router.asPath : router.pathname;
   _react.useEffect.call(void 0, () => {
-    const path = typeof pathCandidate === "string" && pathCandidate.length > 0 ? pathCandidate : _chunkD5LQLRSUcjs.createPathString.call(void 0, _nullishCoalesce(router.pathname, () => ( "/")));
-    _chunkD5LQLRSUcjs.notifyRouteChange.call(void 0, path);
+    const path = typeof pathCandidate === "string" && pathCandidate.length > 0 ? pathCandidate : _chunk7SAJNRGZcjs.createPathString.call(void 0, _nullishCoalesce(router.pathname, () => ( "/")));
+    _chunk7SAJNRGZcjs.notifyRouteChange.call(void 0, path);
   }, [pathCandidate, router.pathname]);
 };
 

package/dist/router/nextPagesRouterAdapter.mjs

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

package/dist/router/reactRouterAdapter.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } }
 
 
-var _chunkD5LQLRSUcjs = require('../chunk-D5LQLRSU.cjs');
+var _chunk7SAJNRGZcjs = require('../chunk-7SAJNRGZ.cjs');
 
 // src/router/reactRouterAdapter.tsx
 var _react = require('react');
@@ -18,12 +18,12 @@ var useReactRouterTourAdapter = () => {
   }
   const location = useLocation2();
   _react.useEffect.call(void 0, () => {
-    const path = _chunkD5LQLRSUcjs.createPathString.call(void 0, 
+    const path = _chunk7SAJNRGZcjs.createPathString.call(void 0, 
       location.pathname,
       location.search,
       location.hash
     );
-    _chunkD5LQLRSUcjs.notifyRouteChange.call(void 0, path);
+    _chunk7SAJNRGZcjs.notifyRouteChange.call(void 0, path);
   }, [location.pathname, location.search, location.hash]);
 };
 

package/dist/router/reactRouterAdapter.mjs

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

package/dist/router/tanstackRouterAdapter.cjs

@@ -1,7 +1,7 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
 
-var _chunkD5LQLRSUcjs = require('../chunk-D5LQLRSU.cjs');
+var _chunk7SAJNRGZcjs = require('../chunk-7SAJNRGZ.cjs');
 
 // src/router/tanstackRouterAdapter.tsx
 var _reactrouter = require('@tanstack/react-router'); var TanStackRouter = _interopRequireWildcard(_reactrouter);
@@ -55,8 +55,8 @@ var useTanStackRouterTourAdapter = () => {
     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 : _chunkD5LQLRSUcjs.createPathString.call(void 0, resolvedPathname, resolvedSearch, resolvedHash);
-    _chunkD5LQLRSUcjs.notifyRouteChange.call(void 0, path);
+    const path = typeof location.href === "string" && location.href.length > 0 ? location.href : _chunk7SAJNRGZcjs.createPathString.call(void 0, resolvedPathname, resolvedSearch, resolvedHash);
+    _chunk7SAJNRGZcjs.notifyRouteChange.call(void 0, path);
   }, [location]);
 };
 

package/dist/router/tanstackRouterAdapter.mjs

@@ -1,7 +1,7 @@
 import {
   createPathString,
   notifyRouteChange
-} from "../chunk-B44EX7YT.mjs";
+} from "../chunk-J2JMZXGD.mjs";
 
 // src/router/tanstackRouterAdapter.tsx
 import { useRouterState } from "@tanstack/react-router";

package/dist/utils/dom.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/utils/dom.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,SAC4C,CAAA;AAElE,KAAK,QAAQ,GAAG;IACd,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,+BAKxB,QAAQ,KAAG,cAOZ,CAAA;AAEF,eAAO,MAAM,YAAY,GAAI,MAAM,OAAO,GAAG,eAAe,KAAG,cAM3D,CAAA;AAEJ,eAAO,MAAM,eAAe,QAAO,cAgBlC,CAAA;AAED,eAAO,MAAM,UAAU,GACrB,MAAM,cAAc,EACpB,SAAS,MAAM,KACd,cAqBF,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,MAAM,cAAc,EAAE,eAAU,YAUhE,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,SAAS,OAAO,KAAG,cACF,CAAA;AAe/C,eAAO,MAAM,gBAAgB,GAAI,SAAS,OAAO,KAAG,KAAK,CAAC,OAAO,CA4BhE,CAAA;AAED,eAAO,MAAM,UAAU,0BAA2C,CAAA;AA4BlE,eAAO,MAAM,eAAe,eAM3B,CAAA"}
+{"version":3,"file":"dom.d.ts","sourceRoot":"","sources":["../../src/utils/dom.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,SAC4C,CAAA;AAElE,KAAK,QAAQ,GAAG;IACd,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf,CAAA;AAED,eAAO,MAAM,UAAU,GAAI,+BAKxB,QAAQ,KAAG,cAOZ,CAAA;AAEF,eAAO,MAAM,YAAY,GAAI,MAAM,OAAO,GAAG,eAAe,KAAG,cAM3D,CAAA;AAEJ,eAAO,MAAM,eAAe,QAAO,cAgBlC,CAAA;AAED,eAAO,MAAM,UAAU,GACrB,MAAM,cAAc,EACpB,SAAS,MAAM,KACd,cAsBF,CAAA;AAED,eAAO,MAAM,gBAAgB,GAAI,MAAM,cAAc,EAAE,eAAU,YAUhE,CAAA;AAED,eAAO,MAAM,aAAa,GAAI,SAAS,OAAO,KAAG,cACF,CAAA;AAe/C,eAAO,MAAM,gBAAgB,GAAI,SAAS,OAAO,KAAG,KAAK,CAAC,OAAO,CA4BhE,CAAA;AAED,eAAO,MAAM,UAAU,0BAA2C,CAAA;AA4BlE,eAAO,MAAM,eAAe,eAM3B,CAAA"}

package/package.json

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