@yakocloud/state-vocab 3.1.2 → 3.1.3

package/README.md

@@ -103,7 +103,7 @@ defineState({
 })
 ```
 
-**Minimal API surface.** Two exports: `defineState`, `setupStorage`. No actions, reducers, selectors, or stores to configure.
+**Minimal API surface.** Three exports: `defineState`, `setupStorage`, `VocabStateProvider`. No actions, reducers, selectors, or stores to configure.
 
 ## Installation
 
@@ -115,8 +115,13 @@ npm install @yakocloud/state-vocab react react-dom
 
 ## Quick Start
 
+Wrap your app with `VocabStateProvider` at the root — this initializes an isolated store for the component tree. Then define and use state anywhere inside it.
+Library SSR-requirements:
+- `Per-request store`: A Next.js server can handle multiple requests simultaneously. This means that the store should be created per request and should not be shared across requests.
+- `SSR friendly`: Next.js applications are rendered twice, first on the server and again on the client. Having different outputs on both the client and the server will result in "hydration errors." The store will have to be initialized on the server and then re-initialized on the client with the same data in order to avoid that.
+
 ```tsx
-import { setupStorage, defineState } from '@yakocloud/state-vocab'
+import { setupStorage, defineState, VocabStateProvider } from '@yakocloud/state-vocab'
 
 type Theme = 'Dark' | 'White' | 'System'
 
@@ -131,6 +136,14 @@ const storage = setupStorage({
   },
 })
 
+function App() {
+  return (
+    <VocabStateProvider>
+      <Settings />
+    </VocabStateProvider>
+  )
+}
+
 function Settings() {
   const [theme, setTheme] = storage.path.to.theme.useState()
 
@@ -144,6 +157,38 @@ function Settings() {
 }
 ```
 
+## Setup
+
+### `VocabStateProvider`
+
+All components that call `.useState()` must be descendants of `VocabStateProvider`. It creates an isolated `VocabStore` instance for its subtree — multiple providers can coexist in the same app without sharing state.
+
+```tsx
+import { VocabStateProvider } from '@yakocloud/state-vocab'
+
+// Wrap your app root
+createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <VocabStateProvider>
+      <App />
+    </VocabStateProvider>
+  </React.StrictMode>
+)
+```
+
+You can mount multiple independent providers — each gets its own store:
+
+```tsx
+// Two isolated state trees — state does not bleed between them
+<VocabStateProvider>
+  <WidgetA />
+</VocabStateProvider>
+
+<VocabStateProvider>
+  <WidgetB />
+</VocabStateProvider>
+```
+
 ## Core Concepts
 
 ### `defineState(options?)`
@@ -247,6 +292,8 @@ With `ssr: true`:
 
 This guarantees the server and client produce identical markup, and the value from storage is applied without a visible flash.
 
+Wrap your page or app root with `VocabStateProvider` as usual — it works correctly in both SSR and client environments.
+
 ## `useState` Hook
 
 Each state node exposes a `.useState()` method that works like React's built-in `useState` but adds persistence and callbacks.
@@ -325,7 +372,9 @@ const storage = setupStorage({
 ## Full Example
 
 ```tsx
-import { setupStorage, defineState } from '@yakocloud/state-vocab'
+import React from 'react'
+import { createRoot } from 'react-dom/client'
+import { setupStorage, defineState, VocabStateProvider } from '@yakocloud/state-vocab'
 
 type Theme = 'Dark' | 'White' | 'System'
 
@@ -409,7 +458,13 @@ function Dashboard() {
   )
 }
 
-createRoot(document.getElementById('root')!).render(<Page />)
+createRoot(document.getElementById('root')!).render(
+  <React.StrictMode>
+    <VocabStateProvider>
+      <Page />
+    </VocabStateProvider>
+  </React.StrictMode>
+)
 ```
 
 ## API Reference
@@ -434,6 +489,16 @@ createRoot(document.getElementById('root')!).render(<Page />)
 
 Returns a proxied copy of `tree` with paths injected into all leaf nodes.
 
+### `VocabStateProvider`
+
+A React context provider that initializes a `VocabStore` for its subtree. Required — all components calling `.useState()` must be descendants of this provider.
+
+```tsx
+<VocabStateProvider>
+  <App />
+</VocabStateProvider>
+```
+
 ### `node.useState(options?)`
 
 | Option | Type | Description |

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 be(){if(te)return N;te=1;var t=Symbol.for("react.transitional.element"),o=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=o,N.jsx=r,N.jsxs=r,N}var V={};var re;function me(){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===ie?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 T:return e.displayName||"Context";case k:return(e._context.displayName||"Context")+".Consumer";case C:var n=e.render;return e=e.displayName,e||(e=n.displayName||n.name||"",e=e!==""?"ForwardRef("+e+")":"ForwardRef"),e;case y:return n=e.displayName||null,n!==null?n:t(e.type)||"Memo";case A:n=e._payload,e=e._init;try{return t(e(n))}catch{}}return null}function o(e){return""+e}function r(e){try{o(e);var n=!1}catch{n=!0}if(n){n=console;var f=n.error,b=typeof Symbol=="function"&&Symbol.toStringTag&&e[Symbol.toStringTag]||e.constructor.name||"Object";return f.call(n,"The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",b),o(e)}}function l(e){if(e===_)return"<>";if(typeof e=="object"&&e!==null&&e.$$typeof===A)return"<...>";try{var n=t(e);return n?"<"+n+">":"<...>"}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 n=Object.getOwnPropertyDescriptor(e,"key").get;if(n&&n.isReactWarning)return!1}return e.key!==void 0}function c(e,n){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)",n))}f.isReactWarning=!0,Object.defineProperty(e,"key",{get:f,configurable:!0})}function g(){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 R(e,n,f,b,I,W){var m=f.ref;return e={$$typeof:S,type:e,key:n,props:f,_owner:b},(m!==void 0?m:null)!==null?Object.defineProperty(e,"ref",{enumerable:!1,get:g}):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,n,f,b,I,W){var m=n.children;if(m!==void 0)if(b)if(fe(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(n,"key")){m=t(e);var j=Object.keys(n).filter(function(de){return de!=="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 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:
   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(n)&&(r(n.key),m=""+n.key),"key"in n){f={};for(var J in n)J!=="key"&&(f[J]=n[J])}else f=n;return m&&c(f,typeof e=="function"?e.displayName||e.name||"Unknown":e),R(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"),T=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"),ie=Symbol.for("react.client.reference"),z=h.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE,X=Object.prototype.hasOwnProperty,fe=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,n,f){var b=1e4>z.recentlyCreatedOwnerStacks++;return P(e,n,f,!1,b?Error("react-stack-top-frame"):Q,b?L(l(e)):K)},V.jsxs=function(e,n,f){var b=1e4>z.recentlyCreatedOwnerStacks++;return P(e,n,f,!0,b?Error("react-stack-top-frame"):Q,b?L(l(e)):K)}})()),V}var ne;function ve(){return ne||(ne=1,process.env.NODE_ENV==="production"?Y.exports=be():Y.exports=me()),Y.exports}var Ee=ve();function D(t,o,r){if(!o)return t;const l=o.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 Se(t,o,r){const l=o.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 pe(t,o=0){let r;return function(...l){r!==void 0&&clearTimeout(r),r=setTimeout(()=>{r=void 0,t.apply(this,l)},o)}}function he(t,o,r=[]){return E.useMemo(()=>pe(t,o),r)}function oe(t){const o=JSON.stringify(t,null,2).split(`
-`),r=[],l=[];for(const s of o){const a=s.match(/^(\s*)"([^"]+)"(\s*:\s*)(.+)$/);if(a){const[,i,c,g,R]=a;r.push(`${i}%c"${c}"%c${g}%c${R}`),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",_e=t=>typeof t=="function",$=t=>typeof t<"u",U=t=>_e(t)?t():t;class ye{#e;#t;constructor(){this.uid=Math.random().toString(36).slice(2),this.#e={},this.#t=new Set}subscribe(o){return this.#t.add(o),()=>this.#t.delete(o)}getClientSnapshot(){return this.#e}getServerSnapshot(){return this.#e}get(o){return D(this.#e,o)}set(o,r){const l=D(this.#e,o),s=se(r)?r(l):r,a={...this.#e};Se(a,o,s),this.#e=a,this.#t.forEach(i=>i())}}const ae=E.createContext({});function Re(){return E.useContext(ae)}function Te({children:t}){const o=E.useMemo(()=>new ye,[]);return Ee.jsx(ae.Provider,{value:o,children:t})}const ce=Symbol("state-def"),M=Symbol("state-path"),q=Symbol("state-verbose"),G=Symbol("state-verbose-path"),B=Symbol("state-ssr"),ue=typeof window>"u",ge=ue?E.useEffect:E.useLayoutEffect;function ke(t={}){return{[ce]:!0,[M]:"",[q]:!1,[G]:"",[B]:!1,useState(o){const r=ue?void 0:U(t.storage),l=U(t.defaultValue),s=t.bidirectional;o??={};const a=U(o.defaultValue)??l,i=o.bidirectional??s,c=this[M],g=this[q],R=this[G],P=this[B],d=Re(),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=he(o.onSet??(()=>{}),o.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(g)if(R){const u=D(x,R);u&&oe(u)}else oe(x);const k=D(x,c,a);_.current=k,ge(()=>{!P||!r||S(c,r,k)},[]);const T=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",T),()=>window.removeEventListener("storage",T)},[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 le(t,o){const{path:r="",verbose:l,verbosePath:s,ssr:a,cache:i}=o;let c=i.proxy.get(t);c||(c=new Map,i.proxy.set(t,c));const g=c.get(r);if(g)return g;const R=new Proxy(t,{get(P,d){const v=P[d],h=r?`${r}.${String(d)}`:String(d);if(v&&typeof v=="object"&&ce 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(T=>typeof S[T]=="function"),x=Object.fromEntries(O.map(T=>[T,(...C)=>S[T].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"?le(v,{...o,path:h}):v}});return c.set(r,R),R}function we(t,o){return le(t,{...o,verbosePath:o?.verbosePath??"",cache:{proxy:new WeakMap,leaf:new WeakMap}})}exports.VocabStateProvider=Te;exports.defineState=ke;exports.setupStorage=we;
+  <%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;

package/dist/state-vocab.es.js

@@ -1,10 +1,10 @@
-import Ee, { useMemo as ae, createContext as pe, useContext as Se, useRef as ee, useSyncExternalStore as he, useEffect as ce, useLayoutEffect as _e, useEffectEvent as ye, useCallback as te } from "react";
+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 Re() {
+function Te() {
   if (re) return C;
   re = 1;
-  var t = Symbol.for("react.transitional.element"), o = Symbol.for("react.fragment");
+  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) {
@@ -20,21 +20,21 @@ function Re() {
       props: a
     };
   }
-  return C.Fragment = o, C.jsx = r, C.jsxs = r, C;
+  return C.Fragment = n, C.jsx = r, C.jsxs = r, C;
 }
 var N = {};
 var ne;
-function Te() {
+function ge() {
   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 === me ? null : e.displayName || e.name || null;
+        return e.$$typeof === be ? null : e.displayName || e.name || null;
       if (typeof e == "string") return e;
       switch (e) {
         case h:
           return "Fragment";
-        case P:
+        case x:
           return "Profiler";
         case A:
           return "StrictMode";
@@ -51,51 +51,51 @@ function Te() {
         ), e.$$typeof) {
           case p:
             return "Portal";
-          case R:
+          case T:
             return e.displayName || "Context";
           case g:
             return (e._context.displayName || "Context") + ".Consumer";
           case j:
-            var n = e.render;
-            return e = e.displayName, e || (e = n.displayName || n.name || "", e = e !== "" ? "ForwardRef(" + e + ")" : "ForwardRef"), e;
+            var o = e.render;
+            return e = e.displayName, e || (e = o.displayName || o.name || "", e = e !== "" ? "ForwardRef(" + e + ")" : "ForwardRef"), e;
           case _:
-            return n = e.displayName || null, n !== null ? n : t(e.type) || "Memo";
-          case x:
-            n = e._payload, e = e._init;
+            return o = e.displayName || null, o !== null ? o : t(e.type) || "Memo";
+          case P:
+            o = e._payload, e = e._init;
             try {
-              return t(e(n));
+              return t(e(o));
             } catch {
             }
         }
       return null;
     }
-    function o(e) {
+    function n(e) {
       return "" + e;
     }
     function r(e) {
       try {
-        o(e);
-        var n = !1;
+        n(e);
+        var o = !1;
       } catch {
-        n = !0;
+        o = !0;
       }
-      if (n) {
-        n = console;
-        var f = n.error, m = typeof Symbol == "function" && Symbol.toStringTag && e[Symbol.toStringTag] || e.constructor.name || "Object";
+      if (o) {
+        o = console;
+        var f = o.error, m = typeof Symbol == "function" && Symbol.toStringTag && e[Symbol.toStringTag] || e.constructor.name || "Object";
         return f.call(
-          n,
+          o,
           "The provided key is an unsupported type %s. This value must be coerced to a string before using it here.",
           m
-        ), o(e);
+        ), n(e);
       }
     }
     function l(e) {
       if (e === h) return "<>";
-      if (typeof e == "object" && e !== null && e.$$typeof === x)
+      if (typeof e == "object" && e !== null && e.$$typeof === P)
         return "<...>";
       try {
-        var n = t(e);
-        return n ? "<" + n + ">" : "<...>";
+        var o = t(e);
+        return o ? "<" + o + ">" : "<...>";
       } catch {
         return "<...>";
       }
@@ -109,16 +109,16 @@ function Te() {
     }
     function i(e) {
       if (B.call(e, "key")) {
-        var n = Object.getOwnPropertyDescriptor(e, "key").get;
-        if (n && n.isReactWarning) return !1;
+        var o = Object.getOwnPropertyDescriptor(e, "key").get;
+        if (o && o.isReactWarning) return !1;
       }
       return e.key !== void 0;
     }
-    function c(e, n) {
+    function c(e, o) {
       function f() {
         X || (X = !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
+          o
         ));
       }
       f.isReactWarning = !0, Object.defineProperty(e, "key", {
@@ -126,23 +126,23 @@ function Te() {
         configurable: !0
       });
     }
-    function T() {
+    function y() {
       var e = t(this.type);
       return H[e] || (H[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 y(e, n, f, m, $, L) {
+    function R(e, o, f, m, $, L) {
       var b = f.ref;
       return e = {
         $$typeof: E,
         type: e,
-        key: n,
+        key: o,
         props: f,
         _owner: m
       }, (b !== void 0 ? b : null) !== null ? Object.defineProperty(e, "ref", {
         enumerable: !1,
-        get: T
+        get: y
       }) : Object.defineProperty(e, "ref", { enumerable: !1, value: null }), e._store = {}, Object.defineProperty(e._store, "validated", {
         configurable: !1,
         enumerable: !1,
@@ -165,11 +165,11 @@ function Te() {
         value: L
       }), Object.freeze && (Object.freeze(e.props), Object.freeze(e)), e;
     }
-    function w(e, n, f, m, $, L) {
-      var b = n.children;
+    function w(e, o, f, m, $, L) {
+      var b = o.children;
       if (b !== void 0)
         if (m)
-          if (be(b)) {
+          if (ve(b)) {
             for (m = 0; m < b.length; m++)
               d(b[m]);
             Object.freeze && Object.freeze(b);
@@ -178,10 +178,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 d(b);
-      if (B.call(n, "key")) {
+      if (B.call(o, "key")) {
         b = t(e);
-        var O = Object.keys(n).filter(function(ve) {
-          return ve !== "key";
+        var O = Object.keys(o).filter(function(Ee) {
+          return Ee !== "key";
         });
         m = 0 < O.length ? "{key: someKey, " + O.join(": ..., ") + ": ...}" : "{key: someKey}", K[b + m] || (O = 0 < O.length ? "{" + O.join(": ..., ") + ": ...}" : "{}", console.error(
           `A props object containing a "key" prop is being spread into JSX:
@@ -196,15 +196,15 @@ React keys must be passed directly to JSX without using spread:
           b
         ), K[b + m] = !0);
       }
-      if (b = null, f !== void 0 && (r(f), b = "" + f), i(n) && (r(n.key), b = "" + n.key), "key" in n) {
+      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 n)
-          W !== "key" && (f[W] = n[W]);
-      } else f = n;
+        for (var W in o)
+          W !== "key" && (f[W] = o[W]);
+      } else f = o;
       return b && c(
         f,
         typeof e == "function" ? e.displayName || e.name || "Unknown" : e
-      ), y(
+      ), R(
         e,
         b,
         f,
@@ -214,12 +214,12 @@ React keys must be passed directly to JSX without using spread:
       );
     }
     function d(e) {
-      v(e) ? e._store && (e._store.validated = 1) : typeof e == "object" && e !== null && e.$$typeof === x && (e._payload.status === "fulfilled" ? v(e._payload.value) && e._payload.value._store && (e._payload.value._store.validated = 1) : e._store && (e._store.validated = 1));
+      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 v(e) {
       return typeof e == "object" && e !== null && e.$$typeof === E;
     }
-    var S = Ee, E = Symbol.for("react.transitional.element"), p = Symbol.for("react.portal"), h = Symbol.for("react.fragment"), A = Symbol.for("react.strict_mode"), P = Symbol.for("react.profiler"), g = Symbol.for("react.consumer"), R = 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"), x = Symbol.for("react.lazy"), k = Symbol.for("react.activity"), me = Symbol.for("react.client.reference"), M = S.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE, B = Object.prototype.hasOwnProperty, be = Array.isArray, z = console.createTask ? console.createTask : function() {
+    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() {
       return null;
     };
     S = {
@@ -231,21 +231,21 @@ React keys must be passed directly to JSX without using spread:
       S,
       a
     )(), Q = z(l(a)), K = {};
-    N.Fragment = h, N.jsx = function(e, n, f) {
+    N.Fragment = h, N.jsx = function(e, o, f) {
       var m = 1e4 > M.recentlyCreatedOwnerStacks++;
       return w(
         e,
-        n,
+        o,
         f,
         !1,
         m ? Error("react-stack-top-frame") : Z,
         m ? z(l(e)) : Q
       );
-    }, N.jsxs = function(e, n, f) {
+    }, N.jsxs = function(e, o, f) {
       var m = 1e4 > M.recentlyCreatedOwnerStacks++;
       return w(
         e,
-        n,
+        o,
         f,
         !0,
         m ? Error("react-stack-top-frame") : Z,
@@ -255,14 +255,14 @@ React keys must be passed directly to JSX without using spread:
   })()), N;
 }
 var oe;
-function ge() {
-  return oe || (oe = 1, process.env.NODE_ENV === "production" ? I.exports = Re() : I.exports = Te()), I.exports;
+function ke() {
+  return oe || (oe = 1, process.env.NODE_ENV === "production" ? I.exports = Te() : I.exports = ge()), I.exports;
 }
-var ke = ge();
-function D(t, o, r) {
-  if (!o)
+var we = ke();
+function D(t, n, r) {
+  if (!n)
     return t;
-  const l = o.split(".");
+  const l = n.split(".");
   let s = t;
   for (const a of l)
     if (s !== null && typeof s == "object" && a in s)
@@ -271,8 +271,8 @@ function D(t, o, r) {
       return r;
   return s === void 0 ? r : s;
 }
-function we(t, o, r) {
-  const l = o.replace(/\[(\d+)\]/g, ".$1").split(".");
+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];
@@ -280,29 +280,29 @@ function we(t, o, r) {
   }
   return s[l[l.length - 1]] = r, t;
 }
-function Pe(t, o = 0) {
+function Pe(t, n = 0) {
   let r;
   return function(...l) {
     r !== void 0 && clearTimeout(r), r = setTimeout(() => {
       r = void 0, t.apply(this, l);
-    }, o);
+    }, n);
   };
 }
-function xe(t, o, r = []) {
+function Ae(t, n, r = []) {
   return ae(
-    () => Pe(t, o),
+    () => Pe(t, n),
     // eslint-disable-next-line react-hooks/exhaustive-deps
     r
   );
 }
 function se(t) {
-  const o = JSON.stringify(t, null, 2).split(`
+  const n = JSON.stringify(t, null, 2).split(`
 `), r = [], l = [];
-  for (const s of o) {
+  for (const s of n) {
     const a = s.match(/^(\s*)"([^"]+)"(\s*:\s*)(.+)$/);
     if (a) {
-      const [, i, c, T, y] = a;
-      r.push(`${i}%c"${c}"%c${T}%c${y}`), l.push(
+      const [, i, c, y, R] = a;
+      r.push(`${i}%c"${c}"%c${y}%c${R}`), l.push(
         "color: #9cdcfe; font-weight: bold",
         "color: #cccccc",
         "color: #ce9178"
@@ -313,15 +313,15 @@ function se(t) {
   console.log(r.join(`
 `), ...l, t);
 }
-const ue = (t) => typeof t == "function", Ae = (t) => typeof t == "function", V = (t) => typeof t < "u", J = (t) => Ae(t) ? t() : t;
-class Oe {
+const ue = (t) => typeof t == "function", Oe = (t) => typeof t == "function", V = (t) => typeof t < "u", J = (t) => Oe(t) ? t() : t;
+class je {
   #e;
   #t;
   constructor() {
     this.uid = Math.random().toString(36).slice(2), this.#e = {}, this.#t = /* @__PURE__ */ new Set();
   }
-  subscribe(o) {
-    return this.#t.add(o), () => this.#t.delete(o);
+  subscribe(n) {
+    return this.#t.add(n), () => this.#t.delete(n);
   }
   getClientSnapshot() {
     return this.#e;
@@ -329,26 +329,27 @@ class Oe {
   getServerSnapshot() {
     return this.#e;
   }
-  get(o) {
-    return D(this.#e, o);
+  get(n) {
+    return D(this.#e, n);
   }
-  set(o, r) {
-    const l = D(this.#e, o), s = ue(r) ? r(l) : r, a = { ...this.#e };
-    we(a, o, s), this.#e = a, this.#t.forEach((i) => i());
+  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 le = pe({});
-function je() {
-  return Se(le);
+const le = Se({});
+function ie(t = {}) {
+  const n = he(le);
+  return t.verbose && console.log(`[${ie.name}]: `, n.uid), n;
 }
 function Ve({ children: t }) {
-  const o = ae(() => new Oe(), []);
-  return /* @__PURE__ */ ke.jsx(le.Provider, { value: o, children: t });
+  const n = ae(() => new je(), []);
+  return /* @__PURE__ */ we.jsx(le.Provider, { value: n, children: t });
 }
-const ie = Symbol("state-def"), Y = Symbol("state-path"), U = Symbol("state-verbose"), q = Symbol("state-verbose-path"), G = Symbol("state-ssr"), fe = typeof window > "u", Ce = fe ? ce : _e;
+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 = {}) {
   return {
-    [ie]: !0,
+    [fe]: !0,
     // marks this object as a leaf in the router tree
     [Y]: "",
     // placeholder; injected at runtime by injectPaths()
@@ -358,16 +359,16 @@ function $e(t = {}) {
     // placeholder
     [G]: !1,
     // placeholder
-    useState(o) {
-      const r = fe ? void 0 : J(t.storage), l = J(t.defaultValue), s = t.bidirectional;
-      o ??= {};
-      const a = J(o.defaultValue) ?? l, i = o.bidirectional ?? s, c = this[Y], T = this[U], y = this[q], w = this[G], d = je(), v = t.serialize ?? JSON.stringify, S = t.deserialize ?? JSON.parse, E = (u, _, x) => {
+    useState(n) {
+      const r = de ? void 0 : J(t.storage), l = J(t.defaultValue), s = 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(x) && _.setItem(u, v(x)) : d.set(u, S(k));
-      }, p = xe(
-        o.onSet ?? (() => {
+        k === null ? V(P) && _.setItem(u, v(P)) : d.set(u, S(k));
+      }, p = Ae(
+        n.onSet ?? (() => {
         }),
-        o.delayedSet,
+        n.delayedSet,
         []
       ), h = ee(void 0), A = ee(!1);
       if (!A.current) {
@@ -375,22 +376,22 @@ function $e(t = {}) {
         let u = d.get(c);
         V(u) || (u = a, V(u) && d.set(c, u)), !w && r && E(c, r, u);
       }
-      const P = he(
+      const x = _e(
         d.subscribe.bind(d),
         d.getClientSnapshot.bind(d),
         d.getServerSnapshot.bind(d)
       );
-      if (T)
-        if (y) {
-          const u = D(P, y);
+      if (y)
+        if (R) {
+          const u = D(x, R);
           u && se(u);
         } else
-          se(P);
-      const g = D(P, c, a);
+          se(x);
+      const g = D(x, c, a);
       h.current = g, Ce(() => {
         !w || !r || E(c, r, g);
       }, []);
-      const R = ye((u) => {
+      const T = Re((u) => {
         if (u.key !== c)
           return;
         const _ = u.newValue, k = (_ === null ? null : S(_)) ?? a;
@@ -398,7 +399,7 @@ function $e(t = {}) {
       });
       ce(() => {
         if (i)
-          return window.addEventListener("storage", R), () => window.removeEventListener("storage", R);
+          return window.addEventListener("storage", T), () => window.removeEventListener("storage", T);
       }, [i]);
       const j = te((u) => {
         const _ = ue(u) ? u(h.current) : u;
@@ -423,23 +424,23 @@ function $e(t = {}) {
     }
   };
 }
-function de(t, o) {
+function me(t, n) {
   const {
     path: r = "",
     verbose: l,
     verbosePath: s,
     ssr: a,
     cache: i
-  } = o;
+  } = n;
   let c = i.proxy.get(t);
   c || (c = /* @__PURE__ */ new Map(), i.proxy.set(t, c));
-  const T = c.get(r);
-  if (T)
-    return T;
-  const y = new Proxy(t, {
+  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" && ie in v) {
+      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));
@@ -447,11 +448,11 @@ function de(t, o) {
         if (h)
           return h;
         const A = Reflect.ownKeys(E).filter(
-          (R) => typeof E[R] == "function"
-        ), P = Object.fromEntries(
-          A.map((R) => [
-            R,
-            (...j) => E[R].call(
+          (T) => typeof E[T] == "function"
+        ), x = Object.fromEntries(
+          A.map((T) => [
+            T,
+            (...j) => E[T].call(
               {
                 ...E,
                 [Y]: S,
@@ -462,21 +463,21 @@ function de(t, o) {
               ...j
             )
           ])
-        ), g = { ...E, ...P };
+        ), g = { ...E, ...x };
         return p.set(S, g), g;
       }
-      return v && typeof v == "object" ? de(v, {
-        ...o,
+      return v && typeof v == "object" ? me(v, {
+        ...n,
         path: S
       }) : v;
     }
   });
-  return c.set(r, y), y;
+  return c.set(r, R), R;
 }
-function Ie(t, o) {
-  return de(t, {
-    ...o,
-    verbosePath: o?.verbosePath ?? "",
+function Ie(t, n) {
+  return me(t, {
+    ...n,
+    verbosePath: n?.verbosePath ?? "",
     cache: {
       proxy: /* @__PURE__ */ new WeakMap(),
       leaf: /* @__PURE__ */ new WeakMap()

package/dist/types/context.d.ts

@@ -1,4 +1,6 @@
 import { type PropsWithChildren } from "react";
 import VocabStore from "./store";
-export declare function useVocabStoreContext(): VocabStore;
+export declare function useVocabStoreContext(options?: {
+    verbose?: boolean;
+}): VocabStore;
 export declare function VocabStoreContextProvider({ children }: PropsWithChildren): import("react/jsx-runtime").JSX.Element;

package/package.json

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