@yakocloud/state-vocab 3.0.1 → 3.0.2

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` |
+| `ssr` | `boolean \| undefined` | Defer storage reads until after hydration (Next.js / SSR) | `false` |
 
 ```ts
 const storage = setupStorage({
@@ -207,6 +208,25 @@ Enable verbose logging during development:
 const storage = setupStorage({ ... }, { verbose: true })
 ```
 
+### 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 +409,7 @@ createRoot(document.getElementById('root')!).render(<Page />)
 | Option | Type | Default |
 |---|---|---|
 | `verbose` | `boolean \| undefined` | `false` |
+| `ssr` | `boolean \| undefined` | `false` |
 
 Returns a proxied copy of `tree` with paths injected into all leaf nodes.
 

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 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;

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 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) {
+  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 n === void 0 ? s : n;
+      return n;
+  return c === void 0 ? n : c;
 }
-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 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];
   }
-  return n[r[r.length - 1]] = s, e;
+  return c[o[o.length - 1]] = n, t;
 }
-function L(e, t = 0) {
-  let s;
-  return function(...r) {
-    s !== void 0 && clearTimeout(s), s = setTimeout(() => {
-      s = void 0, e.apply(this, r);
-    }, 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);
+    }, e);
   };
 }
-function O(e, t, s = []) {
-  return A(
-    () => L(e, t),
+function K(t, e, n = []) {
+  return j(
+    () => B(t, e),
     // eslint-disable-next-line react-hooks/exhaustive-deps
-    s
+    n
   );
 }
-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 W(t) {
+  const e = JSON.stringify(t, null, 2).split(`
+`), n = [], o = [];
+  for (const c of e) {
+    const r = c.match(/^(\s*)"([^"]+)"(\s*:\s*)(.+)$/);
+    if (r) {
+      const [, s, a, f, d] = r;
+      n.push(`${s}%c"${a}"%c${f}%c${d}`), o.push(
         "color: #9cdcfe; font-weight: bold",
         "color: #cccccc",
         "color: #ce9178"
       );
     } else
-      s.push(`%c${n}`), r.push("color: #cccccc");
+      n.push(`%c${c}`), o.push("color: #cccccc");
   }
-  console.log(s.join(`
-`), ...r, e);
+  console.log(n.join(`
+`), ...o, 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 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 {
   #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,88 @@ 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 x(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());
   }
 }
-function q(e = {}) {
-  const t = new K();
+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));
+  };
   return {
-    [M]: !0,
+    [L]: !0,
     // marks this object as a leaf in the router tree
     [V]: "",
     // placeholder; injected at runtime by injectPaths()
-    [$]: !1,
+    [k]: !1,
+    // placeholder
+    [z]: !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 s = N ? void 0 : $(t.storage), a = $(t.defaultValue), f = t.bidirectional;
+      r ??= {};
+      const d = $(r.defaultValue) ?? a, p = r.bidirectional ?? f, u = K(
+        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);
-        }
+      ), 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);
       }
-      const m = D(
-        t.subscribe.bind(t),
-        () => t.getClientSnapshot(),
-        () => t.getServerSnapshot()
+      const w = 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)
+      h && W(w);
+      const b = x(w, i, d);
+      S.current = b, q(() => {
+        !y || !s || c(i, s, b);
+      }, []);
+      const g = O((l) => {
+        if (l.key !== i)
           return;
-        const d = i.newValue, E = (d === null ? null : o(d)) ?? u;
-        v(E) && (t.set(c, E), f(E, h.current));
+        const v = l.newValue, I = (v === null ? null : o(v)) ?? d;
+        m(I) && (e.set(i, I), u(I, S.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));
+      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));
       }, [
-        c,
-        r,
+        i,
+        s,
         n,
-        f
-      ]), R = I(() => {
-        const i = u;
-        if (!v(i)) {
-          r?.removeItem(c);
+        u
+      ]), _ = R(() => {
+        const l = d;
+        if (!m(l)) {
+          s?.removeItem(i);
           return;
         }
-        t.set(c, i), f(i, h.current), r && r.setItem(c, n(i));
+        e.set(i, l), u(l, S.current), s && s.setItem(i, n(l));
       }, [
-        c,
-        u,
-        r,
+        i,
+        d,
+        s,
         n,
-        f
+        u
       ]);
       return [
-        p,
-        w,
-        R
+        b,
+        T,
+        _
       ];
     },
     /** Returns the fully qualified job name (dot-separated path). */
@@ -156,57 +160,64 @@ function q(e = {}) {
     }
   };
 }
-const C = /* @__PURE__ */ new WeakMap(), x = /* @__PURE__ */ new WeakMap();
-function P(e, t) {
-  t ??= {};
+function D(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"
-        ), m = Object.fromEntries(
-          b.map((y) => [
-            y,
-            (...w) => c[y].call(
+    path: n = "",
+    verbose: o,
+    ssr: c,
+    cache: r
+  } = 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(
               {
-                ...c,
-                [V]: f,
-                [$]: r
+                ...h,
+                [V]: i,
+                [k]: o,
+                [z]: c
               },
-              ...w
+              ...T
             )
           ])
-        ), p = { ...c, ...m };
-        return g.set(f, p), p;
+        ), b = { ...h, ...w };
+        return y.set(i, b), b;
       }
-      return a && typeof a == "object" ? P(a, {
-        path: f,
-        verbose: r
-      }) : a;
+      return u && typeof u == "object" ? D(u, {
+        ...e,
+        path: i
+      }) : u;
     }
   });
-  return n.set(s, l), l;
+  return s.set(n, f), f;
 }
-function G(e, t) {
-  return P(e, t);
+function Y(t, e) {
+  return D(t, {
+    ...e,
+    cache: {
+      proxy: /* @__PURE__ */ new WeakMap(),
+      leaf: /* @__PURE__ */ new WeakMap()
+    }
+  });
 }
 export {
-  q as defineState,
-  G as setupStorage
+  X as defineState,
+  Y as setupStorage
 };

package/dist/types/constants.d.ts

@@ -1,3 +1,4 @@
 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_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,7 @@
 type InjectPathsOptions = {
     path: string;
     verbose: boolean;
+    ssr: boolean;
 };
 export declare function setupStorage<T extends object>(native: T, options?: Partial<Omit<InjectPathsOptions, "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 } from "./constants";
 import type { Deserialize, Serialize, ValueOrFactory, ValueOrTransformer } from "./state.types";
 export declare function defineState<D>(definitionOptions?: {
     storage?: ValueOrFactory<Storage>;
@@ -10,9 +10,11 @@ export declare function defineState<D>(definitionOptions?: {
     [STATE_DEFINITION]: boolean;
     [STATE_PATH]: string;
     [STATE_VERBOSE]: boolean;
+    [STATE_SSR]: boolean;
     useState(this: {
         [STATE_PATH]: string;
         [STATE_VERBOSE]: boolean;
+        [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.2",
   "main": "dist/state-vocab.cjs.js",
   "module": "dist/state-vocab.es.js",
   "types": "dist/types/index.d.ts",