clear-react-router 2.0.3 → 2.0.5

package/README.md

@@ -639,6 +639,15 @@ This also works for nested dynamic routes:
 await invalidate('/post/[id]/comment/[id]');
 ```
 
+#### Force revalidation
+By default only paths that already exist in the cache are revalidated.
+Pass `{ force: true }` to also revalidate the exact path(s) you passed, even if they were never cached:
+
+```tsx
+await invalidate('/about', { force: true });
+await invalidate(['/about', '/post/10'], { force: true });
+```
+
 #### Including child routes
 
 To revalidate routes together with their cached child routes, pass the `withChildren` option:
@@ -691,7 +700,8 @@ Each object represents a revalidated route, where `path` is the route pathname,
 
 #### Notes
 
-* **Only routes that already have cached data are revalidated.**
+* Without `force` option, **only routes that already have cached data** are revalidated.
+* With `force: true`, the exact pathnames you pass are always revalidated (and stored in the cache).
 * Cached data is cleared before the new loader starts.
 * When used as an event handler, wrap the call in an arrow function:
 
@@ -729,6 +739,10 @@ useEffect(() => {
 }, [state, process, reset]);
 ```
 
+### `useIsDataLoading()`
+
+Returns a boolean indicating whether any route loader is currently fetching data. Useful for global loading indicators (progress bar, spinner in the layout, etc.).
+
 ### `useRouterContext()`
 
 Returns the router context object and a function to update it. Useful for accessing or modifying global state (like user authentication, theme, etc.) from anywhere in your app.

package/dist/hooks/useIsDataLoading.d.ts

@@ -0,0 +1 @@
+export declare const useIsDataLoading: () => boolean;

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export { useLoaderState } from './hooks/useLoaderState';
 export { useInvalidate } from './hooks/useInvalidate';
 export { useBlocker } from './hooks/useBlocker';
 export { useAction } from './hooks/useAction';
+export { useIsDataLoading } from './hooks/useIsDataLoading';
 export { useRouterContext } from './hooks/useRouterContext';
 export { useSearchParams } from './hooks/useSearchParams';
 export { useFormContext } from './hooks/useFormContext';

package/dist/index.js

@@ -385,9 +385,10 @@ var createInvalidate = ({ routeItemDataState, loaderStateRef, loaderMap, current
 	const invalidateItem = async (pathname, options) => {
 		const routeItem = findRoute(pathname);
 		if (!routeItem) return [];
-		const pathnameArray = [];
-		for (const [key] of loaderMap) if (comparePaths(routeItem, key)) pathnameArray.push(key);
-		const currentResults = await Promise.all(pathnameArray.map((pathname) => invalidatePath(routeItem, pathname, options)));
+		const pathnameSet = /* @__PURE__ */ new Set();
+		for (const [key] of loaderMap) if (comparePaths(routeItem, key)) pathnameSet.add(key);
+		if (options?.force) pathnameSet.add(pathname);
+		const currentResults = await Promise.all([...pathnameSet].map((pathname) => invalidatePath(routeItem, pathname, options)));
 		if (!options?.withChildren || !routeItem.children?.length) return currentResults;
 		const childResults = await Promise.all(routeItem.children.map((child) => invalidateItem(`${pathname}${child.path}`, options)));
 		return [...currentResults, ...childResults.flat()];
@@ -984,6 +985,13 @@ var useBlocker = (blockerFn) => {
 //#region hooks/useAction.ts
 var useAction = router.hooks.useAction;
 //#endregion
+//#region hooks/useIsDataLoading.ts
+var useIsDataLoading = () => {
+	const { usePendingState } = router.hooks;
+	const [pendingState] = usePendingState();
+	return Boolean(pendingState);
+};
+//#endregion
 //#region hooks/useRouterContext.ts
 var useRouterContext = () => {
 	const [context, setContext] = router.hooks.useContextState();
@@ -1061,4 +1069,4 @@ var lazy = (importFn) => ({
 	importFn
 });
 //#endregion
-export { Form, Link, Router, createRouter, lazy, useAction, useBlocker, useFormContext, useInvalidate, useLoaderState, useLocation, useNavigate, useParams, useRouterContext, useSearchParams };
+export { Form, Link, Router, createRouter, lazy, useAction, useBlocker, useFormContext, useInvalidate, useIsDataLoading, useLoaderState, useLocation, useNavigate, useParams, useRouterContext, useSearchParams };

package/dist/types.d.ts

@@ -157,6 +157,7 @@ export type RouterType = {
 export type InvalidateOptions = {
     withChildren?: boolean;
     withBeforeLoad?: boolean;
+    force?: boolean;
 };
 export type RevalidateCache = (args: RevalidateCacheArgs) => LoadingPromise;
 export type Options = Partial<{

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clear-react-router",
-  "version": "2.0.3",
+  "version": "2.0.5",
   "description": "A lightweight, type-safe routing library for React applications",
   "author": "Andrew Bubnov",
   "scripts": {