@yiin/reactive-proxy-state 1.0.36 → 1.0.37

package/dist/index.cjs

@@ -4039,6 +4039,7 @@ function trackVueReactiveEvents(vueState, emit, options = {}) {
   const prev = {};
   const pathStack = [];
   const keyStops = new Map;
+  let rootStop = null;
   for (const k of Object.keys(vueState)) {
     prev[k] = deepClone(vueState[k]);
   }
@@ -4066,41 +4067,63 @@ function trackVueReactiveEvents(vueState, emit, options = {}) {
     }, { flush: "sync" });
     keyStops.set(k, stop);
   }
-  for (const k of Object.keys(prev)) {
-    createKeyEffect(k);
-  }
-  const stopRoot = import_vue.watchEffect(() => {
-    const currKeys = Object.keys(vueState);
-    const currKeySet = new Set(currKeys);
-    const prevKeySet = new Set(Object.keys(prev));
-    for (const k of currKeys) {
-      if (!prevKeySet.has(k)) {
-        import_reactivity.pauseTracking();
-        const cloned = deepClone(vueState[k]);
-        import_reactivity.resetTracking();
-        pathStack.push(k);
-        emit({ action: "set", path: pathStack.slice(), newValue: cloned });
-        pathStack.pop();
-        prev[k] = cloned;
-        createKeyEffect(k);
-      }
-    }
-    for (const k of prevKeySet) {
-      if (!currKeySet.has(k)) {
-        pathStack.push(k);
-        emit({ action: "delete", path: pathStack.slice(), oldValue: prev[k] });
-        pathStack.pop();
-        delete prev[k];
-        keyStops.get(k)?.();
-        keyStops.delete(k);
-      }
-    }
-  }, { flush: "sync" });
-  return () => {
-    stopRoot();
+  function createRootEffect() {
+    rootStop = import_vue.watchEffect(() => {
+      const currKeys = Object.keys(vueState);
+      const currKeySet = new Set(currKeys);
+      const prevKeySet = new Set(Object.keys(prev));
+      for (const k of currKeys) {
+        if (!prevKeySet.has(k)) {
+          import_reactivity.pauseTracking();
+          const cloned = deepClone(vueState[k]);
+          import_reactivity.resetTracking();
+          pathStack.push(k);
+          emit({ action: "set", path: pathStack.slice(), newValue: cloned });
+          pathStack.pop();
+          prev[k] = cloned;
+          createKeyEffect(k);
+        }
+      }
+      for (const k of prevKeySet) {
+        if (!currKeySet.has(k)) {
+          pathStack.push(k);
+          emit({ action: "delete", path: pathStack.slice(), oldValue: prev[k] });
+          pathStack.pop();
+          delete prev[k];
+          keyStops.get(k)?.();
+          keyStops.delete(k);
+        }
+      }
+    }, { flush: "sync" });
+  }
+  function stopAll() {
+    rootStop?.();
+    rootStop = null;
     for (const stop of keyStops.values())
       stop();
     keyStops.clear();
+  }
+  function startAll() {
+    for (const k of Object.keys(prev)) {
+      createKeyEffect(k);
+    }
+    createRootEffect();
+  }
+  startAll();
+  return {
+    stop: stopAll,
+    pause: stopAll,
+    resume() {
+      const currentKeys = new Set(Object.keys(vueState));
+      for (const k of Object.keys(prev)) {
+        if (!currentKeys.has(k))
+          delete prev[k];
+      }
+      for (const k of currentKeys) {
+        prev[k] = deepClone(vueState[k]);
+      }
+      startAll();
+    }
   };
 }
 function typeTag(v) {

package/dist/index.js

@@ -3979,6 +3979,7 @@ function trackVueReactiveEvents(vueState, emit, options = {}) {
   const prev = {};
   const pathStack = [];
   const keyStops = new Map;
+  let rootStop = null;
   for (const k of Object.keys(vueState)) {
     prev[k] = deepClone(vueState[k]);
   }
@@ -4006,41 +4007,63 @@ function trackVueReactiveEvents(vueState, emit, options = {}) {
     }, { flush: "sync" });
     keyStops.set(k, stop);
   }
-  for (const k of Object.keys(prev)) {
-    createKeyEffect(k);
-  }
-  const stopRoot = watchEffect2(() => {
-    const currKeys = Object.keys(vueState);
-    const currKeySet = new Set(currKeys);
-    const prevKeySet = new Set(Object.keys(prev));
-    for (const k of currKeys) {
-      if (!prevKeySet.has(k)) {
-        import_reactivity.pauseTracking();
-        const cloned = deepClone(vueState[k]);
-        import_reactivity.resetTracking();
-        pathStack.push(k);
-        emit({ action: "set", path: pathStack.slice(), newValue: cloned });
-        pathStack.pop();
-        prev[k] = cloned;
-        createKeyEffect(k);
-      }
-    }
-    for (const k of prevKeySet) {
-      if (!currKeySet.has(k)) {
-        pathStack.push(k);
-        emit({ action: "delete", path: pathStack.slice(), oldValue: prev[k] });
-        pathStack.pop();
-        delete prev[k];
-        keyStops.get(k)?.();
-        keyStops.delete(k);
-      }
-    }
-  }, { flush: "sync" });
-  return () => {
-    stopRoot();
+  function createRootEffect() {
+    rootStop = watchEffect2(() => {
+      const currKeys = Object.keys(vueState);
+      const currKeySet = new Set(currKeys);
+      const prevKeySet = new Set(Object.keys(prev));
+      for (const k of currKeys) {
+        if (!prevKeySet.has(k)) {
+          import_reactivity.pauseTracking();
+          const cloned = deepClone(vueState[k]);
+          import_reactivity.resetTracking();
+          pathStack.push(k);
+          emit({ action: "set", path: pathStack.slice(), newValue: cloned });
+          pathStack.pop();
+          prev[k] = cloned;
+          createKeyEffect(k);
+        }
+      }
+      for (const k of prevKeySet) {
+        if (!currKeySet.has(k)) {
+          pathStack.push(k);
+          emit({ action: "delete", path: pathStack.slice(), oldValue: prev[k] });
+          pathStack.pop();
+          delete prev[k];
+          keyStops.get(k)?.();
+          keyStops.delete(k);
+        }
+      }
+    }, { flush: "sync" });
+  }
+  function stopAll() {
+    rootStop?.();
+    rootStop = null;
     for (const stop of keyStops.values())
       stop();
     keyStops.clear();
+  }
+  function startAll() {
+    for (const k of Object.keys(prev)) {
+      createKeyEffect(k);
+    }
+    createRootEffect();
+  }
+  startAll();
+  return {
+    stop: stopAll,
+    pause: stopAll,
+    resume() {
+      const currentKeys = new Set(Object.keys(vueState));
+      for (const k of Object.keys(prev)) {
+        if (!currentKeys.has(k))
+          delete prev[k];
+      }
+      for (const k of currentKeys) {
+        prev[k] = deepClone(vueState[k]);
+      }
+      startAll();
+    }
   };
 }
 function typeTag(v) {

package/dist/integrations/vue3.d.ts

@@ -8,6 +8,14 @@ export type TrackVueReactiveEventsOptions = {
     emitInitialReplace?: boolean;
     onDiffError?: (ctx: DiffErrorContext) => void;
 };
+export type VueTrackingControl = {
+    /** Stop all effects permanently. */
+    stop: () => void;
+    /** Stop all effects temporarily. No diffing overhead while paused. */
+    pause: () => void;
+    /** Rebuild snapshots from current state and re-create effects. */
+    resume: () => void;
+};
 /**
  * Observe a Vue 3 reactive object and emit RPS-compatible StateEvents
  * for each mutation performed through Vue reactivity.
@@ -16,6 +24,7 @@ export type TrackVueReactiveEventsOptions = {
  * only the affected subtree is diffed on mutation. A root structural effect
  * tracks Object.keys() for key add/delete at the top level.
  *
- * Returns a stop() function to tear down all effects.
+ * Returns a control object with stop/pause/resume. Use pause/resume to
+ * suppress diffing while applying external mutations (e.g. server events).
  */
-export declare function trackVueReactiveEvents<T extends object>(vueState: T, emit: (event: StateEvent) => void, options?: TrackVueReactiveEventsOptions): () => void;
+export declare function trackVueReactiveEvents<T extends object>(vueState: T, emit: (event: StateEvent) => void, options?: TrackVueReactiveEventsOptions): VueTrackingControl;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yiin/reactive-proxy-state",
-  "version": "1.0.36",
+  "version": "1.0.37",
   "author": "Yiin <stanislovas@yiin.lt>",
   "repository": {
     "type": "git",