@aigamo/route-sphere 2.1.1-1 → 2.2.0

package/dist/components/IStateHandlerOptions.d.ts

@@ -1,5 +1,13 @@
 import { StateChangeEvent } from '../stores/StateChangeEvent';
+import { StateRestoreEvent } from '../stores/StateRestoreEvent';
+import { StateSaveEvent } from '../stores/StateSaveEvent';
+export interface IRestoreStateOptions<TState> {
+    onStateRestore?: (event: StateRestoreEvent<TState>) => void;
+}
 export interface IHandleStateChangeOptions<TState> {
     onStateChange?: (event: StateChangeEvent<TState>) => void;
 }
-export type IStateHandlerOptions<TState> = IHandleStateChangeOptions<TState>;
+export interface ISaveStateOptions<TState> {
+    onStateSave?: (event: StateSaveEvent<TState>) => void;
+}
+export type IStateHandlerOptions<TState> = IRestoreStateOptions<TState> & IHandleStateChangeOptions<TState> & ISaveStateOptions<TState>;

package/dist/index.cjs.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("react"),n=require("react-router-dom"),c=require("./useStateHandler-xZNycUEj.cjs"),l=()=>{const e=n.useLocation();return a.useLayoutEffect(()=>{window.scrollTo(0,0)},[e]),null},u=e=>a.useCallback(()=>{try{return JSON.parse(window.localStorage.getItem(e)??JSON.stringify({}))}catch(t){return console.error(t),{}}},[e]),S=e=>a.useCallback(t=>{window.localStorage.setItem(e,JSON.stringify(t))},[e]),i=e=>{const t=u(e),o=S(e);return a.useMemo(()=>({deserialize:t,serialize:o}),[t,o])},d=(e,t,o,r)=>{const s=i(e);c.useStateHandler(s,t,o,r)},g=e=>a.useCallback(()=>e.state,[e]),L=e=>a.useCallback(t=>{e.state=t},[e]),m=e=>{const t=g(e),o=L(e);return a.useMemo(()=>({get:t,set:o}),[t,o])},C=(e,t)=>{const o=m(t),r=a.useMemo(()=>({onStateChange:t.onStateChange}),[t]);d(e,t.validateState,o,r)},b=(e,t)=>t.some(o=>e.includes(o));exports.useStateHandler=c.useStateHandler;exports.ScrollToTop=l;exports.includesAny=b;exports.useLocalStorageState=C;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("react"),n=require("react-router-dom"),c=require("./useStateHandler-Ff_CnvN8.cjs"),l=()=>{const e=n.useLocation();return a.useLayoutEffect(()=>{window.scrollTo(0,0)},[e]),null},u=e=>a.useCallback(()=>{try{return JSON.parse(window.localStorage.getItem(e)??JSON.stringify({}))}catch(t){return console.error(t),{}}},[e]),S=e=>a.useCallback(t=>{window.localStorage.setItem(e,JSON.stringify(t))},[e]),i=e=>{const t=u(e),o=S(e);return a.useMemo(()=>({deserialize:t,serialize:o}),[t,o])},d=(e,t,o,r)=>{const s=i(e);c.useStateHandler(s,t,o,r)},g=e=>a.useCallback(()=>e.state,[e]),L=e=>a.useCallback(t=>{e.state=t},[e]),m=e=>{const t=g(e),o=L(e);return a.useMemo(()=>({get:t,set:o}),[t,o])},C=(e,t)=>{const o=m(t),r=a.useMemo(()=>({onStateRestore:t.onStateRestore,onStateChange:t.onStateChange,onStateSave:t.onStateSave}),[t]);d(e,t.validateState,o,r)},b=(e,t)=>t.some(o=>e.includes(o));exports.useStateHandler=c.useStateHandler;exports.ScrollToTop=l;exports.includesAny=b;exports.useLocalStorageState=C;
 //# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs.js","sources":["../src/components/ScrollToTop.tsx","../src/components/useLocalStorageState.tsx","../src/helpers/includesAny.ts"],"sourcesContent":["import { useLayoutEffect } from 'react';\nimport { useLocation } from 'react-router-dom';\n\nexport const ScrollToTop = (): null => {\n\tconst location = useLocation();\n\n\tuseLayoutEffect(() => {\n\t\twindow.scrollTo(0, 0);\n\t}, [location]);\n\n\treturn null;\n};\n","import type { IStateStore } from '@/stores/IStateStore';\nimport { useCallback, useMemo } from 'react';\n\nimport type { IStateAccessor } from './IStateAccessor';\nimport type { IStateCodec } from './IStateCodec';\nimport type { IStateHandlerOptions } from './IStateHandlerOptions';\nimport { useStateHandler } from './useStateHandler';\n\nconst useLocalStorageStateDeserializer = (key: string): (() => unknown) => {\n\treturn useCallback((): unknown => {\n\t\ttry {\n\t\t\treturn JSON.parse(\n\t\t\t\twindow.localStorage.getItem(key) ?? JSON.stringify({}),\n\t\t\t);\n\t\t} catch (error) {\n\t\t\tconsole.error(error);\n\t\t\treturn {};\n\t\t}\n\t}, [key]);\n};\n\nconst useLocalStorageStateSerializer = <TState,>(\n\tkey: string,\n): ((state: TState) => void) => {\n\treturn useCallback(\n\t\t(state: TState): void => {\n\t\t\twindow.localStorage.setItem(key, JSON.stringify(state));\n\t\t},\n\t\t[key],\n\t);\n};\n\nconst useLocalStorageStateCodec = <TState,>(\n\tkey: string,\n): IStateCodec<TState> => {\n\tconst deserializer = useLocalStorageStateDeserializer(key);\n\tconst serializer = useLocalStorageStateSerializer(key);\n\tconst codec = useMemo(\n\t\t(): IStateCodec<TState> => ({\n\t\t\tdeserialize: deserializer,\n\t\t\tserialize: serializer,\n\t\t}),\n\t\t[deserializer, serializer],\n\t);\n\treturn codec;\n};\n\nconst useLocalStorageStateHandler = <TState,>(\n\tkey: string,\n\tvalidator: (state: unknown) => state is TState,\n\taccessor: IStateAccessor<TState>,\n\toptions: IStateHandlerOptions<TState>,\n): void => {\n\tconst codec = useLocalStorageStateCodec(key);\n\tuseStateHandler(codec, validator, accessor, options);\n};\n\nconst useLocalStorageStateGetter = <TState,>(\n\tstore: IStateStore<TState>,\n): (() => TState) => {\n\treturn useCallback((): TState => store.state, [store]);\n};\n\nconst useLocalStorageStateSetter = <TState,>(\n\tstore: IStateStore<TState>,\n): ((state: TState) => void) => {\n\treturn useCallback(\n\t\t(state: TState): void => {\n\t\t\tstore.state = state;\n\t\t},\n\t\t[store],\n\t);\n};\n\nconst useLocalStorageStateAccessor = <TState,>(\n\tstore: IStateStore<TState>,\n): IStateAccessor<TState> => {\n\tconst getter = useLocalStorageStateGetter(store);\n\tconst setter = useLocalStorageStateSetter(store);\n\tconst accessor = useMemo(\n\t\t(): IStateAccessor<TState> => ({ get: getter, set: setter }),\n\t\t[getter, setter],\n\t);\n\treturn accessor;\n};\n\nexport const useLocalStorageState = <TState,>(\n\tkey: string,\n\tstore: IStateStore<TState>,\n): void => {\n\tconst accessor = useLocalStorageStateAccessor(store);\n\tconst options = useMemo(\n\t\t() => ({\n\t\t\tonStateChange: store.onStateChange,\n\t\t}),\n\t\t[store],\n\t);\n\tuseLocalStorageStateHandler(key, store.validateState, accessor, options);\n};\n","export const includesAny = <T>(array: T[], values: T[]): boolean => {\n\treturn values.some((value) => array.includes(value));\n};\n"],"names":["ScrollToTop","location","useLocation","useLayoutEffect","useLocalStorageStateDeserializer","key","useCallback","error","useLocalStorageStateSerializer","state","useLocalStorageStateCodec","deserializer","serializer","useMemo","useLocalStorageStateHandler","validator","accessor","options","codec","useStateHandler","useLocalStorageStateGetter","store","useLocalStorageStateSetter","useLocalStorageStateAccessor","getter","setter","useLocalStorageState","includesAny","array","values","value"],"mappings":"mLAGaA,EAAc,IAAY,CACtC,MAAMC,EAAWC,EAAAA,YAAA,EAEjBC,OAAAA,EAAAA,gBAAgB,IAAM,CACrB,OAAO,SAAS,EAAG,CAAC,CACrB,EAAG,CAACF,CAAQ,CAAC,EAEN,IACR,ECHMG,EAAoCC,GAClCC,EAAAA,YAAY,IAAe,CACjC,GAAI,CACH,OAAO,KAAK,MACX,OAAO,aAAa,QAAQD,CAAG,GAAK,KAAK,UAAU,CAAA,CAAE,CAAA,CAEvD,OAASE,EAAO,CACf,eAAQ,MAAMA,CAAK,EACZ,CAAA,CACR,CACD,EAAG,CAACF,CAAG,CAAC,EAGHG,EACLH,GAEOC,EAAAA,YACLG,GAAwB,CACxB,OAAO,aAAa,QAAQJ,EAAK,KAAK,UAAUI,CAAK,CAAC,CACvD,EACA,CAACJ,CAAG,CAAA,EAIAK,EACLL,GACyB,CACzB,MAAMM,EAAeP,EAAiCC,CAAG,EACnDO,EAAaJ,EAA+BH,CAAG,EAQrD,OAPcQ,EAAAA,QACb,KAA4B,CAC3B,YAAaF,EACb,UAAWC,CAAA,GAEZ,CAACD,EAAcC,CAAU,CAAA,CAG3B,EAEME,EAA8B,CACnCT,EACAU,EACAC,EACAC,IACU,CACV,MAAMC,EAAQR,EAA0BL,CAAG,EAC3Cc,EAAAA,gBAAgBD,EAAOH,EAAWC,EAAUC,CAAO,CACpD,EAEMG,EACLC,GAEOf,EAAAA,YAAY,IAAce,EAAM,MAAO,CAACA,CAAK,CAAC,EAGhDC,EACLD,GAEOf,EAAAA,YACLG,GAAwB,CACxBY,EAAM,MAAQZ,CACf,EACA,CAACY,CAAK,CAAA,EAIFE,EACLF,GAC4B,CAC5B,MAAMG,EAASJ,EAA2BC,CAAK,EACzCI,EAASH,EAA2BD,CAAK,EAK/C,OAJiBR,EAAAA,QAChB,KAA+B,CAAE,IAAKW,EAAQ,IAAKC,CAAA,GACnD,CAACD,EAAQC,CAAM,CAAA,CAGjB,EAEaC,EAAuB,CACnCrB,EACAgB,IACU,CACV,MAAML,EAAWO,EAA6BF,CAAK,EAC7CJ,EAAUJ,EAAAA,QACf,KAAO,CACN,cAAeQ,EAAM,aAAA,GAEtB,CAACA,CAAK,CAAA,EAEPP,EAA4BT,EAAKgB,EAAM,cAAeL,EAAUC,CAAO,CACxE,EClGaU,EAAc,CAAIC,EAAYC,IACnCA,EAAO,KAAMC,GAAUF,EAAM,SAASE,CAAK,CAAC"}
+{"version":3,"file":"index.cjs.js","sources":["../src/components/ScrollToTop.tsx","../src/components/useLocalStorageState.tsx","../src/helpers/includesAny.ts"],"sourcesContent":["import { useLayoutEffect } from 'react';\nimport { useLocation } from 'react-router-dom';\n\nexport const ScrollToTop = (): null => {\n\tconst location = useLocation();\n\n\tuseLayoutEffect(() => {\n\t\twindow.scrollTo(0, 0);\n\t}, [location]);\n\n\treturn null;\n};\n","import type { IStateAccessor } from '@/components/IStateAccessor';\nimport type { IStateCodec } from '@/components/IStateCodec';\nimport type { IStateHandlerOptions } from '@/components/IStateHandlerOptions';\nimport { useStateHandler } from '@/components/useStateHandler';\nimport type { IStateStore } from '@/stores/IStateStore';\nimport { useCallback, useMemo } from 'react';\n\nconst useLocalStorageStateDeserializer = (key: string): (() => unknown) => {\n\treturn useCallback((): unknown => {\n\t\ttry {\n\t\t\treturn JSON.parse(\n\t\t\t\twindow.localStorage.getItem(key) ?? JSON.stringify({}),\n\t\t\t);\n\t\t} catch (error) {\n\t\t\tconsole.error(error);\n\t\t\treturn {};\n\t\t}\n\t}, [key]);\n};\n\nconst useLocalStorageStateSerializer = <TState,>(\n\tkey: string,\n): ((state: TState) => void) => {\n\treturn useCallback(\n\t\t(state: TState): void => {\n\t\t\twindow.localStorage.setItem(key, JSON.stringify(state));\n\t\t},\n\t\t[key],\n\t);\n};\n\nconst useLocalStorageStateCodec = <TState,>(\n\tkey: string,\n): IStateCodec<TState> => {\n\tconst deserializer = useLocalStorageStateDeserializer(key);\n\tconst serializer = useLocalStorageStateSerializer(key);\n\tconst codec = useMemo(\n\t\t(): IStateCodec<TState> => ({\n\t\t\tdeserialize: deserializer,\n\t\t\tserialize: serializer,\n\t\t}),\n\t\t[deserializer, serializer],\n\t);\n\treturn codec;\n};\n\nconst useLocalStorageStateHandler = <TState,>(\n\tkey: string,\n\tvalidator: (state: unknown) => state is TState,\n\taccessor: IStateAccessor<TState>,\n\toptions: IStateHandlerOptions<TState>,\n): void => {\n\tconst codec = useLocalStorageStateCodec(key);\n\tuseStateHandler(codec, validator, accessor, options);\n};\n\nconst useLocalStorageStateGetter = <TState,>(\n\tstore: IStateStore<TState>,\n): (() => TState) => {\n\treturn useCallback((): TState => store.state, [store]);\n};\n\nconst useLocalStorageStateSetter = <TState,>(\n\tstore: IStateStore<TState>,\n): ((state: TState) => void) => {\n\treturn useCallback(\n\t\t(state: TState): void => {\n\t\t\tstore.state = state;\n\t\t},\n\t\t[store],\n\t);\n};\n\nconst useLocalStorageStateAccessor = <TState,>(\n\tstore: IStateStore<TState>,\n): IStateAccessor<TState> => {\n\tconst getter = useLocalStorageStateGetter(store);\n\tconst setter = useLocalStorageStateSetter(store);\n\tconst accessor = useMemo(\n\t\t(): IStateAccessor<TState> => ({ get: getter, set: setter }),\n\t\t[getter, setter],\n\t);\n\treturn accessor;\n};\n\nexport const useLocalStorageState = <TState,>(\n\tkey: string,\n\tstore: IStateStore<TState>,\n): void => {\n\tconst accessor = useLocalStorageStateAccessor(store);\n\tconst options = useMemo(\n\t\t() => ({\n\t\t\tonStateRestore: store.onStateRestore,\n\t\t\tonStateChange: store.onStateChange,\n\t\t\tonStateSave: store.onStateSave,\n\t\t}),\n\t\t[store],\n\t);\n\tuseLocalStorageStateHandler(key, store.validateState, accessor, options);\n};\n","export const includesAny = <T>(array: T[], values: T[]): boolean => {\n\treturn values.some((value) => array.includes(value));\n};\n"],"names":["ScrollToTop","location","useLocation","useLayoutEffect","useLocalStorageStateDeserializer","key","useCallback","error","useLocalStorageStateSerializer","state","useLocalStorageStateCodec","deserializer","serializer","useMemo","useLocalStorageStateHandler","validator","accessor","options","codec","useStateHandler","useLocalStorageStateGetter","store","useLocalStorageStateSetter","useLocalStorageStateAccessor","getter","setter","useLocalStorageState","includesAny","array","values","value"],"mappings":"mLAGaA,EAAc,IAAY,CACtC,MAAMC,EAAWC,EAAAA,YAAA,EAEjBC,OAAAA,EAAAA,gBAAgB,IAAM,CACrB,OAAO,SAAS,EAAG,CAAC,CACrB,EAAG,CAACF,CAAQ,CAAC,EAEN,IACR,ECJMG,EAAoCC,GAClCC,EAAAA,YAAY,IAAe,CACjC,GAAI,CACH,OAAO,KAAK,MACX,OAAO,aAAa,QAAQD,CAAG,GAAK,KAAK,UAAU,CAAA,CAAE,CAAA,CAEvD,OAASE,EAAO,CACf,eAAQ,MAAMA,CAAK,EACZ,CAAA,CACR,CACD,EAAG,CAACF,CAAG,CAAC,EAGHG,EACLH,GAEOC,EAAAA,YACLG,GAAwB,CACxB,OAAO,aAAa,QAAQJ,EAAK,KAAK,UAAUI,CAAK,CAAC,CACvD,EACA,CAACJ,CAAG,CAAA,EAIAK,EACLL,GACyB,CACzB,MAAMM,EAAeP,EAAiCC,CAAG,EACnDO,EAAaJ,EAA+BH,CAAG,EAQrD,OAPcQ,EAAAA,QACb,KAA4B,CAC3B,YAAaF,EACb,UAAWC,CAAA,GAEZ,CAACD,EAAcC,CAAU,CAAA,CAG3B,EAEME,EAA8B,CACnCT,EACAU,EACAC,EACAC,IACU,CACV,MAAMC,EAAQR,EAA0BL,CAAG,EAC3Cc,EAAAA,gBAAgBD,EAAOH,EAAWC,EAAUC,CAAO,CACpD,EAEMG,EACLC,GAEOf,EAAAA,YAAY,IAAce,EAAM,MAAO,CAACA,CAAK,CAAC,EAGhDC,EACLD,GAEOf,EAAAA,YACLG,GAAwB,CACxBY,EAAM,MAAQZ,CACf,EACA,CAACY,CAAK,CAAA,EAIFE,EACLF,GAC4B,CAC5B,MAAMG,EAASJ,EAA2BC,CAAK,EACzCI,EAASH,EAA2BD,CAAK,EAK/C,OAJiBR,EAAAA,QAChB,KAA+B,CAAE,IAAKW,EAAQ,IAAKC,CAAA,GACnD,CAACD,EAAQC,CAAM,CAAA,CAGjB,EAEaC,EAAuB,CACnCrB,EACAgB,IACU,CACV,MAAML,EAAWO,EAA6BF,CAAK,EAC7CJ,EAAUJ,EAAAA,QACf,KAAO,CACN,eAAgBQ,EAAM,eACtB,cAAeA,EAAM,cACrB,YAAaA,EAAM,WAAA,GAEpB,CAACA,CAAK,CAAA,EAEPP,EAA4BT,EAAKgB,EAAM,cAAeL,EAAUC,CAAO,CACxE,ECnGaU,EAAc,CAAIC,EAAYC,IACnCA,EAAO,KAAMC,GAAUF,EAAM,SAASE,CAAK,CAAC"}

package/dist/index.es.js

@@ -1,12 +1,12 @@
-import { useLayoutEffect as n, useMemo as c, useCallback as a } from "react";
-import { useLocation as l } from "react-router-dom";
-import { u as i } from "./useStateHandler-BqPWP1P7.js";
+import { useLayoutEffect as n, useMemo as c, useCallback as r } from "react";
+import { useLocation as S } from "react-router-dom";
+import { u as l } from "./useStateHandler-Dbkejxjm.js";
 const C = () => {
-  const e = l();
+  const e = S();
   return n(() => {
     window.scrollTo(0, 0);
   }, [e]), null;
-}, u = (e) => a(() => {
+}, i = (e) => r(() => {
   try {
     return JSON.parse(
       window.localStorage.getItem(e) ?? JSON.stringify({})
@@ -14,13 +14,13 @@ const C = () => {
   } catch (t) {
     return console.error(t), {};
   }
-}, [e]), S = (e) => a(
+}, [e]), u = (e) => r(
   (t) => {
     window.localStorage.setItem(e, JSON.stringify(t));
   },
   [e]
 ), g = (e) => {
-  const t = u(e), o = S(e);
+  const t = i(e), o = u(e);
   return c(
     () => ({
       deserialize: t,
@@ -28,10 +28,10 @@ const C = () => {
     }),
     [t, o]
   );
-}, d = (e, t, o, r) => {
+}, d = (e, t, o, a) => {
   const s = g(e);
-  i(s, t, o, r);
-}, m = (e) => a(() => e.state, [e]), L = (e) => a(
+  l(s, t, o, a);
+}, m = (e) => r(() => e.state, [e]), L = (e) => r(
   (t) => {
     e.state = t;
   },
@@ -43,18 +43,20 @@ const C = () => {
     [t, o]
   );
 }, h = (e, t) => {
-  const o = f(t), r = c(
+  const o = f(t), a = c(
     () => ({
-      onStateChange: t.onStateChange
+      onStateRestore: t.onStateRestore,
+      onStateChange: t.onStateChange,
+      onStateSave: t.onStateSave
     }),
     [t]
   );
-  d(e, t.validateState, o, r);
-}, J = (e, t) => t.some((o) => e.includes(o));
+  d(e, t.validateState, o, a);
+}, v = (e, t) => t.some((o) => e.includes(o));
 export {
   C as ScrollToTop,
-  J as includesAny,
+  v as includesAny,
   h as useLocalStorageState,
-  i as useStateHandler
+  l as useStateHandler
 };
 //# sourceMappingURL=index.es.js.map

package/dist/index.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.es.js","sources":["../src/components/ScrollToTop.tsx","../src/components/useLocalStorageState.tsx","../src/helpers/includesAny.ts"],"sourcesContent":["import { useLayoutEffect } from 'react';\nimport { useLocation } from 'react-router-dom';\n\nexport const ScrollToTop = (): null => {\n\tconst location = useLocation();\n\n\tuseLayoutEffect(() => {\n\t\twindow.scrollTo(0, 0);\n\t}, [location]);\n\n\treturn null;\n};\n","import type { IStateStore } from '@/stores/IStateStore';\nimport { useCallback, useMemo } from 'react';\n\nimport type { IStateAccessor } from './IStateAccessor';\nimport type { IStateCodec } from './IStateCodec';\nimport type { IStateHandlerOptions } from './IStateHandlerOptions';\nimport { useStateHandler } from './useStateHandler';\n\nconst useLocalStorageStateDeserializer = (key: string): (() => unknown) => {\n\treturn useCallback((): unknown => {\n\t\ttry {\n\t\t\treturn JSON.parse(\n\t\t\t\twindow.localStorage.getItem(key) ?? JSON.stringify({}),\n\t\t\t);\n\t\t} catch (error) {\n\t\t\tconsole.error(error);\n\t\t\treturn {};\n\t\t}\n\t}, [key]);\n};\n\nconst useLocalStorageStateSerializer = <TState,>(\n\tkey: string,\n): ((state: TState) => void) => {\n\treturn useCallback(\n\t\t(state: TState): void => {\n\t\t\twindow.localStorage.setItem(key, JSON.stringify(state));\n\t\t},\n\t\t[key],\n\t);\n};\n\nconst useLocalStorageStateCodec = <TState,>(\n\tkey: string,\n): IStateCodec<TState> => {\n\tconst deserializer = useLocalStorageStateDeserializer(key);\n\tconst serializer = useLocalStorageStateSerializer(key);\n\tconst codec = useMemo(\n\t\t(): IStateCodec<TState> => ({\n\t\t\tdeserialize: deserializer,\n\t\t\tserialize: serializer,\n\t\t}),\n\t\t[deserializer, serializer],\n\t);\n\treturn codec;\n};\n\nconst useLocalStorageStateHandler = <TState,>(\n\tkey: string,\n\tvalidator: (state: unknown) => state is TState,\n\taccessor: IStateAccessor<TState>,\n\toptions: IStateHandlerOptions<TState>,\n): void => {\n\tconst codec = useLocalStorageStateCodec(key);\n\tuseStateHandler(codec, validator, accessor, options);\n};\n\nconst useLocalStorageStateGetter = <TState,>(\n\tstore: IStateStore<TState>,\n): (() => TState) => {\n\treturn useCallback((): TState => store.state, [store]);\n};\n\nconst useLocalStorageStateSetter = <TState,>(\n\tstore: IStateStore<TState>,\n): ((state: TState) => void) => {\n\treturn useCallback(\n\t\t(state: TState): void => {\n\t\t\tstore.state = state;\n\t\t},\n\t\t[store],\n\t);\n};\n\nconst useLocalStorageStateAccessor = <TState,>(\n\tstore: IStateStore<TState>,\n): IStateAccessor<TState> => {\n\tconst getter = useLocalStorageStateGetter(store);\n\tconst setter = useLocalStorageStateSetter(store);\n\tconst accessor = useMemo(\n\t\t(): IStateAccessor<TState> => ({ get: getter, set: setter }),\n\t\t[getter, setter],\n\t);\n\treturn accessor;\n};\n\nexport const useLocalStorageState = <TState,>(\n\tkey: string,\n\tstore: IStateStore<TState>,\n): void => {\n\tconst accessor = useLocalStorageStateAccessor(store);\n\tconst options = useMemo(\n\t\t() => ({\n\t\t\tonStateChange: store.onStateChange,\n\t\t}),\n\t\t[store],\n\t);\n\tuseLocalStorageStateHandler(key, store.validateState, accessor, options);\n};\n","export const includesAny = <T>(array: T[], values: T[]): boolean => {\n\treturn values.some((value) => array.includes(value));\n};\n"],"names":["ScrollToTop","location","useLocation","useLayoutEffect","useLocalStorageStateDeserializer","key","useCallback","error","useLocalStorageStateSerializer","state","useLocalStorageStateCodec","deserializer","serializer","useMemo","useLocalStorageStateHandler","validator","accessor","options","codec","useStateHandler","useLocalStorageStateGetter","store","useLocalStorageStateSetter","useLocalStorageStateAccessor","getter","setter","useLocalStorageState","includesAny","array","values","value"],"mappings":";;;AAGO,MAAMA,IAAc,MAAY;AACtC,QAAMC,IAAWC,EAAA;AAEjB,SAAAC,EAAgB,MAAM;AACrB,WAAO,SAAS,GAAG,CAAC;AAAA,EACrB,GAAG,CAACF,CAAQ,CAAC,GAEN;AACR,GCHMG,IAAmC,CAACC,MAClCC,EAAY,MAAe;AACjC,MAAI;AACH,WAAO,KAAK;AAAA,MACX,OAAO,aAAa,QAAQD,CAAG,KAAK,KAAK,UAAU,CAAA,CAAE;AAAA,IAAA;AAAA,EAEvD,SAASE,GAAO;AACf,mBAAQ,MAAMA,CAAK,GACZ,CAAA;AAAA,EACR;AACD,GAAG,CAACF,CAAG,CAAC,GAGHG,IAAiC,CACtCH,MAEOC;AAAA,EACN,CAACG,MAAwB;AACxB,WAAO,aAAa,QAAQJ,GAAK,KAAK,UAAUI,CAAK,CAAC;AAAA,EACvD;AAAA,EACA,CAACJ,CAAG;AAAA,GAIAK,IAA4B,CACjCL,MACyB;AACzB,QAAMM,IAAeP,EAAiCC,CAAG,GACnDO,IAAaJ,EAA+BH,CAAG;AAQrD,SAPcQ;AAAA,IACb,OAA4B;AAAA,MAC3B,aAAaF;AAAA,MACb,WAAWC;AAAA,IAAA;AAAA,IAEZ,CAACD,GAAcC,CAAU;AAAA,EAAA;AAG3B,GAEME,IAA8B,CACnCT,GACAU,GACAC,GACAC,MACU;AACV,QAAMC,IAAQR,EAA0BL,CAAG;AAC3C,EAAAc,EAAgBD,GAAOH,GAAWC,GAAUC,CAAO;AACpD,GAEMG,IAA6B,CAClCC,MAEOf,EAAY,MAAce,EAAM,OAAO,CAACA,CAAK,CAAC,GAGhDC,IAA6B,CAClCD,MAEOf;AAAA,EACN,CAACG,MAAwB;AACxB,IAAAY,EAAM,QAAQZ;AAAA,EACf;AAAA,EACA,CAACY,CAAK;AAAA,GAIFE,IAA+B,CACpCF,MAC4B;AAC5B,QAAMG,IAASJ,EAA2BC,CAAK,GACzCI,IAASH,EAA2BD,CAAK;AAK/C,SAJiBR;AAAA,IAChB,OAA+B,EAAE,KAAKW,GAAQ,KAAKC,EAAA;AAAA,IACnD,CAACD,GAAQC,CAAM;AAAA,EAAA;AAGjB,GAEaC,IAAuB,CACnCrB,GACAgB,MACU;AACV,QAAML,IAAWO,EAA6BF,CAAK,GAC7CJ,IAAUJ;AAAA,IACf,OAAO;AAAA,MACN,eAAeQ,EAAM;AAAA,IAAA;AAAA,IAEtB,CAACA,CAAK;AAAA,EAAA;AAEP,EAAAP,EAA4BT,GAAKgB,EAAM,eAAeL,GAAUC,CAAO;AACxE,GClGaU,IAAc,CAAIC,GAAYC,MACnCA,EAAO,KAAK,CAACC,MAAUF,EAAM,SAASE,CAAK,CAAC;"}
+{"version":3,"file":"index.es.js","sources":["../src/components/ScrollToTop.tsx","../src/components/useLocalStorageState.tsx","../src/helpers/includesAny.ts"],"sourcesContent":["import { useLayoutEffect } from 'react';\nimport { useLocation } from 'react-router-dom';\n\nexport const ScrollToTop = (): null => {\n\tconst location = useLocation();\n\n\tuseLayoutEffect(() => {\n\t\twindow.scrollTo(0, 0);\n\t}, [location]);\n\n\treturn null;\n};\n","import type { IStateAccessor } from '@/components/IStateAccessor';\nimport type { IStateCodec } from '@/components/IStateCodec';\nimport type { IStateHandlerOptions } from '@/components/IStateHandlerOptions';\nimport { useStateHandler } from '@/components/useStateHandler';\nimport type { IStateStore } from '@/stores/IStateStore';\nimport { useCallback, useMemo } from 'react';\n\nconst useLocalStorageStateDeserializer = (key: string): (() => unknown) => {\n\treturn useCallback((): unknown => {\n\t\ttry {\n\t\t\treturn JSON.parse(\n\t\t\t\twindow.localStorage.getItem(key) ?? JSON.stringify({}),\n\t\t\t);\n\t\t} catch (error) {\n\t\t\tconsole.error(error);\n\t\t\treturn {};\n\t\t}\n\t}, [key]);\n};\n\nconst useLocalStorageStateSerializer = <TState,>(\n\tkey: string,\n): ((state: TState) => void) => {\n\treturn useCallback(\n\t\t(state: TState): void => {\n\t\t\twindow.localStorage.setItem(key, JSON.stringify(state));\n\t\t},\n\t\t[key],\n\t);\n};\n\nconst useLocalStorageStateCodec = <TState,>(\n\tkey: string,\n): IStateCodec<TState> => {\n\tconst deserializer = useLocalStorageStateDeserializer(key);\n\tconst serializer = useLocalStorageStateSerializer(key);\n\tconst codec = useMemo(\n\t\t(): IStateCodec<TState> => ({\n\t\t\tdeserialize: deserializer,\n\t\t\tserialize: serializer,\n\t\t}),\n\t\t[deserializer, serializer],\n\t);\n\treturn codec;\n};\n\nconst useLocalStorageStateHandler = <TState,>(\n\tkey: string,\n\tvalidator: (state: unknown) => state is TState,\n\taccessor: IStateAccessor<TState>,\n\toptions: IStateHandlerOptions<TState>,\n): void => {\n\tconst codec = useLocalStorageStateCodec(key);\n\tuseStateHandler(codec, validator, accessor, options);\n};\n\nconst useLocalStorageStateGetter = <TState,>(\n\tstore: IStateStore<TState>,\n): (() => TState) => {\n\treturn useCallback((): TState => store.state, [store]);\n};\n\nconst useLocalStorageStateSetter = <TState,>(\n\tstore: IStateStore<TState>,\n): ((state: TState) => void) => {\n\treturn useCallback(\n\t\t(state: TState): void => {\n\t\t\tstore.state = state;\n\t\t},\n\t\t[store],\n\t);\n};\n\nconst useLocalStorageStateAccessor = <TState,>(\n\tstore: IStateStore<TState>,\n): IStateAccessor<TState> => {\n\tconst getter = useLocalStorageStateGetter(store);\n\tconst setter = useLocalStorageStateSetter(store);\n\tconst accessor = useMemo(\n\t\t(): IStateAccessor<TState> => ({ get: getter, set: setter }),\n\t\t[getter, setter],\n\t);\n\treturn accessor;\n};\n\nexport const useLocalStorageState = <TState,>(\n\tkey: string,\n\tstore: IStateStore<TState>,\n): void => {\n\tconst accessor = useLocalStorageStateAccessor(store);\n\tconst options = useMemo(\n\t\t() => ({\n\t\t\tonStateRestore: store.onStateRestore,\n\t\t\tonStateChange: store.onStateChange,\n\t\t\tonStateSave: store.onStateSave,\n\t\t}),\n\t\t[store],\n\t);\n\tuseLocalStorageStateHandler(key, store.validateState, accessor, options);\n};\n","export const includesAny = <T>(array: T[], values: T[]): boolean => {\n\treturn values.some((value) => array.includes(value));\n};\n"],"names":["ScrollToTop","location","useLocation","useLayoutEffect","useLocalStorageStateDeserializer","key","useCallback","error","useLocalStorageStateSerializer","state","useLocalStorageStateCodec","deserializer","serializer","useMemo","useLocalStorageStateHandler","validator","accessor","options","codec","useStateHandler","useLocalStorageStateGetter","store","useLocalStorageStateSetter","useLocalStorageStateAccessor","getter","setter","useLocalStorageState","includesAny","array","values","value"],"mappings":";;;AAGO,MAAMA,IAAc,MAAY;AACtC,QAAMC,IAAWC,EAAA;AAEjB,SAAAC,EAAgB,MAAM;AACrB,WAAO,SAAS,GAAG,CAAC;AAAA,EACrB,GAAG,CAACF,CAAQ,CAAC,GAEN;AACR,GCJMG,IAAmC,CAACC,MAClCC,EAAY,MAAe;AACjC,MAAI;AACH,WAAO,KAAK;AAAA,MACX,OAAO,aAAa,QAAQD,CAAG,KAAK,KAAK,UAAU,CAAA,CAAE;AAAA,IAAA;AAAA,EAEvD,SAASE,GAAO;AACf,mBAAQ,MAAMA,CAAK,GACZ,CAAA;AAAA,EACR;AACD,GAAG,CAACF,CAAG,CAAC,GAGHG,IAAiC,CACtCH,MAEOC;AAAA,EACN,CAACG,MAAwB;AACxB,WAAO,aAAa,QAAQJ,GAAK,KAAK,UAAUI,CAAK,CAAC;AAAA,EACvD;AAAA,EACA,CAACJ,CAAG;AAAA,GAIAK,IAA4B,CACjCL,MACyB;AACzB,QAAMM,IAAeP,EAAiCC,CAAG,GACnDO,IAAaJ,EAA+BH,CAAG;AAQrD,SAPcQ;AAAA,IACb,OAA4B;AAAA,MAC3B,aAAaF;AAAA,MACb,WAAWC;AAAA,IAAA;AAAA,IAEZ,CAACD,GAAcC,CAAU;AAAA,EAAA;AAG3B,GAEME,IAA8B,CACnCT,GACAU,GACAC,GACAC,MACU;AACV,QAAMC,IAAQR,EAA0BL,CAAG;AAC3C,EAAAc,EAAgBD,GAAOH,GAAWC,GAAUC,CAAO;AACpD,GAEMG,IAA6B,CAClCC,MAEOf,EAAY,MAAce,EAAM,OAAO,CAACA,CAAK,CAAC,GAGhDC,IAA6B,CAClCD,MAEOf;AAAA,EACN,CAACG,MAAwB;AACxB,IAAAY,EAAM,QAAQZ;AAAA,EACf;AAAA,EACA,CAACY,CAAK;AAAA,GAIFE,IAA+B,CACpCF,MAC4B;AAC5B,QAAMG,IAASJ,EAA2BC,CAAK,GACzCI,IAASH,EAA2BD,CAAK;AAK/C,SAJiBR;AAAA,IAChB,OAA+B,EAAE,KAAKW,GAAQ,KAAKC,EAAA;AAAA,IACnD,CAACD,GAAQC,CAAM;AAAA,EAAA;AAGjB,GAEaC,IAAuB,CACnCrB,GACAgB,MACU;AACV,QAAML,IAAWO,EAA6BF,CAAK,GAC7CJ,IAAUJ;AAAA,IACf,OAAO;AAAA,MACN,gBAAgBQ,EAAM;AAAA,MACtB,eAAeA,EAAM;AAAA,MACrB,aAAaA,EAAM;AAAA,IAAA;AAAA,IAEpB,CAACA,CAAK;AAAA,EAAA;AAEP,EAAAP,EAA4BT,GAAKgB,EAAM,eAAeL,GAAUC,CAAO;AACxE,GCnGaU,IAAc,CAAIC,GAAYC,MACnCA,EAAO,KAAK,CAACC,MAAUF,EAAM,SAASE,CAAK,CAAC;"}

package/dist/react-router.cjs.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./useStateHandler-xZNycUEj.cjs"),o=require("qs"),s=require("react"),n=require("react-router-dom"),i=()=>{const e=n.useLocation();return s.useCallback(()=>o.parse(e.search.slice(1)),[e])},u=()=>{const e=n.useNavigate();return s.useCallback(async t=>{const a=`?${o.stringify(t)}`;await e(a)},[e])},l=()=>{const e=i(),t=u();return s.useMemo(()=>({deserialize:e,serialize:t}),[e,t])},S=(e,t,a)=>{const c=l();r.useStateHandler(c,e,t,a)},d=e=>s.useCallback(()=>e.state,[e]),L=e=>s.useCallback(t=>{e.state=t},[e]),g=e=>{const t=d(e),a=L(e);return s.useMemo(()=>({get:t,set:a}),[t,a])},C=e=>{const t=g(e),a=s.useMemo(()=>({onStateChange:e.onStateChange}),[e]);S(e.validateState,t,a)};exports.useLocationState=C;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const r=require("./useStateHandler-Ff_CnvN8.cjs"),c=require("qs"),o=require("react"),n=require("react-router-dom"),i=()=>{const e=n.useLocation();return o.useCallback(()=>c.parse(e.search.slice(1)),[e])},u=()=>{const e=n.useNavigate();return o.useCallback(async t=>{const a=`?${c.stringify(t)}`;await e(a)},[e])},l=()=>{const e=i(),t=u();return o.useMemo(()=>({deserialize:e,serialize:t}),[e,t])},S=(e,t,a)=>{const s=l();r.useStateHandler(s,e,t,a)},d=e=>o.useCallback(()=>e.state,[e]),L=e=>o.useCallback(t=>{e.state=t},[e]),g=e=>{const t=d(e),a=L(e);return o.useMemo(()=>({get:t,set:a}),[t,a])},C=e=>{const t=g(e),a=o.useMemo(()=>({onStateRestore:e.onStateRestore,onStateChange:e.onStateChange,onStateSave:e.onStateSave}),[e]);S(e.validateState,t,a)};exports.useLocationState=C;
 //# sourceMappingURL=react-router.cjs.js.map

package/dist/react-router.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"react-router.cjs.js","sources":["../src/react-router/useLocationState.tsx"],"sourcesContent":["import type { IStateAccessor } from '@/components/IStateAccessor';\nimport type { IStateCodec } from '@/components/IStateCodec';\nimport type { IStateHandlerOptions } from '@/components/IStateHandlerOptions';\nimport { useStateHandler } from '@/components/useStateHandler';\nimport type { IStateStore } from '@/stores/IStateStore';\nimport { type ParsedQs, parse, stringify } from 'qs';\nimport { useCallback, useMemo } from 'react';\nimport { useLocation, useNavigate } from 'react-router-dom';\n\nconst useLocationStateDeserializer = (): (() => ParsedQs) => {\n\tconst location = useLocation();\n\n\t// Pass `location` as deps instead of `location.search`.\n\treturn useCallback(\n\t\t(): ParsedQs => parse(location.search.slice(1)),\n\t\t[location],\n\t);\n};\n\nconst useLocationStateSerializer = <TState,>(): ((state: TState) => void) => {\n\tconst navigate = useNavigate();\n\n\treturn useCallback(\n\t\tasync (state: TState): Promise<void> => {\n\t\t\tconst newUrl = `?${stringify(state)}`;\n\t\t\tawait navigate(newUrl);\n\t\t},\n\t\t[navigate],\n\t);\n};\n\nconst useLocationStateCodec = <TState,>(): IStateCodec<TState> => {\n\tconst deserializer = useLocationStateDeserializer();\n\tconst serializer = useLocationStateSerializer();\n\tconst codec = useMemo(\n\t\t(): IStateCodec<TState> => ({\n\t\t\tdeserialize: deserializer,\n\t\t\tserialize: serializer,\n\t\t}),\n\t\t[deserializer, serializer],\n\t);\n\treturn codec;\n};\n\n/** Updates a store that implements the {@link LocationStateStore} interface when a route changes, and vice versa. */\nconst useLocationStateHandler = <TState,>(\n\tvalidator: (state: unknown) => state is TState,\n\taccessor: IStateAccessor<TState>,\n\toptions: IStateHandlerOptions<TState>,\n): void => {\n\tconst codec = useLocationStateCodec();\n\tuseStateHandler(codec, validator, accessor, options);\n};\n\nconst useLocationStateGetter = <TState,>(\n\tstore: IStateStore<TState>,\n): (() => TState) => {\n\treturn useCallback((): TState => store.state, [store]);\n};\n\nconst useLocationStateSetter = <TState,>(\n\tstore: IStateStore<TState>,\n): ((state: TState) => void) => {\n\treturn useCallback(\n\t\t(state: TState): void => {\n\t\t\tstore.state = state;\n\t\t},\n\t\t[store],\n\t);\n};\n\nconst useLocationStateAccessor = <TState,>(\n\tstore: IStateStore<TState>,\n): IStateAccessor<TState> => {\n\tconst getter = useLocationStateGetter(store);\n\tconst setter = useLocationStateSetter(store);\n\tconst accessor = useMemo(\n\t\t(): IStateAccessor<TState> => ({ get: getter, set: setter }),\n\t\t[getter, setter],\n\t);\n\treturn accessor;\n};\n\n/** Updates a store that implements the {@link LocationStateStore} interface when a route changes, and vice versa. */\nexport const useLocationState = <TState,>(store: IStateStore<TState>): void => {\n\tconst accessor = useLocationStateAccessor(store);\n\tconst options = useMemo(\n\t\t() => ({\n\t\t\tonStateChange: store.onStateChange,\n\t\t}),\n\t\t[store],\n\t);\n\tuseLocationStateHandler(store.validateState, accessor, options);\n};\n"],"names":["useLocationStateDeserializer","location","useLocation","useCallback","parse","useLocationStateSerializer","navigate","useNavigate","state","newUrl","stringify","useLocationStateCodec","deserializer","serializer","useMemo","useLocationStateHandler","validator","accessor","options","codec","useStateHandler","useLocationStateGetter","store","useLocationStateSetter","useLocationStateAccessor","getter","setter","useLocationState"],"mappings":"mMASMA,EAA+B,IAAwB,CAC5D,MAAMC,EAAWC,EAAAA,YAAA,EAGjB,OAAOC,EAAAA,YACN,IAAgBC,EAAAA,MAAMH,EAAS,OAAO,MAAM,CAAC,CAAC,EAC9C,CAACA,CAAQ,CAAA,CAEX,EAEMI,EAA6B,IAA0C,CAC5E,MAAMC,EAAWC,EAAAA,YAAA,EAEjB,OAAOJ,EAAAA,YACN,MAAOK,GAAiC,CACvC,MAAMC,EAAS,IAAIC,EAAAA,UAAUF,CAAK,CAAC,GACnC,MAAMF,EAASG,CAAM,CACtB,EACA,CAACH,CAAQ,CAAA,CAEX,EAEMK,EAAwB,IAAoC,CACjE,MAAMC,EAAeZ,EAAA,EACfa,EAAaR,EAAA,EAQnB,OAPcS,EAAAA,QACb,KAA4B,CAC3B,YAAaF,EACb,UAAWC,CAAA,GAEZ,CAACD,EAAcC,CAAU,CAAA,CAG3B,EAGME,EAA0B,CAC/BC,EACAC,EACAC,IACU,CACV,MAAMC,EAAQR,EAAA,EACdS,EAAAA,gBAAgBD,EAAOH,EAAWC,EAAUC,CAAO,CACpD,EAEMG,EACLC,GAEOnB,EAAAA,YAAY,IAAcmB,EAAM,MAAO,CAACA,CAAK,CAAC,EAGhDC,EACLD,GAEOnB,EAAAA,YACLK,GAAwB,CACxBc,EAAM,MAAQd,CACf,EACA,CAACc,CAAK,CAAA,EAIFE,EACLF,GAC4B,CAC5B,MAAMG,EAASJ,EAAuBC,CAAK,EACrCI,EAASH,EAAuBD,CAAK,EAK3C,OAJiBR,EAAAA,QAChB,KAA+B,CAAE,IAAKW,EAAQ,IAAKC,CAAA,GACnD,CAACD,EAAQC,CAAM,CAAA,CAGjB,EAGaC,EAA6BL,GAAqC,CAC9E,MAAML,EAAWO,EAAyBF,CAAK,EACzCJ,EAAUJ,EAAAA,QACf,KAAO,CACN,cAAeQ,EAAM,aAAA,GAEtB,CAACA,CAAK,CAAA,EAEPP,EAAwBO,EAAM,cAAeL,EAAUC,CAAO,CAC/D"}
+{"version":3,"file":"react-router.cjs.js","sources":["../src/react-router/useLocationState.tsx"],"sourcesContent":["import type { IStateAccessor } from '@/components/IStateAccessor';\nimport type { IStateCodec } from '@/components/IStateCodec';\nimport type { IStateHandlerOptions } from '@/components/IStateHandlerOptions';\nimport { useStateHandler } from '@/components/useStateHandler';\nimport type { IStateStore } from '@/stores/IStateStore';\nimport { type ParsedQs, parse, stringify } from 'qs';\nimport { useCallback, useMemo } from 'react';\nimport { useLocation, useNavigate } from 'react-router-dom';\n\nconst useLocationStateDeserializer = (): (() => ParsedQs) => {\n\tconst location = useLocation();\n\n\t// Pass `location` as deps instead of `location.search`.\n\treturn useCallback(\n\t\t(): ParsedQs => parse(location.search.slice(1)),\n\t\t[location],\n\t);\n};\n\nconst useLocationStateSerializer = <TState,>(): ((state: TState) => void) => {\n\tconst navigate = useNavigate();\n\n\treturn useCallback(\n\t\tasync (state: TState): Promise<void> => {\n\t\t\tconst newUrl = `?${stringify(state)}`;\n\t\t\tawait navigate(newUrl);\n\t\t},\n\t\t[navigate],\n\t);\n};\n\nconst useLocationStateCodec = <TState,>(): IStateCodec<TState> => {\n\tconst deserializer = useLocationStateDeserializer();\n\tconst serializer = useLocationStateSerializer();\n\tconst codec = useMemo(\n\t\t(): IStateCodec<TState> => ({\n\t\t\tdeserialize: deserializer,\n\t\t\tserialize: serializer,\n\t\t}),\n\t\t[deserializer, serializer],\n\t);\n\treturn codec;\n};\n\n/** Updates a store that implements the {@link LocationStateStore} interface when a route changes, and vice versa. */\nconst useLocationStateHandler = <TState,>(\n\tvalidator: (state: unknown) => state is TState,\n\taccessor: IStateAccessor<TState>,\n\toptions: IStateHandlerOptions<TState>,\n): void => {\n\tconst codec = useLocationStateCodec();\n\tuseStateHandler(codec, validator, accessor, options);\n};\n\nconst useLocationStateGetter = <TState,>(\n\tstore: IStateStore<TState>,\n): (() => TState) => {\n\treturn useCallback((): TState => store.state, [store]);\n};\n\nconst useLocationStateSetter = <TState,>(\n\tstore: IStateStore<TState>,\n): ((state: TState) => void) => {\n\treturn useCallback(\n\t\t(state: TState): void => {\n\t\t\tstore.state = state;\n\t\t},\n\t\t[store],\n\t);\n};\n\nconst useLocationStateAccessor = <TState,>(\n\tstore: IStateStore<TState>,\n): IStateAccessor<TState> => {\n\tconst getter = useLocationStateGetter(store);\n\tconst setter = useLocationStateSetter(store);\n\tconst accessor = useMemo(\n\t\t(): IStateAccessor<TState> => ({ get: getter, set: setter }),\n\t\t[getter, setter],\n\t);\n\treturn accessor;\n};\n\n/** Updates a store that implements the {@link LocationStateStore} interface when a route changes, and vice versa. */\nexport const useLocationState = <TState,>(store: IStateStore<TState>): void => {\n\tconst accessor = useLocationStateAccessor(store);\n\tconst options = useMemo(\n\t\t() => ({\n\t\t\tonStateRestore: store.onStateRestore,\n\t\t\tonStateChange: store.onStateChange,\n\t\t\tonStateSave: store.onStateSave,\n\t\t}),\n\t\t[store],\n\t);\n\tuseLocationStateHandler(store.validateState, accessor, options);\n};\n"],"names":["useLocationStateDeserializer","location","useLocation","useCallback","parse","useLocationStateSerializer","navigate","useNavigate","state","newUrl","stringify","useLocationStateCodec","deserializer","serializer","useMemo","useLocationStateHandler","validator","accessor","options","codec","useStateHandler","useLocationStateGetter","store","useLocationStateSetter","useLocationStateAccessor","getter","setter","useLocationState"],"mappings":"mMASMA,EAA+B,IAAwB,CAC5D,MAAMC,EAAWC,EAAAA,YAAA,EAGjB,OAAOC,EAAAA,YACN,IAAgBC,EAAAA,MAAMH,EAAS,OAAO,MAAM,CAAC,CAAC,EAC9C,CAACA,CAAQ,CAAA,CAEX,EAEMI,EAA6B,IAA0C,CAC5E,MAAMC,EAAWC,EAAAA,YAAA,EAEjB,OAAOJ,EAAAA,YACN,MAAOK,GAAiC,CACvC,MAAMC,EAAS,IAAIC,EAAAA,UAAUF,CAAK,CAAC,GACnC,MAAMF,EAASG,CAAM,CACtB,EACA,CAACH,CAAQ,CAAA,CAEX,EAEMK,EAAwB,IAAoC,CACjE,MAAMC,EAAeZ,EAAA,EACfa,EAAaR,EAAA,EAQnB,OAPcS,EAAAA,QACb,KAA4B,CAC3B,YAAaF,EACb,UAAWC,CAAA,GAEZ,CAACD,EAAcC,CAAU,CAAA,CAG3B,EAGME,EAA0B,CAC/BC,EACAC,EACAC,IACU,CACV,MAAMC,EAAQR,EAAA,EACdS,EAAAA,gBAAgBD,EAAOH,EAAWC,EAAUC,CAAO,CACpD,EAEMG,EACLC,GAEOnB,EAAAA,YAAY,IAAcmB,EAAM,MAAO,CAACA,CAAK,CAAC,EAGhDC,EACLD,GAEOnB,EAAAA,YACLK,GAAwB,CACxBc,EAAM,MAAQd,CACf,EACA,CAACc,CAAK,CAAA,EAIFE,EACLF,GAC4B,CAC5B,MAAMG,EAASJ,EAAuBC,CAAK,EACrCI,EAASH,EAAuBD,CAAK,EAK3C,OAJiBR,EAAAA,QAChB,KAA+B,CAAE,IAAKW,EAAQ,IAAKC,CAAA,GACnD,CAACD,EAAQC,CAAM,CAAA,CAGjB,EAGaC,EAA6BL,GAAqC,CAC9E,MAAML,EAAWO,EAAyBF,CAAK,EACzCJ,EAAUJ,EAAAA,QACf,KAAO,CACN,eAAgBQ,EAAM,eACtB,cAAeA,EAAM,cACrB,YAAaA,EAAM,WAAA,GAEpB,CAACA,CAAK,CAAA,EAEPP,EAAwBO,EAAM,cAAeL,EAAUC,CAAO,CAC/D"}

package/dist/react-router.es.js

@@ -1,15 +1,15 @@
-import { u as n } from "./useStateHandler-BqPWP1P7.js";
+import { u as c } from "./useStateHandler-Dbkejxjm.js";
 import { parse as r, stringify as i } from "qs";
-import { useMemo as s, useCallback as a } from "react";
-import { useLocation as u, useNavigate as l } from "react-router-dom";
-const S = () => {
+import { useMemo as n, useCallback as a } from "react";
+import { useLocation as u, useNavigate as S } from "react-router-dom";
+const l = () => {
   const t = u();
   return a(
     () => r(t.search.slice(1)),
     [t]
   );
 }, d = () => {
-  const t = l();
+  const t = S();
   return a(
     async (e) => {
       const o = `?${i(e)}`;
@@ -18,8 +18,8 @@ const S = () => {
     [t]
   );
 }, m = () => {
-  const t = S(), e = d();
-  return s(
+  const t = l(), e = d();
+  return n(
     () => ({
       deserialize: t,
       serialize: e
@@ -27,8 +27,8 @@ const S = () => {
     [t, e]
   );
 }, L = (t, e, o) => {
-  const c = m();
-  n(c, t, e, o);
+  const s = m();
+  c(s, t, e, o);
 }, g = (t) => a(() => t.state, [t]), p = (t) => a(
   (e) => {
     t.state = e;
@@ -36,14 +36,16 @@ const S = () => {
   [t]
 ), z = (t) => {
   const e = g(t), o = p(t);
-  return s(
+  return n(
     () => ({ get: e, set: o }),
     [e, o]
   );
 }, w = (t) => {
-  const e = z(t), o = s(
+  const e = z(t), o = n(
     () => ({
-      onStateChange: t.onStateChange
+      onStateRestore: t.onStateRestore,
+      onStateChange: t.onStateChange,
+      onStateSave: t.onStateSave
     }),
     [t]
   );

package/dist/react-router.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"react-router.es.js","sources":["../src/react-router/useLocationState.tsx"],"sourcesContent":["import type { IStateAccessor } from '@/components/IStateAccessor';\nimport type { IStateCodec } from '@/components/IStateCodec';\nimport type { IStateHandlerOptions } from '@/components/IStateHandlerOptions';\nimport { useStateHandler } from '@/components/useStateHandler';\nimport type { IStateStore } from '@/stores/IStateStore';\nimport { type ParsedQs, parse, stringify } from 'qs';\nimport { useCallback, useMemo } from 'react';\nimport { useLocation, useNavigate } from 'react-router-dom';\n\nconst useLocationStateDeserializer = (): (() => ParsedQs) => {\n\tconst location = useLocation();\n\n\t// Pass `location` as deps instead of `location.search`.\n\treturn useCallback(\n\t\t(): ParsedQs => parse(location.search.slice(1)),\n\t\t[location],\n\t);\n};\n\nconst useLocationStateSerializer = <TState,>(): ((state: TState) => void) => {\n\tconst navigate = useNavigate();\n\n\treturn useCallback(\n\t\tasync (state: TState): Promise<void> => {\n\t\t\tconst newUrl = `?${stringify(state)}`;\n\t\t\tawait navigate(newUrl);\n\t\t},\n\t\t[navigate],\n\t);\n};\n\nconst useLocationStateCodec = <TState,>(): IStateCodec<TState> => {\n\tconst deserializer = useLocationStateDeserializer();\n\tconst serializer = useLocationStateSerializer();\n\tconst codec = useMemo(\n\t\t(): IStateCodec<TState> => ({\n\t\t\tdeserialize: deserializer,\n\t\t\tserialize: serializer,\n\t\t}),\n\t\t[deserializer, serializer],\n\t);\n\treturn codec;\n};\n\n/** Updates a store that implements the {@link LocationStateStore} interface when a route changes, and vice versa. */\nconst useLocationStateHandler = <TState,>(\n\tvalidator: (state: unknown) => state is TState,\n\taccessor: IStateAccessor<TState>,\n\toptions: IStateHandlerOptions<TState>,\n): void => {\n\tconst codec = useLocationStateCodec();\n\tuseStateHandler(codec, validator, accessor, options);\n};\n\nconst useLocationStateGetter = <TState,>(\n\tstore: IStateStore<TState>,\n): (() => TState) => {\n\treturn useCallback((): TState => store.state, [store]);\n};\n\nconst useLocationStateSetter = <TState,>(\n\tstore: IStateStore<TState>,\n): ((state: TState) => void) => {\n\treturn useCallback(\n\t\t(state: TState): void => {\n\t\t\tstore.state = state;\n\t\t},\n\t\t[store],\n\t);\n};\n\nconst useLocationStateAccessor = <TState,>(\n\tstore: IStateStore<TState>,\n): IStateAccessor<TState> => {\n\tconst getter = useLocationStateGetter(store);\n\tconst setter = useLocationStateSetter(store);\n\tconst accessor = useMemo(\n\t\t(): IStateAccessor<TState> => ({ get: getter, set: setter }),\n\t\t[getter, setter],\n\t);\n\treturn accessor;\n};\n\n/** Updates a store that implements the {@link LocationStateStore} interface when a route changes, and vice versa. */\nexport const useLocationState = <TState,>(store: IStateStore<TState>): void => {\n\tconst accessor = useLocationStateAccessor(store);\n\tconst options = useMemo(\n\t\t() => ({\n\t\t\tonStateChange: store.onStateChange,\n\t\t}),\n\t\t[store],\n\t);\n\tuseLocationStateHandler(store.validateState, accessor, options);\n};\n"],"names":["useLocationStateDeserializer","location","useLocation","useCallback","parse","useLocationStateSerializer","navigate","useNavigate","state","newUrl","stringify","useLocationStateCodec","deserializer","serializer","useMemo","useLocationStateHandler","validator","accessor","options","codec","useStateHandler","useLocationStateGetter","store","useLocationStateSetter","useLocationStateAccessor","getter","setter","useLocationState"],"mappings":";;;;AASA,MAAMA,IAA+B,MAAwB;AAC5D,QAAMC,IAAWC,EAAA;AAGjB,SAAOC;AAAA,IACN,MAAgBC,EAAMH,EAAS,OAAO,MAAM,CAAC,CAAC;AAAA,IAC9C,CAACA,CAAQ;AAAA,EAAA;AAEX,GAEMI,IAA6B,MAA0C;AAC5E,QAAMC,IAAWC,EAAA;AAEjB,SAAOJ;AAAA,IACN,OAAOK,MAAiC;AACvC,YAAMC,IAAS,IAAIC,EAAUF,CAAK,CAAC;AACnC,YAAMF,EAASG,CAAM;AAAA,IACtB;AAAA,IACA,CAACH,CAAQ;AAAA,EAAA;AAEX,GAEMK,IAAwB,MAAoC;AACjE,QAAMC,IAAeZ,EAAA,GACfa,IAAaR,EAAA;AAQnB,SAPcS;AAAA,IACb,OAA4B;AAAA,MAC3B,aAAaF;AAAA,MACb,WAAWC;AAAA,IAAA;AAAA,IAEZ,CAACD,GAAcC,CAAU;AAAA,EAAA;AAG3B,GAGME,IAA0B,CAC/BC,GACAC,GACAC,MACU;AACV,QAAMC,IAAQR,EAAA;AACd,EAAAS,EAAgBD,GAAOH,GAAWC,GAAUC,CAAO;AACpD,GAEMG,IAAyB,CAC9BC,MAEOnB,EAAY,MAAcmB,EAAM,OAAO,CAACA,CAAK,CAAC,GAGhDC,IAAyB,CAC9BD,MAEOnB;AAAA,EACN,CAACK,MAAwB;AACxB,IAAAc,EAAM,QAAQd;AAAA,EACf;AAAA,EACA,CAACc,CAAK;AAAA,GAIFE,IAA2B,CAChCF,MAC4B;AAC5B,QAAMG,IAASJ,EAAuBC,CAAK,GACrCI,IAASH,EAAuBD,CAAK;AAK3C,SAJiBR;AAAA,IAChB,OAA+B,EAAE,KAAKW,GAAQ,KAAKC,EAAA;AAAA,IACnD,CAACD,GAAQC,CAAM;AAAA,EAAA;AAGjB,GAGaC,IAAmB,CAAUL,MAAqC;AAC9E,QAAML,IAAWO,EAAyBF,CAAK,GACzCJ,IAAUJ;AAAA,IACf,OAAO;AAAA,MACN,eAAeQ,EAAM;AAAA,IAAA;AAAA,IAEtB,CAACA,CAAK;AAAA,EAAA;AAEP,EAAAP,EAAwBO,EAAM,eAAeL,GAAUC,CAAO;AAC/D;"}
+{"version":3,"file":"react-router.es.js","sources":["../src/react-router/useLocationState.tsx"],"sourcesContent":["import type { IStateAccessor } from '@/components/IStateAccessor';\nimport type { IStateCodec } from '@/components/IStateCodec';\nimport type { IStateHandlerOptions } from '@/components/IStateHandlerOptions';\nimport { useStateHandler } from '@/components/useStateHandler';\nimport type { IStateStore } from '@/stores/IStateStore';\nimport { type ParsedQs, parse, stringify } from 'qs';\nimport { useCallback, useMemo } from 'react';\nimport { useLocation, useNavigate } from 'react-router-dom';\n\nconst useLocationStateDeserializer = (): (() => ParsedQs) => {\n\tconst location = useLocation();\n\n\t// Pass `location` as deps instead of `location.search`.\n\treturn useCallback(\n\t\t(): ParsedQs => parse(location.search.slice(1)),\n\t\t[location],\n\t);\n};\n\nconst useLocationStateSerializer = <TState,>(): ((state: TState) => void) => {\n\tconst navigate = useNavigate();\n\n\treturn useCallback(\n\t\tasync (state: TState): Promise<void> => {\n\t\t\tconst newUrl = `?${stringify(state)}`;\n\t\t\tawait navigate(newUrl);\n\t\t},\n\t\t[navigate],\n\t);\n};\n\nconst useLocationStateCodec = <TState,>(): IStateCodec<TState> => {\n\tconst deserializer = useLocationStateDeserializer();\n\tconst serializer = useLocationStateSerializer();\n\tconst codec = useMemo(\n\t\t(): IStateCodec<TState> => ({\n\t\t\tdeserialize: deserializer,\n\t\t\tserialize: serializer,\n\t\t}),\n\t\t[deserializer, serializer],\n\t);\n\treturn codec;\n};\n\n/** Updates a store that implements the {@link LocationStateStore} interface when a route changes, and vice versa. */\nconst useLocationStateHandler = <TState,>(\n\tvalidator: (state: unknown) => state is TState,\n\taccessor: IStateAccessor<TState>,\n\toptions: IStateHandlerOptions<TState>,\n): void => {\n\tconst codec = useLocationStateCodec();\n\tuseStateHandler(codec, validator, accessor, options);\n};\n\nconst useLocationStateGetter = <TState,>(\n\tstore: IStateStore<TState>,\n): (() => TState) => {\n\treturn useCallback((): TState => store.state, [store]);\n};\n\nconst useLocationStateSetter = <TState,>(\n\tstore: IStateStore<TState>,\n): ((state: TState) => void) => {\n\treturn useCallback(\n\t\t(state: TState): void => {\n\t\t\tstore.state = state;\n\t\t},\n\t\t[store],\n\t);\n};\n\nconst useLocationStateAccessor = <TState,>(\n\tstore: IStateStore<TState>,\n): IStateAccessor<TState> => {\n\tconst getter = useLocationStateGetter(store);\n\tconst setter = useLocationStateSetter(store);\n\tconst accessor = useMemo(\n\t\t(): IStateAccessor<TState> => ({ get: getter, set: setter }),\n\t\t[getter, setter],\n\t);\n\treturn accessor;\n};\n\n/** Updates a store that implements the {@link LocationStateStore} interface when a route changes, and vice versa. */\nexport const useLocationState = <TState,>(store: IStateStore<TState>): void => {\n\tconst accessor = useLocationStateAccessor(store);\n\tconst options = useMemo(\n\t\t() => ({\n\t\t\tonStateRestore: store.onStateRestore,\n\t\t\tonStateChange: store.onStateChange,\n\t\t\tonStateSave: store.onStateSave,\n\t\t}),\n\t\t[store],\n\t);\n\tuseLocationStateHandler(store.validateState, accessor, options);\n};\n"],"names":["useLocationStateDeserializer","location","useLocation","useCallback","parse","useLocationStateSerializer","navigate","useNavigate","state","newUrl","stringify","useLocationStateCodec","deserializer","serializer","useMemo","useLocationStateHandler","validator","accessor","options","codec","useStateHandler","useLocationStateGetter","store","useLocationStateSetter","useLocationStateAccessor","getter","setter","useLocationState"],"mappings":";;;;AASA,MAAMA,IAA+B,MAAwB;AAC5D,QAAMC,IAAWC,EAAA;AAGjB,SAAOC;AAAA,IACN,MAAgBC,EAAMH,EAAS,OAAO,MAAM,CAAC,CAAC;AAAA,IAC9C,CAACA,CAAQ;AAAA,EAAA;AAEX,GAEMI,IAA6B,MAA0C;AAC5E,QAAMC,IAAWC,EAAA;AAEjB,SAAOJ;AAAA,IACN,OAAOK,MAAiC;AACvC,YAAMC,IAAS,IAAIC,EAAUF,CAAK,CAAC;AACnC,YAAMF,EAASG,CAAM;AAAA,IACtB;AAAA,IACA,CAACH,CAAQ;AAAA,EAAA;AAEX,GAEMK,IAAwB,MAAoC;AACjE,QAAMC,IAAeZ,EAAA,GACfa,IAAaR,EAAA;AAQnB,SAPcS;AAAA,IACb,OAA4B;AAAA,MAC3B,aAAaF;AAAA,MACb,WAAWC;AAAA,IAAA;AAAA,IAEZ,CAACD,GAAcC,CAAU;AAAA,EAAA;AAG3B,GAGME,IAA0B,CAC/BC,GACAC,GACAC,MACU;AACV,QAAMC,IAAQR,EAAA;AACd,EAAAS,EAAgBD,GAAOH,GAAWC,GAAUC,CAAO;AACpD,GAEMG,IAAyB,CAC9BC,MAEOnB,EAAY,MAAcmB,EAAM,OAAO,CAACA,CAAK,CAAC,GAGhDC,IAAyB,CAC9BD,MAEOnB;AAAA,EACN,CAACK,MAAwB;AACxB,IAAAc,EAAM,QAAQd;AAAA,EACf;AAAA,EACA,CAACc,CAAK;AAAA,GAIFE,IAA2B,CAChCF,MAC4B;AAC5B,QAAMG,IAASJ,EAAuBC,CAAK,GACrCI,IAASH,EAAuBD,CAAK;AAK3C,SAJiBR;AAAA,IAChB,OAA+B,EAAE,KAAKW,GAAQ,KAAKC,EAAA;AAAA,IACnD,CAACD,GAAQC,CAAM;AAAA,EAAA;AAGjB,GAGaC,IAAmB,CAAUL,MAAqC;AAC9E,QAAML,IAAWO,EAAyBF,CAAK,GACzCJ,IAAUJ;AAAA,IACf,OAAO;AAAA,MACN,gBAAgBQ,EAAM;AAAA,MACtB,eAAeA,EAAM;AAAA,MACrB,aAAaA,EAAM;AAAA,IAAA;AAAA,IAEpB,CAACA,CAAK;AAAA,EAAA;AAEP,EAAAP,EAAwBO,EAAM,eAAeL,GAAUC,CAAO;AAC/D;"}

package/dist/stores/IStateStore.d.ts

@@ -1,6 +1,10 @@
 import { StateChangeEvent } from './StateChangeEvent';
+import { StateRestoreEvent } from './StateRestoreEvent';
+import { StateSaveEvent } from './StateSaveEvent';
 export interface IStateStore<TState> {
     state: TState;
     validateState(state: unknown): state is TState;
+    onStateRestore?(event: StateRestoreEvent<TState>): void;
     onStateChange?(event: StateChangeEvent<TState>): void;
+    onStateSave?(event: StateSaveEvent<TState>): void;
 }

package/dist/stores/StateRestoreEvent.d.ts

@@ -0,0 +1,3 @@
+export interface StateRestoreEvent<TState> {
+    state: TState;
+}

package/dist/stores/StateSaveEvent.d.ts

@@ -0,0 +1,3 @@
+export interface StateSaveEvent<TState> {
+    state: TState;
+}

package/dist/stores/index.d.ts

@@ -1,2 +1,4 @@
 export * from './IStateStore';
 export * from './StateChangeEvent';
+export * from './StateRestoreEvent';
+export * from './StateSaveEvent';

package/dist/tanstack-router.cjs.js

@@ -1,2 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("./useStateHandler-xZNycUEj.cjs"),o=require("@tanstack/react-router"),r=require("qs"),s=require("react"),i=()=>{const e=o.useLocation();return s.useCallback(()=>r.parse(e.searchStr.slice(1)),[e])},u=()=>{const e=o.useNavigate();return s.useCallback(async t=>{await e({search:t})},[e])},l=()=>{const e=i(),t=u();return s.useMemo(()=>({deserialize:e,serialize:t}),[e,t])},S=(e,t,a)=>{const c=l();n.useStateHandler(c,e,t,a)},d=e=>s.useCallback(()=>e.state,[e]),L=e=>s.useCallback(t=>{e.state=t},[e]),g=e=>{const t=d(e),a=L(e);return s.useMemo(()=>({get:t,set:a}),[t,a])},C=e=>{const t=g(e),a=s.useMemo(()=>({onStateChange:e.onStateChange}),[e]);S(e.validateState,t,a)};exports.useLocationState=C;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("./useStateHandler-Ff_CnvN8.cjs"),c=require("@tanstack/react-router"),r=require("qs"),o=require("react"),i=()=>{const e=c.useLocation();return o.useCallback(()=>r.parse(e.searchStr.slice(1)),[e])},u=()=>{const e=c.useNavigate();return o.useCallback(async t=>{await e({search:t})},[e])},S=()=>{const e=i(),t=u();return o.useMemo(()=>({deserialize:e,serialize:t}),[e,t])},l=(e,t,a)=>{const s=S();n.useStateHandler(s,e,t,a)},d=e=>o.useCallback(()=>e.state,[e]),L=e=>o.useCallback(t=>{e.state=t},[e]),g=e=>{const t=d(e),a=L(e);return o.useMemo(()=>({get:t,set:a}),[t,a])},C=e=>{const t=g(e),a=o.useMemo(()=>({onStateRestore:e.onStateRestore,onStateChange:e.onStateChange,onStateSave:e.onStateSave}),[e]);l(e.validateState,t,a)};exports.useLocationState=C;
 //# sourceMappingURL=tanstack-router.cjs.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"tanstack-router.cjs.js","sources":["../src/tanstack-router/useLocationState.tsx"],"sourcesContent":["import type { IStateAccessor } from '@/components/IStateAccessor';\nimport type { IStateCodec } from '@/components/IStateCodec';\nimport type { IStateHandlerOptions } from '@/components/IStateHandlerOptions';\nimport { useStateHandler } from '@/components/useStateHandler';\nimport type { IStateStore } from '@/stores/IStateStore';\nimport { useLocation, useNavigate } from '@tanstack/react-router';\nimport { type ParsedQs, parse } from 'qs';\nimport { useCallback, useMemo } from 'react';\n\nconst useLocationStateDeserializer = (): (() => ParsedQs) => {\n\tconst location = useLocation();\n\n\t// Pass `location` as deps instead of `location.search`.\n\treturn useCallback(\n\t\t(): ParsedQs => parse(location.searchStr.slice(1)),\n\t\t[location],\n\t);\n};\n\nconst useLocationStateSerializer = <TState,>(): ((state: TState) => void) => {\n\tconst navigate = useNavigate();\n\n\treturn useCallback(\n\t\tasync (state: TState): Promise<void> => {\n\t\t\tawait navigate({ search: state as any /* FIXME */ });\n\t\t},\n\t\t[navigate],\n\t);\n};\n\nconst useLocationStateCodec = <TState,>(): IStateCodec<TState> => {\n\tconst deserializer = useLocationStateDeserializer();\n\tconst serializer = useLocationStateSerializer();\n\tconst codec = useMemo(\n\t\t(): IStateCodec<TState> => ({\n\t\t\tdeserialize: deserializer,\n\t\t\tserialize: serializer,\n\t\t}),\n\t\t[deserializer, serializer],\n\t);\n\treturn codec;\n};\n\n/** Updates a store that implements the {@link LocationStateStore} interface when a route changes, and vice versa. */\nconst useLocationStateHandler = <TState,>(\n\tvalidator: (state: unknown) => state is TState,\n\taccessor: IStateAccessor<TState>,\n\toptions: IStateHandlerOptions<TState>,\n): void => {\n\tconst codec = useLocationStateCodec();\n\tuseStateHandler(codec, validator, accessor, options);\n};\n\nconst useLocationStateGetter = <TState,>(\n\tstore: IStateStore<TState>,\n): (() => TState) => {\n\treturn useCallback(() => store.state, [store]);\n};\n\nconst useLocationStateSetter = <TState,>(\n\tstore: IStateStore<TState>,\n): ((state: TState) => void) => {\n\treturn useCallback(\n\t\t(state: TState) => {\n\t\t\tstore.state = state;\n\t\t},\n\t\t[store],\n\t);\n};\n\nconst useLocationStateAccessor = <TState,>(\n\tstore: IStateStore<TState>,\n): IStateAccessor<TState> => {\n\tconst getter = useLocationStateGetter(store);\n\tconst setter = useLocationStateSetter(store);\n\tconst accessor = useMemo(\n\t\t(): IStateAccessor<TState> => ({ get: getter, set: setter }),\n\t\t[getter, setter],\n\t);\n\treturn accessor;\n};\n\n/** Updates a store that implements the {@link LocationStateStore} interface when a route changes, and vice versa. */\nexport const useLocationState = <TState,>(store: IStateStore<TState>): void => {\n\tconst accessor = useLocationStateAccessor(store);\n\tconst options = useMemo(\n\t\t() => ({\n\t\t\tonStateChange: store.onStateChange,\n\t\t}),\n\t\t[store],\n\t);\n\tuseLocationStateHandler(store.validateState, accessor, options);\n};\n"],"names":["useLocationStateDeserializer","location","useLocation","useCallback","parse","useLocationStateSerializer","navigate","useNavigate","state","useLocationStateCodec","deserializer","serializer","useMemo","useLocationStateHandler","validator","accessor","options","codec","useStateHandler","useLocationStateGetter","store","useLocationStateSetter","useLocationStateAccessor","getter","setter","useLocationState"],"mappings":"yMASMA,EAA+B,IAAwB,CAC5D,MAAMC,EAAWC,EAAAA,YAAA,EAGjB,OAAOC,EAAAA,YACN,IAAgBC,EAAAA,MAAMH,EAAS,UAAU,MAAM,CAAC,CAAC,EACjD,CAACA,CAAQ,CAAA,CAEX,EAEMI,EAA6B,IAA0C,CAC5E,MAAMC,EAAWC,EAAAA,YAAA,EAEjB,OAAOJ,EAAAA,YACN,MAAOK,GAAiC,CACvC,MAAMF,EAAS,CAAE,OAAQE,CAAA,CAA0B,CACpD,EACA,CAACF,CAAQ,CAAA,CAEX,EAEMG,EAAwB,IAAoC,CACjE,MAAMC,EAAeV,EAAA,EACfW,EAAaN,EAAA,EAQnB,OAPcO,EAAAA,QACb,KAA4B,CAC3B,YAAaF,EACb,UAAWC,CAAA,GAEZ,CAACD,EAAcC,CAAU,CAAA,CAG3B,EAGME,EAA0B,CAC/BC,EACAC,EACAC,IACU,CACV,MAAMC,EAAQR,EAAA,EACdS,EAAAA,gBAAgBD,EAAOH,EAAWC,EAAUC,CAAO,CACpD,EAEMG,EACLC,GAEOjB,EAAAA,YAAY,IAAMiB,EAAM,MAAO,CAACA,CAAK,CAAC,EAGxCC,EACLD,GAEOjB,EAAAA,YACLK,GAAkB,CAClBY,EAAM,MAAQZ,CACf,EACA,CAACY,CAAK,CAAA,EAIFE,EACLF,GAC4B,CAC5B,MAAMG,EAASJ,EAAuBC,CAAK,EACrCI,EAASH,EAAuBD,CAAK,EAK3C,OAJiBR,EAAAA,QAChB,KAA+B,CAAE,IAAKW,EAAQ,IAAKC,CAAA,GACnD,CAACD,EAAQC,CAAM,CAAA,CAGjB,EAGaC,EAA6BL,GAAqC,CAC9E,MAAML,EAAWO,EAAyBF,CAAK,EACzCJ,EAAUJ,EAAAA,QACf,KAAO,CACN,cAAeQ,EAAM,aAAA,GAEtB,CAACA,CAAK,CAAA,EAEPP,EAAwBO,EAAM,cAAeL,EAAUC,CAAO,CAC/D"}
+{"version":3,"file":"tanstack-router.cjs.js","sources":["../src/tanstack-router/useLocationState.tsx"],"sourcesContent":["import type { IStateAccessor } from '@/components/IStateAccessor';\nimport type { IStateCodec } from '@/components/IStateCodec';\nimport type { IStateHandlerOptions } from '@/components/IStateHandlerOptions';\nimport { useStateHandler } from '@/components/useStateHandler';\nimport type { IStateStore } from '@/stores/IStateStore';\nimport { useLocation, useNavigate } from '@tanstack/react-router';\nimport { type ParsedQs, parse } from 'qs';\nimport { useCallback, useMemo } from 'react';\n\nconst useLocationStateDeserializer = (): (() => ParsedQs) => {\n\tconst location = useLocation();\n\n\t// Pass `location` as deps instead of `location.search`.\n\treturn useCallback(\n\t\t(): ParsedQs => parse(location.searchStr.slice(1)),\n\t\t[location],\n\t);\n};\n\nconst useLocationStateSerializer = <TState,>(): ((state: TState) => void) => {\n\tconst navigate = useNavigate();\n\n\treturn useCallback(\n\t\tasync (state: TState): Promise<void> => {\n\t\t\tawait navigate({ search: state as any /* FIXME */ });\n\t\t},\n\t\t[navigate],\n\t);\n};\n\nconst useLocationStateCodec = <TState,>(): IStateCodec<TState> => {\n\tconst deserializer = useLocationStateDeserializer();\n\tconst serializer = useLocationStateSerializer();\n\tconst codec = useMemo(\n\t\t(): IStateCodec<TState> => ({\n\t\t\tdeserialize: deserializer,\n\t\t\tserialize: serializer,\n\t\t}),\n\t\t[deserializer, serializer],\n\t);\n\treturn codec;\n};\n\n/** Updates a store that implements the {@link LocationStateStore} interface when a route changes, and vice versa. */\nconst useLocationStateHandler = <TState,>(\n\tvalidator: (state: unknown) => state is TState,\n\taccessor: IStateAccessor<TState>,\n\toptions: IStateHandlerOptions<TState>,\n): void => {\n\tconst codec = useLocationStateCodec();\n\tuseStateHandler(codec, validator, accessor, options);\n};\n\nconst useLocationStateGetter = <TState,>(\n\tstore: IStateStore<TState>,\n): (() => TState) => {\n\treturn useCallback(() => store.state, [store]);\n};\n\nconst useLocationStateSetter = <TState,>(\n\tstore: IStateStore<TState>,\n): ((state: TState) => void) => {\n\treturn useCallback(\n\t\t(state: TState) => {\n\t\t\tstore.state = state;\n\t\t},\n\t\t[store],\n\t);\n};\n\nconst useLocationStateAccessor = <TState,>(\n\tstore: IStateStore<TState>,\n): IStateAccessor<TState> => {\n\tconst getter = useLocationStateGetter(store);\n\tconst setter = useLocationStateSetter(store);\n\tconst accessor = useMemo(\n\t\t(): IStateAccessor<TState> => ({ get: getter, set: setter }),\n\t\t[getter, setter],\n\t);\n\treturn accessor;\n};\n\n/** Updates a store that implements the {@link LocationStateStore} interface when a route changes, and vice versa. */\nexport const useLocationState = <TState,>(store: IStateStore<TState>): void => {\n\tconst accessor = useLocationStateAccessor(store);\n\tconst options = useMemo(\n\t\t() => ({\n\t\t\tonStateRestore: store.onStateRestore,\n\t\t\tonStateChange: store.onStateChange,\n\t\t\tonStateSave: store.onStateSave,\n\t\t}),\n\t\t[store],\n\t);\n\tuseLocationStateHandler(store.validateState, accessor, options);\n};\n"],"names":["useLocationStateDeserializer","location","useLocation","useCallback","parse","useLocationStateSerializer","navigate","useNavigate","state","useLocationStateCodec","deserializer","serializer","useMemo","useLocationStateHandler","validator","accessor","options","codec","useStateHandler","useLocationStateGetter","store","useLocationStateSetter","useLocationStateAccessor","getter","setter","useLocationState"],"mappings":"yMASMA,EAA+B,IAAwB,CAC5D,MAAMC,EAAWC,EAAAA,YAAA,EAGjB,OAAOC,EAAAA,YACN,IAAgBC,EAAAA,MAAMH,EAAS,UAAU,MAAM,CAAC,CAAC,EACjD,CAACA,CAAQ,CAAA,CAEX,EAEMI,EAA6B,IAA0C,CAC5E,MAAMC,EAAWC,EAAAA,YAAA,EAEjB,OAAOJ,EAAAA,YACN,MAAOK,GAAiC,CACvC,MAAMF,EAAS,CAAE,OAAQE,CAAA,CAA0B,CACpD,EACA,CAACF,CAAQ,CAAA,CAEX,EAEMG,EAAwB,IAAoC,CACjE,MAAMC,EAAeV,EAAA,EACfW,EAAaN,EAAA,EAQnB,OAPcO,EAAAA,QACb,KAA4B,CAC3B,YAAaF,EACb,UAAWC,CAAA,GAEZ,CAACD,EAAcC,CAAU,CAAA,CAG3B,EAGME,EAA0B,CAC/BC,EACAC,EACAC,IACU,CACV,MAAMC,EAAQR,EAAA,EACdS,EAAAA,gBAAgBD,EAAOH,EAAWC,EAAUC,CAAO,CACpD,EAEMG,EACLC,GAEOjB,EAAAA,YAAY,IAAMiB,EAAM,MAAO,CAACA,CAAK,CAAC,EAGxCC,EACLD,GAEOjB,EAAAA,YACLK,GAAkB,CAClBY,EAAM,MAAQZ,CACf,EACA,CAACY,CAAK,CAAA,EAIFE,EACLF,GAC4B,CAC5B,MAAMG,EAASJ,EAAuBC,CAAK,EACrCI,EAASH,EAAuBD,CAAK,EAK3C,OAJiBR,EAAAA,QAChB,KAA+B,CAAE,IAAKW,EAAQ,IAAKC,CAAA,GACnD,CAACD,EAAQC,CAAM,CAAA,CAGjB,EAGaC,EAA6BL,GAAqC,CAC9E,MAAML,EAAWO,EAAyBF,CAAK,EACzCJ,EAAUJ,EAAAA,QACf,KAAO,CACN,eAAgBQ,EAAM,eACtB,cAAeA,EAAM,cACrB,YAAaA,EAAM,WAAA,GAEpB,CAACA,CAAK,CAAA,EAEPP,EAAwBO,EAAM,cAAeL,EAAUC,CAAO,CAC/D"}

package/dist/tanstack-router.es.js

@@ -1,11 +1,11 @@
-import { u as n } from "./useStateHandler-BqPWP1P7.js";
+import { u as n } from "./useStateHandler-Dbkejxjm.js";
 import { useLocation as r, useNavigate as i } from "@tanstack/react-router";
-import { parse as u } from "qs";
+import { parse as S } from "qs";
 import { useMemo as s, useCallback as a } from "react";
-const S = () => {
+const u = () => {
   const t = r();
   return a(
-    () => u(t.searchStr.slice(1)),
+    () => S(t.searchStr.slice(1)),
     [t]
   );
 }, l = () => {
@@ -20,7 +20,7 @@ const S = () => {
     [t]
   );
 }, d = () => {
-  const t = S(), e = l();
+  const t = u(), e = l();
   return s(
     () => ({
       deserialize: t,
@@ -42,16 +42,18 @@ const S = () => {
     () => ({ get: e, set: o }),
     [e, o]
   );
-}, v = (t) => {
+}, C = (t) => {
   const e = g(t), o = s(
     () => ({
-      onStateChange: t.onStateChange
+      onStateRestore: t.onStateRestore,
+      onStateChange: t.onStateChange,
+      onStateSave: t.onStateSave
     }),
     [t]
   );
   m(t.validateState, e, o);
 };
 export {
-  v as useLocationState
+  C as useLocationState
 };
 //# sourceMappingURL=tanstack-router.es.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"tanstack-router.es.js","sources":["../src/tanstack-router/useLocationState.tsx"],"sourcesContent":["import type { IStateAccessor } from '@/components/IStateAccessor';\nimport type { IStateCodec } from '@/components/IStateCodec';\nimport type { IStateHandlerOptions } from '@/components/IStateHandlerOptions';\nimport { useStateHandler } from '@/components/useStateHandler';\nimport type { IStateStore } from '@/stores/IStateStore';\nimport { useLocation, useNavigate } from '@tanstack/react-router';\nimport { type ParsedQs, parse } from 'qs';\nimport { useCallback, useMemo } from 'react';\n\nconst useLocationStateDeserializer = (): (() => ParsedQs) => {\n\tconst location = useLocation();\n\n\t// Pass `location` as deps instead of `location.search`.\n\treturn useCallback(\n\t\t(): ParsedQs => parse(location.searchStr.slice(1)),\n\t\t[location],\n\t);\n};\n\nconst useLocationStateSerializer = <TState,>(): ((state: TState) => void) => {\n\tconst navigate = useNavigate();\n\n\treturn useCallback(\n\t\tasync (state: TState): Promise<void> => {\n\t\t\tawait navigate({ search: state as any /* FIXME */ });\n\t\t},\n\t\t[navigate],\n\t);\n};\n\nconst useLocationStateCodec = <TState,>(): IStateCodec<TState> => {\n\tconst deserializer = useLocationStateDeserializer();\n\tconst serializer = useLocationStateSerializer();\n\tconst codec = useMemo(\n\t\t(): IStateCodec<TState> => ({\n\t\t\tdeserialize: deserializer,\n\t\t\tserialize: serializer,\n\t\t}),\n\t\t[deserializer, serializer],\n\t);\n\treturn codec;\n};\n\n/** Updates a store that implements the {@link LocationStateStore} interface when a route changes, and vice versa. */\nconst useLocationStateHandler = <TState,>(\n\tvalidator: (state: unknown) => state is TState,\n\taccessor: IStateAccessor<TState>,\n\toptions: IStateHandlerOptions<TState>,\n): void => {\n\tconst codec = useLocationStateCodec();\n\tuseStateHandler(codec, validator, accessor, options);\n};\n\nconst useLocationStateGetter = <TState,>(\n\tstore: IStateStore<TState>,\n): (() => TState) => {\n\treturn useCallback(() => store.state, [store]);\n};\n\nconst useLocationStateSetter = <TState,>(\n\tstore: IStateStore<TState>,\n): ((state: TState) => void) => {\n\treturn useCallback(\n\t\t(state: TState) => {\n\t\t\tstore.state = state;\n\t\t},\n\t\t[store],\n\t);\n};\n\nconst useLocationStateAccessor = <TState,>(\n\tstore: IStateStore<TState>,\n): IStateAccessor<TState> => {\n\tconst getter = useLocationStateGetter(store);\n\tconst setter = useLocationStateSetter(store);\n\tconst accessor = useMemo(\n\t\t(): IStateAccessor<TState> => ({ get: getter, set: setter }),\n\t\t[getter, setter],\n\t);\n\treturn accessor;\n};\n\n/** Updates a store that implements the {@link LocationStateStore} interface when a route changes, and vice versa. */\nexport const useLocationState = <TState,>(store: IStateStore<TState>): void => {\n\tconst accessor = useLocationStateAccessor(store);\n\tconst options = useMemo(\n\t\t() => ({\n\t\t\tonStateChange: store.onStateChange,\n\t\t}),\n\t\t[store],\n\t);\n\tuseLocationStateHandler(store.validateState, accessor, options);\n};\n"],"names":["useLocationStateDeserializer","location","useLocation","useCallback","parse","useLocationStateSerializer","navigate","useNavigate","state","useLocationStateCodec","deserializer","serializer","useMemo","useLocationStateHandler","validator","accessor","options","codec","useStateHandler","useLocationStateGetter","store","useLocationStateSetter","useLocationStateAccessor","getter","setter","useLocationState"],"mappings":";;;;AASA,MAAMA,IAA+B,MAAwB;AAC5D,QAAMC,IAAWC,EAAA;AAGjB,SAAOC;AAAA,IACN,MAAgBC,EAAMH,EAAS,UAAU,MAAM,CAAC,CAAC;AAAA,IACjD,CAACA,CAAQ;AAAA,EAAA;AAEX,GAEMI,IAA6B,MAA0C;AAC5E,QAAMC,IAAWC,EAAA;AAEjB,SAAOJ;AAAA,IACN,OAAOK,MAAiC;AACvC,YAAMF,EAAS;AAAA,QAAE,QAAQE;AAAA;AAAA,MAAA,CAA0B;AAAA,IACpD;AAAA,IACA,CAACF,CAAQ;AAAA,EAAA;AAEX,GAEMG,IAAwB,MAAoC;AACjE,QAAMC,IAAeV,EAAA,GACfW,IAAaN,EAAA;AAQnB,SAPcO;AAAA,IACb,OAA4B;AAAA,MAC3B,aAAaF;AAAA,MACb,WAAWC;AAAA,IAAA;AAAA,IAEZ,CAACD,GAAcC,CAAU;AAAA,EAAA;AAG3B,GAGME,IAA0B,CAC/BC,GACAC,GACAC,MACU;AACV,QAAMC,IAAQR,EAAA;AACd,EAAAS,EAAgBD,GAAOH,GAAWC,GAAUC,CAAO;AACpD,GAEMG,IAAyB,CAC9BC,MAEOjB,EAAY,MAAMiB,EAAM,OAAO,CAACA,CAAK,CAAC,GAGxCC,IAAyB,CAC9BD,MAEOjB;AAAA,EACN,CAACK,MAAkB;AAClB,IAAAY,EAAM,QAAQZ;AAAA,EACf;AAAA,EACA,CAACY,CAAK;AAAA,GAIFE,IAA2B,CAChCF,MAC4B;AAC5B,QAAMG,IAASJ,EAAuBC,CAAK,GACrCI,IAASH,EAAuBD,CAAK;AAK3C,SAJiBR;AAAA,IAChB,OAA+B,EAAE,KAAKW,GAAQ,KAAKC,EAAA;AAAA,IACnD,CAACD,GAAQC,CAAM;AAAA,EAAA;AAGjB,GAGaC,IAAmB,CAAUL,MAAqC;AAC9E,QAAML,IAAWO,EAAyBF,CAAK,GACzCJ,IAAUJ;AAAA,IACf,OAAO;AAAA,MACN,eAAeQ,EAAM;AAAA,IAAA;AAAA,IAEtB,CAACA,CAAK;AAAA,EAAA;AAEP,EAAAP,EAAwBO,EAAM,eAAeL,GAAUC,CAAO;AAC/D;"}
+{"version":3,"file":"tanstack-router.es.js","sources":["../src/tanstack-router/useLocationState.tsx"],"sourcesContent":["import type { IStateAccessor } from '@/components/IStateAccessor';\nimport type { IStateCodec } from '@/components/IStateCodec';\nimport type { IStateHandlerOptions } from '@/components/IStateHandlerOptions';\nimport { useStateHandler } from '@/components/useStateHandler';\nimport type { IStateStore } from '@/stores/IStateStore';\nimport { useLocation, useNavigate } from '@tanstack/react-router';\nimport { type ParsedQs, parse } from 'qs';\nimport { useCallback, useMemo } from 'react';\n\nconst useLocationStateDeserializer = (): (() => ParsedQs) => {\n\tconst location = useLocation();\n\n\t// Pass `location` as deps instead of `location.search`.\n\treturn useCallback(\n\t\t(): ParsedQs => parse(location.searchStr.slice(1)),\n\t\t[location],\n\t);\n};\n\nconst useLocationStateSerializer = <TState,>(): ((state: TState) => void) => {\n\tconst navigate = useNavigate();\n\n\treturn useCallback(\n\t\tasync (state: TState): Promise<void> => {\n\t\t\tawait navigate({ search: state as any /* FIXME */ });\n\t\t},\n\t\t[navigate],\n\t);\n};\n\nconst useLocationStateCodec = <TState,>(): IStateCodec<TState> => {\n\tconst deserializer = useLocationStateDeserializer();\n\tconst serializer = useLocationStateSerializer();\n\tconst codec = useMemo(\n\t\t(): IStateCodec<TState> => ({\n\t\t\tdeserialize: deserializer,\n\t\t\tserialize: serializer,\n\t\t}),\n\t\t[deserializer, serializer],\n\t);\n\treturn codec;\n};\n\n/** Updates a store that implements the {@link LocationStateStore} interface when a route changes, and vice versa. */\nconst useLocationStateHandler = <TState,>(\n\tvalidator: (state: unknown) => state is TState,\n\taccessor: IStateAccessor<TState>,\n\toptions: IStateHandlerOptions<TState>,\n): void => {\n\tconst codec = useLocationStateCodec();\n\tuseStateHandler(codec, validator, accessor, options);\n};\n\nconst useLocationStateGetter = <TState,>(\n\tstore: IStateStore<TState>,\n): (() => TState) => {\n\treturn useCallback(() => store.state, [store]);\n};\n\nconst useLocationStateSetter = <TState,>(\n\tstore: IStateStore<TState>,\n): ((state: TState) => void) => {\n\treturn useCallback(\n\t\t(state: TState) => {\n\t\t\tstore.state = state;\n\t\t},\n\t\t[store],\n\t);\n};\n\nconst useLocationStateAccessor = <TState,>(\n\tstore: IStateStore<TState>,\n): IStateAccessor<TState> => {\n\tconst getter = useLocationStateGetter(store);\n\tconst setter = useLocationStateSetter(store);\n\tconst accessor = useMemo(\n\t\t(): IStateAccessor<TState> => ({ get: getter, set: setter }),\n\t\t[getter, setter],\n\t);\n\treturn accessor;\n};\n\n/** Updates a store that implements the {@link LocationStateStore} interface when a route changes, and vice versa. */\nexport const useLocationState = <TState,>(store: IStateStore<TState>): void => {\n\tconst accessor = useLocationStateAccessor(store);\n\tconst options = useMemo(\n\t\t() => ({\n\t\t\tonStateRestore: store.onStateRestore,\n\t\t\tonStateChange: store.onStateChange,\n\t\t\tonStateSave: store.onStateSave,\n\t\t}),\n\t\t[store],\n\t);\n\tuseLocationStateHandler(store.validateState, accessor, options);\n};\n"],"names":["useLocationStateDeserializer","location","useLocation","useCallback","parse","useLocationStateSerializer","navigate","useNavigate","state","useLocationStateCodec","deserializer","serializer","useMemo","useLocationStateHandler","validator","accessor","options","codec","useStateHandler","useLocationStateGetter","store","useLocationStateSetter","useLocationStateAccessor","getter","setter","useLocationState"],"mappings":";;;;AASA,MAAMA,IAA+B,MAAwB;AAC5D,QAAMC,IAAWC,EAAA;AAGjB,SAAOC;AAAA,IACN,MAAgBC,EAAMH,EAAS,UAAU,MAAM,CAAC,CAAC;AAAA,IACjD,CAACA,CAAQ;AAAA,EAAA;AAEX,GAEMI,IAA6B,MAA0C;AAC5E,QAAMC,IAAWC,EAAA;AAEjB,SAAOJ;AAAA,IACN,OAAOK,MAAiC;AACvC,YAAMF,EAAS;AAAA,QAAE,QAAQE;AAAA;AAAA,MAAA,CAA0B;AAAA,IACpD;AAAA,IACA,CAACF,CAAQ;AAAA,EAAA;AAEX,GAEMG,IAAwB,MAAoC;AACjE,QAAMC,IAAeV,EAAA,GACfW,IAAaN,EAAA;AAQnB,SAPcO;AAAA,IACb,OAA4B;AAAA,MAC3B,aAAaF;AAAA,MACb,WAAWC;AAAA,IAAA;AAAA,IAEZ,CAACD,GAAcC,CAAU;AAAA,EAAA;AAG3B,GAGME,IAA0B,CAC/BC,GACAC,GACAC,MACU;AACV,QAAMC,IAAQR,EAAA;AACd,EAAAS,EAAgBD,GAAOH,GAAWC,GAAUC,CAAO;AACpD,GAEMG,IAAyB,CAC9BC,MAEOjB,EAAY,MAAMiB,EAAM,OAAO,CAACA,CAAK,CAAC,GAGxCC,IAAyB,CAC9BD,MAEOjB;AAAA,EACN,CAACK,MAAkB;AAClB,IAAAY,EAAM,QAAQZ;AAAA,EACf;AAAA,EACA,CAACY,CAAK;AAAA,GAIFE,IAA2B,CAChCF,MAC4B;AAC5B,QAAMG,IAASJ,EAAuBC,CAAK,GACrCI,IAASH,EAAuBD,CAAK;AAK3C,SAJiBR;AAAA,IAChB,OAA+B,EAAE,KAAKW,GAAQ,KAAKC,EAAA;AAAA,IACnD,CAACD,GAAQC,CAAM;AAAA,EAAA;AAGjB,GAGaC,IAAmB,CAAUL,MAAqC;AAC9E,QAAML,IAAWO,EAAyBF,CAAK,GACzCJ,IAAUJ;AAAA,IACf,OAAO;AAAA,MACN,gBAAgBQ,EAAM;AAAA,MACtB,eAAeA,EAAM;AAAA,MACrB,aAAaA,EAAM;AAAA,IAAA;AAAA,IAEpB,CAACA,CAAK;AAAA,EAAA;AAEP,EAAAP,EAAwBO,EAAM,eAAeL,GAAUC,CAAO;AAC/D;"}

package/dist/useStateHandler-Dbkejxjm.js

@@ -0,0 +1,41 @@
+import { omitBy as h, isEqual as S } from "lodash-es";
+import { reaction as l } from "mobx";
+import { useRef as C, useEffect as a, useCallback as g } from "react";
+const i = (e, u, r, t, n) => {
+  a(() => {
+    const s = u.deserialize();
+    r(s) && (e.current = !0, t.set(s), e.current = !1, n.onStateRestore?.({ state: s }));
+  }, [u, r, e, t, n]);
+}, k = (e, u, r) => {
+  const t = g(
+    (n, s) => {
+      if (!r.onStateChange) return;
+      const f = h(
+        n,
+        (m, o) => S(s[o], m)
+      ), c = Object.keys(f);
+      console.assert(c.length > 0), r.onStateChange({
+        state: n,
+        previousState: s,
+        keys: c,
+        popState: e.current
+      });
+    },
+    [e, r]
+  );
+  a(() => l(u.get, t), [u, t]), a(() => {
+    const n = u.get(), s = {};
+    e.current = !0, t(n, s), e.current = !1;
+  }, [u, e, t]);
+}, y = (e, u, r, t) => {
+  a(() => l(u.get, (n) => {
+    e.current || (r.serialize(n), t.onStateSave?.({ state: n }));
+  }), [u, e, r, t]);
+}, H = (e, u, r, t) => {
+  const n = C(!1);
+  i(n, e, u, r, t), k(n, r, t), y(n, r, e, t);
+};
+export {
+  H as u
+};
+//# sourceMappingURL=useStateHandler-Dbkejxjm.js.map

package/dist/useStateHandler-Dbkejxjm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStateHandler-Dbkejxjm.js","sources":["../src/components/useStateHandler.tsx"],"sourcesContent":["import type {\n\tIStateAccessor,\n\tIStateGetter,\n\tIStateSetter,\n} from '@/components/IStateAccessor';\nimport type {\n\tIStateCodec,\n\tIStateDeserializer,\n\tIStateSerializer,\n} from '@/components/IStateCodec';\nimport type {\n\tIHandleStateChangeOptions,\n\tIRestoreStateOptions,\n\tISaveStateOptions,\n\tIStateHandlerOptions,\n} from '@/components/IStateHandlerOptions';\nimport { isEqual, omitBy } from 'lodash-es';\nimport { reaction } from 'mobx';\nimport { type MutableRefObject, useCallback, useEffect, useRef } from 'react';\n\nconst useRestoreState = <TState,>(\n\tpopStateRef: MutableRefObject<boolean>,\n\tdeserializer: IStateDeserializer /*<TState>*/,\n\tvalidator: (state: unknown) => state is TState,\n\tsetter: IStateSetter<TState>,\n\toptions: IRestoreStateOptions<TState>,\n): void => {\n\tuseEffect(() => {\n\t\tconst state = deserializer.deserialize();\n\n\t\tif (validator(state)) {\n\t\t\tpopStateRef.current = true;\n\n\t\t\tsetter.set(state);\n\n\t\t\tpopStateRef.current = false;\n\n\t\t\toptions.onStateRestore?.({ state: state });\n\t\t}\n\t}, [deserializer, validator, popStateRef, setter, options]);\n};\n\nconst useHandleStateChange = <TState extends Partial<TState>>(\n\tpopStateRef: MutableRefObject<boolean>,\n\tgetter: IStateGetter<TState>,\n\toptions: IHandleStateChangeOptions<TState>,\n): void => {\n\tconst handleStateChange = useCallback(\n\t\t(state: TState, previousState: TState): void => {\n\t\t\tif (!options.onStateChange) return;\n\n\t\t\t// Compare the current and previous values.\n\t\t\tconst diff = omitBy(state, (v, k) =>\n\t\t\t\tisEqual(previousState[k as keyof typeof previousState], v),\n\t\t\t);\n\n\t\t\t// Assuming that the current value is `{ filter: 'Miku', page: 3939, searchType: 'Artist' }`, and the previous one is `{ filter: 'Miku', page: 1 }`,\n\t\t\t// then the diff will be `{ page: 3939, searchType: 'Artist' }`, which results in `['page', 'searchType']`.\n\t\t\tconst keys = Object.keys(diff) as (keyof TState)[];\n\t\t\tconsole.assert(keys.length > 0);\n\n\t\t\toptions.onStateChange({\n\t\t\t\tstate: state,\n\t\t\t\tpreviousState: previousState,\n\t\t\t\tkeys: keys,\n\t\t\t\tpopState: popStateRef.current,\n\t\t\t});\n\t\t},\n\t\t[popStateRef, options],\n\t);\n\n\tuseEffect(() => {\n\t\t// Returns the disposer.\n\t\treturn reaction(getter.get, handleStateChange);\n\t}, [getter, handleStateChange]);\n\n\t// This is called when the page is first loaded.\n\tuseEffect(() => {\n\t\tconst state = getter.get();\n\t\tconst previousState = {} as TState;\n\n\t\tpopStateRef.current = true;\n\n\t\thandleStateChange(state, previousState);\n\n\t\tpopStateRef.current = false;\n\t}, [getter, popStateRef, handleStateChange]);\n};\n\nconst useSaveState = <TState,>(\n\tpopStateRef: MutableRefObject<boolean>,\n\tgetter: IStateGetter<TState>,\n\tserializer: IStateSerializer<TState>,\n\toptions: ISaveStateOptions<TState>,\n): void => {\n\tuseEffect(() => {\n\t\t// Returns the disposer.\n\t\treturn reaction(getter.get, (state) => {\n\t\t\tif (popStateRef.current) return;\n\n\t\t\tserializer.serialize(state);\n\n\t\t\toptions.onStateSave?.({ state: state });\n\t\t});\n\t}, [getter, popStateRef, serializer, options]);\n};\n\nexport const useStateHandler = <TState,>(\n\tcodec: IStateCodec<TState>,\n\tvalidator: (state: unknown) => state is TState,\n\taccessor: IStateAccessor<TState>,\n\toptions: IStateHandlerOptions<TState>,\n): void => {\n\t// Whether currently processing popstate. This is to prevent adding the previous state to history.\n\tconst popStateRef = useRef(false);\n\n\tuseRestoreState(popStateRef, codec, validator, accessor, options);\n\n\t// This must be called before `useSaveState`, so that state can be changed in the `onStateChange` callback.\n\tuseHandleStateChange(popStateRef, accessor, options);\n\n\tuseSaveState(popStateRef, accessor, codec, options);\n};\n"],"names":["useRestoreState","popStateRef","deserializer","validator","setter","options","useEffect","state","useHandleStateChange","getter","handleStateChange","useCallback","previousState","diff","omitBy","v","k","isEqual","keys","reaction","useSaveState","serializer","useStateHandler","codec","accessor","useRef"],"mappings":";;;AAoBA,MAAMA,IAAkB,CACvBC,GACAC,GACAC,GACAC,GACAC,MACU;AACV,EAAAC,EAAU,MAAM;AACf,UAAMC,IAAQL,EAAa,YAAA;AAE3B,IAAIC,EAAUI,CAAK,MAClBN,EAAY,UAAU,IAEtBG,EAAO,IAAIG,CAAK,GAEhBN,EAAY,UAAU,IAEtBI,EAAQ,iBAAiB,EAAE,OAAAE,GAAc;AAAA,EAE3C,GAAG,CAACL,GAAcC,GAAWF,GAAaG,GAAQC,CAAO,CAAC;AAC3D,GAEMG,IAAuB,CAC5BP,GACAQ,GACAJ,MACU;AACV,QAAMK,IAAoBC;AAAA,IACzB,CAACJ,GAAeK,MAAgC;AAC/C,UAAI,CAACP,EAAQ,cAAe;AAG5B,YAAMQ,IAAOC;AAAA,QAAOP;AAAA,QAAO,CAACQ,GAAGC,MAC9BC,EAAQL,EAAcI,CAA+B,GAAGD,CAAC;AAAA,MAAA,GAKpDG,IAAO,OAAO,KAAKL,CAAI;AAC7B,cAAQ,OAAOK,EAAK,SAAS,CAAC,GAE9Bb,EAAQ,cAAc;AAAA,QACrB,OAAAE;AAAA,QACA,eAAAK;AAAA,QACA,MAAAM;AAAA,QACA,UAAUjB,EAAY;AAAA,MAAA,CACtB;AAAA,IACF;AAAA,IACA,CAACA,GAAaI,CAAO;AAAA,EAAA;AAGtB,EAAAC,EAAU,MAEFa,EAASV,EAAO,KAAKC,CAAiB,GAC3C,CAACD,GAAQC,CAAiB,CAAC,GAG9BJ,EAAU,MAAM;AACf,UAAMC,IAAQE,EAAO,IAAA,GACfG,IAAgB,CAAA;AAEtB,IAAAX,EAAY,UAAU,IAEtBS,EAAkBH,GAAOK,CAAa,GAEtCX,EAAY,UAAU;AAAA,EACvB,GAAG,CAACQ,GAAQR,GAAaS,CAAiB,CAAC;AAC5C,GAEMU,IAAe,CACpBnB,GACAQ,GACAY,GACAhB,MACU;AACV,EAAAC,EAAU,MAEFa,EAASV,EAAO,KAAK,CAACF,MAAU;AACtC,IAAIN,EAAY,YAEhBoB,EAAW,UAAUd,CAAK,GAE1BF,EAAQ,cAAc,EAAE,OAAAE,GAAc;AAAA,EACvC,CAAC,GACC,CAACE,GAAQR,GAAaoB,GAAYhB,CAAO,CAAC;AAC9C,GAEaiB,IAAkB,CAC9BC,GACApB,GACAqB,GACAnB,MACU;AAEV,QAAMJ,IAAcwB,EAAO,EAAK;AAEhC,EAAAzB,EAAgBC,GAAasB,GAAOpB,GAAWqB,GAAUnB,CAAO,GAGhEG,EAAqBP,GAAauB,GAAUnB,CAAO,GAEnDe,EAAanB,GAAauB,GAAUD,GAAOlB,CAAO;AACnD;"}

package/dist/useStateHandler-Ff_CnvN8.cjs

@@ -0,0 +1,2 @@
+"use strict";const l=require("lodash-es"),f=require("mobx"),c=require("react"),E=(e,u,s,t,n)=>{c.useEffect(()=>{const r=u.deserialize();s(r)&&(e.current=!0,t.set(r),e.current=!1,n.onStateRestore?.({state:r}))},[u,s,e,t,n])},i=(e,u,s)=>{const t=c.useCallback((n,r)=>{if(!s.onStateChange)return;const h=l.omitBy(n,(S,o)=>l.isEqual(r[o],S)),a=Object.keys(h);console.assert(a.length>0),s.onStateChange({state:n,previousState:r,keys:a,popState:e.current})},[e,s]);c.useEffect(()=>f.reaction(u.get,t),[u,t]),c.useEffect(()=>{const n=u.get(),r={};e.current=!0,t(n,r),e.current=!1},[u,e,t])},C=(e,u,s,t)=>{c.useEffect(()=>f.reaction(u.get,n=>{e.current||(s.serialize(n),t.onStateSave?.({state:n}))}),[u,e,s,t])},d=(e,u,s,t)=>{const n=c.useRef(!1);E(n,e,u,s,t),i(n,s,t),C(n,s,e,t)};exports.useStateHandler=d;
+//# sourceMappingURL=useStateHandler-Ff_CnvN8.cjs.map

package/dist/useStateHandler-Ff_CnvN8.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStateHandler-Ff_CnvN8.cjs","sources":["../src/components/useStateHandler.tsx"],"sourcesContent":["import type {\n\tIStateAccessor,\n\tIStateGetter,\n\tIStateSetter,\n} from '@/components/IStateAccessor';\nimport type {\n\tIStateCodec,\n\tIStateDeserializer,\n\tIStateSerializer,\n} from '@/components/IStateCodec';\nimport type {\n\tIHandleStateChangeOptions,\n\tIRestoreStateOptions,\n\tISaveStateOptions,\n\tIStateHandlerOptions,\n} from '@/components/IStateHandlerOptions';\nimport { isEqual, omitBy } from 'lodash-es';\nimport { reaction } from 'mobx';\nimport { type MutableRefObject, useCallback, useEffect, useRef } from 'react';\n\nconst useRestoreState = <TState,>(\n\tpopStateRef: MutableRefObject<boolean>,\n\tdeserializer: IStateDeserializer /*<TState>*/,\n\tvalidator: (state: unknown) => state is TState,\n\tsetter: IStateSetter<TState>,\n\toptions: IRestoreStateOptions<TState>,\n): void => {\n\tuseEffect(() => {\n\t\tconst state = deserializer.deserialize();\n\n\t\tif (validator(state)) {\n\t\t\tpopStateRef.current = true;\n\n\t\t\tsetter.set(state);\n\n\t\t\tpopStateRef.current = false;\n\n\t\t\toptions.onStateRestore?.({ state: state });\n\t\t}\n\t}, [deserializer, validator, popStateRef, setter, options]);\n};\n\nconst useHandleStateChange = <TState extends Partial<TState>>(\n\tpopStateRef: MutableRefObject<boolean>,\n\tgetter: IStateGetter<TState>,\n\toptions: IHandleStateChangeOptions<TState>,\n): void => {\n\tconst handleStateChange = useCallback(\n\t\t(state: TState, previousState: TState): void => {\n\t\t\tif (!options.onStateChange) return;\n\n\t\t\t// Compare the current and previous values.\n\t\t\tconst diff = omitBy(state, (v, k) =>\n\t\t\t\tisEqual(previousState[k as keyof typeof previousState], v),\n\t\t\t);\n\n\t\t\t// Assuming that the current value is `{ filter: 'Miku', page: 3939, searchType: 'Artist' }`, and the previous one is `{ filter: 'Miku', page: 1 }`,\n\t\t\t// then the diff will be `{ page: 3939, searchType: 'Artist' }`, which results in `['page', 'searchType']`.\n\t\t\tconst keys = Object.keys(diff) as (keyof TState)[];\n\t\t\tconsole.assert(keys.length > 0);\n\n\t\t\toptions.onStateChange({\n\t\t\t\tstate: state,\n\t\t\t\tpreviousState: previousState,\n\t\t\t\tkeys: keys,\n\t\t\t\tpopState: popStateRef.current,\n\t\t\t});\n\t\t},\n\t\t[popStateRef, options],\n\t);\n\n\tuseEffect(() => {\n\t\t// Returns the disposer.\n\t\treturn reaction(getter.get, handleStateChange);\n\t}, [getter, handleStateChange]);\n\n\t// This is called when the page is first loaded.\n\tuseEffect(() => {\n\t\tconst state = getter.get();\n\t\tconst previousState = {} as TState;\n\n\t\tpopStateRef.current = true;\n\n\t\thandleStateChange(state, previousState);\n\n\t\tpopStateRef.current = false;\n\t}, [getter, popStateRef, handleStateChange]);\n};\n\nconst useSaveState = <TState,>(\n\tpopStateRef: MutableRefObject<boolean>,\n\tgetter: IStateGetter<TState>,\n\tserializer: IStateSerializer<TState>,\n\toptions: ISaveStateOptions<TState>,\n): void => {\n\tuseEffect(() => {\n\t\t// Returns the disposer.\n\t\treturn reaction(getter.get, (state) => {\n\t\t\tif (popStateRef.current) return;\n\n\t\t\tserializer.serialize(state);\n\n\t\t\toptions.onStateSave?.({ state: state });\n\t\t});\n\t}, [getter, popStateRef, serializer, options]);\n};\n\nexport const useStateHandler = <TState,>(\n\tcodec: IStateCodec<TState>,\n\tvalidator: (state: unknown) => state is TState,\n\taccessor: IStateAccessor<TState>,\n\toptions: IStateHandlerOptions<TState>,\n): void => {\n\t// Whether currently processing popstate. This is to prevent adding the previous state to history.\n\tconst popStateRef = useRef(false);\n\n\tuseRestoreState(popStateRef, codec, validator, accessor, options);\n\n\t// This must be called before `useSaveState`, so that state can be changed in the `onStateChange` callback.\n\tuseHandleStateChange(popStateRef, accessor, options);\n\n\tuseSaveState(popStateRef, accessor, codec, options);\n};\n"],"names":["useRestoreState","popStateRef","deserializer","validator","setter","options","useEffect","state","useHandleStateChange","getter","handleStateChange","useCallback","previousState","diff","omitBy","v","k","isEqual","keys","reaction","useSaveState","serializer","useStateHandler","codec","accessor","useRef"],"mappings":"+EAoBMA,EAAkB,CACvBC,EACAC,EACAC,EACAC,EACAC,IACU,CACVC,EAAAA,UAAU,IAAM,CACf,MAAMC,EAAQL,EAAa,YAAA,EAEvBC,EAAUI,CAAK,IAClBN,EAAY,QAAU,GAEtBG,EAAO,IAAIG,CAAK,EAEhBN,EAAY,QAAU,GAEtBI,EAAQ,iBAAiB,CAAE,MAAAE,EAAc,EAE3C,EAAG,CAACL,EAAcC,EAAWF,EAAaG,EAAQC,CAAO,CAAC,CAC3D,EAEMG,EAAuB,CAC5BP,EACAQ,EACAJ,IACU,CACV,MAAMK,EAAoBC,EAAAA,YACzB,CAACJ,EAAeK,IAAgC,CAC/C,GAAI,CAACP,EAAQ,cAAe,OAG5B,MAAMQ,EAAOC,EAAAA,OAAOP,EAAO,CAACQ,EAAGC,IAC9BC,EAAAA,QAAQL,EAAcI,CAA+B,EAAGD,CAAC,CAAA,EAKpDG,EAAO,OAAO,KAAKL,CAAI,EAC7B,QAAQ,OAAOK,EAAK,OAAS,CAAC,EAE9Bb,EAAQ,cAAc,CACrB,MAAAE,EACA,cAAAK,EACA,KAAAM,EACA,SAAUjB,EAAY,OAAA,CACtB,CACF,EACA,CAACA,EAAaI,CAAO,CAAA,EAGtBC,EAAAA,UAAU,IAEFa,WAASV,EAAO,IAAKC,CAAiB,EAC3C,CAACD,EAAQC,CAAiB,CAAC,EAG9BJ,EAAAA,UAAU,IAAM,CACf,MAAMC,EAAQE,EAAO,IAAA,EACfG,EAAgB,CAAA,EAEtBX,EAAY,QAAU,GAEtBS,EAAkBH,EAAOK,CAAa,EAEtCX,EAAY,QAAU,EACvB,EAAG,CAACQ,EAAQR,EAAaS,CAAiB,CAAC,CAC5C,EAEMU,EAAe,CACpBnB,EACAQ,EACAY,EACAhB,IACU,CACVC,EAAAA,UAAU,IAEFa,WAASV,EAAO,IAAMF,GAAU,CAClCN,EAAY,UAEhBoB,EAAW,UAAUd,CAAK,EAE1BF,EAAQ,cAAc,CAAE,MAAAE,EAAc,EACvC,CAAC,EACC,CAACE,EAAQR,EAAaoB,EAAYhB,CAAO,CAAC,CAC9C,EAEaiB,EAAkB,CAC9BC,EACApB,EACAqB,EACAnB,IACU,CAEV,MAAMJ,EAAcwB,EAAAA,OAAO,EAAK,EAEhCzB,EAAgBC,EAAasB,EAAOpB,EAAWqB,EAAUnB,CAAO,EAGhEG,EAAqBP,EAAauB,EAAUnB,CAAO,EAEnDe,EAAanB,EAAauB,EAAUD,EAAOlB,CAAO,CACnD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aigamo/route-sphere",
-  "version": "2.1.1-1",
+  "version": "2.2.0",
   "type": "module",
   "dependencies": {},
   "devDependencies": {
@@ -26,7 +26,7 @@
     "eslint-plugin-prettier": "^5.5.4",
     "eslint-plugin-react": "^7.37.5",
     "eslint-plugin-react-hooks": "^7.0.1",
-    "lodash-es": "^4.17.22",
+    "lodash-es": "^4.17.23",
     "mobx": "^6.15.0",
     "mobx-react-lite": "^4.1.1",
     "prettier": "^3.7.4",
@@ -41,7 +41,7 @@
   },
   "peerDependencies": {
     "@tanstack/react-router": "^1.144.0",
-    "lodash-es": "^4.17.22",
+    "lodash-es": "^4.17.23",
     "mobx": "^6.15.0",
     "mobx-react-lite": "^3.0.0 || ^4.0.0",
     "qs": "^6.14.1",

package/dist/useStateHandler-BqPWP1P7.js

@@ -1,41 +0,0 @@
-import { omitBy as m, isEqual as h } from "lodash-es";
-import { reaction as o } from "mobx";
-import { useRef as C, useEffect as a, useCallback as g } from "react";
-const k = (n, e, t, s) => {
-  a(() => {
-    const r = e.deserialize();
-    t(r) && (n.current = !0, s.set(r), n.current = !1);
-  }, [e, t, n, s]);
-}, y = (n, e, t) => {
-  const s = g(
-    (r, u) => {
-      if (!t.onStateChange) return;
-      const l = m(
-        r,
-        (f, i) => h(u[i], f)
-      ), c = Object.keys(l);
-      console.assert(c.length > 0), t.onStateChange({
-        state: r,
-        previousState: u,
-        keys: c,
-        popState: n.current
-      });
-    },
-    [n, t]
-  );
-  a(() => o(e.get, s), [e, s]), a(() => {
-    const r = e.get(), u = {};
-    n.current = !0, s(r, u), n.current = !1;
-  }, [e, n, s]);
-}, S = (n, e, t) => {
-  a(() => o(e.get, (s) => {
-    n.current || t.serialize(s);
-  }), [e, n, t]);
-}, H = (n, e, t, s) => {
-  const r = C(!1);
-  k(r, n, e, t), y(r, t, s), S(r, t, n);
-};
-export {
-  H as u
-};
-//# sourceMappingURL=useStateHandler-BqPWP1P7.js.map

package/dist/useStateHandler-BqPWP1P7.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"useStateHandler-BqPWP1P7.js","sources":["../src/components/useStateHandler.tsx"],"sourcesContent":["import { isEqual, omitBy } from 'lodash-es';\nimport { reaction } from 'mobx';\nimport { type MutableRefObject, useCallback, useEffect, useRef } from 'react';\n\nimport type {\n\tIStateAccessor,\n\tIStateGetter,\n\tIStateSetter,\n} from './IStateAccessor';\nimport type {\n\tIStateCodec,\n\tIStateDeserializer,\n\tIStateSerializer,\n} from './IStateCodec';\nimport type {\n\tIHandleStateChangeOptions,\n\tIStateHandlerOptions,\n} from './IStateHandlerOptions';\n\nconst useRestoreState = <TState,>(\n\tpopStateRef: MutableRefObject<boolean>,\n\tdeserializer: IStateDeserializer /*<TState>*/,\n\tvalidator: (state: unknown) => state is TState,\n\tsetter: IStateSetter<TState>,\n): void => {\n\tuseEffect(() => {\n\t\tconst state = deserializer.deserialize();\n\n\t\tif (validator(state)) {\n\t\t\tpopStateRef.current = true;\n\n\t\t\tsetter.set(state);\n\n\t\t\tpopStateRef.current = false;\n\t\t}\n\t}, [deserializer, validator, popStateRef, setter]);\n};\n\nconst useHandleStateChange = <TState extends Partial<TState>>(\n\tpopStateRef: MutableRefObject<boolean>,\n\tgetter: IStateGetter<TState>,\n\toptions: IHandleStateChangeOptions<TState>,\n): void => {\n\tconst handleStateChange = useCallback(\n\t\t(state: TState, previousState: TState): void => {\n\t\t\tif (!options.onStateChange) return;\n\n\t\t\t// Compare the current and previous values.\n\t\t\tconst diff = omitBy(state, (v, k) =>\n\t\t\t\tisEqual(previousState[k as keyof typeof previousState], v),\n\t\t\t);\n\n\t\t\t// Assuming that the current value is `{ filter: 'Miku', page: 3939, searchType: 'Artist' }`, and the previous one is `{ filter: 'Miku', page: 1 }`,\n\t\t\t// then the diff will be `{ page: 3939, searchType: 'Artist' }`, which results in `['page', 'searchType']`.\n\t\t\tconst keys = Object.keys(diff) as (keyof TState)[];\n\t\t\tconsole.assert(keys.length > 0);\n\n\t\t\toptions.onStateChange({\n\t\t\t\tstate: state,\n\t\t\t\tpreviousState: previousState,\n\t\t\t\tkeys: keys,\n\t\t\t\tpopState: popStateRef.current,\n\t\t\t});\n\t\t},\n\t\t[popStateRef, options],\n\t);\n\n\tuseEffect(() => {\n\t\t// Returns the disposer.\n\t\treturn reaction(getter.get, handleStateChange);\n\t}, [getter, handleStateChange]);\n\n\t// This is called when the page is first loaded.\n\tuseEffect(() => {\n\t\tconst state = getter.get();\n\t\tconst previousState = {} as TState;\n\n\t\tpopStateRef.current = true;\n\n\t\thandleStateChange(state, previousState);\n\n\t\tpopStateRef.current = false;\n\t}, [getter, popStateRef, handleStateChange]);\n};\n\nconst useSaveState = <TState,>(\n\tpopStateRef: MutableRefObject<boolean>,\n\tgetter: IStateGetter<TState>,\n\tserializer: IStateSerializer<TState>,\n): void => {\n\tuseEffect(() => {\n\t\t// Returns the disposer.\n\t\treturn reaction(getter.get, (state) => {\n\t\t\tif (popStateRef.current) return;\n\n\t\t\tserializer.serialize(state);\n\t\t});\n\t}, [getter, popStateRef, serializer]);\n};\n\nexport const useStateHandler = <TState,>(\n\tcodec: IStateCodec<TState>,\n\tvalidator: (state: unknown) => state is TState,\n\taccessor: IStateAccessor<TState>,\n\toptions: IStateHandlerOptions<TState>,\n): void => {\n\t// Whether currently processing popstate. This is to prevent adding the previous state to history.\n\tconst popStateRef = useRef(false);\n\n\tuseRestoreState(popStateRef, codec, validator, accessor);\n\n\t// This must be called before `useSaveState`, so that state can be changed in the `onStateChange` callback.\n\tuseHandleStateChange(popStateRef, accessor, options);\n\n\tuseSaveState(popStateRef, accessor, codec);\n};\n"],"names":["useRestoreState","popStateRef","deserializer","validator","setter","useEffect","state","useHandleStateChange","getter","options","handleStateChange","useCallback","previousState","diff","omitBy","v","k","isEqual","keys","reaction","useSaveState","serializer","useStateHandler","codec","accessor","useRef"],"mappings":";;;AAmBA,MAAMA,IAAkB,CACvBC,GACAC,GACAC,GACAC,MACU;AACV,EAAAC,EAAU,MAAM;AACf,UAAMC,IAAQJ,EAAa,YAAA;AAE3B,IAAIC,EAAUG,CAAK,MAClBL,EAAY,UAAU,IAEtBG,EAAO,IAAIE,CAAK,GAEhBL,EAAY,UAAU;AAAA,EAExB,GAAG,CAACC,GAAcC,GAAWF,GAAaG,CAAM,CAAC;AAClD,GAEMG,IAAuB,CAC5BN,GACAO,GACAC,MACU;AACV,QAAMC,IAAoBC;AAAA,IACzB,CAACL,GAAeM,MAAgC;AAC/C,UAAI,CAACH,EAAQ,cAAe;AAG5B,YAAMI,IAAOC;AAAA,QAAOR;AAAA,QAAO,CAACS,GAAGC,MAC9BC,EAAQL,EAAcI,CAA+B,GAAGD,CAAC;AAAA,MAAA,GAKpDG,IAAO,OAAO,KAAKL,CAAI;AAC7B,cAAQ,OAAOK,EAAK,SAAS,CAAC,GAE9BT,EAAQ,cAAc;AAAA,QACrB,OAAAH;AAAA,QACA,eAAAM;AAAA,QACA,MAAAM;AAAA,QACA,UAAUjB,EAAY;AAAA,MAAA,CACtB;AAAA,IACF;AAAA,IACA,CAACA,GAAaQ,CAAO;AAAA,EAAA;AAGtB,EAAAJ,EAAU,MAEFc,EAASX,EAAO,KAAKE,CAAiB,GAC3C,CAACF,GAAQE,CAAiB,CAAC,GAG9BL,EAAU,MAAM;AACf,UAAMC,IAAQE,EAAO,IAAA,GACfI,IAAgB,CAAA;AAEtB,IAAAX,EAAY,UAAU,IAEtBS,EAAkBJ,GAAOM,CAAa,GAEtCX,EAAY,UAAU;AAAA,EACvB,GAAG,CAACO,GAAQP,GAAaS,CAAiB,CAAC;AAC5C,GAEMU,IAAe,CACpBnB,GACAO,GACAa,MACU;AACV,EAAAhB,EAAU,MAEFc,EAASX,EAAO,KAAK,CAACF,MAAU;AACtC,IAAIL,EAAY,WAEhBoB,EAAW,UAAUf,CAAK;AAAA,EAC3B,CAAC,GACC,CAACE,GAAQP,GAAaoB,CAAU,CAAC;AACrC,GAEaC,IAAkB,CAC9BC,GACApB,GACAqB,GACAf,MACU;AAEV,QAAMR,IAAcwB,EAAO,EAAK;AAEhC,EAAAzB,EAAgBC,GAAasB,GAAOpB,GAAWqB,CAAQ,GAGvDjB,EAAqBN,GAAauB,GAAUf,CAAO,GAEnDW,EAAanB,GAAauB,GAAUD,CAAK;AAC1C;"}

package/dist/useStateHandler-xZNycUEj.cjs

@@ -1,2 +0,0 @@
-"use strict";const l=require("lodash-es"),f=require("mobx"),r=require("react"),E=(e,n,t,s)=>{r.useEffect(()=>{const u=n.deserialize();t(u)&&(e.current=!0,s.set(u),e.current=!1)},[n,t,e,s])},C=(e,n,t)=>{const s=r.useCallback((u,c)=>{if(!t.onStateChange)return;const o=l.omitBy(u,(i,h)=>l.isEqual(c[h],i)),a=Object.keys(o);console.assert(a.length>0),t.onStateChange({state:u,previousState:c,keys:a,popState:e.current})},[e,t]);r.useEffect(()=>f.reaction(n.get,s),[n,s]),r.useEffect(()=>{const u=n.get(),c={};e.current=!0,s(u,c),e.current=!1},[n,e,s])},d=(e,n,t)=>{r.useEffect(()=>f.reaction(n.get,s=>{e.current||t.serialize(s)}),[n,e,t])},g=(e,n,t,s)=>{const u=r.useRef(!1);E(u,e,n,t),C(u,t,s),d(u,t,e)};exports.useStateHandler=g;
-//# sourceMappingURL=useStateHandler-xZNycUEj.cjs.map

package/dist/useStateHandler-xZNycUEj.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"useStateHandler-xZNycUEj.cjs","sources":["../src/components/useStateHandler.tsx"],"sourcesContent":["import { isEqual, omitBy } from 'lodash-es';\nimport { reaction } from 'mobx';\nimport { type MutableRefObject, useCallback, useEffect, useRef } from 'react';\n\nimport type {\n\tIStateAccessor,\n\tIStateGetter,\n\tIStateSetter,\n} from './IStateAccessor';\nimport type {\n\tIStateCodec,\n\tIStateDeserializer,\n\tIStateSerializer,\n} from './IStateCodec';\nimport type {\n\tIHandleStateChangeOptions,\n\tIStateHandlerOptions,\n} from './IStateHandlerOptions';\n\nconst useRestoreState = <TState,>(\n\tpopStateRef: MutableRefObject<boolean>,\n\tdeserializer: IStateDeserializer /*<TState>*/,\n\tvalidator: (state: unknown) => state is TState,\n\tsetter: IStateSetter<TState>,\n): void => {\n\tuseEffect(() => {\n\t\tconst state = deserializer.deserialize();\n\n\t\tif (validator(state)) {\n\t\t\tpopStateRef.current = true;\n\n\t\t\tsetter.set(state);\n\n\t\t\tpopStateRef.current = false;\n\t\t}\n\t}, [deserializer, validator, popStateRef, setter]);\n};\n\nconst useHandleStateChange = <TState extends Partial<TState>>(\n\tpopStateRef: MutableRefObject<boolean>,\n\tgetter: IStateGetter<TState>,\n\toptions: IHandleStateChangeOptions<TState>,\n): void => {\n\tconst handleStateChange = useCallback(\n\t\t(state: TState, previousState: TState): void => {\n\t\t\tif (!options.onStateChange) return;\n\n\t\t\t// Compare the current and previous values.\n\t\t\tconst diff = omitBy(state, (v, k) =>\n\t\t\t\tisEqual(previousState[k as keyof typeof previousState], v),\n\t\t\t);\n\n\t\t\t// Assuming that the current value is `{ filter: 'Miku', page: 3939, searchType: 'Artist' }`, and the previous one is `{ filter: 'Miku', page: 1 }`,\n\t\t\t// then the diff will be `{ page: 3939, searchType: 'Artist' }`, which results in `['page', 'searchType']`.\n\t\t\tconst keys = Object.keys(diff) as (keyof TState)[];\n\t\t\tconsole.assert(keys.length > 0);\n\n\t\t\toptions.onStateChange({\n\t\t\t\tstate: state,\n\t\t\t\tpreviousState: previousState,\n\t\t\t\tkeys: keys,\n\t\t\t\tpopState: popStateRef.current,\n\t\t\t});\n\t\t},\n\t\t[popStateRef, options],\n\t);\n\n\tuseEffect(() => {\n\t\t// Returns the disposer.\n\t\treturn reaction(getter.get, handleStateChange);\n\t}, [getter, handleStateChange]);\n\n\t// This is called when the page is first loaded.\n\tuseEffect(() => {\n\t\tconst state = getter.get();\n\t\tconst previousState = {} as TState;\n\n\t\tpopStateRef.current = true;\n\n\t\thandleStateChange(state, previousState);\n\n\t\tpopStateRef.current = false;\n\t}, [getter, popStateRef, handleStateChange]);\n};\n\nconst useSaveState = <TState,>(\n\tpopStateRef: MutableRefObject<boolean>,\n\tgetter: IStateGetter<TState>,\n\tserializer: IStateSerializer<TState>,\n): void => {\n\tuseEffect(() => {\n\t\t// Returns the disposer.\n\t\treturn reaction(getter.get, (state) => {\n\t\t\tif (popStateRef.current) return;\n\n\t\t\tserializer.serialize(state);\n\t\t});\n\t}, [getter, popStateRef, serializer]);\n};\n\nexport const useStateHandler = <TState,>(\n\tcodec: IStateCodec<TState>,\n\tvalidator: (state: unknown) => state is TState,\n\taccessor: IStateAccessor<TState>,\n\toptions: IStateHandlerOptions<TState>,\n): void => {\n\t// Whether currently processing popstate. This is to prevent adding the previous state to history.\n\tconst popStateRef = useRef(false);\n\n\tuseRestoreState(popStateRef, codec, validator, accessor);\n\n\t// This must be called before `useSaveState`, so that state can be changed in the `onStateChange` callback.\n\tuseHandleStateChange(popStateRef, accessor, options);\n\n\tuseSaveState(popStateRef, accessor, codec);\n};\n"],"names":["useRestoreState","popStateRef","deserializer","validator","setter","useEffect","state","useHandleStateChange","getter","options","handleStateChange","useCallback","previousState","diff","omitBy","v","k","isEqual","keys","reaction","useSaveState","serializer","useStateHandler","codec","accessor","useRef"],"mappings":"+EAmBMA,EAAkB,CACvBC,EACAC,EACAC,EACAC,IACU,CACVC,EAAAA,UAAU,IAAM,CACf,MAAMC,EAAQJ,EAAa,YAAA,EAEvBC,EAAUG,CAAK,IAClBL,EAAY,QAAU,GAEtBG,EAAO,IAAIE,CAAK,EAEhBL,EAAY,QAAU,GAExB,EAAG,CAACC,EAAcC,EAAWF,EAAaG,CAAM,CAAC,CAClD,EAEMG,EAAuB,CAC5BN,EACAO,EACAC,IACU,CACV,MAAMC,EAAoBC,EAAAA,YACzB,CAACL,EAAeM,IAAgC,CAC/C,GAAI,CAACH,EAAQ,cAAe,OAG5B,MAAMI,EAAOC,EAAAA,OAAOR,EAAO,CAACS,EAAGC,IAC9BC,EAAAA,QAAQL,EAAcI,CAA+B,EAAGD,CAAC,CAAA,EAKpDG,EAAO,OAAO,KAAKL,CAAI,EAC7B,QAAQ,OAAOK,EAAK,OAAS,CAAC,EAE9BT,EAAQ,cAAc,CACrB,MAAAH,EACA,cAAAM,EACA,KAAAM,EACA,SAAUjB,EAAY,OAAA,CACtB,CACF,EACA,CAACA,EAAaQ,CAAO,CAAA,EAGtBJ,EAAAA,UAAU,IAEFc,WAASX,EAAO,IAAKE,CAAiB,EAC3C,CAACF,EAAQE,CAAiB,CAAC,EAG9BL,EAAAA,UAAU,IAAM,CACf,MAAMC,EAAQE,EAAO,IAAA,EACfI,EAAgB,CAAA,EAEtBX,EAAY,QAAU,GAEtBS,EAAkBJ,EAAOM,CAAa,EAEtCX,EAAY,QAAU,EACvB,EAAG,CAACO,EAAQP,EAAaS,CAAiB,CAAC,CAC5C,EAEMU,EAAe,CACpBnB,EACAO,EACAa,IACU,CACVhB,EAAAA,UAAU,IAEFc,WAASX,EAAO,IAAMF,GAAU,CAClCL,EAAY,SAEhBoB,EAAW,UAAUf,CAAK,CAC3B,CAAC,EACC,CAACE,EAAQP,EAAaoB,CAAU,CAAC,CACrC,EAEaC,EAAkB,CAC9BC,EACApB,EACAqB,EACAf,IACU,CAEV,MAAMR,EAAcwB,EAAAA,OAAO,EAAK,EAEhCzB,EAAgBC,EAAasB,EAAOpB,EAAWqB,CAAQ,EAGvDjB,EAAqBN,EAAauB,EAAUf,CAAO,EAEnDW,EAAanB,EAAauB,EAAUD,CAAK,CAC1C"}