@danielx/civet-language-server

Civet Language Server

Standalone, editor-agnostic Language Server Protocol implementation for Civet. It also answers grammar-level requests (definition, references, document symbols, completions, hover) for Hera grammar files (.hera), parsed with the project's @danielx/hera.

Install

npm install -g @danielx/civet-language-server

For repository development:

pnpm -C lsp/server build
pnpm -C lsp/server test

Command Line

The package installs civet-lsp, which speaks LSP over stdio:

civet-lsp --stdio

Use this from editors or tools that can launch a standard LSP server process.

Browser Worker

The package also publishes browser-oriented entries for Monaco or other in-browser clients:

import { createCivetLspWorker } from '@danielx/civet-language-server/worker'

const worker = createCivetLspWorker({
  civetUrl: new URL('@danielx/civet/browser.min', import.meta.url),
  serverUrl: new URL('@danielx/civet-language-server/browser', import.meta.url),
})

civetUrl should point to a browser build that installs globalThis.Civet in the worker. serverUrl should point to @danielx/civet-language-server/browser or an equivalent browser bundle of this package.

For a working example, see the Playground and its source code.

Package Entries

Entry	Purpose
@danielx/civet-language-server	Conditional default entry: browser builds use the browser worker server; Node uses the Node stdio server
@danielx/civet-language-server/node	Explicit Node stdio server entry
@danielx/civet-language-server/browser	Explicit browser worker LSP server entry
@danielx/civet-language-server/worker	Browser helper for creating and talking to the worker

Use /node or /browser when a bundler's package conditions are not the runtime you want. The command-line civet-lsp wrapper always launches the Node entry.

Source Layout

Path	Purpose
source/server.civet	Shared LSP server implementation
source/node.civet	Node stdio entrypoint
source/browser.civet	Browser worker entrypoint
source/worker.civet	Browser-side worker helpers