monaco-lsp-bridge 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Daniel Beaven
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,61 @@
+# monaco-lsp-bridge
+
+A small, typed bridge that wires a Language Server Protocol (LSP) server to the Monaco editor.  
+It handles JSON-RPC transport, progress/cancellation, diagnostics → markers, and completion/hover/formatting adapters.
+
+[![Build Status](https://img.shields.io/github/actions/workflow/status/Pingid/monaco-lsp-bridge/test.yml?branch=main&style=flat&colorA=000000&colorB=000000)](https://github.com/Pingid/monaco-lsp-bridge/actions?query=workflow:Test)
+[![Build Size](https://img.shields.io/bundlephobia/minzip/monaco-lsp-bridge?label=bundle%20size&style=flat&colorA=000000&colorB=000000)](https://bundlephobia.com/result?p=monaco-lsp-bridge)
+[![Version](https://img.shields.io/npm/v/monaco-lsp-bridge?style=flat&colorA=000000&colorB=000000)](https://www.npmjs.com/package/monaco-lsp-bridge)
+[![Downloads](https://img.shields.io/npm/dt/monaco-lsp-bridge.svg?style=flat&colorA=000000&colorB=000000)](https://www.npmjs.com/package/monaco-lsp-bridge)
+
+## Install
+
+Install the `monaco-lsp-bridge` library using your preferred package manager:
+
+```bash
+npm install monaco-lsp-bridge
+```
+
+## 🚀 Quick Start
+
+```ts
+import * as monaco from 'monaco-editor'
+import { LspMonacoClient, LspTransport } from 'monaco-lsp-bridge'
+
+// 1) Create your Monaco editor
+const editor = monaco.editor.create(document.getElementById('root')!, {
+  value: 'function main() {}',
+  language: 'javascript',
+})
+
+// 2) Create a transport to your LSP server (e.g. Web Worker)
+const worker = new Worker(new URL('./server.worker.js', import.meta.url), { type: 'module' })
+const transport = LspTransport.fromWorker(worker)
+
+// 3) Start the client
+const client = new LspMonacoClient(transport, {
+  languageSelector: { language: 'javascript' }, // or a selector array
+  dedicatedServer: true, // sends shutdown/exit on dispose
+})
+client.connect(monaco, editor)
+
+// (optional) listen to client events
+const off = client.onEvent((e) => {
+  if (e.type === 'error') console.error(e.error)
+})
+
+// Later: dispose
+// await client.dispose()
+```
+
+## What it does
+
+- Initializes the LSP server and applies reported capabilities.
+- Sends `didOpen`/`didChange`/`didClose` matching server sync mode.
+- Maps diagnostics → Monaco markers.
+- Adapts completion, resolve, hover, and formatting requests.
+- Handles progress (`$/progress`) and cancellation via `AbortSignal`.
+
+## 📄 License
+
+MIT © [Dan Beaven](https://github.com/Pingid)

package/lib/cjs/error.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toLspError = exports.isCancellationError = exports.LspError = exports.LspErrorCode = void 0;
+var LspErrorCode;
+(function (LspErrorCode) {
+    // JSON-RPC predefined errors (-32700 to -32600)
+    LspErrorCode[LspErrorCode["ParseError"] = -32700] = "ParseError";
+    LspErrorCode[LspErrorCode["InvalidRequest"] = -32600] = "InvalidRequest";
+    LspErrorCode[LspErrorCode["MethodNotFound"] = -32601] = "MethodNotFound";
+    LspErrorCode[LspErrorCode["InvalidParams"] = -32602] = "InvalidParams";
+    LspErrorCode[LspErrorCode["InternalError"] = -32603] = "InternalError";
+    // JSON-RPC reserved server error range (-32000 to -32099)
+    LspErrorCode[LspErrorCode["ServerErrorBase"] = -32000] = "ServerErrorBase";
+    // LSP-specific errors (-32900 to -32800)
+    LspErrorCode[LspErrorCode["RequestCancelled"] = -32800] = "RequestCancelled";
+    LspErrorCode[LspErrorCode["ContentModified"] = -32801] = "ContentModified";
+    LspErrorCode[LspErrorCode["ServerCancelled"] = -32802] = "ServerCancelled";
+    // Client-local errors (positive codes to avoid reserved range conflicts)
+    LspErrorCode[LspErrorCode["Timeout"] = 1001] = "Timeout";
+    LspErrorCode[LspErrorCode["Disposed"] = 1002] = "Disposed";
+})(LspErrorCode || (exports.LspErrorCode = LspErrorCode = {}));
+class LspError extends Error {
+    code;
+    data;
+    constructor(shape) {
+        super(shape.message);
+        this.code = shape.code;
+        this.data = shape.data;
+        this.name = 'LspError';
+    }
+}
+exports.LspError = LspError;
+const isCancellationError = (e) => typeof e === 'object' &&
+    e !== null &&
+    'code' in e &&
+    (e.code === LspErrorCode.RequestCancelled || e.code === LspErrorCode.ServerCancelled);
+exports.isCancellationError = isCancellationError;
+const toLspError = (e) => e instanceof LspError
+    ? e
+    : new LspError({
+        code: Number(e?.code ?? LspErrorCode.InternalError),
+        message: String(e?.message ?? 'Error'),
+        data: e?.data,
+    });
+exports.toLspError = toLspError;
+//# sourceMappingURL=error.js.map

package/lib/cjs/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../../src/error.ts"],"names":[],"mappings":";;;AAAA,IAAY,YAmBX;AAnBD,WAAY,YAAY;IACtB,gDAAgD;IAChD,gEAAmB,CAAA;IACnB,wEAAuB,CAAA;IACvB,wEAAuB,CAAA;IACvB,sEAAsB,CAAA;IACtB,sEAAsB,CAAA;IAEtB,0DAA0D;IAC1D,0EAAwB,CAAA;IAExB,yCAAyC;IACzC,4EAAyB,CAAA;IACzB,0EAAwB,CAAA;IACxB,0EAAwB,CAAA;IAExB,yEAAyE;IACzE,wDAAc,CAAA;IACd,0DAAe,CAAA;AACjB,CAAC,EAnBW,YAAY,4BAAZ,YAAY,QAmBvB;AAID,MAAa,QAAS,SAAQ,KAAK;IACjC,IAAI,CAAQ;IACZ,IAAI,CAAU;IACd,YAAY,KAAoB;QAC9B,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAA;QACtB,IAAI,CAAC,IAAI,GAAG,UAAU,CAAA;IACxB,CAAC;CACF;AATD,4BASC;AAEM,MAAM,mBAAmB,GAAG,CAAC,CAAU,EAAE,EAAE,CAChD,OAAO,CAAC,KAAK,QAAQ;IACrB,CAAC,KAAK,IAAI;IACV,MAAM,IAAK,CAAS;IACpB,CAAE,CAAS,CAAC,IAAI,KAAK,YAAY,CAAC,gBAAgB,IAAK,CAAS,CAAC,IAAI,KAAK,YAAY,CAAC,eAAe,CAAC,CAAA;AAJ5F,QAAA,mBAAmB,uBAIyE;AAElG,MAAM,UAAU,GAAG,CAAC,CAAM,EAAY,EAAE,CAC7C,CAAC,YAAY,QAAQ;IACnB,CAAC,CAAC,CAAC;IACH,CAAC,CAAC,IAAI,QAAQ,CAAC;QACX,IAAI,EAAE,MAAM,CAAC,CAAC,EAAE,IAAI,IAAI,YAAY,CAAC,aAAa,CAAC;QACnD,OAAO,EAAE,MAAM,CAAC,CAAC,EAAE,OAAO,IAAI,OAAO,CAAC;QACtC,IAAI,EAAE,CAAC,EAAE,IAAI;KACd,CAAC,CAAA;AAPK,QAAA,UAAU,cAOf"}