v0.4.2-alpha VS Code Setup and Documentation Preview

This alpha release focuses on improving the first-run experience for VS Code users and cleaning up the extension internals. It introduces a setup doctor for modders, reorganizes the VS Code extension source into focused modules, and significantly improves the public documentation.

Highlights

• Added WitcherScript: Doctor Setup to the VS Code extension.
• Added a setup checklist for common installation and workspace issues.
• Added checks for workspace state, witcherscript.toml, uv, .NET SDK, language server environment, REDkit CLI, LSP status, configured Witcher 3 / REDkit paths, script roots, vanilla roots, and recompile executable settings.
• Improved first-run UX for modders using the .vsix package.
• Refactored the VS Code extension source into focused modules:
  • extension.ts
  • languageServer.ts
  • redkitCommands.ts
  • setupDoctor.ts
  • configuration.ts
  • paths.ts
  • statusBar.ts
  • process.ts
  • constants.ts
  • types.ts
• Reduced extension.ts to a thin activation and command-registration layer.
• Reworked README.md with clearer sections for modders, VS Code users, CLI users, and contributors.
• Reworked VS Code extension documentation with setup, commands, settings, troubleshooting, source layout, and packaging notes.
• Updated architecture documentation to describe the VS Code extension module layout.
• Improved version synchronization for prerelease versions such as 0.4.2-alpha.

Fixed

• .NET AssemblyVersion and FileVersion synchronization now use the numeric version portion for prerelease builds.
• Version metadata now supports prerelease labels without breaking .NET builds.

VS Code

The extension now includes a dedicated setup command:

WitcherScript: Doctor Setup

The command writes a setup report to the WitcherScript output panel and helps users identify missing tools, invalid paths, missing configuration, or language server startup issues.

Recommended first-run flow:

1. Install the .vsix.
2. Open your REDkit mod workspace.
3. Run WitcherScript: Doctor Setup.
4. Run WitcherScript: Initialize REDkit Config.
5. Open a .ws file.

Validation

The release has been verified with:

uv run ruff check .
uv run ruff format --check .
uv run mypy src/py
uv run pytest
dotnet test src/dotnet/WitcherScript.RedkitTooling.sln
npm --prefix src/vscode run smoke
npm --prefix src/vscode run package:vsix -- --out ../../dist/witcherscript-redkit-tools-0.4.2-alpha.vsix
uv run python scripts/sync_version.py --check
git diff --check

Current test result:

84 Python tests passed
11 .NET tests passed
VS Code extension lint/typecheck/compile passed
VSIX package builds successfully

Notes

This is an alpha release intended to validate the improved VS Code setup flow and the refactored extension structure before the next stable release.