@yakocloud/state-vocab 3.1.3 → 3.1.5

package/README.md

@@ -508,4 +508,23 @@ A React context provider that initializes a `VocabStore` for its subtree. Requir
 | `onSet` | `(next: T, prev: T) => void \| undefined` | Callback after state change |
 | `bidirectional` | `true \| undefined` | Sync state across browser tabs |
 
-Returns `[value, setValue, resetValue]`
+Returns `[value, setValue, resetValue]`
+
+### `node.useInitialState(options)`
+
+Initializes state without subscribing the caller component to re-renders. Use at layout or root components that only need to seed a value — not react to its changes.
+
+| Option | Type | Description |
+|---|---|---|
+| `defaultValue` | `T \| (() => T)` | Value to seed. Required. |
+
+```tsx
+function Page() {
+  // Seeds the value — this component will NOT re-render when pageProps changes
+  storage.demo.pageProps.useInitialState({
+    defaultValue: { title: 'Hello', count: 42 },
+  })
+
+  return <Dashboard />
+}
+```

package/dist/state-vocab.cjs.js

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

package/dist/state-vocab.es.js

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

package/dist/types/context.d.ts

@@ -1,5 +1,8 @@
 import { type PropsWithChildren } from "react";
 import VocabStore from "./store";
+/**
+ * @see method from from https://zustand.docs.pmnd.rs/learn/guides/nextjs
+ */
 export declare function useVocabStoreContext(options?: {
     verbose?: boolean;
 }): VocabStore;

package/dist/types/state.d.ts

@@ -23,6 +23,13 @@ export declare function defineState<D>(definitionOptions?: {
         bidirectional?: true;
         onSet?(nextValue: NoInfer<D>, prevValue: NoInfer<D>): void;
     }): readonly [D, (nextValue: ValueOrTransformer<D>) => void, () => void];
+    useInitialState(this: {
+        [STATE_PATH]: string;
+        [STATE_VERBOSE]: boolean;
+        [STATE_SSR]: boolean;
+    }, options: {
+        defaultValue: ValueOrFactory<D>;
+    }): void;
     /** Returns the fully qualified job name (dot-separated path). */
     toString(this: {
         [STATE_PATH]: string;

package/package.json

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