clear-react-router 1.3.4 → 1.3.5

package/README.md

@@ -327,13 +327,25 @@ function ProductFilter() {
 
 **Key features:**
 
-- ✅ **Array support** — `getSearchParams` returns `string[]` when multiple values exist for the same key
-- ✅ **Functional updates** — Update parameters based on previous state without losing other params
-- ✅ **Type-safe** — Proper TypeScript support with overloads
-- ✅ **Stable reference** — `setSearchParams` reference is stable and safe to use in `useEffect`
+- **Array support** — `getSearchParams` returns `string[]` when multiple values exist for the same key
+- **Functional updates** — Update parameters based on previous state without losing other params
+- **Type-safe** — Proper TypeScript support with overloads
+- **Stable reference** — `setSearchParams` reference is stable and safe to use in `useEffect`
 
 > **Note:** `getSearchParams` returns `string` for single values, `string[]` for multiple values, and `''` if the key is not found.
 
+### `useHistoricalTrail()`
+
+Returns an array of pathnames representing the user's actual navigation history. Perfect for **history-based breadcrumbs** in dashboards, admin panels, multi-step forms, or any app where users navigate non-linearly.
+
+**Returns:** Array of pathnames in chronological visit order (e.g., `['/dashboard', '/users', '/settings']`)
+
+**Key features:**
+- **Chronological order** — Paths are stored in the order the user visited them
+- **Unique entries** — Revisiting a page trims the trail to that point
+- **Respects navigation blocking** — Only successful navigations are added
+- **Redirect-safe** — Redirected pages are not added to the trail
+
 ## Lazy Loading
 
 Clear Router supports code-splitting out of the box. Simply pass a function that returns a dynamic import:

package/dist/hooks/useHistoricalTrail.d.ts

@@ -0,0 +1 @@
+export declare const useHistoricalTrail: () => string[];

package/dist/index.d.ts

@@ -9,5 +9,6 @@ export { useBlocker } from './hooks/useBlocker';
 export { useBeforeUnload } from './hooks/useBeforeUnload';
 export { useRouterContext } from './hooks/useRouterContext';
 export { useSearchParams } from './hooks/useSearchParams';
+export { useHistoricalTrail } from './hooks/useHistoricalTrail';
 export { createRouter } from './utils/utils';
 export type { RouteItem, BlockerState, Location } from './types/global';

package/dist/index.js

@@ -642,4 +642,18 @@ var useSearchParams = () => {
 	};
 };
 //#endregion
-export { Link, Router, RouterProvider, createRouter, useBeforeUnload, useBlocker, useLoaderState, useLocation, useNavigate, useParams, useRouterContext, useSearchParams };
+//#region hooks/useHistoricalTrail.ts
+var useHistoricalTrail = () => {
+	const { pathname } = useLocation();
+	const [trail, setTrail] = useState([]);
+	useEffect(() => {
+		if (!pathname) return;
+		setTrail((prevState) => {
+			const index = prevState.indexOf(pathname);
+			return index === -1 ? [...prevState, pathname] : prevState.slice(0, index + 1);
+		});
+	}, [pathname]);
+	return trail;
+};
+//#endregion
+export { Link, Router, RouterProvider, createRouter, useBeforeUnload, useBlocker, useHistoricalTrail, useLoaderState, useLocation, useNavigate, useParams, useRouterContext, useSearchParams };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clear-react-router",
-  "version": "1.3.4",
+  "version": "1.3.5",
   "description": "A lightweight, type-safe routing library for React applications",
   "author": "Andrew Bubnov",
   "scripts": {
@@ -12,7 +12,16 @@
     "routing",
     "typescript",
     "spa",
-    "nested-routes"
+    "nested-routes",
+    "data-loading",
+    "navigation-blocker",
+    "scroll-restoration",
+    "breadcrumbs",
+    "search-params",
+    "lazy-loading",
+    "prefetching",
+    "view-transitions",
+    "animations"
   ],
   "repository": {
     "type": "git",