Language support for Kinglet (.kl) and kinglet.nest project manifests — syntax highlighting, diagnostics, completion, and a fast, native language server.

---

Features

• Diagnostics — real-time parser and type-checker errors as you type
• Completion — context-aware, parser-driven suggestions
• Go to Definition — jump to where a symbol is declared
• Hover — types and documentation on hover
• Document Symbols — outline view and breadcrumbs
• Signature Help — parameter hints while you call functions
• Semantic Tokens — precise, type-aware highlighting
• Syntax Highlighting — TextMate grammar for .kl files and kinglet.nest project manifests
• Manifest Diagnostics — real-time validation of kinglet.nest modules, targets, build, and fmt blocks
• Manifest Completion — context-aware suggestions for module names, paths, backends, and formatter extensions

The language server is written in C++ and reuses the official Kinglet compiler frontend, so diagnostics match the compiler exactly.

Getting Started

1. Install the extension.
2. Open any .kl file — the language mode (bottom-right) switches to Kinglet. Open a kinglet.nest file — the language mode switches to Kinglet Nest.
3. The language server starts automatically; a Perch indicator appears in the status bar once it is up.

Perch ships with a matching kinglet-lsp binary, so no extra setup is required on supported platforms. To use your own build, set kinglet.lspPath.

Settings

Setting	Default	Description
kinglet.lspPath	kinglet-lsp	Path to the Kinglet language server binary.
kinglet.trace.server	off	LSP trace verbosity (off, messages, verbose).

Commands

Command	Description
Perch: Show Language Server Log	Open the Perch output channel.
Perch: Restart Language Server	Restart the Kinglet language server.

Troubleshooting

• File opens as Plain Text — set the language mode (bottom-right) to Kinglet (or Kinglet Nest for kinglet.nest manifests), or ensure the file has the right extension / filename.
• No diagnostics / completion — run Perch: Show Language Server Log to check the server started. For detailed RPC traces, set "kinglet.trace.server": "verbose".
• Custom server — point kinglet.lspPath at your own kinglet-lsp binary.

Contributing

Building the language server from source, packaging the VSIX, and the repo layout are documented in CONTRIBUTING.md.