@arbidocs/coedit 0.4.155 → 0.4.156

package/dist/{session-Cf9iu1Vt.d.cts → session-WGvWs6yO.d.cts}

@@ -1,6 +1,6 @@
 import * as Y from 'yjs';
 import { Awareness } from 'y-protocols/awareness';
-import { CollaborationFailureCode, EditorCollaborationSession, CollaborationIdentity, CollaborationStatus, CollaborationStatusSnapshot, CollaborationLocalSelection, CollaborationParticipant, CollaborationRemoteSelection } from '@docx-editor.dev/core/collaboration';
+import { CollaborationFailureCode, EditorCollaborationSession, CollaborationIdentity, CollaborationStatus, CollaborationStatusSnapshot, CollaborationLocalSelection, CollaborationSelectionMove, CollaborationParticipant, CollaborationRemoteSelection } from '@docx-editor.dev/core/collaboration';
 import { CollaborationDocumentPort } from '@docx-editor.dev/core/collaboration/replication';
 
 /**
@@ -19,8 +19,6 @@ interface DocxCollaborationSessionOptions {
     identity: CollaborationIdentity;
     /** Keep accepting edits while the transport is down; they merge on reconnect. */
     offlineEditing?: boolean;
-    /** See `MirrorSyncOptions.remoteDelayMs`. */
-    remoteDelayMs?: number;
 }
 declare class CollaborationSessionError extends Error {
     readonly code: CollaborationFailureCode;
@@ -34,7 +32,6 @@ declare class DocxCollaborationSession implements EditorCollaborationSession {
     private readonly doc;
     private readonly awareness;
     private readonly offlineEditing;
-    private readonly remoteDelayMs;
     private readonly tracker;
     private readonly statusListeners;
     private readonly participantListeners;
@@ -47,6 +44,10 @@ declare class DocxCollaborationSession implements EditorCollaborationSession {
     private selectionsCache;
     private selectionsKey;
     private baselineVector;
+    /** The selection the editor last published, carried across the remote changes since. */
+    private carried;
+    private selectionMove;
+    private inputFlush;
     private readonly disposers;
     constructor(options: DocxCollaborationSessionOptions);
     status(): CollaborationStatus;
@@ -64,11 +65,28 @@ declare class DocxCollaborationSession implements EditorCollaborationSession {
     attach(port: CollaborationDocumentPort): () => void;
     /** Transport hook: call before integrating inbound Yjs data so queued local edits are mirrored first. */
     beforeRemote(): void;
+    /**
+     * Bind the editor's pending-input flush (`PaginatedSurface.flushPendingInput`). The session writes
+     * below the editor's input buffer, so it lands queued typing before a remote change and lays the
+     * change out right after it: the editor carries its caret at that layout, and a keystroke before
+     * it would otherwise use the caret from before the change. Returns the unbind function.
+     */
+    bindEditorInput(flush: () => void): () => void;
     canUndo(): boolean;
     canRedo(): boolean;
     undo(): boolean;
     redo(): boolean;
     setLocalSelection(selection: CollaborationLocalSelection | null): void;
+    /** Where the last remote change carried the local selection; see `carrySelection`. */
+    remoteSelectionMove(): CollaborationSelectionMove | null;
+    /**
+     * Called before a remote change reaches the port: notes the selection's paragraphs and their text,
+     * and returns what carries it across the change once the port holds the new tree. The editor
+     * takes the carried selection when a local edit was coalesced with the remote change, where it
+     * cannot map its caret by the text alone. Several remote changes before the editor publishes its
+     * selection again chain, all from the selection it published.
+     */
+    private carrySelection;
     participants(): readonly CollaborationParticipant[];
     subscribeParticipants(listener: (participants: readonly CollaborationParticipant[]) => void): () => void;
     remoteSelections(): readonly CollaborationRemoteSelection[];

package/dist/{session-Cf9iu1Vt.d.ts → session-WGvWs6yO.d.ts}

@@ -1,6 +1,6 @@
 import * as Y from 'yjs';
 import { Awareness } from 'y-protocols/awareness';
-import { CollaborationFailureCode, EditorCollaborationSession, CollaborationIdentity, CollaborationStatus, CollaborationStatusSnapshot, CollaborationLocalSelection, CollaborationParticipant, CollaborationRemoteSelection } from '@docx-editor.dev/core/collaboration';
+import { CollaborationFailureCode, EditorCollaborationSession, CollaborationIdentity, CollaborationStatus, CollaborationStatusSnapshot, CollaborationLocalSelection, CollaborationSelectionMove, CollaborationParticipant, CollaborationRemoteSelection } from '@docx-editor.dev/core/collaboration';
 import { CollaborationDocumentPort } from '@docx-editor.dev/core/collaboration/replication';
 
 /**
@@ -19,8 +19,6 @@ interface DocxCollaborationSessionOptions {
     identity: CollaborationIdentity;
     /** Keep accepting edits while the transport is down; they merge on reconnect. */
     offlineEditing?: boolean;
-    /** See `MirrorSyncOptions.remoteDelayMs`. */
-    remoteDelayMs?: number;
 }
 declare class CollaborationSessionError extends Error {
     readonly code: CollaborationFailureCode;
@@ -34,7 +32,6 @@ declare class DocxCollaborationSession implements EditorCollaborationSession {
     private readonly doc;
     private readonly awareness;
     private readonly offlineEditing;
-    private readonly remoteDelayMs;
     private readonly tracker;
     private readonly statusListeners;
     private readonly participantListeners;
@@ -47,6 +44,10 @@ declare class DocxCollaborationSession implements EditorCollaborationSession {
     private selectionsCache;
     private selectionsKey;
     private baselineVector;
+    /** The selection the editor last published, carried across the remote changes since. */
+    private carried;
+    private selectionMove;
+    private inputFlush;
     private readonly disposers;
     constructor(options: DocxCollaborationSessionOptions);
     status(): CollaborationStatus;
@@ -64,11 +65,28 @@ declare class DocxCollaborationSession implements EditorCollaborationSession {
     attach(port: CollaborationDocumentPort): () => void;
     /** Transport hook: call before integrating inbound Yjs data so queued local edits are mirrored first. */
     beforeRemote(): void;
+    /**
+     * Bind the editor's pending-input flush (`PaginatedSurface.flushPendingInput`). The session writes
+     * below the editor's input buffer, so it lands queued typing before a remote change and lays the
+     * change out right after it: the editor carries its caret at that layout, and a keystroke before
+     * it would otherwise use the caret from before the change. Returns the unbind function.
+     */
+    bindEditorInput(flush: () => void): () => void;
     canUndo(): boolean;
     canRedo(): boolean;
     undo(): boolean;
     redo(): boolean;
     setLocalSelection(selection: CollaborationLocalSelection | null): void;
+    /** Where the last remote change carried the local selection; see `carrySelection`. */
+    remoteSelectionMove(): CollaborationSelectionMove | null;
+    /**
+     * Called before a remote change reaches the port: notes the selection's paragraphs and their text,
+     * and returns what carries it across the change once the port holds the new tree. The editor
+     * takes the carried selection when a local edit was coalesced with the remote change, where it
+     * cannot map its caret by the text alone. Several remote changes before the editor publishes its
+     * selection again chain, all from the selection it published.
+     */
+    private carrySelection;
     participants(): readonly CollaborationParticipant[];
     subscribeParticipants(listener: (participants: readonly CollaborationParticipant[]) => void): () => void;
     remoteSelections(): readonly CollaborationRemoteSelection[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arbidocs/coedit",
-  "version": "0.4.155",
+  "version": "0.4.156",
   "description": "Real-time collaboration for the ARBI native DOCX editor: a Yjs mirror of the canonical OOXML package, session, and server runtime",
   "type": "module",
   "sideEffects": false,