@logixjs/react 0.1.0 → 0.1.1

package/dist/ModuleScope.cjs

@@ -34,12 +34,12 @@ __export(ModuleScope_exports, {
 });
 module.exports = __toCommonJS(ModuleScope_exports);
 var import_react10 = __toESM(require("react"), 1);
-var Logix10 = __toESM(require("@logixjs/core"), 1);
+var Logix11 = __toESM(require("@logixjs/core"), 1);
 
 // src/internal/hooks/useModule.ts
 var import_react7 = __toESM(require("react"), 1);
-var Logix7 = __toESM(require("@logixjs/core"), 1);
-var import_effect8 = require("effect");
+var Logix8 = __toESM(require("@logixjs/core"), 1);
+var import_effect7 = require("effect");
 
 // src/internal/hooks/useModuleRuntime.ts
 var import_react4 = require("react");
@@ -1123,55 +1123,71 @@ function useModuleRuntime(handle) {
 // src/internal/hooks/useSelector.ts
 var import_react5 = require("react");
 var import_with_selector = require("use-sync-external-store/shim/with-selector");
-var Logix5 = __toESM(require("@logixjs/core"), 1);
+var Logix6 = __toESM(require("@logixjs/core"), 1);
 
-// src/internal/store/ModuleRuntimeExternalStore.ts
+// src/internal/store/RuntimeExternalStore.ts
+var Logix5 = __toESM(require("@logixjs/core"), 1);
 var import_effect6 = require("effect");
 var storesByRuntime = /* @__PURE__ */ new WeakMap();
 var getStoreMapForRuntime = (runtime) => {
   const cached = storesByRuntime.get(runtime);
   if (cached) return cached;
-  const next = /* @__PURE__ */ new WeakMap();
+  const next = /* @__PURE__ */ new Map();
   storesByRuntime.set(runtime, next);
   return next;
 };
-var getModuleRuntimeExternalStore = (runtime, moduleRuntime, options) => {
-  const byModule = getStoreMapForRuntime(runtime);
-  const cached = byModule.get(moduleRuntime);
+var makeModuleInstanceKey = (moduleId, instanceId) => `${moduleId}::${instanceId}`;
+var makeReadQueryTopicKey = (moduleInstanceKey, selectorId) => `${moduleInstanceKey}::rq:${selectorId}`;
+var getRuntimeStore = (runtime) => Logix5.InternalContracts.getRuntimeStore(runtime);
+var getHostScheduler = (runtime) => Logix5.InternalContracts.getHostScheduler(runtime);
+var getOrCreateStore = (runtime, topicKey, make) => {
+  const map = getStoreMapForRuntime(runtime);
+  const cached = map.get(topicKey);
   if (cached) {
     return cached;
   }
-  let currentState;
+  const created = make();
+  map.set(topicKey, created);
+  return created;
+};
+var removeStore = (runtime, topicKey) => {
+  const map = storesByRuntime.get(runtime);
+  if (!map) return;
+  map.delete(topicKey);
+};
+var makeTopicExternalStore = (args) => {
+  const { runtime, runtimeStore, topicKey } = args;
+  const hostScheduler = getHostScheduler(runtime);
+  let currentVersion;
+  let hasSnapshot = false;
+  let currentSnapshot;
   const listeners = /* @__PURE__ */ new Set();
-  const lowPriorityDelayMs = options?.lowPriorityDelayMs ?? 16;
-  const lowPriorityMaxDelayMs = options?.lowPriorityMaxDelayMs ?? 50;
+  let unsubscribeFromRuntimeStore;
+  const lowPriorityDelayMs = args.options?.lowPriorityDelayMs ?? 16;
+  const lowPriorityMaxDelayMs = args.options?.lowPriorityMaxDelayMs ?? 50;
   let notifyScheduled = false;
   let notifyScheduledLow = false;
-  let lowTimeoutId;
-  let lowMaxTimeoutId;
-  let lowRafId;
+  let lowCancelDelay;
+  let lowCancelMaxDelay;
+  let lowCancelRaf;
   const cancelLow = () => {
     if (!notifyScheduledLow) return;
     notifyScheduledLow = false;
-    if (lowTimeoutId != null) {
-      clearTimeout(lowTimeoutId);
-      lowTimeoutId = void 0;
-    }
-    if (lowMaxTimeoutId != null) {
-      clearTimeout(lowMaxTimeoutId);
-      lowMaxTimeoutId = void 0;
-    }
-    const cancel = globalThis.cancelAnimationFrame;
-    if (cancel && typeof lowRafId === "number") {
-      cancel(lowRafId);
-      lowRafId = void 0;
-    }
+    lowCancelDelay?.();
+    lowCancelDelay = void 0;
+    lowCancelMaxDelay?.();
+    lowCancelMaxDelay = void 0;
+    lowCancelRaf?.();
+    lowCancelRaf = void 0;
   };
   const flushNotify = () => {
     notifyScheduled = false;
     cancelLow();
     for (const listener of listeners) {
-      listener();
+      try {
+        listener();
+      } catch {
+      }
     }
   };
   const scheduleNotify = (priority) => {
@@ -1183,72 +1199,135 @@ var getModuleRuntimeExternalStore = (runtime, moduleRuntime, options) => {
         if (!notifyScheduledLow) return;
         flushNotify();
       };
-      const raf = globalThis.requestAnimationFrame;
-      if (raf) {
-        lowRafId = raf(flush);
+      const scheduleRaf = () => {
+        if (!notifyScheduledLow) return;
+        lowCancelRaf = hostScheduler.scheduleAnimationFrame(flush);
+      };
+      if (lowPriorityDelayMs <= 0) {
+        scheduleRaf();
       } else {
-        lowTimeoutId = setTimeout(flush, lowPriorityDelayMs);
+        lowCancelDelay = hostScheduler.scheduleTimeout(lowPriorityDelayMs, scheduleRaf);
       }
-      lowMaxTimeoutId = setTimeout(flush, lowPriorityMaxDelayMs);
+      lowCancelMaxDelay = hostScheduler.scheduleTimeout(lowPriorityMaxDelayMs, flush);
       return;
     }
     cancelLow();
     if (notifyScheduled) return;
     notifyScheduled = true;
-    queueMicrotask(flushNotify);
+    hostScheduler.scheduleMicrotask(flushNotify);
+  };
+  const onRuntimeStoreChange = () => {
+    try {
+      scheduleNotify(runtimeStore.getTopicPriority(topicKey));
+    } catch {
+    }
   };
-  let fiber;
   const ensureSubscription = () => {
-    if (fiber) return;
-    fiber = runtime.runFork(
-      import_effect6.Stream.runForEach(
-        moduleRuntime.changesWithMeta((state) => state),
-        ({ value: state, meta }) => import_effect6.Effect.sync(() => {
-          currentState = state;
-          scheduleNotify(meta.priority);
-        })
-      )
-    );
+    if (unsubscribeFromRuntimeStore) return;
+    unsubscribeFromRuntimeStore = runtimeStore.subscribeTopic(topicKey, onRuntimeStoreChange);
   };
   const refreshSnapshotIfStale = () => {
-    if (currentState === void 0) {
-      return;
-    }
+    if (!hasSnapshot) return;
     try {
-      const latest = runtime.runSync(moduleRuntime.getState);
-      if (currentState === void 0 || !Object.is(currentState, latest)) {
-        currentState = latest;
-        scheduleNotify("normal");
+      const version = runtimeStore.getTopicVersion(topicKey);
+      if (currentVersion !== version) {
+        scheduleNotify(runtimeStore.getTopicPriority(topicKey));
       }
     } catch {
     }
   };
   const getSnapshot = () => {
-    if (currentState !== void 0) return currentState;
-    currentState = runtime.runSync(moduleRuntime.getState);
-    return currentState;
+    const version = runtimeStore.getTopicVersion(topicKey);
+    if (hasSnapshot && currentVersion === version) {
+      return currentSnapshot;
+    }
+    const next = args.readSnapshot();
+    currentVersion = version;
+    hasSnapshot = true;
+    currentSnapshot = next;
+    return next;
   };
   const subscribe = (listener) => {
+    const isFirst = listeners.size === 0;
     listeners.add(listener);
     ensureSubscription();
     refreshSnapshotIfStale();
+    if (isFirst) {
+      try {
+        args.onFirstListener?.();
+      } catch {
+      }
+    }
     return () => {
       listeners.delete(listener);
       if (listeners.size > 0) return;
-      const running = fiber;
-      if (!running) return;
-      fiber = void 0;
+      try {
+        args.onLastListener?.();
+      } catch {
+      }
+      const unsub = unsubscribeFromRuntimeStore;
+      unsubscribeFromRuntimeStore = void 0;
       cancelLow();
-      runtime.runFork(import_effect6.Fiber.interrupt(running));
+      try {
+        unsub?.();
+      } catch {
+      }
+      removeStore(runtime, topicKey);
     };
   };
-  const store = { getSnapshot, subscribe };
-  byModule.set(moduleRuntime, store);
-  return store;
+  return { getSnapshot, getServerSnapshot: getSnapshot, subscribe };
+};
+var getRuntimeModuleExternalStore = (runtime, moduleRuntime, options) => {
+  const moduleInstanceKey = makeModuleInstanceKey(moduleRuntime.moduleId, moduleRuntime.instanceId);
+  const runtimeStore = getRuntimeStore(runtime);
+  return getOrCreateStore(
+    runtime,
+    moduleInstanceKey,
+    () => makeTopicExternalStore({
+      runtime,
+      runtimeStore,
+      topicKey: moduleInstanceKey,
+      readSnapshot: () => {
+        const state = runtimeStore.getModuleState(moduleInstanceKey);
+        if (state !== void 0) return state;
+        return runtime.runSync(moduleRuntime.getState);
+      },
+      options
+    })
+  );
+};
+var getRuntimeReadQueryExternalStore = (runtime, moduleRuntime, selectorReadQuery, options) => {
+  const moduleInstanceKey = makeModuleInstanceKey(moduleRuntime.moduleId, moduleRuntime.instanceId);
+  const topicKey = makeReadQueryTopicKey(moduleInstanceKey, selectorReadQuery.selectorId);
+  const runtimeStore = getRuntimeStore(runtime);
+  let readQueryDrainFiber;
+  return getOrCreateStore(
+    runtime,
+    topicKey,
+    () => makeTopicExternalStore({
+      runtime,
+      runtimeStore,
+      topicKey,
+      readSnapshot: () => {
+        const state = runtimeStore.getModuleState(moduleInstanceKey);
+        const current = state ?? runtime.runSync(moduleRuntime.getState);
+        return selectorReadQuery.select(current);
+      },
+      options,
+      onFirstListener: () => {
+        if (readQueryDrainFiber) return;
+        const effect = import_effect6.Stream.runDrain(moduleRuntime.changesReadQueryWithMeta(selectorReadQuery));
+        readQueryDrainFiber = runtime.runFork(effect);
+      },
+      onLastListener: () => {
+        const fiber = readQueryDrainFiber;
+        if (!fiber) return;
+        readQueryDrainFiber = void 0;
+        runtime.runFork(import_effect6.Fiber.interrupt(fiber));
+      }
+    })
+  );
 };
-
-// src/internal/store/ModuleRuntimeSelectorExternalStore.ts
-var import_effect7 = require("effect");
 
 // src/internal/hooks/shallow.ts
 var hasObjectShape = (value) => typeof value === "object" && value !== null;
@@ -1300,146 +1379,6 @@ var shallow = (previous, next) => {
   return true;
 };
 
-// src/internal/store/ModuleRuntimeSelectorExternalStore.ts
-var storesByRuntime2 = /* @__PURE__ */ new WeakMap();
-var getStoreMapForRuntime2 = (runtime) => {
-  const cached = storesByRuntime2.get(runtime);
-  if (cached) return cached;
-  const next = /* @__PURE__ */ new WeakMap();
-  storesByRuntime2.set(runtime, next);
-  return next;
-};
-var getOrCreateSelectorMapForModule = (byModule, moduleRuntime) => {
-  const cached = byModule.get(moduleRuntime);
-  if (cached) return cached;
-  const next = /* @__PURE__ */ new Map();
-  byModule.set(moduleRuntime, next);
-  return next;
-};
-var equalsValue = (readQuery, a, b) => {
-  if (readQuery.equalsKind === "custom" && typeof readQuery.equals === "function") {
-    return readQuery.equals(a, b);
-  }
-  if (readQuery.equalsKind === "shallowStruct") {
-    return shallow(a, b);
-  }
-  return Object.is(a, b);
-};
-var getModuleRuntimeSelectorExternalStore = (runtime, moduleRuntime, selectorReadQuery, options) => {
-  const byModule = getStoreMapForRuntime2(runtime);
-  const bySelector = getOrCreateSelectorMapForModule(byModule, moduleRuntime);
-  const cached = bySelector.get(selectorReadQuery.selectorId);
-  if (cached) {
-    return cached;
-  }
-  let currentValue;
-  const listeners = /* @__PURE__ */ new Set();
-  const lowPriorityDelayMs = options?.lowPriorityDelayMs ?? 16;
-  const lowPriorityMaxDelayMs = options?.lowPriorityMaxDelayMs ?? 50;
-  let notifyScheduled = false;
-  let notifyScheduledLow = false;
-  let lowTimeoutId;
-  let lowMaxTimeoutId;
-  let lowRafId;
-  const cancelLow = () => {
-    if (!notifyScheduledLow) return;
-    notifyScheduledLow = false;
-    if (lowTimeoutId != null) {
-      clearTimeout(lowTimeoutId);
-      lowTimeoutId = void 0;
-    }
-    if (lowMaxTimeoutId != null) {
-      clearTimeout(lowMaxTimeoutId);
-      lowMaxTimeoutId = void 0;
-    }
-    const cancel = globalThis.cancelAnimationFrame;
-    if (cancel && typeof lowRafId === "number") {
-      cancel(lowRafId);
-      lowRafId = void 0;
-    }
-  };
-  const flushNotify = () => {
-    notifyScheduled = false;
-    cancelLow();
-    for (const listener of listeners) {
-      listener();
-    }
-  };
-  const scheduleNotify = (priority) => {
-    if (priority === "low") {
-      if (notifyScheduled) return;
-      if (notifyScheduledLow) return;
-      notifyScheduledLow = true;
-      const flush = () => {
-        if (!notifyScheduledLow) return;
-        flushNotify();
-      };
-      const raf = globalThis.requestAnimationFrame;
-      if (raf) {
-        lowRafId = raf(flush);
-      } else {
-        lowTimeoutId = setTimeout(flush, lowPriorityDelayMs);
-      }
-      lowMaxTimeoutId = setTimeout(flush, lowPriorityMaxDelayMs);
-      return;
-    }
-    cancelLow();
-    if (notifyScheduled) return;
-    notifyScheduled = true;
-    queueMicrotask(flushNotify);
-  };
-  let fiber;
-  const ensureSubscription = () => {
-    if (fiber) return;
-    fiber = runtime.runFork(
-      import_effect7.Stream.runForEach(
-        moduleRuntime.changesReadQueryWithMeta(selectorReadQuery),
-        ({ value, meta }) => import_effect7.Effect.sync(() => {
-          currentValue = value;
-          scheduleNotify(meta.priority);
-        })
-      )
-    );
-  };
-  const refreshSnapshotIfStale = () => {
-    if (currentValue === void 0) {
-      return;
-    }
-    try {
-      const state = runtime.runSync(moduleRuntime.getState);
-      const next = selectorReadQuery.select(state);
-      if (currentValue === void 0 || !equalsValue(selectorReadQuery, currentValue, next)) {
-        currentValue = next;
-        scheduleNotify("normal");
-      }
-    } catch {
-    }
-  };
-  const getSnapshot = () => {
-    if (currentValue !== void 0) return currentValue;
-    const state = runtime.runSync(moduleRuntime.getState);
-    currentValue = selectorReadQuery.select(state);
-    return currentValue;
-  };
-  const subscribe = (listener) => {
-    listeners.add(listener);
-    ensureSubscription();
-    refreshSnapshotIfStale();
-    return () => {
-      listeners.delete(listener);
-      if (listeners.size > 0) return;
-      const running = fiber;
-      if (!running) return;
-      fiber = void 0;
-      cancelLow();
-      runtime.runFork(import_effect7.Fiber.interrupt(running));
-    };
-  };
-  const store = { getSnapshot, subscribe };
-  bySelector.set(selectorReadQuery.selectorId, store);
-  return store;
-};
-
 // src/internal/hooks/useSelector.ts
 function useSelector(handle, selector, equalityFn) {
   const runtimeContext = (0, import_react5.useContext)(RuntimeContext);
@@ -1450,7 +1389,7 @@ function useSelector(handle, selector, equalityFn) {
   const moduleRuntime = useModuleRuntime(handle);
   const actualSelector = selector ?? ((state) => state);
   const selectorReadQuery = (0, import_react5.useMemo)(
-    () => typeof selector === "function" ? Logix5.ReadQuery.compile(selector) : void 0,
+    () => typeof selector === "function" ? Logix6.ReadQuery.compile(selector) : void 0,
     [selector]
   );
   const actualEqualityFn = (0, import_react5.useMemo)(() => {
@@ -1458,17 +1397,12 @@ function useSelector(handle, selector, equalityFn) {
     if (typeof selector !== "function") return Object.is;
     return selectorReadQuery?.equalsKind === "shallowStruct" ? shallow : Object.is;
   }, [equalityFn, selector, selectorReadQuery?.equalsKind]);
-  const useStaticLane = typeof selector === "function" && selectorReadQuery?.lane === "static";
+  const selectorTopicEligible = typeof selector === "function" && selectorReadQuery?.lane === "static" && selectorReadQuery.readsDigest != null && selectorReadQuery.fallbackReason == null;
   const store = (0, import_react5.useMemo)(
-    () => useStaticLane && selectorReadQuery ? getModuleRuntimeSelectorExternalStore(
-      runtime,
-      moduleRuntime,
-      selectorReadQuery,
-      {
-        lowPriorityDelayMs: runtimeContext.reactConfigSnapshot.lowPriorityDelayMs,
-        lowPriorityMaxDelayMs: runtimeContext.reactConfigSnapshot.lowPriorityMaxDelayMs
-      }
-    ) : getModuleRuntimeExternalStore(
+    () => selectorTopicEligible && selectorReadQuery ? getRuntimeReadQueryExternalStore(runtime, moduleRuntime, selectorReadQuery, {
+      lowPriorityDelayMs: runtimeContext.reactConfigSnapshot.lowPriorityDelayMs,
+      lowPriorityMaxDelayMs: runtimeContext.reactConfigSnapshot.lowPriorityMaxDelayMs
+    }) : getRuntimeModuleExternalStore(
       runtime,
       moduleRuntime,
       {
@@ -1482,18 +1416,18 @@ function useSelector(handle, selector, equalityFn) {
       runtimeContext.reactConfigSnapshot.lowPriorityDelayMs,
       runtimeContext.reactConfigSnapshot.lowPriorityMaxDelayMs,
       selectorReadQuery,
-      useStaticLane
+      selectorTopicEligible
     ]
   );
   const selected = (0, import_with_selector.useSyncExternalStoreWithSelector)(
     store.subscribe,
     store.getSnapshot,
-    store.getSnapshot,
-    useStaticLane ? (snapshot) => snapshot : (snapshot) => actualSelector(snapshot),
+    store.getServerSnapshot ?? store.getSnapshot,
+    selectorTopicEligible ? (snapshot) => snapshot : (snapshot) => actualSelector(snapshot),
     actualEqualityFn
   );
   (0, import_react5.useEffect)(() => {
-    if (!(0, import_Env.isDevEnv)() && !Logix5.Debug.isDevtoolsEnabled()) {
+    if (!(0, import_Env.isDevEnv)() && !Logix6.Debug.isDevtoolsEnabled()) {
       return;
     }
     const instanceId = moduleRuntime.instanceId;
@@ -1509,7 +1443,7 @@ function useSelector(handle, selector, equalityFn) {
       const rawDebugKey = meta.debugKey;
       selectorKey = typeof rawDebugKey === "string" && rawDebugKey.length > 0 ? rawDebugKey : typeof selector.name === "string" && selector.name.length > 0 ? selector.name : void 0;
     }
-    const effect = Logix5.Debug.record({
+    const effect = Logix6.Debug.record({
       type: "trace:react-selector",
       moduleId: moduleRuntime.moduleId,
       instanceId,
@@ -1532,7 +1466,7 @@ function useSelector(handle, selector, equalityFn) {
 }
 
 // src/internal/store/resolveImportedModuleRef.ts
-var Logix6 = __toESM(require("@logixjs/core"), 1);
+var Logix7 = __toESM(require("@logixjs/core"), 1);
 var getOrCreateWeakMap = (map, key, make) => {
   const cached = map.get(key);
   if (cached) return cached;
@@ -1556,7 +1490,7 @@ var resolveImportedModuleRef = (runtime, parentRuntime, module2) => {
   if (cached) {
     return cached;
   }
-  const importsScope = Logix6.InternalContracts.getImportsScope(parentRuntime);
+  const importsScope = Logix7.InternalContracts.getImportsScope(parentRuntime);
   const childRuntime = importsScope.get(module2);
   if (childRuntime) {
     const dispatch = Object.assign(
@@ -1642,8 +1576,8 @@ var useStableId = () => {
 
 // src/internal/hooks/useModule.ts
 var isModuleImpl = (handle) => Boolean(handle) && typeof handle === "object" && handle._tag === "ModuleImpl";
-var isModule = (handle) => Logix7.Module.hasImpl(handle);
-var isModuleDef = (handle) => Logix7.Module.is(handle) && handle._kind === "ModuleDef";
+var isModule = (handle) => Logix8.Module.hasImpl(handle);
+var isModuleDef = (handle) => Logix8.Module.is(handle) && handle._kind === "ModuleDef";
 function useModule(handle, selectorOrOptions, equalityFn) {
   const runtimeBase = useRuntime();
   const runtimeContext = import_react7.default.useContext(RuntimeContext);
@@ -1695,9 +1629,9 @@ function useModule(handle, selectorOrOptions, equalityFn) {
     const key = depsHash ? `${baseKey}:${depsHash}` : baseKey;
     const ownerId = moduleId;
     const baseFactory = import_react7.default.useMemo(
-      () => (scope) => import_effect8.Layer.buildWithScope(normalizedHandle.layer, scope).pipe(
-        import_effect8.Effect.map(
-          (context) => import_effect8.Context.get(context, normalizedHandle.module)
+      () => (scope) => import_effect7.Layer.buildWithScope(normalizedHandle.layer, scope).pipe(
+        import_effect7.Effect.map(
+          (context) => import_effect7.Context.get(context, normalizedHandle.module)
         )
       ),
       [normalizedHandle]
@@ -1707,7 +1641,7 @@ function useModule(handle, selectorOrOptions, equalityFn) {
         return baseFactory;
       }
       return (scope) => baseFactory(scope).pipe(
-        import_effect8.Effect.timeoutFail({
+        import_effect7.Effect.timeoutFail({
           duration: initTimeoutMs,
           onTimeout: () => new Error(`[useModule] Module "${ownerId}" initialization timed out after ${initTimeoutMs}ms`)
         })
@@ -1736,7 +1670,7 @@ function useModule(handle, selectorOrOptions, equalityFn) {
     if (!label) {
       return;
     }
-    const effect = Logix7.Debug.record({
+    const effect = Logix8.Debug.record({
       type: "trace:instanceLabel",
       moduleId: normalizedHandle.module.id,
       instanceId: runtime.instanceId,
@@ -1745,13 +1679,13 @@ function useModule(handle, selectorOrOptions, equalityFn) {
     runtimeBase.runFork(effect);
   }, [runtimeBase, runtime, normalizedHandle, options]);
   import_react7.default.useEffect(() => {
-    if (!(0, import_Env.isDevEnv)() && !Logix7.Debug.isDevtoolsEnabled()) {
+    if (!(0, import_Env.isDevEnv)() && !Logix8.Debug.isDevtoolsEnabled()) {
       return;
     }
     if (!runtime.instanceId) {
       return;
     }
-    const effect = Logix7.Debug.record({
+    const effect = Logix8.Debug.record({
       type: "trace:react-render",
       moduleId: runtime.moduleId,
       instanceId: runtime.instanceId,
@@ -1848,12 +1782,12 @@ function useModule(handle, selectorOrOptions, equalityFn) {
 
 // src/internal/provider/RuntimeProvider.tsx
 var import_react9 = __toESM(require("react"), 1);
-var import_effect10 = require("effect");
-var Logix9 = __toESM(require("@logixjs/core"), 1);
+var import_effect9 = require("effect");
+var Logix10 = __toESM(require("@logixjs/core"), 1);
 
 // src/internal/provider/config.ts
-var import_effect9 = require("effect");
-var ReactRuntimeConfigTag = class extends import_effect9.Context.Tag("@logixjs/react/RuntimeConfig")() {
+var import_effect8 = require("effect");
+var ReactRuntimeConfigTag = class extends import_effect8.Context.Tag("@logixjs/react/RuntimeConfig")() {
 };
 var DEFAULT_CONFIG = {
   gcTime: 500,
@@ -1874,58 +1808,58 @@ var ReactModuleConfigFromEnv = {
    * - Applies when not explicitly specified in useModule(options.gcTime).
    * - Default: 500ms (StrictMode jitter protection).
    */
-  gcTime: import_effect9.Config.number("logix.react.gc_time").pipe(import_effect9.Config.withDefault(DEFAULT_CONFIG.gcTime)),
+  gcTime: import_effect8.Config.number("logix.react.gc_time").pipe(import_effect8.Config.withDefault(DEFAULT_CONFIG.gcTime)),
   /**
    * Default init timeout (ms), only effective when suspend:true.
    * - Uses Option<number> to represent "optional config": missing means init timeout is disabled.
    * - Callers can map Option.none to undefined.
    */
-  initTimeoutMs: import_effect9.Config.option(import_effect9.Config.number("logix.react.init_timeout_ms")),
+  initTimeoutMs: import_effect8.Config.option(import_effect8.Config.number("logix.react.init_timeout_ms")),
   /**
    * Delay (ms) for low-priority notification scheduling.
    * - Roughly "defer to the next frame" cadence (default 16ms).
    */
-  lowPriorityDelayMs: import_effect9.Config.number("logix.react.low_priority_delay_ms").pipe(
-    import_effect9.Config.withDefault(DEFAULT_CONFIG.lowPriorityDelayMs ?? 16)
+  lowPriorityDelayMs: import_effect8.Config.number("logix.react.low_priority_delay_ms").pipe(
+    import_effect8.Config.withDefault(DEFAULT_CONFIG.lowPriorityDelayMs ?? 16)
   ),
   /**
    * Maximum delay upper bound (ms) for low-priority notification scheduling.
    * - Ensures eventual delivery, avoiding indefinite coalescing under extreme high-frequency scenarios.
    * - Default 50ms.
    */
-  lowPriorityMaxDelayMs: import_effect9.Config.number("logix.react.low_priority_max_delay_ms").pipe(
-    import_effect9.Config.withDefault(DEFAULT_CONFIG.lowPriorityMaxDelayMs ?? 50)
+  lowPriorityMaxDelayMs: import_effect8.Config.number("logix.react.low_priority_max_delay_ms").pipe(
+    import_effect8.Config.withDefault(DEFAULT_CONFIG.lowPriorityMaxDelayMs ?? 50)
   )
 };
 var ReactModuleConfig = {
-  gcTime: import_effect9.Effect.gen(function* () {
-    const override = yield* import_effect9.Effect.serviceOption(ReactRuntimeConfigTag);
-    if (import_effect9.Option.isSome(override)) {
+  gcTime: import_effect8.Effect.gen(function* () {
+    const override = yield* import_effect8.Effect.serviceOption(ReactRuntimeConfigTag);
+    if (import_effect8.Option.isSome(override)) {
       return override.value.gcTime;
     }
     const value = yield* ReactModuleConfigFromEnv.gcTime;
     return value;
   }),
-  initTimeoutMs: import_effect9.Effect.gen(function* () {
-    const override = yield* import_effect9.Effect.serviceOption(ReactRuntimeConfigTag);
-    if (import_effect9.Option.isSome(override)) {
+  initTimeoutMs: import_effect8.Effect.gen(function* () {
+    const override = yield* import_effect8.Effect.serviceOption(ReactRuntimeConfigTag);
+    if (import_effect8.Option.isSome(override)) {
       const v = override.value.initTimeoutMs;
-      return v === void 0 ? import_effect9.Option.none() : import_effect9.Option.some(v);
+      return v === void 0 ? import_effect8.Option.none() : import_effect8.Option.some(v);
     }
     const opt = yield* ReactModuleConfigFromEnv.initTimeoutMs;
     return opt;
   }),
-  lowPriorityDelayMs: import_effect9.Effect.gen(function* () {
-    const override = yield* import_effect9.Effect.serviceOption(ReactRuntimeConfigTag);
-    if (import_effect9.Option.isSome(override)) {
+  lowPriorityDelayMs: import_effect8.Effect.gen(function* () {
+    const override = yield* import_effect8.Effect.serviceOption(ReactRuntimeConfigTag);
+    if (import_effect8.Option.isSome(override)) {
       return override.value.lowPriorityDelayMs ?? DEFAULT_CONFIG.lowPriorityDelayMs ?? 16;
     }
     const value = yield* ReactModuleConfigFromEnv.lowPriorityDelayMs;
     return value;
   }),
-  lowPriorityMaxDelayMs: import_effect9.Effect.gen(function* () {
-    const override = yield* import_effect9.Effect.serviceOption(ReactRuntimeConfigTag);
-    if (import_effect9.Option.isSome(override)) {
+  lowPriorityMaxDelayMs: import_effect8.Effect.gen(function* () {
+    const override = yield* import_effect8.Effect.serviceOption(ReactRuntimeConfigTag);
+    if (import_effect8.Option.isSome(override)) {
       return override.value.lowPriorityMaxDelayMs ?? DEFAULT_CONFIG.lowPriorityMaxDelayMs ?? 50;
     }
     const value = yield* ReactModuleConfigFromEnv.lowPriorityMaxDelayMs;
@@ -1933,9 +1867,9 @@ var ReactModuleConfig = {
   })
 };
 var ReactRuntimeConfigSnapshot = {
-  load: import_effect9.Effect.gen(function* () {
-    const runtimeOverride = yield* import_effect9.Effect.serviceOption(ReactRuntimeConfigTag);
-    if (import_effect9.Option.isSome(runtimeOverride)) {
+  load: import_effect8.Effect.gen(function* () {
+    const runtimeOverride = yield* import_effect8.Effect.serviceOption(ReactRuntimeConfigTag);
+    if (import_effect8.Option.isSome(runtimeOverride)) {
       return {
         gcTime: runtimeOverride.value.gcTime,
         initTimeoutMs: runtimeOverride.value.initTimeoutMs,
@@ -1946,10 +1880,10 @@ var ReactRuntimeConfigSnapshot = {
     }
     const envGcTime = yield* ReactModuleConfigFromEnv.gcTime;
     const envInitTimeoutOpt = yield* ReactModuleConfigFromEnv.initTimeoutMs;
-    const envInitTimeout = import_effect9.Option.getOrUndefined(envInitTimeoutOpt);
+    const envInitTimeout = import_effect8.Option.getOrUndefined(envInitTimeoutOpt);
     const envLowPriorityDelayMs = yield* ReactModuleConfigFromEnv.lowPriorityDelayMs;
     const envLowPriorityMaxDelayMs = yield* ReactModuleConfigFromEnv.lowPriorityMaxDelayMs;
-    const fromConfig = envGcTime !== DEFAULT_CONFIG.gcTime || import_effect9.Option.isSome(envInitTimeoutOpt) || envLowPriorityDelayMs !== (DEFAULT_CONFIG.lowPriorityDelayMs ?? 16) || envLowPriorityMaxDelayMs !== (DEFAULT_CONFIG.lowPriorityMaxDelayMs ?? 50);
+    const fromConfig = envGcTime !== DEFAULT_CONFIG.gcTime || import_effect8.Option.isSome(envInitTimeoutOpt) || envLowPriorityDelayMs !== (DEFAULT_CONFIG.lowPriorityDelayMs ?? 16) || envLowPriorityMaxDelayMs !== (DEFAULT_CONFIG.lowPriorityMaxDelayMs ?? 50);
     if (fromConfig) {
       return {
         gcTime: envGcTime,
@@ -1965,7 +1899,7 @@ var ReactRuntimeConfigSnapshot = {
 
 // src/internal/provider/fallback.tsx
 var import_react8 = require("react");
-var Logix8 = __toESM(require("@logixjs/core"), 1);
+var Logix9 = __toESM(require("@logixjs/core"), 1);
 
 // src/internal/provider/docs.ts
 var LOGIX_DOCS_PREFIX_ENV = "LOGIX_DOCS_PREFIX";
@@ -2068,11 +2002,11 @@ var resolveRuntimeProviderFallback = (args) => {
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(DefaultRuntimeFallback, { phase: args.phase, policyMode: args.policyMode });
 };
 var recordFallbackDuration = (args) => {
-  if (!(0, import_Env.isDevEnv)() && !Logix8.Debug.isDevtoolsEnabled()) {
+  if (!(0, import_Env.isDevEnv)() && !Logix9.Debug.isDevtoolsEnabled()) {
     return;
   }
   void args.runtime.runPromise(
-    Logix8.Debug.record({
+    Logix9.Debug.record({
       type: "trace:react.fallback.duration",
       data: {
         phase: args.phase,
@@ -2151,7 +2085,7 @@ var FallbackProbeEnabled = ({ runtime, phase, policyMode, blockers, children })
 };
 var FallbackProbeNoop = ({ children }) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_jsx_runtime.Fragment, { children });
 var FallbackProbe = (props) => {
-  const enabled = (0, import_Env.isDevEnv)() || Logix8.Debug.isDevtoolsEnabled();
+  const enabled = (0, import_Env.isDevEnv)() || Logix9.Debug.isDevtoolsEnabled();
   const Impl = enabled ? FallbackProbeEnabled : FallbackProbeNoop;
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Impl, { ...props });
 };
@@ -2243,6 +2177,20 @@ var RuntimeProvider = ({
   );
   const onErrorRef = import_react9.default.useRef(onError);
   onErrorRef.current = onError;
+  const hasTickServices = (0, import_react9.useMemo)(() => {
+    try {
+      Logix10.InternalContracts.getRuntimeStore(baseRuntime);
+      return true;
+    } catch {
+      return false;
+    }
+  }, [baseRuntime]);
+  const { binding: tickBinding } = useLayerBinding(
+    baseRuntime,
+    Logix10.InternalContracts.tickServicesLayer,
+    !hasTickServices,
+    onErrorRef.current
+  );
   const { binding: layerBinding } = useLayerBinding(baseRuntime, layer, Boolean(layer), onErrorRef.current);
   const onErrorSink = (0, import_react9.useMemo)(() => {
     if (!onError) return null;
@@ -2250,7 +2198,7 @@ var RuntimeProvider = ({
       record: (event) => {
         const handler = onErrorRef.current;
         if (!handler) {
-          return import_effect10.Effect.void;
+          return import_effect9.Effect.void;
         }
         if (event.type === "lifecycle:error") {
           return handler(event.cause, {
@@ -2259,11 +2207,11 @@ var RuntimeProvider = ({
             moduleId: event.moduleId,
             instanceId: event.instanceId,
             runtimeLabel: event.runtimeLabel
-          }).pipe(import_effect10.Effect.catchAllCause(() => import_effect10.Effect.void));
+          }).pipe(import_effect9.Effect.catchAllCause(() => import_effect9.Effect.void));
         }
         if (event.type === "diagnostic" && event.severity === "error") {
           return handler(
-            import_effect10.Cause.fail({
+            import_effect9.Cause.fail({
               code: event.code,
               message: event.message,
               hint: event.hint
@@ -2278,9 +2226,9 @@ var RuntimeProvider = ({
               instanceId: event.instanceId,
               runtimeLabel: event.runtimeLabel
             }
-          ).pipe(import_effect10.Effect.catchAllCause(() => import_effect10.Effect.void));
+          ).pipe(import_effect9.Effect.catchAllCause(() => import_effect9.Effect.void));
         }
-        return import_effect10.Effect.void;
+        return import_effect9.Effect.void;
       }
     };
     return sink;
@@ -2294,24 +2242,24 @@ var RuntimeProvider = ({
     }
     try {
       return baseRuntime.runSync(
-        import_effect10.FiberRef.get(Logix9.Debug.internal.currentDebugSinks)
+        import_effect9.FiberRef.get(Logix10.Debug.internal.currentDebugSinks)
       );
     } catch {
       return [];
     }
   }, [baseRuntime, layerBinding, onErrorSink]);
   const runtimeWithBindings = (0, import_react9.useMemo)(
-    () => layerBinding || onErrorSink ? createRuntimeAdapter(
+    () => tickBinding || layerBinding || onErrorSink ? createRuntimeAdapter(
       baseRuntime,
-      layerBinding ? [layerBinding.context] : [],
-      layerBinding ? [layerBinding.scope] : [],
-      layerBinding ? [layerBinding.loggers] : [],
-      layerBinding ? [layerBinding.logLevel] : [],
+      [...tickBinding ? [tickBinding.context] : [], ...layerBinding ? [layerBinding.context] : []],
+      [...tickBinding ? [tickBinding.scope] : [], ...layerBinding ? [layerBinding.scope] : []],
+      layerBinding ? [layerBinding.loggers] : tickBinding ? [tickBinding.loggers] : [],
+      layerBinding ? [layerBinding.logLevel] : tickBinding ? [tickBinding.logLevel] : [],
       [
         onErrorSink ? [onErrorSink, ...inheritedDebugSinks] : layerBinding ? layerBinding.debugSinks : []
       ]
     ) : baseRuntime,
-    [baseRuntime, inheritedDebugSinks, layerBinding, onErrorSink]
+    [baseRuntime, inheritedDebugSinks, layerBinding, onErrorSink, tickBinding]
   );
   const didReportSyncConfigSnapshotRef = import_react9.default.useRef(false);
   const [configState, setConfigState] = (0, import_react9.useState)(() => {
@@ -2353,7 +2301,7 @@ var RuntimeProvider = ({
     }
     didReportSyncConfigSnapshotRef.current = true;
     void runtimeWithBindings.runPromise(
-      Logix9.Debug.record({
+      Logix10.Debug.record({
         type: "trace:react.runtime.config.snapshot",
         data: {
           source: configState.snapshot.source,
@@ -2384,7 +2332,7 @@ var RuntimeProvider = ({
         };
       });
       void runtimeWithBindings.runPromise(
-        Logix9.Debug.record({
+        Logix10.Debug.record({
           type: "trace:react.runtime.config.snapshot",
           data: {
             source: snapshot.source,
@@ -2416,6 +2364,7 @@ var RuntimeProvider = ({
     }),
     [runtimeWithBindings, configState, resolvedPolicy]
   );
+  const isTickServicesReady = hasTickServices || tickBinding !== null;
   const isLayerReady = !layer || layerBinding !== null;
   const isConfigReady = configState.loaded;
   const resolveFallback = (phase) => {
@@ -2460,8 +2409,8 @@ var RuntimeProvider = ({
         if (handle?._tag === "ModuleImpl") {
           const moduleId = handle.module?.id ?? "ModuleImpl";
           const key2 = resolvedPolicy.preload.keysByModuleId.get(moduleId) ?? getPreloadKeyForModuleId(moduleId);
-          const factory2 = (scope) => import_effect10.Layer.buildWithScope(handle.layer, scope).pipe(
-            import_effect10.Effect.map((context) => import_effect10.Context.get(context, handle.module))
+          const factory2 = (scope) => import_effect9.Layer.buildWithScope(handle.layer, scope).pipe(
+            import_effect9.Effect.map((context) => import_effect9.Context.get(context, handle.module))
           );
           const op2 = cache.preload(key2, factory2, {
             ownerId: moduleId,
@@ -2473,7 +2422,7 @@ var RuntimeProvider = ({
           await op2.promise;
           const durationMs2 = performance.now() - startedAt;
           void runtimeWithBindings.runPromise(
-            Logix9.Debug.record({
+            Logix10.Debug.record({
               type: "trace:react.module.preload",
               moduleId,
               data: {
@@ -2493,7 +2442,7 @@ var RuntimeProvider = ({
         const tagId = handle.id ?? "ModuleTag";
         const key = resolvedPolicy.preload.keysByTagId.get(tagId) ?? getPreloadKeyForTagId(tagId);
         const factory = (scope) => handle.pipe(
-          import_effect10.Scope.extend(scope)
+          import_effect9.Scope.extend(scope)
         );
         const op = cache.preload(key, factory, {
           ownerId: tagId,
@@ -2505,7 +2454,7 @@ var RuntimeProvider = ({
         await op.promise;
         const durationMs = performance.now() - startedAt;
         void runtimeWithBindings.runPromise(
-          Logix9.Debug.record({
+          Logix10.Debug.record({
             type: "trace:react.module.preload",
             data: {
               mode: "defer",
@@ -2537,7 +2486,7 @@ var RuntimeProvider = ({
       if (cancelled) return;
       if (onErrorRef.current) {
         runtimeWithBindings.runFork(
-          onErrorRef.current(import_effect10.Cause.die(error), { source: "provider", phase: "provider.layer.build" }).pipe(import_effect10.Effect.catchAllCause(() => import_effect10.Effect.void))
+          onErrorRef.current(import_effect9.Cause.die(error), { source: "provider", phase: "provider.layer.build" }).pipe(import_effect9.Effect.catchAllCause(() => import_effect9.Effect.void))
         );
       }
       setDeferReady(true);
@@ -2570,9 +2519,10 @@ var RuntimeProvider = ({
       release();
     };
   }, [resolvedPolicy.mode, deferReady]);
-  const isReady = isLayerReady && isConfigReady && (resolvedPolicy.mode !== "defer" || deferReady);
+  const isReady = isTickServicesReady && isLayerReady && isConfigReady && (resolvedPolicy.mode !== "defer" || deferReady);
   if (!isReady) {
     const blockersList = [
+      isTickServicesReady ? null : "tick",
       isLayerReady ? null : "layer",
       isConfigReady ? null : "config",
       resolvedPolicy.mode !== "defer" || deferReady ? null : "preload"
@@ -2617,7 +2567,7 @@ var makeModuleScope = (handle, defaults) => {
   };
   const getRegistryOrThrow = (runtime, where) => {
     try {
-      const registry = runtime.runSync(Logix10.ScopeRegistry.ScopeRegistryTag);
+      const registry = runtime.runSync(Logix11.ScopeRegistry.ScopeRegistryTag);
       if (!registry) {
         throw new Error("ScopeRegistry service is undefined");
       }
@@ -2628,7 +2578,7 @@ var makeModuleScope = (handle, defaults) => {
       );
     }
   };
-  const moduleToken = Logix10.Module.hasImpl(handle) ? handle.tag : handle.module;
+  const moduleToken = Logix11.Module.hasImpl(handle) ? handle.tag : handle.module;
   const Provider = ({ children, options }) => {
     const runtime = useRuntime();
     const merged = defaults || options ? { ...defaults ?? {}, ...options ?? {} } : void 0;
@@ -2637,7 +2587,7 @@ var makeModuleScope = (handle, defaults) => {
     import_react10.default.useEffect(() => {
       if (!scopeId) return;
       const registry = getRegistryOrThrow(runtime, "[ModuleScope]");
-      const leaseRuntime = registry.register(scopeId, Logix10.ScopeRegistry.ScopedRuntimeTag, runtime);
+      const leaseRuntime = registry.register(scopeId, Logix11.ScopeRegistry.ScopedRuntimeTag, runtime);
       const leaseModule = registry.register(scopeId, moduleToken, ref.runtime);
       return () => {
         leaseModule.release();
@@ -2660,11 +2610,8 @@ var makeModuleScope = (handle, defaults) => {
   const Bridge = ({ scopeId, children }) => {
     const runtime = useRuntime();
     const registry = getRegistryOrThrow(runtime, "[ModuleScope.Bridge]");
-    const scopedRuntime = registry.get(scopeId, Logix10.ScopeRegistry.ScopedRuntimeTag);
-    const moduleRuntime = registry.get(
-      scopeId,
-      moduleToken
-    );
+    const scopedRuntime = registry.get(scopeId, Logix11.ScopeRegistry.ScopedRuntimeTag);
+    const moduleRuntime = registry.get(scopeId, moduleToken);
     if (!scopedRuntime || !moduleRuntime) {
       throw new Error(
         `[ModuleScope.Bridge] Scope "${scopeId}" is not registered (or has been disposed). Ensure you have a corresponding <ModuleScope.Provider options={{ scopeId }}> mounted.`