Internals

Internals

Resources for those interested in the internal design of WESL.

Grammars

• lezer-wesl — Lezer grammar for WESL/WGSL, used by CodeMirror editors (including wgsl-edit).
• tree-sitter-wesl — Tree-sitter grammar for WESL/WGSL, used by Neovim, Emacs, Zed, and other editors.

Forthcoming Tools

• wgsl-analyzer — Language server for WESL providing go-to-definition, hover docs, and diagnostics across the module graph. Multi-editor support (VS Code, Emacs, Neovim).
• wesldoc — Documentation generator for web documentation from shader code.

Reference

• Glossary — Key terms and definitions

Design Documents

• Conditional Translation Design — Design rationale for structured @if vs unstructured #ifdef
• Visibility — Module visibility rules
• Name Mangling — How declarations are renamed in output WGSL
• Versioning — Edition versioning strategy
• Packaging — Package format design

Historical Discussions

• Import syntax discussion
• Community use of WGSL string interpolation
• Plugin design ideas
• Old generics discussion
• Packaging design