@flowsterix/react 0.1.0

package/dist/labels.d.ts

@@ -0,0 +1,22 @@
+export interface TourLabels {
+    back: string;
+    next: string;
+    finish: string;
+    skip: string;
+    holdToConfirm: string;
+    ariaStepProgress: (params: {
+        current: number;
+        total: number;
+    }) => string;
+    ariaTimeRemaining: (params: {
+        ms: number;
+    }) => string;
+    ariaDelayProgress: string;
+    formatTimeRemaining: (params: {
+        ms: number;
+    }) => string;
+}
+export declare const defaultLabels: TourLabels;
+export declare const LabelsProvider: import("react").Provider<TourLabels>;
+export declare function useTourLabels(): TourLabels;
+//# sourceMappingURL=labels.d.ts.map

package/dist/labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../src/labels.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IAEzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,EAAE,MAAM,CAAA;IAGrB,gBAAgB,EAAE,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAA;IACxE,iBAAiB,EAAE,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAA;IACrD,iBAAiB,EAAE,MAAM,CAAA;IAGzB,mBAAmB,EAAE,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAA;CACxD;AAED,eAAO,MAAM,aAAa,EAAE,UAa3B,CAAA;AAID,eAAO,MAAM,cAAc,sCAAyB,CAAA;AAEpD,wBAAgB,aAAa,IAAI,UAAU,CAE1C"}

package/dist/motion/animationAdapter.d.ts

@@ -0,0 +1,40 @@
+import type { Transition } from 'motion/react';
+import { motion } from 'motion/react';
+import type { ReactNode } from 'react';
+export interface AnimationAdapterComponents {
+    MotionDiv: typeof motion.div;
+    MotionSection: typeof motion.section;
+    MotionSvg: typeof motion.svg;
+    MotionDefs: typeof motion.defs;
+    MotionMask: typeof motion.mask;
+    MotionRect: typeof motion.rect;
+    MotionSpan: typeof motion.span;
+    MotionButton: typeof motion.button;
+}
+export interface AnimationAdapterTransitions {
+    overlayHighlight?: Transition;
+    overlayFade?: Transition;
+    popoverEntrance?: Transition;
+    popoverExit?: Transition;
+    popoverContent?: Transition;
+    delayIndicator?: Transition;
+}
+export interface AnimationAdapter {
+    components: AnimationAdapterComponents;
+    transitions: AnimationAdapterTransitions;
+}
+export interface AnimationAdapterProviderProps {
+    adapter?: AnimationAdapter;
+    children: ReactNode;
+}
+export declare const AnimationAdapterProvider: ({ adapter, children, }: AnimationAdapterProviderProps) => import("react/jsx-runtime").JSX.Element;
+export declare const useAnimationAdapter: () => AnimationAdapter;
+export declare const defaultAnimationAdapter: AnimationAdapter;
+export declare const reducedMotionAnimationAdapter: AnimationAdapter;
+export interface UseAnimationAdapterOptions {
+    defaultAdapter?: AnimationAdapter;
+    reducedMotionAdapter?: AnimationAdapter;
+    enabled?: boolean;
+}
+export declare const usePreferredAnimationAdapter: (options?: UseAnimationAdapterOptions) => AnimationAdapter;
+//# sourceMappingURL=animationAdapter.d.ts.map

package/dist/motion/animationAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"animationAdapter.d.ts","sourceRoot":"","sources":["../../src/motion/animationAdapter.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAGtC,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,OAAO,MAAM,CAAC,GAAG,CAAA;IAC5B,aAAa,EAAE,OAAO,MAAM,CAAC,OAAO,CAAA;IACpC,SAAS,EAAE,OAAO,MAAM,CAAC,GAAG,CAAA;IAC5B,UAAU,EAAE,OAAO,MAAM,CAAC,IAAI,CAAA;IAC9B,UAAU,EAAE,OAAO,MAAM,CAAC,IAAI,CAAA;IAC9B,UAAU,EAAE,OAAO,MAAM,CAAC,IAAI,CAAA;IAC9B,UAAU,EAAE,OAAO,MAAM,CAAC,IAAI,CAAA;IAC9B,YAAY,EAAE,OAAO,MAAM,CAAC,MAAM,CAAA;CACnC;AAED,MAAM,WAAW,2BAA2B;IAC1C,gBAAgB,CAAC,EAAE,UAAU,CAAA;IAC7B,WAAW,CAAC,EAAE,UAAU,CAAA;IACxB,eAAe,CAAC,EAAE,UAAU,CAAA;IAC5B,WAAW,CAAC,EAAE,UAAU,CAAA;IACxB,cAAc,CAAC,EAAE,UAAU,CAAA;IAC3B,cAAc,CAAC,EAAE,UAAU,CAAA;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,0BAA0B,CAAA;IACtC,WAAW,EAAE,2BAA2B,CAAA;CACzC;AA+CD,MAAM,WAAW,6BAA6B;IAC5C,OAAO,CAAC,EAAE,gBAAgB,CAAA;IAC1B,QAAQ,EAAE,SAAS,CAAA;CACpB;AAED,eAAO,MAAM,wBAAwB,GAAI,wBAGtC,6BAA6B,4CAO/B,CAAA;AAED,eAAO,MAAM,mBAAmB,QAAO,gBAEtC,CAAA;AAED,eAAO,MAAM,uBAAuB,kBAAiB,CAAA;AAErD,eAAO,MAAM,6BAA6B,EAAE,gBA6B3C,CAAA;AAID,MAAM,WAAW,0BAA0B;IACzC,cAAc,CAAC,EAAE,gBAAgB,CAAA;IACjC,oBAAoB,CAAC,EAAE,gBAAgB,CAAA;IACvC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED,eAAO,MAAM,4BAA4B,GACvC,UAAU,0BAA0B,KACnC,gBA6BF,CAAA"}

package/dist/motion/useHudMotion.d.ts

@@ -0,0 +1,14 @@
+import type { Transition } from 'motion/react';
+import type { AnimationAdapterComponents } from './animationAdapter';
+export interface UseHudMotionResult {
+    components: AnimationAdapterComponents;
+    transitions: {
+        highlight: Transition;
+        overlayFade: Transition;
+        popoverEntrance: Transition;
+        popoverExit: Transition;
+        popoverContent: Transition;
+    };
+}
+export declare const useHudMotion: () => UseHudMotionResult;
+//# sourceMappingURL=useHudMotion.d.ts.map

package/dist/motion/useHudMotion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useHudMotion.d.ts","sourceRoot":"","sources":["../../src/motion/useHudMotion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAG9C,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAA;AAgCpE,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,0BAA0B,CAAA;IACtC,WAAW,EAAE;QACX,SAAS,EAAE,UAAU,CAAA;QACrB,WAAW,EAAE,UAAU,CAAA;QACvB,eAAe,EAAE,UAAU,CAAA;QAC3B,WAAW,EAAE,UAAU,CAAA;QACvB,cAAc,EAAE,UAAU,CAAA;KAC3B,CAAA;CACF;AAED,eAAO,MAAM,YAAY,QAAO,kBA0B/B,CAAA"}

package/dist/router/index.cjs

@@ -0,0 +1,275 @@
+"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)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  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/index.ts
+var router_exports = {};
+__export(router_exports, {
+  TanStackRouterSync: () => TanStackRouterSync,
+  createPathString: () => createPathString,
+  getCurrentRoutePath: () => getCurrentRoutePath,
+  getTanStackRouter: () => getTanStackRouter,
+  getTourRouter: () => getTourRouter,
+  notifyRouteChange: () => notifyRouteChange,
+  routeGatingChannel: () => routeGatingChannel,
+  setTanStackRouter: () => setTanStackRouter,
+  setTourRouter: () => setTourRouter,
+  subscribeToRouteChanges: () => subscribeToRouteChanges,
+  useTanStackRouterTourAdapter: () => useTanStackRouterTourAdapter
+});
+module.exports = __toCommonJS(router_exports);
+
+// src/utils/dom.ts
+var isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
+
+// 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}`;
+};
+
+// 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]);
+};
+
+// src/router/tanstackRouterSync.tsx
+var TanStackRouter = __toESM(require("@tanstack/react-router"), 1);
+var import_react2 = 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_react2.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 = {
+  TanStackRouterSync,
+  createPathString,
+  getCurrentRoutePath,
+  getTanStackRouter,
+  getTourRouter,
+  notifyRouteChange,
+  routeGatingChannel,
+  setTanStackRouter,
+  setTourRouter,
+  subscribeToRouteChanges,
+  useTanStackRouterTourAdapter
+});

package/dist/router/index.d.ts

@@ -0,0 +1,5 @@
+export { getCurrentRoutePath, notifyRouteChange, routeGatingChannel, subscribeToRouteChanges, } from './routeGating';
+export { createPathString } from './utils';
+export { useTanStackRouterTourAdapter } from './tanstackRouterAdapter';
+export { getTanStackRouter, getTourRouter, setTanStackRouter, setTourRouter, TanStackRouterSync, } from './tanstackRouterSync';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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"}

package/dist/router/index.mjs

@@ -0,0 +1,30 @@
+import {
+  TanStackRouterSync,
+  getTanStackRouter,
+  getTourRouter,
+  setTanStackRouter,
+  setTourRouter
+} from "../chunk-U757YVZP.mjs";
+import {
+  useTanStackRouterTourAdapter
+} from "../chunk-RCASLQRS.mjs";
+import {
+  createPathString,
+  getCurrentRoutePath,
+  notifyRouteChange,
+  routeGatingChannel,
+  subscribeToRouteChanges
+} from "../chunk-RPA2S5UP.mjs";
+export {
+  TanStackRouterSync,
+  createPathString,
+  getCurrentRoutePath,
+  getTanStackRouter,
+  getTourRouter,
+  notifyRouteChange,
+  routeGatingChannel,
+  setTanStackRouter,
+  setTourRouter,
+  subscribeToRouteChanges,
+  useTanStackRouterTourAdapter
+};

package/dist/router/nextAppRouterAdapter.cjs

@@ -0,0 +1,224 @@
+"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)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  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/nextAppRouterAdapter.tsx
+var nextAppRouterAdapter_exports = {};
+__export(nextAppRouterAdapter_exports, {
+  useNextAppRouterTourAdapter: () => useNextAppRouterTourAdapter
+});
+module.exports = __toCommonJS(nextAppRouterAdapter_exports);
+var NextNavigation = __toESM(require("next/navigation"), 1);
+var import_react = require("react");
+
+// src/utils/dom.ts
+var isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
+
+// 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 notifyRouteChange = (path) => {
+  routeGatingChannel.notify(path);
+};
+
+// 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}`;
+};
+
+// src/router/nextAppRouterAdapter.tsx
+var useNextAppRouterTourAdapter = () => {
+  const usePathname2 = typeof NextNavigation.usePathname === "function" ? NextNavigation.usePathname : null;
+  const useSearchParams2 = typeof NextNavigation.useSearchParams === "function" ? NextNavigation.useSearchParams : null;
+  if (!usePathname2 || !useSearchParams2) {
+    if (typeof console !== "undefined") {
+      console.warn(
+        "[tour][router] useNextAppRouterTourAdapter requires next/navigation. Call this hook only in Next.js App Router environments."
+      );
+    }
+    return;
+  }
+  const pathname = usePathname2();
+  const searchParams = useSearchParams2();
+  const searchValue = searchParams?.toString() ?? "";
+  (0, import_react.useEffect)(() => {
+    if (typeof pathname !== "string") return;
+    const path = createPathString(
+      pathname,
+      searchValue.length > 0 ? `?${searchValue}` : "",
+      void 0
+    );
+    notifyRouteChange(path);
+  }, [pathname, searchValue]);
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useNextAppRouterTourAdapter
+});

package/dist/router/nextAppRouterAdapter.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"nextAppRouterAdapter.d.ts","sourceRoot":"","sources":["../../src/router/nextAppRouterAdapter.tsx"],"names":[],"mappings":"AAMA,eAAO,MAAM,2BAA2B,YAkCvC,CAAA"}

package/dist/router/nextAppRouterAdapter.mjs

@@ -0,0 +1,35 @@
+import {
+  createPathString,
+  notifyRouteChange
+} from "../chunk-RPA2S5UP.mjs";
+
+// src/router/nextAppRouterAdapter.tsx
+import * as NextNavigation from "next/navigation";
+import { useEffect } from "react";
+var useNextAppRouterTourAdapter = () => {
+  const usePathname2 = typeof NextNavigation.usePathname === "function" ? NextNavigation.usePathname : null;
+  const useSearchParams2 = typeof NextNavigation.useSearchParams === "function" ? NextNavigation.useSearchParams : null;
+  if (!usePathname2 || !useSearchParams2) {
+    if (typeof console !== "undefined") {
+      console.warn(
+        "[tour][router] useNextAppRouterTourAdapter requires next/navigation. Call this hook only in Next.js App Router environments."
+      );
+    }
+    return;
+  }
+  const pathname = usePathname2();
+  const searchParams = useSearchParams2();
+  const searchValue = searchParams?.toString() ?? "";
+  useEffect(() => {
+    if (typeof pathname !== "string") return;
+    const path = createPathString(
+      pathname,
+      searchValue.length > 0 ? `?${searchValue}` : "",
+      void 0
+    );
+    notifyRouteChange(path);
+  }, [pathname, searchValue]);
+};
+export {
+  useNextAppRouterTourAdapter
+};