@flowsterix/react 0.1.0

package/dist/router/nextPagesRouterAdapter.cjs

@@ -0,0 +1,217 @@
+"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/nextPagesRouterAdapter.tsx
+var nextPagesRouterAdapter_exports = {};
+__export(nextPagesRouterAdapter_exports, {
+  useNextPagesRouterTourAdapter: () => useNextPagesRouterTourAdapter
+});
+module.exports = __toCommonJS(nextPagesRouterAdapter_exports);
+var NextRouter = __toESM(require("next/router"), 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/nextPagesRouterAdapter.tsx
+var useNextPagesRouterTourAdapter = () => {
+  const useRouter2 = typeof NextRouter.useRouter === "function" ? NextRouter.useRouter : null;
+  if (!useRouter2) {
+    if (typeof console !== "undefined") {
+      console.warn(
+        "[tour][router] useNextPagesRouterTourAdapter requires next/router. Call this hook only in Next.js Pages Router environments."
+      );
+    }
+    return;
+  }
+  const router = useRouter2();
+  const pathCandidate = typeof router.asPath === "string" && router.asPath.length > 0 ? router.asPath : router.pathname;
+  (0, import_react.useEffect)(() => {
+    const path = typeof pathCandidate === "string" && pathCandidate.length > 0 ? pathCandidate : createPathString(router.pathname ?? "/");
+    notifyRouteChange(path);
+  }, [pathCandidate, router.pathname]);
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useNextPagesRouterTourAdapter
+});

package/dist/router/nextPagesRouterAdapter.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"nextPagesRouterAdapter.d.ts","sourceRoot":"","sources":["../../src/router/nextPagesRouterAdapter.tsx"],"names":[],"mappings":"AAMA,eAAO,MAAM,6BAA6B,YA2BzC,CAAA"}

package/dist/router/nextPagesRouterAdapter.mjs

@@ -0,0 +1,28 @@
+import {
+  createPathString,
+  notifyRouteChange
+} from "../chunk-RPA2S5UP.mjs";
+
+// src/router/nextPagesRouterAdapter.tsx
+import * as NextRouter from "next/router";
+import { useEffect } from "react";
+var useNextPagesRouterTourAdapter = () => {
+  const useRouter2 = typeof NextRouter.useRouter === "function" ? NextRouter.useRouter : null;
+  if (!useRouter2) {
+    if (typeof console !== "undefined") {
+      console.warn(
+        "[tour][router] useNextPagesRouterTourAdapter requires next/router. Call this hook only in Next.js Pages Router environments."
+      );
+    }
+    return;
+  }
+  const router = useRouter2();
+  const pathCandidate = typeof router.asPath === "string" && router.asPath.length > 0 ? router.asPath : router.pathname;
+  useEffect(() => {
+    const path = typeof pathCandidate === "string" && pathCandidate.length > 0 ? pathCandidate : createPathString(router.pathname ?? "/");
+    notifyRouteChange(path);
+  }, [pathCandidate, router.pathname]);
+};
+export {
+  useNextPagesRouterTourAdapter
+};

package/dist/router/reactRouterAdapter.cjs

@@ -0,0 +1,220 @@
+"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/reactRouterAdapter.tsx
+var reactRouterAdapter_exports = {};
+__export(reactRouterAdapter_exports, {
+  useReactRouterTourAdapter: () => useReactRouterTourAdapter
+});
+module.exports = __toCommonJS(reactRouterAdapter_exports);
+var import_react = require("react");
+var ReactRouterDom = __toESM(require("react-router-dom"), 1);
+
+// 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/reactRouterAdapter.tsx
+var useReactRouterTourAdapter = () => {
+  const useLocation2 = typeof ReactRouterDom.useLocation === "function" ? ReactRouterDom.useLocation : null;
+  if (!useLocation2) {
+    if (typeof console !== "undefined") {
+      console.warn(
+        "[tour][router] useReactRouterTourAdapter requires react-router-dom. Call this hook only in React Router environments."
+      );
+    }
+    return;
+  }
+  const location = useLocation2();
+  (0, import_react.useEffect)(() => {
+    const path = createPathString(
+      location.pathname,
+      location.search,
+      location.hash
+    );
+    notifyRouteChange(path);
+  }, [location.pathname, location.search, location.hash]);
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useReactRouterTourAdapter
+});

package/dist/router/reactRouterAdapter.d.ts

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

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

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

package/dist/router/reactRouterAdapter.mjs

@@ -0,0 +1,31 @@
+import {
+  createPathString,
+  notifyRouteChange
+} from "../chunk-RPA2S5UP.mjs";
+
+// src/router/reactRouterAdapter.tsx
+import { useEffect } from "react";
+import * as ReactRouterDom from "react-router-dom";
+var useReactRouterTourAdapter = () => {
+  const useLocation2 = typeof ReactRouterDom.useLocation === "function" ? ReactRouterDom.useLocation : null;
+  if (!useLocation2) {
+    if (typeof console !== "undefined") {
+      console.warn(
+        "[tour][router] useReactRouterTourAdapter requires react-router-dom. Call this hook only in React Router environments."
+      );
+    }
+    return;
+  }
+  const location = useLocation2();
+  useEffect(() => {
+    const path = createPathString(
+      location.pathname,
+      location.search,
+      location.hash
+    );
+    notifyRouteChange(path);
+  }, [location.pathname, location.search, location.hash]);
+};
+export {
+  useReactRouterTourAdapter
+};

package/dist/router/routeGating.d.ts

@@ -0,0 +1,13 @@
+export type RouteChangeListener = (path: string) => void;
+declare class RouteGatingChannel {
+    #private;
+    getCurrentPath(): string;
+    notify(path?: string): void;
+    subscribe(listener: RouteChangeListener): () => void;
+}
+export declare const routeGatingChannel: RouteGatingChannel;
+export declare const getCurrentRoutePath: () => string;
+export declare const notifyRouteChange: (path?: string) => void;
+export declare const subscribeToRouteChanges: (listener: RouteChangeListener) => () => void;
+export {};
+//# sourceMappingURL=routeGating.d.ts.map

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

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