@yakocloud/state-vocab 2.0.3 → 2.1.1

package/README.md

@@ -12,7 +12,7 @@ Most state managers treat persistence as an afterthought — you manage state fi
 // declare once — works everywhere
 const storage = setupStorage({
   theme: defineState({ storage: localStorage, defaultValue: 'Dark' }),
-  session: defineState({ storage: sessionStorage }),
+  session: defineState({ storage: () => sessionStorage }),
   inMemory: defineState({ defaultValue: 0 }),
 })
 ```
@@ -77,9 +77,11 @@ defineState({
 ## Installation
 
 ```bash
-npm install @yakocloud/state-vocab
+npm install @yakocloud/state-vocab react react-dom
 ```
 
+> `react` and `react-dom` are peer dependencies and must be installed separately.
+
 ## Quick Start
 
 ```tsx
@@ -125,7 +127,7 @@ Defines a state node. Options:
 
 | Option | Type | Description |
 |---|---|---|
-| `storage` | `Storage` | Where to persist the value. Omit for in-memory only. |
+| `storage` | `Storage \| (() => Storage) \| undefined` | Where to persist the value. Omit for in-memory only. |
 | `defaultValue` | `T` | Value used when storage has no entry. |
 | `serialize` | `(v: T) => string` | Custom serializer. Default: `JSON.stringify`. |
 | `deserialize` | `(v: string) => T` | Custom deserializer. Default: `JSON.parse`. |
@@ -136,13 +138,13 @@ const counter = defineState({ defaultValue: 0 })
 
 // localStorage with custom type
 const theme = defineState<'Dark' | 'White'>({
-  storage: localStorage,
+  storage: () => localStorage,
   defaultValue: 'Dark',
 })
 
 // localStorage with custom serialization
 const birthday = defineState({
-  storage: localStorage,
+  storage: () => localStorage,
   deserialize: (raw) => new Date(JSON.parse(raw)),
 })
 ```
@@ -322,7 +324,7 @@ createRoot(document.getElementById('root')!).render(
 
 | Option | Type | Default |
 |---|---|---|
-| `storage` | `Storage \| undefined` | `undefined` (in-memory) |
+| `storage` | `Storage \| (() => Storage) \| undefined` | `undefined` (in-memory) |
 | `defaultValue` | `T \| undefined` | `undefined` |
 | `bidirectional` | `true \| undefined` | `undefined` |
 | `serialize` | `(v: T) => string` | `JSON.stringify` |

package/dist/state-vocab.cjs.js

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

package/dist/state-vocab.es.js

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

package/dist/types/state.d.ts

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

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

@@ -1,11 +1,14 @@
 import type { Vocab } from "./context";
+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: <D>(defaultValue: D | (() => D), superDefaltValue: unknown) => D;
-export declare const genStoredValue: <D>(options: {
+export declare const genDefaultValue: <V>(defaultValue: ValueOrFactory<V>, superDefaltValue: unknown) => V;
+export declare const genStoredValue: <V>(options: {
     serialized: string | null;
-    defaultValue: D | (() => D);
+    defaultValue: ValueOrFactory<V>;
     superDefaultValue: unknown;
-    deserialize: (v: string) => D;
-}) => D;
+    deserialize: (v: string) => V;
+}) => V;
+export declare const isTransformer: <V>(v: ValueOrTransformer<V>) => v is Transformer<V>;
+export declare const valueOrFactory: <V>(input: ValueOrFactory<V>) => V;

package/dist/types/types.d.ts

@@ -0,0 +1,4 @@
+export type Transformer<V> = (prev: V) => V;
+export type ValueOrTransformer<V> = V | Transformer<V>;
+export type Factory<V> = () => V;
+export type ValueOrFactory<V> = V | Factory<V>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yakocloud/state-vocab",
-  "version": "2.0.3",
+  "version": "2.1.1",
   "main": "dist/state-vocab.cjs.js",
   "module": "dist/state-vocab.es.js",
   "types": "dist/types/index.d.ts",
@@ -20,7 +20,10 @@
     "dev": "vite",
     "build": "tsc -b && vite build ; tsc --project tsconfig.types.json",
     "lint": "eslint .",
-    "type-check": "tsc --project tsconfig.types.json"
+    "type-check": "tsc --project tsconfig.types.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:report": "npx vitest run --reporter=verbose"
   },
   "peerDependencies": {
     "react": "^19.2.1",
@@ -28,16 +31,20 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.39.1",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
     "@types/node": "^24.10.1",
     "@types/react": "^19.2.5",
     "@types/react-dom": "^19.2.3",
-    "@vitejs/plugin-react": "^5.1.1",
+    "@vitejs/plugin-react": "^5.2.0",
     "eslint": "^9.39.1",
     "eslint-plugin-react-hooks": "^7.0.1",
     "eslint-plugin-react-refresh": "^0.4.24",
     "globals": "^16.5.0",
+    "jsdom": "^29.0.2",
     "typescript": "~5.9.3",
     "typescript-eslint": "^8.46.4",
-    "vite": "^7.2.4"
+    "vite": "^7.2.4",
+    "vitest": "^4.1.5"
   }
 }