Placitum for VS Code

Placitum support for .placitum files. A thin VS Code client: all analysis is answered by the bundled Placitum language server, no global install required.

Features

Syntax highlighting via TextMate grammar, plus bracket matching and comment/auto-close configuration.
Language server over stdio with diagnostics, completion, hover, rename and code lens/quick fixes driven by the server's capability model.
Commands:
- Placitum: Run file — saves the file and runs it in a terminal through the bundled CLI, using the file's directory as working directory; also offered as a play button in the editor title bar. Works in local and remote workspaces (Remote SSH, WSL, Dev Containers, Codespaces), requires a trusted workspace, and is hidden otherwise. The terminal stays open after the run (press any key to close it); closing it stops the script.
- Placitum: Show capability manifest — renders the placitum explain text in a markdown preview.
- Placitum: Reanalyze file.
- Placitum: Add missing needs — applies the server's workspace edit.
Settings mirroring the server configuration under the placitum.* section; changing one triggers re-analysis.

The language server and the Placitum core are bundled inside the extension, so there is nothing else to install.

Settings

Setting	Default	Description
`placitum.diagnostics.enable`	`true`	Enable diagnostics.
`placitum.diagnostics.scope`	`true`	Include scope diagnostics.
`placitum.diagnostics.strictChecks`	`true`	Enable strict checks.
`placitum.completion.enable`	`true`	Enable completion.
`placitum.completion.snippets`	`true`	Offer snippets.
`placitum.codeLens.enable`	`true`	Enable code lens.
`placitum.inlayHints.enable`	`false`	Enable inlay hints.
`placitum.inlayHints.capabilities`	`false`	Inlay hints for capabilities.
`placitum.workspaceSymbols.enable`	`true`	Enable workspace symbols.
`placitum.workspaceSymbols.maxFiles`	`2000`	File cap for workspace symbols.
`placitum.trace.server`	`"off"`	Trace LSP traffic (`off`/`messages`/`verbose`).

Requirements

VS Code 1.90 or newer.
A trusted workspace to run .placitum files.

Diagnostics delivery

VS Code supports pull diagnostics and keeps two separate collections: one for pushed textDocument/publishDiagnostics and one for pulled textDocument/diagnostic. It renders the union of both, so a server that does both shows every diagnostic twice.

The bundled language server therefore uses one model per client:

Pull clients (VS Code): the server advertises diagnosticProvider, sends results only through textDocument/diagnostic, and does not publish textDocument/publishDiagnostics. After a settings change it sends workspace/diagnostic/refresh so the client re-pulls the open documents live.
Push-only clients: the server publishes textDocument/publishDiagnostics as usual.

Settings that affect code lens or inlay hints are refreshed the same way through workspace/codeLens/refresh and workspace/inlayHint/refresh.

Development

The host needs Node 20+; the repository ships a Nix dev shell:

nix develop --command npm install
nix develop --command npm run bundle:server   # bundle placitum-lsp + placitum CLI
nix develop --command npm run smoke:server    # stdio smoke: E301, manifest, reanalyze
nix develop --command npm run smoke:cli       # bundled CLI runs a script
nix develop --command npm run test:guard      # unit-test the run guards
nix develop --command npm run smoke:wrapper   # run wrapper waits for input
nix develop --command npm run package         # produce the .vsix

License

MIT. The bundled placitum-lsp and placitum packages are also MIT; see THIRD-PARTY-NOTICES.md.