Sharedb-monaco-cursors NPM

sharedb-monaco-cursors

Collaborative Cursor and Selection support for sharedb-monaco.

(If you're using your own ShareDB Monaco implementation, sharedb-monaco-cursors will work even without sharedb-monaco installed)

Developed for the CodeCollab project.

Tested and works well with monaco-react.

Install

Using NPM:

$ npm install sharedb-monaco-cursors

Usage

sharedb-monaco-cursors relies on the ShareDB Presence API to work. Before using this library, ensure that this API is enabled on the server as it is disabled by default.

To enable the Presence API on the server:

let shareConfig = {
    db,
    presence: true  // This line enables Presence
}

const share = new ShareDB(shareConfig);

Sample usage of this library in action

import ShareDBMonaco from "sharedb-monaco";
import ShareDBMonacoCursors from "sharedb-monaco-cursors";
import monaco from "monaco-editor";

// Get a monaco editor (ICodeEditor) instance
let editor = monaco.editor.create(document.getElementById("editor"), {
    value: "print('Hello World!')",
    language: "python"
});

// Initialise sharedb-monaco
let binding = new ShareDBMonaco(options);
let model = binding.add(editor, attachOptions);

// Initialise sharedb-monaco-cursors
let cursors = new ShareDBMonacoCursors(cursorOptions);

`new ShareDBMonacoCursors(options)`

options \
- id \ ID of the ShareDB document
- namespace \ The namespace of document within ShareDB, to be equal to that on the server
- name \ Name of this user, to be displayed to other connected users.
- editors \<monaco.editor.ICodeEditor[]> Array of ICodeEditors to bind cursors to.
- viewOnly \ Should local cursor and selection events be listened and broadcasted. Default: false
- colors \<string[]> Array of color codes to use for cursors. Defaults to ['BurlyWood', 'lightseagreen', 'Violet', 'Red', 'forestgreen', 'DarkViolet', 'OrangeRed', 'navy', 'darkviolet', 'maroon']
- uid \ Unique Identifier for each user's cursors. Important if you want to manage cursors across multiple ShareDBMonacoCursors instances and documents at the same time.