@jxsuite/collab 0.7.0 → 0.8.2

package/README.md

@@ -69,7 +69,7 @@ one `error{read-only}`.
 
 One project-level `Awareness` per connection. State shape:
 `{ user: {login, name?, avatarUrl?, color}, focusedPath, mode?, structuralSelection?, selection? }` —
-file-tree presence (the plain `selection` field is y-monaco's in-buffer cursor)
+file-tree presence (the plain `selection` field is the code view's in-buffer cursor)
 and per-document cursor overlays both filter the same states. Identity comes from the server
 `hello`; colors are deterministic (`colorForKey`).
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jxsuite/collab",
-  "version": "0.7.0",
+  "version": "0.8.2",
   "description": "Realtime co-editing for Jx Studio — Y.Doc schema, op bridge, structural differ, wire envelope, and provider contracts shared by every collab backend",
   "license": "MIT",
   "repository": {
@@ -33,9 +33,9 @@
     "test:coverage": "bun test --isolate --coverage"
   },
   "dependencies": {
-    "@jxsuite/schema": "^1.6.0",
-    "lib0": "^0.2.99",
-    "y-protocols": "^1.0.6",
-    "yjs": "13.6.27"
+    "@jxsuite/schema": "^1.8.1",
+    "lib0": "^0.2.117",
+    "y-protocols": "^1.0.7",
+    "yjs": "13.6.32"
   }
 }

package/src/awareness-types.ts

@@ -30,9 +30,11 @@ export interface CollabAwarenessState {
    */
   structuralSelection?: JxPath[] | null;
   /**
-   * RESERVED for y-monaco: the in-buffer text cursor as {anchor, head} Y.RelativePosition JSON.
-   * MonacoBinding owns this field via setLocalStateField("selection", …) while a code view is
-   * bound; nothing else may write it.
+   * RESERVED for the code view: the in-buffer text cursor as {anchor, head} Y.RelativePosition
+   * JSON. `studio/src/collab/monaco-binding.ts`'s bindMonacoToYText owns this field via
+   * setLocalStateField("selection", …) while a code view is bound, and sets it back to null when it
+   * unbinds; nothing else may write it. The shape is y-monaco's, deliberately — a peer on an older
+   * Studio publishes and reads exactly this.
    */
   selection?: { anchor: unknown; head: unknown } | null;
   /**

package/src/index.ts

@@ -18,8 +18,18 @@ export {
   yDocToJson,
   yValueToJson,
 } from "./schema.ts";
-// Re-exported so consumers keep a single yjs import point (avoids dual-instance hazards).
-export { Doc as YDoc, UndoManager } from "yjs";
+/* Re-exported so consumers keep a single yjs import point (avoids dual-instance hazards).
+
+   The two position helpers are here for exactly that reason. `studio/src/collab/monaco-binding.ts`
+   mints a RelativePosition for every saved caret and resolves peers' back to offsets, and a
+   RelativePosition minted by a SECOND yjs instance resolves to null against this doc — the failure
+   is a cursor that silently stops moving, not an error. One import point, one instance. */
+export {
+  createAbsolutePositionFromRelativePosition,
+  createRelativePositionFromTypeIndex,
+  Doc as YDoc,
+  UndoManager,
+} from "yjs";
 export {
   applyDocOpsToY,
   CollabPathError,