@formspec/language-server

Language-server support for FormSpec TSDoc tags.

The packaged server is a reference implementation built on top of the composable completion, hover, and diagnostics helpers exported by this package. Downstream tools can reuse those helpers directly and own the final publishing and presentation behavior themselves.

Install

pnpm add @formspec/language-server

Features

• completion items for FormSpec tags
• hover documentation for recognized tags
• go-to-definition support for known tags
• optional plugin-backed diagnostics publishing

Diagnostics are off by default. When enabled, the packaged server consumes canonical FormSpec diagnostics from @formspec/ts-plugin and converts them to LSP diagnostics using the same exported helpers that downstream consumers can call directly.

Usage

import {
  createServer,
  getDefinition,
  getCompletionItems,
  getHoverForTag,
  getPluginDiagnosticsForDocument,
  toLspDiagnostics,
} from "@formspec/language-server";

const server = createServer();
const completions = getCompletionItems();
const hover = getHoverForTag("minimum");

To enable packaged diagnostics publishing:

const server = createServer({
  diagnosticsMode: "plugin",
  diagnosticSource: "formspec",
});

For full white-label control, bypass createServer() and use:

• getPluginDiagnosticsForDocument(...)
• toLspDiagnostics(...)
• getDefinition(...)

or map canonical FormSpec diagnostics to your own editor/UI model directly.

License

This package is part of the FormSpec monorepo and is released under the MIT License. See LICENSE for details.