@okyrychenko-dev/react-action-guard-router 0.2.4 → 1.0.0

package/dist/nextjs/index.js

@@ -1,19 +1,18 @@
-import { useRouter } from 'next/router';
-import { useRef, useEffect, useMemo } from 'react';
+import { useRouter } from 'next/router.js';
+import { useRef, useInsertionEffect, useEffect, useMemo } from 'react';
+import { isDefined, isArray, isFunction, isObject } from '@okyrychenko-dev/type-utils';
 import { useIsBlocked } from '@okyrychenko-dev/react-action-guard';
 
 // src/nextjs/usePagesRouterBlocker.ts
-
-// src/core/utils.ts
 function resolveCondition(condition) {
-  return typeof condition === "function" ? condition() : condition;
+  return isFunction(condition) ? condition() : condition;
 }
-var hasThen = (value) => typeof value === "object" && value !== null && "then" in value;
+var hasThen = (value) => isObject(value) && "then" in value;
 function isThenable(value) {
   if (!hasThen(value)) {
     return false;
   }
-  return typeof value.then === "function";
+  return isFunction(value.then);
 }
 function resolveConfirmResult(message, onConfirm, fallbackConfirm) {
   if (!onConfirm) {
@@ -25,14 +24,14 @@ function resolveConfirmResult(message, onConfirm, fallbackConfirm) {
   }
   return { kind: "sync", confirmed: result };
 }
-function isDefined(value) {
-  return value !== void 0 && value !== null;
-}
 function normalizeScope(scope) {
   if (!scope) {
     return [];
   }
-  return Array.isArray(scope) ? scope : [scope];
+  return isArray(scope) ? scope : [scope];
+}
+function createScopeKey(scope) {
+  return JSON.stringify([...new Set(normalizeScope(scope))].sort());
 }
 
 // src/core/useBeforeUnload.ts
@@ -59,7 +58,6 @@ function useShouldBlock(when, scope) {
   const scopes = useMemo(() => normalizeScope(scope), [scope]);
   const isScopeBlocked = useIsBlocked(scopes.length === 1 ? scopes[0] : scopes);
   const warnedMissingConditionRef = useRef(false);
-  const warnedFunctionRef = useRef(false);
   useEffect(() => {
     if (process.env.NODE_ENV !== "development") {
       return;
@@ -70,24 +68,9 @@ function useShouldBlock(when, scope) {
         '[react-action-guard-router] useShouldBlock: Neither "when" nor "scope" provided. This hook will always return false. Please provide at least one condition.'
       );
     }
-    if (!warnedFunctionRef.current && typeof when === "function") {
-      warnedFunctionRef.current = true;
-      console.warn(
-        '[react-action-guard-router] useShouldBlock: "when" is a function. Make sure to wrap it with useCallback to avoid unnecessary re-computations.'
-      );
-    }
   }, [when, scope]);
-  const shouldBlock = useMemo(() => {
-    let blockCondition = false;
-    if (isDefined(when)) {
-      blockCondition = resolveCondition(when);
-    }
-    if (scope && isScopeBlocked) {
-      blockCondition = true;
-    }
-    return blockCondition;
-  }, [when, scope, isScopeBlocked]);
-  return shouldBlock;
+  const blockCondition = isDefined(when) && resolveCondition(when);
+  return blockCondition || Boolean(scope && isScopeBlocked);
 }
 
 // src/core/constants.ts
@@ -98,30 +81,60 @@ var ROUTE_ERRORS = {
   BLOCKED: "Route change blocked"
 };
 
+// src/core/confirmationOwner.utils.ts
+function createConfirmationOwner() {
+  let currentAttempt = 0;
+  function invalidate() {
+    currentAttempt += 1;
+  }
+  function begin() {
+    const attempt = ++currentAttempt;
+    function settle() {
+      if (attempt !== currentAttempt) {
+        return false;
+      }
+      invalidate();
+      return true;
+    }
+    return settle;
+  }
+  return { begin, invalidate };
+}
+
 // src/nextjs/usePagesRouterBlocker.ts
 function useNavigationBlocker(options) {
   const { when, scope, message, onBlock, onAllow, blockBrowserUnload = true, onConfirm } = options;
   const router = useRouter();
-  const allowNextUrlRef = useRef(null);
+  const callbacksRef = useRef({ onBlock, onAllow, onConfirm });
+  useInsertionEffect(() => {
+    callbacksRef.current = { onBlock, onAllow, onConfirm };
+  }, [onBlock, onAllow, onConfirm]);
   const shouldBlock = useShouldBlock(when, scope);
-  useEffect(() => {
+  const scopeKey = createScopeKey(scope);
+  useInsertionEffect(() => {
     if (!shouldBlock) {
       return;
     }
-    const handleRouteChangeStart = (url) => {
-      if (allowNextUrlRef.current === url) {
-        allowNextUrlRef.current = null;
-        onAllow?.();
+    const confirmationOwner = createConfirmationOwner();
+    let allowedNavigation = null;
+    let currentAttempt = null;
+    function handleRouteChangeStart(url) {
+      if (allowedNavigation?.url === url) {
+        allowedNavigation = null;
         return;
       }
-      onBlock?.();
+      allowedNavigation = null;
+      const settle = confirmationOwner.begin();
+      currentAttempt = settle;
+      const { onBlock: onBlock2, onAllow: onAllow2, onConfirm: onConfirm2 } = callbacksRef.current;
+      onBlock2?.();
       if (!message) {
         router.events.emit("routeChangeError");
         throw new Error(ROUTE_ERRORS.BLOCKED);
       }
       const confirmation = resolveConfirmResult(
         message,
-        onConfirm,
+        onConfirm2,
         (value) => window.confirm(value)
       );
       if (confirmation.kind === "sync" && !confirmation.confirmed) {
@@ -129,25 +142,48 @@ function useNavigationBlocker(options) {
         throw new Error(ROUTE_ERRORS.ABORTED);
       }
       if (confirmation.kind === "sync") {
-        onAllow?.();
+        if (!settle()) {
+          router.events.emit("routeChangeError");
+          throw new Error(ROUTE_ERRORS.ABORTED);
+        }
+        onAllow2?.();
+        if (currentAttempt !== settle) {
+          router.events.emit("routeChangeError");
+          throw new Error(ROUTE_ERRORS.ABORTED);
+        }
         return;
       }
       router.events.emit("routeChangeError");
-      confirmation.promise.then((confirmed) => {
-        if (confirmed) {
-          allowNextUrlRef.current = url;
-          onAllow?.();
-          void router.push(url);
+      async function complete(confirmed) {
+        if (!settle() || !confirmed) {
+          return;
+        }
+        const permission = { url };
+        allowedNavigation = permission;
+        const { onAllow: notifyAllow } = callbacksRef.current;
+        try {
+          notifyAllow?.();
+          if (allowedNavigation !== permission) {
+            return;
+          }
+          await router.push(url);
+        } finally {
+          if (allowedNavigation === permission) {
+            allowedNavigation = null;
+          }
         }
-      }).catch(() => {
-      });
+      }
+      void confirmation.promise.then(complete).catch(() => complete(false));
       throw new Error(ROUTE_ERRORS.ABORTED);
-    };
+    }
     router.events.on("routeChangeStart", handleRouteChangeStart);
     return () => {
+      confirmationOwner.invalidate();
+      currentAttempt = null;
+      allowedNavigation = null;
       router.events.off("routeChangeStart", handleRouteChangeStart);
     };
-  }, [shouldBlock, message, onBlock, onAllow, router, onConfirm]);
+  }, [shouldBlock, scopeKey, message, router]);
   useBeforeUnload(blockBrowserUnload && shouldBlock, message ?? DEFAULT_UNLOAD_MESSAGE);
   return {
     isBlocking: shouldBlock

package/dist/nextjs/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/utils.ts","../../src/core/useBeforeUnload.ts","../../src/core/useShouldBlock.ts","../../src/core/constants.ts","../../src/nextjs/usePagesRouterBlocker.ts","../../src/nextjs/useAppRouterBlocker.ts"],"names":["useEffect","useRef","useNavigationBlocker"],"mappings":";;;;;;;AAMO,SAAS,iBAAiB,SAAA,EAA+C;AAC9E,EAAA,OAAO,OAAO,SAAA,KAAc,UAAA,GAAa,SAAA,EAAU,GAAI,SAAA;AACzD;AAMA,IAAM,OAAA,GAAU,CAAC,KAAA,KACf,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,QAAQ,MAAA,IAAU,KAAA;AAKpD,SAAS,WAAc,KAAA,EAAyC;AACrE,EAAA,IAAI,CAAC,OAAA,CAAQ,KAAK,CAAA,EAAG;AACnB,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,OAAO,MAAM,IAAA,KAAS,UAAA;AAC/B;AAiBO,SAAS,oBAAA,CACd,OAAA,EACA,SAAA,EACA,eAAA,EACe;AACf,EAAA,IAAI,CAAC,SAAA,EAAW;AACd,IAAA,OAAO,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAA,EAAW,eAAA,CAAgB,OAAO,CAAA,EAAE;AAAA,EAC7D;AAEA,EAAA,MAAM,MAAA,GAAS,UAAU,OAAO,CAAA;AAChC,EAAA,IAAI,UAAA,CAAoB,MAAM,CAAA,EAAG;AAC/B,IAAA,OAAO,EAAE,IAAA,EAAM,OAAA,EAAS,SAAS,OAAA,CAAQ,OAAA,CAAQ,MAAM,CAAA,EAAE;AAAA,EAC3D;AAEA,EAAA,OAAO,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAA,EAAW,MAAA,EAAO;AAC3C;AAqBO,SAAS,UAAa,KAAA,EAAyC;AACpE,EAAA,OAAO,KAAA,KAAU,UAAa,KAAA,KAAU,IAAA;AAC1C;AAQO,SAAS,eAAe,KAAA,EAA0D;AACvF,EAAA,IAAI,CAAC,KAAA,EAAO;AACV,IAAA,OAAO,EAAC;AAAA,EACV;AACA,EAAA,OAAO,MAAM,OAAA,CAAQ,KAAK,CAAA,GAAI,KAAA,GAAQ,CAAC,KAAK,CAAA;AAC9C;;;ACvFO,IAAM,sBAAA,GAAyB,oCAAA;AAmC/B,SAAS,eAAA,CACd,IAAA,EACA,OAAA,GAAU,sBAAA,EACJ;AACN,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,MAAM,WAAA,GAAc,iBAAiB,IAAI,CAAA;AAEzC,IAAA,IAAI,CAAC,WAAA,EAAa;AAChB,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,kBAAA,GAAqB,CAAC,KAAA,KAAmC;AAE7D,MAAA,KAAA,CAAM,cAAA,EAAe;AAGrB,MAAA,IAAI,iBAAiB,KAAA,EAAO;AAE1B,QAAA,KAAA,CAAM,WAAA,GAAc,OAAA;AAAA,MACtB;AAAA,IACF,CAAA;AAEA,IAAA,MAAA,CAAO,gBAAA,CAAiB,gBAAgB,kBAAkB,CAAA;AAE1D,IAAA,OAAO,MAAM;AACX,MAAA,MAAA,CAAO,mBAAA,CAAoB,gBAAgB,kBAAkB,CAAA;AAAA,IAC/D,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,IAAA,EAAM,OAAO,CAAC,CAAA;AACpB;ACpDO,SAAS,cAAA,CACd,MACA,KAAA,EACS;AAET,EAAA,MAAM,MAAA,GAAS,QAAQ,MAAM,cAAA,CAAe,KAAK,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAG3D,EAAA,MAAM,cAAA,GAAiB,aAAa,MAAA,CAAO,MAAA,KAAW,IAAI,MAAA,CAAO,CAAC,IAAI,MAAM,CAAA;AAG5E,EAAA,MAAM,yBAAA,GAA4B,OAAO,KAAK,CAAA;AAC9C,EAAA,MAAM,iBAAA,GAAoB,OAAO,KAAK,CAAA;AAEtC,EAAAA,UAAU,MAAM;AACd,IAAA,IAAI,OAAA,CAAQ,GAAA,CAAI,QAAA,KAAa,aAAA,EAAe;AAC1C,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,CAAC,0BAA0B,OAAA,IAAW,CAAC,UAAU,IAAI,CAAA,IAAK,CAAC,KAAA,EAAO;AACpE,MAAA,yBAAA,CAA0B,OAAA,GAAU,IAAA;AACpC,MAAA,OAAA,CAAQ,IAAA;AAAA,QACN;AAAA,OAEF;AAAA,IACF;AAEA,IAAA,IAAI,CAAC,iBAAA,CAAkB,OAAA,IAAW,OAAO,SAAS,UAAA,EAAY;AAC5D,MAAA,iBAAA,CAAkB,OAAA,GAAU,IAAA;AAC5B,MAAA,OAAA,CAAQ,IAAA;AAAA,QACN;AAAA,OAEF;AAAA,IACF;AAAA,EACF,CAAA,EAAG,CAAC,IAAA,EAAM,KAAK,CAAC,CAAA;AAIhB,EAAA,MAAM,WAAA,GAAc,QAAQ,MAAM;AAChC,IAAA,IAAI,cAAA,GAAiB,KAAA;AAGrB,IAAA,IAAI,SAAA,CAAU,IAAI,CAAA,EAAG;AACnB,MAAA,cAAA,GAAiB,iBAAiB,IAAI,CAAA;AAAA,IACxC;AAGA,IAAA,IAAI,SAAS,cAAA,EAAgB;AAC3B,MAAA,cAAA,GAAiB,IAAA;AAAA,IACnB;AAEA,IAAA,OAAO,cAAA;AAAA,EACT,CAAA,EAAG,CAAC,IAAA,EAAM,KAAA,EAAO,cAAc,CAAC,CAAA;AAEhC,EAAA,OAAO,WAAA;AACT;;;ACrEO,IAAM,YAAA,GAAe;AAAA;AAAA,EAE1B,OAAA,EAAS,8BAAA;AAAA;AAAA,EAET,OAAA,EAAS;AACX,CAAA;;;AC2DO,SAAS,qBACd,OAAA,EACyB;AACzB,EAAA,MAAM,EAAE,MAAM,KAAA,EAAO,OAAA,EAAS,SAAS,OAAA,EAAS,kBAAA,GAAqB,IAAA,EAAM,SAAA,EAAU,GAAI,OAAA;AAEzF,EAAA,MAAM,SAAS,SAAA,EAAU;AACzB,EAAA,MAAM,eAAA,GAAkBC,OAAsB,IAAI,CAAA;AAGlD,EAAA,MAAM,WAAA,GAAc,cAAA,CAAe,IAAA,EAAM,KAAK,CAAA;AAG9C,EAAAD,UAAU,MAAM;AACd,IAAA,IAAI,CAAC,WAAA,EAAa;AAChB,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,sBAAA,GAAyB,CAAC,GAAA,KAAsB;AAEpD,MAAA,IAAI,eAAA,CAAgB,YAAY,GAAA,EAAK;AACnC,QAAA,eAAA,CAAgB,OAAA,GAAU,IAAA;AAC1B,QAAA,OAAA,IAAU;AACV,QAAA;AAAA,MACF;AAGA,MAAA,OAAA,IAAU;AAGV,MAAA,IAAI,CAAC,OAAA,EAAS;AACZ,QAAA,MAAA,CAAO,MAAA,CAAO,KAAK,kBAAkB,CAAA;AACrC,QAAA,MAAM,IAAI,KAAA,CAAM,YAAA,CAAa,OAAO,CAAA;AAAA,MACtC;AAEA,MAAA,MAAM,YAAA,GAAe,oBAAA;AAAA,QAAqB,OAAA;AAAA,QAAS,SAAA;AAAA,QAAW,CAAC,KAAA,KAC7D,MAAA,CAAO,OAAA,CAAQ,KAAK;AAAA,OACtB;AAEA,MAAA,IAAI,YAAA,CAAa,IAAA,KAAS,MAAA,IAAU,CAAC,aAAa,SAAA,EAAW;AAC3D,QAAA,MAAA,CAAO,MAAA,CAAO,KAAK,kBAAkB,CAAA;AACrC,QAAA,MAAM,IAAI,KAAA,CAAM,YAAA,CAAa,OAAO,CAAA;AAAA,MACtC;AAEA,MAAA,IAAI,YAAA,CAAa,SAAS,MAAA,EAAQ;AAChC,QAAA,OAAA,IAAU;AACV,QAAA;AAAA,MACF;AAEA,MAAA,MAAA,CAAO,MAAA,CAAO,KAAK,kBAAkB,CAAA;AACrC,MAAA,YAAA,CAAa,OAAA,CACV,IAAA,CAAK,CAAC,SAAA,KAAc;AACnB,QAAA,IAAI,SAAA,EAAW;AACb,UAAA,eAAA,CAAgB,OAAA,GAAU,GAAA;AAC1B,UAAA,OAAA,IAAU;AACV,UAAA,KAAK,MAAA,CAAO,KAAK,GAAG,CAAA;AAAA,QACtB;AAAA,MACF,CAAC,CAAA,CACA,KAAA,CAAM,MAAM;AAAA,MAEb,CAAC,CAAA;AACH,MAAA,MAAM,IAAI,KAAA,CAAM,YAAA,CAAa,OAAO,CAAA;AAAA,IACtC,CAAA;AAEA,IAAA,MAAA,CAAO,MAAA,CAAO,EAAA,CAAG,kBAAA,EAAoB,sBAAsB,CAAA;AAE3D,IAAA,OAAO,MAAM;AACX,MAAA,MAAA,CAAO,MAAA,CAAO,GAAA,CAAI,kBAAA,EAAoB,sBAAsB,CAAA;AAAA,IAC9D,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,WAAA,EAAa,OAAA,EAAS,SAAS,OAAA,EAAS,MAAA,EAAQ,SAAS,CAAC,CAAA;AAG9D,EAAA,eAAA,CAAgB,kBAAA,IAAsB,WAAA,EAAa,OAAA,IAAW,sBAAsB,CAAA;AAEpF,EAAA,OAAO;AAAA,IACL,UAAA,EAAY;AAAA,GACd;AACF;ACxFO,SAASE,sBACd,OAAA,EACyB;AACzB,EAAA,MAAM,EAAE,IAAA,EAAM,KAAA,EAAO,OAAA,EAAS,kBAAA,GAAqB,MAAK,GAAI,OAAA;AAG5D,EAAA,MAAM,WAAA,GAAc,cAAA,CAAe,IAAA,EAAM,KAAK,CAAA;AAG9C,EAAAF,UAAU,MAAM;AACd,IAAA,IAAI,OAAA,CAAQ,GAAA,CAAI,QAAA,KAAa,aAAA,IAAiB,WAAA,EAAa;AACzD,MAAA,OAAA,CAAQ,IAAA;AAAA,QACN;AAAA,OAEF;AAAA,IACF;AAAA,EACF,CAAA,EAAG,CAAC,WAAW,CAAC,CAAA;AAIhB,EAAA,eAAA,CAAgB,kBAAA,IAAsB,WAAA,EAAa,OAAA,IAAW,sBAAsB,CAAA;AAEpF,EAAA,OAAO;AAAA,IACL,UAAA,EAAY;AAAA,GACd;AACF","file":"index.js","sourcesContent":["/**\n * Resolves a condition value (boolean or function returning boolean)\n *\n * @param condition - Boolean value or function\n * @returns Resolved boolean value\n */\nexport function resolveCondition(condition: boolean | (() => boolean)): boolean {\n  return typeof condition === \"function\" ? condition() : condition;\n}\n\ninterface Thenable {\n  then: (...args: Array<unknown>) => unknown;\n}\n\nconst hasThen = (value: unknown): value is Thenable =>\n  typeof value === \"object\" && value !== null && \"then\" in value;\n\n/**\n * Checks if a value behaves like a Promise (thenable)\n */\nexport function isThenable<T>(value: unknown): value is PromiseLike<T> {\n  if (!hasThen(value)) {\n    return false;\n  }\n  return typeof value.then === \"function\";\n}\n\nexport interface ConfirmResultSync {\n  kind: \"sync\";\n  confirmed: boolean;\n}\n\nexport interface ConfirmResultAsync {\n  kind: \"async\";\n  promise: Promise<boolean>;\n}\n\nexport type ConfirmResult = ConfirmResultSync | ConfirmResultAsync;\n\n/**\n * Normalizes custom confirm result into sync or async branch.\n */\nexport function resolveConfirmResult(\n  message: string,\n  onConfirm: ((message: string) => boolean | PromiseLike<boolean>) | undefined,\n  fallbackConfirm: (message: string) => boolean\n): ConfirmResult {\n  if (!onConfirm) {\n    return { kind: \"sync\", confirmed: fallbackConfirm(message) };\n  }\n\n  const result = onConfirm(message);\n  if (isThenable<boolean>(result)) {\n    return { kind: \"async\", promise: Promise.resolve(result) };\n  }\n\n  return { kind: \"sync\", confirmed: result };\n}\n\n/**\n * Generates a unique blocker ID based on scope and timestamp\n *\n * @param prefix - Prefix for the ID\n * @param scope - Optional scope\n * @returns Unique blocker ID\n */\nexport function createBlockerId(prefix: string, scope?: string | Array<string>): string {\n  const scopePart = scope ? `-${Array.isArray(scope) ? scope.join(\"-\") : scope}` : \"\";\n  const timestamp = String(Date.now());\n  return `${prefix}${scopePart}-${timestamp}`;\n}\n\n/**\n * Checks if a value is defined and not empty\n *\n * @param value - Value to check\n * @returns True if value is defined and not empty\n */\nexport function isDefined<T>(value: T | undefined | null): value is T {\n  return value !== undefined && value !== null;\n}\n\n/**\n * Normalizes scope to an array\n *\n * @param scope - String or array of strings\n * @returns Array of scope strings\n */\nexport function normalizeScope(scope: string | Array<string> | undefined): Array<string> {\n  if (!scope) {\n    return [];\n  }\n  return Array.isArray(scope) ? scope : [scope];\n}\n","import { useEffect } from \"react\";\nimport { resolveCondition } from \"./utils\";\n\n/**\n * Default message shown when preventing browser unload\n */\nexport const DEFAULT_UNLOAD_MESSAGE = \"Changes you made may not be saved.\";\n\n/**\n * Blocks browser tab close/refresh when condition is met.\n *\n * This hook adds a `beforeunload` event listener to warn users\n * before they close or refresh the browser tab. Modern browsers\n * may ignore custom messages and show their own generic warning.\n *\n * @param when - Boolean or function returning boolean to determine if blocking should be active\n * @param message - Optional custom message (may be ignored by browsers)\n *\n * @example\n * ```tsx\n * function MyForm() {\n *   const [hasUnsavedChanges, setHasUnsavedChanges] = useState(false);\n *\n *   useBeforeUnload(hasUnsavedChanges, 'You have unsaved changes');\n *\n *   return <form>...</form>;\n * }\n * ```\n *\n * @example\n * ```tsx\n * // With function condition\n * function EditPage() {\n *   const isFormDirty = useIsBlocked('form');\n *\n *   useBeforeUnload(() => isFormDirty);\n *\n *   return <div>...</div>;\n * }\n * ```\n */\nexport function useBeforeUnload(\n  when: boolean | (() => boolean),\n  message = DEFAULT_UNLOAD_MESSAGE\n): void {\n  useEffect(() => {\n    const shouldBlock = resolveCondition(when);\n\n    if (!shouldBlock) {\n      return;\n    }\n\n    const handleBeforeUnload = (event: BeforeUnloadEvent): void => {\n      // Prevent default to trigger the browser's confirmation dialog\n      event.preventDefault();\n\n      // Fallback for legacy browsers/WebViews that still rely on returnValue.\n      if (\"returnValue\" in event) {\n        // eslint-disable-next-line @typescript-eslint/no-deprecated\n        event.returnValue = message;\n      }\n    };\n\n    window.addEventListener(\"beforeunload\", handleBeforeUnload);\n\n    return () => {\n      window.removeEventListener(\"beforeunload\", handleBeforeUnload);\n    };\n  }, [when, message]);\n}\n","import { useIsBlocked } from \"@okyrychenko-dev/react-action-guard\";\nimport { useEffect, useMemo, useRef } from \"react\";\nimport { isDefined, normalizeScope, resolveCondition } from \"./utils\";\n\n/**\n * Shared hook to determine if blocking should be active based on\n * condition and/or scope state.\n *\n * This hook uses `useMemo` for optimal performance, ensuring blocking state\n * is computed synchronously without additional re-renders.\n *\n * @param when - Optional condition (boolean or function)\n * @param scope - Optional scope(s) to check\n * @returns Whether blocking should be active\n *\n * @internal\n */\nexport function useShouldBlock(\n  when?: boolean | (() => boolean),\n  scope?: string | Array<string>\n): boolean {\n  // Memoize scope normalization to avoid recalculation on every render\n  const scopes = useMemo(() => normalizeScope(scope), [scope]);\n\n  // Check if any specified scopes are blocked\n  const isScopeBlocked = useIsBlocked(scopes.length === 1 ? scopes[0] : scopes);\n\n  // Development-only validation\n  const warnedMissingConditionRef = useRef(false);\n  const warnedFunctionRef = useRef(false);\n\n  useEffect(() => {\n    if (process.env.NODE_ENV !== \"development\") {\n      return;\n    }\n\n    if (!warnedMissingConditionRef.current && !isDefined(when) && !scope) {\n      warnedMissingConditionRef.current = true;\n      console.warn(\n        '[react-action-guard-router] useShouldBlock: Neither \"when\" nor \"scope\" provided. ' +\n          \"This hook will always return false. Please provide at least one condition.\"\n      );\n    }\n\n    if (!warnedFunctionRef.current && typeof when === \"function\") {\n      warnedFunctionRef.current = true;\n      console.warn(\n        '[react-action-guard-router] useShouldBlock: \"when\" is a function. ' +\n          \"Make sure to wrap it with useCallback to avoid unnecessary re-computations.\"\n      );\n    }\n  }, [when, scope]);\n\n  // Compute blocking state synchronously using useMemo\n  // This avoids the useState + useEffect pattern which causes an extra render\n  const shouldBlock = useMemo(() => {\n    let blockCondition = false;\n\n    // Check manual condition\n    if (isDefined(when)) {\n      blockCondition = resolveCondition(when);\n    }\n\n    // Check scope-based blocking (OR logic - block if either condition is true)\n    if (scope && isScopeBlocked) {\n      blockCondition = true;\n    }\n\n    return blockCondition;\n  }, [when, scope, isScopeBlocked]);\n\n  return shouldBlock;\n}\n","/**\n * Error messages for route blocking\n */\nexport const ROUTE_ERRORS = {\n  /** Route change was aborted by the user */\n  ABORTED: \"Route change aborted by user\",\n  /** Route change was blocked */\n  BLOCKED: \"Route change blocked\",\n} as const;\n","import { useRouter } from \"next/router\";\nimport { useEffect, useRef } from \"react\";\nimport {\n  DEFAULT_UNLOAD_MESSAGE,\n  ROUTE_ERRORS,\n  resolveConfirmResult,\n  useBeforeUnload,\n  useShouldBlock,\n} from \"../core\";\nimport type { NavigationBlockerReturn } from \"../core/types\";\nimport type { UseNavigationBlockerOptions } from \"./types\";\n\n/**\n * Blocks navigation in Next.js Pages Router applications.\n *\n * This hook integrates with Next.js Pages Router's route change events and\n * react-action-guard's scope system to prevent navigation when certain conditions\n * are met or when specific scopes are blocked.\n *\n * **Note:** This hook ONLY works with Next.js Pages Router (pages/ directory).\n * For App Router, use the App Router adapter instead.\n *\n * **Features:**\n * - Block navigation based on boolean condition or function\n * - Automatically block when react-action-guard scopes are active\n * - Support for browser `beforeunload` event (tab close/refresh)\n * - Customizable confirmation dialog\n * - Callbacks for block/allow events\n *\n * **Custom confirm note:**\n * Async `onConfirm` is supported, but Pages Router requires a re-attempted\n * navigation after confirmation (via `router.push(url)` with default options).\n *\n * ⚠️ **Limitation:** When using async `onConfirm`, the re-attempted navigation\n * uses default options. Original `as`, `shallow`, `locale`, and `scroll` params\n * may be lost because Next.js Pages Router does not expose these in\n * the `routeChangeStart` event. For precise control, use synchronous confirmations.\n *\n * @param options - Configuration options\n * @returns Object with `isBlocking` state\n *\n * @example\n * ```tsx\n * // pages/edit.tsx\n * function EditPage() {\n *   const [hasChanges, setHasChanges] = useState(false);\n *\n *   useNavigationBlocker({\n *     when: hasChanges,\n *     message: 'You have unsaved changes. Leave anyway?',\n *   });\n *\n *   return <form>...</form>;\n * }\n * ```\n *\n * @example\n * ```tsx\n * // Block based on scope\n * function CheckoutFlow() {\n *   useNavigationBlocker({\n *     scope: 'checkout',\n *     message: 'Your order is being processed. Please wait.',\n *   });\n * }\n * ```\n */\nexport function useNavigationBlocker(\n  options: UseNavigationBlockerOptions\n): NavigationBlockerReturn {\n  const { when, scope, message, onBlock, onAllow, blockBrowserUnload = true, onConfirm } = options;\n\n  const router = useRouter();\n  const allowNextUrlRef = useRef<string | null>(null);\n\n  // Use shared logic to determine if blocking should be active\n  const shouldBlock = useShouldBlock(when, scope);\n\n  // Block navigation using Next.js router events\n  useEffect(() => {\n    if (!shouldBlock) {\n      return;\n    }\n\n    const handleRouteChangeStart = (url: string): void => {\n      // Early return for allowed URL\n      if (allowNextUrlRef.current === url) {\n        allowNextUrlRef.current = null;\n        onAllow?.();\n        return;\n      }\n\n      // Trigger onBlock callback\n      onBlock?.();\n\n      // If no message, block silently\n      if (!message) {\n        router.events.emit(\"routeChangeError\");\n        throw new Error(ROUTE_ERRORS.BLOCKED);\n      }\n\n      const confirmation = resolveConfirmResult(message, onConfirm, (value) =>\n        window.confirm(value)\n      );\n\n      if (confirmation.kind === \"sync\" && !confirmation.confirmed) {\n        router.events.emit(\"routeChangeError\");\n        throw new Error(ROUTE_ERRORS.ABORTED);\n      }\n\n      if (confirmation.kind === \"sync\") {\n        onAllow?.();\n        return;\n      }\n\n      router.events.emit(\"routeChangeError\");\n      confirmation.promise\n        .then((confirmed) => {\n          if (confirmed) {\n            allowNextUrlRef.current = url;\n            onAllow?.();\n            void router.push(url);\n          }\n        })\n        .catch(() => {\n          // On error, treat as cancelled\n        });\n      throw new Error(ROUTE_ERRORS.ABORTED);\n    };\n\n    router.events.on(\"routeChangeStart\", handleRouteChangeStart);\n\n    return () => {\n      router.events.off(\"routeChangeStart\", handleRouteChangeStart);\n    };\n  }, [shouldBlock, message, onBlock, onAllow, router, onConfirm]);\n\n  // Also block browser unload if requested\n  useBeforeUnload(blockBrowserUnload && shouldBlock, message ?? DEFAULT_UNLOAD_MESSAGE);\n\n  return {\n    isBlocking: shouldBlock,\n  };\n}\n","import { useEffect } from \"react\";\nimport { DEFAULT_UNLOAD_MESSAGE, useBeforeUnload, useShouldBlock } from \"../core\";\nimport type { NavigationBlockerReturn } from \"../core/types\";\nimport type { UseNavigationBlockerOptions } from \"./types\";\n\n/**\n * Blocks navigation in Next.js App Router applications.\n *\n * **⚠️ IMPORTANT LIMITATION:**\n * Next.js App Router (app/ directory) does not currently provide an official API\n * for blocking navigation. This implementation provides best-effort blocking using\n * available mechanisms, but has limitations:\n *\n * - ✅ Browser back/forward buttons are blocked via `beforeunload`\n * - ✅ Tab close/refresh is blocked via `beforeunload`\n * - ❌ Next.js `<Link>` components are NOT blocked\n * - ❌ Programmatic `router.push()` is NOT blocked\n * - ❌ Browser address bar navigation is NOT fully blocked\n *\n * For production use with full blocking capabilities, consider using Pages Router\n * or wait for official Next.js App Router blocking API.\n *\n * @param options - Configuration options\n * @returns Object with `isBlocking` state\n *\n * @example\n * ```tsx\n * // app/edit/page.tsx\n * 'use client';\n *\n * function EditPage() {\n *   const [hasChanges, setHasChanges] = useState(false);\n *\n *   useNavigationBlocker({\n *     when: hasChanges,\n *     message: 'You have unsaved changes.',\n *   });\n *\n *   return <form>...</form>;\n * }\n * ```\n *\n * @example\n * ```tsx\n * // Block based on scope\n * 'use client';\n *\n * function CheckoutFlow() {\n *   useNavigationBlocker({\n *     scope: 'checkout',\n *     message: 'Your order is being processed.',\n *   });\n * }\n * ```\n */\nexport function useNavigationBlocker(\n  options: UseNavigationBlockerOptions\n): NavigationBlockerReturn {\n  const { when, scope, message, blockBrowserUnload = true } = options;\n\n  // Use shared logic to determine if blocking should be active\n  const shouldBlock = useShouldBlock(when, scope);\n\n  // Log warning in development\n  useEffect(() => {\n    if (process.env.NODE_ENV === \"development\" && shouldBlock) {\n      console.warn(\n        \"[react-action-guard-router] App Router has limited blocking support. \" +\n          \"Link clicks cannot be blocked. Use Pages Router for full support.\"\n      );\n    }\n  }, [shouldBlock]);\n\n  // Best effort: Block browser navigation via beforeunload\n  // This will prevent tab close, refresh, and some browser back/forward\n  useBeforeUnload(blockBrowserUnload && shouldBlock, message ?? DEFAULT_UNLOAD_MESSAGE);\n\n  return {\n    isBlocking: shouldBlock,\n  };\n}\n"]}
+{"version":3,"sources":["../../src/core/utils.ts","../../src/core/useBeforeUnload.ts","../../src/core/useShouldBlock.ts","../../src/core/constants.ts","../../src/core/confirmationOwner.utils.ts","../../src/nextjs/usePagesRouterBlocker.ts","../../src/nextjs/useAppRouterBlocker.ts"],"names":["useEffect","isDefined","useRef","onBlock","onAllow","onConfirm","useNavigationBlocker"],"mappings":"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","file":"index.js","sourcesContent":["import { isArray, isFunction, isObject } from \"@okyrychenko-dev/type-utils\";\nimport type { Optional } from \"@okyrychenko-dev/type-utils\";\n\n/**\n * Resolves a condition value (boolean or function returning boolean)\n *\n * @param condition - Boolean value or function\n * @returns Resolved boolean value\n */\nexport function resolveCondition(condition: boolean | (() => boolean)): boolean {\n  return isFunction(condition) ? condition() : condition;\n}\n\ninterface Thenable {\n  then: (...args: Array<unknown>) => unknown;\n}\n\nconst hasThen = (value: unknown): value is Thenable => isObject(value) && \"then\" in value;\n\n/**\n * Checks if a value behaves like a Promise (thenable)\n */\nexport function isThenable<T>(value: unknown): value is PromiseLike<T> {\n  if (!hasThen(value)) {\n    return false;\n  }\n\n  return isFunction(value.then);\n}\n\nexport interface ConfirmResultSync {\n  kind: \"sync\";\n  confirmed: boolean;\n}\n\nexport interface ConfirmResultAsync {\n  kind: \"async\";\n  promise: Promise<boolean>;\n}\n\nexport type ConfirmResult = ConfirmResultSync | ConfirmResultAsync;\n\n/**\n * Normalizes custom confirm result into sync or async branch.\n */\nexport function resolveConfirmResult(\n  message: string,\n  onConfirm: Optional<(message: string) => boolean | PromiseLike<boolean>>,\n  fallbackConfirm: (message: string) => boolean\n): ConfirmResult {\n  if (!onConfirm) {\n    return { kind: \"sync\", confirmed: fallbackConfirm(message) };\n  }\n\n  const result = onConfirm(message);\n\n  if (isThenable<boolean>(result)) {\n    return { kind: \"async\", promise: Promise.resolve(result) };\n  }\n\n  return { kind: \"sync\", confirmed: result };\n}\n\n/**\n * Generates a unique blocker ID based on scope and timestamp\n *\n * @param prefix - Prefix for the ID\n * @param scope - Optional scope\n * @returns Unique blocker ID\n */\nexport function createBlockerId(prefix: string, scope?: string | Array<string>): string {\n  const scopePart = scope ? `-${isArray(scope) ? scope.join(\"-\") : scope}` : \"\";\n  const timestamp = String(Date.now());\n\n  return `${prefix}${scopePart}-${timestamp}`;\n}\n\n/**\n * Checks if a value is defined and not empty\n *\n * @param value - Value to check\n * @returns True if value is defined and not empty\n */\nexport { isDefined } from \"@okyrychenko-dev/type-utils\";\n\n/**\n * Normalizes scope to an array\n *\n * @param scope - String or array of strings\n * @returns Array of scope strings\n */\nexport function normalizeScope(scope: Optional<string | Array<string>>): Array<string> {\n  if (!scope) {\n    return [];\n  }\n\n  return isArray(scope) ? scope : [scope];\n}\n\n/** Identifies protection independently of scope order and duplicate entries. */\nexport function createScopeKey(scope: Optional<string | Array<string>>): string {\n  return JSON.stringify([...new Set(normalizeScope(scope))].sort());\n}\n","import { useEffect } from \"react\";\nimport { resolveCondition } from \"./utils\";\n\n/**\n * Default message shown when preventing browser unload\n */\nexport const DEFAULT_UNLOAD_MESSAGE = \"Changes you made may not be saved.\";\n\n/**\n * Blocks browser tab close/refresh when condition is met.\n */\nexport function useBeforeUnload(\n  when: boolean | (() => boolean),\n  message = DEFAULT_UNLOAD_MESSAGE\n): void {\n  useEffect(() => {\n    const shouldBlock = resolveCondition(when);\n\n    if (!shouldBlock) {\n      return;\n    }\n\n    const handleBeforeUnload = (event: BeforeUnloadEvent): void => {\n      // Prevent default to trigger the browser's confirmation dialog\n      event.preventDefault();\n\n      // Fallback for legacy browsers/WebViews that still rely on returnValue.\n      if (\"returnValue\" in event) {\n        // eslint-disable-next-line @typescript-eslint/no-deprecated\n        event.returnValue = message;\n      }\n    };\n\n    window.addEventListener(\"beforeunload\", handleBeforeUnload);\n\n    return () => {\n      window.removeEventListener(\"beforeunload\", handleBeforeUnload);\n    };\n  }, [when, message]);\n}\n","import { useIsBlocked } from \"@okyrychenko-dev/react-action-guard\";\nimport { isDefined } from \"@okyrychenko-dev/type-utils\";\nimport { useEffect, useMemo, useRef } from \"react\";\nimport { normalizeScope, resolveCondition } from \"./utils\";\n\n/**\n * Shared hook to determine if blocking should be active based on\n * condition and/or scope state.\n *\n * Pure function conditions are evaluated synchronously on every render.\n * Mutating a ref alone does not trigger a render.\n *\n * @param when - Optional condition (boolean or function)\n * @param scope - Optional scope(s) to check\n * @returns Whether blocking should be active\n *\n * @internal\n */\nexport function useShouldBlock(\n  when?: boolean | (() => boolean),\n  scope?: string | Array<string>\n): boolean {\n  // Memoize scope normalization to avoid recalculation on every render\n  const scopes = useMemo(() => normalizeScope(scope), [scope]);\n\n  // Check if any specified scopes are blocked\n  const isScopeBlocked = useIsBlocked(scopes.length === 1 ? scopes[0] : scopes);\n\n  // Development-only validation\n  const warnedMissingConditionRef = useRef(false);\n\n  useEffect(() => {\n    if (process.env.NODE_ENV !== \"development\") {\n      return;\n    }\n\n    if (!warnedMissingConditionRef.current && !isDefined(when) && !scope) {\n      warnedMissingConditionRef.current = true;\n      console.warn(\n        '[react-action-guard-router] useShouldBlock: Neither \"when\" nor \"scope\" provided. ' +\n          \"This hook will always return false. Please provide at least one condition.\"\n      );\n    }\n  }, [when, scope]);\n\n  const blockCondition = isDefined(when) && resolveCondition(when);\n\n  return blockCondition || Boolean(scope && isScopeBlocked);\n}\n","/**\n * Error messages for route blocking\n */\nexport const ROUTE_ERRORS = {\n  /** Route change was aborted by the user */\n  ABORTED: \"Route change aborted by user\",\n  /** Route change was blocked */\n  BLOCKED: \"Route change blocked\",\n} as const;\n","import type { ConfirmationOwner } from \"./confirmationOwner.types\";\n\nexport function createConfirmationOwner(): ConfirmationOwner {\n  let currentAttempt = 0;\n\n  function invalidate(): void {\n    currentAttempt += 1;\n  }\n\n  function begin(): () => boolean {\n    const attempt = ++currentAttempt;\n\n    function settle(): boolean {\n      if (attempt !== currentAttempt) {\n        return false;\n      }\n      invalidate();\n\n      return true;\n    }\n\n    return settle;\n  }\n\n  return { begin, invalidate };\n}\n","import { useRouter } from \"next/router.js\";\nimport { useInsertionEffect, useRef } from \"react\";\nimport {\n  DEFAULT_UNLOAD_MESSAGE,\n  ROUTE_ERRORS,\n  createConfirmationOwner,\n  createScopeKey,\n  resolveConfirmResult,\n  useBeforeUnload,\n  useShouldBlock,\n} from \"../core\";\nimport type { Nullable } from \"@okyrychenko-dev/type-utils\";\nimport type { NavigationBlockerReturn } from \"../core\";\nimport type { UseNavigationBlockerOptions } from \"./types\";\n\n/**\n * Blocks navigation in Next.js Pages Router applications.\n */\nexport function useNavigationBlocker(\n  options: UseNavigationBlockerOptions\n): NavigationBlockerReturn {\n  const { when, scope, message, onBlock, onAllow, blockBrowserUnload = true, onConfirm } = options;\n\n  const router = useRouter();\n  const callbacksRef = useRef({ onBlock, onAllow, onConfirm });\n\n  // Publish committed callbacks before any component can navigate from a layout effect.\n  // Callback identity changes do not replace the protected navigation attempt.\n  useInsertionEffect(() => {\n    callbacksRef.current = { onBlock, onAllow, onConfirm };\n  }, [onBlock, onAllow, onConfirm]);\n\n  // Use shared logic to determine if blocking should be active\n  const shouldBlock = useShouldBlock(when, scope);\n\n  const scopeKey = createScopeKey(scope);\n\n  // Replace protection and its listener before layout-triggered navigation can run.\n  useInsertionEffect(() => {\n    if (!shouldBlock) {\n      return;\n    }\n\n    const confirmationOwner = createConfirmationOwner();\n    let allowedNavigation: Nullable<{ url: string }> = null;\n    let currentAttempt: Nullable<() => boolean> = null;\n\n    function handleRouteChangeStart(url: string): void {\n      // Early return for allowed URL\n      if (allowedNavigation?.url === url) {\n        allowedNavigation = null;\n\n        return;\n      }\n\n      allowedNavigation = null;\n\n      const settle = confirmationOwner.begin();\n\n      currentAttempt = settle;\n\n      const { onBlock, onAllow, onConfirm } = callbacksRef.current;\n\n      // Trigger onBlock callback\n      onBlock?.();\n\n      // If no message, block silently\n      if (!message) {\n        router.events.emit(\"routeChangeError\");\n        throw new Error(ROUTE_ERRORS.BLOCKED);\n      }\n\n      const confirmation = resolveConfirmResult(message, onConfirm, (value) =>\n        window.confirm(value)\n      );\n\n      if (confirmation.kind === \"sync\" && !confirmation.confirmed) {\n        router.events.emit(\"routeChangeError\");\n        throw new Error(ROUTE_ERRORS.ABORTED);\n      }\n\n      if (confirmation.kind === \"sync\") {\n        if (!settle()) {\n          router.events.emit(\"routeChangeError\");\n          throw new Error(ROUTE_ERRORS.ABORTED);\n        }\n\n        onAllow?.();\n\n        if (currentAttempt !== settle) {\n          router.events.emit(\"routeChangeError\");\n          throw new Error(ROUTE_ERRORS.ABORTED);\n        }\n\n        return;\n      }\n\n      router.events.emit(\"routeChangeError\");\n      async function complete(confirmed: boolean): Promise<void> {\n        if (!settle() || !confirmed) {\n          return;\n        }\n\n        const permission = { url };\n\n        allowedNavigation = permission;\n\n        const { onAllow: notifyAllow } = callbacksRef.current;\n\n        try {\n          notifyAllow?.();\n\n          // User callbacks can replace the attempt or detach this listener synchronously.\n          if (allowedNavigation !== permission) {\n            return;\n          }\n\n          await router.push(url);\n        } finally {\n          if (allowedNavigation === permission) {\n            allowedNavigation = null;\n          }\n        }\n      }\n\n      // Treat confirmation, callback and retry failures as cancellation.\n      void confirmation.promise.then(complete).catch(() => complete(false));\n      throw new Error(ROUTE_ERRORS.ABORTED);\n    }\n\n    router.events.on(\"routeChangeStart\", handleRouteChangeStart);\n\n    return () => {\n      confirmationOwner.invalidate();\n      currentAttempt = null;\n      allowedNavigation = null;\n      router.events.off(\"routeChangeStart\", handleRouteChangeStart);\n    };\n  }, [shouldBlock, scopeKey, message, router]);\n\n  // Also block browser unload if requested\n  useBeforeUnload(blockBrowserUnload && shouldBlock, message ?? DEFAULT_UNLOAD_MESSAGE);\n\n  return {\n    isBlocking: shouldBlock,\n  };\n}\n","import { useEffect } from \"react\";\nimport { DEFAULT_UNLOAD_MESSAGE, useBeforeUnload, useShouldBlock } from \"../core\";\nimport type { NavigationBlockerReturn } from \"../core\";\nimport type { UseNavigationBlockerOptions } from \"./types\";\n\n/**\n * Blocks navigation in Next.js App Router applications.\n */\nexport function useNavigationBlocker(\n  options: UseNavigationBlockerOptions\n): NavigationBlockerReturn {\n  const { when, scope, message, blockBrowserUnload = true } = options;\n\n  // Use shared logic to determine if blocking should be active\n  const shouldBlock = useShouldBlock(when, scope);\n\n  // Log warning in development\n  useEffect(() => {\n    if (process.env.NODE_ENV === \"development\" && shouldBlock) {\n      console.warn(\n        \"[react-action-guard-router] App Router has limited blocking support. \" +\n          \"Link clicks cannot be blocked. Use Pages Router for full support.\"\n      );\n    }\n  }, [shouldBlock]);\n\n  // Request a native prompt on document unload, subject to browser policy.\n  // Same-document App Router back/forward does not trigger beforeunload.\n  useBeforeUnload(blockBrowserUnload && shouldBlock, message ?? DEFAULT_UNLOAD_MESSAGE);\n\n  return {\n    isBlocking: shouldBlock,\n  };\n}\n"]}

package/dist/react-router/index.cjs

@@ -2,20 +2,19 @@
 
 var react = require('react');
 var reactRouterDom = require('react-router-dom');
+var typeUtils = require('@okyrychenko-dev/type-utils');
 var reactActionGuard = require('@okyrychenko-dev/react-action-guard');
 
 // src/react-router/useNavigationBlocker.ts
-
-// src/core/utils.ts
 function resolveCondition(condition) {
-  return typeof condition === "function" ? condition() : condition;
+  return typeUtils.isFunction(condition) ? condition() : condition;
 }
-var hasThen = (value) => typeof value === "object" && value !== null && "then" in value;
+var hasThen = (value) => typeUtils.isObject(value) && "then" in value;
 function isThenable(value) {
   if (!hasThen(value)) {
     return false;
   }
-  return typeof value.then === "function";
+  return typeUtils.isFunction(value.then);
 }
 function resolveConfirmResult(message, onConfirm, fallbackConfirm) {
   if (!onConfirm) {
@@ -27,14 +26,14 @@ function resolveConfirmResult(message, onConfirm, fallbackConfirm) {
   }
   return { kind: "sync", confirmed: result };
 }
-function isDefined(value) {
-  return value !== void 0 && value !== null;
-}
 function normalizeScope(scope) {
   if (!scope) {
     return [];
   }
-  return Array.isArray(scope) ? scope : [scope];
+  return typeUtils.isArray(scope) ? scope : [scope];
+}
+function createScopeKey(scope) {
+  return JSON.stringify([...new Set(normalizeScope(scope))].sort());
 }
 
 // src/core/useBeforeUnload.ts
@@ -61,35 +60,39 @@ function useShouldBlock(when, scope) {
   const scopes = react.useMemo(() => normalizeScope(scope), [scope]);
   const isScopeBlocked = reactActionGuard.useIsBlocked(scopes.length === 1 ? scopes[0] : scopes);
   const warnedMissingConditionRef = react.useRef(false);
-  const warnedFunctionRef = react.useRef(false);
   react.useEffect(() => {
     if (process.env.NODE_ENV !== "development") {
       return;
     }
-    if (!warnedMissingConditionRef.current && !isDefined(when) && !scope) {
+    if (!warnedMissingConditionRef.current && !typeUtils.isDefined(when) && !scope) {
       warnedMissingConditionRef.current = true;
       console.warn(
         '[react-action-guard-router] useShouldBlock: Neither "when" nor "scope" provided. This hook will always return false. Please provide at least one condition.'
       );
     }
-    if (!warnedFunctionRef.current && typeof when === "function") {
-      warnedFunctionRef.current = true;
-      console.warn(
-        '[react-action-guard-router] useShouldBlock: "when" is a function. Make sure to wrap it with useCallback to avoid unnecessary re-computations.'
-      );
-    }
   }, [when, scope]);
-  const shouldBlock = react.useMemo(() => {
-    let blockCondition = false;
-    if (isDefined(when)) {
-      blockCondition = resolveCondition(when);
-    }
-    if (scope && isScopeBlocked) {
-      blockCondition = true;
+  const blockCondition = typeUtils.isDefined(when) && resolveCondition(when);
+  return blockCondition || Boolean(scope && isScopeBlocked);
+}
+
+// src/core/confirmationOwner.utils.ts
+function createConfirmationOwner() {
+  let currentAttempt = 0;
+  function invalidate() {
+    currentAttempt += 1;
+  }
+  function begin() {
+    const attempt = ++currentAttempt;
+    function settle() {
+      if (attempt !== currentAttempt) {
+        return false;
+      }
+      invalidate();
+      return true;
     }
-    return blockCondition;
-  }, [when, scope, isScopeBlocked]);
-  return shouldBlock;
+    return settle;
+  }
+  return { begin, invalidate };
 }
 
 // src/react-router/useNavigationBlocker.ts
@@ -106,16 +109,24 @@ function useNavigationBlocker(options) {
     onAllow,
     onConfirm
   } = options;
-  const confirmSeqRef = react.useRef(0);
-  const [pendingConfirm, setPendingConfirm] = react.useState(null);
+  const [confirmationOwner] = react.useState(createConfirmationOwner);
+  const { begin, invalidate } = confirmationOwner;
+  const [blockedAttempt, setBlockedAttempt] = react.useState(null);
   const shouldBlock = useShouldBlock(when ?? block, scope);
+  const scopeKey = createScopeKey(scope);
+  react.useEffect(() => {
+    return invalidate;
+  }, [invalidate]);
   const blocker = reactRouterDom.useBlocker(
     react.useCallback(() => {
+      const settle = begin();
       if (!shouldBlock) {
+        setBlockedAttempt(null);
         return false;
       }
       onBlock?.();
       if (!message) {
+        setBlockedAttempt({ kind: "denied", settle, scopeKey, message });
         return true;
       }
       const confirmation = resolveConfirmResult(
@@ -124,46 +135,58 @@ function useNavigationBlocker(options) {
         (value) => window.confirm(value)
       );
       if (confirmation.kind === "async") {
-        const id = ++confirmSeqRef.current;
-        setPendingConfirm({ id, promise: confirmation.promise });
+        setBlockedAttempt({
+          kind: "confirming",
+          settle,
+          promise: confirmation.promise.catch(() => false),
+          scopeKey,
+          message
+        });
         return true;
       }
-      if (confirmation.confirmed) {
+      if (confirmation.confirmed && settle()) {
+        setBlockedAttempt(null);
         onAllow?.();
         return false;
       }
+      setBlockedAttempt({ kind: "denied", settle, scopeKey, message });
       return true;
-    }, [shouldBlock, message, onBlock, onConfirm, onAllow])
+    }, [shouldBlock, scopeKey, message, onBlock, onConfirm, onAllow, begin])
   );
   react.useEffect(() => {
-    if (!pendingConfirm) {
+    if (!blockedAttempt) {
+      return;
+    }
+    if (!shouldBlock || blockedAttempt.scopeKey !== scopeKey || blockedAttempt.message !== message) {
+      queueMicrotask(() => {
+        setBlockedAttempt((current) => current === blockedAttempt ? null : current);
+      });
+      if (blockedAttempt.settle()) {
+        blocker.reset?.();
+      }
+      return;
+    }
+    if (blockedAttempt.kind === "denied") {
       return;
     }
     let active = true;
-    const { id, promise } = pendingConfirm;
-    promise.then((confirmed) => {
-      if (!active || id !== confirmSeqRef.current) {
+    const { settle, promise } = blockedAttempt;
+    void promise.then((confirmed) => {
+      if (!active || !settle()) {
         return;
       }
+      setBlockedAttempt(null);
       if (confirmed) {
         onAllow?.();
         blocker.proceed?.();
       } else {
         blocker.reset?.();
       }
-    }).catch(() => {
-      if (active && id === confirmSeqRef.current) {
-        blocker.reset?.();
-      }
-    }).finally(() => {
-      if (active && id === confirmSeqRef.current) {
-        setPendingConfirm(null);
-      }
     });
     return () => {
       active = false;
     };
-  }, [pendingConfirm, blocker, onAllow]);
+  }, [blockedAttempt, blocker, onAllow, shouldBlock, scopeKey, message]);
   useBeforeUnload(blockBrowserUnload && shouldBlock, message ?? DEFAULT_UNLOAD_MESSAGE);
   return {
     isBlocking: shouldBlock,

package/dist/react-router/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/utils.ts","../../src/core/useBeforeUnload.ts","../../src/core/useShouldBlock.ts","../../src/react-router/useNavigationBlocker.ts","../../src/react-router/usePrompt.ts"],"names":["useEffect","useMemo","useIsBlocked","useRef","useState","useBlocker","useCallback"],"mappings":";;;;;;;;;AAMO,SAAS,iBAAiB,SAAA,EAA+C;AAC9E,EAAA,OAAO,OAAO,SAAA,KAAc,UAAA,GAAa,SAAA,EAAU,GAAI,SAAA;AACzD;AAMA,IAAM,OAAA,GAAU,CAAC,KAAA,KACf,OAAO,UAAU,QAAA,IAAY,KAAA,KAAU,QAAQ,MAAA,IAAU,KAAA;AAKpD,SAAS,WAAc,KAAA,EAAyC;AACrE,EAAA,IAAI,CAAC,OAAA,CAAQ,KAAK,CAAA,EAAG;AACnB,IAAA,OAAO,KAAA;AAAA,EACT;AACA,EAAA,OAAO,OAAO,MAAM,IAAA,KAAS,UAAA;AAC/B;AAiBO,SAAS,oBAAA,CACd,OAAA,EACA,SAAA,EACA,eAAA,EACe;AACf,EAAA,IAAI,CAAC,SAAA,EAAW;AACd,IAAA,OAAO,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAA,EAAW,eAAA,CAAgB,OAAO,CAAA,EAAE;AAAA,EAC7D;AAEA,EAAA,MAAM,MAAA,GAAS,UAAU,OAAO,CAAA;AAChC,EAAA,IAAI,UAAA,CAAoB,MAAM,CAAA,EAAG;AAC/B,IAAA,OAAO,EAAE,IAAA,EAAM,OAAA,EAAS,SAAS,OAAA,CAAQ,OAAA,CAAQ,MAAM,CAAA,EAAE;AAAA,EAC3D;AAEA,EAAA,OAAO,EAAE,IAAA,EAAM,MAAA,EAAQ,SAAA,EAAW,MAAA,EAAO;AAC3C;AAqBO,SAAS,UAAa,KAAA,EAAyC;AACpE,EAAA,OAAO,KAAA,KAAU,UAAa,KAAA,KAAU,IAAA;AAC1C;AAQO,SAAS,eAAe,KAAA,EAA0D;AACvF,EAAA,IAAI,CAAC,KAAA,EAAO;AACV,IAAA,OAAO,EAAC;AAAA,EACV;AACA,EAAA,OAAO,MAAM,OAAA,CAAQ,KAAK,CAAA,GAAI,KAAA,GAAQ,CAAC,KAAK,CAAA;AAC9C;;;ACvFO,IAAM,sBAAA,GAAyB,oCAAA;AAmC/B,SAAS,eAAA,CACd,IAAA,EACA,OAAA,GAAU,sBAAA,EACJ;AACN,EAAAA,eAAA,CAAU,MAAM;AACd,IAAA,MAAM,WAAA,GAAc,iBAAiB,IAAI,CAAA;AAEzC,IAAA,IAAI,CAAC,WAAA,EAAa;AAChB,MAAA;AAAA,IACF;AAEA,IAAA,MAAM,kBAAA,GAAqB,CAAC,KAAA,KAAmC;AAE7D,MAAA,KAAA,CAAM,cAAA,EAAe;AAGrB,MAAA,IAAI,iBAAiB,KAAA,EAAO;AAE1B,QAAA,KAAA,CAAM,WAAA,GAAc,OAAA;AAAA,MACtB;AAAA,IACF,CAAA;AAEA,IAAA,MAAA,CAAO,gBAAA,CAAiB,gBAAgB,kBAAkB,CAAA;AAE1D,IAAA,OAAO,MAAM;AACX,MAAA,MAAA,CAAO,mBAAA,CAAoB,gBAAgB,kBAAkB,CAAA;AAAA,IAC/D,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,IAAA,EAAM,OAAO,CAAC,CAAA;AACpB;ACpDO,SAAS,cAAA,CACd,MACA,KAAA,EACS;AAET,EAAA,MAAM,MAAA,GAASC,cAAQ,MAAM,cAAA,CAAe,KAAK,CAAA,EAAG,CAAC,KAAK,CAAC,CAAA;AAG3D,EAAA,MAAM,cAAA,GAAiBC,8BAAa,MAAA,CAAO,MAAA,KAAW,IAAI,MAAA,CAAO,CAAC,IAAI,MAAM,CAAA;AAG5E,EAAA,MAAM,yBAAA,GAA4BC,aAAO,KAAK,CAAA;AAC9C,EAAA,MAAM,iBAAA,GAAoBA,aAAO,KAAK,CAAA;AAEtC,EAAAH,gBAAU,MAAM;AACd,IAAA,IAAI,OAAA,CAAQ,GAAA,CAAI,QAAA,KAAa,aAAA,EAAe;AAC1C,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,CAAC,0BAA0B,OAAA,IAAW,CAAC,UAAU,IAAI,CAAA,IAAK,CAAC,KAAA,EAAO;AACpE,MAAA,yBAAA,CAA0B,OAAA,GAAU,IAAA;AACpC,MAAA,OAAA,CAAQ,IAAA;AAAA,QACN;AAAA,OAEF;AAAA,IACF;AAEA,IAAA,IAAI,CAAC,iBAAA,CAAkB,OAAA,IAAW,OAAO,SAAS,UAAA,EAAY;AAC5D,MAAA,iBAAA,CAAkB,OAAA,GAAU,IAAA;AAC5B,MAAA,OAAA,CAAQ,IAAA;AAAA,QACN;AAAA,OAEF;AAAA,IACF;AAAA,EACF,CAAA,EAAG,CAAC,IAAA,EAAM,KAAK,CAAC,CAAA;AAIhB,EAAA,MAAM,WAAA,GAAcC,cAAQ,MAAM;AAChC,IAAA,IAAI,cAAA,GAAiB,KAAA;AAGrB,IAAA,IAAI,SAAA,CAAU,IAAI,CAAA,EAAG;AACnB,MAAA,cAAA,GAAiB,iBAAiB,IAAI,CAAA;AAAA,IACxC;AAGA,IAAA,IAAI,SAAS,cAAA,EAAgB;AAC3B,MAAA,cAAA,GAAiB,IAAA;AAAA,IACnB;AAEA,IAAA,OAAO,cAAA;AAAA,EACT,CAAA,EAAG,CAAC,IAAA,EAAM,KAAA,EAAO,cAAc,CAAC,CAAA;AAEhC,EAAA,OAAO,WAAA;AACT;;;ACLO,SAAS,qBACd,OAAA,EACyB;AACzB,EAAA,MAAM;AAAA,IACJ,IAAA;AAAA,IACA,KAAA;AAAA,IACA,OAAA;AAAA,IACA,kBAAA,GAAqB,IAAA;AAAA;AAAA,IAErB,KAAA;AAAA;AAAA,IACA,OAAA;AAAA,IACA,OAAA;AAAA,IACA;AAAA,GACF,GAAI,OAAA;AAEJ,EAAA,MAAM,aAAA,GAAgBE,aAAO,CAAC,CAAA;AAC9B,EAAA,MAAM,CAAC,cAAA,EAAgB,iBAAiB,CAAA,GAAIC,eAGlC,IAAI,CAAA;AAGd,EAAA,MAAM,WAAA,GAAc,cAAA,CAAe,IAAA,IAAQ,KAAA,EAAO,KAAK,CAAA;AAGvD,EAAA,MAAM,OAAA,GAAUC,yBAAA;AAAA,IACdC,kBAAY,MAAM;AAEhB,MAAA,IAAI,CAAC,WAAA,EAAa;AAChB,QAAA,OAAO,KAAA;AAAA,MACT;AAGA,MAAA,OAAA,IAAU;AAGV,MAAA,IAAI,CAAC,OAAA,EAAS;AACZ,QAAA,OAAO,IAAA;AAAA,MACT;AAEA,MAAA,MAAM,YAAA,GAAe,oBAAA;AAAA,QAAqB,OAAA;AAAA,QAAS,SAAA;AAAA,QAAW,CAAC,KAAA,KAC7D,MAAA,CAAO,OAAA,CAAQ,KAAK;AAAA,OACtB;AAEA,MAAA,IAAI,YAAA,CAAa,SAAS,OAAA,EAAS;AACjC,QAAA,MAAM,EAAA,GAAK,EAAE,aAAA,CAAc,OAAA;AAC3B,QAAA,iBAAA,CAAkB,EAAE,EAAA,EAAI,OAAA,EAAS,YAAA,CAAa,SAAS,CAAA;AACvD,QAAA,OAAO,IAAA;AAAA,MACT;AAEA,MAAA,IAAI,aAAa,SAAA,EAAW;AAC1B,QAAA,OAAA,IAAU;AACV,QAAA,OAAO,KAAA;AAAA,MACT;AAEA,MAAA,OAAO,IAAA;AAAA,IACT,GAAG,CAAC,WAAA,EAAa,SAAS,OAAA,EAAS,SAAA,EAAW,OAAO,CAAC;AAAA,GACxD;AAEA,EAAAN,gBAAU,MAAM;AACd,IAAA,IAAI,CAAC,cAAA,EAAgB;AACnB,MAAA;AAAA,IACF;AAEA,IAAA,IAAI,MAAA,GAAS,IAAA;AACb,IAAA,MAAM,EAAE,EAAA,EAAI,OAAA,EAAQ,GAAI,cAAA;AAExB,IAAA,OAAA,CACG,IAAA,CAAK,CAAC,SAAA,KAAc;AACnB,MAAA,IAAI,CAAC,MAAA,IAAU,EAAA,KAAO,aAAA,CAAc,OAAA,EAAS;AAC3C,QAAA;AAAA,MACF;AACA,MAAA,IAAI,SAAA,EAAW;AACb,QAAA,OAAA,IAAU;AACV,QAAA,OAAA,CAAQ,OAAA,IAAU;AAAA,MACpB,CAAA,MAAO;AACL,QAAA,OAAA,CAAQ,KAAA,IAAQ;AAAA,MAClB;AAAA,IACF,CAAC,CAAA,CACA,KAAA,CAAM,MAAM;AACX,MAAA,IAAI,MAAA,IAAU,EAAA,KAAO,aAAA,CAAc,OAAA,EAAS;AAC1C,QAAA,OAAA,CAAQ,KAAA,IAAQ;AAAA,MAClB;AAAA,IACF,CAAC,CAAA,CACA,OAAA,CAAQ,MAAM;AACb,MAAA,IAAI,MAAA,IAAU,EAAA,KAAO,aAAA,CAAc,OAAA,EAAS;AAC1C,QAAA,iBAAA,CAAkB,IAAI,CAAA;AAAA,MACxB;AAAA,IACF,CAAC,CAAA;AAEH,IAAA,OAAO,MAAM;AACX,MAAA,MAAA,GAAS,KAAA;AAAA,IACX,CAAA;AAAA,EACF,CAAA,EAAG,CAAC,cAAA,EAAgB,OAAA,EAAS,OAAO,CAAC,CAAA;AAGrC,EAAA,eAAA,CAAgB,kBAAA,IAAsB,WAAA,EAAa,OAAA,IAAW,sBAAsB,CAAA;AAEpF,EAAA,OAAO;AAAA,IACL,UAAA,EAAY,WAAA;AAAA,IACZ,cAAA,EAAgB,QAAQ,KAAA,KAAU;AAAA,GACpC;AACF;;;AClIO,SAAS,SAAA,CAAU,SAAiB,IAAA,EAAuC;AAChF,EAAA,oBAAA,CAAqB;AAAA,IACnB,IAAA;AAAA,IACA,OAAA;AAAA,IACA,kBAAA,EAAoB;AAAA,GACrB,CAAA;AACH;AAeO,SAAS,qBAAqB,OAAA,EAAiC;AACpE,EAAA,oBAAA,CAAqB;AAAA,IACnB,GAAG,OAAA;AAAA,IACH,kBAAA,EAAoB,QAAQ,kBAAA,IAAsB;AAAA,GACnD,CAAA;AACH","file":"index.cjs","sourcesContent":["/**\n * Resolves a condition value (boolean or function returning boolean)\n *\n * @param condition - Boolean value or function\n * @returns Resolved boolean value\n */\nexport function resolveCondition(condition: boolean | (() => boolean)): boolean {\n  return typeof condition === \"function\" ? condition() : condition;\n}\n\ninterface Thenable {\n  then: (...args: Array<unknown>) => unknown;\n}\n\nconst hasThen = (value: unknown): value is Thenable =>\n  typeof value === \"object\" && value !== null && \"then\" in value;\n\n/**\n * Checks if a value behaves like a Promise (thenable)\n */\nexport function isThenable<T>(value: unknown): value is PromiseLike<T> {\n  if (!hasThen(value)) {\n    return false;\n  }\n  return typeof value.then === \"function\";\n}\n\nexport interface ConfirmResultSync {\n  kind: \"sync\";\n  confirmed: boolean;\n}\n\nexport interface ConfirmResultAsync {\n  kind: \"async\";\n  promise: Promise<boolean>;\n}\n\nexport type ConfirmResult = ConfirmResultSync | ConfirmResultAsync;\n\n/**\n * Normalizes custom confirm result into sync or async branch.\n */\nexport function resolveConfirmResult(\n  message: string,\n  onConfirm: ((message: string) => boolean | PromiseLike<boolean>) | undefined,\n  fallbackConfirm: (message: string) => boolean\n): ConfirmResult {\n  if (!onConfirm) {\n    return { kind: \"sync\", confirmed: fallbackConfirm(message) };\n  }\n\n  const result = onConfirm(message);\n  if (isThenable<boolean>(result)) {\n    return { kind: \"async\", promise: Promise.resolve(result) };\n  }\n\n  return { kind: \"sync\", confirmed: result };\n}\n\n/**\n * Generates a unique blocker ID based on scope and timestamp\n *\n * @param prefix - Prefix for the ID\n * @param scope - Optional scope\n * @returns Unique blocker ID\n */\nexport function createBlockerId(prefix: string, scope?: string | Array<string>): string {\n  const scopePart = scope ? `-${Array.isArray(scope) ? scope.join(\"-\") : scope}` : \"\";\n  const timestamp = String(Date.now());\n  return `${prefix}${scopePart}-${timestamp}`;\n}\n\n/**\n * Checks if a value is defined and not empty\n *\n * @param value - Value to check\n * @returns True if value is defined and not empty\n */\nexport function isDefined<T>(value: T | undefined | null): value is T {\n  return value !== undefined && value !== null;\n}\n\n/**\n * Normalizes scope to an array\n *\n * @param scope - String or array of strings\n * @returns Array of scope strings\n */\nexport function normalizeScope(scope: string | Array<string> | undefined): Array<string> {\n  if (!scope) {\n    return [];\n  }\n  return Array.isArray(scope) ? scope : [scope];\n}\n","import { useEffect } from \"react\";\nimport { resolveCondition } from \"./utils\";\n\n/**\n * Default message shown when preventing browser unload\n */\nexport const DEFAULT_UNLOAD_MESSAGE = \"Changes you made may not be saved.\";\n\n/**\n * Blocks browser tab close/refresh when condition is met.\n *\n * This hook adds a `beforeunload` event listener to warn users\n * before they close or refresh the browser tab. Modern browsers\n * may ignore custom messages and show their own generic warning.\n *\n * @param when - Boolean or function returning boolean to determine if blocking should be active\n * @param message - Optional custom message (may be ignored by browsers)\n *\n * @example\n * ```tsx\n * function MyForm() {\n *   const [hasUnsavedChanges, setHasUnsavedChanges] = useState(false);\n *\n *   useBeforeUnload(hasUnsavedChanges, 'You have unsaved changes');\n *\n *   return <form>...</form>;\n * }\n * ```\n *\n * @example\n * ```tsx\n * // With function condition\n * function EditPage() {\n *   const isFormDirty = useIsBlocked('form');\n *\n *   useBeforeUnload(() => isFormDirty);\n *\n *   return <div>...</div>;\n * }\n * ```\n */\nexport function useBeforeUnload(\n  when: boolean | (() => boolean),\n  message = DEFAULT_UNLOAD_MESSAGE\n): void {\n  useEffect(() => {\n    const shouldBlock = resolveCondition(when);\n\n    if (!shouldBlock) {\n      return;\n    }\n\n    const handleBeforeUnload = (event: BeforeUnloadEvent): void => {\n      // Prevent default to trigger the browser's confirmation dialog\n      event.preventDefault();\n\n      // Fallback for legacy browsers/WebViews that still rely on returnValue.\n      if (\"returnValue\" in event) {\n        // eslint-disable-next-line @typescript-eslint/no-deprecated\n        event.returnValue = message;\n      }\n    };\n\n    window.addEventListener(\"beforeunload\", handleBeforeUnload);\n\n    return () => {\n      window.removeEventListener(\"beforeunload\", handleBeforeUnload);\n    };\n  }, [when, message]);\n}\n","import { useIsBlocked } from \"@okyrychenko-dev/react-action-guard\";\nimport { useEffect, useMemo, useRef } from \"react\";\nimport { isDefined, normalizeScope, resolveCondition } from \"./utils\";\n\n/**\n * Shared hook to determine if blocking should be active based on\n * condition and/or scope state.\n *\n * This hook uses `useMemo` for optimal performance, ensuring blocking state\n * is computed synchronously without additional re-renders.\n *\n * @param when - Optional condition (boolean or function)\n * @param scope - Optional scope(s) to check\n * @returns Whether blocking should be active\n *\n * @internal\n */\nexport function useShouldBlock(\n  when?: boolean | (() => boolean),\n  scope?: string | Array<string>\n): boolean {\n  // Memoize scope normalization to avoid recalculation on every render\n  const scopes = useMemo(() => normalizeScope(scope), [scope]);\n\n  // Check if any specified scopes are blocked\n  const isScopeBlocked = useIsBlocked(scopes.length === 1 ? scopes[0] : scopes);\n\n  // Development-only validation\n  const warnedMissingConditionRef = useRef(false);\n  const warnedFunctionRef = useRef(false);\n\n  useEffect(() => {\n    if (process.env.NODE_ENV !== \"development\") {\n      return;\n    }\n\n    if (!warnedMissingConditionRef.current && !isDefined(when) && !scope) {\n      warnedMissingConditionRef.current = true;\n      console.warn(\n        '[react-action-guard-router] useShouldBlock: Neither \"when\" nor \"scope\" provided. ' +\n          \"This hook will always return false. Please provide at least one condition.\"\n      );\n    }\n\n    if (!warnedFunctionRef.current && typeof when === \"function\") {\n      warnedFunctionRef.current = true;\n      console.warn(\n        '[react-action-guard-router] useShouldBlock: \"when\" is a function. ' +\n          \"Make sure to wrap it with useCallback to avoid unnecessary re-computations.\"\n      );\n    }\n  }, [when, scope]);\n\n  // Compute blocking state synchronously using useMemo\n  // This avoids the useState + useEffect pattern which causes an extra render\n  const shouldBlock = useMemo(() => {\n    let blockCondition = false;\n\n    // Check manual condition\n    if (isDefined(when)) {\n      blockCondition = resolveCondition(when);\n    }\n\n    // Check scope-based blocking (OR logic - block if either condition is true)\n    if (scope && isScopeBlocked) {\n      blockCondition = true;\n    }\n\n    return blockCondition;\n  }, [when, scope, isScopeBlocked]);\n\n  return shouldBlock;\n}\n","import { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useBlocker } from \"react-router-dom\";\nimport {\n  DEFAULT_UNLOAD_MESSAGE,\n  resolveConfirmResult,\n  useBeforeUnload,\n  useShouldBlock,\n} from \"../core\";\nimport type { NavigationBlockerReturn } from \"../core/types\";\nimport type { UseNavigationBlockerOptions } from \"./types\";\n\n/**\n * Blocks navigation in React Router v6+ applications based on conditions or scope state.\n *\n * This hook integrates React Router's `useBlocker` with react-action-guard's scope system,\n * allowing you to prevent navigation when certain conditions are met or when specific\n * scopes are blocked.\n *\n * **Features:**\n * - Block navigation based on boolean condition or function\n * - Automatically block when react-action-guard scopes are active\n * - Support for browser `beforeunload` event (tab close/refresh)\n * - Customizable confirmation dialog configuration\n * - Callbacks for block/allow events\n *\n * @param options - Configuration options\n * @returns Object with `isBlocking` state\n *\n * @example\n * ```tsx\n * // Block based on scope\n * function EditForm() {\n *   useNavigationBlocker({\n *     scope: 'form',\n *     message: 'You have unsaved changes. Leave anyway?',\n *   });\n *\n *   return <form>...</form>;\n * }\n * ```\n *\n * @example\n * ```tsx\n * // Block based on condition\n * function UnsavedChanges() {\n *   const [hasChanges, setHasChanges] = useState(false);\n *\n *   useNavigationBlocker({\n *     when: hasChanges,\n *     message: 'Discard changes?',\n *     onBlock: () => console.log('Navigation blocked'),\n *   });\n * }\n * ```\n *\n * @example\n * ```tsx\n * // Block with custom dialog\n * function CheckoutFlow() {\n *   useNavigationBlocker({\n *     scope: 'checkout',\n *     message: 'Your items will still be in your cart.',\n *     blockBrowserUnload: true,\n *   });\n * }\n * ```\n */\nexport function useNavigationBlocker(\n  options: UseNavigationBlockerOptions\n): NavigationBlockerReturn {\n  const {\n    when,\n    scope,\n    message,\n    blockBrowserUnload = true,\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    block, // deprecated, for backwards compatibility\n    onBlock,\n    onAllow,\n    onConfirm,\n  } = options;\n\n  const confirmSeqRef = useRef(0);\n  const [pendingConfirm, setPendingConfirm] = useState<{\n    id: number;\n    promise: Promise<boolean>;\n  } | null>(null);\n\n  // Use shared logic to determine if blocking should be active\n  const shouldBlock = useShouldBlock(when ?? block, scope);\n\n  // Use React Router's blocker\n  const blocker = useBlocker(\n    useCallback(() => {\n      // Early return if not blocking\n      if (!shouldBlock) {\n        return false;\n      }\n\n      // Trigger onBlock callback\n      onBlock?.();\n\n      // If no message, just block\n      if (!message) {\n        return true;\n      }\n\n      const confirmation = resolveConfirmResult(message, onConfirm, (value) =>\n        window.confirm(value)\n      );\n\n      if (confirmation.kind === \"async\") {\n        const id = ++confirmSeqRef.current;\n        setPendingConfirm({ id, promise: confirmation.promise });\n        return true;\n      }\n\n      if (confirmation.confirmed) {\n        onAllow?.();\n        return false;\n      }\n\n      return true;\n    }, [shouldBlock, message, onBlock, onConfirm, onAllow])\n  );\n\n  useEffect(() => {\n    if (!pendingConfirm) {\n      return;\n    }\n\n    let active = true;\n    const { id, promise } = pendingConfirm;\n\n    promise\n      .then((confirmed) => {\n        if (!active || id !== confirmSeqRef.current) {\n          return;\n        }\n        if (confirmed) {\n          onAllow?.();\n          blocker.proceed?.();\n        } else {\n          blocker.reset?.();\n        }\n      })\n      .catch(() => {\n        if (active && id === confirmSeqRef.current) {\n          blocker.reset?.();\n        }\n      })\n      .finally(() => {\n        if (active && id === confirmSeqRef.current) {\n          setPendingConfirm(null);\n        }\n      });\n\n    return () => {\n      active = false;\n    };\n  }, [pendingConfirm, blocker, onAllow]);\n\n  // Also block browser unload if requested\n  useBeforeUnload(blockBrowserUnload && shouldBlock, message ?? DEFAULT_UNLOAD_MESSAGE);\n\n  return {\n    isBlocking: shouldBlock,\n    isIntercepting: blocker.state === \"blocked\",\n  };\n}\n","import { useNavigationBlocker } from \"./useNavigationBlocker\";\nimport type { UsePromptOptions } from \"./types\";\n\n/**\n * Simple prompt API similar to React Router v5's `usePrompt`.\n *\n * Shows a confirmation dialog when the user tries to navigate away\n * while the condition is true.\n *\n * This is a simpler API compared to `useNavigationBlocker` for cases\n * where you just want to show a prompt without advanced configuration.\n *\n * @param message - Message to show in confirmation dialog\n * @param when - Condition to determine when to show the prompt\n *\n * @example\n * ```tsx\n * function MyForm() {\n *   const [hasUnsavedChanges, setHasUnsavedChanges] = useState(false);\n *\n *   usePrompt(\n *     'You have unsaved changes. Are you sure you want to leave?',\n *     hasUnsavedChanges\n *   );\n *\n *   return <form>...</form>;\n * }\n * ```\n *\n * @example\n * ```tsx\n * // With function condition\n * function EditPage() {\n *   const isDirty = useFormDirty();\n *\n *   usePrompt('Discard unsaved changes?', () => isDirty);\n * }\n * ```\n */\nexport function usePrompt(message: string, when: boolean | (() => boolean)): void {\n  useNavigationBlocker({\n    when,\n    message,\n    blockBrowserUnload: true,\n  });\n}\n\n/**\n * Hook variant that accepts options object\n *\n * @param options - Prompt configuration\n *\n * @example\n * ```tsx\n * usePromptWithOptions({\n *   message: 'Leave without saving?',\n *   when: hasChanges\n * });\n * ```\n */\nexport function usePromptWithOptions(options: UsePromptOptions): void {\n  useNavigationBlocker({\n    ...options,\n    blockBrowserUnload: options.blockBrowserUnload ?? true,\n  });\n}\n"]}
+{"version":3,"sources":["../../src/core/utils.ts","../../src/core/useBeforeUnload.ts","../../src/core/useShouldBlock.ts","../../src/core/confirmationOwner.utils.ts","../../src/react-router/useNavigationBlocker.ts","../../src/react-router/usePrompt.ts"],"names":["isFunction","isObject","isArray","useEffect","useMemo","useIsBlocked","useRef","isDefined","useState","useBlocker","useCallback"],"mappings":"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","file":"index.cjs","sourcesContent":["import { isArray, isFunction, isObject } from \"@okyrychenko-dev/type-utils\";\nimport type { Optional } from \"@okyrychenko-dev/type-utils\";\n\n/**\n * Resolves a condition value (boolean or function returning boolean)\n *\n * @param condition - Boolean value or function\n * @returns Resolved boolean value\n */\nexport function resolveCondition(condition: boolean | (() => boolean)): boolean {\n  return isFunction(condition) ? condition() : condition;\n}\n\ninterface Thenable {\n  then: (...args: Array<unknown>) => unknown;\n}\n\nconst hasThen = (value: unknown): value is Thenable => isObject(value) && \"then\" in value;\n\n/**\n * Checks if a value behaves like a Promise (thenable)\n */\nexport function isThenable<T>(value: unknown): value is PromiseLike<T> {\n  if (!hasThen(value)) {\n    return false;\n  }\n\n  return isFunction(value.then);\n}\n\nexport interface ConfirmResultSync {\n  kind: \"sync\";\n  confirmed: boolean;\n}\n\nexport interface ConfirmResultAsync {\n  kind: \"async\";\n  promise: Promise<boolean>;\n}\n\nexport type ConfirmResult = ConfirmResultSync | ConfirmResultAsync;\n\n/**\n * Normalizes custom confirm result into sync or async branch.\n */\nexport function resolveConfirmResult(\n  message: string,\n  onConfirm: Optional<(message: string) => boolean | PromiseLike<boolean>>,\n  fallbackConfirm: (message: string) => boolean\n): ConfirmResult {\n  if (!onConfirm) {\n    return { kind: \"sync\", confirmed: fallbackConfirm(message) };\n  }\n\n  const result = onConfirm(message);\n\n  if (isThenable<boolean>(result)) {\n    return { kind: \"async\", promise: Promise.resolve(result) };\n  }\n\n  return { kind: \"sync\", confirmed: result };\n}\n\n/**\n * Generates a unique blocker ID based on scope and timestamp\n *\n * @param prefix - Prefix for the ID\n * @param scope - Optional scope\n * @returns Unique blocker ID\n */\nexport function createBlockerId(prefix: string, scope?: string | Array<string>): string {\n  const scopePart = scope ? `-${isArray(scope) ? scope.join(\"-\") : scope}` : \"\";\n  const timestamp = String(Date.now());\n\n  return `${prefix}${scopePart}-${timestamp}`;\n}\n\n/**\n * Checks if a value is defined and not empty\n *\n * @param value - Value to check\n * @returns True if value is defined and not empty\n */\nexport { isDefined } from \"@okyrychenko-dev/type-utils\";\n\n/**\n * Normalizes scope to an array\n *\n * @param scope - String or array of strings\n * @returns Array of scope strings\n */\nexport function normalizeScope(scope: Optional<string | Array<string>>): Array<string> {\n  if (!scope) {\n    return [];\n  }\n\n  return isArray(scope) ? scope : [scope];\n}\n\n/** Identifies protection independently of scope order and duplicate entries. */\nexport function createScopeKey(scope: Optional<string | Array<string>>): string {\n  return JSON.stringify([...new Set(normalizeScope(scope))].sort());\n}\n","import { useEffect } from \"react\";\nimport { resolveCondition } from \"./utils\";\n\n/**\n * Default message shown when preventing browser unload\n */\nexport const DEFAULT_UNLOAD_MESSAGE = \"Changes you made may not be saved.\";\n\n/**\n * Blocks browser tab close/refresh when condition is met.\n */\nexport function useBeforeUnload(\n  when: boolean | (() => boolean),\n  message = DEFAULT_UNLOAD_MESSAGE\n): void {\n  useEffect(() => {\n    const shouldBlock = resolveCondition(when);\n\n    if (!shouldBlock) {\n      return;\n    }\n\n    const handleBeforeUnload = (event: BeforeUnloadEvent): void => {\n      // Prevent default to trigger the browser's confirmation dialog\n      event.preventDefault();\n\n      // Fallback for legacy browsers/WebViews that still rely on returnValue.\n      if (\"returnValue\" in event) {\n        // eslint-disable-next-line @typescript-eslint/no-deprecated\n        event.returnValue = message;\n      }\n    };\n\n    window.addEventListener(\"beforeunload\", handleBeforeUnload);\n\n    return () => {\n      window.removeEventListener(\"beforeunload\", handleBeforeUnload);\n    };\n  }, [when, message]);\n}\n","import { useIsBlocked } from \"@okyrychenko-dev/react-action-guard\";\nimport { isDefined } from \"@okyrychenko-dev/type-utils\";\nimport { useEffect, useMemo, useRef } from \"react\";\nimport { normalizeScope, resolveCondition } from \"./utils\";\n\n/**\n * Shared hook to determine if blocking should be active based on\n * condition and/or scope state.\n *\n * Pure function conditions are evaluated synchronously on every render.\n * Mutating a ref alone does not trigger a render.\n *\n * @param when - Optional condition (boolean or function)\n * @param scope - Optional scope(s) to check\n * @returns Whether blocking should be active\n *\n * @internal\n */\nexport function useShouldBlock(\n  when?: boolean | (() => boolean),\n  scope?: string | Array<string>\n): boolean {\n  // Memoize scope normalization to avoid recalculation on every render\n  const scopes = useMemo(() => normalizeScope(scope), [scope]);\n\n  // Check if any specified scopes are blocked\n  const isScopeBlocked = useIsBlocked(scopes.length === 1 ? scopes[0] : scopes);\n\n  // Development-only validation\n  const warnedMissingConditionRef = useRef(false);\n\n  useEffect(() => {\n    if (process.env.NODE_ENV !== \"development\") {\n      return;\n    }\n\n    if (!warnedMissingConditionRef.current && !isDefined(when) && !scope) {\n      warnedMissingConditionRef.current = true;\n      console.warn(\n        '[react-action-guard-router] useShouldBlock: Neither \"when\" nor \"scope\" provided. ' +\n          \"This hook will always return false. Please provide at least one condition.\"\n      );\n    }\n  }, [when, scope]);\n\n  const blockCondition = isDefined(when) && resolveCondition(when);\n\n  return blockCondition || Boolean(scope && isScopeBlocked);\n}\n","import type { ConfirmationOwner } from \"./confirmationOwner.types\";\n\nexport function createConfirmationOwner(): ConfirmationOwner {\n  let currentAttempt = 0;\n\n  function invalidate(): void {\n    currentAttempt += 1;\n  }\n\n  function begin(): () => boolean {\n    const attempt = ++currentAttempt;\n\n    function settle(): boolean {\n      if (attempt !== currentAttempt) {\n        return false;\n      }\n      invalidate();\n\n      return true;\n    }\n\n    return settle;\n  }\n\n  return { begin, invalidate };\n}\n","import { useCallback, useEffect, useState } from \"react\";\nimport { useBlocker } from \"react-router-dom\";\nimport {\n  DEFAULT_UNLOAD_MESSAGE,\n  createConfirmationOwner,\n  createScopeKey,\n  resolveConfirmResult,\n  useBeforeUnload,\n  useShouldBlock,\n} from \"../core\";\nimport type { Nullable } from \"@okyrychenko-dev/type-utils\";\nimport type { NavigationBlockerReturn } from \"../core\";\nimport type { BlockedNavigationAttempt, UseNavigationBlockerOptions } from \"./types\";\n\n/**\n * Blocks navigation in React Router v6+ applications based on conditions or scope state.\n */\nexport function useNavigationBlocker(\n  options: UseNavigationBlockerOptions\n): NavigationBlockerReturn {\n  const {\n    when,\n    scope,\n    message,\n    blockBrowserUnload = true,\n    // eslint-disable-next-line @typescript-eslint/no-deprecated\n    block, // deprecated, for backwards compatibility\n    onBlock,\n    onAllow,\n    onConfirm,\n  } = options;\n\n  const [confirmationOwner] = useState(createConfirmationOwner);\n  const { begin, invalidate } = confirmationOwner;\n  const [blockedAttempt, setBlockedAttempt] = useState<Nullable<BlockedNavigationAttempt>>(null);\n\n  // Use shared logic to determine if blocking should be active\n  const shouldBlock = useShouldBlock(when ?? block, scope);\n\n  const scopeKey = createScopeKey(scope);\n\n  useEffect(() => {\n    return invalidate;\n  }, [invalidate]);\n\n  // Use React Router's blocker\n  const blocker = useBlocker(\n    useCallback(() => {\n      const settle = begin();\n\n      // Early return if not blocking\n      if (!shouldBlock) {\n        setBlockedAttempt(null);\n\n        return false;\n      }\n\n      // Trigger onBlock callback\n      onBlock?.();\n\n      // If no message, just block\n      if (!message) {\n        setBlockedAttempt({ kind: \"denied\", settle, scopeKey, message });\n\n        return true;\n      }\n\n      const confirmation = resolveConfirmResult(message, onConfirm, (value) =>\n        window.confirm(value)\n      );\n\n      if (confirmation.kind === \"async\") {\n        setBlockedAttempt({\n          kind: \"confirming\",\n          settle,\n          promise: confirmation.promise.catch(() => false),\n          scopeKey,\n          message,\n        });\n\n        return true;\n      }\n\n      if (confirmation.confirmed && settle()) {\n        setBlockedAttempt(null);\n        onAllow?.();\n\n        return false;\n      }\n\n      setBlockedAttempt({ kind: \"denied\", settle, scopeKey, message });\n\n      return true;\n    }, [shouldBlock, scopeKey, message, onBlock, onConfirm, onAllow, begin])\n  );\n\n  useEffect(() => {\n    if (!blockedAttempt) {\n      return;\n    }\n\n    // Compare protection values, not inline callback identities, before attaching completion.\n    if (\n      !shouldBlock ||\n      blockedAttempt.scopeKey !== scopeKey ||\n      blockedAttempt.message !== message\n    ) {\n      queueMicrotask(() => {\n        setBlockedAttempt((current) => (current === blockedAttempt ? null : current));\n      });\n\n      if (blockedAttempt.settle()) {\n        blocker.reset?.();\n      }\n\n      return;\n    }\n\n    if (blockedAttempt.kind === \"denied\") {\n      return;\n    }\n\n    let active = true;\n    const { settle, promise } = blockedAttempt;\n\n    void promise.then((confirmed) => {\n      if (!active || !settle()) {\n        return;\n      }\n\n      setBlockedAttempt(null);\n\n      if (confirmed) {\n        onAllow?.();\n        blocker.proceed?.();\n      } else {\n        blocker.reset?.();\n      }\n    });\n\n    return () => {\n      active = false;\n    };\n  }, [blockedAttempt, blocker, onAllow, shouldBlock, scopeKey, message]);\n\n  // Also block browser unload if requested\n  useBeforeUnload(blockBrowserUnload && shouldBlock, message ?? DEFAULT_UNLOAD_MESSAGE);\n\n  return {\n    isBlocking: shouldBlock,\n    isIntercepting: blocker.state === \"blocked\",\n  };\n}\n","import { useNavigationBlocker } from \"./useNavigationBlocker\";\nimport type { UsePromptOptions } from \"./types\";\n\n/**\n * Simple prompt API similar to React Router v5's `usePrompt`.\n */\nexport function usePrompt(message: string, when: boolean | (() => boolean)): void {\n  useNavigationBlocker({\n    when,\n    message,\n    blockBrowserUnload: true,\n  });\n}\n\n/**\n * Hook variant that accepts options object\n *\n * @param options - Prompt configuration\n *\n * @example\n * ```tsx\n * usePromptWithOptions({\n *   message: 'Leave without saving?',\n *   when: hasChanges\n * });\n * ```\n */\nexport function usePromptWithOptions(options: UsePromptOptions): void {\n  useNavigationBlocker({\n    ...options,\n    blockBrowserUnload: options.blockBrowserUnload ?? true,\n  });\n}\n"]}