feat(toolkit): add popstate event trigger to location hooks

- Add `triggerPopstate` function to `useLocation` and `useSearchParams` hooks
- Update `createLocationStore` to expose `triggerPopstateEvent` function
- This allows triggering a popstate event manually

.changeset/thin-lobsters-bathe.md

@@ -0,0 +1,9 @@
+---
+"@zayne-labs/toolkit": patch
+---
+
+feat(toolkit): add popstate event trigger to location hooks
+
+-  Add `triggerPopstate` function to `useLocation` and `useSearchParams` hooks
+-  Update `createLocationStore` to expose `triggerPopstateEvent` function
+-  This allows triggering a popstate event manually

packages/toolkit/src/core/createLocationStore.ts

@@ -105,7 +105,6 @@ const createLocationStore = (options: LocationStoreOptions = {}) => {
 		push,
 		replace,
 		subscribe,
-
 		triggerPopstateEvent,
 	};
 

packages/toolkit/src/react/hooks/useLocation.ts

@@ -3,17 +3,32 @@ import type { SelectorFn } from "@/type-helpers";
 import { useConstant } from "./useConstant";
 import { useStore } from "./useStore";
 
+type LocationStore = ReturnType<typeof createLocationStore>;
+
+type UseLocationResult<TSlice> = [
+	state: TSlice,
+	setState: {
+		push: LocationStore["push"];
+		replace: LocationStore["replace"];
+		triggerPopstate: LocationStore["triggerPopstateEvent"];
+	},
+];
+
 const useLocation = <TSlice = LocationState>(
 	selector: SelectorFn<LocationState, TSlice> = (store) => store as TSlice
 ) => {
 	const locationStore = useConstant(() => createLocationStore());
 
 	const stateSlice = useStore(locationStore as never, selector);
 
-	return [stateSlice, { push: locationStore.push, replace: locationStore.replace }] as [
-		state: TSlice,
-		setState: { push: typeof locationStore.push; replace: typeof locationStore.replace },
-	];
+	return [
+		stateSlice,
+		{
+			push: locationStore.push,
+			replace: locationStore.replace,
+			triggerPopstate: locationStore.triggerPopstateEvent,
+		},
+	] as UseLocationResult<TSlice>;
 };
 
 export { useLocation };

packages/toolkit/src/react/hooks/useSearchParams.ts

@@ -48,6 +48,8 @@ const useSearchParams = <TSearchParams extends URLSearchParamsInit>(
 		setSearch[action](`?${params.toString()}`);
 	};
 
+	setSearchParams.triggerPopstate = setSearch.triggerPopstate;
+
 	return [searchParams, setSearchParams] as const;
 };