Vitte Language Support for VS Code
Professional tooling for the Vitte/Vitl language family: language server, debugger, diagnostics view, snippets, and icon theme—packaged as a single Visual Studio Code extension.
Overview
- ✅ Languages:
vitte, vit, vitl
- 🎨 Syntax & semantic highlighting via TextMate grammar and semantic tokens
- 🧠 Language Server: workspace-aware completion, hover, go to definition, document symbols, diagnostics, workspace watchers
- 🛠️ Debugging: Vitl launch/attach configurations, breakpoints, watch expressions, call stack
- 📊 Diagnostics view: Activity Bar panel with filter, refresh, and quick navigation
- 🗂️ Tooling integration: file watchers for
vitte.toml, .vitteconfig, vitl.toml, .vitlconfig
- 🧭 Module Explorer: browse modules, structs, and functions with per-module diagnostics health
- ✅ Real-time health indicator: status bar dot turns green when the workspace is clean and highlights warnings/errors instantly
See the Getting Started guide for a hands-on walkthrough.
Feature Highlights
| Area |
Highlights |
| Editing |
Rich language configuration, snippets for common constructs (async fn, switch/case, try/catch/finally, defer, unsafe, with) |
| Language Server |
Automatic restart, workspace completions (modules, symbols), telemetry log channel, configurable trace level, semantic diagnostics |
| Debugging |
Ready-to-use Vitl launch/attach recipes, breakpoint management, multi-config compounds |
| Structure |
Module Explorer view listing modules/structs/functions with per-entry diagnostics summaries |
| Observability |
Status bar health indicator, diagnostics dashboard, quick restart, detailed server logging |
| Reliability |
File system watchers for config changes, graceful server restarts, fallback server resolution with detailed logging |
Installation
Marketplace
Search for “Vitte Language Support” in VS Code or install via CLI:
code --install-extension VitteStudio.vitte-studio
Manual (VSIX)
vsce package
code --install-extension vitte-studio-<version>.vsix
Requires VS Code 1.93.0+, Node.js 18+, and the Vitte/Vitl toolchain (vitlc, vitlv) accessible via PATH.
Quick Start
- Open a workspace containing
.vitte, .vit, or .vitl files.
- Watch the status bar item
$(rocket) Vitte; when it turns to $(check) and shows $(pass-filled), the server is running and diagnostics are clean.
- Use
Vitte: Show Server Log to inspect language server activity.
- Press F5 to launch the default Vitl: Launch current file debug configuration.
- Open the Vitte ▸ Diagnostics view (Activity Bar) to triage warnings/errors.
Debugging Workflows
- Launch current file: Press F5 or select Vitl: Launch current file in Run and Debug.
- Launch with arguments: Add a configuration that passes CLI flags and environment variables.
- Attach to a running VM: Use Vitl: Attach to running VM (default host
127.0.0.1, port 6009).
- Compound sessions: Combine launch + attach to orchestrate tooling.
View complete launch samples in docs/getting-started.md.
Commands & Keybindings
| Command |
Title |
Default keybinding |
vitte.showServerLog |
Vitte: Show Server Log |
— |
vitte.restartServer |
Vitte: Restart Server |
Ctrl+Shift+R (Win/Linux) / ⌃⇧R (macOS) |
vitte.runAction |
Vitte: Run Action |
— |
vitte.runActionWithArgs |
Vitte: Run Action (Args) |
— |
vitte.organizeImports |
Vitte: Organize Imports |
— |
vitte.fixAll |
Vitte: Fix All |
— |
vitte.debug.runFile |
Vitte Debug: Run File |
— |
vitte.debug.attachServer |
Vitte Debug: Attach |
— |
vitte.modules.refresh |
Vitte: Rafraîchir la structure |
— |
All commands are discoverable from the Command Palette (⇧⌘P / Ctrl+Shift+P).
Settings
| Setting |
Default |
Description |
vitte.trace.server |
"off" |
Controls language server trace level (off, messages, verbose). |
vitte.serverPath |
"" |
Absolute path to a custom LSP server binary. Leave empty to use the bundled server. |
Diagnostics & Observability
- Status bar health reflects lifecycle states and diagnostics: starting (
$(gear)), running ($(check)), stopped ($(debug-stop)), plus a green $(pass-filled) badge when the workspace is clean (warning/error icons otherwise).
- Output channel (Vitte Language Server) logs telemetry, status updates, and manual restart traces.
- Diagnostics View (
Vitte ▸ Diagnostics) aggregates LSP diagnostics with filtering and quick navigation.
Module Explorer
- The Vitte ▸ Structure view (Activity Bar) presents modules, structs, enums, and functions grouped by module/file.
- Each node carries a live diagnostics badge (green, warning, or error) so you can spot problematic areas instantly.
- Selecting an item jumps directly to the symbol definition with the appropriate editor reveal.
Documentation & Support
Development
npm install
npm run build
npm test # builds + runs VS Code integration suite
npm run lint # lint TypeScript sources
npm run watch # incremental builds
To publish a VSIX:
npm run package
The repository includes a full LSP implementation under server/, shared client utilities in src/, and integration tests in src/test.
Licence
Released under the MIT Licence.
| |
