Language Server and VS Code Extension

.github/workflows/ci.yml

@@ -9,22 +9,98 @@ permissions:
 
 jobs:
   build-and-test:
-    name: ${{ matrix.os }} build and test
+    name: ${{ matrix.target }} build, test, and package
     runs-on: ${{ matrix.os }}
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest, windows-latest, macos-latest]
+        include:
+          - os: ubuntu-latest
+            target: linux-x64
+            cmake_arguments: ''
+          - os: windows-latest
+            target: win32-x64
+            cmake_arguments: -A x64
+          - os: macos-15-intel
+            target: darwin-x64
+            cmake_arguments: ''
 
     steps:
       - name: Check out repository
         uses: actions/checkout@v7
 
+      - name: Set up Python for process smoke tests
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.12'
+
+      - name: Set up Node for VS Code client tests
+        uses: actions/setup-node@v5
+        with:
+          node-version: 22
+
       - name: Configure
-        run: cmake -S . -B build -DBUILD_TESTING=ON -DCMAKE_BUILD_TYPE=Release
+        run: >-
+          cmake -S . -B build
+          -DBUILD_TESTING=ON
+          -DCMAKE_BUILD_TYPE=Release
+          ${{ matrix.cmake_arguments }}
 
       - name: Build
         run: cmake --build build --config Release --parallel
 
       - name: Test
-        run: ctest --test-dir build --build-config Release --output-on-failure
+        run: ctest --test-dir build --build-config Release --output-on-failure
+
+      - name: Install VS Code client dependencies
+        working-directory: editors/vscode
+        run: npm ci
+
+      - name: Test VS Code language client on Linux
+        if: runner.os == 'Linux'
+        working-directory: editors/vscode
+        run: xvfb-run -a npm test
+
+      - name: Test VS Code language client
+        if: runner.os != 'Linux'
+        working-directory: editors/vscode
+        run: npm test
+
+      - name: Package targeted VSIX
+        working-directory: editors/vscode
+        env:
+          RLS_VSCODE_RELEASE_BUILD_DIRECTORY: build
+        run: npx --no-install vsce package --target ${{ matrix.target }} --out rando-logic-script-${{ matrix.target }}.vsix
+
+      - name: Validate targeted VSIX
+        working-directory: editors/vscode
+        run: npm run validate:vsix -- rando-logic-script-${{ matrix.target }}.vsix ${{ matrix.target }}
+
+      - name: Store validated VSIX
+        uses: actions/upload-artifact@v7
+        with:
+          name: rando-logic-script-${{ matrix.target }}
+          path: editors/vscode/rando-logic-script-${{ matrix.target }}.vsix
+          if-no-files-found: error
+          retention-days: 7
+
+  editor-grammar-tests:
+    name: Editor grammar tests
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v7
+
+      - name: Set up Node
+        uses: actions/setup-node@v5
+        with:
+          node-version: 22
+
+      - name: Test TextMate grammar
+        working-directory: tooling/textmate
+        run: npm ci && npm test
+
+      - name: Generate and test Tree-sitter grammar
+        working-directory: tooling/tree-sitter-rls
+        run: npm ci && npm run generate && npm test

.github/workflows/release.yml

@@ -0,0 +1,166 @@
+name: Release VS Code extension
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+permissions:
+  contents: read
+
+jobs:
+  package:
+    name: Package ${{ matrix.target }}
+    runs-on: ${{ matrix.os }}
+    permissions:
+      contents: read
+      id-token: write
+      attestations: write
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            target: linux-x64
+            cmake_arguments: ''
+            server: build-vscode-release/lsp/rls_language_server
+          - os: windows-latest
+            target: win32-x64
+            cmake_arguments: -A x64
+            server: build-vscode-release/lsp/Release/rls_language_server.exe
+          - os: macos-15-intel
+            target: darwin-x64
+            cmake_arguments: ''
+            server: build-vscode-release/lsp/rls_language_server
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v7
+
+      - name: Set up Python for process smoke test
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.12'
+
+      - name: Set up Node for VSIX packaging
+        uses: actions/setup-node@v5
+        with:
+          node-version: 22
+
+      - name: Verify tag matches extension version
+        run: node -e "const actual=require('./editors/vscode/package.json').version; const tag=process.env.GITHUB_REF_NAME; if (tag !== 'v' + actual) throw new Error('Tag ' + tag + ' does not match extension v' + actual);"
+
+      - name: Configure release server
+        run: >-
+          cmake -S . -B build-vscode-release
+          -DCMAKE_BUILD_TYPE=Release
+          -DBUILD_TESTING=OFF
+          -DRLS_STATIC_MSVC_RUNTIME=ON
+          ${{ matrix.cmake_arguments }}
+
+      - name: Build release server
+        run: cmake --build build-vscode-release --config Release --target rls_language_server --parallel
+
+      - name: Smoke test release server
+        run: python lsp/tests/process_smoke.py --server "${{ matrix.server }}"
+
+      - name: Install extension dependencies
+        working-directory: editors/vscode
+        run: npm ci
+
+      - name: Package targeted VSIX
+        working-directory: editors/vscode
+        env:
+          RLS_VSCODE_RELEASE_BUILD_DIRECTORY: build-vscode-release
+        run: npx --no-install vsce package --target ${{ matrix.target }} --out rando-logic-script-${{ github.ref_name }}-${{ matrix.target }}.vsix
+
+      - name: Validate targeted VSIX
+        working-directory: editors/vscode
+        run: npm run validate:vsix -- rando-logic-script-${{ github.ref_name }}-${{ matrix.target }}.vsix ${{ matrix.target }}
+
+      - name: Attest VSIX build provenance
+        uses: actions/attest@v4
+        with:
+          subject-path: editors/vscode/rando-logic-script-${{ github.ref_name }}-${{ matrix.target }}.vsix
+
+      - name: Store targeted VSIX
+        uses: actions/upload-artifact@v7
+        with:
+          name: rando-logic-script-${{ matrix.target }}
+          path: editors/vscode/rando-logic-script-${{ github.ref_name }}-${{ matrix.target }}.vsix
+          if-no-files-found: error
+          retention-days: 7
+
+  release:
+    name: Create GitHub release
+    needs: package
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Download validated VSIX files
+        uses: actions/download-artifact@v8
+        with:
+          pattern: rando-logic-script-*
+          path: artifacts
+          merge-multiple: true
+
+      - name: Verify release artifact set
+        shell: bash
+        run: |
+          mapfile -t artifacts < <(find artifacts -maxdepth 1 -name '*.vsix' -type f | sort)
+          test "${#artifacts[@]}" -eq 3
+          printf '%s\n' "${artifacts[@]}"
+
+      - name: Create GitHub release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          GH_REPO: ${{ github.repository }}
+        run: gh release create "$GITHUB_REF_NAME" artifacts/*.vsix --verify-tag --generate-notes --title "Rando Logic Script $GITHUB_REF_NAME"
+
+  publish-marketplace:
+    name: Publish to Visual Studio Marketplace
+    needs: release
+    runs-on: ubuntu-latest
+    environment: marketplace-production
+    permissions:
+      contents: read
+      id-token: write
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v7
+
+      - name: Set up Node
+        uses: actions/setup-node@v5
+        with:
+          node-version: 22
+
+      - name: Install extension dependencies
+        working-directory: editors/vscode
+        run: npm ci
+
+      - name: Download validated VSIX files
+        uses: actions/download-artifact@v8
+        with:
+          pattern: rando-logic-script-*
+          path: artifacts
+          merge-multiple: true
+
+      - name: Sign in to Azure with GitHub OIDC
+        uses: azure/login@v3
+        with:
+          client-id: ${{ secrets.AZURE_CLIENT_ID }}
+          tenant-id: ${{ secrets.AZURE_TENANT_ID }}
+          subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}
+
+      - name: Publish validated VSIX files
+        working-directory: editors/vscode
+        shell: bash
+        run: |
+          mapfile -t packages < <(find ../../artifacts -maxdepth 1 -name '*.vsix' -type f | sort)
+          test "${#packages[@]}" -eq 3
+          for package in "${packages[@]}"; do
+            npx --no-install vsce publish --azure-credential --packagePath "$package"
+          done

.gitignore

@@ -13,6 +13,7 @@
 
 # Linker files
 *.ilk
+*.exp
 
 # Debugger Files
 *.pdb
@@ -68,3 +69,11 @@ vcpkg_installed/
 Testing/
 .cache/
 /.vs
+
+# VS Code extension build and test output
+editors/vscode/node_modules/
+editors/vscode/out/
+editors/vscode/dist/
+editors/vscode/.vscode-test/
+editors/vscode/server/
+editors/vscode/*.vsix

.vscode/launch.json

@@ -0,0 +1,17 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Run RLS Language Extension",
+      "type": "extensionHost",
+      "request": "launch",
+      "preLaunchTask": "Prepare RLS Language Extension",
+      "args": [
+        "--extensionDevelopmentPath=${workspaceFolder}/editors/vscode"
+      ],
+      "outFiles": [
+        "${workspaceFolder}/editors/vscode/out/**/*.js"
+      ]
+    }
+  ]
+}

.vscode/tasks.json

@@ -0,0 +1,52 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Bundle RLS Language Server",
+      "type": "shell",
+      "command": "npm",
+      "args": [
+        "run",
+        "bundle:lsp"
+      ],
+      "options": {
+        "cwd": "${workspaceFolder}/editors/vscode"
+      }
+    },
+    {
+      "label": "Package RLS VS Code Extension",
+      "type": "shell",
+      "command": "vsce",
+      "args": [
+        "package"
+      ],
+      "options": {
+        "cwd": "${workspaceFolder}/editors/vscode"
+      },
+      "problemMatcher": [
+        "$msCompile"
+      ]
+    },
+    {
+      "label": "Compile RLS VS Code Extension",
+      "type": "shell",
+      "command": "npm",
+      "args": [
+        "run",
+        "compile"
+      ],
+      "options": {
+        "cwd": "${workspaceFolder}/editors/vscode"
+      },
+      "problemMatcher": "$tsc"
+    },
+    {
+      "label": "Prepare RLS Language Extension",
+      "dependsOrder": "sequence",
+      "dependsOn": [
+        "Bundle RLS Language Server",
+        "Compile RLS VS Code Extension"
+      ]
+    }
+  ]
+}