LFX Shader DSL Toolkit adds first-class editing, diagnostics, and preview tooling for .lfx files in Visual Studio Code.
It provides:
syntax highlighting for LFX effect and library modules
comment, bracket, auto-closing, folding, and indentation behavior
snippets for common LFX constructs
inline parse and semantic diagnostics by running the lfx checker
commands to validate files, inspect generated WGSL, and work with live preview tools
This extension is intended for authors working with the LFX language and toolchain. It focuses on fast feedback and solid authoring ergonomics without requiring a full language server.
Requirements
Install the lfx CLI and ensure it is available on your PATH, or set lfx.path to the executable location.
When developing inside the LFX source repository, the extension can fall back to go run ./cmd/lfx if no installed binary is found.
Features
Language registration for *.lfx
TextMate-based syntax highlighting
Comment and bracket handling from language-configuration.json
Snippets for effect modules, library modules, params, timeline, stdlib imports, and common return shapes
Inline diagnostics from lfx check --json
Commands:
LFX: Check Current File
LFX: Check Workspace
LFX: Show Generated WGSL
LFX: Open Module Graph
LFX: WebGPU Probe
LFX: Open Live Preview
LFX: Refresh Live Preview
Settings
lfx.path: path to the lfx executable. Default: "lfx".
lfx.check.onSave: run checks when saving .lfx files. Default: true.
lfx.check.onType: run checks while typing using a debounce. Default: false.
lfx.check.debounceMs: debounce delay in milliseconds for on-type checks. Default: 400.
lfx.moduleRoots: additional module roots passed through as repeated --module-root flags.
lfx.trace.diagnostics: log CLI tracing and diagnostics flow to the output channel.
lfx.preview.enableOnSave: refresh the live preview when saving the active .lfx file. Default: true.
lfx.preview.trackActiveEditor: retarget an open preview when switching active .lfx editors. Default: true.
lfx.preview.preferredLayout: default built-in layout used by the live preview panel.
lfx.preview.trace: log preview protocol and runtime tracing to the output channel. Default: false.
Notes
The extension uses regular VS Code extension APIs rather than an LSP.
Semantic tokens, completion, hovers, formatting, rename, and go-to-definition are intentionally out of scope for v1.
