@flowsterix/react 0.1.0

package/dist/adapters/radixDialog.d.ts

@@ -0,0 +1,18 @@
+import type { UseTourFocusDominanceOptions } from '../hooks/useTourFocusDominance';
+export interface UseRadixDialogAdapterOptions extends UseTourFocusDominanceOptions {
+    disableEscapeClose?: boolean;
+}
+export interface RadixDialogAdapterResult {
+    dialogProps: {
+        modal: boolean;
+    };
+    contentProps: {
+        trapFocus: boolean;
+        onInteractOutside: (event: Event) => void;
+        onFocusOutside: (event: Event) => void;
+        onEscapeKeyDown: (event: Event) => void;
+    };
+    suspendExternalFocusTrap: boolean;
+}
+export declare const useRadixDialogAdapter: (options?: UseRadixDialogAdapterOptions) => RadixDialogAdapterResult;
+//# sourceMappingURL=radixDialog.d.ts.map

package/dist/adapters/radixDialog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"radixDialog.d.ts","sourceRoot":"","sources":["../../src/adapters/radixDialog.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAA;AAGlF,MAAM,WAAW,4BACf,SAAQ,4BAA4B;IACpC,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAC7B;AAED,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE;QACX,KAAK,EAAE,OAAO,CAAA;KACf,CAAA;IACD,YAAY,EAAE;QACZ,SAAS,EAAE,OAAO,CAAA;QAClB,iBAAiB,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;QACzC,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;QACtC,eAAe,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAA;KACxC,CAAA;IACD,wBAAwB,EAAE,OAAO,CAAA;CAClC;AAED,eAAO,MAAM,qBAAqB,GAChC,UAAS,4BAAiC,KACzC,wBA0BF,CAAA"}

package/dist/chunk-RCASLQRS.mjs

@@ -0,0 +1,24 @@
+import {
+  createPathString,
+  notifyRouteChange
+} from "./chunk-RPA2S5UP.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
+};

package/dist/chunk-RPA2S5UP.mjs

@@ -0,0 +1,280 @@
+// src/utils/dom.ts
+var isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
+var createRect = ({
+  top,
+  left,
+  width,
+  height
+}) => ({
+  top,
+  left,
+  width,
+  height,
+  right: left + width,
+  bottom: top + height
+});
+var toClientRect = (rect) => createRect({
+  top: rect.top,
+  left: rect.left,
+  width: rect.width,
+  height: rect.height
+});
+var getViewportRect = () => {
+  if (!isBrowser) {
+    return createRect({ top: 0, left: 0, width: 0, height: 0 });
+  }
+  const clientWidth = document.documentElement.clientWidth;
+  const clientHeight = document.documentElement.clientHeight;
+  const width = clientWidth > 0 ? clientWidth : window.innerWidth;
+  const height = clientHeight > 0 ? clientHeight : window.innerHeight;
+  return createRect({
+    top: 0,
+    left: 0,
+    width,
+    height
+  });
+};
+var expandRect = (rect, padding) => {
+  if (!isBrowser) return rect;
+  const viewport = getViewportRect();
+  const top = Math.max(0, rect.top - padding);
+  const left = Math.max(0, rect.left - padding);
+  const width = Math.min(viewport.width - left, rect.width + padding * 2);
+  const height = Math.min(viewport.height - top, rect.height + padding * 2);
+  return createRect({
+    top,
+    left,
+    width: Math.max(0, width),
+    height: Math.max(0, height)
+  });
+};
+var getClientRect = (element) => toClientRect(element.getBoundingClientRect());
+var SCROLLABLE_OVERFLOW = /(auto|scroll|overlay)/i;
+var isElementScrollable = (node) => {
+  if (!isBrowser) return false;
+  const style = window.getComputedStyle(node);
+  if (style.position === "fixed") return false;
+  return SCROLLABLE_OVERFLOW.test(style.overflow) || SCROLLABLE_OVERFLOW.test(style.overflowX) || SCROLLABLE_OVERFLOW.test(style.overflowY);
+};
+var getScrollParents = (element) => {
+  if (!isBrowser) return [];
+  const parents = [];
+  const seen = /* @__PURE__ */ new Set();
+  let current = element.parentElement;
+  while (current && current !== document.documentElement) {
+    if (current !== document.body && isElementScrollable(current)) {
+      if (!seen.has(current)) {
+        parents.push(current);
+        seen.add(current);
+      }
+    }
+    current = current.parentElement;
+  }
+  const scrollingElement = document.scrollingElement;
+  if (scrollingElement && scrollingElement instanceof Element && !seen.has(scrollingElement) && isElementScrollable(scrollingElement)) {
+    parents.push(scrollingElement);
+    seen.add(scrollingElement);
+  }
+  return parents;
+};
+var portalHost = () => isBrowser ? document.body : null;
+var cachedMaskSupport = null;
+var detectMaskSupport = () => {
+  if (!isBrowser) return false;
+  if ("CSS" in window) {
+    try {
+      if (window.CSS.supports("mask-image", "linear-gradient(#000,#000)")) {
+        return true;
+      }
+      if (window.CSS.supports("-webkit-mask-image", "linear-gradient(#000,#000)")) {
+        return true;
+      }
+    } catch (error) {
+      if (typeof console !== "undefined") {
+        console.warn("Flowsterix: CSS.supports check failed", error);
+      }
+    }
+  }
+  const probe = document.createElement("div");
+  return "maskImage" in probe.style || "webkitMaskImage" in probe.style;
+};
+var supportsMasking = () => {
+  if (!isBrowser) return false;
+  if (cachedMaskSupport === null) {
+    cachedMaskSupport = detectMaskSupport();
+  }
+  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);
+};
+
+// src/router/utils.ts
+var ensurePrefix = (value, prefix) => value.startsWith(prefix) ? value : `${prefix}${value}`;
+var isNonEmptyString = (value) => typeof value === "string" && value.length > 0;
+var toSearchString = (value) => {
+  if (!isNonEmptyString(value)) {
+    if (value instanceof URLSearchParams) {
+      const serialized = value.toString();
+      return serialized.length > 0 ? `?${serialized}` : "";
+    }
+    if (typeof value === "object" && value !== null) {
+      try {
+        const params = new URLSearchParams();
+        for (const [key, raw] of Object.entries(
+          value
+        )) {
+          if (raw === void 0 || raw === null) continue;
+          params.set(key, String(raw));
+        }
+        const serialized = params.toString();
+        return serialized.length > 0 ? `?${serialized}` : "";
+      } catch {
+        return "";
+      }
+    }
+    return "";
+  }
+  if (value === "?") return "";
+  return value.startsWith("?") ? value : ensurePrefix(value, "?");
+};
+var toHashString = (value) => {
+  if (!isNonEmptyString(value)) {
+    return "";
+  }
+  if (value === "#") return "";
+  return value.startsWith("#") ? value : ensurePrefix(value, "#");
+};
+var createPathString = (pathname, search, hash) => {
+  const normalizedPath = isNonEmptyString(pathname) ? pathname.startsWith("/") ? pathname : `/${pathname}` : "/";
+  const searchPart = toSearchString(search);
+  const hashPart = toHashString(hash);
+  return `${normalizedPath}${searchPart}${hashPart}`;
+};
+
+export {
+  isBrowser,
+  getViewportRect,
+  expandRect,
+  getClientRect,
+  getScrollParents,
+  portalHost,
+  supportsMasking,
+  routeGatingChannel,
+  getCurrentRoutePath,
+  notifyRouteChange,
+  subscribeToRouteChanges,
+  createPathString
+};

package/dist/chunk-U757YVZP.mjs

@@ -0,0 +1,50 @@
+import {
+  useTanStackRouterTourAdapter
+} from "./chunk-RCASLQRS.mjs";
+
+// src/router/tanstackRouterSync.tsx
+import * as TanStackRouter from "@tanstack/react-router";
+import { useEffect } from "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();
+  useEffect(() => {
+    setTourRouter(router);
+    onRouterAvailable?.(router);
+    return () => {
+      if (getTourRouter() === router) {
+        setTourRouter(null);
+      }
+      onRouterAvailable?.(null);
+    };
+  }, [router, onRouterAvailable]);
+  return null;
+};
+
+export {
+  setTourRouter,
+  setTanStackRouter,
+  getTourRouter,
+  getTanStackRouter,
+  TanStackRouterSync
+};

package/dist/components/OverlayBackdrop.d.ts

@@ -0,0 +1,34 @@
+import type { Transition } from 'motion/react';
+import type { UseTourOverlayResult } from '../hooks/useTourOverlay';
+import type { AnimationAdapterTransitions } from '../motion/animationAdapter';
+export interface OverlayBackdropTransitionsOverride extends Partial<Pick<AnimationAdapterTransitions, 'overlayHighlight' | 'overlayFade'>> {
+    overlayHighlightCollapse?: Transition;
+}
+export interface OverlayBackdropProps {
+    overlay: UseTourOverlayResult;
+    zIndex?: number;
+    /** Background color of the overlay */
+    color?: string;
+    /**
+     * @deprecated Use `color` prop instead. This is kept for backwards compatibility but has no effect.
+     */
+    colorClassName?: string;
+    opacity?: number;
+    /** Box shadow for the highlight ring */
+    shadow?: string;
+    blurAmount?: number;
+    ariaHidden?: boolean;
+    /** Additional class name for the root element */
+    rootClassName?: string;
+    /** Additional class name for the overlay backdrop */
+    overlayClassName?: string;
+    /** Additional class name for fallback segments */
+    segmentClassName?: string;
+    /** Additional class name for the highlight ring */
+    ringClassName?: string;
+    showHighlightRing?: boolean;
+    showInteractionBlocker?: boolean;
+    transitionsOverride?: OverlayBackdropTransitionsOverride;
+}
+export declare const OverlayBackdrop: ({ overlay, zIndex, color, colorClassName: _colorClassName, opacity, shadow, blurAmount, ariaHidden, rootClassName, overlayClassName, segmentClassName, ringClassName, showHighlightRing, showInteractionBlocker, transitionsOverride, }: OverlayBackdropProps) => import("react").ReactPortal | null;
+//# sourceMappingURL=OverlayBackdrop.d.ts.map

package/dist/components/OverlayBackdrop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OverlayBackdrop.d.ts","sourceRoot":"","sources":["../../src/components/OverlayBackdrop.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAG9C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAA;AACnE,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA;AAgE7E,MAAM,WAAW,kCACf,SAAQ,OAAO,CACb,IAAI,CAAC,2BAA2B,EAAE,kBAAkB,GAAG,aAAa,CAAC,CACtE;IACD,wBAAwB,CAAC,EAAE,UAAU,CAAA;CACtC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,oBAAoB,CAAA;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wCAAwC;IACxC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,qDAAqD;IACrD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,kDAAkD;IAClD,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,mDAAmD;IACnD,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,mBAAmB,CAAC,EAAE,kCAAkC,CAAA;CACzD;AAED,eAAO,MAAM,eAAe,GAAI,yOAgB7B,oBAAoB,uCAkStB,CAAA"}

package/dist/components/TourFocusManager.d.ts

@@ -0,0 +1,11 @@
+import type { TourOverlayRect } from '../hooks/useTourOverlay';
+import type { TourTargetInfo } from '../hooks/useTourTarget';
+export interface TourFocusManagerProps {
+    active: boolean;
+    target: TourTargetInfo;
+    popoverNode: HTMLElement | null;
+    highlightRect?: TourOverlayRect | null;
+    targetRingOffset?: number;
+}
+export declare const TourFocusManager: ({ active, target, popoverNode, highlightRect, targetRingOffset, }: TourFocusManagerProps) => import("react").ReactPortal | null;
+//# sourceMappingURL=TourFocusManager.d.ts.map

package/dist/components/TourFocusManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TourFocusManager.d.ts","sourceRoot":"","sources":["../../src/components/TourFocusManager.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAgB5D,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,OAAO,CAAA;IACf,MAAM,EAAE,cAAc,CAAA;IACtB,WAAW,EAAE,WAAW,GAAG,IAAI,CAAA;IAC/B,aAAa,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IACtC,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,eAAO,MAAM,gBAAgB,GAAI,mEAM9B,qBAAqB,uCAkVvB,CAAA"}

package/dist/components/TourPopoverPortal.d.ts

@@ -0,0 +1,57 @@
+import type { CSSProperties, ComponentType, HTMLAttributes, PointerEventHandler, ReactNode, RefCallback } from 'react';
+import type { StepPlacement } from '@flowsterix/core';
+import type { MotionProps, MotionStyle } from 'motion/react';
+import type { TourTargetInfo } from '../hooks/useTourTarget';
+import type { AnimationAdapterTransitions } from '../motion/animationAdapter';
+type MotionElementProps = MotionProps & Omit<HTMLAttributes<HTMLElement>, 'style'> & {
+    style?: CSSProperties | MotionStyle;
+};
+type MotionElementComponent = ComponentType<MotionElementProps>;
+export type TourPopoverLayoutMode = 'floating' | 'docked' | 'manual' | 'mobile';
+export interface TourPopoverPortalRenderProps {
+    Container: MotionElementComponent;
+    Content: MotionElementComponent;
+    containerProps: MotionElementProps & Record<string, unknown> & {
+        ref: RefCallback<HTMLElement>;
+        style: CSSProperties;
+    };
+    contentProps: MotionElementProps & Record<string, unknown> & {
+        key?: string | null;
+    };
+    layoutMode: TourPopoverLayoutMode;
+    isDragging: boolean;
+    showDragHandle: boolean;
+    dragHandleProps: {
+        type: 'button';
+        'aria-label': string;
+        style: CSSProperties;
+        onPointerDown: PointerEventHandler<HTMLButtonElement>;
+    };
+    descriptionProps: {
+        id?: string;
+        text?: string;
+    };
+}
+export interface TourPopoverPortalProps {
+    target: TourTargetInfo;
+    children: (props: TourPopoverPortalRenderProps) => ReactNode;
+    offset?: number;
+    width?: number | string;
+    maxWidth?: number | string;
+    zIndex?: number;
+    placement?: StepPlacement;
+    role?: string;
+    ariaLabel?: string;
+    ariaDescribedBy?: string;
+    ariaModal?: boolean;
+    descriptionId?: string;
+    descriptionText?: string;
+    onContainerChange?: (node: HTMLDivElement | null) => void;
+    layoutId?: string;
+    containerComponent?: MotionElementComponent;
+    contentComponent?: MotionElementComponent;
+    transitionsOverride?: Partial<AnimationAdapterTransitions>;
+}
+export declare const TourPopoverPortal: ({ target, children, offset, width, maxWidth, zIndex, placement, role, ariaLabel, ariaDescribedBy, ariaModal, descriptionId, descriptionText, onContainerChange, layoutId, containerComponent, contentComponent, transitionsOverride, }: TourPopoverPortalProps) => import("react").ReactPortal | null;
+export {};
+//# sourceMappingURL=TourPopoverPortal.d.ts.map

package/dist/components/TourPopoverPortal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TourPopoverPortal.d.ts","sourceRoot":"","sources":["../../src/components/TourPopoverPortal.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,mBAAmB,EACnB,SAAS,EACT,WAAW,EACZ,MAAM,OAAO,CAAA;AAYd,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAc,MAAM,cAAc,CAAA;AAExE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAE5D,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,4BAA4B,CAAA;AAuB7E,KAAK,kBAAkB,GAAG,WAAW,GACnC,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,GAAG;IAC3C,KAAK,CAAC,EAAE,aAAa,GAAG,WAAW,CAAA;CACpC,CAAA;AAEH,KAAK,sBAAsB,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAA;AAoB/D,MAAM,MAAM,qBAAqB,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAE/E,MAAM,WAAW,4BAA4B;IAC3C,SAAS,EAAE,sBAAsB,CAAA;IACjC,OAAO,EAAE,sBAAsB,CAAA;IAC/B,cAAc,EAAE,kBAAkB,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QACxB,GAAG,EAAE,WAAW,CAAC,WAAW,CAAC,CAAA;QAC7B,KAAK,EAAE,aAAa,CAAA;KACrB,CAAA;IACH,YAAY,EAAE,kBAAkB,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;IACnD,UAAU,EAAE,qBAAqB,CAAA;IACjC,UAAU,EAAE,OAAO,CAAA;IACnB,cAAc,EAAE,OAAO,CAAA;IACvB,eAAe,EAAE;QACf,IAAI,EAAE,QAAQ,CAAA;QACd,YAAY,EAAE,MAAM,CAAA;QACpB,KAAK,EAAE,aAAa,CAAA;QACpB,aAAa,EAAE,mBAAmB,CAAC,iBAAiB,CAAC,CAAA;KACtD,CAAA;IACD,gBAAgB,EAAE;QAChB,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;CACF;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,cAAc,CAAA;IACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,4BAA4B,KAAK,SAAS,CAAA;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,aAAa,CAAA;IACzB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,KAAK,IAAI,CAAA;IACzD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kBAAkB,CAAC,EAAE,sBAAsB,CAAA;IAC3C,gBAAgB,CAAC,EAAE,sBAAsB,CAAA;IACzC,mBAAmB,CAAC,EAAE,OAAO,CAAC,2BAA2B,CAAC,CAAA;CAC3D;AAED,eAAO,MAAM,iBAAiB,GAAI,wOAmB/B,sBAAsB,uCAmsBxB,CAAA"}

package/dist/components/__tests__/TourFocusManager.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=TourFocusManager.test.d.ts.map

package/dist/components/__tests__/TourFocusManager.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TourFocusManager.test.d.ts","sourceRoot":"","sources":["../../../src/components/__tests__/TourFocusManager.test.tsx"],"names":[],"mappings":""}

package/dist/context.d.ts

@@ -0,0 +1,56 @@
+import type { BackdropInteractionMode, EventBus, FlowAnalyticsHandlers, FlowCancelReason, FlowDefinition, FlowEvents, FlowState, StartFlowOptions, Step, StorageAdapter, VersionMismatchInfo } from '@flowsterix/core';
+import type { Dispatch, PropsWithChildren, ReactNode, SetStateAction } from 'react';
+import type { TourLabels } from './labels';
+import type { AnimationAdapter } from './motion/animationAdapter';
+export interface DelayAdvanceInfo {
+    flowId: string;
+    stepId: string;
+    totalMs: number;
+    startedAt: number;
+    endsAt: number;
+}
+export interface TourProviderProps {
+    flows: Array<FlowDefinition<ReactNode>>;
+    children: ReactNode;
+    storageAdapter?: StorageAdapter;
+    storageNamespace?: string;
+    persistOnChange?: boolean;
+    defaultDebug?: boolean;
+    animationAdapter?: AnimationAdapter;
+    reducedMotionAdapter?: AnimationAdapter;
+    autoDetectReducedMotion?: boolean;
+    analytics?: FlowAnalyticsHandlers<ReactNode>;
+    backdropInteraction?: BackdropInteractionMode;
+    lockBodyScroll?: boolean;
+    /** Customize UI labels for internationalization */
+    labels?: Partial<TourLabels>;
+    /** Callback when a version mismatch is detected and resolved */
+    onVersionMismatch?: (info: VersionMismatchInfo) => void;
+}
+export interface TourContextValue {
+    flows: Map<string, FlowDefinition<ReactNode>>;
+    activeFlowId: string | null;
+    state: FlowState | null;
+    activeStep: Step<ReactNode> | null;
+    startFlow: (flowId: string, options?: StartFlowOptions) => FlowState;
+    next: () => FlowState;
+    back: () => FlowState;
+    goToStep: (step: number | string) => FlowState;
+    pause: () => FlowState;
+    resume: () => FlowState;
+    cancel: (reason?: FlowCancelReason) => FlowState;
+    complete: () => FlowState;
+    events: EventBus<FlowEvents<ReactNode>> | null;
+    debugEnabled: boolean;
+    setDebugEnabled: (value: boolean) => void;
+    toggleDebug: () => void;
+    delayInfo: DelayAdvanceInfo | null;
+    /** @internal */
+    setDelayInfo: Dispatch<SetStateAction<DelayAdvanceInfo | null>>;
+    backdropInteraction: BackdropInteractionMode;
+    lockBodyScroll: boolean;
+}
+export declare const TourProvider: ({ flows, children, storageAdapter, storageNamespace, persistOnChange, defaultDebug, animationAdapter: animationAdapterProp, reducedMotionAdapter, autoDetectReducedMotion, analytics, backdropInteraction: backdropInteractionProp, lockBodyScroll: lockBodyScrollProp, labels: labelsProp, onVersionMismatch, }: PropsWithChildren<TourProviderProps>) => import("react/jsx-runtime").JSX.Element;
+export declare const useTour: () => TourContextValue;
+export declare const useTourEvents: <TEventKey extends Extract<keyof FlowEvents<ReactNode>, string>>(event: TEventKey, handler: (payload: FlowEvents<ReactNode>[TEventKey]) => void) => void;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

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

package/dist/hooks/__tests__/scrollMargin.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scrollMargin.test.d.ts.map

package/dist/hooks/__tests__/scrollMargin.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrollMargin.test.d.ts","sourceRoot":"","sources":["../../../src/hooks/__tests__/scrollMargin.test.ts"],"names":[],"mappings":""}

package/dist/hooks/__tests__/useBodyScrollLock.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useBodyScrollLock.test.d.ts.map

package/dist/hooks/__tests__/useBodyScrollLock.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBodyScrollLock.test.d.ts","sourceRoot":"","sources":["../../../src/hooks/__tests__/useBodyScrollLock.test.tsx"],"names":[],"mappings":""}

package/dist/hooks/__tests__/useHiddenTargetFallback.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=useHiddenTargetFallback.test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useHiddenTargetFallback.test.d.ts","sourceRoot":"","sources":["../../../src/hooks/__tests__/useHiddenTargetFallback.test.tsx"],"names":[],"mappings":""}

package/dist/hooks/__tests__/waitForPredicate.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=waitForPredicate.test.d.ts.map

package/dist/hooks/__tests__/waitForPredicate.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"waitForPredicate.test.d.ts","sourceRoot":"","sources":["../../../src/hooks/__tests__/waitForPredicate.test.ts"],"names":[],"mappings":""}

package/dist/hooks/scrollMargin.d.ts

@@ -0,0 +1,15 @@
+export type ScrollMarginInput = number | {
+    top?: number;
+    bottom?: number;
+    left?: number;
+    right?: number;
+};
+export interface ScrollMargin {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+}
+export declare const DEFAULT_SCROLL_MARGIN = 16;
+export declare const resolveScrollMargin: (margin?: ScrollMarginInput, fallback?: number) => ScrollMargin;
+//# sourceMappingURL=scrollMargin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scrollMargin.d.ts","sourceRoot":"","sources":["../../src/hooks/scrollMargin.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GACzB,MAAM,GACN;IACE,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAEL,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd;AAED,eAAO,MAAM,qBAAqB,KAAK,CAAA;AASvC,eAAO,MAAM,mBAAmB,GAC9B,SAAS,iBAAiB,EAC1B,iBAAgC,KAC/B,YAiBF,CAAA"}

package/dist/hooks/useAdvanceRules.d.ts

@@ -0,0 +1,3 @@
+import type { TourTargetInfo } from './useTourTarget';
+export declare const useAdvanceRules: (target: TourTargetInfo) => void;
+//# sourceMappingURL=useAdvanceRules.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useAdvanceRules.d.ts","sourceRoot":"","sources":["../../src/hooks/useAdvanceRules.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AA2DrD,eAAO,MAAM,eAAe,GAAI,QAAQ,cAAc,SA6MrD,CAAA"}

package/dist/hooks/useBodyScrollLock.d.ts

@@ -0,0 +1,2 @@
+export declare const useBodyScrollLock: (enabled: boolean) => void;
+//# sourceMappingURL=useBodyScrollLock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useBodyScrollLock.d.ts","sourceRoot":"","sources":["../../src/hooks/useBodyScrollLock.ts"],"names":[],"mappings":"AA0BA,eAAO,MAAM,iBAAiB,GAAI,SAAS,OAAO,SAQjD,CAAA"}

package/dist/hooks/useDelayAdvance.d.ts

@@ -0,0 +1,14 @@
+export interface DelayAdvanceProgress {
+    isActive: boolean;
+    flowId: string | null;
+    stepId: string | null;
+    totalMs: number;
+    remainingMs: number;
+    elapsedMs: number;
+    fractionElapsed: number;
+    fractionRemaining: number;
+    startedAt: number | null;
+    endsAt: number | null;
+}
+export declare const useDelayAdvance: () => DelayAdvanceProgress;
+//# sourceMappingURL=useDelayAdvance.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useDelayAdvance.d.ts","sourceRoot":"","sources":["../../src/hooks/useDelayAdvance.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,OAAO,CAAA;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;IACjB,eAAe,EAAE,MAAM,CAAA;IACvB,iBAAiB,EAAE,MAAM,CAAA;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAOD,eAAO,MAAM,eAAe,QAAO,oBAwFlC,CAAA"}