@loro-dev/flock 4.4.4 → 4.5.0

package/README.md

@@ -53,6 +53,14 @@ unsubscribe();
 - Track causal progress with `version()` and `getMaxPhysicalTime()` when orchestrating incremental syncs.
 - Use `Flock.checkConsistency()` in tests to assert that two replicas converged to the same state.
 
+## JSON Compatibility
+
+Flock stores strict JSON data. Keys and values may use strings, finite numbers,
+booleans, null, arrays, and plain objects. Values that structured clone can
+represent but JSON cannot, such as `undefined`, `bigint`, functions, symbols,
+`NaN`, and infinities, are rejected instead of being preserved or silently
+dropped.
+
 ## Type Basics
 
 - `Value`: JSON-compatible data (`string`, `number`, `boolean`, `null`, nested arrays/objects).
@@ -113,7 +121,7 @@ All types are exported from the package entry point for use in TypeScript projec
 
 ### Utilities
 
-- `exportJson`, `importJson`, `kvToJson`, and `fromJson` all work with plain JavaScript objects, so they serialise cleanly through JSON or structured clone.
+- `exportJson`, `importJson`, `kvToJson`, and `fromJson` all work with plain JavaScript objects that serialize cleanly through JSON.
 - Keys are encoded using MoonBit’s memcomparable format; use simple scalars and natural ordering for predictable scans.
 
 ## Error Handling