apollovm_lsp library

ApolloVM Language Server (LSP 3.17) — editor/agent tooling for ApolloVM sources.

This library is part of the apollovm package but kept separate from package:apollovm/apollovm.dart so importing the VM does not pull in the language-server surface, and vice-versa.

It is web-safe: nothing here imports dart:io, so a browser-based IDE or an AI agent can embed the server directly. Wire it up with:

• MessageLspEndpoint — a host that already exchanges decoded JSON-RPC objects (web postMessage/MessageChannel, an in-process agent bridge):

  final endpoint = MessageLspEndpoint((msg) => port.postMessage(msg));
  final server = LspServer(endpoint);
  // deliver incoming messages:
  endpoint.receive(incomingJsonRpcMap);
  

• StreamLspEndpoint — byte streams with Content-Length framing (stdio, sockets). The CLI exposes this via apollovm lsp.

To consume the server, use LspClient, which correlates responses, streams diagnostics, and exposes typed helpers (LspClient.hover, LspClient.definition, …). LspClient.inProcess pairs a client with a fresh server in the same isolate:

final client = LspClient.inProcess();
await client.initialize();
client.didOpen('file:///Foo.dart', source);
final hover = await client.hover('file:///Foo.dart', Position(2, 13));

For the simplest embedding — no transport, no socket, no handshake to run by hand — use LspService, a document-oriented facade ideal for a web app or an AI agent:

final lsp = LspService();
final errors = await lsp.analyze('file:///Foo.dart', source);
final hover = await lsp.hover('file:///Foo.dart', Position(2, 13));