@logixjs/devtools-react 0.0.2 → 1.0.0

package/dist/DevtoolsLayer.cjs

@@ -50,7 +50,10 @@ module.exports = __toCommonJS(DevtoolsLayer_exports);
 // src/internal/snapshot/index.ts
 var Logix = __toESM(require("@logixjs/core"), 1);
 var import_effect = require("effect");
-var clearDevtoolsEvents = Logix.Debug.clearDevtoolsEvents;
+var clearDevtoolsEvents = () => {
+  Logix.Debug.clearDevtoolsEvents();
+  notify();
+};
 var setInstanceLabel = Logix.Debug.setInstanceLabel;
 var getInstanceLabel = Logix.Debug.getInstanceLabel;
 var snapshotOverride;
@@ -95,7 +98,9 @@ var normalizeDevtoolsSnapshot = (snapshot) => {
 };
 var listeners = /* @__PURE__ */ new Set();
 var unsubscribeCore;
+var snapshotPubSub = import_effect.Effect.runSync(import_effect.PubSub.unbounded());
 var notify = () => {
+  import_effect.PubSub.publishUnsafe(snapshotPubSub, getDevtoolsSnapshot());
   for (const listener of listeners) {
     listener();
   }
@@ -137,17 +142,13 @@ var subscribeDevtoolsSnapshot = (listener) => {
 };
 var subscribeDevtoolsSnapshotToken = subscribeDevtoolsSnapshot;
 var devtoolsLayer = Logix.Debug.devtoolsHubLayer();
-var DevtoolsSnapshotStore = class extends import_effect.Context.Tag("Logix/DevtoolsSnapshotStore")() {
+var DevtoolsSnapshotStore = class extends import_effect.ServiceMap.Service()(
+  "Logix/DevtoolsSnapshotStore"
+) {
 };
 var devtoolsSnapshotService = {
   get: import_effect.Effect.sync(() => getDevtoolsSnapshot()),
-  changes: import_effect.Stream.async((emit) => {
-    const listener = () => {
-      emit.single(getDevtoolsSnapshot());
-    };
-    const unsubscribe = subscribeDevtoolsSnapshot(listener);
-    return import_effect.Effect.sync(unsubscribe);
-  })
+  changes: import_effect.Stream.fromPubSub(snapshotPubSub)
 };
 var devtoolsSnapshotLayer = import_effect.Layer.succeed(
   DevtoolsSnapshotStore,

package/dist/DevtoolsLayer.d.cts

@@ -1,5 +1,5 @@
 import * as Logix from '@logixjs/core';
-import { Layer, Effect, Stream, Context } from 'effect';
+import { Layer, Effect, Stream, ServiceMap } from 'effect';
 
 /**
  * Notes:
@@ -40,7 +40,7 @@ interface DevtoolsSnapshotService {
     readonly get: Effect.Effect<DevtoolsSnapshot>;
     readonly changes: Stream.Stream<DevtoolsSnapshot>;
 }
-declare const DevtoolsSnapshotStore_base: Context.TagClass<DevtoolsSnapshotStore, "Logix/DevtoolsSnapshotStore", DevtoolsSnapshotService>;
+declare const DevtoolsSnapshotStore_base: ServiceMap.ServiceClass<DevtoolsSnapshotStore, "Logix/DevtoolsSnapshotStore", DevtoolsSnapshotService>;
 /**
  * DevtoolsSnapshotStore：
  * - Exposed as an Env Service for Devtools Runtime.

package/dist/DevtoolsLayer.d.ts

@@ -1,5 +1,5 @@
 import * as Logix from '@logixjs/core';
-import { Layer, Effect, Stream, Context } from 'effect';
+import { Layer, Effect, Stream, ServiceMap } from 'effect';
 
 /**
  * Notes:
@@ -40,7 +40,7 @@ interface DevtoolsSnapshotService {
     readonly get: Effect.Effect<DevtoolsSnapshot>;
     readonly changes: Stream.Stream<DevtoolsSnapshot>;
 }
-declare const DevtoolsSnapshotStore_base: Context.TagClass<DevtoolsSnapshotStore, "Logix/DevtoolsSnapshotStore", DevtoolsSnapshotService>;
+declare const DevtoolsSnapshotStore_base: ServiceMap.ServiceClass<DevtoolsSnapshotStore, "Logix/DevtoolsSnapshotStore", DevtoolsSnapshotService>;
 /**
  * DevtoolsSnapshotStore：
  * - Exposed as an Env Service for Devtools Runtime.

package/dist/DevtoolsLayer.js

@@ -14,7 +14,7 @@ import {
   setInstanceLabel,
   subscribeDevtoolsSnapshot,
   subscribeDevtoolsSnapshotToken
-} from "./chunk-FNWHBEXD.js";
+} from "./chunk-NH3EYAZ6.js";
 export {
   DevtoolsSnapshotStore,
   clearDevtoolsEvents,

package/dist/LogixDevtools.cjs

@@ -64,15 +64,19 @@ var Logix8 = __toESM(require("@logixjs/core"), 1);
 
 // src/internal/ui/hooks/DevtoolsHooks.tsx
 var import_react = __toESM(require("react"), 1);
-var import_effect5 = require("effect");
+var import_effect6 = require("effect");
 
 // src/internal/state/runtime.ts
 var Logix5 = __toESM(require("@logixjs/core"), 1);
+var import_effect5 = require("effect");
 
 // src/internal/snapshot/index.ts
 var Logix = __toESM(require("@logixjs/core"), 1);
 var import_effect = require("effect");
-var clearDevtoolsEvents = Logix.Debug.clearDevtoolsEvents;
+var clearDevtoolsEvents = () => {
+  Logix.Debug.clearDevtoolsEvents();
+  notify();
+};
 var setInstanceLabel = Logix.Debug.setInstanceLabel;
 var getInstanceLabel = Logix.Debug.getInstanceLabel;
 var snapshotOverride;
@@ -116,19 +120,13 @@ var normalizeDevtoolsSnapshot = (snapshot) => {
   return { ...snapshot, events };
 };
 var listeners = /* @__PURE__ */ new Set();
-var unsubscribeCore;
+var snapshotPubSub = import_effect.Effect.runSync(import_effect.PubSub.unbounded());
 var notify = () => {
+  import_effect.PubSub.publishUnsafe(snapshotPubSub, getDevtoolsSnapshot());
   for (const listener of listeners) {
     listener();
   }
 };
-var ensureCoreSubscribed = () => {
-  if (unsubscribeCore) return;
-  unsubscribeCore = Logix.Debug.subscribeDevtoolsSnapshot(() => {
-    if (snapshotOverride) return;
-    notify();
-  });
-};
 var hasDevtoolsSnapshotOverride = () => snapshotOverride != null;
 var getDevtoolsSnapshotOverrideInfo = () => snapshotOverrideInfo;
 var setDevtoolsSnapshotOverride = (snapshot, info) => {
@@ -145,29 +143,14 @@ var clearDevtoolsSnapshotOverride = () => {
   notify();
 };
 var getDevtoolsSnapshot = () => snapshotOverride ?? Logix.Debug.getDevtoolsSnapshot();
-var subscribeDevtoolsSnapshot = (listener) => {
-  listeners.add(listener);
-  ensureCoreSubscribed();
-  return () => {
-    listeners.delete(listener);
-    if (listeners.size === 0 && unsubscribeCore) {
-      unsubscribeCore();
-      unsubscribeCore = void 0;
-    }
-  };
-};
 var devtoolsLayer = Logix.Debug.devtoolsHubLayer();
-var DevtoolsSnapshotStore = class extends import_effect.Context.Tag("Logix/DevtoolsSnapshotStore")() {
+var DevtoolsSnapshotStore = class extends import_effect.ServiceMap.Service()(
+  "Logix/DevtoolsSnapshotStore"
+) {
 };
 var devtoolsSnapshotService = {
   get: import_effect.Effect.sync(() => getDevtoolsSnapshot()),
-  changes: import_effect.Stream.async((emit) => {
-    const listener = () => {
-      emit.single(getDevtoolsSnapshot());
-    };
-    const unsubscribe = subscribeDevtoolsSnapshot(listener);
-    return import_effect.Effect.sync(unsubscribe);
-  })
+  changes: import_effect.Stream.fromPubSub(snapshotPubSub)
 };
 var devtoolsSnapshotLayer = import_effect.Layer.succeed(
   DevtoolsSnapshotStore,
@@ -213,7 +196,7 @@ var OperationSummarySchema = import_effect2.Schema.Struct({
       top3: import_effect2.Schema.Array(
         import_effect2.Schema.Struct({
           stepId: import_effect2.Schema.String,
-          kind: import_effect2.Schema.Literal("computed", "link"),
+          kind: import_effect2.Schema.Literals(["computed", "link"]),
           fieldPath: import_effect2.Schema.String,
           durationMs: import_effect2.Schema.Number,
           changed: import_effect2.Schema.Boolean,
@@ -229,7 +212,7 @@ var TriggerLayoutSchema = import_effect2.Schema.Struct({
   isDragging: import_effect2.Schema.Boolean
 });
 var DevtoolsSettingsSchema = import_effect2.Schema.Struct({
-  mode: import_effect2.Schema.Literal("basic", "deep"),
+  mode: import_effect2.Schema.Literals(["basic", "deep"]),
   showTraitEvents: import_effect2.Schema.Boolean,
   showReactRenderEvents: import_effect2.Schema.Boolean,
   enableTimeTravelUI: import_effect2.Schema.Boolean,
@@ -270,7 +253,7 @@ var DevtoolsStateSchema = import_effect2.Schema.Struct({
       moduleId: import_effect2.Schema.String,
       instanceId: import_effect2.Schema.String,
       txnId: import_effect2.Schema.String,
-      mode: import_effect2.Schema.Literal("before", "after")
+      mode: import_effect2.Schema.Literals(["before", "after"])
     })
   ),
   runtimes: import_effect2.Schema.Array(
@@ -299,7 +282,7 @@ var DevtoolsStateSchema = import_effect2.Schema.Struct({
     isDragging: import_effect2.Schema.Boolean,
     trigger: import_effect2.Schema.optional(TriggerLayoutSchema)
   }),
-  theme: import_effect2.Schema.Literal("system", "light", "dark"),
+  theme: import_effect2.Schema.Literals(["system", "light", "dark"]),
   settings: DevtoolsSettingsSchema
 });
 var defaultSettings = {
@@ -369,13 +352,11 @@ var gateDirtyRootPathsByDigest = (meta) => {
   }
   const dirtySet = meta.dirtySet;
   if (!isRecord2(dirtySet)) return meta;
-  if (!Array.isArray(dirtySet.rootPaths)) return meta;
+  if (!Object.prototype.hasOwnProperty.call(dirtySet, "rootPaths")) return meta;
+  const { rootPaths: _rootPaths, ...dirtySetWithoutRootPaths } = dirtySet;
   return {
     ...meta,
-    dirtySet: {
-      ...dirtySet,
-      rootPaths: void 0
-    }
+    dirtySet: dirtySetWithoutRootPaths
   };
 };
 var getEventTimestamp = (event) => event.timestamp;
@@ -906,23 +887,21 @@ var persistSettingsToStorage = (settings) => {
 var Logix3 = __toESM(require("@logixjs/core"), 1);
 var import_effect3 = require("effect");
 var ResizePayload = import_effect3.Schema.Struct({
-  edge: import_effect3.Schema.Literal("top", "left", "right")
+  edge: import_effect3.Schema.Literals(["top", "left", "right"])
+});
+var UpdateLayoutPayload = import_effect3.Schema.Struct({
+  height: import_effect3.Schema.optional(import_effect3.Schema.Number),
+  marginLeft: import_effect3.Schema.optional(import_effect3.Schema.Number),
+  marginRight: import_effect3.Schema.optional(import_effect3.Schema.Number),
+  isDragging: import_effect3.Schema.optional(import_effect3.Schema.Boolean),
+  trigger: import_effect3.Schema.optional(
+    import_effect3.Schema.Struct({
+      x: import_effect3.Schema.Number,
+      y: import_effect3.Schema.Number,
+      isDragging: import_effect3.Schema.Boolean
+    })
+  )
 });
-var UpdateLayoutPayload = import_effect3.Schema.partial(
-  import_effect3.Schema.Struct({
-    height: import_effect3.Schema.Number,
-    marginLeft: import_effect3.Schema.Number,
-    marginRight: import_effect3.Schema.Number,
-    isDragging: import_effect3.Schema.Boolean,
-    trigger: import_effect3.Schema.optional(
-      import_effect3.Schema.Struct({
-        x: import_effect3.Schema.Number,
-        y: import_effect3.Schema.Number,
-        isDragging: import_effect3.Schema.Boolean
-      })
-    )
-  })
-);
 var DevtoolsModule = Logix3.Module.make("LogixDevtoolsModule", {
   state: DevtoolsStateSchema,
   actions: {
@@ -956,8 +935,8 @@ var DevtoolsModule = Logix3.Module.make("LogixDevtoolsModule", {
     clearImportedEvidence: import_effect3.Schema.Void,
     resizeStart: ResizePayload,
     updateLayout: UpdateLayoutPayload,
-    setTheme: import_effect3.Schema.Literal("system", "light", "dark"),
-    setMode: import_effect3.Schema.Literal("basic", "deep"),
+    setTheme: import_effect3.Schema.Literals(["system", "light", "dark"]),
+    setMode: import_effect3.Schema.Literals(["basic", "deep"]),
     updateSettings: import_effect3.Schema.Any
   },
   reducers: {
@@ -1192,15 +1171,165 @@ var normalizeRuntimeDebugEventRef = (value) => {
   }
   return { ...value, instanceId };
 };
-var fromDomEvent = (event) => import_effect4.Stream.async((emit) => {
-  const handler = (e) => emit.single(e);
-  window.addEventListener(event, handler);
-  return import_effect4.Effect.sync(() => window.removeEventListener(event, handler));
-});
+var readConvergeFieldPathsByDigest = (summary) => {
+  if (!isRecord3(summary)) return /* @__PURE__ */ new Map();
+  const converge = isRecord3(summary.converge) ? summary.converge : void 0;
+  const byDigest = converge && isRecord3(converge.staticIrByDigest) ? converge.staticIrByDigest : void 0;
+  if (!byDigest) return /* @__PURE__ */ new Map();
+  const out = /* @__PURE__ */ new Map();
+  for (const [digest, ir] of Object.entries(byDigest)) {
+    if (!isRecord3(ir)) continue;
+    const fieldPathsRaw = ir.fieldPaths;
+    if (!Array.isArray(fieldPathsRaw)) continue;
+    const fieldPaths = [];
+    for (const pathRaw of fieldPathsRaw) {
+      if (!Array.isArray(pathRaw) || pathRaw.length === 0) {
+        fieldPaths.length = 0;
+        break;
+      }
+      if (!pathRaw.every((seg) => typeof seg === "string" && seg.length > 0)) {
+        fieldPaths.length = 0;
+        break;
+      }
+      fieldPaths.push(pathRaw);
+    }
+    if (fieldPaths.length > 0) {
+      out.set(digest, fieldPaths);
+    }
+  }
+  return out;
+};
+var isPrefixPath = (prefix, path) => {
+  if (prefix.length > path.length) return false;
+  for (let i = 0; i < prefix.length; i++) {
+    if (prefix[i] !== path[i]) return false;
+  }
+  return true;
+};
+var minimizeRootPaths = (paths) => {
+  const roots = [];
+  for (const path of paths) {
+    let redundant = false;
+    for (const existing of roots) {
+      if (isPrefixPath(existing, path)) {
+        redundant = true;
+        break;
+      }
+    }
+    if (redundant) continue;
+    let nextLen = 0;
+    for (let i = 0; i < roots.length; i++) {
+      const existing = roots[i];
+      if (isPrefixPath(path, existing)) continue;
+      roots[nextLen] = existing;
+      nextLen += 1;
+    }
+    roots.length = nextLen;
+    roots.push(path);
+  }
+  return roots;
+};
+var resolveRootPaths = (args) => {
+  const ids = args.ids;
+  if (!Array.isArray(ids) || ids.length === 0) return void 0;
+  const candidates = [];
+  for (const rawId of ids) {
+    if (!Number.isInteger(rawId)) continue;
+    const id = rawId;
+    if (id < 0 || id >= args.fieldPaths.length) continue;
+    candidates.push(args.fieldPaths[id]);
+  }
+  if (candidates.length === 0) return void 0;
+  const minimized = minimizeRootPaths(candidates);
+  return minimized.length > 0 ? minimized : void 0;
+};
+var stripRootPathsField = (value) => {
+  const { rootPaths: _rootPaths, ...rest } = value;
+  return rest;
+};
+var stripLegacyDirtyRootPathsFromEvent = (event) => {
+  const meta = isRecord3(event.meta) ? event.meta : void 0;
+  if (!meta) return event;
+  if (event.kind === "state" && event.label === "state:update") {
+    const dirtySet = isRecord3(meta.dirtySet) ? meta.dirtySet : void 0;
+    if (!dirtySet || !Object.prototype.hasOwnProperty.call(dirtySet, "rootPaths")) return event;
+    return {
+      ...event,
+      meta: {
+        ...meta,
+        dirtySet: stripRootPathsField(dirtySet)
+      }
+    };
+  }
+  if (event.kind === "trait:converge") {
+    const dirty = isRecord3(meta.dirty) ? meta.dirty : void 0;
+    if (!dirty || !Object.prototype.hasOwnProperty.call(dirty, "rootPaths")) return event;
+    return {
+      ...event,
+      meta: {
+        ...meta,
+        dirty: stripRootPathsField(dirty)
+      }
+    };
+  }
+  return event;
+};
+var materializeDirtyRootPathsFromCanonical = (args) => {
+  if (args.fieldPathsByDigest.size === 0) return args.event;
+  const meta = isRecord3(args.event.meta) ? args.event.meta : void 0;
+  if (!meta) return args.event;
+  const staticIrDigest = asNonEmptyString2(meta.staticIrDigest);
+  if (!staticIrDigest) return args.event;
+  const fieldPaths = args.fieldPathsByDigest.get(staticIrDigest);
+  if (!fieldPaths) return args.event;
+  if (args.event.kind === "state" && args.event.label === "state:update") {
+    const dirtySet = isRecord3(meta.dirtySet) ? meta.dirtySet : void 0;
+    if (!dirtySet) return args.event;
+    const ids = Object.prototype.hasOwnProperty.call(dirtySet, "pathIds") ? dirtySet.pathIds : dirtySet.rootIds;
+    const rootPaths = resolveRootPaths({ ids, fieldPaths });
+    if (!rootPaths) return args.event;
+    return {
+      ...args.event,
+      meta: {
+        ...meta,
+        dirtySet: {
+          ...dirtySet,
+          rootPaths
+        }
+      }
+    };
+  }
+  if (args.event.kind === "trait:converge") {
+    const dirty = isRecord3(meta.dirty) ? meta.dirty : void 0;
+    if (!dirty) return args.event;
+    const rootPaths = resolveRootPaths({ ids: dirty.rootIds, fieldPaths });
+    if (!rootPaths) return args.event;
+    return {
+      ...args.event,
+      meta: {
+        ...meta,
+        dirty: {
+          ...dirty,
+          rootPaths
+        }
+      }
+    };
+  }
+  return args.event;
+};
+var fromDomEvent = (event) => import_effect4.Stream.callback(
+  (queue) => import_effect4.Effect.gen(function* () {
+    const handler = (e) => {
+      import_effect4.Queue.offerUnsafe(queue, e);
+    };
+    window.addEventListener(event, handler);
+    yield* import_effect4.Effect.addFinalizer(() => import_effect4.Effect.sync(() => window.removeEventListener(event, handler)));
+  })
+);
 var DevtoolsLogic = DevtoolsModule.logic(($) => ({
   setup: $.lifecycle.onStart(
     import_effect4.Effect.gen(function* () {
-      const snapshotStore = yield* DevtoolsSnapshotStore;
+      const snapshotStore = yield* $.use(DevtoolsSnapshotStore);
       const initialSnapshot = yield* snapshotStore.get;
       yield* $.state.update(
         (prev) => computeDevtoolsState(prev, initialSnapshot, {
@@ -1211,7 +1340,7 @@ var DevtoolsLogic = DevtoolsModule.logic(($) => ({
   ),
   // run section: initialize snapshot subscription + register all onAction watchers and dragging logic.
   run: import_effect4.Effect.gen(function* () {
-    const snapshotStore = yield* DevtoolsSnapshotStore;
+    const snapshotStore = yield* $.use(DevtoolsSnapshotStore);
     yield* $.on(snapshotStore.changes).runFork(
       (snapshot) => $.state.update(
         (prev) => computeDevtoolsState(prev, snapshot, {
@@ -1310,13 +1439,15 @@ var DevtoolsLogic = DevtoolsModule.logic(($) => ({
           return;
         }
         const evidence = Logix4.Observability.importEvidencePackage(parsed);
+        const fieldPathsByDigest = readConvergeFieldPathsByDigest(evidence.summary);
         const events = [];
         for (const envelope of evidence.events) {
           if (envelope.type !== "debug:event") continue;
           const payload = envelope.payload;
           const normalized = normalizeRuntimeDebugEventRef(payload);
           if (!normalized) continue;
-          events.push(normalized);
+          const canonicalEvent = stripLegacyDirtyRootPathsFromEvent(normalized);
+          events.push(materializeDirtyRootPathsFromCanonical({ event: canonicalEvent, fieldPathsByDigest }));
         }
         const snapshot = {
           snapshotToken: 0,
@@ -1408,18 +1539,18 @@ var devtoolsRuntime = Logix5.Runtime.make(DevtoolsImpl, {
   // so Logic can subscribe to Snapshot changes via Tag.
   layer: devtoolsSnapshotLayer
 });
-var devtoolsModuleRuntime = devtoolsRuntime.runSync(DevtoolsModule.tag);
+var devtoolsModuleRuntime = devtoolsRuntime.runSync(import_effect5.Effect.service(DevtoolsModule.tag).pipe(import_effect5.Effect.orDie));
 
 // src/internal/ui/hooks/DevtoolsHooks.tsx
 var subscribe = (onStoreChange) => {
   const fiber = devtoolsRuntime.runFork(
-    import_effect5.Stream.runForEach(
+    import_effect6.Stream.runForEach(
       devtoolsModuleRuntime.changes((state) => state),
-      () => import_effect5.Effect.sync(onStoreChange)
+      () => import_effect6.Effect.sync(onStoreChange)
     )
   );
   return () => {
-    devtoolsRuntime.runFork(import_effect5.Fiber.interrupt(fiber));
+    devtoolsRuntime.runFork(import_effect6.Fiber.interrupt(fiber));
   };
 };
 var getSnapshot = () => devtoolsRuntime.runSync(devtoolsModuleRuntime.getState);
@@ -1747,9 +1878,9 @@ var makeTraitConvergeOverrideSnippets = (params) => {
       [moduleId]: patch
     }
   })})`;
-  const moduleOverride = `Logix.Runtime.setTraitConvergeOverride(runtime, ${stableStringify(moduleId)}, ${stableStringify(
+  const moduleOverride = `await Effect.runPromise(Logix.Runtime.setTraitConvergeOverride(runtime, ${stableStringify(moduleId)}, ${stableStringify(
     patch
-  )})`;
+  )}))`;
   return [
     {
       kind: "provider_override",

package/dist/LogixDevtools.js

@@ -1,7 +1,7 @@
 import {
   LogixDevtools
-} from "./chunk-WTZBDE4J.js";
-import "./chunk-FNWHBEXD.js";
+} from "./chunk-H5JD2DNC.js";
+import "./chunk-NH3EYAZ6.js";
 import "./chunk-CZWYV2AZ.js";
 export {
   LogixDevtools

package/dist/{chunk-WTZBDE4J.js → chunk-H5JD2DNC.js}

@@ -8,7 +8,7 @@ import {
   getInstanceLabel,
   hasDevtoolsSnapshotOverride,
   setDevtoolsSnapshotOverride
-} from "./chunk-FNWHBEXD.js";
+} from "./chunk-NH3EYAZ6.js";
 import {
   StateTraitGraphView,
   ensureDevtoolsStyles
@@ -24,14 +24,15 @@ import * as Logix7 from "@logixjs/core";
 
 // src/internal/ui/hooks/DevtoolsHooks.tsx
 import React, { useSyncExternalStore } from "react";
-import { Effect as Effect2, Fiber, Stream as Stream2 } from "effect";
+import { Effect as Effect3, Fiber, Stream as Stream2 } from "effect";
 
 // src/internal/state/runtime.ts
 import * as Logix4 from "@logixjs/core";
+import { Effect as Effect2 } from "effect";
 
 // src/internal/state/logic.ts
 import * as Logix3 from "@logixjs/core";
-import { Effect, Stream } from "effect";
+import { Effect, Queue, Stream } from "effect";
 
 // src/internal/state/compute.ts
 import * as Logix from "@logixjs/core";
@@ -68,7 +69,7 @@ var OperationSummarySchema = Schema.Struct({
       top3: Schema.Array(
         Schema.Struct({
           stepId: Schema.String,
-          kind: Schema.Literal("computed", "link"),
+          kind: Schema.Literals(["computed", "link"]),
           fieldPath: Schema.String,
           durationMs: Schema.Number,
           changed: Schema.Boolean,
@@ -84,7 +85,7 @@ var TriggerLayoutSchema = Schema.Struct({
   isDragging: Schema.Boolean
 });
 var DevtoolsSettingsSchema = Schema.Struct({
-  mode: Schema.Literal("basic", "deep"),
+  mode: Schema.Literals(["basic", "deep"]),
   showTraitEvents: Schema.Boolean,
   showReactRenderEvents: Schema.Boolean,
   enableTimeTravelUI: Schema.Boolean,
@@ -125,7 +126,7 @@ var DevtoolsStateSchema = Schema.Struct({
       moduleId: Schema.String,
       instanceId: Schema.String,
       txnId: Schema.String,
-      mode: Schema.Literal("before", "after")
+      mode: Schema.Literals(["before", "after"])
     })
   ),
   runtimes: Schema.Array(
@@ -154,7 +155,7 @@ var DevtoolsStateSchema = Schema.Struct({
     isDragging: Schema.Boolean,
     trigger: Schema.optional(TriggerLayoutSchema)
   }),
-  theme: Schema.Literal("system", "light", "dark"),
+  theme: Schema.Literals(["system", "light", "dark"]),
   settings: DevtoolsSettingsSchema
 });
 var defaultSettings = {
@@ -224,13 +225,11 @@ var gateDirtyRootPathsByDigest = (meta) => {
   }
   const dirtySet = meta.dirtySet;
   if (!isRecord(dirtySet)) return meta;
-  if (!Array.isArray(dirtySet.rootPaths)) return meta;
+  if (!Object.prototype.hasOwnProperty.call(dirtySet, "rootPaths")) return meta;
+  const { rootPaths: _rootPaths, ...dirtySetWithoutRootPaths } = dirtySet;
   return {
     ...meta,
-    dirtySet: {
-      ...dirtySet,
-      rootPaths: void 0
-    }
+    dirtySet: dirtySetWithoutRootPaths
   };
 };
 var getEventTimestamp = (event) => event.timestamp;
@@ -761,23 +760,21 @@ var persistSettingsToStorage = (settings) => {
 import * as Logix2 from "@logixjs/core";
 import { Schema as Schema2 } from "effect";
 var ResizePayload = Schema2.Struct({
-  edge: Schema2.Literal("top", "left", "right")
+  edge: Schema2.Literals(["top", "left", "right"])
+});
+var UpdateLayoutPayload = Schema2.Struct({
+  height: Schema2.optional(Schema2.Number),
+  marginLeft: Schema2.optional(Schema2.Number),
+  marginRight: Schema2.optional(Schema2.Number),
+  isDragging: Schema2.optional(Schema2.Boolean),
+  trigger: Schema2.optional(
+    Schema2.Struct({
+      x: Schema2.Number,
+      y: Schema2.Number,
+      isDragging: Schema2.Boolean
+    })
+  )
 });
-var UpdateLayoutPayload = Schema2.partial(
-  Schema2.Struct({
-    height: Schema2.Number,
-    marginLeft: Schema2.Number,
-    marginRight: Schema2.Number,
-    isDragging: Schema2.Boolean,
-    trigger: Schema2.optional(
-      Schema2.Struct({
-        x: Schema2.Number,
-        y: Schema2.Number,
-        isDragging: Schema2.Boolean
-      })
-    )
-  })
-);
 var DevtoolsModule = Logix2.Module.make("LogixDevtoolsModule", {
   state: DevtoolsStateSchema,
   actions: {
@@ -811,8 +808,8 @@ var DevtoolsModule = Logix2.Module.make("LogixDevtoolsModule", {
     clearImportedEvidence: Schema2.Void,
     resizeStart: ResizePayload,
     updateLayout: UpdateLayoutPayload,
-    setTheme: Schema2.Literal("system", "light", "dark"),
-    setMode: Schema2.Literal("basic", "deep"),
+    setTheme: Schema2.Literals(["system", "light", "dark"]),
+    setMode: Schema2.Literals(["basic", "deep"]),
     updateSettings: Schema2.Any
   },
   reducers: {
@@ -1047,15 +1044,165 @@ var normalizeRuntimeDebugEventRef = (value) => {
   }
   return { ...value, instanceId };
 };
-var fromDomEvent = (event) => Stream.async((emit) => {
-  const handler = (e) => emit.single(e);
-  window.addEventListener(event, handler);
-  return Effect.sync(() => window.removeEventListener(event, handler));
-});
+var readConvergeFieldPathsByDigest = (summary) => {
+  if (!isRecord2(summary)) return /* @__PURE__ */ new Map();
+  const converge = isRecord2(summary.converge) ? summary.converge : void 0;
+  const byDigest = converge && isRecord2(converge.staticIrByDigest) ? converge.staticIrByDigest : void 0;
+  if (!byDigest) return /* @__PURE__ */ new Map();
+  const out = /* @__PURE__ */ new Map();
+  for (const [digest, ir] of Object.entries(byDigest)) {
+    if (!isRecord2(ir)) continue;
+    const fieldPathsRaw = ir.fieldPaths;
+    if (!Array.isArray(fieldPathsRaw)) continue;
+    const fieldPaths = [];
+    for (const pathRaw of fieldPathsRaw) {
+      if (!Array.isArray(pathRaw) || pathRaw.length === 0) {
+        fieldPaths.length = 0;
+        break;
+      }
+      if (!pathRaw.every((seg) => typeof seg === "string" && seg.length > 0)) {
+        fieldPaths.length = 0;
+        break;
+      }
+      fieldPaths.push(pathRaw);
+    }
+    if (fieldPaths.length > 0) {
+      out.set(digest, fieldPaths);
+    }
+  }
+  return out;
+};
+var isPrefixPath = (prefix, path) => {
+  if (prefix.length > path.length) return false;
+  for (let i = 0; i < prefix.length; i++) {
+    if (prefix[i] !== path[i]) return false;
+  }
+  return true;
+};
+var minimizeRootPaths = (paths) => {
+  const roots = [];
+  for (const path of paths) {
+    let redundant = false;
+    for (const existing of roots) {
+      if (isPrefixPath(existing, path)) {
+        redundant = true;
+        break;
+      }
+    }
+    if (redundant) continue;
+    let nextLen = 0;
+    for (let i = 0; i < roots.length; i++) {
+      const existing = roots[i];
+      if (isPrefixPath(path, existing)) continue;
+      roots[nextLen] = existing;
+      nextLen += 1;
+    }
+    roots.length = nextLen;
+    roots.push(path);
+  }
+  return roots;
+};
+var resolveRootPaths = (args) => {
+  const ids = args.ids;
+  if (!Array.isArray(ids) || ids.length === 0) return void 0;
+  const candidates = [];
+  for (const rawId of ids) {
+    if (!Number.isInteger(rawId)) continue;
+    const id = rawId;
+    if (id < 0 || id >= args.fieldPaths.length) continue;
+    candidates.push(args.fieldPaths[id]);
+  }
+  if (candidates.length === 0) return void 0;
+  const minimized = minimizeRootPaths(candidates);
+  return minimized.length > 0 ? minimized : void 0;
+};
+var stripRootPathsField = (value) => {
+  const { rootPaths: _rootPaths, ...rest } = value;
+  return rest;
+};
+var stripLegacyDirtyRootPathsFromEvent = (event) => {
+  const meta = isRecord2(event.meta) ? event.meta : void 0;
+  if (!meta) return event;
+  if (event.kind === "state" && event.label === "state:update") {
+    const dirtySet = isRecord2(meta.dirtySet) ? meta.dirtySet : void 0;
+    if (!dirtySet || !Object.prototype.hasOwnProperty.call(dirtySet, "rootPaths")) return event;
+    return {
+      ...event,
+      meta: {
+        ...meta,
+        dirtySet: stripRootPathsField(dirtySet)
+      }
+    };
+  }
+  if (event.kind === "trait:converge") {
+    const dirty = isRecord2(meta.dirty) ? meta.dirty : void 0;
+    if (!dirty || !Object.prototype.hasOwnProperty.call(dirty, "rootPaths")) return event;
+    return {
+      ...event,
+      meta: {
+        ...meta,
+        dirty: stripRootPathsField(dirty)
+      }
+    };
+  }
+  return event;
+};
+var materializeDirtyRootPathsFromCanonical = (args) => {
+  if (args.fieldPathsByDigest.size === 0) return args.event;
+  const meta = isRecord2(args.event.meta) ? args.event.meta : void 0;
+  if (!meta) return args.event;
+  const staticIrDigest = asNonEmptyString(meta.staticIrDigest);
+  if (!staticIrDigest) return args.event;
+  const fieldPaths = args.fieldPathsByDigest.get(staticIrDigest);
+  if (!fieldPaths) return args.event;
+  if (args.event.kind === "state" && args.event.label === "state:update") {
+    const dirtySet = isRecord2(meta.dirtySet) ? meta.dirtySet : void 0;
+    if (!dirtySet) return args.event;
+    const ids = Object.prototype.hasOwnProperty.call(dirtySet, "pathIds") ? dirtySet.pathIds : dirtySet.rootIds;
+    const rootPaths = resolveRootPaths({ ids, fieldPaths });
+    if (!rootPaths) return args.event;
+    return {
+      ...args.event,
+      meta: {
+        ...meta,
+        dirtySet: {
+          ...dirtySet,
+          rootPaths
+        }
+      }
+    };
+  }
+  if (args.event.kind === "trait:converge") {
+    const dirty = isRecord2(meta.dirty) ? meta.dirty : void 0;
+    if (!dirty) return args.event;
+    const rootPaths = resolveRootPaths({ ids: dirty.rootIds, fieldPaths });
+    if (!rootPaths) return args.event;
+    return {
+      ...args.event,
+      meta: {
+        ...meta,
+        dirty: {
+          ...dirty,
+          rootPaths
+        }
+      }
+    };
+  }
+  return args.event;
+};
+var fromDomEvent = (event) => Stream.callback(
+  (queue) => Effect.gen(function* () {
+    const handler = (e) => {
+      Queue.offerUnsafe(queue, e);
+    };
+    window.addEventListener(event, handler);
+    yield* Effect.addFinalizer(() => Effect.sync(() => window.removeEventListener(event, handler)));
+  })
+);
 var DevtoolsLogic = DevtoolsModule.logic(($) => ({
   setup: $.lifecycle.onStart(
     Effect.gen(function* () {
-      const snapshotStore = yield* DevtoolsSnapshotStore;
+      const snapshotStore = yield* $.use(DevtoolsSnapshotStore);
       const initialSnapshot = yield* snapshotStore.get;
       yield* $.state.update(
         (prev) => computeDevtoolsState(prev, initialSnapshot, {
@@ -1066,7 +1213,7 @@ var DevtoolsLogic = DevtoolsModule.logic(($) => ({
   ),
   // run section: initialize snapshot subscription + register all onAction watchers and dragging logic.
   run: Effect.gen(function* () {
-    const snapshotStore = yield* DevtoolsSnapshotStore;
+    const snapshotStore = yield* $.use(DevtoolsSnapshotStore);
     yield* $.on(snapshotStore.changes).runFork(
       (snapshot) => $.state.update(
         (prev) => computeDevtoolsState(prev, snapshot, {
@@ -1165,13 +1312,15 @@ var DevtoolsLogic = DevtoolsModule.logic(($) => ({
           return;
         }
         const evidence = Logix3.Observability.importEvidencePackage(parsed);
+        const fieldPathsByDigest = readConvergeFieldPathsByDigest(evidence.summary);
         const events = [];
         for (const envelope of evidence.events) {
           if (envelope.type !== "debug:event") continue;
           const payload = envelope.payload;
           const normalized = normalizeRuntimeDebugEventRef(payload);
           if (!normalized) continue;
-          events.push(normalized);
+          const canonicalEvent = stripLegacyDirtyRootPathsFromEvent(normalized);
+          events.push(materializeDirtyRootPathsFromCanonical({ event: canonicalEvent, fieldPathsByDigest }));
         }
         const snapshot = {
           snapshotToken: 0,
@@ -1263,14 +1412,14 @@ var devtoolsRuntime = Logix4.Runtime.make(DevtoolsImpl, {
   // so Logic can subscribe to Snapshot changes via Tag.
   layer: devtoolsSnapshotLayer
 });
-var devtoolsModuleRuntime = devtoolsRuntime.runSync(DevtoolsModule.tag);
+var devtoolsModuleRuntime = devtoolsRuntime.runSync(Effect2.service(DevtoolsModule.tag).pipe(Effect2.orDie));
 
 // src/internal/ui/hooks/DevtoolsHooks.tsx
 var subscribe = (onStoreChange) => {
   const fiber = devtoolsRuntime.runFork(
     Stream2.runForEach(
       devtoolsModuleRuntime.changes((state) => state),
-      () => Effect2.sync(onStoreChange)
+      () => Effect3.sync(onStoreChange)
     )
   );
   return () => {
@@ -1602,9 +1751,9 @@ var makeTraitConvergeOverrideSnippets = (params) => {
       [moduleId]: patch
     }
   })})`;
-  const moduleOverride = `Logix.Runtime.setTraitConvergeOverride(runtime, ${stableStringify(moduleId)}, ${stableStringify(
+  const moduleOverride = `await Effect.runPromise(Logix.Runtime.setTraitConvergeOverride(runtime, ${stableStringify(moduleId)}, ${stableStringify(
     patch
-  )})`;
+  )}))`;
   return [
     {
       kind: "provider_override",

package/dist/{chunk-FNWHBEXD.js → chunk-NH3EYAZ6.js}

@@ -1,7 +1,10 @@
 // src/internal/snapshot/index.ts
 import * as Logix from "@logixjs/core";
-import { Context, Effect, Layer, Stream } from "effect";
-var clearDevtoolsEvents = Logix.Debug.clearDevtoolsEvents;
+import { Effect, Layer, PubSub, ServiceMap, Stream } from "effect";
+var clearDevtoolsEvents = () => {
+  Logix.Debug.clearDevtoolsEvents();
+  notify();
+};
 var setInstanceLabel = Logix.Debug.setInstanceLabel;
 var getInstanceLabel = Logix.Debug.getInstanceLabel;
 var snapshotOverride;
@@ -46,7 +49,9 @@ var normalizeDevtoolsSnapshot = (snapshot) => {
 };
 var listeners = /* @__PURE__ */ new Set();
 var unsubscribeCore;
+var snapshotPubSub = Effect.runSync(PubSub.unbounded());
 var notify = () => {
+  PubSub.publishUnsafe(snapshotPubSub, getDevtoolsSnapshot());
   for (const listener of listeners) {
     listener();
   }
@@ -88,17 +93,13 @@ var subscribeDevtoolsSnapshot = (listener) => {
 };
 var subscribeDevtoolsSnapshotToken = subscribeDevtoolsSnapshot;
 var devtoolsLayer = Logix.Debug.devtoolsHubLayer();
-var DevtoolsSnapshotStore = class extends Context.Tag("Logix/DevtoolsSnapshotStore")() {
+var DevtoolsSnapshotStore = class extends ServiceMap.Service()(
+  "Logix/DevtoolsSnapshotStore"
+) {
 };
 var devtoolsSnapshotService = {
   get: Effect.sync(() => getDevtoolsSnapshot()),
-  changes: Stream.async((emit) => {
-    const listener = () => {
-      emit.single(getDevtoolsSnapshot());
-    };
-    const unsubscribe = subscribeDevtoolsSnapshot(listener);
-    return Effect.sync(unsubscribe);
-  })
+  changes: Stream.fromPubSub(snapshotPubSub)
 };
 var devtoolsSnapshotLayer = Layer.succeed(
   DevtoolsSnapshotStore,

package/dist/index.cjs

@@ -79,15 +79,19 @@ var Logix8 = __toESM(require("@logixjs/core"), 1);
 
 // src/internal/ui/hooks/DevtoolsHooks.tsx
 var import_react = __toESM(require("react"), 1);
-var import_effect5 = require("effect");
+var import_effect6 = require("effect");
 
 // src/internal/state/runtime.ts
 var Logix5 = __toESM(require("@logixjs/core"), 1);
+var import_effect5 = require("effect");
 
 // src/internal/snapshot/index.ts
 var Logix = __toESM(require("@logixjs/core"), 1);
 var import_effect = require("effect");
-var clearDevtoolsEvents = Logix.Debug.clearDevtoolsEvents;
+var clearDevtoolsEvents = () => {
+  Logix.Debug.clearDevtoolsEvents();
+  notify();
+};
 var setInstanceLabel = Logix.Debug.setInstanceLabel;
 var getInstanceLabel = Logix.Debug.getInstanceLabel;
 var snapshotOverride;
@@ -132,7 +136,9 @@ var normalizeDevtoolsSnapshot = (snapshot) => {
 };
 var listeners = /* @__PURE__ */ new Set();
 var unsubscribeCore;
+var snapshotPubSub = import_effect.Effect.runSync(import_effect.PubSub.unbounded());
 var notify = () => {
+  import_effect.PubSub.publishUnsafe(snapshotPubSub, getDevtoolsSnapshot());
   for (const listener of listeners) {
     listener();
   }
@@ -174,17 +180,13 @@ var subscribeDevtoolsSnapshot = (listener) => {
 };
 var subscribeDevtoolsSnapshotToken = subscribeDevtoolsSnapshot;
 var devtoolsLayer = Logix.Debug.devtoolsHubLayer();
-var DevtoolsSnapshotStore = class extends import_effect.Context.Tag("Logix/DevtoolsSnapshotStore")() {
+var DevtoolsSnapshotStore = class extends import_effect.ServiceMap.Service()(
+  "Logix/DevtoolsSnapshotStore"
+) {
 };
 var devtoolsSnapshotService = {
   get: import_effect.Effect.sync(() => getDevtoolsSnapshot()),
-  changes: import_effect.Stream.async((emit) => {
-    const listener = () => {
-      emit.single(getDevtoolsSnapshot());
-    };
-    const unsubscribe = subscribeDevtoolsSnapshot(listener);
-    return import_effect.Effect.sync(unsubscribe);
-  })
+  changes: import_effect.Stream.fromPubSub(snapshotPubSub)
 };
 var devtoolsSnapshotLayer = import_effect.Layer.succeed(
   DevtoolsSnapshotStore,
@@ -230,7 +232,7 @@ var OperationSummarySchema = import_effect2.Schema.Struct({
       top3: import_effect2.Schema.Array(
         import_effect2.Schema.Struct({
           stepId: import_effect2.Schema.String,
-          kind: import_effect2.Schema.Literal("computed", "link"),
+          kind: import_effect2.Schema.Literals(["computed", "link"]),
           fieldPath: import_effect2.Schema.String,
           durationMs: import_effect2.Schema.Number,
           changed: import_effect2.Schema.Boolean,
@@ -246,7 +248,7 @@ var TriggerLayoutSchema = import_effect2.Schema.Struct({
   isDragging: import_effect2.Schema.Boolean
 });
 var DevtoolsSettingsSchema = import_effect2.Schema.Struct({
-  mode: import_effect2.Schema.Literal("basic", "deep"),
+  mode: import_effect2.Schema.Literals(["basic", "deep"]),
   showTraitEvents: import_effect2.Schema.Boolean,
   showReactRenderEvents: import_effect2.Schema.Boolean,
   enableTimeTravelUI: import_effect2.Schema.Boolean,
@@ -287,7 +289,7 @@ var DevtoolsStateSchema = import_effect2.Schema.Struct({
       moduleId: import_effect2.Schema.String,
       instanceId: import_effect2.Schema.String,
       txnId: import_effect2.Schema.String,
-      mode: import_effect2.Schema.Literal("before", "after")
+      mode: import_effect2.Schema.Literals(["before", "after"])
     })
   ),
   runtimes: import_effect2.Schema.Array(
@@ -316,7 +318,7 @@ var DevtoolsStateSchema = import_effect2.Schema.Struct({
     isDragging: import_effect2.Schema.Boolean,
     trigger: import_effect2.Schema.optional(TriggerLayoutSchema)
   }),
-  theme: import_effect2.Schema.Literal("system", "light", "dark"),
+  theme: import_effect2.Schema.Literals(["system", "light", "dark"]),
   settings: DevtoolsSettingsSchema
 });
 var defaultSettings = {
@@ -386,13 +388,11 @@ var gateDirtyRootPathsByDigest = (meta) => {
   }
   const dirtySet = meta.dirtySet;
   if (!isRecord2(dirtySet)) return meta;
-  if (!Array.isArray(dirtySet.rootPaths)) return meta;
+  if (!Object.prototype.hasOwnProperty.call(dirtySet, "rootPaths")) return meta;
+  const { rootPaths: _rootPaths, ...dirtySetWithoutRootPaths } = dirtySet;
   return {
     ...meta,
-    dirtySet: {
-      ...dirtySet,
-      rootPaths: void 0
-    }
+    dirtySet: dirtySetWithoutRootPaths
   };
 };
 var getEventTimestamp = (event) => event.timestamp;
@@ -923,23 +923,21 @@ var persistSettingsToStorage = (settings) => {
 var Logix3 = __toESM(require("@logixjs/core"), 1);
 var import_effect3 = require("effect");
 var ResizePayload = import_effect3.Schema.Struct({
-  edge: import_effect3.Schema.Literal("top", "left", "right")
+  edge: import_effect3.Schema.Literals(["top", "left", "right"])
+});
+var UpdateLayoutPayload = import_effect3.Schema.Struct({
+  height: import_effect3.Schema.optional(import_effect3.Schema.Number),
+  marginLeft: import_effect3.Schema.optional(import_effect3.Schema.Number),
+  marginRight: import_effect3.Schema.optional(import_effect3.Schema.Number),
+  isDragging: import_effect3.Schema.optional(import_effect3.Schema.Boolean),
+  trigger: import_effect3.Schema.optional(
+    import_effect3.Schema.Struct({
+      x: import_effect3.Schema.Number,
+      y: import_effect3.Schema.Number,
+      isDragging: import_effect3.Schema.Boolean
+    })
+  )
 });
-var UpdateLayoutPayload = import_effect3.Schema.partial(
-  import_effect3.Schema.Struct({
-    height: import_effect3.Schema.Number,
-    marginLeft: import_effect3.Schema.Number,
-    marginRight: import_effect3.Schema.Number,
-    isDragging: import_effect3.Schema.Boolean,
-    trigger: import_effect3.Schema.optional(
-      import_effect3.Schema.Struct({
-        x: import_effect3.Schema.Number,
-        y: import_effect3.Schema.Number,
-        isDragging: import_effect3.Schema.Boolean
-      })
-    )
-  })
-);
 var DevtoolsModule = Logix3.Module.make("LogixDevtoolsModule", {
   state: DevtoolsStateSchema,
   actions: {
@@ -973,8 +971,8 @@ var DevtoolsModule = Logix3.Module.make("LogixDevtoolsModule", {
     clearImportedEvidence: import_effect3.Schema.Void,
     resizeStart: ResizePayload,
     updateLayout: UpdateLayoutPayload,
-    setTheme: import_effect3.Schema.Literal("system", "light", "dark"),
-    setMode: import_effect3.Schema.Literal("basic", "deep"),
+    setTheme: import_effect3.Schema.Literals(["system", "light", "dark"]),
+    setMode: import_effect3.Schema.Literals(["basic", "deep"]),
     updateSettings: import_effect3.Schema.Any
   },
   reducers: {
@@ -1209,15 +1207,165 @@ var normalizeRuntimeDebugEventRef = (value) => {
   }
   return { ...value, instanceId };
 };
-var fromDomEvent = (event) => import_effect4.Stream.async((emit) => {
-  const handler = (e) => emit.single(e);
-  window.addEventListener(event, handler);
-  return import_effect4.Effect.sync(() => window.removeEventListener(event, handler));
-});
+var readConvergeFieldPathsByDigest = (summary) => {
+  if (!isRecord3(summary)) return /* @__PURE__ */ new Map();
+  const converge = isRecord3(summary.converge) ? summary.converge : void 0;
+  const byDigest = converge && isRecord3(converge.staticIrByDigest) ? converge.staticIrByDigest : void 0;
+  if (!byDigest) return /* @__PURE__ */ new Map();
+  const out = /* @__PURE__ */ new Map();
+  for (const [digest, ir] of Object.entries(byDigest)) {
+    if (!isRecord3(ir)) continue;
+    const fieldPathsRaw = ir.fieldPaths;
+    if (!Array.isArray(fieldPathsRaw)) continue;
+    const fieldPaths = [];
+    for (const pathRaw of fieldPathsRaw) {
+      if (!Array.isArray(pathRaw) || pathRaw.length === 0) {
+        fieldPaths.length = 0;
+        break;
+      }
+      if (!pathRaw.every((seg) => typeof seg === "string" && seg.length > 0)) {
+        fieldPaths.length = 0;
+        break;
+      }
+      fieldPaths.push(pathRaw);
+    }
+    if (fieldPaths.length > 0) {
+      out.set(digest, fieldPaths);
+    }
+  }
+  return out;
+};
+var isPrefixPath = (prefix, path) => {
+  if (prefix.length > path.length) return false;
+  for (let i = 0; i < prefix.length; i++) {
+    if (prefix[i] !== path[i]) return false;
+  }
+  return true;
+};
+var minimizeRootPaths = (paths) => {
+  const roots = [];
+  for (const path of paths) {
+    let redundant = false;
+    for (const existing of roots) {
+      if (isPrefixPath(existing, path)) {
+        redundant = true;
+        break;
+      }
+    }
+    if (redundant) continue;
+    let nextLen = 0;
+    for (let i = 0; i < roots.length; i++) {
+      const existing = roots[i];
+      if (isPrefixPath(path, existing)) continue;
+      roots[nextLen] = existing;
+      nextLen += 1;
+    }
+    roots.length = nextLen;
+    roots.push(path);
+  }
+  return roots;
+};
+var resolveRootPaths = (args) => {
+  const ids = args.ids;
+  if (!Array.isArray(ids) || ids.length === 0) return void 0;
+  const candidates = [];
+  for (const rawId of ids) {
+    if (!Number.isInteger(rawId)) continue;
+    const id = rawId;
+    if (id < 0 || id >= args.fieldPaths.length) continue;
+    candidates.push(args.fieldPaths[id]);
+  }
+  if (candidates.length === 0) return void 0;
+  const minimized = minimizeRootPaths(candidates);
+  return minimized.length > 0 ? minimized : void 0;
+};
+var stripRootPathsField = (value) => {
+  const { rootPaths: _rootPaths, ...rest } = value;
+  return rest;
+};
+var stripLegacyDirtyRootPathsFromEvent = (event) => {
+  const meta = isRecord3(event.meta) ? event.meta : void 0;
+  if (!meta) return event;
+  if (event.kind === "state" && event.label === "state:update") {
+    const dirtySet = isRecord3(meta.dirtySet) ? meta.dirtySet : void 0;
+    if (!dirtySet || !Object.prototype.hasOwnProperty.call(dirtySet, "rootPaths")) return event;
+    return {
+      ...event,
+      meta: {
+        ...meta,
+        dirtySet: stripRootPathsField(dirtySet)
+      }
+    };
+  }
+  if (event.kind === "trait:converge") {
+    const dirty = isRecord3(meta.dirty) ? meta.dirty : void 0;
+    if (!dirty || !Object.prototype.hasOwnProperty.call(dirty, "rootPaths")) return event;
+    return {
+      ...event,
+      meta: {
+        ...meta,
+        dirty: stripRootPathsField(dirty)
+      }
+    };
+  }
+  return event;
+};
+var materializeDirtyRootPathsFromCanonical = (args) => {
+  if (args.fieldPathsByDigest.size === 0) return args.event;
+  const meta = isRecord3(args.event.meta) ? args.event.meta : void 0;
+  if (!meta) return args.event;
+  const staticIrDigest = asNonEmptyString2(meta.staticIrDigest);
+  if (!staticIrDigest) return args.event;
+  const fieldPaths = args.fieldPathsByDigest.get(staticIrDigest);
+  if (!fieldPaths) return args.event;
+  if (args.event.kind === "state" && args.event.label === "state:update") {
+    const dirtySet = isRecord3(meta.dirtySet) ? meta.dirtySet : void 0;
+    if (!dirtySet) return args.event;
+    const ids = Object.prototype.hasOwnProperty.call(dirtySet, "pathIds") ? dirtySet.pathIds : dirtySet.rootIds;
+    const rootPaths = resolveRootPaths({ ids, fieldPaths });
+    if (!rootPaths) return args.event;
+    return {
+      ...args.event,
+      meta: {
+        ...meta,
+        dirtySet: {
+          ...dirtySet,
+          rootPaths
+        }
+      }
+    };
+  }
+  if (args.event.kind === "trait:converge") {
+    const dirty = isRecord3(meta.dirty) ? meta.dirty : void 0;
+    if (!dirty) return args.event;
+    const rootPaths = resolveRootPaths({ ids: dirty.rootIds, fieldPaths });
+    if (!rootPaths) return args.event;
+    return {
+      ...args.event,
+      meta: {
+        ...meta,
+        dirty: {
+          ...dirty,
+          rootPaths
+        }
+      }
+    };
+  }
+  return args.event;
+};
+var fromDomEvent = (event) => import_effect4.Stream.callback(
+  (queue) => import_effect4.Effect.gen(function* () {
+    const handler = (e) => {
+      import_effect4.Queue.offerUnsafe(queue, e);
+    };
+    window.addEventListener(event, handler);
+    yield* import_effect4.Effect.addFinalizer(() => import_effect4.Effect.sync(() => window.removeEventListener(event, handler)));
+  })
+);
 var DevtoolsLogic = DevtoolsModule.logic(($) => ({
   setup: $.lifecycle.onStart(
     import_effect4.Effect.gen(function* () {
-      const snapshotStore = yield* DevtoolsSnapshotStore;
+      const snapshotStore = yield* $.use(DevtoolsSnapshotStore);
       const initialSnapshot = yield* snapshotStore.get;
       yield* $.state.update(
         (prev) => computeDevtoolsState(prev, initialSnapshot, {
@@ -1228,7 +1376,7 @@ var DevtoolsLogic = DevtoolsModule.logic(($) => ({
   ),
   // run section: initialize snapshot subscription + register all onAction watchers and dragging logic.
   run: import_effect4.Effect.gen(function* () {
-    const snapshotStore = yield* DevtoolsSnapshotStore;
+    const snapshotStore = yield* $.use(DevtoolsSnapshotStore);
     yield* $.on(snapshotStore.changes).runFork(
       (snapshot) => $.state.update(
         (prev) => computeDevtoolsState(prev, snapshot, {
@@ -1327,13 +1475,15 @@ var DevtoolsLogic = DevtoolsModule.logic(($) => ({
           return;
         }
         const evidence = Logix4.Observability.importEvidencePackage(parsed);
+        const fieldPathsByDigest = readConvergeFieldPathsByDigest(evidence.summary);
         const events = [];
         for (const envelope of evidence.events) {
           if (envelope.type !== "debug:event") continue;
           const payload = envelope.payload;
           const normalized = normalizeRuntimeDebugEventRef(payload);
           if (!normalized) continue;
-          events.push(normalized);
+          const canonicalEvent = stripLegacyDirtyRootPathsFromEvent(normalized);
+          events.push(materializeDirtyRootPathsFromCanonical({ event: canonicalEvent, fieldPathsByDigest }));
         }
         const snapshot = {
           snapshotToken: 0,
@@ -1425,18 +1575,18 @@ var devtoolsRuntime = Logix5.Runtime.make(DevtoolsImpl, {
   // so Logic can subscribe to Snapshot changes via Tag.
   layer: devtoolsSnapshotLayer
 });
-var devtoolsModuleRuntime = devtoolsRuntime.runSync(DevtoolsModule.tag);
+var devtoolsModuleRuntime = devtoolsRuntime.runSync(import_effect5.Effect.service(DevtoolsModule.tag).pipe(import_effect5.Effect.orDie));
 
 // src/internal/ui/hooks/DevtoolsHooks.tsx
 var subscribe = (onStoreChange) => {
   const fiber = devtoolsRuntime.runFork(
-    import_effect5.Stream.runForEach(
+    import_effect6.Stream.runForEach(
       devtoolsModuleRuntime.changes((state) => state),
-      () => import_effect5.Effect.sync(onStoreChange)
+      () => import_effect6.Effect.sync(onStoreChange)
     )
   );
   return () => {
-    devtoolsRuntime.runFork(import_effect5.Fiber.interrupt(fiber));
+    devtoolsRuntime.runFork(import_effect6.Fiber.interrupt(fiber));
   };
 };
 var getSnapshot = () => devtoolsRuntime.runSync(devtoolsModuleRuntime.getState);
@@ -1764,9 +1914,9 @@ var makeTraitConvergeOverrideSnippets = (params) => {
       [moduleId]: patch
     }
   })})`;
-  const moduleOverride = `Logix.Runtime.setTraitConvergeOverride(runtime, ${stableStringify(moduleId)}, ${stableStringify(
+  const moduleOverride = `await Effect.runPromise(Logix.Runtime.setTraitConvergeOverride(runtime, ${stableStringify(moduleId)}, ${stableStringify(
     patch
-  )})`;
+  )}))`;
   return [
     {
       kind: "provider_override",

package/dist/index.js

@@ -1,7 +1,7 @@
 import "./chunk-HFUIUVQI.js";
 import {
   LogixDevtools
-} from "./chunk-WTZBDE4J.js";
+} from "./chunk-H5JD2DNC.js";
 import {
   DevtoolsSnapshotStore,
   clearDevtoolsEvents,
@@ -17,7 +17,7 @@ import {
   setInstanceLabel,
   subscribeDevtoolsSnapshot,
   subscribeDevtoolsSnapshotToken
-} from "./chunk-FNWHBEXD.js";
+} from "./chunk-NH3EYAZ6.js";
 import "./chunk-AELNVFJN.js";
 import {
   StateTraitGraphView,

package/package.json

@@ -1,6 +1,11 @@
 {
   "name": "@logixjs/devtools-react",
-  "version": "0.0.2",
+  "version": "1.0.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yoyooyooo/logix",
+    "directory": "packages/logix-devtools-react"
+  },
   "license": "Apache-2.0",
   "files": [
     "dist/**"
@@ -28,10 +33,10 @@
   },
   "dependencies": {
     "clsx": "^2.1.1",
-    "effect": "^3.19.8",
+    "effect": "4.0.0-beta.28",
     "framer-motion": "^12.23.26",
     "tailwind-merge": "^3.4.0",
-    "@logixjs/core": "0.0.2"
+    "@logixjs/core": "1.0.0"
   },
   "devDependencies": {
     "@tailwindcss/cli": "^4.1.17",
@@ -45,7 +50,7 @@
     "tsup": "^8.1.0",
     "typescript": "^5.4.5",
     "vitest": "^4.0.15",
-    "@logixjs/react": "0.1.1"
+    "@logixjs/react": "1.0.0"
   },
   "peerDependencies": {
     "react": ">=18.0.0"