@lensmcp/valtio-instrumentation 1.16.31 → 1.17.0

package/lib/snapshot.d.ts

@@ -14,4 +14,6 @@ export declare function useTrackedSnapshot<T extends object>(target: T, opts: Us
  * `proxy()`; falls back to a single root subscription when nothing is read.
  */
 export declare function useSnapshot<T extends object>(target: T): T;
+/** Join a visited-property path, truncated to {@link SUB_PATH_DEPTH} segments (0 ⇒ no truncation). */
+export declare function truncatePath(parts: readonly (string | symbol)[]): string;
 //# sourceMappingURL=snapshot.d.ts.map

package/lib/snapshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/lib/snapshot.ts"],"names":[],"mappings":"AAoCA,MAAM,WAAW,kBAAkB;IACjC;0DACsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;2DACuD;IACvD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EACjD,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,kBAAkB,GACvB,CAAC,CAcH;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAgF1D"}
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/lib/snapshot.ts"],"names":[],"mappings":"AAoCA,MAAM,WAAW,kBAAkB;IACjC;0DACsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;2DACuD;IACvD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,EACjD,MAAM,EAAE,CAAC,EACT,IAAI,EAAE,kBAAkB,GACvB,CAAC,CAcH;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAgF1D;AA2BD,sGAAsG;AACtG,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,GAAG,MAAM,CAGxE"}

package/lib/snapshot.js

@@ -79,7 +79,7 @@ export function useSnapshot(target) {
     // Runs after every commit — `affected` now reflects this render's reads.
     useEffect(() => {
         const paths = affected
-            ? affectedToPathList(currSnapshot, affected, true).map((parts) => parts.map(String).join('.'))
+            ? affectedToPathList(currSnapshot, affected, true).map((parts) => truncatePath(parts))
             : [];
         const next = new Set(paths.length ? paths : ['']);
         reconcileSubscriptions(subscribedRef.current, next, storeId, componentInstanceId);
@@ -98,6 +98,35 @@ export function useSnapshot(target) {
         ? createProxy(currSnapshot, affected, proxyCache, targetCache)
         : currSnapshot;
 }
+/**
+ * Depth a tracked read path is reported at. `affectedToPathList` returns EVERY property visited, so a
+ * component that reads one large nested object through `useSnapshot` yields thousands of paths — and one
+ * event was published per path, per reconcile.
+ *
+ * Worked failure (foodguard, 2026-07-28): a run-timeline phase toggle re-rendered a list reading
+ * `runs[i].input` (a deep run payload). React rendered only **22** times, yet the bus took **26,216**
+ * `subscription-added/removed` events for a single store in 10s (peak 10,486/s, ~1,200 per render), and
+ * valtio events were **68%** of the whole event log — the mechanism behind the 60-84 MB `events.jsonl`
+ * files and an earlier OOM flood. It read as an app render storm and was not: the storm was the
+ * instrumentation.
+ *
+ * Truncating to the first N segments fixes it at the source instead of capping the emission: the `Set`
+ * then DEDUPES thousands of deep paths down to a handful, so the reducer's `storeId::path → subscribers`
+ * view stays complete and correct — just aggregated at a granularity a human can use
+ * (`entries.["runs","all"].data` rather than `…data.3.input.steps.7.config.foo`, which no one needs a
+ * subscriber list for). It also makes the set STABLE across renders, so churn stops generating
+ * remove+add pairs. Override with `LENSMCP_VALTIO_PATH_DEPTH`; `0` restores full untruncated paths.
+ */
+const SUB_PATH_DEPTH = (() => {
+    const raw = typeof process !== 'undefined' ? process.env?.['LENSMCP_VALTIO_PATH_DEPTH'] : undefined;
+    const n = Number(raw);
+    return Number.isFinite(n) && n >= 0 && n <= 20 ? Math.floor(n) : 3;
+})();
+/** Join a visited-property path, truncated to {@link SUB_PATH_DEPTH} segments (0 ⇒ no truncation). */
+export function truncatePath(parts) {
+    const segs = parts.map(String);
+    return (SUB_PATH_DEPTH > 0 ? segs.slice(0, SUB_PATH_DEPTH) : segs).join('.');
+}
 /** Add/remove subscriptions so the registry matches `next` exactly. */
 function reconcileSubscriptions(prev, next, storeId, componentInstanceId) {
     for (const path of next) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lensmcp/valtio-instrumentation",
-  "version": "1.16.31",
+  "version": "1.17.0",
   "type": "module",
   "main": "./index.js",
   "module": "./index.js",
@@ -14,7 +14,7 @@
     }
   },
   "dependencies": {
-    "@lensmcp/react-instrumentation": "1.16.31",
+    "@lensmcp/react-instrumentation": "1.17.0",
     "proxy-compare": "^3.0.0",
     "tslib": "^2.3.0"
   },