@estjs/signals 0.0.17 → 0.0.18-beta.1

package/dist/signals.d.cts

@@ -1138,7 +1138,7 @@ interface WatchOptions {
     /**
      * When the callback fires relative to the reactive flush cycle.
      * - `'post'` (default) — queued on the microtask job queue (essor's historical
-     *   behavior). NOTE: Vue defaults `watch` to `'pre'`; essor keeps `'post'`.
+     *   behavior).
      * - `'pre'`  — queued before the main job queue.
      * - `'sync'` — run synchronously the instant the source changes. Use sparingly:
      *   a callback that mutates a tracked dependency can recurse.
@@ -1152,23 +1152,12 @@ type WatchSource<T = any> = T | {
 } | (() => T);
 /**
  * Register a cleanup handler that runs right before the next callback invocation
- * and when the watcher stops. Mirrors Vue's `onCleanup`/`onInvalidate` — use it
- * to cancel stale async work (timers, fetches, subscriptions).
  */
 type OnCleanup = (cleanupFn: () => void) => void;
 type WatchCallback<T = any> = (newValue: T, oldValue: T | undefined, onCleanup: OnCleanup) => void;
 /**
  * Watch one or more reactive data sources and execute callback when sources change.
  *
- * ⚠️ **`oldValue` caveat for object / reactive sources.** For performance,
- * `watch` does NOT deep-clone the watched value between runs (deep cloning
- * every tick is prohibitively expensive). The `newValue` and `oldValue` passed
- * to your callback are therefore the *same reference* whenever the source is a
- * reactive object, array, Map/Set, or a getter that returns one — i.e.
- * `newValue === oldValue` and reading `oldValue.foo` yields the already-mutated
- * value. This differs from Vue, which snapshots primitives but likewise shares
- * the reference for deep/reactive sources.
- *
  * To capture a previous snapshot for object sources, derive the specific
  * primitive you care about in a getter:
  *

package/dist/signals.d.ts

@@ -1138,7 +1138,7 @@ interface WatchOptions {
     /**
      * When the callback fires relative to the reactive flush cycle.
      * - `'post'` (default) — queued on the microtask job queue (essor's historical
-     *   behavior). NOTE: Vue defaults `watch` to `'pre'`; essor keeps `'post'`.
+     *   behavior).
      * - `'pre'`  — queued before the main job queue.
      * - `'sync'` — run synchronously the instant the source changes. Use sparingly:
      *   a callback that mutates a tracked dependency can recurse.
@@ -1152,23 +1152,12 @@ type WatchSource<T = any> = T | {
 } | (() => T);
 /**
  * Register a cleanup handler that runs right before the next callback invocation
- * and when the watcher stops. Mirrors Vue's `onCleanup`/`onInvalidate` — use it
- * to cancel stale async work (timers, fetches, subscriptions).
  */
 type OnCleanup = (cleanupFn: () => void) => void;
 type WatchCallback<T = any> = (newValue: T, oldValue: T | undefined, onCleanup: OnCleanup) => void;
 /**
  * Watch one or more reactive data sources and execute callback when sources change.
  *
- * ⚠️ **`oldValue` caveat for object / reactive sources.** For performance,
- * `watch` does NOT deep-clone the watched value between runs (deep cloning
- * every tick is prohibitively expensive). The `newValue` and `oldValue` passed
- * to your callback are therefore the *same reference* whenever the source is a
- * reactive object, array, Map/Set, or a getter that returns one — i.e.
- * `newValue === oldValue` and reading `oldValue.foo` yields the already-mutated
- * value. This differs from Vue, which snapshots primitives but likewise shares
- * the reference for deep/reactive sources.
- *
  * To capture a previous snapshot for object sources, derive the specific
  * primitive you care about in a getter:
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@estjs/signals",
-  "version": "0.0.17",
+  "version": "0.0.18-beta.1",
   "description": "",
   "type": "module",
   "keywords": [],
@@ -52,7 +52,7 @@
   "unpkg": "dist/signals.js",
   "jsdelivr": "dist/signals.js",
   "dependencies": {
-    "@estjs/shared": "0.0.17"
+    "@estjs/shared": "0.0.18-beta.1"
   },
   "scripts": {
     "build": "tsup && cross-env NODE_ENV=production tsup --clean=false",