Vitte Language Support for VS Code

Professional tooling for the Vitte/Vit language family: language server, debugger, diagnostics view, snippets, and icon theme—packaged as a single Visual Studio Code extension.

---

Overview

• ✅ Languages: vitte, vit
• 🎨 Syntax & semantic highlighting via TextMate grammar and semantic tokens
• 📚 Official grammar: tokens, completions, and snippets follow the published Vitte .ebnf (module/import/union/CLI)
• 🧠 Language Server: workspace-aware completion, hover, go to definition, document symbols, diagnostics, workspace watchers
• 🛠️ Debugging: Vitte 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
• 🧭 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 module/import/fn/struct/enum/union/match/loops aligned with the official Vitte EBNF
Language Server	Automatic restart, workspace completions (modules, symbols), telemetry log channel, configurable trace level, semantic diagnostics
Debugging	Ready-to-use Vitte 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 toolchain accessible via PATH.

---

Quick Start

1. Open a workspace containing .vitte or .vit files.
2. Watch the status bar item $(rocket) Vitte; when it turns to $(check) and shows $(pass-filled), the server is running and diagnostics are clean.
3. Use Vitte: Show Server Log to inspect language server activity.
4. Press F5 to launch the default Vitte: Launch current file debug configuration.
5. Open the Vitte ▸ Diagnostics view (Activity Bar) to triage warnings/errors.

---

Debugging Workflows

• Launch current file: Press F5 or select Vitte: 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 Vitte: 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.showServerMetrics	Vitte: Show Server Metrics	—
vitte.showCommandMenu	Vitte: Show Command Menu	—
vitte.metrics.refresh	Vitte: Refresh Metrics View	—
vitte.restartServer	Vitte: Restart Server	Ctrl+Shift+R (Win/Linux) / ⌃⇧R (macOS)
vitte.runAction	Vitte: Run Action	—
vitte.runActionWithArgs	Vitte: Run Action (Args)	—
vitte.quickActions	Vitte: Quick (build/run/test/bench menu + sequences)	—
vitte.quickActions.exportStats	Vitte: Quick Export	—
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: Refresh Structure	—

All commands are discoverable from the Command Palette (⇧⌘P / Ctrl+Shift+P). The VS Code Welcome view also includes a Vitte Quickstart walkthrough that guides you through docs, toolchain detection, and the onboarding Quick action.
For even quicker access, the status bar exposes dedicated buttons for Build, Run, and Test, plus a $(list-selection) Vitte drop-down that lists the remaining commands (clean, bench, diagnostics, telemetry, etc.) without needing to type their names. When the extension activates, a toast also proposes these buttons so you can kick off a build/run/test immediately.

Custom Quick Action sequences

Describe your own pipelines in settings.json via vitte.quickActions.sequences:

"vitte.quickActions.sequences": [
  {
    "id": "pipeline.build-test-bench",
    "label": "Build + Test + Bench",
    "description": "Full pipeline to validate the CI",
    "steps": [
      { "command": "vitte.build" },
      { "command": "vitte.test" },
      { "command": "vitte.bench" }
    ]
  }
]

Each sequence automatically appears under Vitte: Quick, benefits from favorites/MRU, and can chain any VS Code command (vitte.*, workbench.action.*, etc.). Use Vitte: Quick Export to generate a JSON report of your top workflows.

Critical entries in the Quick palette (Build/Run/Test/Bench) display a telemetry-driven “🔁 Dernière exécution” badge plus an “⟳ Exécuter à nouveau” hint so you can immediately replay the workflows you run the most.

Run Setup Quick Action

New to the toolchain? Launch Vitte: Quick Actions, choose the 🚀 Setup entry, and let the extension guide you through the three essentials:

1. Open the bundled docs (vitte.openDocs)
2. Detect the local toolchain (vitte.detectToolchain)
3. Kick off the first build (vitte.build)

This mirrors the onboarding walkthrough, but can be triggered any time from the palette, the Quick Actions status button, or the startup toast.

Override built-in Quick Actions

Need to tweak the default build/test/run behavior without writing full sequences? Override any built-in entry via vitte.quickActions.defaults:

"vitte.quickActions.defaults": {
  "build": {
    "label": "⚙️ Build (profile dev)",
    "args": ["--profile", "dev", "--incremental"]
  },
  "bench": {
    "actions": [
      { "command": "vitte.clean" },
      { "command": "vitte.bench", "args": ["--auto"] }
    ]
  }
}

Available ids include build, run, tests, testFile, bench, benchReport, benchDir, diagnostics.refresh, diagnostics.next, docs, profile, incremental, docs.combo, and onboarding.setup.

Custom command shortcuts

Tune the status-bar buttons and startup toast via vitte.commandShortcuts:

"vitte.commandShortcuts": [
  { "label": "Build", "command": "vitte.build", "icon": "$(tools)" },
  { "label": "Docs", "command": "vitte.openDocs", "statusBar": true, "startup": false },
  { "label": "Bench", "command": "vitte.bench", "icon": "$(pulse)", "tooltip": "Bench the workspace" }
]

Each entry accepts a label, command identifier, optional codicon/tooltip, and booleans to control whether it appears in the status bar or the startup toast.

---

Settings

• Core

  • vitte.trace.server (default: "off") — Language server trace level (off, messages, verbose).
  • vitte.serverPath (default: "") — Absolute path to a custom LSP server binary. Leave empty to use the bundled server.

• Formatting (vitte.formatting.*) — used by the language server for document/range formatting

  • vitte.formatting.tabSize (default: 2) — Indentation size in spaces (1..16).
  • vitte.formatting.insertSpaces (default: true) — Use spaces instead of tabs.
  • vitte.formatting.trimTrailingWhitespace (default: true) — Remove trailing spaces at end of lines.
  • vitte.formatting.insertFinalNewline (default: true) — Ensure a final newline at end of file.
  • vitte.formatting.eol (default: "lf") — End‑of‑line policy: lf, crlf, or auto.
  • vitte.formatting.detectMixedIndentation (default: true) — Heuristic to normalize mixed tabs/spaces to the dominant style.

• Shortcuts & automation

  • vitte.quickActions.defaults — Override built-in Quick Actions (build/run/bench/diagnostics) with custom labels, commands, arguments, or multi-step actions.
  • vitte.commandShortcuts — Array of objects describing the status-bar buttons and startup toast entries (label, command, icon, tooltip, statusBar, startup).
  • vitte.quickActions.sequences — Array of custom Quick Actions sequences (each entry supplies a label, optional description, and ordered list of commands).

Example (User or Workspace settings):

{
  "vitte.formatting": {
    "tabSize": 4,
    "insertSpaces": true,
    "trimTrailingWhitespace": true,
    "insertFinalNewline": true,
    "eol": "lf",
    "detectMixedIndentation": true
  }
}

Tips:

• Use “Vitte: Format Document” or the standard “Format Document” command; both call the same LSP formatter.
• You can also format a selection via “Format Selection”.

---

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.
• Metrics view (Vitte ▸ Vitte Metrics) polls the server’s vitte/metrics endpoint and lists average/last/max timings per handler with a toolbar refresh button.

---

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

• Getting Started
• Examples: examples/
• Issue tracker: https://github.com/roussov/vittelang-vscode/issues

---

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.