@datalayer/lexical-loro 0.0.3 → 0.1.0

package/lib/LoroCollaborativePlugin.js

@@ -1,2503 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-/*
- * Copyright (c) 2023-2025 Datalayer, Inc.
- * Distributed under the terms of the MIT License.
- */
-import { useEffect, useRef, useCallback, useState } from 'react';
-import { createPortal } from 'react-dom';
-import { $createParagraphNode, $getRoot, $getSelection, $isRangeSelection, $getNodeByKey, $isTextNode, $isElementNode, $isLineBreakNode, $createTextNode, createState, $getState, $setState } from 'lexical';
-import { createDOMRange, createRectsFromDOMRange } from '@lexical/selection';
-import { useLexicalComposerContext } from '@lexical/react/LexicalComposerContext';
-import { LoroDoc, LoroText, Cursor, EphemeralStore } from 'loro-crdt';
-// ============================================================================
-// STABLE NODE UUID SYSTEM using Lexical NodeState
-// ============================================================================
-/**
- * NodeState configuration for storing stable UUIDs in Lexical nodes.
- * This replaces the unstable NodeKey system for cursor positioning.
- *
- * Based on Lexical NodeState documentation:
- * https://lexical.dev/docs/concepts/node-state
- */
-const stableNodeIdState = createState('stable-node-id', {
-    parse: (v) => typeof v === 'string' ? v : undefined,
-});
-/**
- * Generate a stable UUID for nodes
- */
-function generateStableNodeId() {
-    return `node_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
-}
-/**
- * Get or create a stable UUID for a Lexical node using NodeState
- */
-function $getStableNodeId(node) {
-    let stableId = $getState(node, stableNodeIdState);
-    if (!stableId) {
-        stableId = generateStableNodeId();
-        $setState(node, stableNodeIdState, stableId);
-    }
-    return stableId;
-}
-// ============================================================================
-// STABLE CURSOR POSITION FUNCTIONS - UUID Based (No Performance Issues)
-// ============================================================================
-/**
- * Create stable position data from Lexical selection point using UUID
- * This replaces NodeKey-based approach with stable UUIDs
- * Must be called within editor.getEditorState().read() or editor.update()
- */
-function $createStablePositionFromPoint(point) {
-    const node = $getNodeByKey(point.key);
-    if (!node) {
-        console.warn('❌ Node not found for key:', point.key);
-        return null;
-    }
-    // Get or create stable UUID for this node
-    const stableNodeId = $getStableNodeId(node);
-    return {
-        stableNodeId,
-        offset: point.offset,
-        type: $isTextNode(node) ? 'text' : 'element'
-    };
-}
-/**
- * Find a node by its stable UUID (traverses the document tree)
- * This is the reverse operation - finding node by stable ID
- */
-function $findNodeByStableId(stableNodeId) {
-    const root = $getRoot();
-    // Traverse the document tree to find node with matching stable ID
-    function traverse(node) {
-        // Check if this node has the stable ID we're looking for
-        const nodeStableId = $getState(node, stableNodeIdState);
-        if (nodeStableId === stableNodeId) {
-            return node;
-        }
-        // If this is an element node, traverse its children
-        if ($isElementNode(node)) {
-            const children = node.getChildren();
-            for (const child of children) {
-                const found = traverse(child);
-                if (found)
-                    return found;
-            }
-        }
-        return null;
-    }
-    return traverse(root);
-}
-/**
- * Convert stable position back to NodeKey and offset for Lexical operations
- * This allows compatibility with existing cursor positioning code
- */
-function $resolveStablePosition(stablePos) {
-    const node = $findNodeByStableId(stablePos.stableNodeId);
-    if (!node) {
-        console.warn('❌ Could not find node for stable ID:', stablePos.stableNodeId, '- using document end fallback');
-        // ROBUST FALLBACK: When stable UUID can't be resolved (node doesn't exist yet),
-        // position cursor at end of document instead of failing
-        const root = $getRoot();
-        const children = root.getChildren();
-        // Find the last text node in the document
-        for (let i = children.length - 1; i >= 0; i--) {
-            const child = children[i];
-            if ($isElementNode(child)) {
-                const textChildren = child.getChildren().filter($isTextNode);
-                if (textChildren.length > 0) {
-                    const lastText = textChildren[textChildren.length - 1];
-                    console.log('✅ Fallback: Using end of last text node:', {
-                        nodeKey: lastText.getKey(),
-                        textLength: lastText.getTextContentSize(),
-                        stableIdThatFailed: stablePos.stableNodeId
-                    });
-                    return {
-                        key: lastText.getKey(),
-                        offset: lastText.getTextContentSize()
-                    };
-                }
-            }
-        }
-        // If no text nodes found, use root
-        console.log('✅ Fallback: Using root node (no text nodes found)');
-        return {
-            key: root.getKey(),
-            offset: 0
-        };
-    }
-    return {
-        key: node.getKey(),
-        offset: stablePos.offset
-    };
-}
-/**
- * Ensure all nodes in the document have stable UUIDs
- * This should be called after document updates to maintain stability
- */
-function $ensureAllNodesHaveStableIds() {
-    const root = $getRoot();
-    function traverse(node) {
-        // Ensure this node has a stable ID
-        $getStableNodeId(node);
-        // If this is an element node, traverse its children
-        if ($isElementNode(node)) {
-            const children = node.getChildren();
-            for (const child of children) {
-                traverse(child);
-            }
-        }
-    }
-    traverse(root);
-} /**
- * LoroCollaborativePlugin - Enhanced Cursor Management
- *
- * IMPROVEMENTS IMPLEMENTED based on Loro Cursor documentation and YJS SyncCursors patterns:
- *
- * 1. Enhanced CursorAwareness class with Loro document reference
- *    - Added loroDoc parameter for proper cursor operations
- *    - Provides framework for stable cursor positioning
- *
- * 2. Added createCursorFromLexicalPoint method
- *    - Inspired by YJS SyncCursors createRelativePosition pattern
- *    - Creates stable Loro cursors from Lexical selection points
- *    - Replaces approximation with proper cursor positioning
- *
- * 3. Added getStableCursorPosition method
- *    - Inspired by YJS SyncCursors createAbsolutePosition pattern
- *    - Converts Loro cursors back to stable positions
- *    - Provides better positioning than current approximations
- *
- * 4. Enhanced cursor side information support
- *    - Added anchorSide and focusSide to stable cursor data
- *    - Follows Loro Cursor documentation patterns for precise positioning
- *    - Equivalent to YJS RelativePosition side information
- *
- * 5. Improved cursor creation with framework for better methods
- *    - Added TODO comments showing enhanced cursor creation approach
- *    - Framework ready for using createCursorFromLexicalPoint
- *    - Maintains backward compatibility while providing upgrade path
- *
- * 6. Enhanced remote cursor processing
- *    - Added support for cursor side information in stable cursor data
- *    - Provides framework for direct Loro cursor conversion
- *    - Better handling of cursor position stability across edits
- *
- * TECHNICAL APPROACH:
- * - Loro Cursor type is equivalent to YJS RelativePosition (as documented)
- * - Stable positions survive document edits (like YJS RelativePosition)
- * - Cursor side information provides precise positioning
- * - Framework supports proper createRelativePosition/createAbsolutePosition patterns
- *
- * NEXT STEPS for full implementation:
- * - Implement calculateGlobalPosition method with proper document traversal
- * - Add convertGlobalPositionToLexical helper function
- * - Enable the enhanced cursor creation methods by uncommenting TODO sections
- * - Complete the direct Loro cursor conversion path
- */
-const CursorComponent = ({ peerId, position, color, name, isCurrentUser, selection }) => {
-    const displayName = `${name} (peer:${peerId})`;
-    return (_jsxs(_Fragment, { children: [selection && selection.rects.map((rect, index) => (_jsx("span", { style: {
-                    position: 'fixed',
-                    top: `${rect.top}px`,
-                    left: `${rect.left}px`,
-                    width: `${rect.width}px`,
-                    height: `${rect.height}px`,
-                    backgroundColor: color,
-                    opacity: 0.2,
-                    pointerEvents: 'none',
-                    zIndex: 1, // Behind cursor
-                } }, `selection-${peerId}-${index}`))), _jsxs("span", { style: {
-                    position: 'fixed',
-                    top: `${position.top}px`,
-                    left: `${position.left}px`,
-                    height: '20px', // Standard text line height
-                    width: '0px',
-                    pointerEvents: 'none',
-                    zIndex: 5,
-                    opacity: isCurrentUser ? 0.6 : 1.0,
-                }, children: [_jsx("span", { style: {
-                            position: 'absolute',
-                            left: '0',
-                            top: '0',
-                            backgroundColor: color,
-                            opacity: 0.3,
-                            height: '20px',
-                            width: '2px',
-                            pointerEvents: 'none',
-                            zIndex: 5,
-                        } }), _jsx("span", { style: {
-                            position: 'absolute',
-                            top: '0',
-                            bottom: '0',
-                            right: '-1px',
-                            width: '1px',
-                            backgroundColor: color,
-                            zIndex: 10,
-                            pointerEvents: 'none',
-                        }, children: _jsx("span", { style: {
-                                position: 'absolute',
-                                left: '-2px',
-                                top: '-16px',
-                                backgroundColor: color,
-                                color: '#fff',
-                                lineHeight: '12px',
-                                fontSize: '12px',
-                                padding: '2px',
-                                fontFamily: 'Arial',
-                                fontWeight: 'bold',
-                                whiteSpace: 'nowrap',
-                                borderRadius: '2px',
-                                maxWidth: '200px',
-                                overflow: 'hidden',
-                                textOverflow: 'ellipsis',
-                            }, children: displayName }) })] })] }));
-};
-const CursorsContainer = ({ remoteCursors, getPositionFromLexicalPosition, clientId, editor }) => {
-    const [portalContainer, setPortalContainer] = useState(null);
-    // Keep last known good positions to avoid snapping to x=0 when mapping fails
-    const lastCursorStateRef = useRef({});
-    useEffect(() => {
-        // Create or get the cursor overlay container
-        let container = document.getElementById('loro-cursor-overlay');
-        if (!container) {
-            container = document.createElement('div');
-            container.id = 'loro-cursor-overlay';
-            container.style.cssText = `
-        position: fixed;
-        top: 0;
-        left: 0;
-        width: 100vw;
-        height: 100vh;
-        pointer-events: none;
-        z-index: 999999;
-        overflow: visible;
-      `;
-            document.body.appendChild(container);
-            console.log('🎭 Created React portal cursor overlay container');
-        }
-        setPortalContainer(container);
-        return () => {
-            // Clean up container on unmount
-            const existingContainer = document.getElementById('loro-cursor-overlay');
-            if (existingContainer && existingContainer.parentNode) {
-                existingContainer.parentNode.removeChild(existingContainer);
-                console.log('🧹 Cleaned up cursor overlay container');
-            }
-        };
-    }, []);
-    if (!portalContainer) {
-        return null;
-    }
-    console.log('🎯 Rendering cursors via React portal:', {
-        remoteCursorsCount: Object.keys(remoteCursors).length,
-        clientId
-    });
-    const cursors = Object.values(remoteCursors)
-        .map(remoteCursor => {
-        const { peerId, anchor, focus, user } = remoteCursor;
-        if (!anchor) {
-            console.log('⚠️ No anchor for peer:', peerId);
-            return null;
-        }
-        try {
-            // Get cursor position using standard positioning
-            let position = getPositionFromLexicalPosition(anchor.key, anchor.offset);
-            const lastState = lastCursorStateRef.current[peerId];
-            // Basic position validation
-            const isPositionValid = (pos) => {
-                if (!pos)
-                    return false;
-                // Check for NaN values
-                if (isNaN(pos.top) || isNaN(pos.left))
-                    return false;
-                // Check for negative positions (usually indicates positioning error)
-                if (pos.top < 0 || pos.left < 0)
-                    return false;
-                // Check for unreasonably large positions (likely positioning error)
-                if (pos.top > window.innerHeight * 3 || pos.left > window.innerWidth * 3)
-                    return false;
-                return true;
-            };
-            // If position seems invalid, try to recalculate
-            if (!isPositionValid(position)) {
-                console.log('⚠️ Position validation failed, recalculating...', position);
-                // Try again to get position
-                position = getPositionFromLexicalPosition(anchor.key, anchor.offset);
-                console.log('🔄 Recalculated position:', position);
-            }
-            // Heuristic: if mapping still invalid, or we detect a suspicious jump to line start,
-            // keep the last known good position to avoid snapping to x=0.
-            const looksLikeLineStartFallback = () => {
-                if (!position || !lastState)
-                    return false;
-                // Consider a suspicious leftward jump on the same line while offset increased or stayed
-                const leftwardJump = position.left < (lastState.position.left - 20); // >20px jump left
-                const roughlySameLine = Math.abs(position.top - lastState.position.top) < 30; // within same line height
-                const offsetDidNotDecrease = anchor.offset >= (lastState.offset || 0);
-                return leftwardJump && roughlySameLine && offsetDidNotDecrease;
-            };
-            if (!isPositionValid(position) || looksLikeLineStartFallback()) {
-                if (!isPositionValid(position)) {
-                    console.log('⚠️ Final position invalid; using last known good position for peer:', peerId, { last: lastState?.position });
-                }
-                else {
-                    console.log('⚠️ Suspicious leftward jump detected; keeping last position for peer:', peerId, {
-                        current: position,
-                        last: lastState?.position,
-                        anchorOffset: anchor.offset,
-                        lastOffset: lastState?.offset
-                    });
-                }
-                if (lastState && isPositionValid(lastState.position)) {
-                    position = lastState.position;
-                }
-            }
-            if (!isPositionValid(position)) {
-                console.log('⚠️ No valid position available for peer after fallback:', peerId, position);
-                return null;
-            }
-            // Position is now guaranteed to be valid due to isPositionValid check above
-            const color = user?.color || '#007acc';
-            const displayName = user?.name || peerId.slice(-8);
-            const isCurrentUser = peerId === clientId;
-            // Calculate selection rectangles if there's a focus position different from anchor
-            let selection;
-            if (focus && (focus.key !== anchor.key || focus.offset !== anchor.offset)) {
-                // There's a selection, calculate the selection rectangles
-                console.log('� Calculating selection for peer:', peerId, { anchor, focus });
-                try {
-                    // Use the provided editor instance to create a range from anchor to focus
-                    if (editor) {
-                        const rects = editor.getEditorState().read(() => {
-                            const anchorNode = $getNodeByKey(anchor.key);
-                            const focusNode = $getNodeByKey(focus.key);
-                            if (!anchorNode || !focusNode) {
-                                console.log('⚠️ Selection nodes not found:', { anchorNode: !!anchorNode, focusNode: !!focusNode });
-                                return [];
-                            }
-                            try {
-                                // Create a DOM range from anchor to focus
-                                const range = createDOMRange(editor, anchorNode, anchor.offset, focusNode, focus.offset);
-                                if (range) {
-                                    const rectList = createRectsFromDOMRange(editor, range);
-                                    console.log('📐 Selection rects calculated:', rectList.length);
-                                    return rectList.map(rect => ({
-                                        top: rect.top,
-                                        left: rect.left,
-                                        width: rect.width,
-                                        height: rect.height
-                                    }));
-                                }
-                            }
-                            catch (rangeError) {
-                                console.warn('Error creating selection range:', rangeError);
-                            }
-                            return [];
-                        });
-                        if (rects.length > 0) {
-                            selection = { rects };
-                            console.log('✅ Selection calculated successfully for peer:', peerId, selection);
-                        }
-                    }
-                }
-                catch (selectionError) {
-                    console.warn('Error calculating selection for peer:', peerId, selectionError);
-                }
-            }
-            console.log('�🟢 Rendering cursor for peer:', peerId, {
-                position,
-                color,
-                displayName,
-                isCurrentUser,
-                hasSelection: !!selection
-            });
-            // Store last known good position and offset for future fallbacks
-            lastCursorStateRef.current[peerId] = {
-                position: { top: position.top, left: position.left },
-                offset: anchor.offset
-            };
-            return (_jsx(CursorComponent, { peerId: peerId, position: {
-                    top: Math.max(position.top, 20),
-                    left: Math.max(position.left, 20)
-                }, color: color, name: displayName, isCurrentUser: isCurrentUser, selection: selection }, peerId));
-        }
-        catch (error) {
-            console.warn('Error creating cursor for peer:', peerId, error);
-            return null;
-        }
-    })
-        .filter(Boolean);
-    return createPortal(_jsx(_Fragment, { children: cursors }), portalContainer);
-};
-class CursorAwareness {
-    ephemeralStore;
-    peerId;
-    listeners = [];
-    loroDoc; // Add reference to Loro document for proper cursor operations
-    constructor(peer, loroDoc, timeout = 300_000) {
-        this.ephemeralStore = new EphemeralStore(timeout);
-        this.peerId = peer.toString();
-        this.loroDoc = loroDoc; // Store document reference for stable cursor operations
-        // Subscribe to EphemeralStore events with proper event handling
-        this.ephemeralStore.subscribe((event) => {
-            console.log('🔔 EphemeralStore event received:', {
-                by: event.by,
-                added: event.added,
-                updated: event.updated,
-                removed: event.removed
-            });
-            // Notify all listeners about changes with event details
-            this.notifyListeners(event);
-            return true; // Continue subscription
-        });
-    }
-    getAll() {
-        const ans = {};
-        const allStates = this.ephemeralStore.getAllStates();
-        for (const [peer, state] of Object.entries(allStates)) {
-            const stateData = state;
-            try {
-                const decodedAnchor = stateData.anchor ? Cursor.decode(stateData.anchor) : undefined;
-                const decodedFocus = stateData.focus ? Cursor.decode(stateData.focus) : undefined;
-                ans[peer] = {
-                    anchor: decodedAnchor,
-                    focus: decodedFocus,
-                    user: stateData.user ? stateData.user : undefined,
-                };
-            }
-            catch (error) {
-                console.warn('Error decoding cursor for peer', peer, error);
-            }
-        }
-        return ans;
-    }
-    setLocal(state) {
-        this.ephemeralStore.set(this.peerId, {
-            anchor: state.anchor?.encode() || null,
-            focus: state.focus?.encode() || null,
-            user: state.user || null,
-        });
-    }
-    getLocal() {
-        const state = this.ephemeralStore.get(this.peerId);
-        if (!state) {
-            return undefined;
-        }
-        const stateData = state;
-        try {
-            return {
-                anchor: stateData.anchor && Cursor.decode(stateData.anchor),
-                focus: stateData.focus && Cursor.decode(stateData.focus),
-                user: stateData.user,
-            };
-        }
-        catch (error) {
-            console.warn('Error decoding local cursor:', error);
-            return undefined;
-        }
-    }
-    getLocalState() {
-        const state = this.ephemeralStore.get(this.peerId);
-        if (!state)
-            return null;
-        const stateData = state;
-        return {
-            anchor: stateData.anchor || null,
-            focus: stateData.focus || null,
-            user: stateData.user || null,
-        };
-    }
-    setRemoteState(peerId, state) {
-        console.log('Setting remote state for peer:', peerId, state);
-        try {
-            if (state === null || (state.anchor === null && state.focus === null)) {
-                this.ephemeralStore.delete(peerId.toString());
-                return;
-            }
-            // Store the raw state in EphemeralStore
-            this.ephemeralStore.set(peerId.toString(), {
-                anchor: state.anchor,
-                focus: state.focus,
-                user: state.user
-            });
-            // Validate and decode cursor data safely for callback
-            let anchor;
-            let focus;
-            if (state.anchor && state.anchor.length > 0) {
-                try {
-                    anchor = Cursor.decode(state.anchor);
-                }
-                catch (error) {
-                    console.warn('Failed to decode anchor cursor:', error);
-                }
-            }
-            if (state.focus && state.focus.length > 0) {
-                try {
-                    focus = Cursor.decode(state.focus);
-                }
-                catch (error) {
-                    console.warn('Failed to decode focus cursor:', error);
-                }
-            }
-            if (anchor || focus) {
-                // The awareness callback will handle the cursor conversion
-                // Just trigger a notification that this peer's cursor has changed
-                setTimeout(() => {
-                    // Force the awareness callback to run by notifying listeners
-                    this.notifyListeners();
-                }, 0);
-            }
-        }
-        catch (error) {
-            console.error('Error processing remote state:', error);
-        }
-    }
-    // Add methods for compatibility with existing code
-    addListener(callback) {
-        this.listeners.push(callback);
-    }
-    removeListener(callback) {
-        const index = this.listeners.indexOf(callback);
-        if (index > -1) {
-            this.listeners.splice(index, 1);
-        }
-    }
-    notifyListeners(event) {
-        const states = new Map();
-        const allStates = this.ephemeralStore.getAllStates();
-        for (const [peer, state] of Object.entries(allStates)) {
-            states.set(peer, state);
-        }
-        this.listeners.forEach(listener => listener(states, event));
-    }
-    // Get encoded data for network transmission
-    encode() {
-        return this.ephemeralStore.encodeAll();
-    }
-    // Apply received encoded data
-    apply(data) {
-        this.ephemeralStore.apply(data);
-        // Trigger listeners after applying external data
-        this.notifyListeners();
-    }
-    setRemoteCursorCallback(callback) {
-        this._onRemoteCursorUpdate = callback;
-    }
-    // Simplified cursor creation from Lexical point (inspired by YJS createRelativePosition)
-    // Loro Cursor = container ID + character ID, much simpler than YJS RelativePosition
-    createLoroPosition(nodeKey, offset, textContainer) {
-        try {
-            if (!this.loroDoc || !textContainer) {
-                console.warn('❌ No Loro document or text container available');
-                return null;
-            }
-            // SIMPLIFIED APPROACH: For Loro, we just need the global text position
-            // Loro will handle the container ID + character ID mapping internally
-            const globalPosition = this.calculateSimpleGlobalPosition(nodeKey, offset);
-            // Let Loro create the cursor with its internal container+character structure
-            const cursor = textContainer.getCursor(globalPosition);
-            console.log('🎯 Created Loro cursor:', {
-                nodeKey,
-                offset,
-                globalPosition,
-                cursorCreated: !!cursor
-            });
-            return cursor || null;
-        }
-        catch (error) {
-            console.warn('❌ Failed to create Loro position:', error);
-            return null;
-        }
-    }
-    // Simplified position calculation (much simpler than YJS approach)
-    calculateSimpleGlobalPosition(nodeKey, offset) {
-        // For Loro, we don't need complex CollabNode mapping like YJS
-        // Just calculate the simple global text position
-        // This is much simpler because Loro handles container+character mapping internally
-        // TODO: Implement simple document traversal
-        // For now, return a basic position - this would be implemented with:
-        // 1. Find the text node in the document
-        // 2. Calculate its start position 
-        // 3. Add the offset within that node
-        console.log('🔄 Calculating simple position for Loro cursor:', { nodeKey, offset });
-        return 0; // Placeholder for simplified implementation
-    }
-    // Debug method to access raw ephemeral store data
-    getRawStates() {
-        return this.ephemeralStore.getAllStates();
-    }
-}
-export function LoroCollaborativePlugin({ websocketUrl, docId, onConnectionChange, onDisconnectReady, onPeerIdChange, onAwarenessChange, onInitialization, onSendMessageReady }) {
-    const [editor] = useLexicalComposerContext();
-    const wsRef = useRef(null);
-    const loroDocRef = useRef(new LoroDoc());
-    const loroTextRef = useRef(null);
-    const isLocalChange = useRef(false);
-    const hasReceivedInitialSnapshot = useRef(false);
-    // Cursor awareness system
-    const awarenessRef = useRef(null);
-    const [remoteCursors, setRemoteCursors] = useState({});
-    const [clientId, setClientId] = useState('');
-    const [clientColor, setClientColor] = useState('');
-    const peerIdRef = useRef(''); // Changed from numericPeerIdRef to handle string IDs
-    // Version vector state for optimized updates
-    const [lastSentVersionVector, setLastSentVersionVector] = useState(null);
-    const isConnectingRef = useRef(false);
-    const [forceUpdate, setForceUpdate] = useState(0); // Force cursor re-render
-    const cursorTimestamps = useRef({});
-    const updateLoroFromLexical = useCallback((editorState) => {
-        if (!loroTextRef.current)
-            return;
-        let editorStateJson = '';
-        editorState.read(() => {
-            // Store the raw Lexical EditorState JSON instead of HTML
-            const serialized = editorState.toJSON();
-            editorStateJson = JSON.stringify(serialized);
-        });
-        const currentLoroText = loroTextRef.current.toString();
-        if (currentLoroText === editorStateJson)
-            return;
-        // Mark this as a local change
-        isLocalChange.current = true;
-        // FIXED: Use incremental text operations instead of wholesale replacement
-        // This prevents massive changes that can cause connection issues
-        try {
-            // Calculate the difference between current and new content
-            const oldContent = currentLoroText;
-            const newContent = editorStateJson;
-            // Find common prefix and suffix to minimize changes
-            let prefixEnd = 0;
-            const minLength = Math.min(oldContent.length, newContent.length);
-            // Find common prefix
-            while (prefixEnd < minLength && oldContent[prefixEnd] === newContent[prefixEnd]) {
-                prefixEnd++;
-            }
-            // Find common suffix
-            let suffixStart = oldContent.length;
-            let newSuffixStart = newContent.length;
-            while (suffixStart > prefixEnd && newSuffixStart > prefixEnd &&
-                oldContent[suffixStart - 1] === newContent[newSuffixStart - 1]) {
-                suffixStart--;
-                newSuffixStart--;
-            }
-            // Apply incremental changes
-            if (prefixEnd < suffixStart) {
-                // Delete the changed portion
-                const deleteLength = suffixStart - prefixEnd;
-                if (deleteLength > 0) {
-                    loroTextRef.current.delete(prefixEnd, deleteLength);
-                }
-            }
-            if (prefixEnd < newSuffixStart) {
-                // Insert the new content
-                const insertText = newContent.substring(prefixEnd, newSuffixStart);
-                if (insertText.length > 0) {
-                    loroTextRef.current.insert(prefixEnd, insertText);
-                }
-            }
-        }
-        catch (error) {
-            console.warn('Error with incremental update, falling back to full replacement:', error);
-            // Fallback to full replacement if incremental update fails
-            loroTextRef.current.delete(0, currentLoroText.length);
-            loroTextRef.current.insert(0, editorStateJson);
-        }
-        // Send update to WebSocket server
-        if (wsRef.current && wsRef.current.readyState === WebSocket.OPEN) {
-            // Use the new export method with version vector optimization
-            const currentVersion = loroDocRef.current.version();
-            const update = loroDocRef.current.export({
-                mode: "update",
-                from: lastSentVersionVector || undefined
-            });
-            // Update the last sent version vector
-            setLastSentVersionVector(currentVersion);
-            wsRef.current.send(JSON.stringify({
-                type: 'loro-update',
-                update: Array.from(update),
-                docId: docId
-            }));
-            // Also send a snapshot occasionally to keep server state updated
-            if (Math.random() < 0.1) { // 10% chance to send snapshot
-                const snapshot = loroDocRef.current.export({ mode: "snapshot" });
-                wsRef.current.send(JSON.stringify({
-                    type: 'snapshot',
-                    snapshot: Array.from(snapshot),
-                    docId: docId
-                }));
-            }
-        }
-        // Reset the flag after a delay to prevent infinite loops
-        setTimeout(() => {
-            isLocalChange.current = false;
-        }, 50);
-    }, [docId, lastSentVersionVector, setLastSentVersionVector]);
-    const updateLexicalFromLoro = useCallback((editor, incoming) => {
-        if (isLocalChange.current)
-            return; // Don't update if this is a local change
-        isLocalChange.current = true;
-        let applied = false;
-        editor.update(() => {
-            const root = $getRoot();
-            // Avoid unnecessary updates when the incoming JSON exactly matches current state
-            try {
-                const currentStateJson = JSON.stringify(editor.getEditorState().toJSON());
-                if (incoming === currentStateJson) {
-                    isLocalChange.current = false;
-                    return;
-                }
-            }
-            catch {
-                // ignore JSON stringify/compare failure; not critical for update gating
-            }
-            try {
-                if (incoming && incoming.trim().length > 0) {
-                    // Try to parse as Lexical EditorState JSON first
-                    try {
-                        const parsed = JSON.parse(incoming);
-                        // Support both raw EditorState and wrapper { editorState: { ... } }
-                        const stateLike = (parsed && typeof parsed === 'object' && parsed.editorState)
-                            ? parsed.editorState
-                            : parsed;
-                        if (stateLike && typeof stateLike === 'object' && stateLike.root && stateLike.root.type === 'root') {
-                            const newEditorState = editor.parseEditorState(stateLike);
-                            editor.setEditorState(newEditorState);
-                            applied = true;
-                        }
-                    }
-                    catch {
-                        // Not JSON; will treat as plain text below
-                    }
-                    if (!applied) {
-                        // Treat incoming as plain text (e.g., from Python server)
-                        root.clear();
-                        const lines = incoming.split(/\r?\n/);
-                        if (lines.length === 0) {
-                            const p = $createParagraphNode();
-                            root.append(p);
-                        }
-                        else {
-                            for (const line of lines) {
-                                const p = $createParagraphNode();
-                                if (line.length > 0) {
-                                    p.append($createTextNode(line));
-                                }
-                                root.append(p);
-                            }
-                        }
-                        applied = true;
-                    }
-                }
-                else {
-                    // Empty content -> ensure there's one empty paragraph
-                    root.clear();
-                    const paragraph = $createParagraphNode();
-                    root.append(paragraph);
-                    applied = true;
-                }
-                // Defer UUID assignment to a follow-up update to avoid frozen node map mutations
-            }
-            catch (error) {
-                console.error('Error applying incoming content to Lexical editor:', error);
-                // Fallback: create a single empty paragraph
-                root.clear();
-                const paragraph = $createParagraphNode();
-                root.append(paragraph);
-            }
-        }, { tag: 'collaboration' });
-        if (applied) {
-            // Ensure the previous update is committed before assigning UUIDs
-            setTimeout(() => {
-                editor.update(() => {
-                    try {
-                        $ensureAllNodesHaveStableIds();
-                        console.log('🆔 Assigned stable UUIDs after applying incoming content');
-                    }
-                    catch (e) {
-                        console.warn('⚠️ Failed to assign stable UUIDs in deferred update:', e);
-                    }
-                }, { tag: 'uuid-assignment' });
-            }, 0);
-        }
-        // Reset the flag after a short delay
-        setTimeout(() => {
-            isLocalChange.current = false;
-        }, 50);
-    }, []);
-    // Send cursor position using Awareness
-    const updateCursorAwareness = useCallback(() => {
-        if (!awarenessRef.current || !loroTextRef.current)
-            return;
-        editor.getEditorState().read(() => {
-            const selection = $getSelection();
-            if ($isRangeSelection(selection)) {
-                try {
-                    // =================================================================
-                    // NEW STABLE UUID APPROACH - Replace unstable NodeKeys
-                    // =================================================================
-                    // Create stable positions using UUIDs instead of NodeKeys
-                    const anchorStablePos = $createStablePositionFromPoint({
-                        key: selection.anchor.key,
-                        offset: selection.anchor.offset
-                    });
-                    const focusStablePos = $createStablePositionFromPoint({
-                        key: selection.focus.key,
-                        offset: selection.focus.offset
-                    });
-                    if (!anchorStablePos || !focusStablePos) {
-                        console.warn('❌ Failed to create stable positions');
-                        return;
-                    }
-                    console.log('🎯 Created stable UUID-based positions:', {
-                        anchor: anchorStablePos,
-                        focus: focusStablePos
-                    });
-                    // LEGACY APPROACH for Loro cursor creation (still needed for now)
-                    // Create Loro cursors using the resolved NodeKeys
-                    const anchorKey = selection.anchor.key;
-                    const anchorOffset = selection.anchor.offset;
-                    const focusKey = selection.focus.key;
-                    const focusOffset = selection.focus.offset;
-                    const anchor = awarenessRef.current.createLoroPosition(anchorKey, anchorOffset, loroTextRef.current);
-                    const focus = awarenessRef.current.createLoroPosition(focusKey, focusOffset, loroTextRef.current);
-                    if (!anchor || !focus) {
-                        console.warn('❌ Failed to create Loro cursors');
-                        return;
-                    }
-                    console.log('🎯 Created Loro cursors with stable position data:', {
-                        anchorStableId: anchorStablePos.stableNodeId,
-                        focusStableId: focusStablePos.stableNodeId,
-                        anchorCreated: !!anchor,
-                        focusCreated: !!focus
-                    });
-                    // Extract meaningful part from client ID
-                    const extractedId = clientId.includes('_') ?
-                        clientId.split('_').find(part => /^\d{13}$/.test(part)) || clientId.slice(-8) :
-                        clientId.slice(-8);
-                    // ENHANCED: Store stable UUID-based cursor data instead of NodeKeys
-                    const userWithCursorData = {
-                        name: extractedId,
-                        color: clientColor || '#007acc',
-                        // NEW: Use stable UUIDs that survive document edits
-                        stableCursor: {
-                            // Store stable UUIDs instead of unstable NodeKeys
-                            anchorStableId: anchorStablePos.stableNodeId,
-                            anchorOffset: anchorStablePos.offset,
-                            anchorType: anchorStablePos.type,
-                            focusStableId: focusStablePos.stableNodeId,
-                            focusOffset: focusStablePos.offset,
-                            focusType: focusStablePos.type,
-                            timestamp: Date.now()
-                        }
-                    };
-                    awarenessRef.current.setLocal({
-                        anchor,
-                        focus,
-                        user: userWithCursorData
-                    });
-                    console.log('🎯 Set awareness with stable cursor data:', { userWithCursorData, clientId });
-                    // Send ephemeral update to other clients via WebSocket
-                    if (wsRef.current && wsRef.current.readyState === WebSocket.OPEN && awarenessRef.current) {
-                        try {
-                            const ephemeralData = awarenessRef.current.encode();
-                            // Validate ephemeral data before sending
-                            if (!ephemeralData || ephemeralData.length === 0) {
-                                console.warn('⚠️ Empty ephemeral data, skipping send');
-                                return;
-                            }
-                            const hexData = Array.from(ephemeralData).map(b => b.toString(16).padStart(2, '0')).join('');
-                            // Validate hex data
-                            if (!hexData || hexData.length === 0) {
-                                console.warn('⚠️ Empty hex data, skipping send');
-                                return;
-                            }
-                            wsRef.current.send(JSON.stringify({
-                                type: 'ephemeral-update',
-                                docId: docId,
-                                data: hexData // Convert to hex string
-                            }));
-                            console.log('📤 Sent ephemeral update:', { docId, dataLength: hexData.length });
-                        }
-                        catch (error) {
-                            console.error('❌ Error encoding/sending ephemeral data:', error);
-                        }
-                    }
-                }
-                catch (error) {
-                    console.warn('Error creating cursor:', error);
-                }
-            }
-        });
-    }, [editor, clientId, clientColor, docId]);
-    useEffect(() => {
-        // Initialize Loro document and text object
-        loroTextRef.current = loroDocRef.current.getText(docId);
-        // Only initialize awareness if it doesn't exist yet
-        if (!awarenessRef.current) {
-            // Initialize cursor awareness with a temporary numeric ID
-            // We'll update this with the actual client ID when we receive the welcome message
-            const tempNumericId = Date.now(); // Temporary ID until we get the real client ID
-            peerIdRef.current = tempNumericId.toString();
-            awarenessRef.current = new CursorAwareness(tempNumericId.toString(), loroDocRef.current);
-            console.log('🎯 Initializing awareness with temporary numeric ID:', tempNumericId, '(will be updated with client ID)');
-        }
-        else {
-            console.log('🎯 Awareness already exists, skipping initialization');
-        }
-        // Subscribe to awareness changes with event-aware callback
-        const awarenessCallback = (_states, event) => {
-            console.log('🚨 AWARENESS CALLBACK TRIGGERED!', {
-                event: event ? {
-                    by: event.by,
-                    added: event.added,
-                    updated: event.updated,
-                    removed: event.removed
-                } : 'no event',
-                statesSize: _states?.size,
-                timestamp: Date.now()
-            });
-            if (awarenessRef.current) {
-                const allCursors = awarenessRef.current.getAll();
-                const remoteCursorsData = {};
-                const currentPeerId = peerIdRef.current || clientId;
-                console.log('👁️ Awareness callback - all cursors:', allCursors);
-                console.log('👁️ Current peer ID:', currentPeerId);
-                console.log('👁️ All cursor peer IDs:', Object.keys(allCursors));
-                // Debug: Check raw ephemeral store data
-                const rawStates = awarenessRef.current.getRawStates();
-                console.log('👁️ Raw ephemeral store states:', rawStates);
-                console.log('👁️ Awareness callback triggered:', {
-                    event: event ? {
-                        by: event.by,
-                        added: event.added,
-                        updated: event.updated,
-                        removed: event.removed
-                    } : 'no event',
-                    allCursorsKeys: Object.keys(allCursors),
-                    allCursorsDetail: allCursors,
-                    currentPeerId: currentPeerId,
-                    clientId: clientId
-                });
-                // CRITICAL DEBUG: Check if we have remote cursors before processing
-                const remoteCursorsBefore = Object.keys(allCursors).filter(peerId => peerId !== currentPeerId);
-                console.log('🔍 Remote cursors BEFORE processing:', remoteCursorsBefore);
-                console.log('🔍 ALL CURSORS DATA:', allCursors);
-                console.log('🔍 TOTAL CURSORS COUNT:', Object.keys(allCursors).length);
-                // Use event information to optimize cursor processing
-                let peersToProcess = [];
-                if (event) {
-                    console.log('🔍 DETAILED EVENT ANALYSIS:', {
-                        eventBy: event.by,
-                        isImportEvent: event.by === 'import',
-                        isImportEventCaseInsensitive: event.by?.toLowerCase() === 'import',
-                        removedCount: event.removed?.length || 0,
-                        removedPeers: event.removed || [],
-                        addedCount: event.added?.length || 0,
-                        updatedCount: event.updated?.length || 0
-                    });
-                    // Check if this is a local event (our own cursor update)
-                    const isLocalEvent = event.by === 'local' || event.by === currentPeerId;
-                    const isImportEvent = event.by === 'import' || event.by?.toLowerCase() === 'import';
-                    if (isLocalEvent) {
-                        console.log('👁️ Local event detected - processing all cursors to ensure remote cursors remain visible');
-                        // For local events, process all cursors to maintain remote cursor visibility
-                        peersToProcess = Object.keys(allCursors);
-                    }
-                    else if (isImportEvent) {
-                        console.log('👁️ Import event detected - processing all current cursors to maintain visibility');
-                        // For import events, process all current cursors to maintain remote cursor visibility
-                        // Import events often have misleading added/updated arrays
-                        peersToProcess = Object.keys(allCursors);
-                    }
-                    else {
-                        console.log('👁️ Remote event detected - processing only changed peers');
-                        // For other remote events, process only the peers that changed
-                        peersToProcess = [...event.added, ...event.updated];
-                    }
-                    console.log('👁️ Event-driven processing - peers to process:', peersToProcess);
-                    // CRITICAL FIX: Be much more conservative about removals
-                    // Only remove cursors if they're not in the current allCursors AND
-                    // this is not an "import" event (which often has false removals)
-                    if (event.removed && event.removed.length > 0) {
-                        console.log('🔍 REMOVAL EVENT ANALYSIS:', {
-                            eventBy: event.by,
-                            isImport: event.by?.toLowerCase() === 'import',
-                            isImportLowercase: event.by?.toLowerCase() === 'import',
-                            removedPeers: event.removed,
-                            shouldIgnore: event.by?.toLowerCase() === 'import'
-                        });
-                        if (event.by?.toLowerCase() === 'import') {
-                            console.log('👁️ 🚫 IGNORING import-based removal events (often false positives):', event.removed);
-                            // Don't process removals for import events - they're usually false positives
-                        }
-                        else {
-                            console.log('👁️ Processing potential removals for peers (non-import event):', event.removed);
-                            const currentAllCursors = awarenessRef.current.getAll();
-                            const currentPeerIds = Object.keys(currentAllCursors);
-                            console.log('🔍 REMOVAL VALIDATION:', {
-                                removedPeers: event.removed,
-                                currentPeerIds: currentPeerIds,
-                                peerStillExists: event.removed.map(peerId => ({
-                                    peerId,
-                                    stillExists: currentPeerIds.includes(peerId)
-                                }))
-                            });
-                            event.removed.forEach(peerId => {
-                                // Only remove if the peer is truly no longer in the awareness state
-                                if (!currentPeerIds.includes(peerId)) {
-                                    console.log('👁️ ✅ Confirmed removal - peer not in current state:', peerId);
-                                    setRemoteCursors(prev => {
-                                        const updated = { ...prev };
-                                        delete updated[peerId];
-                                        console.log('👁️ Removed peer from remote cursors:', peerId);
-                                        return updated;
-                                    });
-                                    // Clear cursor timestamps
-                                    delete cursorTimestamps.current[peerId];
-                                }
-                                else {
-                                    console.log('👁️ ❌ Ignoring removal - peer still in current state:', peerId);
-                                }
-                            });
-                        }
-                    }
-                    // Don't force reprocessing of all peers, just continue with the event-driven processing
-                }
-                else {
-                    // No event info, process all cursors
-                    peersToProcess = Object.keys(allCursors);
-                    console.log('👁️ Full processing - all peers:', peersToProcess);
-                }
-                // Process the relevant peers
-                console.log('🔍 PEER PROCESSING START:', {
-                    peersToProcess,
-                    totalPeersInAllCursors: Object.keys(allCursors).length,
-                    currentPeerId
-                });
-                peersToProcess.forEach(peerId => {
-                    const cursorData = allCursors[peerId];
-                    console.log('🔍 Processing peer:', peerId, {
-                        hasData: !!cursorData,
-                        isCurrentUser: peerId === currentPeerId,
-                        cursorData: cursorData ? {
-                            hasAnchor: !!cursorData.anchor,
-                            hasFocus: !!cursorData.focus,
-                            hasUser: !!cursorData.user
-                        } : 'NO DATA'
-                    });
-                    if (!cursorData) {
-                        console.log('⚠️ No cursor data for peer:', peerId);
-                        return;
-                    }
-                    // Only exclude our own cursor (using current peer ID)
-                    if (peerId !== currentPeerId) {
-                        console.log('👁️ Processing remote cursor for peer:', peerId, {
-                            hasAnchor: !!cursorData.anchor,
-                            hasFocus: !!cursorData.focus,
-                            hasUser: !!cursorData.user,
-                            hasStableCursor: !!cursorData.user?.stableCursor,
-                            user: cursorData.user
-                        });
-                        let anchorPos;
-                        let focusPos;
-                        // Check if we have stable cursor data in user metadata (preferred)
-                        const stableCursor = cursorData.user?.stableCursor;
-                        // =================================================================
-                        // NEW STABLE UUID RESOLUTION - Replace NodeKey validation
-                        // =================================================================
-                        if (stableCursor && stableCursor.anchorStableId && stableCursor.focusStableId) {
-                            console.log('👁️ Using NEW stable UUID-based cursor data:', stableCursor);
-                            // Use stable UUIDs to resolve positions
-                            const anchorResolved = editor.getEditorState().read(() => {
-                                return $resolveStablePosition({
-                                    stableNodeId: stableCursor.anchorStableId,
-                                    offset: stableCursor.anchorOffset,
-                                    type: stableCursor.anchorType || 'text'
-                                });
-                            });
-                            const focusResolved = editor.getEditorState().read(() => {
-                                return $resolveStablePosition({
-                                    stableNodeId: stableCursor.focusStableId,
-                                    offset: stableCursor.focusOffset,
-                                    type: stableCursor.focusType || 'text'
-                                });
-                            });
-                            if (anchorResolved && focusResolved) {
-                                console.log('✅ Successfully resolved stable UUID positions:', {
-                                    anchorStableId: stableCursor.anchorStableId,
-                                    focusStableId: stableCursor.focusStableId,
-                                    anchorNodeKey: anchorResolved.key,
-                                    focusNodeKey: focusResolved.key
-                                });
-                                anchorPos = {
-                                    key: anchorResolved.key,
-                                    offset: anchorResolved.offset,
-                                    type: 'text'
-                                };
-                                focusPos = {
-                                    key: focusResolved.key,
-                                    offset: focusResolved.offset,
-                                    type: 'text'
-                                };
-                            }
-                            else {
-                                console.log('🔄 STABLE UUID RESOLUTION FAILED - positions will use document fallback:', {
-                                    anchorStableId: stableCursor.anchorStableId,
-                                    focusStableId: stableCursor.focusStableId,
-                                    anchorResolved: !!anchorResolved,
-                                    focusResolved: !!focusResolved,
-                                    note: 'Fallback positioning will be used - this prevents (0,0) cursor jumps'
-                                });
-                                // anchorPos and focusPos will remain undefined, triggering legacy fallback
-                            }
-                        }
-                        // FALLBACK: Legacy NodeKey-based approach (for backwards compatibility)
-                        else if (stableCursor && stableCursor.anchorKey && typeof stableCursor.anchorOffset === 'number') {
-                            console.log('👁️ Fallback to legacy NodeKey-based cursor data:', stableCursor);
-                            // ENHANCEMENT: Use cursor side information for better positioning
-                            // The stableCursor now includes anchorSide and focusSide following Loro Cursor patterns
-                            const hasPositioningSides = stableCursor.anchorSide && stableCursor.focusSide;
-                            if (hasPositioningSides) {
-                                console.log('🎯 Enhanced positioning with cursor side information:', {
-                                    anchorSide: stableCursor.anchorSide,
-                                    focusSide: stableCursor.focusSide
-                                });
-                            }
-                            // Validate that the node keys still exist in the current editor state
-                            const validAnchor = editor.getEditorState().read(() => {
-                                const anchorNode = $getNodeByKey(stableCursor.anchorKey);
-                                const isValid = !!anchorNode;
-                                console.log('🔍 Anchor node validation:', {
-                                    key: stableCursor.anchorKey,
-                                    found: isValid,
-                                    nodeType: anchorNode?.getType?.() || 'null'
-                                });
-                                return isValid;
-                            });
-                            const validFocus = editor.getEditorState().read(() => {
-                                const focusNode = $getNodeByKey(stableCursor.focusKey);
-                                const isValid = !!focusNode;
-                                console.log('🔍 Focus node validation:', {
-                                    key: stableCursor.focusKey,
-                                    found: isValid,
-                                    nodeType: focusNode?.getType?.() || 'null'
-                                });
-                                return isValid;
-                            });
-                            if (validAnchor && validFocus) {
-                                console.log('✅ Using stable cursor data - nodes are valid');
-                                anchorPos = {
-                                    key: stableCursor.anchorKey,
-                                    offset: stableCursor.anchorOffset,
-                                    type: 'text'
-                                };
-                                focusPos = {
-                                    key: stableCursor.focusKey,
-                                    offset: stableCursor.focusOffset,
-                                    type: 'text'
-                                };
-                                console.log('👁️ Successfully used stable cursor data:', { anchorPos, focusPos });
-                            }
-                            else {
-                                console.log('👁️ Node keys invalid, using line-aware stable fallback');
-                                // LINE-AWARE MINIMAL FALLBACK: Try to preserve which line the cursor was on
-                                const lineAwarePosition = editor.getEditorState().read(() => {
-                                    const root = $getRoot();
-                                    const children = root.getChildren();
-                                    // Build a simple map of text nodes (representing lines/paragraphs)
-                                    const textNodesList = [];
-                                    let lineIndex = 0;
-                                    for (const child of children) {
-                                        if ($isElementNode(child)) {
-                                            const textChildren = child.getChildren().filter($isTextNode);
-                                            for (const textNode of textChildren) {
-                                                textNodesList.push({ node: textNode, lineIndex });
-                                            }
-                                            // Each element (paragraph/div) represents a new line
-                                            if (textChildren.length > 0) {
-                                                lineIndex++;
-                                            }
-                                        }
-                                    }
-                                    console.log('👁️ Document structure for line-aware fallback:', {
-                                        totalLines: lineIndex,
-                                        totalTextNodes: textNodesList.length,
-                                        originalOffset: stableCursor.anchorOffset
-                                    });
-                                    if (textNodesList.length === 0) {
-                                        // No text nodes, use root
-                                        return {
-                                            key: root.getKey(),
-                                            offset: 0,
-                                            type: 'text'
-                                        };
-                                    }
-                                    // SMART ESTIMATION: Use the original offset to guess which line
-                                    const originalOffset = stableCursor.anchorOffset;
-                                    let targetLineIndex = 0;
-                                    if (textNodesList.length > 1) {
-                                        // Multiple lines available - estimate which line based on offset
-                                        if (originalOffset <= 10) {
-                                            targetLineIndex = 0; // Small offset = first line
-                                        }
-                                        else if (originalOffset <= 30) {
-                                            targetLineIndex = Math.min(1, textNodesList.length - 1); // Medium offset = second line
-                                        }
-                                        else {
-                                            // Large offset = later line (proportional)
-                                            targetLineIndex = Math.min(Math.floor(originalOffset / 25), // Assume ~25 chars per line average
-                                            textNodesList.length - 1);
-                                        }
-                                    }
-                                    // Find text node for the target line
-                                    const targetTextNodeInfo = textNodesList.find(info => info.lineIndex === targetLineIndex) || textNodesList[0];
-                                    const targetTextNode = targetTextNodeInfo.node;
-                                    // Use a small, safe offset within that line
-                                    const safeOffset = Math.min(1, targetTextNode.getTextContentSize());
-                                    console.log('👁️ Line-aware positioning:', {
-                                        originalOffset,
-                                        estimatedLine: targetLineIndex,
-                                        selectedLine: targetTextNodeInfo.lineIndex,
-                                        nodeKey: targetTextNode.getKey(),
-                                        safeOffset,
-                                        nodeText: targetTextNode.getTextContent().substring(0, 15)
-                                    });
-                                    return {
-                                        key: targetTextNode.getKey(),
-                                        offset: safeOffset,
-                                        type: 'text'
-                                    };
-                                });
-                                anchorPos = lineAwarePosition;
-                                focusPos = lineAwarePosition;
-                                console.log('👁️ Applied line-aware stable fallback:', { anchorPos, focusPos });
-                            }
-                        }
-                        else {
-                            console.log('👁️ No stable cursor data available, creating smart fallback positions');
-                            // Instead of trying LORO cursor conversion (which we skip), create immediate fallback
-                            const smartFallbackPosition = editor.getEditorState().read(() => {
-                                const root = $getRoot();
-                                const children = root.getChildren();
-                                // Find the first available text node
-                                for (const child of children) {
-                                    if ($isElementNode(child)) {
-                                        const grandChildren = child.getChildren();
-                                        for (const grandChild of grandChildren) {
-                                            if ($isTextNode(grandChild)) {
-                                                console.log('👁️ Using first available text node for cursor:', {
-                                                    nodeKey: grandChild.getKey(),
-                                                    textContent: grandChild.getTextContent().substring(0, 30)
-                                                });
-                                                return {
-                                                    key: grandChild.getKey(),
-                                                    offset: Math.min(5, grandChild.getTextContent().length), // Small offset from start
-                                                    type: 'text'
-                                                };
-                                            }
-                                        }
-                                    }
-                                }
-                                // Fallback to root if no text nodes found
-                                console.log('👁️ No text nodes found, using root as fallback');
-                                return {
-                                    key: root.getKey(),
-                                    offset: 0,
-                                    type: 'text'
-                                };
-                            });
-                            anchorPos = smartFallbackPosition;
-                            focusPos = smartFallbackPosition;
-                            console.log('👁️ Applied smart fallback for no stable cursor data:', { anchorPos, focusPos });
-                        }
-                        // ENHANCEMENT: Direct Loro cursor conversion path
-                        // When stable cursor data is not available, we could use the improved
-                        // CursorAwareness methods to convert Loro cursors to Lexical positions:
-                        //
-                        // if (cursorData.anchor && awarenessRef.current) {
-                        //   const stableAnchorPos = awarenessRef.current.getStableCursorPosition(cursorData.anchor);
-                        //   if (stableAnchorPos !== null) {
-                        //     // Convert stable position to Lexical node position using document traversal
-                        //     anchorPos = convertGlobalPositionToLexical(stableAnchorPos);
-                        //   }
-                        // }
-                        //
-                        // This would provide better cursor positioning than approximations
-                        console.log('👁️ Note: Enhanced Loro cursor conversion framework available for implementation');
-                        console.log('👁️ Converted positions for peer:', peerId, {
-                            anchorPos,
-                            focusPos
-                        });
-                        // CRITICAL: Ensure we always have valid anchor and focus positions
-                        if (!anchorPos || !focusPos) {
-                            console.log('🚨 Missing anchor or focus position, creating smart fallback for peer:', peerId);
-                            // Try to use the stored stable cursor as reference for finding a similar position
-                            let referencePosition = null;
-                            if (stableCursor && stableCursor.anchorKey && typeof stableCursor.anchorOffset === 'number') {
-                                referencePosition = {
-                                    anchorKey: stableCursor.anchorKey,
-                                    anchorOffset: stableCursor.anchorOffset
-                                };
-                            }
-                            const smartPosition = editor.getEditorState().read(() => {
-                                const root = $getRoot();
-                                // If we have a reference position, calculate the global document position
-                                // and try to find a position that maintains the same relative location
-                                if (referencePosition) {
-                                    console.log('🔄 Using reference position for smart fallback:', referencePosition);
-                                    // First, try to find the exact same node (it might still exist)
-                                    let targetNode = null;
-                                    const findExactNode = (node) => {
-                                        if (node.getKey() === referencePosition.anchorKey) {
-                                            targetNode = node;
-                                            return true;
-                                        }
-                                        if ($isElementNode(node)) {
-                                            const nodeChildren = node.getChildren();
-                                            for (const child of nodeChildren) {
-                                                if (findExactNode(child)) {
-                                                    return true;
-                                                }
-                                            }
-                                        }
-                                        return false;
-                                    };
-                                    findExactNode(root);
-                                    if (targetNode && $isTextNode(targetNode)) {
-                                        const textNode = targetNode;
-                                        const textLength = textNode.getTextContent().length;
-                                        const safeOffset = Math.min(referencePosition.anchorOffset, textLength);
-                                        console.log('🔄 Found exact node still exists:', {
-                                            nodeKey: textNode.getKey(),
-                                            offset: safeOffset
-                                        });
-                                        return {
-                                            key: textNode.getKey(),
-                                            offset: safeOffset,
-                                            type: 'text'
-                                        };
-                                    }
-                                    // If exact node not found, we need to calculate the global position
-                                    // that this cursor was at and find the equivalent position in the new tree
-                                    console.log('🔄 Exact node not found, calculating global position equivalent');
-                                    // Instead of guessing, let's calculate where this cursor should be
-                                    // based on the current document structure
-                                    const fullDocumentText = root.getTextContent();
-                                    console.log('🔄 Full document text for position calculation:', {
-                                        text: JSON.stringify(fullDocumentText),
-                                        length: fullDocumentText.length
-                                    });
-                                    // Calculate a reasonable position: try to maintain the same relative position
-                                    // For a simple approach, let's use the offset as a ratio of the original node length
-                                    // and apply that ratio to a reasonable position in the current document
-                                    // Find a good text node to place the cursor in
-                                    let bestFallbackNode = null;
-                                    let bestFallbackOffset = 0;
-                                    const findBestFallbackPosition = (node) => {
-                                        if ($isTextNode(node)) {
-                                            const textContent = node.getTextContent();
-                                            const textLength = textContent.length;
-                                            if (textLength > 0 && !bestFallbackNode) {
-                                                bestFallbackNode = node;
-                                                // Use a reasonable offset: if original offset was small, use small offset
-                                                // if original offset was large relative to typical text, use larger offset
-                                                const originalOffset = referencePosition.anchorOffset;
-                                                if (originalOffset <= 5) {
-                                                    // Original was near start, place near start
-                                                    bestFallbackOffset = Math.min(originalOffset, textLength);
-                                                }
-                                                else {
-                                                    // Original was further in, place proportionally
-                                                    bestFallbackOffset = Math.min(Math.floor(textLength * 0.3), textLength);
-                                                }
-                                            }
-                                        }
-                                        else if ($isElementNode(node)) {
-                                            const nodeChildren = node.getChildren();
-                                            for (const child of nodeChildren) {
-                                                findBestFallbackPosition(child);
-                                            }
-                                        }
-                                    };
-                                    findBestFallbackPosition(root);
-                                    if (bestFallbackNode && $isTextNode(bestFallbackNode)) {
-                                        const textNode = bestFallbackNode;
-                                        const textLength = textNode.getTextContent().length;
-                                        const safeOffset = Math.min(bestFallbackOffset, textLength);
-                                        console.log('🔄 Found proportional fallback position:', {
-                                            nodeKey: textNode.getKey(),
-                                            offset: safeOffset,
-                                            originalOffset: referencePosition.anchorOffset,
-                                            nodeLength: textLength
-                                        });
-                                        return {
-                                            key: textNode.getKey(),
-                                            offset: safeOffset,
-                                            type: 'text'
-                                        };
-                                    }
-                                }
-                                // If no reference position or position calculation failed,
-                                // fallback to a reasonable default position (not beginning of document)
-                                console.log('🔄 No reference position or calculation failed, using safe fallback');
-                                // Find the first text node with some content
-                                const findFirstTextNode = (node) => {
-                                    if ($isTextNode(node) && node.getTextContent().length > 0) {
-                                        return node;
-                                    }
-                                    if ($isElementNode(node)) {
-                                        const nodeChildren = node.getChildren();
-                                        for (const child of nodeChildren) {
-                                            const result = findFirstTextNode(child);
-                                            if (result)
-                                                return result;
-                                        }
-                                    }
-                                    return null;
-                                };
-                                const firstTextNode = findFirstTextNode(root);
-                                if (firstTextNode && $isTextNode(firstTextNode)) {
-                                    const textNode = firstTextNode;
-                                    // Place cursor at a reasonable position, not at the very beginning
-                                    const textLength = textNode.getTextContent().length;
-                                    const offset = Math.min(1, textLength); // Position 1 or end if shorter
-                                    console.log('🔄 Using reasonable position in first text node as fallback:', {
-                                        nodeKey: textNode.getKey(),
-                                        offset: offset,
-                                        textLength: textLength
-                                    });
-                                    return {
-                                        key: textNode.getKey(),
-                                        offset: offset,
-                                        type: 'text'
-                                    };
-                                }
-                                // Ultimate fallback to root
-                                console.log('🔄 Ultimate emergency fallback to root');
-                                return {
-                                    key: root.getKey(),
-                                    offset: 0,
-                                    type: 'text'
-                                };
-                            });
-                            anchorPos = anchorPos || smartPosition;
-                            focusPos = focusPos || smartPosition;
-                            console.log('🔄 Applied smart fallback positions:', { anchorPos, focusPos });
-                        }
-                        remoteCursorsData[peerId] = {
-                            peerId: peerId,
-                            anchor: anchorPos,
-                            focus: focusPos,
-                            user: cursorData.user
-                        };
-                    }
-                    else {
-                        console.log('👁️ Skipping own cursor for peer:', peerId);
-                    }
-                });
-                console.log('🔍 PEER PROCESSING END:', {
-                    remoteCursorsDataKeys: Object.keys(remoteCursorsData),
-                    remoteCursorsDataCount: Object.keys(remoteCursorsData).length,
-                    originalAllCursorsKeys: Object.keys(allCursors),
-                    currentPeerId,
-                    peersProcessed: peersToProcess
-                });
-                console.log('🎯 Setting remote cursors:', remoteCursorsData);
-                console.log('🔢 Remote cursors count after processing:', Object.keys(remoteCursorsData).length);
-                if (Object.keys(remoteCursorsData).length === 0) {
-                    console.log('💡 No remote cursors to display. Open another browser tab to see collaborative cursors!');
-                }
-                // Update cursor timestamps for activity tracking
-                const now = Date.now();
-                Object.keys(remoteCursorsData).forEach(peerId => {
-                    cursorTimestamps.current[peerId] = now;
-                });
-                setRemoteCursors(remoteCursorsData);
-                // Call awareness change callback for UI display (include ALL users, including self)
-                if (stableOnAwarenessChange.current) {
-                    const awarenessData = Object.keys(allCursors).map(peerId => {
-                        // Extract meaningful part from peer ID
-                        const extractedId = peerId.includes('_') ?
-                            peerId.split('_').find(part => /^\d{13}$/.test(part)) || peerId.slice(-8) :
-                            peerId.slice(-8);
-                        const isCurrentUser = peerId === currentPeerId;
-                        return {
-                            peerId: peerId,
-                            userName: allCursors[peerId]?.user?.name || extractedId,
-                            isCurrentUser: isCurrentUser
-                        };
-                    });
-                    stableOnAwarenessChange.current(awarenessData);
-                }
-                // Force cursor re-render when remote cursors change
-                setForceUpdate(prev => prev + 1);
-            }
-        };
-        // Only add the listener if this is a new awareness instance
-        const currentAwareness = awarenessRef.current;
-        if (currentAwareness) {
-            // Remove any existing listeners first to prevent duplicates
-            currentAwareness.removeListener(awarenessCallback);
-            // Add the new listener
-            currentAwareness.addListener(awarenessCallback);
-            console.log('🎯 Added awareness callback listener');
-        }
-        // Set up the remote cursor callback
-        awarenessRef.current.setRemoteCursorCallback((peerId, cursor) => {
-            console.log('🎯 Remote cursor callback triggered:', peerId, cursor);
-            setRemoteCursors(prev => {
-                const updated = {
-                    ...prev,
-                    [peerId]: cursor
-                };
-                console.log('🎯 Updated remote cursors state:', updated);
-                // Force cursor re-render
-                setForceUpdate(updateVal => updateVal + 1);
-                return updated;
-            });
-        });
-        // Subscribe to Loro document changes
-        const unsubscribe = loroDocRef.current.subscribe(() => {
-            if (!isLocalChange.current) {
-                // This is a remote change, update Lexical editor
-                const currentText = loroTextRef.current?.toString() || '';
-                updateLexicalFromLoro(editor, currentText);
-            }
-            // Force cursor re-render when document changes (content affects cursor positioning)
-            setForceUpdate(prev => prev + 1);
-        });
-        // Subscribe to Lexical editor changes with debouncing
-        let updateTimeout = null;
-        const removeEditorListener = editor.registerUpdateListener(({ editorState, tags }) => {
-            // Skip if this is a local change from our plugin
-            if (isLocalChange.current || tags.has('collaboration'))
-                return;
-            // =================================================================
-            // CRITICAL: Assign stable UUIDs to new nodes on local changes
-            // =================================================================
-            editor.update(() => {
-                $ensureAllNodesHaveStableIds();
-            }, { tag: 'uuid-assignment' });
-            // Clear previous timeout
-            if (updateTimeout) {
-                clearTimeout(updateTimeout);
-            }
-            // Debounce updates to prevent rapid firing
-            updateTimeout = setTimeout(() => {
-                if (!isLocalChange.current) {
-                    updateLoroFromLexical(editorState);
-                }
-            }, 25); // 25ms debounce for better responsiveness
-        });
-        return () => {
-            if (updateTimeout) {
-                clearTimeout(updateTimeout);
-            }
-            if (awarenessRef.current) {
-                awarenessRef.current.removeListener(awarenessCallback);
-                console.log('🎯 Removed awareness callback listener');
-            }
-            unsubscribe();
-            removeEditorListener();
-        };
-    }, [editor, docId, updateLoroFromLexical, updateLexicalFromLoro, clientId]);
-    // Connection retry state
-    const retryTimeoutRef = useRef(null);
-    const retryCountRef = useRef(0);
-    const maxRetries = 5;
-    // Create stable refs for callbacks to avoid dependency issues
-    const stableOnAwarenessChange = useRef(onAwarenessChange);
-    stableOnAwarenessChange.current = onAwarenessChange;
-    // WebSocket connection management with stable dependencies
-    const stableOnConnectionChange = useRef(onConnectionChange);
-    const stableOnDisconnectReady = useRef(onDisconnectReady);
-    const stableOnSendMessageReady = useRef(onSendMessageReady);
-    // Update refs when props change without triggering effect
-    useEffect(() => {
-        stableOnConnectionChange.current = onConnectionChange;
-        stableOnDisconnectReady.current = onDisconnectReady;
-        stableOnSendMessageReady.current = onSendMessageReady;
-    });
-    useEffect(() => {
-        // Close any existing connection before creating a new one
-        if (wsRef.current) {
-            wsRef.current.close();
-            wsRef.current = null;
-        }
-        const connectWebSocket = () => {
-            // Prevent multiple connections
-            if (isConnectingRef.current || (wsRef.current && wsRef.current.readyState === WebSocket.OPEN)) {
-                return;
-            }
-            try {
-                isConnectingRef.current = true;
-                const ws = new WebSocket(websocketUrl);
-                wsRef.current = ws;
-                // Wrap send to log all outgoing messages with a clear, visible marker
-                try {
-                    const originalSend = ws.send.bind(ws);
-                    ws.send = (data) => {
-                        try {
-                            if (typeof data === 'string') {
-                                const len = data.length;
-                                let parsed = null;
-                                try {
-                                    parsed = JSON.parse(data);
-                                }
-                                catch { /* ignore parse errors for preview */ }
-                                const preview = data.slice(0, 300) + (len > 300 ? '…' : '');
-                                console.log('🛰️📤 WS SEND →', {
-                                    type: parsed?.type,
-                                    docId: parsed?.docId,
-                                    length: len,
-                                    keys: parsed ? Object.keys(parsed) : ['<unparsed>'],
-                                    preview
-                                });
-                            }
-                            else {
-                                console.log('🛰️📤 WS SEND → (non-string payload)', { kind: typeof data });
-                            }
-                        }
-                        catch (logErr) {
-                            console.warn('WS send log failed:', logErr);
-                        }
-                        return originalSend(data);
-                    };
-                }
-                catch (wrapErr) {
-                    console.warn('Failed to wrap WebSocket.send for logging:', wrapErr);
-                }
-                ws.onopen = () => {
-                    isConnectingRef.current = false;
-                    retryCountRef.current = 0; // Reset retry count on successful connection
-                    console.log('🔗 Lexical editor connected to WebSocket server');
-                    stableOnConnectionChange.current?.(true);
-                    // Initialize version vector for optimized updates
-                    setLastSentVersionVector(loroDocRef.current.version());
-                    // Provide disconnect function to parent component
-                    const disconnectFn = () => {
-                        if (wsRef.current) {
-                            wsRef.current.close();
-                            stableOnConnectionChange.current?.(false);
-                        }
-                    };
-                    stableOnDisconnectReady.current?.(disconnectFn);
-                    // Provide sendMessage function to parent component
-                    const sendMessageFn = (message) => {
-                        if (wsRef.current && wsRef.current.readyState === WebSocket.OPEN) {
-                            wsRef.current.send(JSON.stringify(message));
-                        }
-                    };
-                    stableOnSendMessageReady.current?.(sendMessageFn);
-                };
-                ws.onmessage = (event) => {
-                    try {
-                        const data = JSON.parse(event.data);
-                        // Prominent log for ALL incoming messages with safe preview
-                        const preview = typeof event.data === 'string' ? event.data.slice(0, 300) + (event.data.length > 300 ? '…' : '') : '';
-                        console.log('🛰️📥 WS RECV ←', {
-                            type: data.type,
-                            docId: data.docId,
-                            hasData: !!data.data,
-                            hasEvent: !!data.event,
-                            clientId: data.clientId,
-                            length: typeof event.data === 'string' ? event.data.length : undefined,
-                            preview
-                        });
-                        if (data.type === 'loro-update' && data.docId === docId) {
-                            // Apply remote update to local document
-                            const update = new Uint8Array(data.update);
-                            loroDocRef.current.import(update);
-                        }
-                        else if (data.type === 'initial-snapshot' && data.docId === docId) {
-                            // Apply initial snapshot from server and immediately sync to Lexical
-                            const snapshot = new Uint8Array(data.snapshot);
-                            loroDocRef.current.import(snapshot);
-                            hasReceivedInitialSnapshot.current = true;
-                            console.log('📄 Lexical editor received and applied initial snapshot');
-                            // Notify parent component about successful initialization
-                            if (onInitialization) {
-                                onInitialization(true);
-                            }
-                            // Immediately reflect the current Loro content into the editor after import
-                            try {
-                                // For lexical-shared-doc, we need to get the structured JSON from the content container
-                                let currentContent = '';
-                                try {
-                                    // Try to get from 'content' container first (structured JSON)
-                                    currentContent = loroDocRef.current.getText('content').toString();
-                                    console.log('📋 Got structured content from "content" container:', currentContent.slice(0, 100) + '...');
-                                }
-                                catch {
-                                    // Fallback to docId container if content doesn't exist
-                                    currentContent = loroDocRef.current.getText(docId).toString();
-                                    console.log('📋 Fallback to docId container:', currentContent.slice(0, 100) + '...');
-                                }
-                                if (currentContent && currentContent.trim().length > 0) {
-                                    updateLexicalFromLoro(editor, currentContent);
-                                    console.log('✅ Successfully updated Lexical editor from snapshot');
-                                }
-                                else {
-                                    console.warn('⚠️ Empty content received from snapshot');
-                                }
-                            }
-                            catch (e) {
-                                console.warn('⚠️ Could not immediately reflect snapshot to editor:', e);
-                                // Notify parent component about failed initialization
-                                if (onInitialization) {
-                                    onInitialization(false);
-                                }
-                            }
-                        }
-                        else if (data.type === 'ephemeral-update' || data.type === 'ephemeral-event') {
-                            // Handle ephemeral updates from other clients using EphemeralStore
-                            if (data.docId === docId && data.data) {
-                                try {
-                                    console.log('📡 Received ephemeral update:', {
-                                        type: data.type,
-                                        event: data.event || 'legacy',
-                                        hasEventInfo: !!data.event,
-                                        eventDetails: data.event
-                                    });
-                                    // Convert hex string back to Uint8Array
-                                    const ephemeralBytes = new Uint8Array(data.data.match(/.{1,2}/g)?.map((byte) => parseInt(byte, 16)) || []);
-                                    if (awarenessRef.current && ephemeralBytes.length > 0) {
-                                        console.log('🎯 About to apply ephemeral data, current state before apply:');
-                                        console.log('🎯 Current awareness data before apply:', awarenessRef.current.getAll());
-                                        // Apply the ephemeral data to our local store
-                                        // This will now automatically trigger the awareness callback
-                                        awarenessRef.current.apply(ephemeralBytes);
-                                        console.log('🎯 Current awareness data after apply:', awarenessRef.current.getAll());
-                                        // Process ephemeral event - the awareness callback handles cursor updates
-                                        console.log('🎯 Processing ephemeral event with details:', {
-                                            by: data.event?.by,
-                                            added: data.event?.added,
-                                            updated: data.event?.updated,
-                                            removed: data.event?.removed
-                                        });
-                                        // CRITICAL FIX: Don't immediately remove cursors on ephemeral events
-                                        // The typing action often triggers false "removal" events
-                                        // Let the awareness callback handle cursor state properly
-                                        if (data.event?.removed && data.event.removed.length > 0) {
-                                            console.log('�️ Note: Ephemeral event indicates removals:', data.event.removed, '(will be validated by awareness callback)');
-                                            // Don't immediately remove cursors - let the awareness callback validate
-                                        }
-                                        console.log('👁️ Applied ephemeral update from remote clients');
-                                    }
-                                }
-                                catch (error) {
-                                    console.warn('Error applying ephemeral update:', error);
-                                }
-                            }
-                        }
-                        else if (data.type === 'welcome') {
-                            console.log('👋 Lexical editor welcome message received', {
-                                clientId: data.clientId,
-                                color: data.color
-                            });
-                            // Set client ID and color for cursor tracking
-                            setClientId(data.clientId || '');
-                            setClientColor(data.color || '');
-                            // Update the numeric peer ID to use the client ID for consistency
-                            if (data.clientId && awarenessRef.current) {
-                                // Store the client ID as the peer ID
-                                peerIdRef.current = data.clientId;
-                                // Create a new CursorAwareness instance with the client ID as peer ID
-                                awarenessRef.current = new CursorAwareness(data.clientId, loroDocRef.current);
-                                console.log('🎯 Updated awareness to use client ID as peer ID:', data.clientId);
-                                // Extract meaningful part from client ID
-                                const extractedId = data.clientId.includes('_') ?
-                                    data.clientId.split('_').find(part => /^\d{13}$/.test(part)) || data.clientId.slice(-8) :
-                                    data.clientId.slice(-8);
-                                // We'll re-add the awareness callback in the main useEffect
-                                // Update awareness with client info using the client ID
-                                awarenessRef.current.setLocal({
-                                    user: { name: extractedId, color: data.color || '#007acc' }
-                                });
-                                console.log('🎯 Updated awareness with WebSocket client ID user data:', { name: extractedId, color: data.color || '#007acc', clientId: data.clientId });
-                            } // Notify parent component of the peerId
-                            if (onPeerIdChange && data.clientId) {
-                                onPeerIdChange(data.clientId);
-                            }
-                            // Request current snapshot from server after a small delay
-                            setTimeout(() => {
-                                if (ws.readyState === WebSocket.OPEN) {
-                                    ws.send(JSON.stringify({
-                                        type: 'request-snapshot',
-                                        docId: docId
-                                    }));
-                                    console.log('📞 Lexical editor requested current snapshot from server');
-                                }
-                            }, 150); // Slightly different delay than text editor
-                        }
-                        else if (data.type === 'snapshot-request' && data.docId === docId) {
-                            // Another client is requesting a snapshot, send ours if we have content
-                            editor.getEditorState().read(() => {
-                                const currentText = $getRoot().getTextContent();
-                                if (currentText.length > 0) {
-                                    const snapshot = loroDocRef.current.export({ mode: "snapshot" });
-                                    ws.send(JSON.stringify({
-                                        type: 'snapshot',
-                                        snapshot: Array.from(snapshot),
-                                        docId: docId
-                                    }));
-                                    console.log('📄 Lexical editor sent snapshot in response to request');
-                                }
-                            });
-                        }
-                        else if (data.type === 'client-disconnect') {
-                            // Handle explicit client disconnect notifications
-                            console.log('📢 Received client disconnect notification:', data);
-                            const disconnectedClientId = data.clientId;
-                            if (disconnectedClientId && awarenessRef.current) {
-                                console.log('🧹 Forcing cleanup of disconnected client:', disconnectedClientId);
-                                // Remove from remote cursors immediately
-                                setRemoteCursors(prev => {
-                                    const updated = { ...prev };
-                                    console.log('🧹 Current remote cursors before cleanup:', prev);
-                                    delete updated[disconnectedClientId];
-                                    console.log('🧹 Removed disconnected client from remote cursors, new state:', updated);
-                                    return updated;
-                                });
-                                // Clear from timestamps
-                                delete cursorTimestamps.current[disconnectedClientId];
-                                // Force awareness refresh
-                                setForceUpdate(prev => prev + 1);
-                                console.log('🧹 Completed immediate cleanup for disconnected client');
-                            }
-                            else {
-                                console.warn('🧹 Cannot cleanup - missing client ID or awareness ref');
-                            }
-                        }
-                        else if (data.type === 'paragraph-added') {
-                            // Handle server broadcast when a new paragraph was added
-                            console.log('➕ Received paragraph-added broadcast:', {
-                                docId: data.docId,
-                                message: data.message,
-                                addedBy: data.addedBy
-                            });
-                            // Trigger a sync from Loro to Lexical to reflect the new paragraph
-                            if (data.docId === docId) {
-                                try {
-                                    // Request fresh snapshot to get the updated content
-                                    if (ws.readyState === WebSocket.OPEN) {
-                                        ws.send(JSON.stringify({
-                                            type: 'request-snapshot',
-                                            docId: docId
-                                        }));
-                                        console.log('📞 Requested fresh snapshot after paragraph addition');
-                                    }
-                                }
-                                catch (error) {
-                                    console.warn('Error handling paragraph-added message:', error);
-                                }
-                            }
-                        }
-                    }
-                    catch (err) {
-                        console.error('Error processing WebSocket message in Lexical plugin:', err);
-                    }
-                };
-                ws.onclose = () => {
-                    isConnectingRef.current = false;
-                    console.log('📴 Lexical editor disconnected from WebSocket server');
-                    stableOnConnectionChange.current?.(false);
-                    // Clear any existing retry timeout
-                    if (retryTimeoutRef.current) {
-                        clearTimeout(retryTimeoutRef.current);
-                    }
-                    // Only retry if we haven't exceeded max retries
-                    if (retryCountRef.current < maxRetries) {
-                        const retryDelay = Math.min(1000 * Math.pow(2, retryCountRef.current), 10000); // Exponential backoff, max 10s
-                        retryCountRef.current++;
-                        console.log(`🔄 Retrying connection in ${retryDelay}ms (attempt ${retryCountRef.current}/${maxRetries})`);
-                        retryTimeoutRef.current = setTimeout(connectWebSocket, retryDelay);
-                    }
-                    else {
-                        console.log('❌ Max connection retries exceeded, giving up');
-                    }
-                };
-                ws.onerror = (err) => {
-                    isConnectingRef.current = false;
-                    console.error('WebSocket error in Lexical plugin:', err);
-                    // Notify initialization failure if we haven't received initial content yet
-                    if (!hasReceivedInitialSnapshot.current && onInitialization) {
-                        onInitialization(false);
-                    }
-                };
-            }
-            catch (err) {
-                isConnectingRef.current = false;
-                console.error('Failed to connect to WebSocket server in Lexical plugin:', err);
-            }
-        };
-        connectWebSocket();
-        return () => {
-            // Clear retry timeout
-            if (retryTimeoutRef.current) {
-                clearTimeout(retryTimeoutRef.current);
-            }
-            if (wsRef.current) {
-                wsRef.current.close();
-            }
-        };
-    }, [websocketUrl, docId, editor, onPeerIdChange, updateLexicalFromLoro]); // Include all dependencies
-    // Cleanup stale cursors periodically
-    useEffect(() => {
-        const cleanupInterval = setInterval(() => {
-            const now = Date.now();
-            const staleThreshold = 10000; // 10 seconds
-            setRemoteCursors(prev => {
-                const updated = { ...prev };
-                let hasChanges = false;
-                Object.keys(updated).forEach(peerId => {
-                    const lastSeen = cursorTimestamps.current[peerId] || 0;
-                    if (now - lastSeen > staleThreshold) {
-                        console.log('🧹 Removing stale cursor for peer:', peerId, 'last seen:', now - lastSeen, 'ms ago');
-                        delete updated[peerId];
-                        delete cursorTimestamps.current[peerId];
-                        hasChanges = true;
-                    }
-                });
-                return hasChanges ? updated : prev;
-            });
-        }, 2000); // Check every 2 seconds
-        return () => clearInterval(cleanupInterval);
-    }, []);
-    // Track selection changes for collaborative cursors using Awareness
-    useEffect(() => {
-        // Listen to both content changes AND selection changes
-        const removeUpdateListener = editor.registerUpdateListener(({ editorState }) => {
-            // Always update cursor awareness on any state change (content or selection)
-            editorState.read(() => {
-                updateCursorAwareness();
-            });
-        });
-        // Add DOM event listeners to track cursor movements
-        const editorElement = editor.getElementByKey('root');
-        const editorContainer = editorElement?.closest('[contenteditable]');
-        if (editorContainer) {
-            // Listen for mouse clicks that change cursor position
-            const handleClick = () => {
-                // Small delay to ensure selection has updated
-                setTimeout(() => {
-                    updateCursorAwareness();
-                }, 10);
-            };
-            // Listen for keyboard events that change cursor position
-            const handleKeyboard = (event) => {
-                // Check for cursor movement keys OR typing keys
-                const cursorKeys = ['ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight', 'Home', 'End', 'PageUp', 'PageDown'];
-                const isTyping = event.key.length === 1 || event.key === 'Backspace' || event.key === 'Delete';
-                if (cursorKeys.includes(event.key) || isTyping) {
-                    // Small delay to ensure selection has updated
-                    setTimeout(() => {
-                        updateCursorAwareness();
-                    }, 10);
-                }
-            };
-            // Listen for global selection changes
-            const handleSelectionChange = () => {
-                // Check if the current selection is within our editor
-                const selection = window.getSelection();
-                if (selection && selection.rangeCount > 0) {
-                    const range = selection.getRangeAt(0);
-                    if (editorContainer.contains(range.commonAncestorContainer)) {
-                        updateCursorAwareness();
-                    }
-                }
-            };
-            editorContainer.addEventListener('click', handleClick);
-            editorContainer.addEventListener('keyup', handleKeyboard);
-            document.addEventListener('selectionchange', handleSelectionChange);
-            // Periodic cursor refresh to keep cursor alive in EphemeralStore
-            // Send cursor update every 60 seconds to prevent timeout
-            const cursorRefreshInterval = setInterval(() => {
-                updateCursorAwareness();
-            }, 60_000); // Every 60 seconds
-            return () => {
-                clearInterval(cursorRefreshInterval);
-                removeUpdateListener();
-                editorContainer.removeEventListener('click', handleClick);
-                editorContainer.removeEventListener('keyup', handleKeyboard);
-                document.removeEventListener('selectionchange', handleSelectionChange);
-            };
-        }
-        return removeUpdateListener;
-    }, [editor, updateCursorAwareness]);
-    // Force cursor re-rendering when remote cursors change
-    useEffect(() => {
-        // This effect will trigger whenever forceUpdate changes
-        console.log('🔄 Forcing cursor re-render due to remote cursor changes');
-    }, [forceUpdate]);
-    // Get the Lexical editor element and its parent for overlay positioning
-    const getEditorElement = useCallback(() => {
-        const editorContainer = editor.getElementByKey('root');
-        return editorContainer?.closest('[contenteditable]');
-    }, [editor]);
-    // Calculate DOM position from Lexical node position (using Lexical's approach)
-    const getPositionFromLexicalPosition = useCallback((nodeKey, offset) => {
-        const editorElement = getEditorElement();
-        if (!editorElement) {
-            console.warn('🚨 No editor element for cursor positioning');
-            // Return position far off-screen so validation will skip it
-            return { top: -1000, left: -1000 };
-        }
-        try {
-            return editor.getEditorState().read(() => {
-                const node = $getNodeByKey(nodeKey);
-                if (!node) {
-                    console.warn('🚨 Node not found for key:', nodeKey);
-                    return { top: -1000, left: -1000 };
-                }
-                console.log('🎯 Calculating position for node:', {
-                    nodeKey,
-                    offset,
-                    nodeType: node.getType(),
-                    isTextNode: $isTextNode(node),
-                    isElementNode: $isElementNode(node),
-                    isLineBreakNode: $isLineBreakNode(node),
-                    textContent: $isTextNode(node) ? node.getTextContent() : 'N/A'
-                });
-                // Handle line break nodes specially (like Lexical does)
-                if ($isLineBreakNode(node)) {
-                    const brElement = editor.getElementByKey(nodeKey);
-                    if (brElement) {
-                        const brRect = brElement.getBoundingClientRect();
-                        console.log('📏 Line break node position:', { top: brRect.top, left: brRect.left });
-                        return {
-                            top: brRect.top,
-                            left: brRect.left
-                        };
-                    }
-                }
-                // For element nodes (like root, paragraph), we need to find the text position within
-                if ($isElementNode(node)) {
-                    console.log('🏗️ Element node, finding text position at offset:', offset);
-                    // Get all children and find the text position
-                    const children = node.getChildren();
-                    let currentOffset = 0;
-                    let targetNode = null;
-                    let targetOffset = 0;
-                    for (let i = 0; i < children.length; i++) {
-                        const child = children[i];
-                        if ($isTextNode(child)) {
-                            const textLength = child.getTextContentSize();
-                            console.log('📝 Found text node:', {
-                                key: child.getKey(),
-                                textLength,
-                                currentOffset,
-                                targetOffset: offset
-                            });
-                            if (currentOffset + textLength >= offset) {
-                                // Found the target text node
-                                targetNode = child;
-                                targetOffset = offset - currentOffset;
-                                console.log('🎯 Target found in text node:', {
-                                    targetNodeKey: targetNode.getKey(),
-                                    targetOffset
-                                });
-                                break;
-                            }
-                            currentOffset += textLength;
-                        }
-                        else if ($isElementNode(child)) {
-                            // For element children, count as 1 position
-                            console.log('🏗️ Found element node:', {
-                                key: child.getKey(),
-                                currentOffset,
-                                targetOffset: offset
-                            });
-                            if (currentOffset + 1 > offset) {
-                                targetNode = child;
-                                targetOffset = 0;
-                                console.log('🎯 Target found at element node:', {
-                                    targetNodeKey: targetNode.getKey(),
-                                    targetOffset
-                                });
-                                break;
-                            }
-                            currentOffset += 1;
-                        }
-                        else {
-                            // Other node types (decorators, etc.)
-                            if (currentOffset + 1 > offset) {
-                                targetNode = child;
-                                targetOffset = 0;
-                                break;
-                            }
-                            currentOffset += 1;
-                        }
-                    }
-                    // If we didn't find a specific target, use the last available position
-                    if (!targetNode && children.length > 0) {
-                        const lastChild = children[children.length - 1];
-                        if ($isTextNode(lastChild)) {
-                            targetNode = lastChild;
-                            targetOffset = lastChild.getTextContentSize();
-                            console.log('🔚 Using last text node position:', {
-                                targetNodeKey: targetNode.getKey(),
-                                targetOffset
-                            });
-                        }
-                        else {
-                            targetNode = lastChild;
-                            targetOffset = 0;
-                            console.log('🔚 Using last element node:', {
-                                targetNodeKey: targetNode.getKey(),
-                                targetOffset
-                            });
-                        }
-                    }
-                    // If we found a target node, use it for positioning
-                    if (targetNode) {
-                        console.log('🎯 Processing target node:', {
-                            targetNodeKey: targetNode.getKey(),
-                            targetOffset,
-                            isTextNode: $isTextNode(targetNode),
-                            isElementNode: $isElementNode(targetNode)
-                        });
-                        // If target is a text node, use it directly
-                        if ($isTextNode(targetNode)) {
-                            try {
-                                // Create DOM range for position calculation
-                                const range = createDOMRange(editor, targetNode, targetOffset, targetNode, targetOffset);
-                                if (range !== null) {
-                                    // Use createRectsFromDOMRange for accurate positioning
-                                    const rects = createRectsFromDOMRange(editor, range);
-                                    if (rects.length > 0) {
-                                        const rect = rects[0];
-                                        // Ensure the rect has valid dimensions
-                                        if (rect.height > 0 && rect.width >= 0) {
-                                            console.log('📐 Valid text node range position:', {
-                                                top: rect.top,
-                                                left: rect.left,
-                                                height: rect.height,
-                                                width: rect.width,
-                                                targetNodeKey: targetNode.getKey(),
-                                                targetOffset
-                                            });
-                                            return {
-                                                top: rect.top,
-                                                left: rect.left
-                                            };
-                                        }
-                                        else {
-                                            console.warn('🚨 Invalid rect dimensions, trying fallback approach:', rect);
-                                        }
-                                    }
-                                    // Fallback: Use native DOM range if Lexical rects fail
-                                    const rangeBounds = range.getBoundingClientRect();
-                                    if (rangeBounds && rangeBounds.height > 0) {
-                                        console.log('📐 Fallback DOM range position:', {
-                                            top: rangeBounds.top,
-                                            left: rangeBounds.left,
-                                            height: rangeBounds.height,
-                                            width: rangeBounds.width
-                                        });
-                                        return {
-                                            top: rangeBounds.top,
-                                            left: rangeBounds.left
-                                        };
-                                    }
-                                }
-                                // Ultimate fallback: Use direct DOM element positioning
-                                const domElement = editor.getElementByKey(targetNode.getKey());
-                                if (domElement) {
-                                    const elementRect = domElement.getBoundingClientRect();
-                                    console.log('📐 Ultimate fallback - DOM element position:', {
-                                        top: elementRect.top,
-                                        left: elementRect.left,
-                                        height: elementRect.height,
-                                        width: elementRect.width
-                                    });
-                                    // For text nodes, try to calculate character position within the element
-                                    if (targetOffset > 0 && domElement.textContent) {
-                                        // Create a temporary range to measure character offset
-                                        const tempRange = document.createRange();
-                                        const textNode = domElement.firstChild;
-                                        if (textNode && textNode.nodeType === Node.TEXT_NODE && textNode.textContent) {
-                                            const safeOffset = Math.min(targetOffset, textNode.textContent.length);
-                                            tempRange.setStart(textNode, safeOffset);
-                                            tempRange.setEnd(textNode, safeOffset);
-                                            const tempRect = tempRange.getBoundingClientRect();
-                                            if (tempRect && tempRect.height > 0) {
-                                                console.log('📐 Character-precise position:', {
-                                                    top: tempRect.top,
-                                                    left: tempRect.left,
-                                                    offset: safeOffset
-                                                });
-                                                return {
-                                                    top: tempRect.top,
-                                                    left: tempRect.left
-                                                };
-                                            }
-                                        }
-                                    }
-                                    return {
-                                        top: elementRect.top,
-                                        left: elementRect.left
-                                    };
-                                }
-                            }
-                            catch (error) {
-                                console.warn('🚨 Error creating range for target text node:', error);
-                            }
-                        }
-                        // If target is an element node, try to find first text node within it
-                        if ($isElementNode(targetNode)) {
-                            console.log('🏗️ Target is element, looking for text within it');
-                            const targetChildren = targetNode.getChildren();
-                            let firstTextNode = null;
-                            for (const child of targetChildren) {
-                                if ($isTextNode(child)) {
-                                    firstTextNode = child;
-                                    console.log('📝 Found first text node in target element:', child.getKey());
-                                    break;
-                                }
-                            }
-                            if (firstTextNode) {
-                                try {
-                                    // Improved range creation for element nodes
-                                    const range = createDOMRange(editor, firstTextNode, 0, // Start of first text node
-                                    firstTextNode, 0);
-                                    if (range !== null) {
-                                        const rects = createRectsFromDOMRange(editor, range);
-                                        if (rects.length > 0) {
-                                            const rect = rects[0];
-                                            // Ensure rect has valid height
-                                            if (rect.height > 0) {
-                                                console.log('📐 Valid element->text range position:', {
-                                                    top: rect.top,
-                                                    left: rect.left,
-                                                    height: rect.height,
-                                                    targetNodeKey: targetNode.getKey(),
-                                                    firstTextNodeKey: firstTextNode.getKey()
-                                                });
-                                                return {
-                                                    top: rect.top,
-                                                    left: rect.left
-                                                };
-                                            }
-                                            else {
-                                                console.warn('🚨 Invalid element rect height, using fallback');
-                                            }
-                                        }
-                                        // Try native DOM range fallback
-                                        const rangeBounds = range.getBoundingClientRect();
-                                        if (rangeBounds && rangeBounds.height > 0) {
-                                            console.log('📐 Element fallback DOM range position:', {
-                                                top: rangeBounds.top,
-                                                left: rangeBounds.left,
-                                                height: rangeBounds.height
-                                            });
-                                            return {
-                                                top: rangeBounds.top,
-                                                left: rangeBounds.left
-                                            };
-                                        }
-                                    }
-                                }
-                                catch (error) {
-                                    console.warn('🚨 Error creating range for text within target element:', error);
-                                }
-                            }
-                            else {
-                                // No text nodes in element, use element position directly
-                                console.log('📦 No text in target element, using element position');
-                                const domElement = editor.getElementByKey(targetNode.getKey());
-                                if (domElement) {
-                                    const elementRect = domElement.getBoundingClientRect();
-                                    console.log('📐 Direct element position:', {
-                                        top: elementRect.top,
-                                        left: elementRect.left,
-                                        height: elementRect.height,
-                                        width: elementRect.width
-                                    });
-                                    return {
-                                        top: elementRect.top,
-                                        left: elementRect.left
-                                    };
-                                }
-                            }
-                        }
-                    }
-                    // Fallback to element position if we can't create a range
-                    console.log('⚠️ Falling back to element position for:', nodeKey);
-                    const domElement = editor.getElementByKey(nodeKey);
-                    if (domElement) {
-                        const elementRect = domElement.getBoundingClientRect();
-                        return {
-                            top: elementRect.top,
-                            left: elementRect.left
-                        };
-                    }
-                }
-                // For text nodes, use Lexical's createDOMRange directly
-                if ($isTextNode(node)) {
-                    console.log('📝 Text node, creating range at offset:', offset);
-                    try {
-                        // Enhanced range creation for text nodes
-                        const range = createDOMRange(editor, node, offset, node, offset);
-                        if (range !== null) {
-                            const rects = createRectsFromDOMRange(editor, range);
-                            if (rects.length > 0) {
-                                const rect = rects[0];
-                                // Validate rect dimensions
-                                if (rect.height > 0 && !isNaN(rect.top) && !isNaN(rect.left)) {
-                                    console.log('📐 Valid text range position:', {
-                                        top: rect.top,
-                                        left: rect.left,
-                                        width: rect.width,
-                                        height: rect.height,
-                                        nodeKey,
-                                        offset
-                                    });
-                                    return {
-                                        top: rect.top,
-                                        left: rect.left
-                                    };
-                                }
-                                else {
-                                    console.warn('🚨 Invalid text rect, trying DOM range fallback:', rect);
-                                    // Use native DOM range fallback
-                                    const rangeBounds = range.getBoundingClientRect();
-                                    if (rangeBounds && rangeBounds.height > 0) {
-                                        console.log('📐 Text DOM range fallback position:', {
-                                            top: rangeBounds.top,
-                                            left: rangeBounds.left,
-                                            height: rangeBounds.height
-                                        });
-                                        return {
-                                            top: rangeBounds.top,
-                                            left: rangeBounds.left
-                                        };
-                                    }
-                                }
-                            }
-                            // Additional fallback: Use range getBoundingClientRect directly
-                            const directRect = range.getBoundingClientRect();
-                            if (directRect && directRect.height > 0) {
-                                console.log('📐 Direct range rect position:', {
-                                    top: directRect.top,
-                                    left: directRect.left,
-                                    height: directRect.height
-                                });
-                                return {
-                                    top: directRect.top,
-                                    left: directRect.left
-                                };
-                            }
-                        }
-                    }
-                    catch (error) {
-                        console.warn('🚨 Error creating range for text node:', error);
-                    }
-                }
-                // Get the DOM element for this node
-                const domElement = editor.getElementByKey(nodeKey);
-                if (!domElement) {
-                    console.warn('� DOM element not found for node key:', nodeKey);
-                    return { top: -1000, left: -1000 };
-                }
-                if (domElement) {
-                    try {
-                        // Create a range at the specified offset within the node
-                        const range = document.createRange();
-                        if (domElement.nodeType === Node.TEXT_NODE) {
-                            // For text nodes, set range at the offset
-                            range.setStart(domElement, Math.min(offset, domElement?.textContent?.length || 0));
-                            range.collapse(true);
-                        }
-                        else {
-                            // For element nodes, find the text content and position
-                            const walker = document.createTreeWalker(domElement, NodeFilter.SHOW_TEXT, null);
-                            let currentOffset = 0;
-                            let textNode = walker.nextNode();
-                            while (textNode && currentOffset + textNode.textContent.length < offset) {
-                                currentOffset += textNode.textContent.length;
-                                textNode = walker.nextNode();
-                            }
-                            if (textNode) {
-                                range.setStart(textNode, Math.min(offset - currentOffset, textNode.textContent.length));
-                                range.collapse(true);
-                            }
-                            else {
-                                // Fallback to end of element
-                                range.selectNodeContents(domElement);
-                                range.collapse(false);
-                            }
-                        }
-                        const rect = range.getBoundingClientRect();
-                        if (rect.width > 0 || rect.height > 0) {
-                            return {
-                                top: rect.top,
-                                left: rect.left
-                            };
-                        }
-                    }
-                    catch (rangeError) {
-                        console.warn('Range error:', rangeError);
-                    }
-                    // Fallback to element position
-                    const elementRect = domElement.getBoundingClientRect();
-                    return {
-                        top: elementRect.top,
-                        left: elementRect.left
-                    };
-                }
-                else {
-                    // No DOM element found
-                    return { top: -1000, left: -1000 };
-                }
-            });
-        }
-        catch (error) {
-            console.warn('Error calculating cursor position:', error);
-            const editorRect = editorElement.getBoundingClientRect();
-            return {
-                top: editorRect.top + 20,
-                left: editorRect.left + 20
-            };
-        }
-    }, [getEditorElement, editor]);
-    // Add scroll listener to update cursor positions when page scrolls
-    useEffect(() => {
-        const handleScroll = () => {
-            console.log('🔄 Scroll detected, forcing cursor re-render');
-            setForceUpdate(prev => prev + 1); // Use existing force update mechanism
-        };
-        // Listen to scroll events on window and any scrollable containers
-        window.addEventListener('scroll', handleScroll, { passive: true });
-        document.addEventListener('scroll', handleScroll, { passive: true });
-        // Also listen to editor container scroll if it exists
-        const editorElement = getEditorElement();
-        if (editorElement) {
-            const editorContainer = editorElement.closest('.editor-container, .lexical-editor, [data-lexical-editor]');
-            if (editorContainer) {
-                editorContainer.addEventListener('scroll', handleScroll, { passive: true });
-            }
-        }
-        return () => {
-            window.removeEventListener('scroll', handleScroll);
-            document.removeEventListener('scroll', handleScroll);
-            const editorElement = getEditorElement();
-            if (editorElement) {
-                const editorContainer = editorElement.closest('.editor-container, .lexical-editor, [data-lexical-editor]');
-                if (editorContainer) {
-                    editorContainer.removeEventListener('scroll', handleScroll);
-                }
-            }
-        };
-    }, [setForceUpdate, getEditorElement]);
-    console.log('🎬 LoroCollaborativePlugin component render called', {
-        remoteCursorsCount: Object.keys(remoteCursors).length,
-        remoteCursorsPeerIds: Object.keys(remoteCursors),
-        clientId: clientId,
-        peerIdRef: peerIdRef.current,
-        editorElementExists: !!getEditorElement()
-    });
-    // Use React portal for cursor rendering
-    return (_jsx(CursorsContainer, { remoteCursors: remoteCursors, getPositionFromLexicalPosition: getPositionFromLexicalPosition, clientId: clientId, editor: editor }));
-}
-export default LoroCollaborativePlugin;