⚡ Plugin Bridge & Event Lifecycle

🔌 Bridge Architecture (SPA ⇄ Editor)

• Outbound (Editor → Host): Intercept changes via view.dispatch() ➡️ broadcast external state.
• Inbound (Host → Editor): Dispatch transactions imperatively via view.dispatch(tr) ➡️ update doc state.

🔄 Event Registry & Lifecycle

[Event Trigger] ➡️ [Capture: High-Precedence Listeners] ➡️ [Bubble/Dispatch] ➡️ [Destruction: Cleanup]

• DOM Listeners: Bind directly via view.dom.addEventListener().
• Editor Handlers: Declare via EditorView.domEventHandlers({...}) for internal event mapping.
• 🧹 Teardown: ALWAYS remove DOM listeners in the plugin’s destroy() hook to prevent memory leaks.

⚖️ State Sync & Reconciliation

• ⏱️ Debounce: Batch outbound updates to prevent input lag and performance thrashing.
• 🔄 Reconciliation: Diff incoming host state against view.state.doc before applying updates.
• ⚔️ Conflict Resolution: Employ LWW (Last-Writer-Wins) for simple state, or OT (Operational Transformation) for concurrent edits.

---