@yakocloud/state-vocab 2.1.2 → 2.2.1

package/README.md

@@ -149,10 +149,14 @@ const birthday = defineState({
 })
 ```
 
-### `setupStorage(tree)`
+### `setupStorage(tree, options)`
 
 Wraps a nested object of `defineState()` nodes and injects dot-separated paths into each leaf. The returned object mirrors your tree structure.
 
+| Parameter | Type | Description | Default
+|---|---|---|
+| `ssr` | `boolean \| undefined` | SSR support | false
+
 ```ts
 const storage = setupStorage({
   user: {
@@ -327,6 +331,7 @@ createRoot(document.getElementById('root')!).render(
 | `storage` | `Storage \| (() => Storage) \| undefined` | `undefined` (in-memory) |
 | `defaultValue` | `T \| undefined` | `undefined` |
 | `bidirectional` | `true \| undefined` | `undefined` |
+| `autoSet` | `true \| undefined` | `undefined` |
 | `serialize` | `(v: T) => string` | `JSON.stringify` |
 | `deserialize` | `(v: string) => T` | `JSON.parse` |
 
@@ -346,5 +351,6 @@ React context provider. Must be an ancestor of any component using `.useState()`
 | `options.delayedSet` | `number \| undefined` | Debounce delay for `onSet` in ms |
 | `options.onSet` | `(next: D, prev: D) => void \| undefined` | Callback after state change |
 | `options.bidirectional` | `true \| undefined` | bidirectional state update to sync tabs |
+| `options.autoSet` | `true \| undefined` | set the passed default value |
 
 Returns `[value, setValue, resetValue]`.

package/dist/state-vocab.cjs.js

@@ -1,8 +1,8 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const y=require("react"),B=Symbol("state-def"),A=Symbol("state-path");function ie(t,c,o){if(!c)return t;const a=c.split(".");let r=t;for(const s of a)if(r!==null&&typeof r=="object"&&s in r)r=r[s];else return o;return r===void 0?o:r}function fe(t,c,o){const a=c.replace(/\[(\d+)\]/g,".$1").split(".");let r=t;for(let s=0;s<a.length-1;s++){const f=a[s],u=a[s+1];(r[f]===void 0||r[f]===null)&&(r[f]=/^\d+$/.test(u)?[]:{}),r=r[f]}return r[a[a.length-1]]=o,t}function de(t,c=0){let o;return function(...a){o!==void 0&&clearTimeout(o),o=setTimeout(()=>{o=void 0,t.apply(this,a)},c)}}function me(t,c,o=[]){return y.useMemo(()=>de(t,c),o)}function be(t){const c=JSON.stringify(t,null,2).split(`
-`),o=[],a=[];for(const r of c){const s=r.match(/^(\s*)"([^"]+)"(\s*:\s*)(.+)$/);if(s){const[,f,u,p,v]=s;o.push(`${f}%c"${u}"%c${p}%c${v}`),a.push("color: #9cdcfe; font-weight: bold","color: #cccccc","color: #ce9178")}else o.push(`%c${r}`),a.push("color: #cccccc")}console.log(o.join(`
-`),...a,t)}var x={exports:{}},k={};var W;function ve(){if(W)return k;W=1;var t=Symbol.for("react.transitional.element"),c=Symbol.for("react.fragment");function o(a,r,s){var f=null;if(s!==void 0&&(f=""+s),r.key!==void 0&&(f=""+r.key),"key"in r){s={};for(var u in r)u!=="key"&&(s[u]=r[u])}else s=r;return r=s.ref,{$$typeof:t,type:a,key:f,ref:r!==void 0?r:null,props:s}}return k.Fragment=c,k.jsx=o,k.jsxs=o,k}var w={};var J;function Ee(){return J||(J=1,process.env.NODE_ENV!=="production"&&(function(){function t(e){if(e==null)return null;if(typeof e=="function")return e.$$typeof===ce?null:e.displayName||e.name||null;if(typeof e=="string")return e;switch(e){case S:return"Fragment";case K:return"Profiler";case h:return"StrictMode";case ne:return"Suspense";case oe:return"SuspenseList";case se:return"Activity"}if(typeof e=="object")switch(typeof e.tag=="number"&&console.error("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."),e.$$typeof){case d:return"Portal";case te:return e.displayName||"Context";case ee:return(e._context.displayName||"Context")+".Consumer";case re:var n=e.render;return e=e.displayName,e||(e=n.displayName||n.name||"",e=e!==""?"ForwardRef("+e+")":"ForwardRef"),e;case ae:return n=e.displayName||null,n!==null?n:t(e.type)||"Memo";case j:n=e._payload,e=e._init;try{return t(e(n))}catch{}}return null}function c(e){return""+e}function o(e){try{c(e);var n=!1}catch{n=!0}if(n){n=console;var i=n.error,m=typeof Symbol=="function"&&Symbol.toStringTag&&e[Symbol.toStringTag]||e.constructor.name||"Object";return i.call(n,"The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",m),c(e)}}function a(e){if(e===S)return"<>";if(typeof e=="object"&&e!==null&&e.$$typeof===j)return"<...>";try{var n=t(e);return n?"<"+n+">":"<...>"}catch{return"<...>"}}function r(){var e=N.A;return e===null?null:e.getOwner()}function s(){return Error("react-stack-top-frame")}function f(e){if(Y.call(e,"key")){var n=Object.getOwnPropertyDescriptor(e,"key").get;if(n&&n.isReactWarning)return!1}return e.key!==void 0}function u(e,n){function i(){M||(M=!0,console.error("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",n))}i.isReactWarning=!0,Object.defineProperty(e,"key",{get:i,configurable:!0})}function p(){var e=t(this.type);return D[e]||(D[e]=!0,console.error("Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release.")),e=this.props.ref,e!==void 0?e:null}function v(e,n,i,m,P,V){var b=i.ref;return e={$$typeof:_,type:e,key:n,props:i,_owner:m},(b!==void 0?b:null)!==null?Object.defineProperty(e,"ref",{enumerable:!1,get:p}):Object.defineProperty(e,"ref",{enumerable:!1,value:null}),e._store={},Object.defineProperty(e._store,"validated",{configurable:!1,enumerable:!1,writable:!0,value:0}),Object.defineProperty(e,"_debugInfo",{configurable:!1,enumerable:!1,writable:!0,value:null}),Object.defineProperty(e,"_debugStack",{configurable:!1,enumerable:!1,writable:!0,value:P}),Object.defineProperty(e,"_debugTask",{configurable:!1,enumerable:!1,writable:!0,value:V}),Object.freeze&&(Object.freeze(e.props),Object.freeze(e)),e}function l(e,n,i,m,P,V){var b=n.children;if(b!==void 0)if(m)if(ue(b)){for(m=0;m<b.length;m++)R(b[m]);Object.freeze&&Object.freeze(b)}else console.error("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");else R(b);if(Y.call(n,"key")){b=t(e);var g=Object.keys(n).filter(function(le){return le!=="key"});m=0<g.length?"{key: someKey, "+g.join(": ..., ")+": ...}":"{key: someKey}",z[b+m]||(g=0<g.length?"{"+g.join(": ..., ")+": ...}":"{}",console.error(`A props object containing a "key" prop is being spread into JSX:
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const S=require("react"),te=Symbol("state-def"),C=Symbol("state-path"),z=Symbol("state-ssr-support");function ie(t,s,o){if(!s)return t;const a=s.split(".");let r=t;for(const c of a)if(r!==null&&typeof r=="object"&&c in r)r=r[c];else return o;return r===void 0?o:r}function fe(t,s,o){const a=s.replace(/\[(\d+)\]/g,".$1").split(".");let r=t;for(let c=0;c<a.length-1;c++){const u=a[c],l=a[c+1];(r[u]===void 0||r[u]===null)&&(r[u]=/^\d+$/.test(l)?[]:{}),r=r[u]}return r[a[a.length-1]]=o,t}function de(t,s=0){let o;return function(...a){o!==void 0&&clearTimeout(o),o=setTimeout(()=>{o=void 0,t.apply(this,a)},s)}}function me(t,s,o=[]){return S.useMemo(()=>de(t,s),o)}function be(t){const s=JSON.stringify(t,null,2).split(`
+`),o=[],a=[];for(const r of s){const c=r.match(/^(\s*)"([^"]+)"(\s*:\s*)(.+)$/);if(c){const[,u,l,_,d]=c;o.push(`${u}%c"${l}"%c${_}%c${d}`),a.push("color: #9cdcfe; font-weight: bold","color: #cccccc","color: #ce9178")}else o.push(`%c${r}`),a.push("color: #cccccc")}console.log(o.join(`
+`),...a,t)}var V={exports:{}},O={};var B;function ve(){if(B)return O;B=1;var t=Symbol.for("react.transitional.element"),s=Symbol.for("react.fragment");function o(a,r,c){var u=null;if(c!==void 0&&(u=""+c),r.key!==void 0&&(u=""+r.key),"key"in r){c={};for(var l in r)l!=="key"&&(c[l]=r[l])}else c=r;return r=c.ref,{$$typeof:t,type:a,key:u,ref:r!==void 0?r:null,props:c}}return O.Fragment=s,O.jsx=o,O.jsxs=o,O}var A={};var H;function Ee(){return H||(H=1,process.env.NODE_ENV!=="production"&&(function(){function t(e){if(e==null)return null;if(typeof e=="function")return e.$$typeof===ce?null:e.displayName||e.name||null;if(typeof e=="string")return e;switch(e){case E:return"Fragment";case P:return"Profiler";case g:return"StrictMode";case x:return"Suspense";case oe:return"SuspenseList";case se:return"Activity"}if(typeof e=="object")switch(typeof e.tag=="number"&&console.error("Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."),e.$$typeof){case k:return"Portal";case h:return e.displayName||"Context";case v:return(e._context.displayName||"Context")+".Consumer";case I:var n=e.render;return e=e.displayName,e||(e=n.displayName||n.name||"",e=e!==""?"ForwardRef("+e+")":"ForwardRef"),e;case ae:return n=e.displayName||null,n!==null?n:t(e.type)||"Memo";case M:n=e._payload,e=e._init;try{return t(e(n))}catch{}}return null}function s(e){return""+e}function o(e){try{s(e);var n=!1}catch{n=!0}if(n){n=console;var i=n.error,m=typeof Symbol=="function"&&Symbol.toStringTag&&e[Symbol.toStringTag]||e.constructor.name||"Object";return i.call(n,"The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",m),s(e)}}function a(e){if(e===E)return"<>";if(typeof e=="object"&&e!==null&&e.$$typeof===M)return"<...>";try{var n=t(e);return n?"<"+n+">":"<...>"}catch{return"<...>"}}function r(){var e=Y.A;return e===null?null:e.getOwner()}function c(){return Error("react-stack-top-frame")}function u(e){if(W.call(e,"key")){var n=Object.getOwnPropertyDescriptor(e,"key").get;if(n&&n.isReactWarning)return!1}return e.key!==void 0}function l(e,n){function i(){J||(J=!0,console.error("%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",n))}i.isReactWarning=!0,Object.defineProperty(e,"key",{get:i,configurable:!0})}function _(){var e=t(this.type);return U[e]||(U[e]=!0,console.error("Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release.")),e=this.props.ref,e!==void 0?e:null}function d(e,n,i,m,j,F){var b=i.ref;return e={$$typeof:T,type:e,key:n,props:i,_owner:m},(b!==void 0?b:null)!==null?Object.defineProperty(e,"ref",{enumerable:!1,get:_}):Object.defineProperty(e,"ref",{enumerable:!1,value:null}),e._store={},Object.defineProperty(e._store,"validated",{configurable:!1,enumerable:!1,writable:!0,value:0}),Object.defineProperty(e,"_debugInfo",{configurable:!1,enumerable:!1,writable:!0,value:null}),Object.defineProperty(e,"_debugStack",{configurable:!1,enumerable:!1,writable:!0,value:j}),Object.defineProperty(e,"_debugTask",{configurable:!1,enumerable:!1,writable:!0,value:F}),Object.freeze&&(Object.freeze(e.props),Object.freeze(e)),e}function f(e,n,i,m,j,F){var b=n.children;if(b!==void 0)if(m)if(ue(b)){for(m=0;m<b.length;m++)p(b[m]);Object.freeze&&Object.freeze(b)}else console.error("React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead.");else p(b);if(W.call(n,"key")){b=t(e);var w=Object.keys(n).filter(function(le){return le!=="key"});m=0<w.length?"{key: someKey, "+w.join(": ..., ")+": ...}":"{key: someKey}",X[b+m]||(w=0<w.length?"{"+w.join(": ..., ")+": ...}":"{}",console.error(`A props object containing a "key" prop is being spread into JSX:
   let props = %s;
   <%s {...props} />
 React keys must be passed directly to JSX without using spread:
   let props = %s;
-  <%s key={someKey} {...props} />`,m,b,g,b),z[b+m]=!0)}if(b=null,i!==void 0&&(o(i),b=""+i),f(n)&&(o(n.key),b=""+n.key),"key"in n){i={};for(var $ in n)$!=="key"&&(i[$]=n[$])}else i=n;return b&&u(i,typeof e=="function"?e.displayName||e.name||"Unknown":e),v(e,b,i,r(),P,V)}function R(e){T(e)?e._store&&(e._store.validated=1):typeof e=="object"&&e!==null&&e.$$typeof===j&&(e._payload.status==="fulfilled"?T(e._payload.value)&&e._payload.value._store&&(e._payload.value._store.validated=1):e._store&&(e._store.validated=1))}function T(e){return typeof e=="object"&&e!==null&&e.$$typeof===_}var E=y,_=Symbol.for("react.transitional.element"),d=Symbol.for("react.portal"),S=Symbol.for("react.fragment"),h=Symbol.for("react.strict_mode"),K=Symbol.for("react.profiler"),ee=Symbol.for("react.consumer"),te=Symbol.for("react.context"),re=Symbol.for("react.forward_ref"),ne=Symbol.for("react.suspense"),oe=Symbol.for("react.suspense_list"),ae=Symbol.for("react.memo"),j=Symbol.for("react.lazy"),se=Symbol.for("react.activity"),ce=Symbol.for("react.client.reference"),N=E.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,Y=Object.prototype.hasOwnProperty,ue=Array.isArray,C=console.createTask?console.createTask:function(){return null};E={react_stack_bottom_frame:function(e){return e()}};var M,D={},F=E.react_stack_bottom_frame.bind(E,s)(),L=C(a(s)),z={};w.Fragment=S,w.jsx=function(e,n,i){var m=1e4>N.recentlyCreatedOwnerStacks++;return l(e,n,i,!1,m?Error("react-stack-top-frame"):F,m?C(a(e)):L)},w.jsxs=function(e,n,i){var m=1e4>N.recentlyCreatedOwnerStacks++;return l(e,n,i,!0,m?Error("react-stack-top-frame"):F,m?C(a(e)):L)}})()),w}var U;function pe(){return U||(U=1,process.env.NODE_ENV==="production"?x.exports=ve():x.exports=Ee()),x.exports}var _e=pe();const H=y.createContext({stateVocab:{},setStateVocab:()=>{}});function Se(){return y.useContext(H)}const Re=t=>{const{children:c,verbose:o}=t,[a,r]=y.useState({});return o&&be(a),_e.jsx(H.Provider,{value:{stateVocab:a,setStateVocab:r},children:c})},O=(t,c)=>o=>{const a={...o};return fe(a,t,c),a},I=(t,c)=>Z(t)??c,q=t=>{const{serialized:c,defaultValue:o,superDefaultValue:a,deserialize:r}=t;if(c===null){const s=I(o,a);return typeof s>"u"?void 0:s}return r(c)},ye=t=>typeof t=="function",Te=t=>typeof t=="function",Z=t=>Te(t)?t():t;function ge(t={}){const{serialize:c=JSON.stringify,deserialize:o=JSON.parse}=t,a=t.defaultValue,r=t.bidirectional,s=typeof window>"u"?void 0:Z(t.storage);return{[B]:!0,[A]:"",useState(f,u){u??={};const p=me(u.onSet??(()=>{}),u.delayedSet,[]),v=Se(),l=this[A],R=y.useMemo(()=>{if(!s)return;const _=s.getItem(l);return q({serialized:_,defaultValue:f,superDefaultValue:a,deserialize:o})},[l]),T=y.useMemo(()=>ie(v.stateVocab,l,R??I(f,a)),[v.stateVocab,R,l]);y.useEffect(()=>{!s||typeof R>"u"||v.setStateVocab(O(l,R))},[R]),y.useEffect(()=>{if(!u.bidirectional&&!r)return;const _=d=>{if(d.key!==l)return;const S=d.newValue,h=q({serialized:S,defaultValue:f,superDefaultValue:a,deserialize:o});v.setStateVocab(O(l,h)),p(h,E.current),E.current=h};return window.addEventListener("storage",_),()=>window.removeEventListener("storage",_)},[l,u.bidirectional,r]);const E=y.useRef(T);return[T,function(d){const S=ye(d)?d(E.current):d;v.setStateVocab(O(l,S)),p(S,E.current),s&&s.setItem(l,c(S)),E.current=S},function(){const d=I(f,a);if(typeof d>"u"){s?.removeItem(l);return}v.setStateVocab(O(l,d)),p(d,E.current),E.current=d,s&&s.setItem(l,c(d))}]},toString(){return this[A]}}}const G=new WeakMap,X=new WeakMap;function Q(t,c=""){let o=G.get(t);o||(o=new Map,G.set(t,o));const a=o.get(c);if(a)return a;const r=new Proxy(t,{get(s,f){const u=s[f],p=c?`${c}.${String(f)}`:String(f);if(u&&typeof u=="object"&&B in u){const v=u;let l=X.get(v);l||(l=new Map,X.set(v,l));const R=l.get(p);if(R)return R;const T=Reflect.ownKeys(v).filter(d=>typeof v[d]=="function"),E=Object.fromEntries(T.map(d=>[d,(...S)=>v[d].call({...v,[A]:p},...S)])),_={...v,...E};return l.set(p,_),_}return u&&typeof u=="object"?Q(u,p):u}});return o.set(c,r),r}function he(t){return Q(t)}exports.StorageProvider=Re;exports.defineState=ge;exports.setupStorage=he;
+  <%s key={someKey} {...props} />`,m,b,w,b),X[b+m]=!0)}if(b=null,i!==void 0&&(o(i),b=""+i),u(n)&&(o(n.key),b=""+n.key),"key"in n){i={};for(var L in n)L!=="key"&&(i[L]=n[L])}else i=n;return b&&l(i,typeof e=="function"?e.displayName||e.name||"Unknown":e),d(e,b,i,r(),j,F)}function p(e){R(e)?e._store&&(e._store.validated=1):typeof e=="object"&&e!==null&&e.$$typeof===M&&(e._payload.status==="fulfilled"?R(e._payload.value)&&e._payload.value._store&&(e._payload.value._store.validated=1):e._store&&(e._store.validated=1))}function R(e){return typeof e=="object"&&e!==null&&e.$$typeof===T}var y=S,T=Symbol.for("react.transitional.element"),k=Symbol.for("react.portal"),E=Symbol.for("react.fragment"),g=Symbol.for("react.strict_mode"),P=Symbol.for("react.profiler"),v=Symbol.for("react.consumer"),h=Symbol.for("react.context"),I=Symbol.for("react.forward_ref"),x=Symbol.for("react.suspense"),oe=Symbol.for("react.suspense_list"),ae=Symbol.for("react.memo"),M=Symbol.for("react.lazy"),se=Symbol.for("react.activity"),ce=Symbol.for("react.client.reference"),Y=y.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,W=Object.prototype.hasOwnProperty,ue=Array.isArray,D=console.createTask?console.createTask:function(){return null};y={react_stack_bottom_frame:function(e){return e()}};var J,U={},q=y.react_stack_bottom_frame.bind(y,c)(),G=D(a(c)),X={};A.Fragment=E,A.jsx=function(e,n,i){var m=1e4>Y.recentlyCreatedOwnerStacks++;return f(e,n,i,!1,m?Error("react-stack-top-frame"):q,m?D(a(e)):G)},A.jsxs=function(e,n,i){var m=1e4>Y.recentlyCreatedOwnerStacks++;return f(e,n,i,!0,m?Error("react-stack-top-frame"):q,m?D(a(e)):G)}})()),A}var Z;function Se(){return Z||(Z=1,process.env.NODE_ENV==="production"?V.exports=ve():V.exports=Ee()),V.exports}var pe=Se();const re=S.createContext({stateVocab:{},setStateVocab:()=>{}});function _e(){return S.useContext(re)}const Re=t=>{const{children:s,verbose:o}=t,[a,r]=S.useState({});return o&&be(a),pe.jsx(re.Provider,{value:{stateVocab:a,setStateVocab:r},children:s})},N=(t,s)=>o=>{const a={...o};return fe(a,t,s),a},Q=t=>{const{serialized:s,defaultValue:o,superDefaultValue:a,deserialize:r}=t;if(s===null){const c=$(o)??a;return typeof c>"u"?void 0:c}return r(s)},Te=t=>typeof t=="function",ye=t=>typeof t=="function",$=t=>ye(t)?t():t,ge=typeof window>"u";function he(t={}){const{serialize:s=JSON.stringify,deserialize:o=JSON.parse}=t,a=t.defaultValue,r=t.bidirectional,c=t.autoSet,u=ge?void 0:$(t.storage);return{[te]:!0,[z]:!1,[C]:"",useState(l){l??={};const _=me(l.onSet??(()=>{}),l.delayedSet,[]),d=_e(),f=this[C],p=this[z],[R,y]=S.useState(!p);S.useEffect(()=>y(!0),[]);const T=S.useMemo(()=>{if(!R||!u)return;const v=u.getItem(f);return Q({defaultValue:l.defaultValue,serialized:v,superDefaultValue:a,deserialize:o})},[f,R]),k=S.useMemo(()=>ie(d.stateVocab,f,T??$(l.defaultValue)??a),[d.stateVocab,T,f]);S.useEffect(()=>{!u||typeof T>"u"||d.setStateVocab(N(f,T))},[T]),S.useEffect(()=>{if(!l.bidirectional&&!r)return;const v=h=>{if(h.key!==f)return;const I=h.newValue,x=Q({defaultValue:l.defaultValue,superDefaultValue:a,serialized:I,deserialize:o});d.setStateVocab(N(f,x)),_(x,E.current),E.current=x};return window.addEventListener("storage",v),()=>window.removeEventListener("storage",v)},[f,l.bidirectional,r]);const E=S.useRef(k),g=v=>{const h=Te(v)?v(E.current):v;d.setStateVocab(N(f,h)),_(h,E.current),u&&u.setItem(f,s(h)),E.current=h},P=()=>{const v=$(l.defaultValue)??a;if(typeof v>"u"){u?.removeItem(f);return}d.setStateVocab(N(f,v)),_(v,E.current),E.current=v,u&&u.setItem(f,s(v))};return S.useEffect(()=>{(l.autoSet||c)&&g(k)},[]),[k,g,P]},toString(){return this[C]}}}const K=new WeakMap,ee=new WeakMap;function ne(t,s){s??={};const{path:o="",ssr:a}=s;let r=K.get(t);r||(r=new Map,K.set(t,r));const c=r.get(o);if(c)return c;const u=new Proxy(t,{get(l,_){const d=l[_],f=o?`${o}.${String(_)}`:String(_);if(d&&typeof d=="object"&&te in d){const p=d;let R=ee.get(p);R||(R=new Map,ee.set(p,R));const y=R.get(f);if(y)return y;const T=Reflect.ownKeys(p).filter(g=>typeof p[g]=="function"),k=Object.fromEntries(T.map(g=>[g,(...P)=>p[g].call({...p,[C]:f,[z]:a},...P)])),E={...p,...k};return R.set(f,E),E}return d&&typeof d=="object"?ne(d,{path:f,ssr:a}):d}});return r.set(o,u),u}function ke(t,s){return ne(t,s)}exports.StorageProvider=Re;exports.defineState=he;exports.setupStorage=ke;

package/dist/state-vocab.es.js

@@ -1,49 +1,49 @@
-import fe, { useMemo as $, createContext as de, useState as me, useContext as be, useEffect as W, useRef as ve } from "react";
-const H = Symbol("state-def"), O = Symbol("state-path");
-function Ee(t, c, o) {
-  if (!c)
+import de, { useMemo as z, createContext as me, useState as re, useContext as be, useEffect as V, useRef as ve } from "react";
+const ne = Symbol("state-def"), C = Symbol("state-path"), W = Symbol("state-ssr-support");
+function Ee(t, s, o) {
+  if (!s)
     return t;
-  const a = c.split(".");
+  const a = s.split(".");
   let r = t;
-  for (const s of a)
-    if (r !== null && typeof r == "object" && s in r)
-      r = r[s];
+  for (const c of a)
+    if (r !== null && typeof r == "object" && c in r)
+      r = r[c];
     else
       return o;
   return r === void 0 ? o : r;
 }
-function pe(t, c, o) {
-  const a = c.replace(/\[(\d+)\]/g, ".$1").split(".");
+function pe(t, s, o) {
+  const a = s.replace(/\[(\d+)\]/g, ".$1").split(".");
   let r = t;
-  for (let s = 0; s < a.length - 1; s++) {
-    const f = a[s], u = a[s + 1];
-    (r[f] === void 0 || r[f] === null) && (r[f] = /^\d+$/.test(u) ? [] : {}), r = r[f];
+  for (let c = 0; c < a.length - 1; c++) {
+    const u = a[c], l = a[c + 1];
+    (r[u] === void 0 || r[u] === null) && (r[u] = /^\d+$/.test(l) ? [] : {}), r = r[u];
   }
   return r[a[a.length - 1]] = o, t;
 }
-function _e(t, c = 0) {
+function _e(t, s = 0) {
   let o;
   return function(...a) {
     o !== void 0 && clearTimeout(o), o = setTimeout(() => {
       o = void 0, t.apply(this, a);
-    }, c);
+    }, s);
   };
 }
-function Se(t, c, o = []) {
-  return $(
-    () => _e(t, c),
+function Se(t, s, o = []) {
+  return z(
+    () => _e(t, s),
     // eslint-disable-next-line react-hooks/exhaustive-deps
     o
   );
 }
 function Re(t) {
-  const c = JSON.stringify(t, null, 2).split(`
+  const s = JSON.stringify(t, null, 2).split(`
 `), o = [], a = [];
-  for (const r of c) {
-    const s = r.match(/^(\s*)"([^"]+)"(\s*:\s*)(.+)$/);
-    if (s) {
-      const [, f, u, p, v] = s;
-      o.push(`${f}%c"${u}"%c${p}%c${v}`), a.push(
+  for (const r of s) {
+    const c = r.match(/^(\s*)"([^"]+)"(\s*:\s*)(.+)$/);
+    if (c) {
+      const [, u, l, _, d] = c;
+      o.push(`${u}%c"${l}"%c${_}%c${d}`), a.push(
         "color: #9cdcfe; font-weight: bold",
         "color: #cccccc",
         "color: #ce9178"
@@ -54,68 +54,68 @@ function Re(t) {
   console.log(o.join(`
 `), ...a, t);
 }
-var x = { exports: {} }, h = {};
-var J;
-function ye() {
-  if (J) return h;
-  J = 1;
-  var t = Symbol.for("react.transitional.element"), c = Symbol.for("react.fragment");
-  function o(a, r, s) {
-    var f = null;
-    if (s !== void 0 && (f = "" + s), r.key !== void 0 && (f = "" + r.key), "key" in r) {
-      s = {};
-      for (var u in r)
-        u !== "key" && (s[u] = r[u]);
-    } else s = r;
-    return r = s.ref, {
+var j = { exports: {} }, x = {};
+var H;
+function Te() {
+  if (H) return x;
+  H = 1;
+  var t = Symbol.for("react.transitional.element"), s = Symbol.for("react.fragment");
+  function o(a, r, c) {
+    var u = null;
+    if (c !== void 0 && (u = "" + c), r.key !== void 0 && (u = "" + r.key), "key" in r) {
+      c = {};
+      for (var l in r)
+        l !== "key" && (c[l] = r[l]);
+    } else c = r;
+    return r = c.ref, {
       $$typeof: t,
       type: a,
-      key: f,
+      key: u,
       ref: r !== void 0 ? r : null,
-      props: s
+      props: c
     };
   }
-  return h.Fragment = c, h.jsx = o, h.jsxs = o, h;
+  return x.Fragment = s, x.jsx = o, x.jsxs = o, x;
 }
-var k = {};
-var U;
-function Te() {
-  return U || (U = 1, process.env.NODE_ENV !== "production" && (function() {
+var A = {};
+var Z;
+function ye() {
+  return Z || (Z = 1, process.env.NODE_ENV !== "production" && (function() {
     function t(e) {
       if (e == null) return null;
       if (typeof e == "function")
-        return e.$$typeof === ue ? null : e.displayName || e.name || null;
+        return e.$$typeof === le ? null : e.displayName || e.name || null;
       if (typeof e == "string") return e;
       switch (e) {
-        case S:
+        case E:
           return "Fragment";
-        case ee:
+        case w:
           return "Profiler";
-        case g:
+        case y:
           return "StrictMode";
-        case oe:
+        case P:
           return "Suspense";
-        case ae:
+        case se:
           return "SuspenseList";
-        case ce:
+        case ue:
           return "Activity";
       }
       if (typeof e == "object")
         switch (typeof e.tag == "number" && console.error(
           "Received an unexpected object in getComponentNameFromType(). This is likely a bug in React. Please file an issue."
         ), e.$$typeof) {
-          case d:
+          case g:
             return "Portal";
-          case re:
+          case h:
             return e.displayName || "Context";
-          case te:
+          case v:
             return (e._context.displayName || "Context") + ".Consumer";
-          case ne:
+          case I:
             var n = e.render;
             return e = e.displayName, e || (e = n.displayName || n.name || "", e = e !== "" ? "ForwardRef(" + e + ")" : "ForwardRef"), e;
-          case se:
+          case ce:
             return n = e.displayName || null, n !== null ? n : t(e.type) || "Memo";
-          case A:
+          case Y:
             n = e._payload, e = e._init;
             try {
               return t(e(n));
@@ -124,12 +124,12 @@ function Te() {
         }
       return null;
     }
-    function c(e) {
+    function s(e) {
       return "" + e;
     }
     function o(e) {
       try {
-        c(e);
+        s(e);
         var n = !1;
       } catch {
         n = !0;
@@ -141,12 +141,12 @@ function Te() {
           n,
           "The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",
           m
-        ), c(e);
+        ), s(e);
       }
     }
     function a(e) {
-      if (e === S) return "<>";
-      if (typeof e == "object" && e !== null && e.$$typeof === A)
+      if (e === E) return "<>";
+      if (typeof e == "object" && e !== null && e.$$typeof === Y)
         return "<...>";
       try {
         var n = t(e);
@@ -156,22 +156,22 @@ function Te() {
       }
     }
     function r() {
-      var e = j.A;
+      var e = D.A;
       return e === null ? null : e.getOwner();
     }
-    function s() {
+    function c() {
       return Error("react-stack-top-frame");
     }
-    function f(e) {
-      if (Y.call(e, "key")) {
+    function u(e) {
+      if (J.call(e, "key")) {
         var n = Object.getOwnPropertyDescriptor(e, "key").get;
         if (n && n.isReactWarning) return !1;
       }
       return e.key !== void 0;
     }
-    function u(e, n) {
+    function l(e, n) {
       function i() {
-        D || (D = !0, console.error(
+        U || (U = !0, console.error(
           "%s: `key` is not a prop. Trying to access it will result in `undefined` being returned. If you need to access the same value within the child component, you should pass it as a different prop. (https://react.dev/link/special-props)",
           n
         ));
@@ -181,23 +181,23 @@ function Te() {
         configurable: !0
       });
     }
-    function p() {
+    function _() {
       var e = t(this.type);
-      return F[e] || (F[e] = !0, console.error(
+      return q[e] || (q[e] = !0, console.error(
         "Accessing element.ref was removed in React 19. ref is now a regular prop. It will be removed from the JSX Element type in a future release."
       )), e = this.props.ref, e !== void 0 ? e : null;
     }
-    function v(e, n, i, m, w, C) {
+    function d(e, n, i, m, O, M) {
       var b = i.ref;
       return e = {
-        $$typeof: _,
+        $$typeof: R,
         type: e,
         key: n,
         props: i,
         _owner: m
       }, (b !== void 0 ? b : null) !== null ? Object.defineProperty(e, "ref", {
         enumerable: !1,
-        get: p
+        get: _
       }) : Object.defineProperty(e, "ref", { enumerable: !1, value: null }), e._store = {}, Object.defineProperty(e._store, "validated", {
         configurable: !1,
         enumerable: !1,
@@ -212,33 +212,33 @@ function Te() {
         configurable: !1,
         enumerable: !1,
         writable: !0,
-        value: w
+        value: O
       }), Object.defineProperty(e, "_debugTask", {
         configurable: !1,
         enumerable: !1,
         writable: !0,
-        value: C
+        value: M
       }), Object.freeze && (Object.freeze(e.props), Object.freeze(e)), e;
     }
-    function l(e, n, i, m, w, C) {
+    function f(e, n, i, m, O, M) {
       var b = n.children;
       if (b !== void 0)
         if (m)
-          if (le(b)) {
+          if (ie(b)) {
             for (m = 0; m < b.length; m++)
-              R(b[m]);
+              p(b[m]);
             Object.freeze && Object.freeze(b);
           } else
             console.error(
               "React.jsx: Static children should always be an array. You are likely explicitly calling React.jsxs or React.jsxDEV. Use the Babel transform instead."
             );
-        else R(b);
-      if (Y.call(n, "key")) {
+        else p(b);
+      if (J.call(n, "key")) {
         b = t(e);
-        var T = Object.keys(n).filter(function(ie) {
-          return ie !== "key";
+        var k = Object.keys(n).filter(function(fe) {
+          return fe !== "key";
         });
-        m = 0 < T.length ? "{key: someKey, " + T.join(": ..., ") + ": ...}" : "{key: someKey}", z[b + m] || (T = 0 < T.length ? "{" + T.join(": ..., ") + ": ...}" : "{}", console.error(
+        m = 0 < k.length ? "{key: someKey, " + k.join(": ..., ") + ": ...}" : "{key: someKey}", B[b + m] || (k = 0 < k.length ? "{" + k.join(": ..., ") + ": ...}" : "{}", console.error(
           `A props object containing a "key" prop is being spread into JSX:
   let props = %s;
   <%s {...props} />
@@ -247,228 +247,246 @@ React keys must be passed directly to JSX without using spread:
   <%s key={someKey} {...props} />`,
           m,
           b,
-          T,
+          k,
           b
-        ), z[b + m] = !0);
+        ), B[b + m] = !0);
       }
-      if (b = null, i !== void 0 && (o(i), b = "" + i), f(n) && (o(n.key), b = "" + n.key), "key" in n) {
+      if (b = null, i !== void 0 && (o(i), b = "" + i), u(n) && (o(n.key), b = "" + n.key), "key" in n) {
         i = {};
-        for (var V in n)
-          V !== "key" && (i[V] = n[V]);
+        for (var L in n)
+          L !== "key" && (i[L] = n[L]);
       } else i = n;
-      return b && u(
+      return b && l(
         i,
         typeof e == "function" ? e.displayName || e.name || "Unknown" : e
-      ), v(
+      ), d(
         e,
         b,
         i,
         r(),
-        w,
-        C
+        O,
+        M
       );
     }
-    function R(e) {
-      y(e) ? e._store && (e._store.validated = 1) : typeof e == "object" && e !== null && e.$$typeof === A && (e._payload.status === "fulfilled" ? y(e._payload.value) && e._payload.value._store && (e._payload.value._store.validated = 1) : e._store && (e._store.validated = 1));
+    function p(e) {
+      S(e) ? e._store && (e._store.validated = 1) : typeof e == "object" && e !== null && e.$$typeof === Y && (e._payload.status === "fulfilled" ? S(e._payload.value) && e._payload.value._store && (e._payload.value._store.validated = 1) : e._store && (e._store.validated = 1));
     }
-    function y(e) {
-      return typeof e == "object" && e !== null && e.$$typeof === _;
+    function S(e) {
+      return typeof e == "object" && e !== null && e.$$typeof === R;
     }
-    var E = fe, _ = Symbol.for("react.transitional.element"), d = Symbol.for("react.portal"), S = Symbol.for("react.fragment"), g = Symbol.for("react.strict_mode"), ee = Symbol.for("react.profiler"), te = Symbol.for("react.consumer"), re = Symbol.for("react.context"), ne = Symbol.for("react.forward_ref"), oe = Symbol.for("react.suspense"), ae = Symbol.for("react.suspense_list"), se = Symbol.for("react.memo"), A = Symbol.for("react.lazy"), ce = Symbol.for("react.activity"), ue = Symbol.for("react.client.reference"), j = E.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE, Y = Object.prototype.hasOwnProperty, le = Array.isArray, N = console.createTask ? console.createTask : function() {
+    var T = de, R = Symbol.for("react.transitional.element"), g = Symbol.for("react.portal"), E = Symbol.for("react.fragment"), y = Symbol.for("react.strict_mode"), w = Symbol.for("react.profiler"), v = Symbol.for("react.consumer"), h = Symbol.for("react.context"), I = Symbol.for("react.forward_ref"), P = Symbol.for("react.suspense"), se = Symbol.for("react.suspense_list"), ce = Symbol.for("react.memo"), Y = Symbol.for("react.lazy"), ue = Symbol.for("react.activity"), le = Symbol.for("react.client.reference"), D = T.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE, J = Object.prototype.hasOwnProperty, ie = Array.isArray, F = console.createTask ? console.createTask : function() {
       return null;
     };
-    E = {
+    T = {
       react_stack_bottom_frame: function(e) {
         return e();
       }
     };
-    var D, F = {}, M = E.react_stack_bottom_frame.bind(
-      E,
-      s
-    )(), L = N(a(s)), z = {};
-    k.Fragment = S, k.jsx = function(e, n, i) {
-      var m = 1e4 > j.recentlyCreatedOwnerStacks++;
-      return l(
+    var U, q = {}, G = T.react_stack_bottom_frame.bind(
+      T,
+      c
+    )(), X = F(a(c)), B = {};
+    A.Fragment = E, A.jsx = function(e, n, i) {
+      var m = 1e4 > D.recentlyCreatedOwnerStacks++;
+      return f(
         e,
         n,
         i,
         !1,
-        m ? Error("react-stack-top-frame") : M,
-        m ? N(a(e)) : L
+        m ? Error("react-stack-top-frame") : G,
+        m ? F(a(e)) : X
       );
-    }, k.jsxs = function(e, n, i) {
-      var m = 1e4 > j.recentlyCreatedOwnerStacks++;
-      return l(
+    }, A.jsxs = function(e, n, i) {
+      var m = 1e4 > D.recentlyCreatedOwnerStacks++;
+      return f(
         e,
         n,
         i,
         !0,
-        m ? Error("react-stack-top-frame") : M,
-        m ? N(a(e)) : L
+        m ? Error("react-stack-top-frame") : G,
+        m ? F(a(e)) : X
       );
     };
-  })()), k;
+  })()), A;
 }
-var q;
-function ge() {
-  return q || (q = 1, process.env.NODE_ENV === "production" ? x.exports = ye() : x.exports = Te()), x.exports;
+var Q;
+function he() {
+  return Q || (Q = 1, process.env.NODE_ENV === "production" ? j.exports = Te() : j.exports = ye()), j.exports;
 }
-var he = ge();
-const Z = de({
+var ge = he();
+const oe = me({
   stateVocab: {},
   setStateVocab: () => {
   }
 });
 function ke() {
-  return be(Z);
+  return be(oe);
 }
 const Oe = (t) => {
-  const { children: c, verbose: o } = t, [a, r] = me({});
-  return o && Re(a), /* @__PURE__ */ he.jsx(Z.Provider, { value: { stateVocab: a, setStateVocab: r }, children: c });
-}, P = (t, c) => (o) => {
+  const { children: s, verbose: o } = t, [a, r] = re({});
+  return o && Re(a), /* @__PURE__ */ ge.jsx(oe.Provider, { value: { stateVocab: a, setStateVocab: r }, children: s });
+}, N = (t, s) => (o) => {
   const a = { ...o };
-  return pe(a, t, c), a;
-}, I = (t, c) => Q(t) ?? c, G = (t) => {
-  const { serialized: c, defaultValue: o, superDefaultValue: a, deserialize: r } = t;
-  if (c === null) {
-    const s = I(o, a);
-    return typeof s > "u" ? void 0 : s;
+  return pe(a, t, s), a;
+}, K = (t) => {
+  const { serialized: s, defaultValue: o, superDefaultValue: a, deserialize: r } = t;
+  if (s === null) {
+    const c = $(o) ?? a;
+    return typeof c > "u" ? void 0 : c;
   }
-  return r(c);
-}, we = (t) => typeof t == "function", xe = (t) => typeof t == "function", Q = (t) => xe(t) ? t() : t;
-function Ae(t = {}) {
+  return r(s);
+}, we = (t) => typeof t == "function", Pe = (t) => typeof t == "function", $ = (t) => Pe(t) ? t() : t, xe = typeof window > "u";
+function Ve(t = {}) {
   const {
-    serialize: c = JSON.stringify,
+    serialize: s = JSON.stringify,
     deserialize: o = JSON.parse
-  } = t, a = t.defaultValue, r = t.bidirectional, s = typeof window > "u" ? void 0 : Q(t.storage);
+  } = t, a = t.defaultValue, r = t.bidirectional, c = t.autoSet, u = xe ? void 0 : $(t.storage);
   return {
-    [H]: !0,
+    [ne]: !0,
     // marks this object as a leaf in the router tree
-    [O]: "",
+    [W]: !1,
+    // placeholder; injected at runtime by injectPaths()
+    [C]: "",
     // placeholder; injected at runtime by injectPaths()
-    useState(f, u) {
-      u ??= {};
-      const p = Se(
-        u.onSet ?? (() => {
+    useState(l) {
+      l ??= {};
+      const _ = Se(
+        l.onSet ?? (() => {
         }),
-        u.delayedSet,
+        l.delayedSet,
         []
-      ), v = ke(), l = this[O], R = $(
+      ), d = ke(), f = this[C], p = this[W], [S, T] = re(!p);
+      V(() => T(!0), []);
+      const R = z(
         () => {
-          if (!s)
+          if (!S || !u)
             return;
-          const _ = s.getItem(l);
-          return G({
-            serialized: _,
-            defaultValue: f,
+          const v = u.getItem(f);
+          return K({
+            defaultValue: l.defaultValue,
+            serialized: v,
             superDefaultValue: a,
             deserialize: o
           });
         },
         // eslint-disable-next-line react-hooks/exhaustive-deps
-        [l]
-      ), y = $(
+        [f, S]
+      ), g = z(
         () => Ee(
-          v.stateVocab,
-          l,
-          R ?? I(f, a)
+          d.stateVocab,
+          f,
+          R ?? $(l.defaultValue) ?? a
         ),
         // eslint-disable-next-line react-hooks/exhaustive-deps
         [
-          v.stateVocab,
+          d.stateVocab,
           R,
-          l
+          f
         ]
       );
-      W(
+      V(
         () => {
-          !s || typeof R > "u" || v.setStateVocab(P(l, R));
+          !u || typeof R > "u" || d.setStateVocab(N(f, R));
         },
         // eslint-disable-next-line react-hooks/exhaustive-deps
         [R]
-      ), W(() => {
-        if (!u.bidirectional && !r)
+      ), V(() => {
+        if (!l.bidirectional && !r)
           return;
-        const _ = (d) => {
-          if (d.key !== l)
+        const v = (h) => {
+          if (h.key !== f)
             return;
-          const S = d.newValue, g = G({
-            serialized: S,
-            defaultValue: f,
+          const I = h.newValue, P = K({
+            defaultValue: l.defaultValue,
             superDefaultValue: a,
+            serialized: I,
             deserialize: o
           });
-          v.setStateVocab(P(l, g)), p(g, E.current), E.current = g;
+          d.setStateVocab(N(f, P)), _(P, E.current), E.current = P;
         };
-        return window.addEventListener("storage", _), () => window.removeEventListener("storage", _);
+        return window.addEventListener("storage", v), () => window.removeEventListener("storage", v);
       }, [
-        l,
-        u.bidirectional,
+        f,
+        l.bidirectional,
         r
       ]);
-      const E = ve(y);
-      return [
-        y,
-        function(d) {
-          const S = we(d) ? d(E.current) : d;
-          v.setStateVocab(P(l, S)), p(S, E.current), s && s.setItem(l, c(S)), E.current = S;
-        },
-        function() {
-          const d = I(f, a);
-          if (typeof d > "u") {
-            s?.removeItem(l);
-            return;
-          }
-          v.setStateVocab(P(l, d)), p(d, E.current), E.current = d, s && s.setItem(l, c(d));
+      const E = ve(g), y = (v) => {
+        const h = we(v) ? v(E.current) : v;
+        d.setStateVocab(N(f, h)), _(h, E.current), u && u.setItem(f, s(h)), E.current = h;
+      }, w = () => {
+        const v = $(l.defaultValue) ?? a;
+        if (typeof v > "u") {
+          u?.removeItem(f);
+          return;
         }
+        d.setStateVocab(N(f, v)), _(v, E.current), E.current = v, u && u.setItem(f, s(v));
+      };
+      return V(() => {
+        (l.autoSet || c) && y(g);
+      }, []), [
+        g,
+        y,
+        w
       ];
     },
     /** Returns the fully qualified job name (dot-separated path). */
     toString() {
-      return this[O];
+      return this[C];
     }
   };
 }
-const X = /* @__PURE__ */ new WeakMap(), B = /* @__PURE__ */ new WeakMap();
-function K(t, c = "") {
-  let o = X.get(t);
-  o || (o = /* @__PURE__ */ new Map(), X.set(t, o));
-  const a = o.get(c);
-  if (a)
-    return a;
-  const r = new Proxy(t, {
-    get(s, f) {
-      const u = s[f], p = c ? `${c}.${String(f)}` : String(f);
-      if (u && typeof u == "object" && H in u) {
-        const v = u;
-        let l = B.get(v);
-        l || (l = /* @__PURE__ */ new Map(), B.set(v, l));
-        const R = l.get(p);
-        if (R)
-          return R;
-        const y = Reflect.ownKeys(v).filter(
-          (d) => typeof v[d] == "function"
-        ), E = Object.fromEntries(
-          y.map((d) => [
-            d,
-            (...S) => v[d].call(
-              { ...v, [O]: p },
-              ...S
+const ee = /* @__PURE__ */ new WeakMap(), te = /* @__PURE__ */ new WeakMap();
+function ae(t, s) {
+  s ??= {};
+  const {
+    path: o = "",
+    ssr: a
+  } = s;
+  let r = ee.get(t);
+  r || (r = /* @__PURE__ */ new Map(), ee.set(t, r));
+  const c = r.get(o);
+  if (c)
+    return c;
+  const u = new Proxy(t, {
+    get(l, _) {
+      const d = l[_], f = o ? `${o}.${String(_)}` : String(_);
+      if (d && typeof d == "object" && ne in d) {
+        const p = d;
+        let S = te.get(p);
+        S || (S = /* @__PURE__ */ new Map(), te.set(p, S));
+        const T = S.get(f);
+        if (T)
+          return T;
+        const R = Reflect.ownKeys(p).filter(
+          (y) => typeof p[y] == "function"
+        ), g = Object.fromEntries(
+          R.map((y) => [
+            y,
+            (...w) => p[y].call(
+              {
+                ...p,
+                [C]: f,
+                [W]: a
+              },
+              ...w
             )
           ])
-        ), _ = { ...v, ...E };
-        return l.set(p, _), _;
+        ), E = { ...p, ...g };
+        return S.set(f, E), E;
       }
-      return u && typeof u == "object" ? K(u, p) : u;
+      return d && typeof d == "object" ? ae(d, {
+        path: f,
+        ssr: a
+      }) : d;
     }
   });
-  return o.set(c, r), r;
+  return r.set(o, u), u;
 }
-function je(t) {
-  return K(t);
+function je(t, s) {
+  return ae(t, s);
 }
 export {
   Oe as StorageProvider,
-  Ae as defineState,
+  Ve as defineState,
   je as setupStorage
 };

package/dist/types/constants.d.ts

@@ -1,2 +1,3 @@
 export declare const STATE_DEFINITION: unique symbol;
 export declare const STATE_PATH: unique symbol;
+export declare const STATE_SSR_SUPPORT: unique symbol;

package/dist/types/setup.d.ts

@@ -1 +1,3 @@
-export declare function setupStorage<T extends object>(nativeRouter: T): T;
+export declare function setupStorage<T extends object>(native: T, options?: Partial<{
+    ssr: boolean;
+}>): T;

package/dist/types/state.d.ts

@@ -1,19 +1,24 @@
-import { STATE_DEFINITION, STATE_PATH } from "./constants";
+import { STATE_DEFINITION, STATE_PATH, STATE_SSR_SUPPORT } from "./constants";
 import type { ValueOrFactory, ValueOrTransformer } from "./types";
 export declare function defineState<T>(definitionOptions?: {
     storage?: ValueOrFactory<Storage>;
     defaultValue?: T;
     bidirectional?: true;
+    autoSet?: true;
     serialize?: (v: T) => string;
     deserialize?: (v: string) => T;
 }): {
     [STATE_DEFINITION]: boolean;
+    [STATE_SSR_SUPPORT]: boolean;
     [STATE_PATH]: string;
     useState<D = T>(this: {
         [STATE_PATH]: string;
-    }, defaultValue?: ValueOrFactory<D>, options?: {
+        [STATE_SSR_SUPPORT]: boolean;
+    }, options?: {
+        defaultValue?: ValueOrFactory<D>;
         delayedSet?: number;
         bidirectional?: true;
+        autoSet?: true;
         onSet?(nextValue: NoInfer<D>, prevValue: NoInfer<D>): void;
     }): readonly [D, (nextValue: ValueOrTransformer<D>) => void, () => void];
     /** Returns the fully qualified job name (dot-separated path). */

package/dist/types/state.utils.d.ts

@@ -3,7 +3,6 @@ import type { ValueOrTransformer, Transformer, ValueOrFactory } from "./types";
 export declare const embed: <D>(statePath: string, value: D) => (vocab: Vocab<D>) => {
     [x: string]: D;
 };
-export declare const genDefaultValue: <V>(defaultValue: ValueOrFactory<V>, superDefaltValue: unknown) => V;
 export declare const genStoredValue: <V>(options: {
     serialized: string | null;
     defaultValue: ValueOrFactory<V>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yakocloud/state-vocab",
-  "version": "2.1.2",
+  "version": "2.2.1",
   "main": "dist/state-vocab.cjs.js",
   "module": "dist/state-vocab.es.js",
   "types": "dist/types/index.d.ts",