@yakocloud/state-vocab 3.0.1 → 3.0.3

package/README.md

@@ -188,6 +188,8 @@ Wraps a nested object of `defineState()` nodes and injects dot-separated paths i
 | Option | Type | Description | Default |
 |---|---|---|---|
 | `verbose` | `boolean \| undefined` | Log current state to the browser console on every change | `false` |
+| `verbosePath` | `string \| undefined` | Narrow verbose logging to a specific subtree (dot-separated path). When set, only that subtree is logged instead of the entire state. TypeScript will autocomplete valid paths based on your tree. | `undefined` |
+| `ssr` | `boolean \| undefined` | Defer storage reads until after hydration (Next.js / SSR) | `false` |
 
 ```ts
 const storage = setupStorage({
@@ -207,6 +209,44 @@ Enable verbose logging during development:
 const storage = setupStorage({ ... }, { verbose: true })
 ```
 
+Narrow verbose logging to a specific subtree:
+
+```ts
+const storage = setupStorage({
+  user: {
+    profile: defineState({ ... }),
+    settings: defineState({ ... }),
+  },
+  cart: {
+    items: defineState({ ... }),
+  },
+}, {
+  verbose: true,
+  verbosePath: "user", // only logs changes inside "user.*"
+})
+```
+
+TypeScript will only accept paths that exist in your tree — `"user"`, `"user.profile"`, `"cart.items"`, etc. Invalid paths are caught at compile time.
+
+### SSR / Next.js
+
+When using localStorage or sessionStorage in a Next.js app, the server renders with `defaultValue` while the client reads the persisted value — causing a hydration mismatch. Pass `ssr: true` to fix this:
+
+```ts
+// lib/storage.ts
+const storage = setupStorage({
+  preference: {
+    theme: defineState<Theme>({ storage: localStorage, defaultValue: 'Dark' }),
+  },
+}, { ssr: true })
+```
+
+With `ssr: true`:
+- **Server & first client render** — always use `defaultValue`, storage is not read
+- **After hydration** — `useLayoutEffect` fires synchronously before paint, reads storage and updates state
+
+This guarantees the server and client produce identical markup, and the value from storage is applied without a visible flash.
+
 ## `useState` Hook
 
 Each state node exposes a `.useState()` method that works like React's built-in `useState` but adds persistence and callbacks.
@@ -389,6 +429,8 @@ createRoot(document.getElementById('root')!).render(<Page />)
 | Option | Type | Default |
 |---|---|---|
 | `verbose` | `boolean \| undefined` | `false` |
+| `verbosePath` | `Path<T> \| undefined` | `undefined` |
+| `ssr` | `boolean \| undefined` | `false` |
 
 Returns a proxied copy of `tree` with paths injected into all leaf nodes.
 
@@ -401,4 +443,4 @@ Returns a proxied copy of `tree` with paths injected into all leaf nodes.
 | `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]`

package/dist/state-vocab.cjs.js

@@ -1,3 +1,3 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const S=require("react"),M=Symbol("state-def"),w=Symbol("state-path"),$=Symbol("state-verbose");function z(e,t,s){if(!t)return e;const r=t.split(".");let n=e;for(const o of r)if(n!==null&&typeof n=="object"&&o in n)n=n[o];else return s;return n===void 0?s:n}function N(e,t,s){const r=t.replace(/\[(\d+)\]/g,".$1").split(".");let n=e;for(let o=0;o<r.length-1;o++){const a=r[o],g=r[o+1];(n[a]===void 0||n[a]===null)&&(n[a]=/^\d+$/.test(g)?[]:{}),n=n[a]}return n[r[r.length-1]]=s,e}function j(e,t=0){let s;return function(...r){s!==void 0&&clearTimeout(s),s=setTimeout(()=>{s=void 0,e.apply(this,r)},t)}}function A(e,t,s=[]){return S.useMemo(()=>j(e,t),s)}function D(e){const t=JSON.stringify(e,null,2).split(`
-`),s=[],r=[];for(const n of t){const o=n.match(/^(\s*)"([^"]+)"(\s*:\s*)(.+)$/);if(o){const[,a,g,u,l]=o;s.push(`${a}%c"${g}"%c${u}%c${l}`),r.push("color: #9cdcfe; font-weight: bold","color: #cccccc","color: #ce9178")}else s.push(`%c${n}`),r.push("color: #cccccc")}console.log(s.join(`
-`),...r,e)}const P=e=>typeof e=="function",O=e=>typeof e=="function",p=e=>typeof e<"u",k=e=>O(e)?e():e;class F{#e;#t;constructor(){this.#e={},this.#t=new Set}subscribe(t){return this.#t.add(t),()=>this.#t.delete(t)}getClientSnapshot(){return this.#e}getServerSnapshot(){return this.#e}set(t,s){const r=z(this.#e,t),n=P(s)?s(r):s,o={...this.#e};N(o,t,n),this.#e=o,this.#t.forEach(a=>a())}}function J(e={}){const t=new F;return{[M]:!0,[w]:"",[$]:!1,useState(s){const r=k(e.storage),n=e.serialize??JSON.stringify,o=e.deserialize??JSON.parse,a=k(e.defaultValue),g=e.bidirectional;s??={};const u=k(s.defaultValue)??a,l=s.bidirectional??g,f=A(s.onSet??(()=>{}),s.delayedSet,[]),c=this[w],y=this[$],h=S.useRef(void 0),m=S.useRef(!1);if(!m.current){m.current=!0;let i=z(t.getServerSnapshot(),c);if(!p(i)){if(i=u,r){const d=r.getItem(c);d===null?p(i)&&r.setItem(c,n(i)):i=o(d)}p(i)&&t.set(c,i)}}const V=S.useSyncExternalStore(t.subscribe.bind(t),()=>t.getClientSnapshot(),()=>t.getServerSnapshot());y&&D(V);const v=z(V,c);h.current=v;const b=S.useEffectEvent(i=>{if(i.key!==c)return;const d=i.newValue,T=(d===null?null:o(d))??u;p(T)&&(t.set(c,T),f(T,h.current))});S.useEffect(()=>{if(l)return window.addEventListener("storage",b),()=>window.removeEventListener("storage",b)},[l]);const E=S.useCallback(i=>{const d=P(i)?i(h.current):i;t.set(c,d),f(d,h.current),r&&r.setItem(c,n(d))},[c,r,n,f]),x=S.useCallback(()=>{const i=u;if(!p(i)){r?.removeItem(c);return}t.set(c,i),f(i,h.current),r&&r.setItem(c,n(i))},[c,u,r,n,f]);return[v,E,x]},toString(){return this[w]}}}const C=new WeakMap,I=new WeakMap;function R(e,t){t??={};const{path:s="",verbose:r}=t;let n=C.get(e);n||(n=new Map,C.set(e,n));const o=n.get(s);if(o)return o;const a=new Proxy(e,{get(g,u){const l=g[u],f=s?`${s}.${String(u)}`:String(u);if(l&&typeof l=="object"&&M in l){const c=l;let y=I.get(c);y||(y=new Map,I.set(c,y));const h=y.get(f);if(h)return h;const m=Reflect.ownKeys(c).filter(b=>typeof c[b]=="function"),V=Object.fromEntries(m.map(b=>[b,(...E)=>c[b].call({...c,[w]:f,[$]:r},...E)])),v={...c,...V};return y.set(f,v),v}return l&&typeof l=="object"?R(l,{path:f,verbose:r}):l}});return n.set(s,a),a}function L(e,t){return R(e,t)}exports.defineState=J;exports.setupStorage=L;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const d=require("react"),M=Symbol("state-def"),k=Symbol("state-path"),R=Symbol("state-verbose"),x=Symbol("state-verbose-path"),A=Symbol("state-ssr");function I(t,e,s){if(!e)return t;const i=e.split(".");let c=t;for(const r of i)if(c!==null&&typeof c=="object"&&r in c)c=c[r];else return s;return c===void 0?s:c}function j(t,e,s){const i=e.replace(/\[(\d+)\]/g,".$1").split(".");let c=t;for(let r=0;r<i.length-1;r++){const n=i[r],l=i[r+1];(c[n]===void 0||c[n]===null)&&(c[n]=/^\d+$/.test(l)?[]:{}),c=c[n]}return c[i[i.length-1]]=s,t}function D(t,e=0){let s;return function(...i){s!==void 0&&clearTimeout(s),s=setTimeout(()=>{s=void 0,t.apply(this,i)},e)}}function B(t,e,s=[]){return d.useMemo(()=>D(t,e),s)}function C(t){const e=JSON.stringify(t,null,2).split(`
+`),s=[],i=[];for(const c of e){const r=c.match(/^(\s*)"([^"]+)"(\s*:\s*)(.+)$/);if(r){const[,n,l,h,u]=r;s.push(`${n}%c"${l}"%c${h}%c${u}`),i.push("color: #9cdcfe; font-weight: bold","color: #cccccc","color: #ce9178")}else s.push(`%c${c}`),i.push("color: #cccccc")}console.log(s.join(`
+`),...i,t)}const _=t=>typeof t=="function",F=t=>typeof t=="function",T=t=>typeof t<"u",P=t=>F(t)?t():t,L=typeof window>"u",J=L?d.useEffect:d.useLayoutEffect;class H{#e;#t;constructor(){this.#e={},this.#t=new Set}subscribe(e){return this.#t.add(e),()=>this.#t.delete(e)}getClientSnapshot(){return this.#e}getServerSnapshot(){return this.#e}get(e){return I(this.#e,e)}set(e,s){const i=I(this.#e,e),c=_(s)?s(i):s,r={...this.#e};j(r,e,c),this.#e=r,this.#t.forEach(n=>n())}}function K(t={}){const e=new H,s=t.serialize??JSON.stringify,i=t.deserialize??JSON.parse,c=(r,n,l)=>{const h=n.getItem(r);h===null?T(l)&&n.setItem(r,s(l)):e.set(r,i(h))};return{[M]:!0,[k]:"",[R]:!1,[x]:"",[A]:!1,useState(r){const n=L?void 0:P(t.storage),l=P(t.defaultValue),h=t.bidirectional;r??={};const u=P(r.defaultValue)??l,w=r.bidirectional??h,S=B(r.onSet??(()=>{}),r.delayedSet,[]),o=this[k],v=this[R],f=this[x],y=this[A],b=d.useRef(void 0),V=d.useRef(!1);if(!V.current){V.current=!0;let a=e.get(o);T(a)||(a=u,T(a)&&e.set(o,a)),!y&&n&&c(o,n,a)}const E=d.useSyncExternalStore(e.subscribe.bind(e),e.getClientSnapshot.bind(e),e.getServerSnapshot.bind(e));if(v)if(f){const a=I(E,f);a&&C(a)}else C(E);const p=I(E,o,u);b.current=p,J(()=>{!y||!n||c(o,n,p)},[]);const g=d.useEffectEvent(a=>{if(a.key!==o)return;const m=a.newValue,z=(m===null?null:i(m))??u;T(z)&&(e.set(o,z),S(z,b.current))});d.useEffect(()=>{if(w)return window.addEventListener("storage",g),()=>window.removeEventListener("storage",g)},[w]);const $=d.useCallback(a=>{const m=_(a)?a(b.current):a;e.set(o,m),S(m,b.current),n&&n.setItem(o,s(m))},[o,n,S]),O=d.useCallback(()=>{const a=u;if(!T(a)){n?.removeItem(o);return}e.set(o,a),S(a,b.current),n&&n.setItem(o,s(a))},[o,u,n,S]);return[p,$,O]},toString(){return this[k]}}}function N(t,e){const{path:s="",verbose:i,verbosePath:c,ssr:r,cache:n}=e;let l=n.proxy.get(t);l||(l=new Map,n.proxy.set(t,l));const h=l.get(s);if(h)return h;const u=new Proxy(t,{get(w,S){const o=w[S],v=s?`${s}.${String(S)}`:String(S);if(o&&typeof o=="object"&&M in o){const f=o;let y=n.leaf.get(f);y||(y=new Map,n.leaf.set(f,y));const b=y.get(v);if(b)return b;const V=Reflect.ownKeys(f).filter(g=>typeof f[g]=="function"),E=Object.fromEntries(V.map(g=>[g,(...$)=>f[g].call({...f,[k]:v,[R]:i,[x]:c,[A]:r},...$)])),p={...f,...E};return y.set(v,p),p}return o&&typeof o=="object"?N(o,{...e,path:v}):o}});return l.set(s,u),u}function W(t,e){return N(t,{...e,verbosePath:e?.verbosePath??"",cache:{proxy:new WeakMap,leaf:new WeakMap}})}exports.defineState=K;exports.setupStorage=W;

package/dist/state-vocab.es.js

@@ -1,68 +1,68 @@
-import { useMemo as A, useRef as z, useSyncExternalStore as D, useEffectEvent as j, useEffect as F, useCallback as I } from "react";
-const M = Symbol("state-def"), V = Symbol("state-path"), $ = Symbol("state-verbose");
-function k(e, t, s) {
-  if (!t)
-    return e;
-  const r = t.split(".");
-  let n = e;
-  for (const o of r)
-    if (n !== null && typeof n == "object" && o in n)
-      n = n[o];
+import { useMemo as B, useRef as R, useSyncExternalStore as F, useEffect as L, useLayoutEffect as J, useEffectEvent as H, useCallback as C } from "react";
+const M = Symbol("state-def"), V = Symbol("state-path"), x = Symbol("state-verbose"), P = Symbol("state-verbose-path"), A = Symbol("state-ssr");
+function I(t, e, s) {
+  if (!e)
+    return t;
+  const i = e.split(".");
+  let o = t;
+  for (const r of i)
+    if (o !== null && typeof o == "object" && r in o)
+      o = o[r];
     else
       return s;
-  return n === void 0 ? s : n;
+  return o === void 0 ? s : o;
 }
-function J(e, t, s) {
-  const r = t.replace(/\[(\d+)\]/g, ".$1").split(".");
-  let n = e;
-  for (let o = 0; o < r.length - 1; o++) {
-    const l = r[o], S = r[o + 1];
-    (n[l] === void 0 || n[l] === null) && (n[l] = /^\d+$/.test(S) ? [] : {}), n = n[l];
+function K(t, e, s) {
+  const i = e.replace(/\[(\d+)\]/g, ".$1").split(".");
+  let o = t;
+  for (let r = 0; r < i.length - 1; r++) {
+    const n = i[r], a = i[r + 1];
+    (o[n] === void 0 || o[n] === null) && (o[n] = /^\d+$/.test(a) ? [] : {}), o = o[n];
   }
-  return n[r[r.length - 1]] = s, e;
+  return o[i[i.length - 1]] = s, t;
 }
-function L(e, t = 0) {
+function W(t, e = 0) {
   let s;
-  return function(...r) {
+  return function(...i) {
     s !== void 0 && clearTimeout(s), s = setTimeout(() => {
-      s = void 0, e.apply(this, r);
-    }, t);
+      s = void 0, t.apply(this, i);
+    }, e);
   };
 }
-function O(e, t, s = []) {
-  return A(
-    () => L(e, t),
+function q(t, e, s = []) {
+  return B(
+    () => W(t, e),
     // eslint-disable-next-line react-hooks/exhaustive-deps
     s
   );
 }
-function _(e) {
-  const t = JSON.stringify(e, null, 2).split(`
-`), s = [], r = [];
-  for (const n of t) {
-    const o = n.match(/^(\s*)"([^"]+)"(\s*:\s*)(.+)$/);
-    if (o) {
-      const [, l, S, u, a] = o;
-      s.push(`${l}%c"${S}"%c${u}%c${a}`), r.push(
+function _(t) {
+  const e = JSON.stringify(t, null, 2).split(`
+`), s = [], i = [];
+  for (const o of e) {
+    const r = o.match(/^(\s*)"([^"]+)"(\s*:\s*)(.+)$/);
+    if (r) {
+      const [, n, a, d, u] = r;
+      s.push(`${n}%c"${a}"%c${d}%c${u}`), i.push(
         "color: #9cdcfe; font-weight: bold",
         "color: #cccccc",
         "color: #ce9178"
       );
     } else
-      s.push(`%c${n}`), r.push("color: #cccccc");
+      s.push(`%c${o}`), i.push("color: #cccccc");
   }
   console.log(s.join(`
-`), ...r, e);
+`), ...i, t);
 }
-const N = (e) => typeof e == "function", B = (e) => typeof e == "function", v = (e) => typeof e < "u", T = (e) => B(e) ? e() : e;
-class K {
+const N = (t) => typeof t == "function", G = (t) => typeof t == "function", E = (t) => typeof t < "u", z = (t) => G(t) ? t() : t, D = typeof window > "u", Q = D ? L : J;
+class U {
   #e;
   #t;
   constructor() {
     this.#e = {}, this.#t = /* @__PURE__ */ new Set();
   }
-  subscribe(t) {
-    return this.#t.add(t), () => this.#t.delete(t);
+  subscribe(e) {
+    return this.#t.add(e), () => this.#t.delete(e);
   }
   getClientSnapshot() {
     return this.#e;
@@ -70,84 +70,84 @@ class K {
   getServerSnapshot() {
     return this.#e;
   }
-  set(t, s) {
-    const r = k(this.#e, t), n = N(s) ? s(r) : s, o = { ...this.#e };
-    J(o, t, n), this.#e = o, this.#t.forEach((l) => l());
+  get(e) {
+    return I(this.#e, e);
+  }
+  set(e, s) {
+    const i = I(this.#e, e), o = N(s) ? s(i) : s, r = { ...this.#e };
+    K(r, e, o), this.#e = r, this.#t.forEach((n) => n());
   }
 }
-function q(e = {}) {
-  const t = new K();
+function Z(t = {}) {
+  const e = new U(), s = t.serialize ?? JSON.stringify, i = t.deserialize ?? JSON.parse, o = (r, n, a) => {
+    const d = n.getItem(r);
+    d === null ? E(a) && n.setItem(r, s(a)) : e.set(r, i(d));
+  };
   return {
     [M]: !0,
     // marks this object as a leaf in the router tree
     [V]: "",
     // placeholder; injected at runtime by injectPaths()
-    [$]: !1,
+    [x]: !1,
+    // placeholder
+    [P]: "",
+    // placeholder
+    [A]: !1,
     // placeholder
-    useState(s) {
-      const r = T(e.storage), n = e.serialize ?? JSON.stringify, o = e.deserialize ?? JSON.parse, l = T(e.defaultValue), S = e.bidirectional;
-      s ??= {};
-      const u = T(s.defaultValue) ?? l, a = s.bidirectional ?? S, f = O(
-        s.onSet ?? (() => {
+    useState(r) {
+      const n = D ? void 0 : z(t.storage), a = z(t.defaultValue), d = t.bidirectional;
+      r ??= {};
+      const u = z(r.defaultValue) ?? a, w = r.bidirectional ?? d, h = q(
+        r.onSet ?? (() => {
         }),
-        s.delayedSet,
+        r.delayedSet,
         []
-      ), c = this[V], g = this[$], h = z(void 0), b = z(!1);
-      if (!b.current) {
-        b.current = !0;
-        let i = k(t.getServerSnapshot(), c);
-        if (!v(i)) {
-          if (i = u, r) {
-            const d = r.getItem(c);
-            d === null ? v(i) && r.setItem(c, n(i)) : i = o(d);
-          }
-          v(i) && t.set(c, i);
-        }
+      ), c = this[V], g = this[x], f = this[P], S = this[A], y = R(void 0), T = R(!1);
+      if (!T.current) {
+        T.current = !0;
+        let l = e.get(c);
+        E(l) || (l = u, E(l) && e.set(c, l)), !S && n && o(c, n, l);
       }
-      const m = D(
-        t.subscribe.bind(t),
-        () => t.getClientSnapshot(),
-        () => t.getServerSnapshot()
+      const m = F(
+        e.subscribe.bind(e),
+        e.getClientSnapshot.bind(e),
+        e.getServerSnapshot.bind(e)
       );
-      g && _(m);
-      const p = k(m, c);
-      h.current = p;
-      const y = j((i) => {
-        if (i.key !== c)
+      if (g)
+        if (f) {
+          const l = I(m, f);
+          l && _(l);
+        } else
+          _(m);
+      const v = I(m, c, u);
+      y.current = v, Q(() => {
+        !S || !n || o(c, n, v);
+      }, []);
+      const b = H((l) => {
+        if (l.key !== c)
           return;
-        const d = i.newValue, E = (d === null ? null : o(d)) ?? u;
-        v(E) && (t.set(c, E), f(E, h.current));
+        const p = l.newValue, k = (p === null ? null : i(p)) ?? u;
+        E(k) && (e.set(c, k), h(k, y.current));
       });
-      F(() => {
-        if (a)
-          return window.addEventListener("storage", y), () => window.removeEventListener("storage", y);
-      }, [a]);
-      const w = I((i) => {
-        const d = N(i) ? i(h.current) : i;
-        t.set(c, d), f(d, h.current), r && r.setItem(c, n(d));
-      }, [
-        c,
-        r,
-        n,
-        f
-      ]), R = I(() => {
-        const i = u;
-        if (!v(i)) {
-          r?.removeItem(c);
+      L(() => {
+        if (w)
+          return window.addEventListener("storage", b), () => window.removeEventListener("storage", b);
+      }, [w]);
+      const $ = C((l) => {
+        const p = N(l) ? l(y.current) : l;
+        e.set(c, p), h(p, y.current), n && n.setItem(c, s(p));
+      }, [c, n, h]), j = C(() => {
+        const l = u;
+        if (!E(l)) {
+          n?.removeItem(c);
           return;
         }
-        t.set(c, i), f(i, h.current), r && r.setItem(c, n(i));
-      }, [
-        c,
-        u,
-        r,
-        n,
-        f
-      ]);
+        e.set(c, l), h(l, y.current), n && n.setItem(c, s(l));
+      }, [c, u, n, h]);
       return [
-        p,
-        w,
-        R
+        v,
+        $,
+        j
       ];
     },
     /** Returns the fully qualified job name (dot-separated path). */
@@ -156,57 +156,67 @@ function q(e = {}) {
     }
   };
 }
-const C = /* @__PURE__ */ new WeakMap(), x = /* @__PURE__ */ new WeakMap();
-function P(e, t) {
-  t ??= {};
+function O(t, e) {
   const {
     path: s = "",
-    verbose: r
-  } = t;
-  let n = C.get(e);
-  n || (n = /* @__PURE__ */ new Map(), C.set(e, n));
-  const o = n.get(s);
-  if (o)
-    return o;
-  const l = new Proxy(e, {
-    get(S, u) {
-      const a = S[u], f = s ? `${s}.${String(u)}` : String(u);
-      if (a && typeof a == "object" && M in a) {
-        const c = a;
-        let g = x.get(c);
-        g || (g = /* @__PURE__ */ new Map(), x.set(c, g));
-        const h = g.get(f);
-        if (h)
-          return h;
-        const b = Reflect.ownKeys(c).filter(
-          (y) => typeof c[y] == "function"
+    verbose: i,
+    verbosePath: o,
+    ssr: r,
+    cache: n
+  } = e;
+  let a = n.proxy.get(t);
+  a || (a = /* @__PURE__ */ new Map(), n.proxy.set(t, a));
+  const d = a.get(s);
+  if (d)
+    return d;
+  const u = new Proxy(t, {
+    get(w, h) {
+      const c = w[h], g = s ? `${s}.${String(h)}` : String(h);
+      if (c && typeof c == "object" && M in c) {
+        const f = c;
+        let S = n.leaf.get(f);
+        S || (S = /* @__PURE__ */ new Map(), n.leaf.set(f, S));
+        const y = S.get(g);
+        if (y)
+          return y;
+        const T = Reflect.ownKeys(f).filter(
+          (b) => typeof f[b] == "function"
         ), m = Object.fromEntries(
-          b.map((y) => [
-            y,
-            (...w) => c[y].call(
+          T.map((b) => [
+            b,
+            (...$) => f[b].call(
               {
-                ...c,
-                [V]: f,
-                [$]: r
+                ...f,
+                [V]: g,
+                [x]: i,
+                [P]: o,
+                [A]: r
               },
-              ...w
+              ...$
             )
           ])
-        ), p = { ...c, ...m };
-        return g.set(f, p), p;
+        ), v = { ...f, ...m };
+        return S.set(g, v), v;
       }
-      return a && typeof a == "object" ? P(a, {
-        path: f,
-        verbose: r
-      }) : a;
+      return c && typeof c == "object" ? O(c, {
+        ...e,
+        path: g
+      }) : c;
     }
   });
-  return n.set(s, l), l;
+  return a.set(s, u), u;
 }
-function G(e, t) {
-  return P(e, t);
+function ee(t, e) {
+  return O(t, {
+    ...e,
+    verbosePath: e?.verbosePath ?? "",
+    cache: {
+      proxy: /* @__PURE__ */ new WeakMap(),
+      leaf: /* @__PURE__ */ new WeakMap()
+    }
+  });
 }
 export {
-  q as defineState,
-  G as setupStorage
+  Z as defineState,
+  ee as setupStorage
 };

package/dist/types/constants.d.ts

@@ -1,3 +1,5 @@
 export declare const STATE_DEFINITION: unique symbol;
 export declare const STATE_PATH: unique symbol;
 export declare const STATE_VERBOSE: unique symbol;
+export declare const STATE_VERBOSE_PATH: unique symbol;
+export declare const STATE_SSR: unique symbol;

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

@@ -1,2 +1,2 @@
 export declare const toLocalDatetimeString: (date: Date | null) => string;
-export declare const toDateString: (date: Date | null) => string | undefined;
+export declare const toDateString: (date: Date | null) => string;

package/dist/types/setup.d.ts

@@ -1,6 +1,14 @@
-type InjectPathsOptions = {
+import { STATE_DEFINITION } from "./constants";
+type Path<T, Prefix extends string = ""> = {
+    [K in keyof T & string]: T[K] extends object ? T[K] extends {
+        [STATE_DEFINITION]: unknown;
+    } ? `${Prefix}${K}` : `${Prefix}${K}` | Path<T[K], `${Prefix}${K}.`> : `${Prefix}${K}`;
+}[keyof T & string];
+type InjectPathsOptions<T extends object> = {
     path: string;
     verbose: boolean;
+    verbosePath: Path<T>;
+    ssr: boolean;
 };
-export declare function setupStorage<T extends object>(native: T, options?: Partial<Omit<InjectPathsOptions, "path">>): T;
+export declare function setupStorage<T extends object>(native: T, options?: Partial<Omit<InjectPathsOptions<T>, "path">>): T;
 export {};

package/dist/types/state.d.ts

@@ -1,4 +1,4 @@
-import { STATE_DEFINITION, STATE_PATH, STATE_VERBOSE } from "./constants";
+import { STATE_DEFINITION, STATE_PATH, STATE_SSR, STATE_VERBOSE, STATE_VERBOSE_PATH } from "./constants";
 import type { Deserialize, Serialize, ValueOrFactory, ValueOrTransformer } from "./state.types";
 export declare function defineState<D>(definitionOptions?: {
     storage?: ValueOrFactory<Storage>;
@@ -10,9 +10,13 @@ export declare function defineState<D>(definitionOptions?: {
     [STATE_DEFINITION]: boolean;
     [STATE_PATH]: string;
     [STATE_VERBOSE]: boolean;
+    [STATE_VERBOSE_PATH]: string;
+    [STATE_SSR]: boolean;
     useState(this: {
         [STATE_PATH]: string;
         [STATE_VERBOSE]: boolean;
+        [STATE_VERBOSE_PATH]: string;
+        [STATE_SSR]: boolean;
     }, options?: {
         defaultValue?: ValueOrFactory<D>;
         delayedSet?: number;

package/package.json

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