@yiin/reactive-proxy-state 1.0.36 → 1.0.38

package/dist/index.cjs

@@ -2340,6 +2340,7 @@ __export(exports_src, {
   toRaw: () => toRaw,
   setActiveEffect: () => setActiveEffect,
   runCleanupFunctions: () => runCleanupFunctions,
+  resetProxyStats: () => resetProxyStats,
   ref: () => ref,
   reactive: () => reactive,
   markRaw: () => markRaw,
@@ -2347,6 +2348,7 @@ __export(exports_src, {
   isRef: () => isRef,
   isReactive: () => isReactive,
   isComputed: () => isComputed,
+  getProxyStats: () => getProxyStats,
   deepToRaw: () => deepToRaw,
   deepEqual: () => deepEqual,
   deepClone: () => deepClone,
@@ -2368,6 +2370,25 @@ var pathConcatCache = new Map;
 var MAX_PATH_CACHE_SIZE = 1000;
 var globalSeen = new WeakMap;
 var wrapperCache = new WeakMap;
+var proxyStats = {
+  created: 0,
+  arrays: 0,
+  maps: 0,
+  sets: 0,
+  objects: 0,
+  staleEvicted: 0
+};
+function getProxyStats() {
+  return { ...proxyStats, pathConcatCacheSize: pathConcatCache.size };
+}
+function resetProxyStats() {
+  proxyStats.created = 0;
+  proxyStats.arrays = 0;
+  proxyStats.maps = 0;
+  proxyStats.sets = 0;
+  proxyStats.objects = 0;
+  proxyStats.staleEvicted = 0;
+}
 function cleanupPathCache(root) {
   const cache = pathCache.get(root);
   if (cache && pathCacheSize.get(root) > MAX_CACHE_SIZE) {
@@ -3154,6 +3175,8 @@ function wrapSet(set, emit, path = []) {
   });
   globalSeen.set(set, proxy);
   wrapperCache.set(set, proxy);
+  proxyStats.created++;
+  proxyStats.sets++;
   return proxy;
 }
 
@@ -3395,6 +3418,8 @@ function wrapMap(map, emit, path = []) {
   });
   globalSeen.set(map, proxy);
   wrapperCache.set(map, proxy);
+  proxyStats.created++;
+  proxyStats.maps++;
   return proxy;
 }
 
@@ -3692,6 +3717,8 @@ function wrapArray(arr, emit, path = []) {
   });
   globalSeen.set(arr, proxy);
   wrapperCache.set(arr, proxy);
+  proxyStats.created++;
+  proxyStats.arrays++;
   return proxy;
 }
 
@@ -3813,6 +3840,11 @@ function reactive(obj, emit, path = [], options) {
         };
         emit?.(event);
         trigger(target, prop);
+        if (isObject3(oldValue) && oldValue !== value) {
+          globalSeen.delete(oldValue);
+          wrapperCache.delete(oldValue);
+          proxyStats.staleEvicted++;
+        }
       }
       return result;
     },
@@ -3835,11 +3867,18 @@ function reactive(obj, emit, path = [], options) {
         };
         emit?.(event);
         trigger(target, prop);
+        if (isObject3(oldValue)) {
+          globalSeen.delete(oldValue);
+          wrapperCache.delete(oldValue);
+          proxyStats.staleEvicted++;
+        }
       }
       return result;
     }
   });
   globalSeen.set(obj, proxy);
+  proxyStats.created++;
+  proxyStats.objects++;
   return proxy;
 }
 // src/ref.ts
@@ -4039,6 +4078,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 +4106,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.d.ts

@@ -1,5 +1,5 @@
 export * from './types';
-export { deepClone, deepEqual } from './utils';
+export { deepClone, deepEqual, getProxyStats, resetProxyStats } from './utils';
 export * from './state';
 export * from './reactive';
 export * from './watch';

package/dist/index.js

@@ -2308,6 +2308,25 @@ var pathConcatCache = new Map;
 var MAX_PATH_CACHE_SIZE = 1000;
 var globalSeen = new WeakMap;
 var wrapperCache = new WeakMap;
+var proxyStats = {
+  created: 0,
+  arrays: 0,
+  maps: 0,
+  sets: 0,
+  objects: 0,
+  staleEvicted: 0
+};
+function getProxyStats() {
+  return { ...proxyStats, pathConcatCacheSize: pathConcatCache.size };
+}
+function resetProxyStats() {
+  proxyStats.created = 0;
+  proxyStats.arrays = 0;
+  proxyStats.maps = 0;
+  proxyStats.sets = 0;
+  proxyStats.objects = 0;
+  proxyStats.staleEvicted = 0;
+}
 function cleanupPathCache(root) {
   const cache = pathCache.get(root);
   if (cache && pathCacheSize.get(root) > MAX_CACHE_SIZE) {
@@ -3094,6 +3113,8 @@ function wrapSet(set, emit, path = []) {
   });
   globalSeen.set(set, proxy);
   wrapperCache.set(set, proxy);
+  proxyStats.created++;
+  proxyStats.sets++;
   return proxy;
 }
 
@@ -3335,6 +3356,8 @@ function wrapMap(map, emit, path = []) {
   });
   globalSeen.set(map, proxy);
   wrapperCache.set(map, proxy);
+  proxyStats.created++;
+  proxyStats.maps++;
   return proxy;
 }
 
@@ -3632,6 +3655,8 @@ function wrapArray(arr, emit, path = []) {
   });
   globalSeen.set(arr, proxy);
   wrapperCache.set(arr, proxy);
+  proxyStats.created++;
+  proxyStats.arrays++;
   return proxy;
 }
 
@@ -3753,6 +3778,11 @@ function reactive(obj, emit, path = [], options) {
         };
         emit?.(event);
         trigger(target, prop);
+        if (isObject3(oldValue) && oldValue !== value) {
+          globalSeen.delete(oldValue);
+          wrapperCache.delete(oldValue);
+          proxyStats.staleEvicted++;
+        }
       }
       return result;
     },
@@ -3775,11 +3805,18 @@ function reactive(obj, emit, path = [], options) {
         };
         emit?.(event);
         trigger(target, prop);
+        if (isObject3(oldValue)) {
+          globalSeen.delete(oldValue);
+          wrapperCache.delete(oldValue);
+          proxyStats.staleEvicted++;
+        }
       }
       return result;
     }
   });
   globalSeen.set(obj, proxy);
+  proxyStats.created++;
+  proxyStats.objects++;
   return proxy;
 }
 // src/ref.ts
@@ -3979,6 +4016,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 +4044,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) {
@@ -4390,6 +4450,7 @@ export {
   toRaw,
   setActiveEffect,
   runCleanupFunctions,
+  resetProxyStats,
   ref,
   reactive,
   markRaw,
@@ -4397,6 +4458,7 @@ export {
   isRef,
   isReactive,
   isComputed,
+  getProxyStats,
   deepToRaw,
   deepEqual,
   deepClone,

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/dist/utils.d.ts

@@ -2,6 +2,26 @@ export declare const pathCache: WeakMap<object, Map<string, any>>;
 export declare const pathConcatCache: Map<string, any[]>;
 export declare const globalSeen: WeakMap<any, any>;
 export declare const wrapperCache: WeakMap<object, object>;
+export declare const proxyStats: {
+    created: number;
+    arrays: number;
+    maps: number;
+    sets: number;
+    objects: number;
+    /** Number of old proxied values evicted when replaced via set trap */
+    staleEvicted: number;
+};
+export declare function getProxyStats(): {
+    pathConcatCacheSize: number;
+    created: number;
+    arrays: number;
+    maps: number;
+    sets: number;
+    objects: number;
+    /** Number of old proxied values evicted when replaced via set trap */
+    staleEvicted: number;
+};
+export declare function resetProxyStats(): void;
 export declare function deepEqual(a: any, b: any, seen?: WeakMap<any, any>): boolean;
 export declare function getFromPathCache(root: object, pathKey: string): any | undefined;
 export declare function setInPathCache(root: object, pathKey: string, value: any): void;

package/package.json

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