@yakocloud/state-vocab 3.0.5 → 3.0.7

package/dist/state-vocab.cjs.js

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

package/dist/state-vocab.es.js

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

package/dist/types/index.d.ts

@@ -1,2 +1,3 @@
+export { runWithStateVocab } from "./store";
 export { defineState } from "./state";
 export { setupStorage } from "./setup";

package/dist/types/store.d.ts

@@ -12,5 +12,6 @@ declare class VocabStore {
     get<V>(statePath: string): V | undefined;
     set<V>(statePath: string, value: ValueOrTransformer<V>): void;
 }
+export declare function runWithStateVocab<T>(fn: () => T): T;
 export declare const getVocabStore: () => VocabStore;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yakocloud/state-vocab",
-  "version": "3.0.5",
+  "version": "3.0.7",
   "main": "dist/state-vocab.cjs.js",
   "module": "dist/state-vocab.es.js",
   "types": "dist/types/index.d.ts",
@@ -50,7 +50,6 @@
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
     "@types/jest": "^30.0.0",
-    "@types/node": "^24.10.1",
     "@types/react": "^19.2.5",
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^5.2.0",