Repository navigation
Releases
HLSL-LSP v0.17.0
Native Windows FXC / D3DCompiler backend
- Adds an opt-in native FXC backend for legacy Shader Model 4/5 projects in Visual Studio and VS Code.
- Select the compiler and an optional production-matched D3DCompiler DLL per project, file group, or shader variant.
- Uses native FXC compilation, errors and warnings, preprocessing, disassembly, and reflection, including unsaved include buffers.
- Reports unsupported capabilities explicitly instead of silently compiling with DXC or inventing reflected metadata.
- DXC remains the default. FXC requires Windows; shared source-symbol features still use the DXC source index.
- See the FXC configuration and capability guide.
Visual Studio reliability
- Fixes custom shader-extension settings, document synchronization, classification, and navigation integration.
- Applies native settings atomically and preserves the previous settings if a read fails.
- Serializes runtime restarts and startup, awaits host shutdown before replacing the transport, and prevents overlapping owned server processes.
- Preserves the existing connection after failed shutdown and keeps newer language-version changes made during a restart.
Runtime diagnostics and background analysis
- Deduplicates DXC runtime conflicts using the complete normalized runtime selection, including equivalent paths with trailing separators.
- Adds document/configuration provenance and process/session correlation to runtime troubleshooting logs, with existing protocol-trace redaction.
- Returns ordinary document activity to quiet logging after a conflict is resolved.
- Fixes a scheduler lost-wakeup race that could leave analysis waits blocked indefinitely.
Downloads
- Visual Studio:
HlslLsp.VisualStudio.vsix - Visual Studio Code:
hlsl-lsp-vscode.vsix, including Windows x64 and Linux x64 runtimes - Standalone Linux x64:
HLSL-LSP-linux-x64.tar.gz
All components use version 0.17.0. Linux requires glibc 2.38 or newer; the FXC backend is Windows-only.
Full changelog: v0.16.0...v0.17.0
HLSL-LSP v0.16.0
Shader compiler statistics
- Adds a summary-first compiler statistics section in Visual Studio and VS Code.
- Shows DXC reflection counters for instructions, temporary storage, texture operations, flow control, barriers, and atomics.
- Counters describe the compiled shader; they do not estimate GPU execution time or hardware occupancy.
Guided shader configuration
- Adds guided creation and editing of
shadertoolsconfig.jsonin both editors. - Supports reviewing shader entry points, profiles, defines, and named variants before validating, applying, and saving a draft.
- Adds a screenshot-based configuration-authoring tutorial with checked-in example shaders and Natural/Warm variants.
Opt-in runtime compilation capture
- Adds authenticated, local metadata capture from applications instrumented with the capture SDK.
- Supports reviewing captured compilation settings and turning them into configuration drafts and named variants.
- Capture is explicitly started and stopped by the user; it is not automatic interception of application compiler calls.
- Adds a screenshot-based runtime-capture tutorial and a metadata-reporting example.
- Fixes VS Code capture previews when Windows file URIs differ only in drive-letter case.
DXC runtime and Linux reliability
- Updates the checksum-verified Windows and Linux packages to DXC
2609-kstocky.3. - Verifies the fix for the Linux
GetSkippedRangescrash on virtual unsaved files and restores rewritten-source skipped-region and entry-point data-flow analysis for the known-safe runtime. - Retains the safe fallback for older, unidentified, or unverified Linux runtimes.
- Includes a standalone reproducer and compatibility documentation.
The release includes the Visual Studio VSIX, the VS Code VSIX with Windows x64 and Linux x64 runtimes, and a standalone Linux x64 archive. All components use version 0.16.0. Linux requires glibc 2.38 or newer.
Full changelog: v0.15.0...v0.16.0
HLSL-LSP v0.15.0
Context-aware editor workflows
- Adds effective shader-context visibility and pinned/following analysis modes with explicit freshness states.
- Adds compiler-backed macro expansion and richer contextual HLSL commands across Visual Studio and Visual Studio Code.
- Improves analysis-view information hierarchy while preserving filters, expanded sections, inputs, and last-good results across refreshes.
Setup, status, and recovery
- Adds actionable configuration guidance, lightweight first-run help, and competing-extension detection.
- Adds compact cross-editor server, DXC runtime, configuration, and analysis health surfaces with adjacent recovery actions.
Cross-platform DXC runtime
- Adopts the fixed KStocky DXC IntelliSense runtime for Windows and Linux release packages.
- Restores Linux runtime proof and packages the compatible compiler with both editor distributions.
Cross-stage pipeline validation
- Adds versioned named graphics-pipeline configuration with active or explicitly selected variants.
- Validates compiler-reflected stage interfaces and shared resources across unsaved, same-file, closed-file, and watched-file stages.
- Publishes actionable producer/consumer diagnostics while explicitly reporting unavailable hull/domain patch-signature validation.
Reliability
- Fixes valid token-pasting IntelliSense diagnostics and strengthens stale-result, cancellation, configuration-refresh, and worker-failure behavior.
This release includes the Windows and Linux server runtimes, Visual Studio VSIX, and Visual Studio Code VSIX at version 0.15.0.
HLSL-LSP v0.14.1
Visual Studio theme compatibility
- Fixed black/default WPF text rendering on dark Visual Studio tool-window backgrounds.
- Made all seven custom HLSL panes follow Visual Studio's dynamic foreground, background, hyperlink, scrollbar, control, and environment-font resources.
- Themed the shader-variant picker and corrected default foreground inheritance in Resource Bindings and Compute Visualization.
- Refreshed the affected README screenshots and configuration-refresh animation with the corrected dark-theme UI.
This patch includes the server, Visual Studio VSIX, and Visual Studio Code VSIX at version 0.14.1.
HLSL-LSP v0.14.0
Visual Studio contextual workflows
- Adds an HLSL editor context submenu for shader variants, memory layouts, shader compilation, call hierarchy, and entry-point data flow.
- Filters shader variants to the current file and, when invoked on an entry point, to that entry point.
- Keeps document-independent explorers under Tools while preventing HLSL commands from targeting configuration documents.
Live configuration refresh
- Applies created, changed, and deleted shadertoolsconfig.json files without reopening shaders or restarting Visual Studio.
- Refreshes open compilation, resource-binding, preprocessor, data-flow, compute, call-hierarchy, and navigation views after ordered server reanalysis.
- Suppresses duplicate Visual Studio save/watch events and preserves reliable completion ordering during cancellation, root closure, and shutdown.
Release artifacts are built and attached by the release workflow.
HLSL-LSP v0.13.1
Fix
- Ensures an explicit LSP $/cancelRequest takes precedence over a handler or lifecycle error produced concurrently.
- Removes the cancellation race exposed by the v0.13.0 tag validation workflow.
Included from v0.13.0
- Visual Studio 2022 17.14+ support for 64-bit Community, Professional, and Enterprise.
- Killable DXC analysis-worker isolation and bounded analysis deadlines.
Release artifacts are built and attached by the release workflow.
HLSL-LSP v0.13.0
Highlights
- Adds support for 64-bit Visual Studio 2022 17.14+ Community, Professional, and Enterprise while retaining Visual Studio 2026 support.
- Isolates all DXC translation units and compiler queries in killable worker processes, preventing pathological shaders or native DXC crashes from wedging the language server.
- Adds bounded background and interactive analysis deadlines, stale-safe unavailable diagnostics, worker recovery, and deterministic stress coverage.
- Packages the analysis worker with the native runtime, Visual Studio VSIX, and Visual Studio Code VSIX.
Compatibility
- Visual Studio 2022 17.14+ and Visual Studio 2026
- Visual Studio Code 1.96+
- Windows x64 and Linux x64 language-server runtimes
Release artifacts are built and attached by the release workflow.
HLSL-LSP v0.12.0
Highlights
- Added compiler-backed incoming and outgoing call hierarchy with stable overload and root-context identity.
- Added entry-point data-flow analysis for reachable and recursive functions, global/resource reads and writes, unreachable functions, and unused declarations.
- Added navigable call hierarchy and entry-point data-flow experiences to Visual Studio and Visual Studio Code.
- Added bounded configured macro include expansion for
hlsl.preprocessorDefinitions, including alias chains, quoted and angle headers, virtual mappings, variants, editor overrides, dependency invalidation, and Preprocessor Explorer provenance.
Reliability
- Call and data-flow analysis is bounded, cancellable, generation-aware, and conservative around incomplete compiler information.
- Configured include expansion defers to DXC for source-defined, conditional, malformed, cyclic, context-dependent, or later compiler-argument-overridden macros.
- Linux safely reports skipped-region analysis as unavailable for rewritten virtual include buffers affected by a DXC 1.9
GetSkippedRangescrash, while retaining include resolution, macros, diagnostics, and configuration details.
Documentation
- Added call hierarchy and entry-point data-flow protocol/editor documentation.
- Documented configured macro include JSON escaping, resolution boundaries, provenance, and the Linux skipped-region limitation.
HLSL-LSP v0.11.1
Fixes
- Visual Studio now highlights all valid built-in HLSL matrix aliases, including non-square forms such as
float3x4. - Cbuffer array layout no longer lets final-element stride padding overlap or obscure a following member.
- Visual Studio and Visual Studio Code memory-layout diagrams now show absolute 4-byte labels and visible 2-byte guides, making native 16-bit values easier to read.
This is a patch release over v0.11.0.
HLSL-LSP v0.11.0
Highlights
- Added compiler-verified code actions and deterministic variant-based include recovery.
- Added the cross-editor Include/Preprocessor Explorer with include, macro, skipped-region, virtual-mapping, and configuration provenance.
- Added bounded compiler-generated DXIL disassembly to Shader Compilation, with secure Copy and Save actions in both editors.
- Corrected expanded memory-layout names and byte-accurate internal, inter-member, and trailing padding visualization.
- Fixed Visual Studio Tools command packaging so HLSL commands appear reliably.
Compatibility notes
- DXIL disassembly is generated by DXC. The pinned DXC runtime rejects SPIR-V binaries in its disassembler, so SPIR-V output reports that limitation explicitly rather than fabricating text.
- Visual Studio and Visual Studio Code packages remain aligned with server protocol version 0.11.0.
Full Changelog: v0.10.0...v0.11.0