@yakocloud/state-vocab 2.1.3 → 2.2.1

package/README.md

@@ -331,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` |
 
@@ -350,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 _=require("react"),K=Symbol("state-def"),C=Symbol("state-path"),D=Symbol("state-ssr-support");function fe(t,c,a){if(!c)return t;const s=c.split(".");let r=t;for(const o of s)if(r!==null&&typeof r=="object"&&o in r)r=r[o];else return a;return r===void 0?a:r}function de(t,c,a){const s=c.replace(/\[(\d+)\]/g,".$1").split(".");let r=t;for(let o=0;o<s.length-1;o++){const i=s[o],b=s[o+1];(r[i]===void 0||r[i]===null)&&(r[i]=/^\d+$/.test(b)?[]:{}),r=r[i]}return r[s[s.length-1]]=a,t}function me(t,c=0){let a;return function(...s){a!==void 0&&clearTimeout(a),a=setTimeout(()=>{a=void 0,t.apply(this,s)},c)}}function be(t,c,a=[]){return _.useMemo(()=>me(t,c),a)}function ve(t){const c=JSON.stringify(t,null,2).split(`
-`),a=[],s=[];for(const r of c){const o=r.match(/^(\s*)"([^"]+)"(\s*:\s*)(.+)$/);if(o){const[,i,b,R,f]=o;a.push(`${i}%c"${b}"%c${R}%c${f}`),s.push("color: #9cdcfe; font-weight: bold","color: #cccccc","color: #ce9178")}else a.push(`%c${r}`),s.push("color: #cccccc")}console.log(a.join(`
-`),...s,t)}var j={exports:{}},O={};var G;function pe(){if(G)return O;G=1;var t=Symbol.for("react.transitional.element"),c=Symbol.for("react.fragment");function a(s,r,o){var i=null;if(o!==void 0&&(i=""+o),r.key!==void 0&&(i=""+r.key),"key"in r){o={};for(var b in r)b!=="key"&&(o[b]=r[b])}else o=r;return r=o.ref,{$$typeof:t,type:s,key:i,ref:r!==void 0?r:null,props:o}}return O.Fragment=c,O.jsx=a,O.jsxs=a,O}var x={};var X;function Ee(){return X||(X=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;if(typeof e=="string")return e;switch(e){case p:return"Fragment";case v:return"Profiler";case E:return"StrictMode";case oe:return"Suspense";case ae:return"SuspenseList";case ce: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 P:return e.displayName||"Context";case h:return(e._context.displayName||"Context")+".Consumer";case ne:var n=e.render;return e=e.displayName,e||(e=n.displayName||n.name||"",e=e!==""?"ForwardRef("+e+")":"ForwardRef"),e;case se:return n=e.displayName||null,n!==null?n:t(e.type)||"Memo";case V:n=e._payload,e=e._init;try{return t(e(n))}catch{}}return null}function c(e){return""+e}function a(e){try{c(e);var n=!1}catch{n=!0}if(n){n=console;var u=n.error,d=typeof Symbol=="function"&&Symbol.toStringTag&&e[Symbol.toStringTag]||e.constructor.name||"Object";return u.call(n,"The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",d),c(e)}}function s(e){if(e===p)return"<>";if(typeof e=="object"&&e!==null&&e.$$typeof===V)return"<...>";try{var n=t(e);return n?"<"+n+">":"<...>"}catch{return"<...>"}}function r(){var e=$.A;return e===null?null:e.getOwner()}function o(){return Error("react-stack-top-frame")}function i(e){if(L.call(e,"key")){var n=Object.getOwnPropertyDescriptor(e,"key").get;if(n&&n.isReactWarning)return!1}return e.key!==void 0}function b(e,n){function u(){z||(z=!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))}u.isReactWarning=!0,Object.defineProperty(e,"key",{get:u,configurable:!0})}function R(){var e=t(this.type);return W[e]||(W[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 f(e,n,u,d,A,M){var m=u.ref;return e={$$typeof:y,type:e,key:n,props:u,_owner:d},(m!==void 0?m:null)!==null?Object.defineProperty(e,"ref",{enumerable:!1,get:R}):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:A}),Object.defineProperty(e,"_debugTask",{configurable:!1,enumerable:!1,writable:!0,value:M}),Object.freeze&&(Object.freeze(e.props),Object.freeze(e)),e}function l(e,n,u,d,A,M){var m=n.children;if(m!==void 0)if(d)if(le(m)){for(d=0;d<m.length;d++)S(m[d]);Object.freeze&&Object.freeze(m)}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 S(m);if(L.call(n,"key")){m=t(e);var w=Object.keys(n).filter(function(ie){return ie!=="key"});d=0<w.length?"{key: someKey, "+w.join(": ..., ")+": ...}":"{key: someKey}",q[m+d]||(w=0<w.length?"{"+w.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} />`,d,m,w,m),q[m+d]=!0)}if(m=null,u!==void 0&&(a(u),m=""+u),i(n)&&(a(n.key),m=""+n.key),"key"in n){u={};for(var Y in n)Y!=="key"&&(u[Y]=n[Y])}else u=n;return m&&b(u,typeof e=="function"?e.displayName||e.name||"Unknown":e),f(e,m,u,r(),A,M)}function S(e){T(e)?e._store&&(e._store.validated=1):typeof e=="object"&&e!==null&&e.$$typeof===V&&(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===y}var g=_,y=Symbol.for("react.transitional.element"),k=Symbol.for("react.portal"),p=Symbol.for("react.fragment"),E=Symbol.for("react.strict_mode"),v=Symbol.for("react.profiler"),h=Symbol.for("react.consumer"),P=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"),V=Symbol.for("react.lazy"),ce=Symbol.for("react.activity"),ue=Symbol.for("react.client.reference"),$=g.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,L=Object.prototype.hasOwnProperty,le=Array.isArray,I=console.createTask?console.createTask:function(){return null};g={react_stack_bottom_frame:function(e){return e()}};var z,W={},J=g.react_stack_bottom_frame.bind(g,o)(),U=I(s(o)),q={};x.Fragment=p,x.jsx=function(e,n,u){var d=1e4>$.recentlyCreatedOwnerStacks++;return l(e,n,u,!1,d?Error("react-stack-top-frame"):J,d?I(s(e)):U)},x.jsxs=function(e,n,u){var d=1e4>$.recentlyCreatedOwnerStacks++;return l(e,n,u,!0,d?Error("react-stack-top-frame"):J,d?I(s(e)):U)}})()),x}var B;function Se(){return B||(B=1,process.env.NODE_ENV==="production"?j.exports=pe():j.exports=Ee()),j.exports}var _e=Se();const ee=_.createContext({stateVocab:{},setStateVocab:()=>{}});function Re(){return _.useContext(ee)}const Te=t=>{const{children:c,verbose:a}=t,[s,r]=_.useState({});return a&&ve(s),_e.jsx(ee.Provider,{value:{stateVocab:s,setStateVocab:r},children:c})},N=(t,c)=>a=>{const s={...a};return de(s,t,c),s},F=(t,c)=>te(t)??c,H=t=>{const{serialized:c,defaultValue:a,superDefaultValue:s,deserialize:r}=t;if(c===null){const o=F(a,s);return typeof o>"u"?void 0:o}return r(c)},ye=t=>typeof t=="function",ge=t=>typeof t=="function",te=t=>ge(t)?t():t,he=typeof window>"u";function ke(t={}){const{serialize:c=JSON.stringify,deserialize:a=JSON.parse}=t,s=t.defaultValue,r=t.bidirectional,o=he?void 0:te(t.storage);return{[K]:!0,[D]:!1,[C]:"",useState(i,b){b??={};const R=be(b.onSet??(()=>{}),b.delayedSet,[]),f=Re(),l=this[C],S=this[D],[T,g]=_.useState(!S);_.useEffect(()=>g(!0),[]);const y=_.useMemo(()=>{if(!T||!o)return;const E=o.getItem(l);return H({serialized:E,defaultValue:i,superDefaultValue:s,deserialize:a})},[l,T]),k=_.useMemo(()=>fe(f.stateVocab,l,y??F(i,s)),[f.stateVocab,y,l]);_.useEffect(()=>{!o||typeof y>"u"||f.setStateVocab(N(l,y))},[y]),_.useEffect(()=>{if(!b.bidirectional&&!r)return;const E=v=>{if(v.key!==l)return;const h=v.newValue,P=H({serialized:h,defaultValue:i,superDefaultValue:s,deserialize:a});f.setStateVocab(N(l,P)),R(P,p.current),p.current=P};return window.addEventListener("storage",E),()=>window.removeEventListener("storage",E)},[l,b.bidirectional,r]);const p=_.useRef(k);return[k,function(v){const h=ye(v)?v(p.current):v;f.setStateVocab(N(l,h)),R(h,p.current),o&&o.setItem(l,c(h)),p.current=h},function(){const v=F(i,s);if(typeof v>"u"){o?.removeItem(l);return}f.setStateVocab(N(l,v)),R(v,p.current),p.current=v,o&&o.setItem(l,c(v))}]},toString(){return this[C]}}}const Z=new WeakMap,Q=new WeakMap;function re(t,c){c??={};const{path:a="",ssr:s}=c;let r=Z.get(t);r||(r=new Map,Z.set(t,r));const o=r.get(a);if(o)return o;const i=new Proxy(t,{get(b,R){const f=b[R],l=a?`${a}.${String(R)}`:String(R);if(f&&typeof f=="object"&&K in f){const S=f;let T=Q.get(S);T||(T=new Map,Q.set(S,T));const g=T.get(l);if(g)return g;const y=Reflect.ownKeys(S).filter(E=>typeof S[E]=="function"),k=Object.fromEntries(y.map(E=>[E,(...v)=>S[E].call({...S,[C]:l,[D]:s},...v)])),p={...S,...k};return T.set(l,p),p}return f&&typeof f=="object"?re(f,{path:l,ssr:s}):f}});return r.set(a,i),i}function we(t,c){return re(t,c)}exports.StorageProvider=Te;exports.defineState=ke;exports.setupStorage=we;
+  <%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,121 +1,121 @@
-import me, { useMemo as F, createContext as be, useState as ee, useContext as ve, useEffect as D, useRef as pe } from "react";
-const te = Symbol("state-def"), N = Symbol("state-path"), M = Symbol("state-ssr-support");
-function Ee(t, c, a) {
-  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 s = c.split(".");
+  const a = s.split(".");
   let r = t;
-  for (const o of s)
-    if (r !== null && typeof r == "object" && o in r)
-      r = r[o];
+  for (const c of a)
+    if (r !== null && typeof r == "object" && c in r)
+      r = r[c];
     else
-      return a;
-  return r === void 0 ? a : r;
+      return o;
+  return r === void 0 ? o : r;
 }
-function _e(t, c, a) {
-  const s = c.replace(/\[(\d+)\]/g, ".$1").split(".");
+function pe(t, s, o) {
+  const a = s.replace(/\[(\d+)\]/g, ".$1").split(".");
   let r = t;
-  for (let o = 0; o < s.length - 1; o++) {
-    const i = s[o], b = s[o + 1];
-    (r[i] === void 0 || r[i] === null) && (r[i] = /^\d+$/.test(b) ? [] : {}), r = r[i];
+  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[s[s.length - 1]] = a, t;
+  return r[a[a.length - 1]] = o, t;
 }
-function Se(t, c = 0) {
-  let a;
-  return function(...s) {
-    a !== void 0 && clearTimeout(a), a = setTimeout(() => {
-      a = void 0, t.apply(this, s);
-    }, c);
+function _e(t, s = 0) {
+  let o;
+  return function(...a) {
+    o !== void 0 && clearTimeout(o), o = setTimeout(() => {
+      o = void 0, t.apply(this, a);
+    }, s);
   };
 }
-function Re(t, c, a = []) {
-  return F(
-    () => Se(t, c),
+function Se(t, s, o = []) {
+  return z(
+    () => _e(t, s),
     // eslint-disable-next-line react-hooks/exhaustive-deps
-    a
+    o
   );
 }
-function Te(t) {
-  const c = JSON.stringify(t, null, 2).split(`
-`), a = [], s = [];
-  for (const r of c) {
-    const o = r.match(/^(\s*)"([^"]+)"(\s*:\s*)(.+)$/);
-    if (o) {
-      const [, i, b, S, f] = o;
-      a.push(`${i}%c"${b}"%c${S}%c${f}`), s.push(
+function Re(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
-      a.push(`%c${r}`), s.push("color: #cccccc");
+      o.push(`%c${r}`), a.push("color: #cccccc");
   }
-  console.log(a.join(`
-`), ...s, t);
+  console.log(o.join(`
+`), ...a, t);
 }
-var A = { exports: {} }, P = {};
-var X;
-function ye() {
-  if (X) return P;
-  X = 1;
-  var t = Symbol.for("react.transitional.element"), c = Symbol.for("react.fragment");
-  function a(s, r, o) {
-    var i = null;
-    if (o !== void 0 && (i = "" + o), r.key !== void 0 && (i = "" + r.key), "key" in r) {
-      o = {};
-      for (var b in r)
-        b !== "key" && (o[b] = r[b]);
-    } else o = r;
-    return r = o.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: s,
-      key: i,
+      type: a,
+      key: u,
       ref: r !== void 0 ? r : null,
-      props: o
+      props: c
     };
   }
-  return P.Fragment = c, P.jsx = a, P.jsxs = a, P;
+  return x.Fragment = s, x.jsx = o, x.jsxs = o, x;
 }
-var x = {};
-var B;
-function ge() {
-  return B || (B = 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 === ie ? 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 p:
+        case E:
           return "Fragment";
-        case v:
+        case w:
           return "Profiler";
-        case E:
+        case y:
           return "StrictMode";
-        case se:
+        case P:
           return "Suspense";
-        case ce:
+        case se:
           return "SuspenseList";
-        case le:
+        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 h:
+          case g:
             return "Portal";
-          case w:
+          case h:
             return e.displayName || "Context";
-          case g:
+          case v:
             return (e._context.displayName || "Context") + ".Consumer";
-          case ae:
+          case I:
             var n = e.render;
             return e = e.displayName, e || (e = n.displayName || n.name || "", e = e !== "" ? "ForwardRef(" + e + ")" : "ForwardRef"), e;
-          case ue:
+          case ce:
             return n = e.displayName || null, n !== null ? n : t(e.type) || "Memo";
-          case C:
+          case Y:
             n = e._payload, e = e._init;
             try {
               return t(e(n));
@@ -124,29 +124,29 @@ function ge() {
         }
       return null;
     }
-    function c(e) {
+    function s(e) {
       return "" + e;
     }
-    function a(e) {
+    function o(e) {
       try {
-        c(e);
+        s(e);
         var n = !1;
       } catch {
         n = !0;
       }
       if (n) {
         n = console;
-        var u = n.error, d = typeof Symbol == "function" && Symbol.toStringTag && e[Symbol.toStringTag] || e.constructor.name || "Object";
-        return u.call(
+        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.",
-          d
-        ), c(e);
+          m
+        ), s(e);
       }
     }
-    function s(e) {
-      if (e === p) return "<>";
-      if (typeof e == "object" && e !== null && e.$$typeof === C)
+    function a(e) {
+      if (e === E) return "<>";
+      if (typeof e == "object" && e !== null && e.$$typeof === Y)
         return "<...>";
       try {
         var n = t(e);
@@ -156,48 +156,48 @@ function ge() {
       }
     }
     function r() {
-      var e = V.A;
+      var e = D.A;
       return e === null ? null : e.getOwner();
     }
-    function o() {
+    function c() {
       return Error("react-stack-top-frame");
     }
-    function i(e) {
-      if (z.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 b(e, n) {
-      function u() {
-        W || (W = !0, console.error(
+    function l(e, n) {
+      function i() {
+        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
         ));
       }
-      u.isReactWarning = !0, Object.defineProperty(e, "key", {
-        get: u,
+      i.isReactWarning = !0, Object.defineProperty(e, "key", {
+        get: i,
         configurable: !0
       });
     }
-    function S() {
+    function _() {
       var e = t(this.type);
-      return J[e] || (J[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 f(e, n, u, d, O, I) {
-      var m = u.ref;
+    function d(e, n, i, m, O, M) {
+      var b = i.ref;
       return e = {
-        $$typeof: T,
+        $$typeof: R,
         type: e,
         key: n,
-        props: u,
-        _owner: d
-      }, (m !== void 0 ? m : null) !== null ? Object.defineProperty(e, "ref", {
+        props: i,
+        _owner: m
+      }, (b !== void 0 ? b : null) !== null ? Object.defineProperty(e, "ref", {
         enumerable: !1,
-        get: S
+        get: _
       }) : Object.defineProperty(e, "ref", { enumerable: !1, value: null }), e._store = {}, Object.defineProperty(e._store, "validated", {
         configurable: !1,
         enumerable: !1,
@@ -217,274 +217,276 @@ function ge() {
         configurable: !1,
         enumerable: !1,
         writable: !0,
-        value: I
+        value: M
       }), Object.freeze && (Object.freeze(e.props), Object.freeze(e)), e;
     }
-    function l(e, n, u, d, O, I) {
-      var m = n.children;
-      if (m !== void 0)
-        if (d)
-          if (fe(m)) {
-            for (d = 0; d < m.length; d++)
-              _(m[d]);
-            Object.freeze && Object.freeze(m);
+    function f(e, n, i, m, O, M) {
+      var b = n.children;
+      if (b !== void 0)
+        if (m)
+          if (ie(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 _(m);
-      if (z.call(n, "key")) {
-        m = t(e);
-        var k = Object.keys(n).filter(function(de) {
-          return de !== "key";
+        else p(b);
+      if (J.call(n, "key")) {
+        b = t(e);
+        var k = Object.keys(n).filter(function(fe) {
+          return fe !== "key";
         });
-        d = 0 < k.length ? "{key: someKey, " + k.join(": ..., ") + ": ...}" : "{key: someKey}", G[m + d] || (k = 0 < k.length ? "{" + k.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} />
 React keys must be passed directly to JSX without using spread:
   let props = %s;
   <%s key={someKey} {...props} />`,
-          d,
           m,
+          b,
           k,
-          m
-        ), G[m + d] = !0);
+          b
+        ), B[b + m] = !0);
       }
-      if (m = null, u !== void 0 && (a(u), m = "" + u), i(n) && (a(n.key), m = "" + n.key), "key" in n) {
-        u = {};
-        for (var Y in n)
-          Y !== "key" && (u[Y] = n[Y]);
-      } else u = n;
-      return m && b(
-        u,
+      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
-      ), f(
+      ), d(
         e,
-        m,
-        u,
+        b,
+        i,
         r(),
         O,
-        I
+        M
       );
     }
-    function _(e) {
-      R(e) ? e._store && (e._store.validated = 1) : typeof e == "object" && e !== null && e.$$typeof === C && (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 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 R(e) {
-      return typeof e == "object" && e !== null && e.$$typeof === T;
+    function S(e) {
+      return typeof e == "object" && e !== null && e.$$typeof === R;
     }
-    var y = me, T = Symbol.for("react.transitional.element"), h = Symbol.for("react.portal"), p = Symbol.for("react.fragment"), E = Symbol.for("react.strict_mode"), v = Symbol.for("react.profiler"), g = Symbol.for("react.consumer"), w = Symbol.for("react.context"), ae = Symbol.for("react.forward_ref"), se = Symbol.for("react.suspense"), ce = Symbol.for("react.suspense_list"), ue = Symbol.for("react.memo"), C = Symbol.for("react.lazy"), le = Symbol.for("react.activity"), ie = Symbol.for("react.client.reference"), V = y.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE, z = Object.prototype.hasOwnProperty, fe = Array.isArray, $ = 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;
     };
-    y = {
+    T = {
       react_stack_bottom_frame: function(e) {
         return e();
       }
     };
-    var W, J = {}, U = y.react_stack_bottom_frame.bind(
-      y,
-      o
-    )(), q = $(s(o)), G = {};
-    x.Fragment = p, x.jsx = function(e, n, u) {
-      var d = 1e4 > V.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,
-        u,
+        i,
         !1,
-        d ? Error("react-stack-top-frame") : U,
-        d ? $(s(e)) : q
+        m ? Error("react-stack-top-frame") : G,
+        m ? F(a(e)) : X
       );
-    }, x.jsxs = function(e, n, u) {
-      var d = 1e4 > V.recentlyCreatedOwnerStacks++;
-      return l(
+    }, A.jsxs = function(e, n, i) {
+      var m = 1e4 > D.recentlyCreatedOwnerStacks++;
+      return f(
         e,
         n,
-        u,
+        i,
         !0,
-        d ? Error("react-stack-top-frame") : U,
-        d ? $(s(e)) : q
+        m ? Error("react-stack-top-frame") : G,
+        m ? F(a(e)) : X
       );
     };
-  })()), x;
+  })()), A;
 }
-var H;
+var Q;
 function he() {
-  return H || (H = 1, process.env.NODE_ENV === "production" ? A.exports = ye() : A.exports = ge()), A.exports;
+  return Q || (Q = 1, process.env.NODE_ENV === "production" ? j.exports = Te() : j.exports = ye()), j.exports;
 }
-var ke = he();
-const re = be({
+var ge = he();
+const oe = me({
   stateVocab: {},
   setStateVocab: () => {
   }
 });
-function we() {
-  return ve(re);
+function ke() {
+  return be(oe);
 }
-const je = (t) => {
-  const { children: c, verbose: a } = t, [s, r] = ee({});
-  return a && Te(s), /* @__PURE__ */ ke.jsx(re.Provider, { value: { stateVocab: s, setStateVocab: r }, children: c });
-}, j = (t, c) => (a) => {
-  const s = { ...a };
-  return _e(s, t, c), s;
-}, L = (t, c) => ne(t) ?? c, Z = (t) => {
-  const { serialized: c, defaultValue: a, superDefaultValue: s, deserialize: r } = t;
-  if (c === null) {
-    const o = L(a, s);
-    return typeof o > "u" ? void 0 : o;
+const Oe = (t) => {
+  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, 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);
-}, Pe = (t) => typeof t == "function", xe = (t) => typeof t == "function", ne = (t) => xe(t) ? t() : t, Oe = typeof window > "u";
-function Ne(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,
-    deserialize: a = JSON.parse
-  } = t, s = t.defaultValue, r = t.bidirectional, o = Oe ? void 0 : ne(t.storage);
+    serialize: s = JSON.stringify,
+    deserialize: o = JSON.parse
+  } = t, a = t.defaultValue, r = t.bidirectional, c = t.autoSet, u = xe ? void 0 : $(t.storage);
   return {
-    [te]: !0,
+    [ne]: !0,
     // marks this object as a leaf in the router tree
-    [M]: !1,
+    [W]: !1,
     // placeholder; injected at runtime by injectPaths()
-    [N]: "",
+    [C]: "",
     // placeholder; injected at runtime by injectPaths()
-    useState(i, b) {
-      b ??= {};
-      const S = Re(
-        b.onSet ?? (() => {
+    useState(l) {
+      l ??= {};
+      const _ = Se(
+        l.onSet ?? (() => {
         }),
-        b.delayedSet,
+        l.delayedSet,
         []
-      ), f = we(), l = this[N], _ = this[M], [R, y] = ee(!_);
-      D(() => y(!0), []);
-      const T = F(
+      ), d = ke(), f = this[C], p = this[W], [S, T] = re(!p);
+      V(() => T(!0), []);
+      const R = z(
         () => {
-          if (!R || !o)
+          if (!S || !u)
             return;
-          const E = o.getItem(l);
-          return Z({
-            serialized: E,
-            defaultValue: i,
-            superDefaultValue: s,
-            deserialize: a
+          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, R]
-      ), h = F(
+        [f, S]
+      ), g = z(
         () => Ee(
-          f.stateVocab,
-          l,
-          T ?? L(i, s)
+          d.stateVocab,
+          f,
+          R ?? $(l.defaultValue) ?? a
         ),
         // eslint-disable-next-line react-hooks/exhaustive-deps
         [
-          f.stateVocab,
-          T,
-          l
+          d.stateVocab,
+          R,
+          f
         ]
       );
-      D(
+      V(
         () => {
-          !o || typeof T > "u" || f.setStateVocab(j(l, T));
+          !u || typeof R > "u" || d.setStateVocab(N(f, R));
         },
         // eslint-disable-next-line react-hooks/exhaustive-deps
-        [T]
-      ), D(() => {
-        if (!b.bidirectional && !r)
+        [R]
+      ), V(() => {
+        if (!l.bidirectional && !r)
           return;
-        const E = (v) => {
-          if (v.key !== l)
+        const v = (h) => {
+          if (h.key !== f)
             return;
-          const g = v.newValue, w = Z({
-            serialized: g,
-            defaultValue: i,
-            superDefaultValue: s,
-            deserialize: a
+          const I = h.newValue, P = K({
+            defaultValue: l.defaultValue,
+            superDefaultValue: a,
+            serialized: I,
+            deserialize: o
           });
-          f.setStateVocab(j(l, w)), S(w, p.current), p.current = w;
+          d.setStateVocab(N(f, P)), _(P, E.current), E.current = P;
         };
-        return window.addEventListener("storage", E), () => window.removeEventListener("storage", E);
+        return window.addEventListener("storage", v), () => window.removeEventListener("storage", v);
       }, [
-        l,
-        b.bidirectional,
+        f,
+        l.bidirectional,
         r
       ]);
-      const p = pe(h);
-      return [
-        h,
-        function(v) {
-          const g = Pe(v) ? v(p.current) : v;
-          f.setStateVocab(j(l, g)), S(g, p.current), o && o.setItem(l, c(g)), p.current = g;
-        },
-        function() {
-          const v = L(i, s);
-          if (typeof v > "u") {
-            o?.removeItem(l);
-            return;
-          }
-          f.setStateVocab(j(l, v)), S(v, p.current), p.current = v, o && o.setItem(l, c(v));
+      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[N];
+      return this[C];
     }
   };
 }
-const Q = /* @__PURE__ */ new WeakMap(), K = /* @__PURE__ */ new WeakMap();
-function oe(t, c) {
-  c ??= {};
+const ee = /* @__PURE__ */ new WeakMap(), te = /* @__PURE__ */ new WeakMap();
+function ae(t, s) {
+  s ??= {};
   const {
-    path: a = "",
-    ssr: s
-  } = c;
-  let r = Q.get(t);
-  r || (r = /* @__PURE__ */ new Map(), Q.set(t, r));
-  const o = r.get(a);
-  if (o)
-    return o;
-  const i = new Proxy(t, {
-    get(b, S) {
-      const f = b[S], l = a ? `${a}.${String(S)}` : String(S);
-      if (f && typeof f == "object" && te in f) {
-        const _ = f;
-        let R = K.get(_);
-        R || (R = /* @__PURE__ */ new Map(), K.set(_, R));
-        const y = R.get(l);
-        if (y)
-          return y;
-        const T = Reflect.ownKeys(_).filter(
-          (E) => typeof _[E] == "function"
-        ), h = Object.fromEntries(
-          T.map((E) => [
-            E,
-            (...v) => _[E].call(
+    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(
               {
-                ..._,
-                [N]: l,
-                [M]: s
+                ...p,
+                [C]: f,
+                [W]: a
               },
-              ...v
+              ...w
             )
           ])
-        ), p = { ..._, ...h };
-        return R.set(l, p), p;
+        ), E = { ...p, ...g };
+        return S.set(f, E), E;
       }
-      return f && typeof f == "object" ? oe(f, {
-        path: l,
-        ssr: s
-      }) : f;
+      return d && typeof d == "object" ? ae(d, {
+        path: f,
+        ssr: a
+      }) : d;
     }
   });
-  return r.set(a, i), i;
+  return r.set(o, u), u;
 }
-function Ce(t, c) {
-  return oe(t, c);
+function je(t, s) {
+  return ae(t, s);
 }
 export {
-  je as StorageProvider,
-  Ne as defineState,
-  Ce as setupStorage
+  Oe as StorageProvider,
+  Ve as defineState,
+  je as setupStorage
 };

package/dist/types/state.d.ts

@@ -4,6 +4,7 @@ export declare function defineState<T>(definitionOptions?: {
     storage?: ValueOrFactory<Storage>;
     defaultValue?: T;
     bidirectional?: true;
+    autoSet?: true;
     serialize?: (v: T) => string;
     deserialize?: (v: string) => T;
 }): {
@@ -13,9 +14,11 @@ export declare function defineState<T>(definitionOptions?: {
     useState<D = T>(this: {
         [STATE_PATH]: string;
         [STATE_SSR_SUPPORT]: boolean;
-    }, defaultValue?: ValueOrFactory<D>, options?: {
+    }, 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.3",
+  "version": "2.2.1",
   "main": "dist/state-vocab.cjs.js",
   "module": "dist/state-vocab.es.js",
   "types": "dist/types/index.d.ts",