@lensmcp/valtio-instrumentation 1.18.4 → 1.18.6

package/index.js

@@ -1,10 +1 @@
-// Drop-in for `valtio`: re-exports the full main-entry surface so the
-// Vite plugin can alias `valtio → @lensmcp/valtio-instrumentation` in dev
-// with no caller changes. `proxy` + `useSnapshot` are the instrumented
-// versions; the rest pass through from the real valtio (imported via the
-// `valtio/vanilla` subpath so this module never aliases itself).
-export { ref, snapshot, subscribe, getVersion, unstable_enableOp, unstable_getInternalStates, unstable_replaceInternalFunction, } from 'valtio/vanilla';
-export { proxy } from './lib/proxy.js';
-export { useSnapshot, useTrackedSnapshot } from './lib/snapshot.js';
-// LensMCP-specific extras (not part of the valtio surface).
-export { registerStore, tagProxy, storeIdOf, addSubscription, removeSubscription, subscribersFor, subscribersForPathAndParents, resetRegistry, } from './lib/store-registry.js';
+"use strict";export{ref,snapshot,subscribe,getVersion,unstable_enableOp,unstable_getInternalStates,unstable_replaceInternalFunction}from"valtio/vanilla";export{proxy}from"./lib/proxy.js";export{useSnapshot,useTrackedSnapshot}from"./lib/snapshot.js";export{registerStore,tagProxy,storeIdOf,addSubscription,removeSubscription,subscribersFor,subscribersForPathAndParents,resetRegistry}from"./lib/store-registry.js";

package/lib/proxy.js

@@ -1,94 +1 @@
-/**
- * `proxy(initial, opts)` — wraps the actual Valtio proxy and emits
- * `store-created` + per-mutation `state-update` events.
- *
- * Valtio is a peer dependency; we import it statically so bundlers
- * resolve it the same way as user code.
- */
-// Import the REAL valtio via the `valtio/vanilla` subpath — never bare
-// `valtio` — so the dev-time `valtio → @lensmcp/valtio-instrumentation`
-// alias (Phase 8) doesn't make this module import itself.
-// `unstable_enableOp` turns on path-aware ops; without it `subscribe()`
-// callbacks receive empty op arrays.
-import { proxy as valtioProxy, subscribe as valtioSubscribe, unstable_enableOp, } from 'valtio/vanilla';
-import { publish, depsHash } from '@lensmcp/react-instrumentation';
-import { registerStore, subscribersForPathAndParents, tagProxy, } from './store-registry.js';
-let opsEnabled = false;
-function ensureOpsEnabled() {
-    if (opsEnabled)
-        return;
-    try {
-        unstable_enableOp(true);
-        opsEnabled = true;
-    }
-    catch {
-        /* older valtio without the flag — fall through, paths just won't populate */
-    }
-}
-let storeCounter = 0;
-/**
- * Create a tracked Valtio proxy.
- */
-export function proxy(initial, opts = {}) {
-    ensureOpsEnabled();
-    const storeId = opts.storeId ?? `valtio:store:${++storeCounter}`;
-    registerStore(storeId, opts.source);
-    const proxied = valtioProxy(initial);
-    // Remember which store this proxy is, so the drop-in `useSnapshot(store)`
-    // can recover the id with no extra args.
-    tagProxy(proxied, storeId);
-    publish({
-        source: 'valtio',
-        category: 'state',
-        severity: 'info',
-        title: `store-created ${storeId}`,
-        fingerprint: `valtio-store:${storeId}`,
-        raw: {
-            kind: 'store-created',
-            store: {
-                storeId,
-                source: opts.source,
-                initialPreview: opts.emitInitialPreview === false ? undefined : safePreview(initial),
-            },
-        },
-    });
-    // Subscribe at the root to all changes; Valtio's ops carry the path
-    // tuple so we can emit one `state-update` per touched leaf.
-    valtioSubscribe(proxied, (ops) => {
-        for (const op of ops) {
-            const [, pathParts, value, prevValue] = op;
-            const path = (pathParts ?? []).map(String).join('.');
-            if (!path)
-                continue;
-            const changedKeys = (pathParts ?? []).map(String);
-            publish({
-                source: 'valtio',
-                category: 'state',
-                severity: 'info',
-                title: `state-update ${storeId}.${path}`,
-                fingerprint: `valtio-update:${storeId}:${path}`,
-                raw: {
-                    kind: 'state-update',
-                    update: {
-                        storeId,
-                        path,
-                        changedKeys,
-                        beforeHash: depsHash([prevValue]),
-                        afterHash: depsHash([value]),
-                        preview: safePreview(value),
-                        subscribers: subscribersForPathAndParents(storeId, path),
-                    },
-                },
-            });
-        }
-    }, true);
-    return proxied;
-}
-function safePreview(v) {
-    try {
-        return JSON.parse(JSON.stringify(v));
-    }
-    catch {
-        return undefined;
-    }
-}
+"use strict";var m=Object.defineProperty;var a=(t,r)=>m(t,"name",{value:r,configurable:!0});var h=Object.defineProperty,i=a((t,r)=>h(t,"name",{value:r,configurable:!0}),"s");import{proxy as P,subscribe as $,unstable_enableOp as w}from"valtio/vanilla";import{publish as p,depsHash as f}from"@lensmcp/react-instrumentation";import{registerStore as x,subscribersForPathAndParents as S,tagProxy as O}from"./store-registry.js";let d=!1;function l(){if(!d)try{w(!0),d=!0}catch{}}a(l,"x"),i(l,"ensureOpsEnabled");let I=0;export function proxy(t,r={}){l();const e=r.storeId??`valtio:store:${++I}`;x(e,r.source);const o=P(t);return O(o,e),p({source:"valtio",category:"state",severity:"info",title:`store-created ${e}`,fingerprint:`valtio-store:${e}`,raw:{kind:"store-created",store:{storeId:e,source:r.source,initialPreview:r.emitInitialPreview===!1?void 0:n(t)}}}),$(o,v=>{for(const b of v){const[,c,u,y]=b,s=(c??[]).map(String).join(".");if(!s)continue;const g=(c??[]).map(String);p({source:"valtio",category:"state",severity:"info",title:`state-update ${e}.${s}`,fingerprint:`valtio-update:${e}:${s}`,raw:{kind:"state-update",update:{storeId:e,path:s,changedKeys:g,beforeHash:f([y]),afterHash:f([u]),preview:n(u),subscribers:S(e,s)}}})}},!0),o}a(proxy,"proxy"),i(proxy,"proxy");function n(t){try{return JSON.parse(JSON.stringify(t))}catch{return}}a(n,"f"),i(n,"safePreview");

package/lib/snapshot.js

@@ -1,165 +1 @@
-/**
- * `useSnapshot` — the drop-in replacement for valtio's `useSnapshot`, with
- * **per-path subscription inference**.
- *
- * valtio's own re-render optimisation is a `proxy-compare` "affected"
- * WeakMap recording which snapshot paths a component reads. We inline
- * valtio v2's `useSnapshot` here so we *own* that `affected` map, then read
- * it back with `affectedToPathList` after commit to learn exactly which
- * (`storeId`, `path`) pairs the component depends on — and register one
- * subscription per path instead of a single store-root subscription.
- *
- * `useTrackedSnapshot(target, { storeId, path })` stays available for
- * callers that want to declare a path explicitly.
- */
-import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useSyncExternalStore, } from 'react';
-// Real valtio via the `valtio/vanilla` subpath (never bare `valtio`), so the
-// dev-time alias doesn't make this module import itself.
-import { snapshot as valtioSnapshot, subscribe as valtioSubscribe, } from 'valtio/vanilla';
-import { useSnapshot as valtioUseSnapshot } from 'valtio/react';
-import { affectedToPathList, createProxy, isChanged } from 'proxy-compare';
-import { useLensmcpContext, publish } from '@lensmcp/react-instrumentation';
-import { addSubscription, removeSubscription, storeIdOf } from './store-registry.js';
-// Shared across components for proxy reuse, exactly as valtio does.
-const targetCache = new WeakMap();
-export function useTrackedSnapshot(target, opts) {
-    const ctx = useLensmcpContext();
-    const path = opts.path ?? '';
-    const componentInstanceId = ctx.componentInstanceId ?? `react:component:anonymous`;
-    useEffect(() => {
-        emitSubscription('added', opts.storeId, path, componentInstanceId);
-        return () => {
-            emitSubscription('removed', opts.storeId, path, componentInstanceId);
-        };
-    }, [opts.storeId, path, componentInstanceId]);
-    return valtioUseSnapshot(target);
-}
-/**
- * Drop-in `useSnapshot(store)` matching valtio's signature exactly. Infers
- * the read paths from `proxy-compare`'s affected map and registers one
- * subscription per path. Recovers the storeId tagged by the instrumented
- * `proxy()`; falls back to a single root subscription when nothing is read.
- */
-export function useSnapshot(target) {
-    const storeId = storeIdOf(target) ?? 'valtio:store:anonymous';
-    const ctx = useLensmcpContext();
-    const componentInstanceId = ctx.componentInstanceId ?? 'react:component:anonymous';
-    // ---- valtio v2's useSnapshot, inlined so we own `affected` ----
-    const affected = useMemo(() => target && new WeakMap(), [target]);
-    const lastSnapshot = useRef(undefined);
-    let inRender = true;
-    const currSnapshot = useSyncExternalStore(useCallback((callback) => {
-        const unsub = valtioSubscribe(target, callback, false);
-        callback();
-        return unsub;
-    }, [target]), () => {
-        const next = valtioSnapshot(target);
-        try {
-            if (!inRender &&
-                lastSnapshot.current &&
-                affected &&
-                !isChanged(lastSnapshot.current, next, affected, new WeakMap())) {
-                return lastSnapshot.current;
-            }
-        }
-        catch {
-            /* fall through to the fresh snapshot */
-        }
-        return next;
-    }, () => valtioSnapshot(target));
-    inRender = false;
-    useLayoutEffect(() => {
-        lastSnapshot.current = currSnapshot;
-    });
-    const proxyCache = useMemo(() => new WeakMap(), []);
-    // ---- LensMCP: reconcile per-path subscriptions to the read set ----
-    const subscribedRef = useRef(undefined);
-    if (!subscribedRef.current)
-        subscribedRef.current = new Set();
-    // Runs after every commit — `affected` now reflects this render's reads.
-    useEffect(() => {
-        const paths = affected
-            ? affectedToPathList(currSnapshot, affected, true).map((parts) => truncatePath(parts))
-            : [];
-        const next = new Set(paths.length ? paths : ['']);
-        reconcileSubscriptions(subscribedRef.current, next, storeId, componentInstanceId);
-    });
-    // Drop all subscriptions on unmount.
-    useEffect(() => {
-        const subscribed = subscribedRef.current;
-        return () => {
-            for (const path of [...subscribed]) {
-                emitSubscription('removed', storeId, path, componentInstanceId);
-            }
-            subscribed.clear();
-        };
-    }, [storeId, componentInstanceId]);
-    return affected
-        ? 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) {
-        if (!prev.has(path)) {
-            emitSubscription('added', storeId, path, componentInstanceId);
-        }
-    }
-    for (const path of [...prev]) {
-        if (!next.has(path)) {
-            emitSubscription('removed', storeId, path, componentInstanceId);
-        }
-    }
-    prev.clear();
-    for (const path of next)
-        prev.add(path);
-}
-function emitSubscription(kind, storeId, path, componentInstanceId) {
-    if (kind === 'added') {
-        addSubscription({ storeId, path, componentInstanceId });
-    }
-    else {
-        removeSubscription({ storeId, path, componentInstanceId });
-    }
-    const verb = kind === 'added' ? 'sub' : 'unsub';
-    publish({
-        source: 'valtio',
-        category: 'state',
-        severity: 'debug',
-        title: `subscription-${kind} ${storeId}.${path}`,
-        fingerprint: `valtio-${verb}:${storeId}:${path}:${componentInstanceId}`,
-        raw: {
-            kind: `subscription-${kind}`,
-            subscription: { storeId, path, componentInstanceId },
-        },
-    });
-}
+"use strict";var P=Object.defineProperty;var a=(n,e)=>P(n,"name",{value:e,configurable:!0});var $=Object.defineProperty,i=a((n,e)=>$(n,"name",{value:e,configurable:!0}),"c");import{useCallback as w,useEffect as m,useLayoutEffect as M,useMemo as h,useRef as b,useSyncExternalStore as g}from"react";import{snapshot as l,subscribe as T}from"valtio/vanilla";import{useSnapshot as x}from"valtio/react";import{affectedToPathList as E,createProxy as L,isChanged as C}from"proxy-compare";import{useLensmcpContext as I,publish as W}from"@lensmcp/react-instrumentation";import{addSubscription as N,removeSubscription as _,storeIdOf as A}from"./store-registry.js";const H=new WeakMap;export function useTrackedSnapshot(n,e){const s=I(),t=e.path??"",o=s.componentInstanceId??"react:component:anonymous";return m(()=>(c("added",e.storeId,t,o),()=>{c("removed",e.storeId,t,o)}),[e.storeId,t,o]),x(n)}a(useTrackedSnapshot,"useTrackedSnapshot"),i(useTrackedSnapshot,"useTrackedSnapshot");export function useSnapshot(n){const e=A(n)??"valtio:store:anonymous",s=I().componentInstanceId??"react:component:anonymous",t=h(()=>n&&new WeakMap,[n]),o=b(void 0);let f=!0;const p=g(w(r=>{const u=T(n,r,!1);return r(),u},[n]),()=>{const r=l(n);try{if(!f&&o.current&&t&&!C(o.current,r,t,new WeakMap))return o.current}catch{}return r},()=>l(n));f=!1,M(()=>{o.current=p});const y=h(()=>new WeakMap,[]),d=b(void 0);return d.current||(d.current=new Set),m(()=>{const r=t?E(p,t,!0).map(k=>truncatePath(k)):[],u=new Set(r.length?r:[""]);S(d.current,u,e,s)}),m(()=>{const r=d.current;return()=>{for(const u of[...r])c("removed",e,u,s);r.clear()}},[e,s]),t?L(p,t,y,H):p}a(useSnapshot,"useSnapshot"),i(useSnapshot,"useSnapshot");const v=(()=>{const n=typeof process<"u"?process.env?.LENSMCP_VALTIO_PATH_DEPTH:void 0,e=Number(n);return Number.isFinite(e)&&e>=0&&e<=20?Math.floor(e):3})();export function truncatePath(n){const e=n.map(String);return(v>0?e.slice(0,v):e).join(".")}a(truncatePath,"truncatePath"),i(truncatePath,"truncatePath");function S(n,e,s,t){for(const o of e)n.has(o)||c("added",s,o,t);for(const o of[...n])e.has(o)||c("removed",s,o,t);n.clear();for(const o of e)n.add(o)}a(S,"R"),i(S,"reconcileSubscriptions");function c(n,e,s,t){n==="added"?N({storeId:e,path:s,componentInstanceId:t}):_({storeId:e,path:s,componentInstanceId:t});const o=n==="added"?"sub":"unsub";W({source:"valtio",category:"state",severity:"debug",title:`subscription-${n} ${e}.${s}`,fingerprint:`valtio-${o}:${e}:${s}:${t}`,raw:{kind:`subscription-${n}`,subscription:{storeId:e,path:s,componentInstanceId:t}}})}a(c,"a"),i(c,"emitSubscription");

package/lib/store-registry.js

@@ -1,58 +1 @@
-const subs = new Map(); // key: `${storeId}::${path}` → set of componentInstanceIds
-const stores = new Map();
-// proxy object → its storeId, so the drop-in `useSnapshot(store)` can
-// recover the store id without the caller passing it.
-const proxyStoreIds = new WeakMap();
-export function registerStore(storeId, source) {
-    stores.set(storeId, { storeId, source });
-}
-export function tagProxy(proxyObject, storeId) {
-    proxyStoreIds.set(proxyObject, storeId);
-}
-export function storeIdOf(proxyObject) {
-    return proxyStoreIds.get(proxyObject);
-}
-export function isStoreRegistered(storeId) {
-    return stores.has(storeId);
-}
-export function addSubscription(entry) {
-    const key = `${entry.storeId}::${entry.path}`;
-    let set = subs.get(key);
-    if (!set) {
-        set = new Set();
-        subs.set(key, set);
-    }
-    set.add(entry.componentInstanceId);
-}
-export function removeSubscription(entry) {
-    const key = `${entry.storeId}::${entry.path}`;
-    const set = subs.get(key);
-    if (set) {
-        set.delete(entry.componentInstanceId);
-        if (set.size === 0)
-            subs.delete(key);
-    }
-}
-export function subscribersFor(storeId, path) {
-    return [...(subs.get(`${storeId}::${path}`) ?? [])];
-}
-/** Walk every prefix of `path` and union the subscribers. Used when a
- *  state-update lands on a nested path but parent-path snapshot users
- *  also need to be notified. */
-export function subscribersForPathAndParents(storeId, path) {
-    const out = new Set();
-    const parts = path.split('.');
-    for (let i = parts.length; i > 0; i--) {
-        const candidate = parts.slice(0, i).join('.');
-        for (const id of subscribersFor(storeId, candidate))
-            out.add(id);
-    }
-    // root subscribers
-    for (const id of subscribersFor(storeId, ''))
-        out.add(id);
-    return [...out];
-}
-export function resetRegistry() {
-    subs.clear();
-    stores.clear();
-}
+"use strict";var f=Object.defineProperty;var o=(e,t)=>f(e,"name",{value:t,configurable:!0});var b=Object.defineProperty,n=o((e,t)=>b(e,"name",{value:t,configurable:!0}),"n");const s=new Map,c=new Map,u=new WeakMap;export function registerStore(e,t){c.set(e,{storeId:e,source:t})}o(registerStore,"registerStore"),n(registerStore,"registerStore");export function tagProxy(e,t){u.set(e,t)}o(tagProxy,"tagProxy"),n(tagProxy,"tagProxy");export function storeIdOf(e){return u.get(e)}o(storeIdOf,"storeIdOf"),n(storeIdOf,"storeIdOf");export function isStoreRegistered(e){return c.has(e)}o(isStoreRegistered,"isStoreRegistered"),n(isStoreRegistered,"isStoreRegistered");export function addSubscription(e){const t=`${e.storeId}::${e.path}`;let r=s.get(t);r||(r=new Set,s.set(t,r)),r.add(e.componentInstanceId)}o(addSubscription,"addSubscription"),n(addSubscription,"addSubscription");export function removeSubscription(e){const t=`${e.storeId}::${e.path}`,r=s.get(t);r&&(r.delete(e.componentInstanceId),r.size===0&&s.delete(t))}o(removeSubscription,"removeSubscription"),n(removeSubscription,"removeSubscription");export function subscribersFor(e,t){return[...s.get(`${e}::${t}`)??[]]}o(subscribersFor,"subscribersFor"),n(subscribersFor,"subscribersFor");export function subscribersForPathAndParents(e,t){const r=new Set,a=t.split(".");for(let i=a.length;i>0;i--){const d=a.slice(0,i).join(".");for(const p of subscribersFor(e,d))r.add(p)}for(const i of subscribersFor(e,""))r.add(i);return[...r]}o(subscribersForPathAndParents,"subscribersForPathAndParents"),n(subscribersForPathAndParents,"subscribersForPathAndParents");export function resetRegistry(){s.clear(),c.clear()}o(resetRegistry,"resetRegistry"),n(resetRegistry,"resetRegistry");

package/lib/types.js

@@ -1 +1 @@
-export {};
+"use strict";export{};

package/package.json

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