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

package/dist/index.cjs

@@ -1,26 +1,22 @@
 'use strict';
 
 var react = require('react');
+var typeUtils = require('@okyrychenko-dev/type-utils');
 
 // src/core/useBeforeUnload.ts
-
-// src/core/utils.ts
 function resolveCondition(condition) {
-  return typeof condition === "function" ? condition() : condition;
+  return typeUtils.isFunction(condition) ? condition() : condition;
 }
 function createBlockerId(prefix, scope) {
-  const scopePart = scope ? `-${Array.isArray(scope) ? scope.join("-") : scope}` : "";
+  const scopePart = scope ? `-${typeUtils.isArray(scope) ? scope.join("-") : scope}` : "";
   const timestamp = String(Date.now());
   return `${prefix}${scopePart}-${timestamp}`;
 }
-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];
 }
 
 // src/core/useBeforeUnload.ts
@@ -46,26 +42,40 @@ function useBeforeUnload(when, message = DEFAULT_UNLOAD_MESSAGE) {
 function useDialogState() {
   const [dialogState, setDialogState] = react.useState(null);
   const resolveRef = react.useRef(null);
+  const mountedRef = react.useRef(true);
+  react.useEffect(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+      resolveRef.current?.(false);
+    };
+  }, []);
   const confirm = react.useCallback((message) => {
+    if (!mountedRef.current) {
+      return Promise.resolve(false);
+    }
     return new Promise((resolve) => {
       if (resolveRef.current) {
         resolveRef.current(false);
       }
-      resolveRef.current = resolve;
+      const settle = (confirmed) => {
+        if (resolveRef.current !== settle) {
+          return;
+        }
+        resolveRef.current = null;
+        resolve(confirmed);
+        setDialogState(null);
+      };
+      resolveRef.current = settle;
       setDialogState({
         isOpen: true,
         message,
-        resolve
+        resolve: settle
       });
     });
   }, []);
   const closeDialog = react.useCallback((confirmed) => {
-    const resolve = resolveRef.current;
-    if (resolve) {
-      resolve(confirmed);
-    }
-    resolveRef.current = null;
-    setDialogState(null);
+    resolveRef.current?.(confirmed);
   }, []);
   const onConfirm = react.useCallback(() => {
     closeDialog(true);
@@ -81,8 +91,11 @@ function useDialogState() {
   };
 }
 
+Object.defineProperty(exports, "isDefined", {
+  enumerable: true,
+  get: function () { return typeUtils.isDefined; }
+});
 exports.createBlockerId = createBlockerId;
-exports.isDefined = isDefined;
 exports.normalizeScope = normalizeScope;
 exports.resolveCondition = resolveCondition;
 exports.useBeforeUnload = useBeforeUnload;

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/utils.ts","../src/core/useBeforeUnload.ts","../src/core/useDialogState.ts"],"names":["useEffect","useState","useRef","useCallback"],"mappings":"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","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 { useCallback, useRef, useState } from \"react\";\n\n/**\n * State object for a confirmation dialog\n */\nexport interface DialogState<T = string> {\n  /** Whether the dialog is currently open */\n  isOpen: boolean;\n\n  /** The data to display in the dialog (typically a message) */\n  message: T;\n\n  /** Resolver function to confirm/cancel navigation */\n  resolve: (confirmed: boolean) => void;\n}\n\n/**\n * Return type for useDialogState hook\n */\nexport interface UseDialogStateReturn<T = string> {\n  /** Current dialog state (null when closed) */\n  dialogState: DialogState<T> | null;\n\n  /**\n   * Function to use as onConfirm callback.\n   * Returns a Promise that resolves when user confirms/cancels.\n   */\n  confirm: (message: T) => Promise<boolean>;\n\n  /** Close dialog with confirmation (allows navigation) */\n  onConfirm: () => void;\n\n  /** Close dialog with cancellation (blocks navigation) */\n  onCancel: () => void;\n}\n\n/**\n * Hook to manage custom confirmation dialog state.\n *\n * Simplifies integration with custom dialog components when using\n * navigation blocking with `onConfirm` callback.\n *\n * @template T - Type of message/data to pass to dialog (defaults to string)\n * @returns Object with dialog state and control functions\n *\n * @example\n * ```tsx\n * function MyForm() {\n *   const [isDirty, setIsDirty] = useState(false);\n *   const { dialogState, confirm, onConfirm, onCancel } = useDialogState();\n *\n *   useNavigationBlocker({\n *     when: isDirty,\n *     message: 'Unsaved changes',\n *     onConfirm: confirm,\n *   });\n *\n *   return (\n *     <>\n *       <form>...</form>\n *       {dialogState && (\n *         <ConfirmDialog\n *           message={dialogState.message}\n *           onConfirm={onConfirm}\n *           onCancel={onCancel}\n *         />\n *       )}\n *     </>\n *   );\n * }\n * ```\n *\n * @example\n * ```tsx\n * // With Material-UI\n * import { Dialog, DialogTitle, DialogActions, Button } from '@mui/material';\n *\n * function EditPage() {\n *   const { dialogState, confirm, onConfirm, onCancel } = useDialogState();\n *\n *   useNavigationBlocker({\n *     when: hasChanges,\n *     onConfirm: confirm,\n *   });\n *\n *   return (\n *     <Dialog open={dialogState?.isOpen ?? false}>\n *       <DialogTitle>{dialogState?.message}</DialogTitle>\n *       <DialogActions>\n *         <Button onClick={onCancel}>Stay</Button>\n *         <Button onClick={onConfirm}>Leave</Button>\n *       </DialogActions>\n *     </Dialog>\n *   );\n * }\n * ```\n */\nexport function useDialogState<T = string>(): UseDialogStateReturn<T> {\n  const [dialogState, setDialogState] = useState<DialogState<T> | null>(null);\n  const resolveRef = useRef<DialogState<T>[\"resolve\"] | null>(null);\n\n  const confirm = useCallback((message: T): Promise<boolean> => {\n    return new Promise<boolean>((resolve) => {\n      if (resolveRef.current) {\n        resolveRef.current(false);\n      }\n      resolveRef.current = resolve;\n      setDialogState({\n        isOpen: true,\n        message,\n        resolve,\n      });\n    });\n  }, []);\n\n  const closeDialog = useCallback((confirmed: boolean) => {\n    const resolve = resolveRef.current;\n    if (resolve) {\n      resolve(confirmed);\n    }\n    resolveRef.current = null;\n    setDialogState(null);\n  }, []);\n\n  const onConfirm = useCallback(() => {\n    closeDialog(true);\n  }, [closeDialog]);\n\n  const onCancel = useCallback(() => {\n    closeDialog(false);\n  }, [closeDialog]);\n\n  return {\n    dialogState,\n    confirm,\n    onConfirm,\n    onCancel,\n  };\n}\n"]}
+{"version":3,"sources":["../src/core/utils.ts","../src/core/useBeforeUnload.ts","../src/core/useDialogState.ts"],"names":["isFunction","isArray","useEffect","useState","useRef","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 { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { Nullable } from \"@okyrychenko-dev/type-utils\";\n\n/**\n * State object for a confirmation dialog\n */\nexport interface DialogState<T = string> {\n  /** Whether the dialog is currently open */\n  isOpen: boolean;\n\n  /** The data to display in the dialog (typically a message) */\n  message: T;\n\n  /** Settle and close this dialog; repeated or stale calls have no effect */\n  resolve: (confirmed: boolean) => void;\n}\n\n/**\n * Return type for useDialogState hook\n */\nexport interface UseDialogStateReturn<T = string> {\n  /** Current dialog state (null when closed) */\n  dialogState: Nullable<DialogState<T>>;\n\n  /**\n   * Function to use as onConfirm callback.\n   * Resolves true on confirmation, false on cancellation, replacement or effect teardown.\n   */\n  confirm: (message: T) => Promise<boolean>;\n\n  /** Close dialog with confirmation (allows navigation) */\n  onConfirm: () => void;\n\n  /** Close dialog with cancellation (blocks navigation) */\n  onCancel: () => void;\n}\n\n/**\n * Hook to manage custom confirmation dialog state.\n */\nexport function useDialogState<T = string>(): UseDialogStateReturn<T> {\n  const [dialogState, setDialogState] = useState<Nullable<DialogState<T>>>(null);\n  const resolveRef = useRef<Nullable<DialogState<T>[\"resolve\"]>>(null);\n  const mountedRef = useRef(true);\n\n  useEffect(() => {\n    mountedRef.current = true;\n\n    return () => {\n      mountedRef.current = false;\n      resolveRef.current?.(false);\n    };\n  }, []);\n\n  const confirm = useCallback((message: T): Promise<boolean> => {\n    if (!mountedRef.current) {\n      return Promise.resolve(false);\n    }\n\n    return new Promise<boolean>((resolve) => {\n      if (resolveRef.current) {\n        resolveRef.current(false);\n      }\n\n      const settle = (confirmed: boolean): void => {\n        if (resolveRef.current !== settle) {\n          return;\n        }\n\n        resolveRef.current = null;\n        resolve(confirmed);\n\n        setDialogState(null);\n      };\n\n      resolveRef.current = settle;\n\n      setDialogState({\n        isOpen: true,\n        message,\n        resolve: settle,\n      });\n    });\n  }, []);\n\n  const closeDialog = useCallback((confirmed: boolean) => {\n    resolveRef.current?.(confirmed);\n  }, []);\n\n  const onConfirm = useCallback(() => {\n    closeDialog(true);\n  }, [closeDialog]);\n\n  const onCancel = useCallback(() => {\n    closeDialog(false);\n  }, [closeDialog]);\n\n  return {\n    dialogState,\n    confirm,\n    onConfirm,\n    onCancel,\n  };\n}\n"]}

package/dist/index.d.cts

@@ -1,37 +1,9 @@
-export { B as BaseNavigationBlockerOptions, a as BeforeUnloadOptions, N as NavigationBlockerReturn } from './types-C3CPuZip.cjs';
+import { Nullable, Optional } from '@okyrychenko-dev/type-utils';
+export { isDefined } from '@okyrychenko-dev/type-utils';
+export { B as BaseNavigationBlockerOptions, a as BeforeUnloadOptions, N as NavigationBlockerReturn } from './types-xxRwsJ1N.cjs';
 
 /**
  * Blocks browser tab close/refresh when condition is met.
- *
- * This hook adds a `beforeunload` event listener to warn users
- * before they close or refresh the browser tab. Modern browsers
- * may ignore custom messages and show their own generic warning.
- *
- * @param when - Boolean or function returning boolean to determine if blocking should be active
- * @param message - Optional custom message (may be ignored by browsers)
- *
- * @example
- * ```tsx
- * function MyForm() {
- *   const [hasUnsavedChanges, setHasUnsavedChanges] = useState(false);
- *
- *   useBeforeUnload(hasUnsavedChanges, 'You have unsaved changes');
- *
- *   return <form>...</form>;
- * }
- * ```
- *
- * @example
- * ```tsx
- * // With function condition
- * function EditPage() {
- *   const isFormDirty = useIsBlocked('form');
- *
- *   useBeforeUnload(() => isFormDirty);
- *
- *   return <div>...</div>;
- * }
- * ```
  */
 declare function useBeforeUnload(when: boolean | (() => boolean), message?: string): void;
 
@@ -43,7 +15,7 @@ interface DialogState<T = string> {
     isOpen: boolean;
     /** The data to display in the dialog (typically a message) */
     message: T;
-    /** Resolver function to confirm/cancel navigation */
+    /** Settle and close this dialog; repeated or stale calls have no effect */
     resolve: (confirmed: boolean) => void;
 }
 /**
@@ -51,10 +23,10 @@ interface DialogState<T = string> {
  */
 interface UseDialogStateReturn<T = string> {
     /** Current dialog state (null when closed) */
-    dialogState: DialogState<T> | null;
+    dialogState: Nullable<DialogState<T>>;
     /**
      * Function to use as onConfirm callback.
-     * Returns a Promise that resolves when user confirms/cancels.
+     * Resolves true on confirmation, false on cancellation, replacement or effect teardown.
      */
     confirm: (message: T) => Promise<boolean>;
     /** Close dialog with confirmation (allows navigation) */
@@ -64,64 +36,6 @@ interface UseDialogStateReturn<T = string> {
 }
 /**
  * Hook to manage custom confirmation dialog state.
- *
- * Simplifies integration with custom dialog components when using
- * navigation blocking with `onConfirm` callback.
- *
- * @template T - Type of message/data to pass to dialog (defaults to string)
- * @returns Object with dialog state and control functions
- *
- * @example
- * ```tsx
- * function MyForm() {
- *   const [isDirty, setIsDirty] = useState(false);
- *   const { dialogState, confirm, onConfirm, onCancel } = useDialogState();
- *
- *   useNavigationBlocker({
- *     when: isDirty,
- *     message: 'Unsaved changes',
- *     onConfirm: confirm,
- *   });
- *
- *   return (
- *     <>
- *       <form>...</form>
- *       {dialogState && (
- *         <ConfirmDialog
- *           message={dialogState.message}
- *           onConfirm={onConfirm}
- *           onCancel={onCancel}
- *         />
- *       )}
- *     </>
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // With Material-UI
- * import { Dialog, DialogTitle, DialogActions, Button } from '@mui/material';
- *
- * function EditPage() {
- *   const { dialogState, confirm, onConfirm, onCancel } = useDialogState();
- *
- *   useNavigationBlocker({
- *     when: hasChanges,
- *     onConfirm: confirm,
- *   });
- *
- *   return (
- *     <Dialog open={dialogState?.isOpen ?? false}>
- *       <DialogTitle>{dialogState?.message}</DialogTitle>
- *       <DialogActions>
- *         <Button onClick={onCancel}>Stay</Button>
- *         <Button onClick={onConfirm}>Leave</Button>
- *       </DialogActions>
- *     </Dialog>
- *   );
- * }
- * ```
  */
 declare function useDialogState<T = string>(): UseDialogStateReturn<T>;
 
@@ -140,19 +54,13 @@ declare function resolveCondition(condition: boolean | (() => boolean)): boolean
  * @returns Unique blocker ID
  */
 declare function createBlockerId(prefix: string, scope?: string | Array<string>): string;
-/**
- * Checks if a value is defined and not empty
- *
- * @param value - Value to check
- * @returns True if value is defined and not empty
- */
-declare function isDefined<T>(value: T | undefined | null): value is T;
+
 /**
  * Normalizes scope to an array
  *
  * @param scope - String or array of strings
  * @returns Array of scope strings
  */
-declare function normalizeScope(scope: string | Array<string> | undefined): Array<string>;
+declare function normalizeScope(scope: Optional<string | Array<string>>): Array<string>;
 
-export { type DialogState, type UseDialogStateReturn, createBlockerId, isDefined, normalizeScope, resolveCondition, useBeforeUnload, useDialogState };
+export { type DialogState, type UseDialogStateReturn, createBlockerId, normalizeScope, resolveCondition, useBeforeUnload, useDialogState };

package/dist/index.d.ts

@@ -1,37 +1,9 @@
-export { B as BaseNavigationBlockerOptions, a as BeforeUnloadOptions, N as NavigationBlockerReturn } from './types-C3CPuZip.js';
+import { Nullable, Optional } from '@okyrychenko-dev/type-utils';
+export { isDefined } from '@okyrychenko-dev/type-utils';
+export { B as BaseNavigationBlockerOptions, a as BeforeUnloadOptions, N as NavigationBlockerReturn } from './types-xxRwsJ1N.js';
 
 /**
  * Blocks browser tab close/refresh when condition is met.
- *
- * This hook adds a `beforeunload` event listener to warn users
- * before they close or refresh the browser tab. Modern browsers
- * may ignore custom messages and show their own generic warning.
- *
- * @param when - Boolean or function returning boolean to determine if blocking should be active
- * @param message - Optional custom message (may be ignored by browsers)
- *
- * @example
- * ```tsx
- * function MyForm() {
- *   const [hasUnsavedChanges, setHasUnsavedChanges] = useState(false);
- *
- *   useBeforeUnload(hasUnsavedChanges, 'You have unsaved changes');
- *
- *   return <form>...</form>;
- * }
- * ```
- *
- * @example
- * ```tsx
- * // With function condition
- * function EditPage() {
- *   const isFormDirty = useIsBlocked('form');
- *
- *   useBeforeUnload(() => isFormDirty);
- *
- *   return <div>...</div>;
- * }
- * ```
  */
 declare function useBeforeUnload(when: boolean | (() => boolean), message?: string): void;
 
@@ -43,7 +15,7 @@ interface DialogState<T = string> {
     isOpen: boolean;
     /** The data to display in the dialog (typically a message) */
     message: T;
-    /** Resolver function to confirm/cancel navigation */
+    /** Settle and close this dialog; repeated or stale calls have no effect */
     resolve: (confirmed: boolean) => void;
 }
 /**
@@ -51,10 +23,10 @@ interface DialogState<T = string> {
  */
 interface UseDialogStateReturn<T = string> {
     /** Current dialog state (null when closed) */
-    dialogState: DialogState<T> | null;
+    dialogState: Nullable<DialogState<T>>;
     /**
      * Function to use as onConfirm callback.
-     * Returns a Promise that resolves when user confirms/cancels.
+     * Resolves true on confirmation, false on cancellation, replacement or effect teardown.
      */
     confirm: (message: T) => Promise<boolean>;
     /** Close dialog with confirmation (allows navigation) */
@@ -64,64 +36,6 @@ interface UseDialogStateReturn<T = string> {
 }
 /**
  * Hook to manage custom confirmation dialog state.
- *
- * Simplifies integration with custom dialog components when using
- * navigation blocking with `onConfirm` callback.
- *
- * @template T - Type of message/data to pass to dialog (defaults to string)
- * @returns Object with dialog state and control functions
- *
- * @example
- * ```tsx
- * function MyForm() {
- *   const [isDirty, setIsDirty] = useState(false);
- *   const { dialogState, confirm, onConfirm, onCancel } = useDialogState();
- *
- *   useNavigationBlocker({
- *     when: isDirty,
- *     message: 'Unsaved changes',
- *     onConfirm: confirm,
- *   });
- *
- *   return (
- *     <>
- *       <form>...</form>
- *       {dialogState && (
- *         <ConfirmDialog
- *           message={dialogState.message}
- *           onConfirm={onConfirm}
- *           onCancel={onCancel}
- *         />
- *       )}
- *     </>
- *   );
- * }
- * ```
- *
- * @example
- * ```tsx
- * // With Material-UI
- * import { Dialog, DialogTitle, DialogActions, Button } from '@mui/material';
- *
- * function EditPage() {
- *   const { dialogState, confirm, onConfirm, onCancel } = useDialogState();
- *
- *   useNavigationBlocker({
- *     when: hasChanges,
- *     onConfirm: confirm,
- *   });
- *
- *   return (
- *     <Dialog open={dialogState?.isOpen ?? false}>
- *       <DialogTitle>{dialogState?.message}</DialogTitle>
- *       <DialogActions>
- *         <Button onClick={onCancel}>Stay</Button>
- *         <Button onClick={onConfirm}>Leave</Button>
- *       </DialogActions>
- *     </Dialog>
- *   );
- * }
- * ```
  */
 declare function useDialogState<T = string>(): UseDialogStateReturn<T>;
 
@@ -140,19 +54,13 @@ declare function resolveCondition(condition: boolean | (() => boolean)): boolean
  * @returns Unique blocker ID
  */
 declare function createBlockerId(prefix: string, scope?: string | Array<string>): string;
-/**
- * Checks if a value is defined and not empty
- *
- * @param value - Value to check
- * @returns True if value is defined and not empty
- */
-declare function isDefined<T>(value: T | undefined | null): value is T;
+
 /**
  * Normalizes scope to an array
  *
  * @param scope - String or array of strings
  * @returns Array of scope strings
  */
-declare function normalizeScope(scope: string | Array<string> | undefined): Array<string>;
+declare function normalizeScope(scope: Optional<string | Array<string>>): Array<string>;
 
-export { type DialogState, type UseDialogStateReturn, createBlockerId, isDefined, normalizeScope, resolveCondition, useBeforeUnload, useDialogState };
+export { type DialogState, type UseDialogStateReturn, createBlockerId, normalizeScope, resolveCondition, useBeforeUnload, useDialogState };

package/dist/index.js

@@ -1,24 +1,21 @@
 import { useEffect, useState, useRef, useCallback } from 'react';
+import { isFunction, isArray } from '@okyrychenko-dev/type-utils';
+export { isDefined } from '@okyrychenko-dev/type-utils';
 
 // src/core/useBeforeUnload.ts
-
-// src/core/utils.ts
 function resolveCondition(condition) {
-  return typeof condition === "function" ? condition() : condition;
+  return isFunction(condition) ? condition() : condition;
 }
 function createBlockerId(prefix, scope) {
-  const scopePart = scope ? `-${Array.isArray(scope) ? scope.join("-") : scope}` : "";
+  const scopePart = scope ? `-${isArray(scope) ? scope.join("-") : scope}` : "";
   const timestamp = String(Date.now());
   return `${prefix}${scopePart}-${timestamp}`;
 }
-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];
 }
 
 // src/core/useBeforeUnload.ts
@@ -44,26 +41,40 @@ function useBeforeUnload(when, message = DEFAULT_UNLOAD_MESSAGE) {
 function useDialogState() {
   const [dialogState, setDialogState] = useState(null);
   const resolveRef = useRef(null);
+  const mountedRef = useRef(true);
+  useEffect(() => {
+    mountedRef.current = true;
+    return () => {
+      mountedRef.current = false;
+      resolveRef.current?.(false);
+    };
+  }, []);
   const confirm = useCallback((message) => {
+    if (!mountedRef.current) {
+      return Promise.resolve(false);
+    }
     return new Promise((resolve) => {
       if (resolveRef.current) {
         resolveRef.current(false);
       }
-      resolveRef.current = resolve;
+      const settle = (confirmed) => {
+        if (resolveRef.current !== settle) {
+          return;
+        }
+        resolveRef.current = null;
+        resolve(confirmed);
+        setDialogState(null);
+      };
+      resolveRef.current = settle;
       setDialogState({
         isOpen: true,
         message,
-        resolve
+        resolve: settle
       });
     });
   }, []);
   const closeDialog = useCallback((confirmed) => {
-    const resolve = resolveRef.current;
-    if (resolve) {
-      resolve(confirmed);
-    }
-    resolveRef.current = null;
-    setDialogState(null);
+    resolveRef.current?.(confirmed);
   }, []);
   const onConfirm = useCallback(() => {
     closeDialog(true);
@@ -79,6 +90,6 @@ function useDialogState() {
   };
 }
 
-export { createBlockerId, isDefined, normalizeScope, resolveCondition, useBeforeUnload, useDialogState };
+export { createBlockerId, normalizeScope, resolveCondition, useBeforeUnload, useDialogState };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/core/utils.ts","../src/core/useBeforeUnload.ts","../src/core/useDialogState.ts"],"names":[],"mappings":"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","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 { useCallback, useRef, useState } from \"react\";\n\n/**\n * State object for a confirmation dialog\n */\nexport interface DialogState<T = string> {\n  /** Whether the dialog is currently open */\n  isOpen: boolean;\n\n  /** The data to display in the dialog (typically a message) */\n  message: T;\n\n  /** Resolver function to confirm/cancel navigation */\n  resolve: (confirmed: boolean) => void;\n}\n\n/**\n * Return type for useDialogState hook\n */\nexport interface UseDialogStateReturn<T = string> {\n  /** Current dialog state (null when closed) */\n  dialogState: DialogState<T> | null;\n\n  /**\n   * Function to use as onConfirm callback.\n   * Returns a Promise that resolves when user confirms/cancels.\n   */\n  confirm: (message: T) => Promise<boolean>;\n\n  /** Close dialog with confirmation (allows navigation) */\n  onConfirm: () => void;\n\n  /** Close dialog with cancellation (blocks navigation) */\n  onCancel: () => void;\n}\n\n/**\n * Hook to manage custom confirmation dialog state.\n *\n * Simplifies integration with custom dialog components when using\n * navigation blocking with `onConfirm` callback.\n *\n * @template T - Type of message/data to pass to dialog (defaults to string)\n * @returns Object with dialog state and control functions\n *\n * @example\n * ```tsx\n * function MyForm() {\n *   const [isDirty, setIsDirty] = useState(false);\n *   const { dialogState, confirm, onConfirm, onCancel } = useDialogState();\n *\n *   useNavigationBlocker({\n *     when: isDirty,\n *     message: 'Unsaved changes',\n *     onConfirm: confirm,\n *   });\n *\n *   return (\n *     <>\n *       <form>...</form>\n *       {dialogState && (\n *         <ConfirmDialog\n *           message={dialogState.message}\n *           onConfirm={onConfirm}\n *           onCancel={onCancel}\n *         />\n *       )}\n *     </>\n *   );\n * }\n * ```\n *\n * @example\n * ```tsx\n * // With Material-UI\n * import { Dialog, DialogTitle, DialogActions, Button } from '@mui/material';\n *\n * function EditPage() {\n *   const { dialogState, confirm, onConfirm, onCancel } = useDialogState();\n *\n *   useNavigationBlocker({\n *     when: hasChanges,\n *     onConfirm: confirm,\n *   });\n *\n *   return (\n *     <Dialog open={dialogState?.isOpen ?? false}>\n *       <DialogTitle>{dialogState?.message}</DialogTitle>\n *       <DialogActions>\n *         <Button onClick={onCancel}>Stay</Button>\n *         <Button onClick={onConfirm}>Leave</Button>\n *       </DialogActions>\n *     </Dialog>\n *   );\n * }\n * ```\n */\nexport function useDialogState<T = string>(): UseDialogStateReturn<T> {\n  const [dialogState, setDialogState] = useState<DialogState<T> | null>(null);\n  const resolveRef = useRef<DialogState<T>[\"resolve\"] | null>(null);\n\n  const confirm = useCallback((message: T): Promise<boolean> => {\n    return new Promise<boolean>((resolve) => {\n      if (resolveRef.current) {\n        resolveRef.current(false);\n      }\n      resolveRef.current = resolve;\n      setDialogState({\n        isOpen: true,\n        message,\n        resolve,\n      });\n    });\n  }, []);\n\n  const closeDialog = useCallback((confirmed: boolean) => {\n    const resolve = resolveRef.current;\n    if (resolve) {\n      resolve(confirmed);\n    }\n    resolveRef.current = null;\n    setDialogState(null);\n  }, []);\n\n  const onConfirm = useCallback(() => {\n    closeDialog(true);\n  }, [closeDialog]);\n\n  const onCancel = useCallback(() => {\n    closeDialog(false);\n  }, [closeDialog]);\n\n  return {\n    dialogState,\n    confirm,\n    onConfirm,\n    onCancel,\n  };\n}\n"]}
+{"version":3,"sources":["../src/core/utils.ts","../src/core/useBeforeUnload.ts","../src/core/useDialogState.ts"],"names":["useEffect"],"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 { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { Nullable } from \"@okyrychenko-dev/type-utils\";\n\n/**\n * State object for a confirmation dialog\n */\nexport interface DialogState<T = string> {\n  /** Whether the dialog is currently open */\n  isOpen: boolean;\n\n  /** The data to display in the dialog (typically a message) */\n  message: T;\n\n  /** Settle and close this dialog; repeated or stale calls have no effect */\n  resolve: (confirmed: boolean) => void;\n}\n\n/**\n * Return type for useDialogState hook\n */\nexport interface UseDialogStateReturn<T = string> {\n  /** Current dialog state (null when closed) */\n  dialogState: Nullable<DialogState<T>>;\n\n  /**\n   * Function to use as onConfirm callback.\n   * Resolves true on confirmation, false on cancellation, replacement or effect teardown.\n   */\n  confirm: (message: T) => Promise<boolean>;\n\n  /** Close dialog with confirmation (allows navigation) */\n  onConfirm: () => void;\n\n  /** Close dialog with cancellation (blocks navigation) */\n  onCancel: () => void;\n}\n\n/**\n * Hook to manage custom confirmation dialog state.\n */\nexport function useDialogState<T = string>(): UseDialogStateReturn<T> {\n  const [dialogState, setDialogState] = useState<Nullable<DialogState<T>>>(null);\n  const resolveRef = useRef<Nullable<DialogState<T>[\"resolve\"]>>(null);\n  const mountedRef = useRef(true);\n\n  useEffect(() => {\n    mountedRef.current = true;\n\n    return () => {\n      mountedRef.current = false;\n      resolveRef.current?.(false);\n    };\n  }, []);\n\n  const confirm = useCallback((message: T): Promise<boolean> => {\n    if (!mountedRef.current) {\n      return Promise.resolve(false);\n    }\n\n    return new Promise<boolean>((resolve) => {\n      if (resolveRef.current) {\n        resolveRef.current(false);\n      }\n\n      const settle = (confirmed: boolean): void => {\n        if (resolveRef.current !== settle) {\n          return;\n        }\n\n        resolveRef.current = null;\n        resolve(confirmed);\n\n        setDialogState(null);\n      };\n\n      resolveRef.current = settle;\n\n      setDialogState({\n        isOpen: true,\n        message,\n        resolve: settle,\n      });\n    });\n  }, []);\n\n  const closeDialog = useCallback((confirmed: boolean) => {\n    resolveRef.current?.(confirmed);\n  }, []);\n\n  const onConfirm = useCallback(() => {\n    closeDialog(true);\n  }, [closeDialog]);\n\n  const onCancel = useCallback(() => {\n    closeDialog(false);\n  }, [closeDialog]);\n\n  return {\n    dialogState,\n    confirm,\n    onConfirm,\n    onCancel,\n  };\n}\n"]}