@vemjs/lsp-client 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,67 @@
+# @vemjs/lsp-client
+
+## 0.2.0
+
+### Minor Changes
+
+- 3fa4848: feat(lsp): implement JSON-RPC 2.0 client, document sync, diagnostics & completion
+
+  - Add `JsonRpcClient` — JSON-RPC 2.0 engine over WebSocket with pending-Map request/response correlation and notification dispatch
+  - Add `LSPClient` — full LSP lifecycle (initialize handshake, textDocument/didOpen, didChange, didClose, completion, hover, publishDiagnostics bridging)
+  - Add `Diagnostic` / `DiagnosticSeverity` types to `@vemjs/core`
+  - Add `VemEditorState.setDiagnostics()`, `getDiagnostics()`, `onPublishDiagnostics()` API
+  - Add `VemEditorState.getText()` public buffer content accessor
+
+### Patch Changes
+
+- 0498765: chore: release infrastructure, package metadata, and documentation scaffolding
+
+  This changeset covers all release preparation work for the initial 0.1.0 publish:
+
+  **Package metadata** — Added `license`, `repository`, `keywords`, and `publishConfig` fields to
+  all four packages so they display correctly on npmjs.com with proper source links, license badges,
+  and searchable tags.
+
+  **CI/CD pipeline** — Rewrote `.github/workflows/ci.yml` and `release.yml`:
+
+  - `quality` job: build → test → lint (oxlint) → dead-code scan (knip) on every PR and push
+  - `publish` job: automatic `changeset publish` to npm on every merge to `main` via
+    `changesets/action@v1` using the `NPM_TOKEN` org secret
+
+  **Changesets** — Initialized `.changeset/` with a `config.json` configured for public access and
+  patch-level internal dependency updates, enabling a fully automated release flow.
+
+  **Tooling** — Added `knip.config.ts` (dead-code detection), `oxlintrc.json` (TypeScript-aware
+  lint rules), `.lintstagedrc.json` (auto-fix staged files on commit), and updated root
+  `package.json` scripts: `build`, `test`, `lint`, `knip`, `changeset`, `version-packages`,
+  `release`.
+
+  **Dependabot** — Configured weekly npm dependency scanning with dev/prod groups and
+  `@vectojs/*` major-version pin to avoid upstream breaking changes.
+
+  **Repository** — Updated root `README.md` with CI/npm/license badges and package table.
+  Updated `SECURITY.md` with all four `@vemjs/*` packages and coordinated-disclosure guidance.
+  Added GitHub topics (vim, editor, typescript, vectojs, canvas, modal-editing, lsp) and branch
+  protection requiring the `quality` status check before merging to `main`.
+
+  **Build hygiene** — Cleaned all `dist/` directories and rebuilt from source to ensure no
+  test artefacts are included in published tarballs. Verified `knip` reports zero issues.
+
+- Updated dependencies [0498765]
+- Updated dependencies [3fa4848]
+  - @vemjs/core@0.2.0
+
+## 0.2.0 (unreleased)
+
+### Minor Changes
+
+- Add `JsonRpcClient` — JSON-RPC 2.0 engine over WebSocket with pending-Map correlation and notification dispatch
+- Add `LSPClient` — full LSP lifecycle: initialize handshake, textDocument/didOpen, didChange, didClose, completion, hover, publishDiagnostics
+- Wire `VemEditorState` events to automatic document sync
+- Bridge `publishDiagnostics` notifications to `VemEditorState.setDiagnostics()`
+
+## 0.1.0
+
+### Features
+
+- Initial `LSPClient` stub with WebSocket connect and completion request placeholders

package/README.md

@@ -0,0 +1,132 @@
+# @vemjs/lsp-client
+
+[![npm version](https://img.shields.io/npm/v/@vemjs/lsp-client.svg)](https://www.npmjs.com/package/@vemjs/lsp-client)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+A lightweight Language Server Protocol (LSP) client and JSON-RPC 2.0 communication engine for the **Vem Editor**. It establishes connection to language servers over WebSocket connections, synchronizes document buffers dynamically, and maps incoming diagnostics or completion results straight to the editor state.
+
+## Features
+
+- **JSON-RPC 2.0 Protocol Engine**: Direct implementation of the JSON-RPC 2.0 spec over WebSockets, including automatic correlation of request/response IDs and fire-and-forget notifications.
+- **Document Synchronization**: Binds directly to `@vemjs/core` editor buffers, automatically sending `textDocument/didOpen`, `textDocument/didChange`, and `textDocument/didClose` notification events on text edit triggers.
+- **AutoComplete Bridge**: Fetch completions asynchronously on demand and dispatch them to listeners.
+- **Hover Capability**: Query type signatures or docs from language servers under current editor positions.
+- **Diagnostics Translation**: Subscribes to `textDocument/publishDiagnostics` notifications, translates severity mappings, and automatically updates `@vemjs/core` diagnostics storage.
+
+## Installation
+
+```bash
+bun add @vemjs/lsp-client
+# or via npm
+npm install @vemjs/lsp-client
+```
+
+## Quick Start
+
+Initialize the LSP client, attach it to the editor state, and connect:
+
+```typescript
+import { VemEditorState } from '@vemjs/core';
+import { LSPClient } from '@vemjs/lsp-client';
+
+const editorState = new VemEditorState('const a = 123;');
+const lsp = new LSPClient('ws://localhost:8080', 'file:///workspace/app.ts', 'typescript');
+
+// Attach before connecting to auto-bind didOpen / didChange buffer events
+await lsp.connect(editorState);
+
+// Request completions at line 0, character 12
+const completions = await lsp.requestCompletion(0, 12);
+console.log('Completions:', completions);
+```
+
+## API Reference
+
+### `JsonRpcClient`
+
+Low-level client for communication.
+
+- `constructor(url: string)`: Creates a new JSON-RPC client.
+- `connect(): Promise<void>`: Connects to the WebSocket URL.
+- `disconnect(): void`: Closes the WebSocket connection.
+- `isConnected: boolean`: Get connection status.
+- `sendRequest(method: string, params?: unknown): Promise<unknown>`: Sends a request with generated unique ID and awaits the server's reply.
+- `sendNotification(method: string, params?: unknown): void`: Sends a notification without expecting a response.
+- `onNotification(method: string, cb: (params: unknown) => void): void`: Registers a handler for server notifications.
+
+### `LSPClient`
+
+High-level LSP integration wrapper.
+
+- `constructor(serverUrl: string, fileUri: string, languageId: string)`: Creates an LSPClient instance.
+- `connect(editorState?: VemEditorState): Promise<void>`: Initiates WebSocket connection, attaches optional editor state, and performs the standard LSP `initialize` / `initialized` handshake.
+- `disconnect(): void`: Sends LSP `exit` notification and disconnects.
+- `attach(editorState: VemEditorState): void`: Binds to editor buffer change events to automate buffer sync.
+- `requestCompletion(line: number, character: number): Promise<LspCompletionItem[]>`: Queries the server for autocomplete options at the specified coordinates.
+- `requestHover(line: number, character: number): Promise<string | null>`: Queries type details or docs at the position.
+- `sendDidClose(): void`: Sends standard document close notification to free server resources.
+- `onCompletion(cb: (items: LspCompletionItem[]) => void): void`: Register autocomplete event listener.
+- `onHover(cb: (content: string) => void): void`: Register hover event listener.
+- `setFileUri(uri: string): void`: Switches file URI context.
+- `setLanguageId(id: string): void`: Switches language context.
+
+---
+
+## Connecting to TypeScript Language Server
+
+To run a language server in the browser environment, you can proxy `typescript-language-server` or `typescript-language-server --stdio` through a simple WebSocket proxy (such as `ws-jsonrpc-proxy` or standard stdio-to-ws bridges).
+
+Here is a complete setup workflow:
+
+```typescript
+import { VemEditorState } from '@vemjs/core';
+import { LSPClient } from '@vemjs/lsp-client';
+
+const editor = new VemEditorState('console.l');
+
+// Establish LSPClient connection to the proxy URL
+const lsp = new LSPClient('ws://localhost:2087', 'file:///mnt/workspace/index.ts', 'typescript');
+
+// Register autocomplete handler
+lsp.onCompletion((items) => {
+  console.log('Received completions:');
+  items.forEach((item) => {
+    console.log(`- ${item.label} (${item.detail ?? 'no detail'})`);
+  });
+});
+
+await lsp.connect(editor);
+
+// Send keys to append characters to trigger didChange
+editor.input('o'); // buffer now contains: console.lo
+editor.input('g'); // buffer now contains: console.log
+
+// Ask for completion at line 0, position 11 (after 'log')
+const results = await lsp.requestCompletion(0, 11);
+```
+
+## Architecture
+
+```mermaid
+sequenceDiagram
+    participant Editor as VemEditorState
+    participant LSP as LSPClient
+    participant RPC as JsonRpcClient
+    participant LS as Language Server (via WS)
+
+    Editor->>LSP: onDidOpenBuffer / onDidChangeBuffer
+    LSP->>RPC: sendNotification("textDocument/didChange", text)
+    RPC->>LS: WebSocket Message
+    LS-->>RPC: textDocument/publishDiagnostics
+    RPC-->>LSP: Trigger Diagnostic Handler
+    LSP->>Editor: setDiagnostics(mappedErrors)
+    Editor->>Editor: Trigger change callbacks (Canvas repaints)
+```
+
+## Contributing
+
+Please review [CONTRIBUTING.md](../../CONTRIBUTING.md) for details on our workflow and engineering guidelines.
+
+## License
+
+This package is licensed under the MIT License - see the LICENSE file for details.

package/dist/JsonRpcClient.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @vemjs/lsp-client — JSON-RPC 2.0 Protocol Engine
+ *
+ * Handles request/response correlation and notification routing
+ * over a WebSocket transport layer.
+ */
+export interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id: number;
+    method: string;
+    params?: unknown;
+}
+export interface JsonRpcNotification {
+    jsonrpc: '2.0';
+    method: string;
+    params?: unknown;
+}
+export interface JsonRpcResponse {
+    jsonrpc: '2.0';
+    id: number;
+    result?: unknown;
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export type JsonRpcMessage = JsonRpcRequest | JsonRpcNotification | JsonRpcResponse;
+export type NotificationHandler = (params: unknown) => void;
+export declare class JsonRpcClient {
+    private ws;
+    private nextId;
+    private pending;
+    private notificationHandlers;
+    private readyQueue;
+    private connected;
+    private readonly url;
+    constructor(url: string);
+    connect(): Promise<void>;
+    disconnect(): void;
+    get isConnected(): boolean;
+    sendRequest(method: string, params?: unknown): Promise<unknown>;
+    sendNotification(method: string, params?: unknown): void;
+    onNotification(method: string, cb: NotificationHandler): void;
+    private send;
+    private handleMessage;
+}
+//# sourceMappingURL=JsonRpcClient.d.ts.map

package/dist/JsonRpcClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonRpcClient.d.ts","sourceRoot":"","sources":["../src/JsonRpcClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CAC3D;AAED,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,mBAAmB,GAAG,eAAe,CAAC;AAEpF,MAAM,MAAM,mBAAmB,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAE5D,qBAAa,aAAa;IACxB,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,OAAO,CAGX;IACJ,OAAO,CAAC,oBAAoB,CAA4C;IACxE,OAAO,CAAC,UAAU,CAAsB;IACxC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;gBAEjB,GAAG,EAAE,MAAM;IAMhB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCxB,UAAU,IAAI,IAAI;IAMzB,IAAW,WAAW,IAAI,OAAO,CAEhC;IAIM,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAe/D,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAWxD,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,mBAAmB,GAAG,IAAI;IAQpE,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,aAAa;CAyBtB"}

package/dist/JsonRpcClient.js

@@ -0,0 +1,123 @@
+/**
+ * @vemjs/lsp-client — JSON-RPC 2.0 Protocol Engine
+ *
+ * Handles request/response correlation and notification routing
+ * over a WebSocket transport layer.
+ */
+export class JsonRpcClient {
+    ws = null;
+    nextId = 1;
+    pending = new Map();
+    notificationHandlers = new Map();
+    readyQueue = [];
+    connected = false;
+    url;
+    constructor(url) {
+        this.url = url;
+    }
+    // ── Connection ─────────────────────────────────────────────────────────────
+    connect() {
+        return new Promise((resolve, reject) => {
+            this.ws = new WebSocket(this.url);
+            this.ws.onopen = () => {
+                this.connected = true;
+                for (const fn of this.readyQueue)
+                    fn();
+                this.readyQueue = [];
+                resolve();
+            };
+            this.ws.onmessage = (ev) => {
+                try {
+                    this.handleMessage(JSON.parse(ev.data));
+                }
+                catch {
+                    console.warn('[JsonRpcClient] Failed to parse message:', ev.data);
+                }
+            };
+            this.ws.onerror = (ev) => {
+                reject(ev);
+            };
+            this.ws.onclose = () => {
+                this.connected = false;
+                // Reject all pending requests on disconnect
+                for (const [id, p] of this.pending) {
+                    p.reject(new Error(`Connection closed before response for id=${id}`));
+                }
+                this.pending.clear();
+            };
+        });
+    }
+    disconnect() {
+        this.ws?.close();
+        this.ws = null;
+        this.connected = false;
+    }
+    get isConnected() {
+        return this.connected;
+    }
+    // ── Outbound ───────────────────────────────────────────────────────────────
+    sendRequest(method, params) {
+        const id = this.nextId++;
+        const message = {
+            jsonrpc: '2.0',
+            id,
+            method,
+            ...(params !== undefined && { params }),
+        };
+        return new Promise((resolve, reject) => {
+            this.pending.set(id, { resolve, reject });
+            this.send(message);
+        });
+    }
+    sendNotification(method, params) {
+        const message = {
+            jsonrpc: '2.0',
+            method,
+            ...(params !== undefined && { params }),
+        };
+        this.send(message);
+    }
+    // ── Inbound ────────────────────────────────────────────────────────────────
+    onNotification(method, cb) {
+        const handlers = this.notificationHandlers.get(method) ?? [];
+        handlers.push(cb);
+        this.notificationHandlers.set(method, handlers);
+    }
+    // ── Internal ───────────────────────────────────────────────────────────────
+    send(message) {
+        const send = () => this.ws?.send(JSON.stringify(message));
+        if (this.connected) {
+            send();
+        }
+        else {
+            this.readyQueue.push(send);
+        }
+    }
+    handleMessage(message) {
+        // Response (has `id` and `result` or `error`)
+        if ('id' in message && ('result' in message || 'error' in message)) {
+            const response = message;
+            const pending = this.pending.get(response.id);
+            if (pending) {
+                this.pending.delete(response.id);
+                if (response.error) {
+                    pending.reject(response.error);
+                }
+                else {
+                    pending.resolve(response.result);
+                }
+            }
+            return;
+        }
+        // Notification (no `id`)
+        if ('method' in message && !('id' in message)) {
+            const notification = message;
+            const handlers = this.notificationHandlers.get(notification.method);
+            if (handlers) {
+                for (const h of handlers)
+                    h(notification.params);
+            }
+        }
+    }
+}
+//# sourceMappingURL=JsonRpcClient.js.map

package/dist/JsonRpcClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonRpcClient.js","sourceRoot":"","sources":["../src/JsonRpcClient.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0BH,MAAM,OAAO,aAAa;IAChB,EAAE,GAAqB,IAAI,CAAC;IAC5B,MAAM,GAAG,CAAC,CAAC;IACX,OAAO,GAAG,IAAI,GAAG,EAGtB,CAAC;IACI,oBAAoB,GAAG,IAAI,GAAG,EAAiC,CAAC;IAChE,UAAU,GAAmB,EAAE,CAAC;IAChC,SAAS,GAAG,KAAK,CAAC;IACT,GAAG,CAAS;IAE7B,YAAY,GAAW;QACrB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAED,8EAA8E;IAEvE,OAAO;QACZ,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,EAAE,GAAG,IAAI,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAElC,IAAI,CAAC,EAAE,CAAC,MAAM,GAAG,GAAG,EAAE;gBACpB,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;gBACtB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,UAAU;oBAAE,EAAE,EAAE,CAAC;gBACvC,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;gBACrB,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC;YAEF,IAAI,CAAC,EAAE,CAAC,SAAS,GAAG,CAAC,EAAE,EAAE,EAAE;gBACzB,IAAI,CAAC;oBACH,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAc,CAAmB,CAAC,CAAC;gBACtE,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,CAAC,IAAI,CAAC,0CAA0C,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;gBACpE,CAAC;YACH,CAAC,CAAC;YAEF,IAAI,CAAC,EAAE,CAAC,OAAO,GAAG,CAAC,EAAE,EAAE,EAAE;gBACvB,MAAM,CAAC,EAAE,CAAC,CAAC;YACb,CAAC,CAAC;YAEF,IAAI,CAAC,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE;gBACrB,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;gBACvB,4CAA4C;gBAC5C,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;oBACnC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4CAA4C,EAAE,EAAE,CAAC,CAAC,CAAC;gBACxE,CAAC;gBACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,UAAU;QACf,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC;QACjB,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC;QACf,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;IACzB,CAAC;IAED,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,8EAA8E;IAEvE,WAAW,CAAC,MAAc,EAAE,MAAgB;QACjD,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACzB,MAAM,OAAO,GAAmB;YAC9B,OAAO,EAAE,KAAK;YACd,EAAE;YACF,MAAM;YACN,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;SACxC,CAAC;QAEF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;YAC1C,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC,CAAC,CAAC;IACL,CAAC;IAEM,gBAAgB,CAAC,MAAc,EAAE,MAAgB;QACtD,MAAM,OAAO,GAAwB;YACnC,OAAO,EAAE,KAAK;YACd,MAAM;YACN,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,CAAC;SACxC,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,CAAC;IAED,8EAA8E;IAEvE,cAAc,CAAC,MAAc,EAAE,EAAuB;QAC3D,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAClB,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAClD,CAAC;IAED,8EAA8E;IAEtE,IAAI,CAAC,OAAuB;QAClC,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1D,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,EAAE,CAAC;QACT,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAEO,aAAa,CAAC,OAAuB;QAC3C,8CAA8C;QAC9C,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,QAAQ,IAAI,OAAO,IAAI,OAAO,IAAI,OAAO,CAAC,EAAE,CAAC;YACnE,MAAM,QAAQ,GAAG,OAA0B,CAAC;YAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC9C,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;gBACjC,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;oBACnB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBACjC,CAAC;qBAAM,CAAC;oBACN,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;YACD,OAAO;QACT,CAAC;QAED,yBAAyB;QACzB,IAAI,QAAQ,IAAI,OAAO,IAAI,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,EAAE,CAAC;YAC9C,MAAM,YAAY,GAAG,OAA8B,CAAC;YACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACpE,IAAI,QAAQ,EAAE,CAAC;gBACb,KAAK,MAAM,CAAC,IAAI,QAAQ;oBAAE,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;YACnD,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @vemjs/lsp-client — Language Server Protocol Client
+ *
+ * Implements the LSP specification subset needed for:
+ *   - Initialize / Shutdown handshake
+ *   - textDocument/didOpen, didChange, didClose
+ *   - textDocument/completion (autocomplete)
+ *   - textDocument/publishDiagnostics (error / warning highlights)
+ *   - textDocument/hover
+ */
+import type { VemEditorState } from '@vemjs/core';
+export type { JsonRpcRequest, JsonRpcNotification, JsonRpcResponse, JsonRpcMessage, NotificationHandler, } from './JsonRpcClient';
+export interface LspPosition {
+    line: number;
+    character: number;
+}
+export interface LspRange {
+    start: LspPosition;
+    end: LspPosition;
+}
+export interface LspTextDocumentIdentifier {
+    uri: string;
+}
+export interface LspTextDocumentItem {
+    uri: string;
+    languageId: string;
+    version: number;
+    text: string;
+}
+export interface LspCompletionItem {
+    label: string;
+    kind?: number;
+    detail?: string;
+    insertText?: string;
+}
+export interface LspCompletionList {
+    isIncomplete: boolean;
+    items: LspCompletionItem[];
+}
+export interface LspDiagnostic {
+    range: LspRange;
+    severity?: 1 | 2 | 3 | 4;
+    message: string;
+    source?: string;
+}
+export type CompletionResultCallback = (items: LspCompletionItem[]) => void;
+export type HoverCallback = (content: string) => void;
+export declare class LSPClient {
+    private rpc;
+    private fileUri;
+    private languageId;
+    private editorState;
+    private version;
+    private initialized;
+    private completionCallbacks;
+    private hoverCallbacks;
+    constructor(serverUrl: string, fileUri: string, languageId: string);
+    connect(editorState?: VemEditorState): Promise<void>;
+    disconnect(): void;
+    attach(editorState: VemEditorState): void;
+    private sendDidOpen;
+    private sendDidChange;
+    sendDidClose(): void;
+    requestCompletion(line: number, character: number): Promise<LspCompletionItem[]>;
+    private parseCompletionResult;
+    onCompletion(cb: CompletionResultCallback): void;
+    requestHover(line: number, character: number): Promise<string | null>;
+    onHover(cb: HoverCallback): void;
+    private handlePublishDiagnostics;
+    setFileUri(uri: string): void;
+    setLanguageId(languageId: string): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAkC,MAAM,aAAa,CAAC;AAElF,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,eAAe,EACf,cAAc,EACd,mBAAmB,GACpB,MAAM,iBAAiB,CAAC;AAIzB,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,WAAW,CAAC;CAClB;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,wBAAwB,GAAG,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,IAAI,CAAC;AAC5E,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;AAatD,qBAAa,SAAS;IACpB,OAAO,CAAC,GAAG,CAAgB;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAA+B;IAClD,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,mBAAmB,CAAkC;IAC7D,OAAO,CAAC,cAAc,CAAuB;gBAEjC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;IAQrD,OAAO,CAAC,WAAW,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAoC1D,UAAU,IAAI,IAAI;IAUlB,MAAM,CAAC,WAAW,EAAE,cAAc,GAAG,IAAI;IAchD,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,aAAa;IAQd,YAAY,IAAI,IAAI;IAQd,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAa7F,OAAO,CAAC,qBAAqB;IAStB,YAAY,CAAC,EAAE,EAAE,wBAAwB,GAAG,IAAI;IAM1C,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA4B3E,OAAO,CAAC,EAAE,EAAE,aAAa,GAAG,IAAI;IAMvC,OAAO,CAAC,wBAAwB;IAiBzB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI7B,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;CAG/C"}

package/dist/index.js

@@ -0,0 +1,187 @@
+/**
+ * @vemjs/lsp-client — Language Server Protocol Client
+ *
+ * Implements the LSP specification subset needed for:
+ *   - Initialize / Shutdown handshake
+ *   - textDocument/didOpen, didChange, didClose
+ *   - textDocument/completion (autocomplete)
+ *   - textDocument/publishDiagnostics (error / warning highlights)
+ *   - textDocument/hover
+ */
+import { JsonRpcClient } from './JsonRpcClient';
+// ── Severity mapping ────────────────────────────────────────────────────────
+const LSP_SEVERITY_MAP = {
+    1: 'error',
+    2: 'warning',
+    3: 'info',
+    4: 'hint',
+};
+// ── LSPClient ───────────────────────────────────────────────────────────────
+export class LSPClient {
+    rpc;
+    fileUri;
+    languageId;
+    editorState = null;
+    version = 0;
+    initialized = false;
+    completionCallbacks = [];
+    hoverCallbacks = [];
+    constructor(serverUrl, fileUri, languageId) {
+        this.rpc = new JsonRpcClient(serverUrl);
+        this.fileUri = fileUri;
+        this.languageId = languageId;
+    }
+    // ── Lifecycle ─────────────────────────────────────────────────────────────
+    async connect(editorState) {
+        await this.rpc.connect();
+        if (editorState) {
+            this.attach(editorState);
+        }
+        // LSP initialize handshake
+        await this.rpc.sendRequest('initialize', {
+            processId: null,
+            clientInfo: { name: 'vem', version: '0.1.0' },
+            rootUri: null,
+            capabilities: {
+                textDocument: {
+                    synchronization: { didOpen: true, didChange: true, didClose: true },
+                    completion: { completionItem: { snippetSupport: false } },
+                    hover: {},
+                    publishDiagnostics: {},
+                },
+            },
+        });
+        this.rpc.sendNotification('initialized', {});
+        this.initialized = true;
+        // Register diagnostics listener
+        this.rpc.onNotification('textDocument/publishDiagnostics', (params) => {
+            this.handlePublishDiagnostics(params);
+        });
+        // If editor was already open, sync immediately
+        if (this.editorState) {
+            this.sendDidOpen();
+        }
+    }
+    disconnect() {
+        if (this.initialized) {
+            this.rpc.sendNotification('exit', undefined);
+        }
+        this.rpc.disconnect();
+        this.initialized = false;
+    }
+    // ── Editor state binding ──────────────────────────────────────────────────
+    attach(editorState) {
+        this.editorState = editorState;
+        editorState.onDidOpenBuffer(() => {
+            if (this.initialized)
+                this.sendDidOpen();
+        });
+        editorState.onDidChangeBuffer(() => {
+            if (this.initialized)
+                this.sendDidChange();
+        });
+    }
+    // ── textDocument sync ─────────────────────────────────────────────────────
+    sendDidOpen() {
+        if (!this.editorState)
+            return;
+        this.rpc.sendNotification('textDocument/didOpen', {
+            textDocument: {
+                uri: this.fileUri,
+                languageId: this.languageId,
+                version: ++this.version,
+                text: this.editorState.getText(),
+            },
+        });
+    }
+    sendDidChange() {
+        if (!this.editorState)
+            return;
+        this.rpc.sendNotification('textDocument/didChange', {
+            textDocument: { uri: this.fileUri, version: ++this.version },
+            contentChanges: [{ text: this.editorState.getText() }],
+        });
+    }
+    sendDidClose() {
+        this.rpc.sendNotification('textDocument/didClose', {
+            textDocument: { uri: this.fileUri },
+        });
+    }
+    // ── Completion ────────────────────────────────────────────────────────────
+    async requestCompletion(line, character) {
+        if (!this.initialized)
+            return [];
+        const result = await this.rpc.sendRequest('textDocument/completion', {
+            textDocument: { uri: this.fileUri },
+            position: { line, character },
+        });
+        const items = this.parseCompletionResult(result);
+        for (const cb of this.completionCallbacks)
+            cb(items);
+        return items;
+    }
+    parseCompletionResult(result) {
+        if (!result)
+            return [];
+        if (Array.isArray(result))
+            return result;
+        if (typeof result === 'object' && 'items' in result) {
+            return result.items;
+        }
+        return [];
+    }
+    onCompletion(cb) {
+        this.completionCallbacks.push(cb);
+    }
+    // ── Hover ─────────────────────────────────────────────────────────────────
+    async requestHover(line, character) {
+        if (!this.initialized)
+            return null;
+        const result = await this.rpc.sendRequest('textDocument/hover', {
+            textDocument: { uri: this.fileUri },
+            position: { line, character },
+        });
+        if (!result || typeof result !== 'object')
+            return null;
+        const hover = result;
+        let text = null;
+        if (typeof hover.contents === 'string') {
+            text = hover.contents;
+        }
+        else if (typeof hover.contents === 'object' &&
+            hover.contents !== null &&
+            'value' in hover.contents) {
+            text = hover.contents.value;
+        }
+        if (text) {
+            for (const cb of this.hoverCallbacks)
+                cb(text);
+        }
+        return text;
+    }
+    onHover(cb) {
+        this.hoverCallbacks.push(cb);
+    }
+    // ── Diagnostics ───────────────────────────────────────────────────────────
+    handlePublishDiagnostics(params) {
+        if (!this.editorState || params.uri !== this.fileUri)
+            return;
+        const mapped = params.diagnostics.map((d) => ({
+            line: d.range.start.line,
+            startCharacter: d.range.start.character,
+            endCharacter: d.range.end.character,
+            severity: LSP_SEVERITY_MAP[d.severity ?? 1] ?? 'error',
+            message: d.message,
+            source: d.source,
+        }));
+        this.editorState.setDiagnostics(mapped);
+    }
+    // ── Workspace ─────────────────────────────────────────────────────────────
+    setFileUri(uri) {
+        this.fileUri = uri;
+    }
+    setLanguageId(languageId) {
+        this.languageId = languageId;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@vemjs/lsp-client",
+  "version": "0.1.0",
+  "description": "LSP protocol client for the Vem editor",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "@vemjs/core": "workspace:*"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/JsonRpcClient.ts

@@ -0,0 +1,164 @@
+/**
+ * @vemjs/lsp-client — JSON-RPC 2.0 Protocol Engine
+ *
+ * Handles request/response correlation and notification routing
+ * over a WebSocket transport layer.
+ */
+
+export interface JsonRpcRequest {
+  jsonrpc: '2.0';
+  id: number;
+  method: string;
+  params?: unknown;
+}
+
+export interface JsonRpcNotification {
+  jsonrpc: '2.0';
+  method: string;
+  params?: unknown;
+}
+
+export interface JsonRpcResponse {
+  jsonrpc: '2.0';
+  id: number;
+  result?: unknown;
+  error?: { code: number; message: string; data?: unknown };
+}
+
+export type JsonRpcMessage = JsonRpcRequest | JsonRpcNotification | JsonRpcResponse;
+
+export type NotificationHandler = (params: unknown) => void;
+
+export class JsonRpcClient {
+  private ws: WebSocket | null = null;
+  private nextId = 1;
+  private pending = new Map<
+    number,
+    { resolve: (v: unknown) => void; reject: (e: unknown) => void }
+  >();
+  private notificationHandlers = new Map<string, NotificationHandler[]>();
+  private readyQueue: (() => void)[] = [];
+  private connected = false;
+  private readonly url: string;
+
+  constructor(url: string) {
+    this.url = url;
+  }
+
+  // ── Connection ─────────────────────────────────────────────────────────────
+
+  public connect(): Promise<void> {
+    return new Promise((resolve, reject) => {
+      this.ws = new WebSocket(this.url);
+
+      this.ws.onopen = () => {
+        this.connected = true;
+        for (const fn of this.readyQueue) fn();
+        this.readyQueue = [];
+        resolve();
+      };
+
+      this.ws.onmessage = (ev) => {
+        try {
+          this.handleMessage(JSON.parse(ev.data as string) as JsonRpcMessage);
+        } catch {
+          console.warn('[JsonRpcClient] Failed to parse message:', ev.data);
+        }
+      };
+
+      this.ws.onerror = (ev) => {
+        reject(ev);
+      };
+
+      this.ws.onclose = () => {
+        this.connected = false;
+        // Reject all pending requests on disconnect
+        for (const [id, p] of this.pending) {
+          p.reject(new Error(`Connection closed before response for id=${id}`));
+        }
+        this.pending.clear();
+      };
+    });
+  }
+
+  public disconnect(): void {
+    this.ws?.close();
+    this.ws = null;
+    this.connected = false;
+  }
+
+  public get isConnected(): boolean {
+    return this.connected;
+  }
+
+  // ── Outbound ───────────────────────────────────────────────────────────────
+
+  public sendRequest(method: string, params?: unknown): Promise<unknown> {
+    const id = this.nextId++;
+    const message: JsonRpcRequest = {
+      jsonrpc: '2.0',
+      id,
+      method,
+      ...(params !== undefined && { params }),
+    };
+
+    return new Promise((resolve, reject) => {
+      this.pending.set(id, { resolve, reject });
+      this.send(message);
+    });
+  }
+
+  public sendNotification(method: string, params?: unknown): void {
+    const message: JsonRpcNotification = {
+      jsonrpc: '2.0',
+      method,
+      ...(params !== undefined && { params }),
+    };
+    this.send(message);
+  }
+
+  // ── Inbound ────────────────────────────────────────────────────────────────
+
+  public onNotification(method: string, cb: NotificationHandler): void {
+    const handlers = this.notificationHandlers.get(method) ?? [];
+    handlers.push(cb);
+    this.notificationHandlers.set(method, handlers);
+  }
+
+  // ── Internal ───────────────────────────────────────────────────────────────
+
+  private send(message: JsonRpcMessage): void {
+    const send = () => this.ws?.send(JSON.stringify(message));
+    if (this.connected) {
+      send();
+    } else {
+      this.readyQueue.push(send);
+    }
+  }
+
+  private handleMessage(message: JsonRpcMessage): void {
+    // Response (has `id` and `result` or `error`)
+    if ('id' in message && ('result' in message || 'error' in message)) {
+      const response = message as JsonRpcResponse;
+      const pending = this.pending.get(response.id);
+      if (pending) {
+        this.pending.delete(response.id);
+        if (response.error) {
+          pending.reject(response.error);
+        } else {
+          pending.resolve(response.result);
+        }
+      }
+      return;
+    }
+
+    // Notification (no `id`)
+    if ('method' in message && !('id' in message)) {
+      const notification = message as JsonRpcNotification;
+      const handlers = this.notificationHandlers.get(notification.method);
+      if (handlers) {
+        for (const h of handlers) h(notification.params);
+      }
+    }
+  }
+}

package/src/index.test.ts

@@ -0,0 +1,211 @@
+import { describe, it, expect, beforeEach } from 'bun:test';
+import { VemEditorState } from '@vemjs/core';
+import { JsonRpcClient } from './JsonRpcClient';
+import { LSPClient } from './index';
+
+// ── Mock WebSocket ───────────────────────────────────────────────────────────
+
+interface SentMessage {
+  jsonrpc: string;
+  id?: number;
+  method: string;
+  params?: unknown;
+}
+
+class MockWebSocket {
+  static instances: MockWebSocket[] = [];
+
+  onopen: (() => void) | null = null;
+  onmessage: ((ev: { data: string }) => void) | null = null;
+  onerror: ((ev: unknown) => void) | null = null;
+  onclose: (() => void) | null = null;
+
+  sentMessages: SentMessage[] = [];
+  readyState = 1; // OPEN
+
+  constructor(_url: string) {
+    MockWebSocket.instances.push(this);
+    // Simulate async open
+    Promise.resolve().then(() => this.onopen?.());
+  }
+
+  send(data: string) {
+    this.sentMessages.push(JSON.parse(data) as SentMessage);
+
+    // Auto-respond to requests with a mock result
+    const msg = JSON.parse(data) as SentMessage;
+    if (msg.id !== undefined) {
+      Promise.resolve().then(() => {
+        this.onmessage?.({
+          data: JSON.stringify({
+            jsonrpc: '2.0',
+            id: msg.id,
+            result:
+              msg.method === 'textDocument/completion'
+                ? { isIncomplete: false, items: [{ label: 'console', kind: 6 }] }
+                : {},
+          }),
+        });
+      });
+    }
+  }
+
+  close() {
+    this.readyState = 3;
+    this.onclose?.();
+  }
+
+  /** Helper: simulate a server push notification */
+  pushNotification(method: string, params: unknown) {
+    this.onmessage?.({
+      data: JSON.stringify({ jsonrpc: '2.0', method, params }),
+    });
+  }
+}
+
+// Inject mock globally
+(globalThis as unknown as Record<string, unknown>).WebSocket = MockWebSocket;
+
+// ── JsonRpcClient tests ──────────────────────────────────────────────────────
+
+describe('JsonRpcClient', () => {
+  beforeEach(() => {
+    MockWebSocket.instances = [];
+  });
+
+  it('should connect and resolve sendRequest via mock response', async () => {
+    const client = new JsonRpcClient('ws://localhost:2087');
+    await client.connect();
+
+    const ws = MockWebSocket.instances[0];
+    expect(ws).toBeDefined();
+    expect(client.isConnected).toBe(true);
+
+    const result = await client.sendRequest('textDocument/completion', {
+      textDocument: { uri: 'file:///test.ts' },
+      position: { line: 0, character: 5 },
+    });
+
+    expect(result).toBeDefined();
+  });
+
+  it('should dispatch onNotification handlers', async () => {
+    const client = new JsonRpcClient('ws://localhost:2087');
+    await client.connect();
+
+    let received: unknown = null;
+    client.onNotification('textDocument/publishDiagnostics', (params) => {
+      received = params;
+    });
+
+    const ws = MockWebSocket.instances[0];
+    ws.pushNotification('textDocument/publishDiagnostics', {
+      uri: 'file:///test.ts',
+      diagnostics: [],
+    });
+
+    // Give the microtask queue a chance to flush
+    await Promise.resolve();
+    expect(received).not.toBeNull();
+  });
+
+  it('should send notifications without expecting a response', async () => {
+    const client = new JsonRpcClient('ws://localhost:2087');
+    await client.connect();
+
+    client.sendNotification('textDocument/didClose', {
+      textDocument: { uri: 'file:///test.ts' },
+    });
+
+    const ws = MockWebSocket.instances[0];
+    const notif = ws.sentMessages.find((m) => m.method === 'textDocument/didClose');
+    expect(notif).toBeDefined();
+    expect(notif?.id).toBeUndefined();
+  });
+});
+
+// ── LSPClient integration tests ──────────────────────────────────────────────
+
+describe('LSPClient', () => {
+  beforeEach(() => {
+    MockWebSocket.instances = [];
+  });
+
+  it('should sync buffer text on didOpen after connect', async () => {
+    const editor = new VemEditorState('const x = 1;');
+    const lsp = new LSPClient('ws://localhost:2087', 'file:///test.ts', 'typescript');
+    await lsp.connect(editor);
+
+    const ws = MockWebSocket.instances[0];
+    // Wait for the async didOpen triggered by the setTimeout in editor state
+    await new Promise((r) => setTimeout(r, 10));
+
+    const didOpen = ws.sentMessages.find((m) => m.method === 'textDocument/didOpen');
+    expect(didOpen).toBeDefined();
+    const doc = (didOpen?.params as { textDocument: { text: string } })?.textDocument;
+    expect(doc?.text).toBe('const x = 1;');
+  });
+
+  it('should update diagnostics in editor state on publishDiagnostics', async () => {
+    const editor = new VemEditorState('let x: number = "oops";');
+    const lsp = new LSPClient('ws://localhost:2087', 'file:///test.ts', 'typescript');
+    await lsp.connect(editor);
+
+    await new Promise((r) => setTimeout(r, 5));
+
+    const ws = MockWebSocket.instances[0];
+    ws.pushNotification('textDocument/publishDiagnostics', {
+      uri: 'file:///test.ts',
+      diagnostics: [
+        {
+          range: {
+            start: { line: 0, character: 16 },
+            end: { line: 0, character: 22 },
+          },
+          severity: 1,
+          message: "Type 'string' is not assignable to type 'number'.",
+          source: 'tsserver',
+        },
+      ],
+    });
+
+    await Promise.resolve();
+    const diags = editor.getDiagnostics();
+    expect(diags).toHaveLength(1);
+    expect(diags[0].severity).toBe('error');
+    expect(diags[0].line).toBe(0);
+    expect(diags[0].source).toBe('tsserver');
+  });
+
+  it('should fire onPublishDiagnostics callback when diagnostics arrive', async () => {
+    const editor = new VemEditorState('');
+    const lsp = new LSPClient('ws://localhost:2087', 'file:///test.ts', 'typescript');
+    await lsp.connect(editor);
+
+    let callbackFired = false;
+    editor.onPublishDiagnostics((_diags) => {
+      callbackFired = true;
+    });
+
+    await new Promise((r) => setTimeout(r, 5));
+    const ws = MockWebSocket.instances[0];
+    ws.pushNotification('textDocument/publishDiagnostics', {
+      uri: 'file:///test.ts',
+      diagnostics: [],
+    });
+    await Promise.resolve();
+
+    // setDiagnostics fires callbacks even for empty arrays
+    expect(callbackFired).toBe(true);
+  });
+
+  it('should request completions and return items', async () => {
+    const editor = new VemEditorState('console');
+    const lsp = new LSPClient('ws://localhost:2087', 'file:///test.ts', 'typescript');
+    await lsp.connect(editor);
+
+    const items = await lsp.requestCompletion(0, 7);
+    expect(items.length).toBeGreaterThan(0);
+    expect(items[0].label).toBe('console');
+  });
+});

package/src/index.ts

@@ -0,0 +1,270 @@
+/**
+ * @vemjs/lsp-client — Language Server Protocol Client
+ *
+ * Implements the LSP specification subset needed for:
+ *   - Initialize / Shutdown handshake
+ *   - textDocument/didOpen, didChange, didClose
+ *   - textDocument/completion (autocomplete)
+ *   - textDocument/publishDiagnostics (error / warning highlights)
+ *   - textDocument/hover
+ */
+
+import type { VemEditorState, Diagnostic, DiagnosticSeverity } from '@vemjs/core';
+import { JsonRpcClient } from './JsonRpcClient';
+export type {
+  JsonRpcRequest,
+  JsonRpcNotification,
+  JsonRpcResponse,
+  JsonRpcMessage,
+  NotificationHandler,
+} from './JsonRpcClient';
+
+// ── LSP Types (subset of the spec) ─────────────────────────────────────────
+
+export interface LspPosition {
+  line: number;
+  character: number;
+}
+
+export interface LspRange {
+  start: LspPosition;
+  end: LspPosition;
+}
+
+export interface LspTextDocumentIdentifier {
+  uri: string;
+}
+
+export interface LspTextDocumentItem {
+  uri: string;
+  languageId: string;
+  version: number;
+  text: string;
+}
+
+export interface LspCompletionItem {
+  label: string;
+  kind?: number;
+  detail?: string;
+  insertText?: string;
+}
+
+export interface LspCompletionList {
+  isIncomplete: boolean;
+  items: LspCompletionItem[];
+}
+
+export interface LspDiagnostic {
+  range: LspRange;
+  severity?: 1 | 2 | 3 | 4; // error, warning, info, hint
+  message: string;
+  source?: string;
+}
+
+export type CompletionResultCallback = (items: LspCompletionItem[]) => void;
+export type HoverCallback = (content: string) => void;
+
+// ── Severity mapping ────────────────────────────────────────────────────────
+
+const LSP_SEVERITY_MAP: Record<number, DiagnosticSeverity> = {
+  1: 'error',
+  2: 'warning',
+  3: 'info',
+  4: 'hint',
+};
+
+// ── LSPClient ───────────────────────────────────────────────────────────────
+
+export class LSPClient {
+  private rpc: JsonRpcClient;
+  private fileUri: string;
+  private languageId: string;
+  private editorState: VemEditorState | null = null;
+  private version = 0;
+  private initialized = false;
+  private completionCallbacks: CompletionResultCallback[] = [];
+  private hoverCallbacks: HoverCallback[] = [];
+
+  constructor(serverUrl: string, fileUri: string, languageId: string) {
+    this.rpc = new JsonRpcClient(serverUrl);
+    this.fileUri = fileUri;
+    this.languageId = languageId;
+  }
+
+  // ── Lifecycle ─────────────────────────────────────────────────────────────
+
+  public async connect(editorState?: VemEditorState): Promise<void> {
+    await this.rpc.connect();
+
+    if (editorState) {
+      this.attach(editorState);
+    }
+
+    // LSP initialize handshake
+    await this.rpc.sendRequest('initialize', {
+      processId: null,
+      clientInfo: { name: 'vem', version: '0.1.0' },
+      rootUri: null,
+      capabilities: {
+        textDocument: {
+          synchronization: { didOpen: true, didChange: true, didClose: true },
+          completion: { completionItem: { snippetSupport: false } },
+          hover: {},
+          publishDiagnostics: {},
+        },
+      },
+    });
+
+    this.rpc.sendNotification('initialized', {});
+    this.initialized = true;
+
+    // Register diagnostics listener
+    this.rpc.onNotification('textDocument/publishDiagnostics', (params: unknown) => {
+      this.handlePublishDiagnostics(params as { uri: string; diagnostics: LspDiagnostic[] });
+    });
+
+    // If editor was already open, sync immediately
+    if (this.editorState) {
+      this.sendDidOpen();
+    }
+  }
+
+  public disconnect(): void {
+    if (this.initialized) {
+      this.rpc.sendNotification('exit', undefined);
+    }
+    this.rpc.disconnect();
+    this.initialized = false;
+  }
+
+  // ── Editor state binding ──────────────────────────────────────────────────
+
+  public attach(editorState: VemEditorState): void {
+    this.editorState = editorState;
+
+    editorState.onDidOpenBuffer(() => {
+      if (this.initialized) this.sendDidOpen();
+    });
+
+    editorState.onDidChangeBuffer(() => {
+      if (this.initialized) this.sendDidChange();
+    });
+  }
+
+  // ── textDocument sync ─────────────────────────────────────────────────────
+
+  private sendDidOpen(): void {
+    if (!this.editorState) return;
+    this.rpc.sendNotification('textDocument/didOpen', {
+      textDocument: {
+        uri: this.fileUri,
+        languageId: this.languageId,
+        version: ++this.version,
+        text: this.editorState.getText(),
+      } satisfies LspTextDocumentItem,
+    });
+  }
+
+  private sendDidChange(): void {
+    if (!this.editorState) return;
+    this.rpc.sendNotification('textDocument/didChange', {
+      textDocument: { uri: this.fileUri, version: ++this.version },
+      contentChanges: [{ text: this.editorState.getText() }],
+    });
+  }
+
+  public sendDidClose(): void {
+    this.rpc.sendNotification('textDocument/didClose', {
+      textDocument: { uri: this.fileUri } satisfies LspTextDocumentIdentifier,
+    });
+  }
+
+  // ── Completion ────────────────────────────────────────────────────────────
+
+  public async requestCompletion(line: number, character: number): Promise<LspCompletionItem[]> {
+    if (!this.initialized) return [];
+
+    const result = await this.rpc.sendRequest('textDocument/completion', {
+      textDocument: { uri: this.fileUri },
+      position: { line, character } satisfies LspPosition,
+    });
+
+    const items = this.parseCompletionResult(result);
+    for (const cb of this.completionCallbacks) cb(items);
+    return items;
+  }
+
+  private parseCompletionResult(result: unknown): LspCompletionItem[] {
+    if (!result) return [];
+    if (Array.isArray(result)) return result as LspCompletionItem[];
+    if (typeof result === 'object' && 'items' in (result as object)) {
+      return (result as LspCompletionList).items;
+    }
+    return [];
+  }
+
+  public onCompletion(cb: CompletionResultCallback): void {
+    this.completionCallbacks.push(cb);
+  }
+
+  // ── Hover ─────────────────────────────────────────────────────────────────
+
+  public async requestHover(line: number, character: number): Promise<string | null> {
+    if (!this.initialized) return null;
+
+    const result = await this.rpc.sendRequest('textDocument/hover', {
+      textDocument: { uri: this.fileUri },
+      position: { line, character } satisfies LspPosition,
+    });
+
+    if (!result || typeof result !== 'object') return null;
+    const hover = result as { contents: unknown };
+
+    let text: string | null = null;
+    if (typeof hover.contents === 'string') {
+      text = hover.contents;
+    } else if (
+      typeof hover.contents === 'object' &&
+      hover.contents !== null &&
+      'value' in hover.contents
+    ) {
+      text = (hover.contents as { value: string }).value;
+    }
+
+    if (text) {
+      for (const cb of this.hoverCallbacks) cb(text);
+    }
+    return text;
+  }
+
+  public onHover(cb: HoverCallback): void {
+    this.hoverCallbacks.push(cb);
+  }
+
+  // ── Diagnostics ───────────────────────────────────────────────────────────
+
+  private handlePublishDiagnostics(params: { uri: string; diagnostics: LspDiagnostic[] }): void {
+    if (!this.editorState || params.uri !== this.fileUri) return;
+
+    const mapped: Diagnostic[] = params.diagnostics.map((d) => ({
+      line: d.range.start.line,
+      startCharacter: d.range.start.character,
+      endCharacter: d.range.end.character,
+      severity: LSP_SEVERITY_MAP[d.severity ?? 1] ?? 'error',
+      message: d.message,
+      source: d.source,
+    }));
+
+    this.editorState.setDiagnostics(mapped);
+  }
+
+  // ── Workspace ─────────────────────────────────────────────────────────────
+
+  public setFileUri(uri: string): void {
+    this.fileUri = uri;
+  }
+
+  public setLanguageId(languageId: string): void {
+    this.languageId = languageId;
+  }
+}

package/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "noEmit": false,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "rootDir": "./src",
+    "outDir": "./dist"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["src/**/*.test.ts"]
+}