teamplay 0.4.0-alpha.92 → 0.4.0-alpha.93

package/orm/Compat/README.md

@@ -407,7 +407,7 @@ Compatibility mode intentionally aligns mutators with Racer. This differs from c
 | `set` | Uses deep-diff path (`dataTree.set` + internal `setDiffDeep`). | Path-targeted replace semantics, Racer-like. `undefined` keeps delete semantics. |
 | `setEach` | Not a special API in core mutators. | Per-key compat `set` (not `assign` merge/delete behavior). |
 | `setDiffDeep` | Deep-diff engine (`utils/setDiffDeep.js`). | Recursive Racer-like diff implemented via compat mutators (`set` / `del`) on nested paths. |
-| `setDiff` | N/A as compat shim. | Alias to compat `set` for both signatures: `setDiff(value)` and `setDiff(path, value)`. |
+| `setDiff` | N/A as compat shim. | Racer-like full replace with exact-equality no-op (`===` / `NaN`). Equivalent objects / arrays still replace. |
 
 Migration note: compat behavior is intentionally Racer-aligned and may differ from core mutators.
 Composite compat mutators (`setEach`, `setDiffDeep`) apply updates atomically for Teamplay-scheduled observers via the runtime batch scheduler.
@@ -474,13 +474,17 @@ await $.users.user1.setDiffDeep({ profile: { name: 'Kate' } }) // deep-diff path
 
 ### setDiff(path?, value)
 
-Alias for compat `set` in both forms:
-- `setDiff(value)` -> same as `set(value)`
-- `setDiff(path, value)` -> same as `set(path, value)`
+Racer-like full replace at the target path.
+- No-op only when previous and next values are exactly equal (`===`) or both `NaN`
+- Equivalent objects / arrays still perform a replace
+- Unlike `setDiffDeep`, this is not a recursive diff
 
 ```js
+await $.users.user1.set('count', 1)
+await $.users.user1.setDiff('count', 1) // no-op
+
 await $.users.user1.setDiff({ profile: { name: 'Kate' } })
-await $.users.user1.setDiff('profile', { name: 'Bob' })
+await $.users.user1.setDiff('profile', { name: 'Bob' }) // full replace
 ```
 
 ### setEach(path?, object)

package/orm/Compat/SignalCompat.js

@@ -289,10 +289,16 @@ class SignalCompat extends Signal {
     const forwarded = forwardRef(this, 'setDiff', arguments)
     if (forwarded) return forwarded
     if (arguments.length > 2) throw Error('Signal.setDiff() expects one or two arguments')
-    if (arguments.length === 1) {
-      return this.set(path)
+    let segments = []
+    if (arguments.length === 2) {
+      segments = parseAtSubpath(path, 1, 'Signal.setDiff()')
+    } else if (arguments.length === 1) {
+      value = path
     }
-    return this.set(path, value)
+    const $target = resolveRelativePathTarget(this, segments)
+    const before = $target.peek()
+    if (racerEqualCompat(before, value)) return
+    return setReplaceOnSignal($target, value)
   }
 
   async setEach (path, object) {
@@ -1090,6 +1096,10 @@ function deepEqualCompat (left, right) {
   return true
 }
 
+function racerEqualCompat (left, right) {
+  return left === right || (Number.isNaN(left) && Number.isNaN(right))
+}
+
 function getSignalValueAt ($signal, segments) {
   const $target = resolveRelativePathTarget($signal, segments)
   return $target.get()

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "teamplay",
-  "version": "0.4.0-alpha.92",
+  "version": "0.4.0-alpha.93",
   "description": "Full-stack signals ORM with multiplayer",
   "type": "module",
   "main": "index.js",
@@ -83,5 +83,5 @@
     ]
   },
   "license": "MIT",
-  "gitHead": "d55bd0417f7611c11584ae6400e5e111cc0ec9e3"
+  "gitHead": "286165ff8cf198fe20f8ec1be416c12839f47de8"
 }