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

package/dist/tanstack-router/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/core/utils.ts","../../src/core/useBeforeUnload.ts","../../src/core/useShouldBlock.ts","../../src/tanstack-router/useNavigationBlocker.ts"],"names":["useEffect"],"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 { 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 { useRouter } from \"@tanstack/react-router\";\nimport { useEffect } from \"react\";\nimport {\n  DEFAULT_UNLOAD_MESSAGE,\n  resolveConfirmResult,\n  useBeforeUnload,\n  useShouldBlock,\n} from \"../core\";\nimport type { NavigationBlockerReturn } from \"../core/types\";\nimport type { SafeTanStackRouter, UseNavigationBlockerOptions } from \"./types\";\n\ninterface RetryableUpdate {\n  [key: string]: unknown;\n  retry: () => void;\n}\n\nconst hasBlockingHistory = (value: unknown): value is SafeTanStackRouter => {\n  if (!value || typeof value !== \"object\") {\n    return false;\n  }\n  if (!(\"history\" in value)) {\n    return false;\n  }\n  const history = value.history;\n  if (!history || typeof history !== \"object\") {\n    return false;\n  }\n  if (!(\"block\" in history)) {\n    return false;\n  }\n  return typeof history.block === \"function\";\n};\n\nconst hasRetry = (value: Record<string, unknown>): value is RetryableUpdate =>\n  typeof value.retry === \"function\";\n\nconst attemptRetry = (update: Record<string, unknown>): void => {\n  if (hasRetry(update)) {\n    try {\n      update.retry();\n    } catch {\n      // Swallow retry errors to avoid breaking blocking flow.\n    }\n  }\n};\n\n/**\n * Blocks navigation in TanStack Router applications based on conditions or scope state.\n *\n * This hook integrates with TanStack Router's history blocking mechanism 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 * **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 * @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 * // Type-safe with scopes\n * import { createTypedHooks } from '@okyrychenko-dev/react-action-guard';\n *\n * type AppScopes = 'global' | 'form' | 'checkout';\n * const { useBlocker } = createTypedHooks<AppScopes>();\n *\n * function MyComponent() {\n *   useBlocker('blocker-id', { scope: 'form' });\n *\n *   useNavigationBlocker({\n *     scope: 'form', // Type-safe!\n *     message: 'Leave?',\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\n  // Use shared logic to determine if blocking should be active\n  const shouldBlock = useShouldBlock(when, scope);\n\n  // Block navigation using TanStack Router's history\n  useEffect(() => {\n    if (!shouldBlock || !hasBlockingHistory(router)) {\n      return;\n    }\n\n    // Block navigation with properly typed update parameter\n    type NavigationUpdate = Record<string, unknown> & { retry?: () => void };\n    const unblock = router.history.block((update: NavigationUpdate) => {\n      // Early return if no message\n      if (!message) {\n        return;\n      }\n\n      // Trigger onBlock callback\n      onBlock?.();\n\n      const confirmation = resolveConfirmResult(message, onConfirm, (value) =>\n        window.confirm(value)\n      );\n\n      if (confirmation.kind === \"async\") {\n        confirmation.promise\n          .then((confirmed) => {\n            if (confirmed) {\n              onAllow?.();\n              unblock();\n              attemptRetry(update);\n            }\n          })\n          .catch((error: unknown) => {\n            // On error, unblock but don't retry\n            unblock();\n            if (process.env.NODE_ENV !== \"production\") {\n              console.error(\"[react-action-guard-router] Confirmation error:\", error);\n            }\n          });\n        return;\n      }\n\n      if (confirmation.confirmed) {\n        onAllow?.();\n        unblock();\n        attemptRetry(update);\n      }\n    });\n\n    return () => {\n      unblock();\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"]}
+{"version":3,"sources":["../../src/core/utils.ts","../../src/core/useShouldBlock.ts","../../src/core/confirmationOwner.utils.ts","../../src/tanstack-router/useNavigationBlocker.ts"],"names":["isDefined","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 { 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 { useBlocker } from \"@tanstack/react-router\";\nimport { useCallback, useEffect, useState } from \"react\";\nimport {\n  createConfirmationOwner,\n  createScopeKey,\n  resolveConfirmResult,\n  useShouldBlock,\n} from \"../core\";\nimport type { NavigationBlockerReturn } from \"../core\";\nimport type { UseNavigationBlockerOptions } from \"./types\";\n\n/** Blocks native TanStack transitions while retaining protection after confirmation. */\nexport function useNavigationBlocker(\n  options: UseNavigationBlockerOptions\n): NavigationBlockerReturn {\n  const { when, scope, message, onBlock, onAllow, blockBrowserUnload = true, onConfirm } = options;\n\n  const shouldBlock = useShouldBlock(when, scope);\n  const scopeKey = createScopeKey(scope);\n  const [confirmationOwner] = useState(createConfirmationOwner);\n\n  const { begin, invalidate } = confirmationOwner;\n\n  useEffect(() => {\n    return invalidate;\n  }, [when, scopeKey, shouldBlock, message, onConfirm, invalidate]);\n\n  const shouldBlockFn = useCallback(async () => {\n    const settle = begin();\n\n    onBlock?.();\n\n    if (!message) {\n      return true;\n    }\n\n    try {\n      const confirmation = resolveConfirmResult(message, onConfirm, (value) =>\n        window.confirm(value)\n      );\n      let confirmed: boolean;\n\n      if (confirmation.kind === \"async\") {\n        confirmed = await confirmation.promise;\n      } else {\n        confirmed = confirmation.confirmed;\n      }\n\n      if (!settle() || !confirmed) {\n        return true;\n      }\n\n      onAllow?.();\n\n      return false;\n    } catch {\n      return true;\n    }\n  }, [message, onBlock, onAllow, onConfirm, begin]);\n\n  useBlocker({\n    shouldBlockFn,\n    enableBeforeUnload: blockBrowserUnload && shouldBlock,\n    disabled: !shouldBlock,\n  });\n\n  return { isBlocking: shouldBlock };\n}\n"]}

package/dist/{types-C3CPuZip.d.cts → types-xxRwsJ1N.d.cts}

@@ -35,41 +35,6 @@ interface BaseNavigationBlockerOptions {
     blockBrowserUnload?: boolean;
     /**
      * Custom confirmation handler for showing your own dialog UI.
-     *
-     * If provided, this will be called instead of window.confirm() to allow
-     * custom dialog components. Async handlers are supported, but note:
-     * - Next.js Pages Router re-attempts navigation after resolve.
-     * - Router adapters may ignore stale resolves if a newer confirm starts.
-     *
-     * @param message - The confirmation message to display
-     * @returns boolean | Promise<boolean> - true to allow navigation, false to block
-     *
-     * @example
-     * ```tsx
-     * // With custom dialog component
-     * const [dialogState, setDialogState] = useState(null);
-     *
-     * onConfirm: (message) => {
-     *   return new Promise((resolve) => {
-     *     setDialogState({ message, resolve });
-     *   });
-     * }
-     *
-     * // In JSX:
-     * {dialogState && (
-     *   <CustomDialog
-     *     message={dialogState.message}
-     *     onConfirm={() => {
-     *       dialogState.resolve(true);
-     *       setDialogState(null);
-     *     }}
-     *     onCancel={() => {
-     *       dialogState.resolve(false);
-     *       setDialogState(null);
-     *     }}
-     *   />
-     * )}
-     * ```
      */
     onConfirm?: (message: string) => boolean | PromiseLike<boolean>;
 }

package/dist/{types-C3CPuZip.d.ts → types-xxRwsJ1N.d.ts}

@@ -35,41 +35,6 @@ interface BaseNavigationBlockerOptions {
     blockBrowserUnload?: boolean;
     /**
      * Custom confirmation handler for showing your own dialog UI.
-     *
-     * If provided, this will be called instead of window.confirm() to allow
-     * custom dialog components. Async handlers are supported, but note:
-     * - Next.js Pages Router re-attempts navigation after resolve.
-     * - Router adapters may ignore stale resolves if a newer confirm starts.
-     *
-     * @param message - The confirmation message to display
-     * @returns boolean | Promise<boolean> - true to allow navigation, false to block
-     *
-     * @example
-     * ```tsx
-     * // With custom dialog component
-     * const [dialogState, setDialogState] = useState(null);
-     *
-     * onConfirm: (message) => {
-     *   return new Promise((resolve) => {
-     *     setDialogState({ message, resolve });
-     *   });
-     * }
-     *
-     * // In JSX:
-     * {dialogState && (
-     *   <CustomDialog
-     *     message={dialogState.message}
-     *     onConfirm={() => {
-     *       dialogState.resolve(true);
-     *       setDialogState(null);
-     *     }}
-     *     onCancel={() => {
-     *       dialogState.resolve(false);
-     *       setDialogState(null);
-     *     }}
-     *   />
-     * )}
-     * ```
      */
     onConfirm?: (message: string) => boolean | PromiseLike<boolean>;
 }

package/package.json

@@ -1,57 +1,63 @@
 {
   "name": "@okyrychenko-dev/react-action-guard-router",
-  "version": "0.2.3",
+  "version": "1.0.0",
   "type": "module",
   "description": "Navigation blocking adapters for React Action Guard across React Router, TanStack Router, and Next.js",
+  "engines": {
+    "node": ">=20"
+  },
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
     },
     "./react-router": {
-      "types": "./dist/react-router/index.d.ts",
-      "import": "./dist/react-router/index.js",
-      "require": "./dist/react-router/index.cjs"
+      "import": {
+        "types": "./dist/react-router/index.d.ts",
+        "default": "./dist/react-router/index.js"
+      },
+      "require": {
+        "types": "./dist/react-router/index.d.cts",
+        "default": "./dist/react-router/index.cjs"
+      }
     },
     "./tanstack-router": {
-      "types": "./dist/tanstack-router/index.d.ts",
-      "import": "./dist/tanstack-router/index.js",
-      "require": "./dist/tanstack-router/index.cjs"
+      "import": {
+        "types": "./dist/tanstack-router/index.d.ts",
+        "default": "./dist/tanstack-router/index.js"
+      },
+      "require": {
+        "types": "./dist/tanstack-router/index.d.cts",
+        "default": "./dist/tanstack-router/index.cjs"
+      }
     },
     "./nextjs": {
-      "types": "./dist/nextjs/index.d.ts",
-      "import": "./dist/nextjs/index.js",
-      "require": "./dist/nextjs/index.cjs"
+      "import": {
+        "types": "./dist/nextjs/index.d.ts",
+        "default": "./dist/nextjs/index.js"
+      },
+      "require": {
+        "types": "./dist/nextjs/index.d.cts",
+        "default": "./dist/nextjs/index.cjs"
+      }
     }
   },
   "sideEffects": false,
   "files": [
     "dist",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "clean": "rm -rf dist",
-    "prepublishOnly": "npm run clean && npm run build",
-    "typecheck": "tsc --noEmit",
-    "lint": "eslint src --ext .ts,.tsx",
-    "lint:fix": "eslint src --ext .ts,.tsx --fix",
-    "format": "npm run lint:fix && prettier --write \"src/**/*.{ts,tsx}\"",
-    "format:check": "npm run lint && prettier --check \"src/**/*.{ts,tsx}\"",
-    "test": "vitest",
-    "test:ui": "vitest --ui",
-    "test:run": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "prepare": "husky",
-    "storybook": "storybook dev -p 6007",
-    "build-storybook": "storybook build"
-  },
   "keywords": [
     "react",
     "router",
@@ -68,21 +74,22 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/okyrychenko-dev/react-action-guard-router"
+    "url": "git+https://github.com/okyrychenko-dev/react-action-guard.git",
+    "directory": "packages/router"
   },
   "bugs": {
-    "url": "https://github.com/okyrychenko-dev/react-action-guard-router/issues"
+    "url": "https://github.com/okyrychenko-dev/react-action-guard/issues"
   },
-  "homepage": "https://github.com/okyrychenko-dev/react-action-guard-router#readme",
+  "homepage": "https://github.com/okyrychenko-dev/react-action-guard/tree/main/packages/router#readme",
   "publishConfig": {
     "access": "public"
   },
   "peerDependencies": {
-    "@okyrychenko-dev/react-action-guard": "^1.0.3",
-    "@tanstack/react-router": "^1.0.0",
+    "@okyrychenko-dev/react-action-guard": "^2.0.0",
+    "@tanstack/react-router": "^1.170.41",
     "next": "^13.4.0 || ^14.0.0 || ^15.0.0",
     "react": "^18.0.0 || ^19.0.0",
-    "react-router-dom": "^6.0.0 || ^7.0.0"
+    "react-router-dom": "^6.19.0 || ^7.0.0"
   },
   "peerDependenciesMeta": {
     "react-router-dom": {
@@ -95,46 +102,53 @@
       "optional": true
     }
   },
-  "overrides": {
-    "@okyrychenko-dev/react-zustand-toolkit": "^0.4.0",
-    "postcss": ">=8.5.10"
-  },
   "devDependencies": {
-    "@eslint/js": "^9.39.1",
-    "@okyrychenko-dev/react-action-guard": "^1.0.3",
-    "@storybook/addon-a11y": "10.0.8",
-    "@storybook/addon-docs": "10.0.8",
-    "@storybook/react-vite": "10.0.8",
-    "@tanstack/react-router": "^1.94.4",
+    "@okyrychenko-dev/react-action-guard": "2.0.0",
+    "@playwright/test": "^1.63.0",
+    "@storybook/addon-a11y": "^10.3.6",
+    "@storybook/addon-docs": "^10.3.6",
+    "@storybook/react-vite": "^10.3.6",
+    "@tanstack/react-router": "^1.170.41",
     "@testing-library/dom": "^10.4.1",
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.0",
     "@types/node": "^24.10.4",
     "@types/react": "^19.2.5",
-    "@typescript-eslint/eslint-plugin": "^8.46.4",
-    "@typescript-eslint/parser": "^8.46.4",
-    "@vitest/coverage-v8": "^4.0.9",
-    "@vitest/ui": "^4.0.9",
+    "@types/react-dom": "~19.2.7",
     "clsx": "^2.1.1",
-    "eslint": "^9.39.1",
-    "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-react": "^7.37.5",
-    "eslint-plugin-react-hooks": "^7.0.1",
-    "eslint-plugin-storybook": "10.0.8",
-    "happy-dom": "^20.0.10",
-    "husky": "^9.1.7",
+    "eslint-plugin-storybook": "^10.3.6",
     "next": "^15.1.6",
-    "prettier": "^3.6.2",
     "react": "^19.2.0",
     "react-dom": "^19.2.0",
-    "react-router-dom": "^7.1.3",
+    "react-router-dom": "7.14.2",
     "remark-gfm": "^4.0.1",
     "storybook": "^10.3.6",
-    "tsup": "^8.5.1",
-    "typescript": "^5.3.3",
-    "typescript-eslint": "^8.46.4",
-    "vitest": "^4.0.9",
+    "vite": "8.2.1",
     "zustand": "^5.0.8"
+  },
+  "allowScripts": {
+    "esbuild@0.27.2": true,
+    "sharp@0.34.5": true
+  },
+  "dependencies": {
+    "@okyrychenko-dev/type-utils": "^0.1.2"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit -p tsconfig.typecheck.json",
+    "lint": "eslint src browser --ext .ts,.tsx",
+    "lint:fix": "eslint src browser --ext .ts,.tsx --fix",
+    "format": "prettier --write \"src/**/*.{ts,tsx}\" \"browser/**/*.{ts,tsx,html,md}\" playwright.config.ts",
+    "format:check": "prettier --check \"src/**/*.{ts,tsx}\" \"browser/**/*.{ts,tsx,html,md}\" playwright.config.ts",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:run": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "storybook": "storybook dev -p 6007",
+    "build-storybook": "storybook build",
+    "browser:serve": "vite browser --host 127.0.0.1 --port 4173 --strictPort",
+    "test:browser": "playwright test"
   }
-}
+}