feat: jetbrains extension, syntax highlighting and release automation only (#1983)

Implement jetbrains extension and set up jetbrains release automation.

The only thing implemented in the jetbrains extension right now is
syntax highlighting. We still need to:

- fix icons
- add the webview (via JCEF)
- add codelenses (not sure what the Jetbrains equivalent is)
- wire up the LSP (via lsp4ij from redhat)
- set up LSP downloading (and platform-specific logic)
- LSP packaging and release process there

But this lets us start iterating on it asap in prod.

Author: sxlijin

.github/workflows/build-jetbrains-release.reusable.yaml

@@ -0,0 +1,181 @@
+# GitHub Actions Workflow is created for testing and preparing the plugin release in the following steps:
+# - Validate Gradle Wrapper.
+# - Run 'test' and 'verifyPlugin' tasks.
+# - Run Qodana inspections.
+# - Run the 'buildPlugin' task and prepare artifact for further tests.
+# - Run the 'runPluginVerifier' task.
+# - Create a draft release.
+#
+# The workflow is triggered on push and pull_request events.
+#
+# GitHub Actions reference: https://help.github.com/en/actions
+
+name: BAML Release - Build JetBrains
+on:
+  workflow_call: {}
+  push:
+    branches:
+      - sam/jetbrains
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}-build-jetbrains
+  cancel-in-progress: true
+  
+defaults:
+  run:
+    working-directory: ./jetbrains
+
+jobs:
+  # Prepare environment and build the plugin
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.properties.outputs.version }}
+      changelog: ${{ steps.properties.outputs.changelog }}
+      pluginVerifierHomeDir: ${{ steps.properties.outputs.pluginVerifierHomeDir }}
+    steps:
+
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: 23
+
+      - uses: gradle/actions/setup-gradle@v4
+
+      # Set environment variables
+      - name: Export Properties
+        id: properties
+        shell: bash
+        run: |
+          PROPERTIES="$(./gradlew properties --console=plain -q)"
+          VERSION="$(echo "$PROPERTIES" | grep "^version:" | cut -f2- -d ' ')"
+          CHANGELOG="$(./gradlew getChangelog --unreleased --no-header --console=plain -q)"
+
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "pluginVerifierHomeDir=~/.pluginVerifier" >> $GITHUB_OUTPUT
+          
+          echo "changelog<<EOF" >> $GITHUB_OUTPUT
+          echo "$CHANGELOG" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
+      # Build plugin
+      - name: Build plugin
+        run: ./gradlew buildPlugin
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: baml-jetbrains-zip
+          path: ./jetbrains/build/distributions/*
+
+  # # Run tests and upload a code coverage report
+  # test:
+  #   name: Test
+  #   needs: [ build ]
+  #   runs-on: ubuntu-latest
+  #   steps:
+
+  #     # Check out the current repository
+  #     - name: Fetch Sources
+  #       uses: actions/checkout@v4
+
+  #     # Set up Java environment for the next steps
+  #     - name: Setup Java
+  #       uses: actions/setup-java@v4
+  #       with:
+  #         distribution: zulu
+  #         java-version: 21
+
+  #     # Setup Gradle
+  #     - name: Setup Gradle
+  #       uses: gradle/actions/setup-gradle@v4
+
+  #     # Run tests
+  #     - name: Run Tests
+  #       run: ./gradlew check
+
+  #     # Collect Tests Result of failed tests
+  #     - name: Collect Tests Result
+  #       if: ${{ failure() }}
+  #       uses: actions/upload-artifact@v4
+  #       with:
+  #         name: tests-result
+  #         path: ./build/reports/tests
+
+  #     # Upload the Kover report to CodeCov
+  #     - name: Upload Code Coverage Report
+  #       uses: codecov/codecov-action@v5
+  #       with:
+  #         files: ./build/reports/kover/report.xml
+
+  # # Run Qodana inspections and provide report
+  # inspectCode:
+  #   name: Inspect code
+  #   needs: [ build ]
+  #   runs-on: ubuntu-latest
+  #   permissions:
+  #     contents: write
+  #     checks: write
+  #     pull-requests: write
+  #   steps:
+  #     # Check out the current repository
+  #     - uses: actions/checkout@v4
+  #       with:
+  #         ref: ${{ github.event.pull_request.head.sha }}  # to check out the actual pull request commit, not the merge commit
+  #         fetch-depth: 0  # a full history is required for pull request analysis
+
+  #     # Set up Java environment for the next steps
+  #     - uses: actions/setup-java@v4
+  #       with:
+  #         distribution: temurin
+  #         java-version: 23
+
+  #     # Run Qodana inspections
+  #     - name: Qodana - Code Inspection
+  #       uses: JetBrains/qodana-action@v2025.1
+  #       with:
+  #         cache-default-branch-only: true
+
+  # # Run plugin structure verification along with IntelliJ Plugin Verifier
+  # verify:
+  #   name: Verify plugin
+  #   needs: [ build ]
+  #   runs-on: ubuntu-latest
+  #   steps:
+  #     - uses: actions/checkout@v4
+
+  #     # Set up Java environment for the next steps
+  #     - name: Setup Java
+  #       uses: actions/setup-java@v4
+  #       with:
+  #         distribution: temurin
+  #         java-version: 23
+
+  #     # Setup Gradle
+  #     - name: Setup Gradle
+  #       uses: gradle/actions/setup-gradle@v4
+
+  #     # Cache Plugin Verifier IDEs
+  #     - name: Setup Plugin Verifier IDEs Cache
+  #       uses: actions/cache@v4
+  #       with:
+  #         path: ${{ needs.build.outputs.pluginVerifierHomeDir }}/ides
+  #         key: plugin-verifier-${{ hashFiles('build/listProductsReleases.txt') }}
+
+  #     # Run Verify Plugin task and IntelliJ Plugin Verifier tool
+  #     - name: Run Plugin Verification tasks
+  #       run: ./gradlew verifyPlugin -Dplugin.verifier.home.dir=${{ needs.build.outputs.pluginVerifierHomeDir }}
+
+  #     # Collect Plugin Verifier Result
+  #     - name: Collect Plugin Verifier Result
+  #       if: ${{ always() }}
+  #       uses: actions/upload-artifact@v4
+  #       with:
+  #         name: pluginVerifier-result
+  #         path: ./build/reports/pluginVerifier

.github/workflows/release.yml

@@ -86,6 +86,9 @@ jobs:
       version: ${{ needs.determine-version.outputs.version_string }}
       # Pass the boolean output directly
       is_release_build: ${{ needs.determine-version.outputs.is_release_tag == 'true' }}
+  
+  build-jetbrains-release:
+    uses: ./.github/workflows/build-jetbrains-release.reusable.yaml
 
   # Kick off integration tests when we build everything.
   # This does not yet succeed/pass consistently, or even run everything, but it's a good start.
@@ -103,6 +106,7 @@ jobs:
       - build-typescript-release
       - build-cli
       - build-vscode-reusable # Depends on the job calling the reusable workflow
+      - build-jetbrains-release
     steps:
       - run: echo "::do-nothing::" >/dev/null
 
@@ -288,6 +292,40 @@ jobs:
         env:
           VSCE_PAT: ${{ secrets.VSCODE_PAT }}
 
+  publish-to-jetbrains-marketplace:
+    environment: release
+    needs: [determine-version, all-builds] # Also need determine-version for the condition
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./jetbrains
+    steps:
+      # We need checkout, java, and gradle because there's no CLI for publishing
+      # to JetBrains Marketplace, just a gradle task in the project.
+      - uses: actions/checkout@v4
+      - uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: 23
+      - uses: gradle/actions/setup-gradle@v4
+
+      - name: Download extension zips
+        uses: actions/download-artifact@v4
+        with:
+          pattern: baml-jetbrains-zip-*
+          path: ./jetbrains/build/distributions/
+          merge-multiple: true
+
+      - name: List downloaded extension zips
+        run: ls -al ./jetbrains/build/distributions/
+
+      - name: Publish to JetBrains Marketplace
+        working-directory: ./jetbrains
+        run: ./gradlew publishPlugin
+        env:
+          INTELLIJ_PLATFORM_PUBLISH_TOKEN: ${{ secrets.SAM_INTELLIJ_PLATFORM_PUBLISH_TOKEN }}
+
+
   publish-to-github:
     environment: release
     permissions:

jetbrains/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,63 @@
+name: Bug report
+description: Create a report to help us improve
+labels: ["bug"]
+body:
+
+  - type: textarea
+    id: issue
+    attributes:
+      label: What happened?
+      description: A clear and concise description of what the bug is.
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant log output or stack trace
+      description: |
+        Please copy and paste any relevant log output.
+        Add the full stack trace if available.
+        If possible, run the failing task with `--stacktrace` flag.
+        
+        *This will be automatically formatted into code, so there is no need for backticks.*
+      render: shell
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: Steps to reproduce the behavior – provide your build configuration.
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: Gradle IntelliJ Plugin version
+      placeholder: 1.16.0
+    validations:
+      required: true
+
+  - type: input
+    id: gradle
+    attributes:
+      label: Gradle version
+      placeholder: 8.2.1
+    validations:
+      required: true
+
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      options:
+        - macOS
+        - Linux
+        - Windows
+
+  - type: input
+    id: url
+    attributes:
+      label: Link to build, i.e. failing GitHub Action job
+      placeholder: https://github.com/username/project/actions/runs/1234567890

jetbrains/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Documentation
+    url: https://github.com/JetBrains/intellij-platform-plugin-template
+    about: Check the README file in the first place.
+  - name: Getting Help
+    url: https://plugins.jetbrains.com/docs/intellij/getting-help.html
+    about: Check if you search for a help in plugin development.

jetbrains/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,32 @@
+name: Feature request
+description: Suggest an idea for this project
+labels: ["enhancement"]
+body:
+
+  - type: textarea
+    id: cause
+    attributes:
+      label: Describe the need of your request
+      description: A clear and concise description of what the need or problem is.
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: A clear and concise description of what you want to happen.
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives you've considered
+      description: What did you try so far to accomplish the goal?
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+      description: Add any other context or screenshots about the feature request here.

jetbrains/.github/dependabot.yml

@@ -0,0 +1,17 @@
+# Dependabot configuration:
+# https://docs.github.com/en/free-pro-team@latest/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  # Maintain dependencies for Gradle dependencies
+  - package-ecosystem: "gradle"
+    directory: "/"
+    target-branch: "next"
+    schedule:
+      interval: "daily"
+  # Maintain dependencies for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    target-branch: "next"
+    schedule:
+      interval: "daily"