@yakocloud/state-vocab 2.0.2 → 2.1.0

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

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";
+import fe, { useMemo as $, createContext as de, useState as me, useContext as be, useEffect as W, useRef as ve } from "react";
 const H = Symbol("state-def"), O = Symbol("state-path");
-function 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];
+function Ee(t, c, o) {
+  if (!c)
+    return t;
+  const a = c.split(".");
+  let r = t;
+  for (const s of a)
+    if (r !== null && typeof r == "object" && s in r)
+      r = r[s];
     else
-      return 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, c, o) {
+  const a = c.replace(/\[(\d+)\]/g, ".$1").split(".");
+  let r = t;
+  for (let s = 0; s < a.length - 1; s++) {
+    const f = a[s], u = a[s + 1];
+    (r[f] === void 0 || r[f] === null) && (r[f] = /^\d+$/.test(u) ? [] : {}), r = r[f];
   }
-  return 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, c = 0) {
+  let o;
+  return function(...a) {
+    o !== void 0 && clearTimeout(o), o = setTimeout(() => {
+      o = void 0, t.apply(this, a);
+    }, c);
   };
 }
-function _e(r, n, a = []) {
+function Se(t, c, o = []) {
   return $(
-    () => pe(r, n),
+    () => _e(t, c),
     // 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*)(.+)$/);
-    if (c) {
-      const [, f, u, p, v] = c;
-      a.push(`${f}%c"${u}"%c${p}%c${v}`), s.push(
+function Re(t) {
+  const c = JSON.stringify(t, null, 2).split(`
+`), o = [], a = [];
+  for (const r of c) {
+    const s = r.match(/^(\s*)"([^"]+)"(\s*:\s*)(.+)$/);
+    if (s) {
+      const [, f, u, p, v] = s;
+      o.push(`${f}%c"${u}"%c${p}%c${v}`), a.push(
         "color: #9cdcfe; font-weight: bold",
         "color: #cccccc",
         "color: #ce9178"
       );
     } else
-      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 t = Symbol.for("react.transitional.element"), c = Symbol.for("react.fragment");
+  function o(a, r, s) {
     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,
+    if (s !== void 0 && (f = "" + s), r.key !== void 0 && (f = "" + r.key), "key" in r) {
+      s = {};
+      for (var u in r)
+        u !== "key" && (s[u] = r[u]);
+    } else s = r;
+    return r = s.ref, {
+      $$typeof: t,
+      type: a,
       key: f,
-      ref: t !== void 0 ? t : null,
-      props: c
+      ref: r !== void 0 ? r : null,
+      props: s
     };
   }
-  return h.Fragment = n, h.jsx = a, h.jsxs = a, h;
+  return h.Fragment = c, 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,74 +106,74 @@ 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 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 A:
-            o = e._payload, e = e._init;
+            n = e._payload, e = e._init;
             try {
-              return r(e(o));
+              return t(e(n));
             } catch {
             }
         }
       return null;
     }
-    function n(e) {
+    function c(e) {
       return "" + e;
     }
-    function a(e) {
+    function o(e) {
       try {
-        n(e);
-        var o = !1;
+        c(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";
+      if (n) {
+        n = console;
+        var i = n.error, m = typeof Symbol == "function" && Symbol.toStringTag && e[Symbol.toStringTag] || e.constructor.name || "Object";
         return i.call(
-          o,
+          n,
           "The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",
           m
-        ), n(e);
+        ), c(e);
       }
     }
-    function s(e) {
+    function a(e) {
       if (e === S) return "<>";
       if (typeof e == "object" && e !== null && e.$$typeof === A)
         return "<...>";
       try {
-        var o = r(e);
-        return o ? "<" + o + ">" : "<...>";
+        var n = t(e);
+        return n ? "<" + n + ">" : "<...>";
       } catch {
         return "<...>";
       }
     }
-    function t() {
+    function r() {
       var e = j.A;
       return e === null ? null : e.getOwner();
     }
-    function c() {
+    function s() {
       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;
+        var n = Object.getOwnPropertyDescriptor(e, "key").get;
+        if (n && n.isReactWarning) return !1;
       }
       return e.key !== void 0;
     }
-    function u(e, o) {
+    function u(e, n) {
       function i() {
         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", {
@@ -182,17 +182,17 @@ function Te() {
       });
     }
     function p() {
-      var e = r(this.type);
-      return M[e] || (M[e] = !0, console.error(
+      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) {
+    function v(e, n, i, m, w, C) {
       var b = i.ref;
       return e = {
         $$typeof: _,
         type: e,
-        key: o,
+        key: n,
         props: i,
         _owner: m
       }, (b !== void 0 ? b : null) !== null ? Object.defineProperty(e, "ref", {
@@ -220,11 +220,11 @@ function Te() {
         value: C
       }), Object.freeze && (Object.freeze(e.props), Object.freeze(e)), e;
     }
-    function l(e, o, i, m, w, C) {
-      var b = o.children;
+    function l(e, n, i, m, w, C) {
+      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,11 +251,11 @@ 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) {
+      if (b = null, i !== void 0 && (o(i), b = "" + i), f(n) && (o(n.key), b = "" + n.key), "key" in n) {
         i = {};
-        for (var V in o)
-          V !== "key" && (i[V] = o[V]);
-      } else i = o;
+        for (var V in n)
+          V !== "key" && (i[V] = n[V]);
+      } else i = n;
       return b && u(
         i,
         typeof e == "function" ? e.displayName || e.name || "Unknown" : e
@@ -263,7 +263,7 @@ React keys must be passed directly to JSX without using spread:
         e,
         b,
         i,
-        t(),
+        r(),
         w,
         C
       );
@@ -274,7 +274,7 @@ React keys must be passed directly to JSX without using spread:
     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 E = fe, _ = Symbol.for("react.transitional.element"), d = Symbol.for("react.portal"), S = Symbol.for("react.fragment"), g = Symbol.for("react.strict_mode"), ee = Symbol.for("react.profiler"), te = Symbol.for("react.consumer"), re = Symbol.for("react.context"), ne = Symbol.for("react.forward_ref"), oe = Symbol.for("react.suspense"), ae = Symbol.for("react.suspense_list"), se = Symbol.for("react.memo"), A = Symbol.for("react.lazy"), ce = Symbol.for("react.activity"), ue = Symbol.for("react.client.reference"), j = E.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE, Y = Object.prototype.hasOwnProperty, le = Array.isArray, N = console.createTask ? console.createTask : function() {
       return null;
     };
     E = {
@@ -282,66 +282,65 @@ React keys must be passed directly to JSX without using spread:
         return e();
       }
     };
-    var D, M = {}, F = E.react_stack_bottom_frame.bind(
+    var D, F = {}, M = E.react_stack_bottom_frame.bind(
       E,
-      c
-    )(), L = N(s(c)), z = {};
-    k.Fragment = S, k.jsx = function(e, o, i) {
+      s
+    )(), L = N(a(s)), z = {};
+    k.Fragment = S, k.jsx = function(e, n, i) {
       var m = 1e4 > j.recentlyCreatedOwnerStacks++;
       return l(
         e,
-        o,
+        n,
         i,
         !1,
-        m ? Error("react-stack-top-frame") : F,
-        m ? N(s(e)) : L
+        m ? Error("react-stack-top-frame") : M,
+        m ? N(a(e)) : L
       );
-    }, k.jsxs = function(e, o, i) {
+    }, k.jsxs = function(e, n, i) {
       var m = 1e4 > j.recentlyCreatedOwnerStacks++;
       return l(
         e,
-        o,
+        n,
         i,
         !0,
-        m ? Error("react-stack-top-frame") : F,
-        m ? N(s(e)) : L
+        m ? Error("react-stack-top-frame") : M,
+        m ? N(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);
-    return typeof c > "u" ? void 0 : c;
+const Oe = (t) => {
+  const { children: c, verbose: o } = t, [a, r] = me({});
+  return o && Re(a), /* @__PURE__ */ he.jsx(Z.Provider, { value: { stateVocab: a, setStateVocab: r }, children: c });
+}, P = (t, c) => (o) => {
+  const a = { ...o };
+  return pe(a, t, c), a;
+}, I = (t, c) => Q(t) ?? c, G = (t) => {
+  const { serialized: c, defaultValue: o, superDefaultValue: a, deserialize: r } = t;
+  if (c === null) {
+    const s = I(o, a);
+    return typeof s > "u" ? void 0 : s;
   }
-  return t(n);
-};
-function xe(r = {}) {
+  return r(c);
+}, 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: c = JSON.stringify,
+    deserialize: o = JSON.parse
+  } = t, a = t.defaultValue, r = t.bidirectional, s = Q(t.storage);
   return {
     [H]: !0,
     // marks this object as a leaf in the router tree
@@ -349,30 +348,30 @@ function xe(r = {}) {
     // placeholder; injected at runtime by injectPaths()
     useState(f, u) {
       u ??= {};
-      const p = _e(
+      const p = Se(
         u.onSet ?? (() => {
         }),
         u.delayedSet,
         []
-      ), v = he(), l = this[O], R = $(
+      ), v = ke(), l = this[O], R = $(
         () => {
-          if (!n)
+          if (!s)
             return;
-          const _ = n.getItem(l);
+          const _ = s.getItem(l);
           return G({
             serialized: _,
             defaultValue: f,
-            superDefaultValue: t,
-            deserialize: s
+            superDefaultValue: a,
+            deserialize: o
           });
         },
         // eslint-disable-next-line react-hooks/exhaustive-deps
         [l]
       ), T = $(
-        () => ve(
+        () => Ee(
           v.stateVocab,
           l,
-          R ?? I(f, t)
+          R ?? I(f, a)
         ),
         // eslint-disable-next-line react-hooks/exhaustive-deps
         [
@@ -383,12 +382,12 @@ function xe(r = {}) {
       );
       W(
         () => {
-          !n || typeof R > "u" || v.setStateVocab(P(l, R));
+          !s || typeof R > "u" || v.setStateVocab(P(l, 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)
@@ -396,8 +395,8 @@ function xe(r = {}) {
           const S = d.newValue, g = G({
             serialized: S,
             defaultValue: f,
-            superDefaultValue: t,
-            deserialize: s
+            superDefaultValue: a,
+            deserialize: o
           });
           v.setStateVocab(P(l, g)), p(g, E.current), E.current = g;
         };
@@ -405,22 +404,22 @@ function xe(r = {}) {
       }, [
         l,
         u.bidirectional,
-        c
+        r
       ]);
-      const E = be(T);
+      const E = 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(E.current) : d;
+          v.setStateVocab(P(l, S)), p(S, E.current), s && s.setItem(l, c(S)), E.current = S;
         },
         function() {
-          const d = I(f, t);
+          const d = I(f, a);
           if (typeof d > "u") {
-            n?.removeItem(l);
+            s?.removeItem(l);
             return;
           }
-          v.setStateVocab(P(l, d)), p(d, E.current), E.current = d, n && n.setItem(l, a(d));
+          v.setStateVocab(P(l, d)), p(d, E.current), E.current = d, s && s.setItem(l, c(d));
         }
       ];
     },
@@ -431,15 +430,15 @@ function xe(r = {}) {
   };
 }
 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);
+function K(t, c = "") {
+  let o = X.get(t);
+  o || (o = /* @__PURE__ */ new Map(), X.set(t, o));
+  const a = o.get(c);
+  if (a)
+    return a;
+  const r = new Proxy(t, {
+    get(s, f) {
+      const u = s[f], p = c ? `${c}.${String(f)}` : String(f);
       if (u && typeof u == "object" && H in u) {
         const v = u;
         let l = B.get(v);
@@ -460,16 +459,16 @@ function Q(r, n = "") {
         ), _ = { ...v, ...E };
         return l.set(p, _), _;
       }
-      return u && typeof u == "object" ? Q(u, p) : u;
+      return u && typeof u == "object" ? K(u, p) : u;
     }
   });
-  return a.set(n, t), t;
+  return o.set(c, 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/constants.d.ts

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

package/dist/types/context.d.ts

@@ -0,0 +1,11 @@
+import { type SetStateAction, type PropsWithChildren, type Dispatch } from "react";
+export type Vocab<T = unknown> = Record<string, T | null>;
+type Context<V extends Vocab = Vocab> = {
+    stateVocab: V;
+    setStateVocab: Dispatch<SetStateAction<V>>;
+};
+export declare function useStateVocabContext<T>(): Context<Vocab<T>>;
+export declare const StateVocabContextProvider: (props: PropsWithChildren<{
+    verbose?: boolean;
+}>) => import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export { defineState } from "./state";
+export { setupStorage } from "./setup";
+export { StateVocabContextProvider as StorageProvider } from "./context";

package/dist/types/main.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/setup.d.ts

@@ -0,0 +1 @@
+export declare function setupStorage<T extends object>(nativeRouter: T): T;

package/dist/types/state.d.ts

@@ -0,0 +1,23 @@
+import { STATE_DEFINITION, STATE_PATH } from "./constants";
+import type { ValueOrFactory, ValueOrTransformer } from "./types";
+export declare function defineState<T>(definitionOptions?: {
+    storage?: ValueOrFactory<Storage>;
+    defaultValue?: T;
+    bidirectional?: true;
+    serialize?: (v: T) => string;
+    deserialize?: (v: string) => T;
+}): {
+    [STATE_DEFINITION]: boolean;
+    [STATE_PATH]: string;
+    useState<D = T>(this: {
+        [STATE_PATH]: string;
+    }, defaultValue?: ValueOrFactory<D>, options?: {
+        delayedSet?: number;
+        bidirectional?: 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). */
+    toString(this: {
+        [STATE_PATH]: string;
+    }): string;
+};

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

@@ -0,0 +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: <V>(defaultValue: ValueOrFactory<V>, superDefaltValue: unknown) => V;
+export declare const genStoredValue: <V>(options: {
+    serialized: string | null;
+    defaultValue: ValueOrFactory<V>;
+    superDefaultValue: unknown;
+    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/dist/types/utils.d.ts

@@ -0,0 +1,7 @@
+import { type DependencyList } from "react";
+export declare function get<T, Default = undefined>(obj: T, path: string, defaultValue?: Default): unknown | Default;
+export declare function set(obj: Record<string, unknown>, path: string, value: unknown): Record<string, unknown>;
+export declare function debounce<T extends (...args: never[]) => unknown>(func: T, wait?: number): (...args: Parameters<T>) => void;
+export declare function useDebounce<T extends (...args: never[]) => unknown>(effect: T, wait: number | undefined, deps?: DependencyList): (...args: Parameters<T>) => void;
+export declare const isJsonValid: (input: string) => boolean;
+export declare function logStyled(obj: object): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yakocloud/state-vocab",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "main": "dist/state-vocab.cjs.js",
   "module": "dist/state-vocab.es.js",
   "types": "dist/types/index.d.ts",
@@ -18,10 +18,11 @@
   },
   "scripts": {
     "dev": "vite",
-    "build": "tsc -b && vite build",
+    "build": "tsc -b && vite build ; tsc --project tsconfig.types.json",
     "lint": "eslint .",
     "type-check": "tsc --project tsconfig.types.json",
-    "build:types": "tsc --project tsconfig.types.json"
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "peerDependencies": {
     "react": "^19.2.1",
@@ -29,16 +30,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"
   }
 }