@reckona/mreact-reactive-core 0.0.135 → 0.0.137

package/README.md

@@ -38,6 +38,20 @@ dispose();
 - `batchAsync()` groups updates across `await` points into one flush. Use it only around intentionally scoped async work because reactive flushes are deferred until the callback settles.
 - `untrack()` reads values without subscribing.
 
+## Update Scheduling
+
+`cell.set()` updates the stored value immediately and propagates `computed` invalidation synchronously, but effects (including the DOM bindings emitted by the compiler) run in a single microtask scheduled at the first update. Reads through `.get()` always observe the latest value even before that flush runs.
+
+Because browsers drain the microtask queue before any rendering steps, this scheduling is compatible with `document.startViewTransition()`: a `cell.set()` made inside the update callback is committed to the DOM before the browser captures the new-state snapshot, so no `flushSync` wrapper is required.
+
+```ts
+document.startViewTransition(() => {
+  selectedMediaId.set(mediaId);
+});
+```
+
+If you need the DOM committed synchronously before the current task continues, for example to measure layout right after an update, wrap the update in `flushSync` from the React DOM-compatible entrypoint (`react-dom` in mreact apps, `@reckona/mreact-dom` standalone), which drains pending reactive computations before returning. Updates deferred through `startTransition` or `useDeferredValue` run on a macrotask scheduler and are not guaranteed to land inside a view transition capture.
+
 ## Testing
 
 `@reckona/mreact-reactive-core/testing` exports `flushMicrotasks()` and

package/dist/internal.d.ts

@@ -1,5 +1,6 @@
 export type { Scheduler } from "./scheduler.js";
 export { registerCleanup, withCleanupScope } from "./cleanup-scope.js";
 export { flushQueuedComputations, schedulePendingFlush, setScheduler } from "./scheduler.js";
+export { flushPendingComputed } from "./tracking.js";
 export { getGlobalRuntimeState } from "./runtime-state.js";
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/internal.js

@@ -1,4 +1,5 @@
 export { registerCleanup, withCleanupScope } from "./cleanup-scope.js";
 export { flushQueuedComputations, schedulePendingFlush, setScheduler } from "./scheduler.js";
+export { flushPendingComputed } from "./tracking.js";
 export { getGlobalRuntimeState } from "./runtime-state.js";
 //# sourceMappingURL=internal.js.map

package/dist/internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["export type { Scheduler } from \"./scheduler.js\";\nexport { registerCleanup, withCleanupScope } from \"./cleanup-scope.js\";\nexport { flushQueuedComputations, schedulePendingFlush, setScheduler } from \"./scheduler.js\";\nexport { getGlobalRuntimeState } from \"./runtime-state.js\";\n"]}
+{"version":3,"file":"internal.js","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACvE,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC","sourcesContent":["export type { Scheduler } from \"./scheduler.js\";\nexport { registerCleanup, withCleanupScope } from \"./cleanup-scope.js\";\nexport { flushQueuedComputations, schedulePendingFlush, setScheduler } from \"./scheduler.js\";\nexport { flushPendingComputed } from \"./tracking.js\";\nexport { getGlobalRuntimeState } from \"./runtime-state.js\";\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reckona/mreact-reactive-core",
-  "version": "0.0.135",
+  "version": "0.0.137",
   "description": "Fine-grained reactive primitives used across mreact.",
   "keywords": [
     "jsx",

package/src/internal.ts

@@ -1,4 +1,5 @@
 export type { Scheduler } from "./scheduler.js";
 export { registerCleanup, withCleanupScope } from "./cleanup-scope.js";
 export { flushQueuedComputations, schedulePendingFlush, setScheduler } from "./scheduler.js";
+export { flushPendingComputed } from "./tracking.js";
 export { getGlobalRuntimeState } from "./runtime-state.js";