@yakocloud/state-vocab 3.0.2 → 3.0.4

package/README.md

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

package/dist/types/constants.d.ts

@@ -1,4 +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/setup.d.ts

@@ -1,7 +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_SSR, 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,10 +10,12 @@ 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>;

package/package.json

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