feat: Basic IR codegen (#11)

* feat(codegen): add LLVM IR generation and JIT execution support

* feat(codegen): enhance LLVM IR generation with type system and JIT execution

* feat(codegen): implement bitwise operations and loop constructs

* feat(codegen): add variable type tracking for proper type-aware loads

* feat(codegen): add comprehensive test suite and module declarations

Add comprehensive_test.rs and test.rs files with extensive test coverage.
Declare test modules in codegen.rs to organize test structure.

* feat(codegen): add modulo operator and type conversion support

Add modulo operator implementation for both integer and floating-point types. Support mixed int/float operations through automatic type conversion. Improve return type handling for boolean values.

* feat(codegen): add boolean-to-float conversion for arithmetic operations

* style: format code

* refactor: Improve IR generation error handling and code structure

This commit standardizes error handling in  by refactoring long, chained error maps into more readable blocks. It also removes internal test modules to simplify the build structure.

* **IR Generation:** Refactors complex LLVM builder calls and conversions (like float/int/bool promotions, bitwise operations) to use dedicated code blocks, improving readability and maintainability of error messages.

* **Code Structure:** Removes  and  modules from , aligning with the typical Rust practice of placing tests directly within the module being tested or in a dedicated  directory.

* **Minor Cleanup:** Removes unused  variable assignment in .

* refactor(tests): extract common test helpers to shared module

* refactor(parser): rename parse_program to parse_gml and mark visitors as WIP

* refactor(codegen): modularize IR generator implementation

* feat(codegen): add terminator-aware control flow handling

Add early termination checks in statement processing to skip remaining statements when a block already has a terminator. Improve control flow handling in if statements and blocks by checking for existing terminators before adding branches.

* refactor(codegen): reorganize module structure and enhance type mapping

* chore(ci): delete rust beta

* chore(ci): add LLVM 18 installation to CI workflow

* chore(ci): switch test to beta channel

* test: update codegen test to use std::f64::consts::TAU

* chore(ci): add LLVM 18 installation to GitHub workflows

* chore(ci): add libpolly-18-dev to LLVM dependencies

* Fix(CI): Allow LLVM v18 downgrade on Windows build

The 'windows-latest' runner pre-installs a newer LLVM version (e.g., v20), causing the 'choco install llvm --version=18.1.8' step to fail.
Added '--allow-downgrade' to the Chocolatey command to force the installation of the required LLVM v18.1.8.

* ci: set explicit clang path for macos build

* feat: Implement macOS Universal 2 Binary build in CI

Author: Bli-AIk

.github/workflows/ci.yml

@@ -22,24 +22,32 @@ jobs:
           - nightly
     steps:
     - uses: actions/checkout@v5
+
+    - name: Install LLVM 18
+      run: |
+        wget https://apt.llvm.org/llvm.sh
+        chmod +x llvm.sh
+        sudo ./llvm.sh 18
+        sudo apt-get install -y llvm-18-dev libclang-18-dev libpolly-18-dev
+        echo "LLVM_SYS_180_PREFIX=/usr/lib/llvm-18" >> $GITHUB_ENV
     
     - name: Install Rust
       uses: dtolnay/rust-toolchain@master
       with:
         toolchain: ${{ matrix.rust }}
-        
+
     - name: Cache cargo registry
       uses: actions/cache@v4
       with:
         path: ~/.cargo/registry
         key: ${{ runner.os }}-cargo-registry-${{ hashFiles('**/Cargo.lock') }}
-        
+
     - name: Cache cargo index
       uses: actions/cache@v4
       with:
         path: ~/.cargo/git
         key: ${{ runner.os }}-cargo-index-${{ hashFiles('**/Cargo.lock') }}
-        
+
     - name: Cache cargo build
       uses: actions/cache@v4
       with:
@@ -49,18 +57,19 @@ jobs:
     - name: Check formatting
       run: cargo fmt --all -- --check
       if: matrix.rust == 'stable'
-      
+
     - name: Run clippy
       run: cargo clippy --all-targets --all-features
-      # -- -D warnings
       if: matrix.rust == 'stable'
-      
+
     - name: Build
       run: cargo build --verbose
-      
+
     - name: Run tests
       run: cargo test --verbose
 
+---
+
   build:
     name: Build
     needs: test
@@ -79,50 +88,90 @@ jobs:
             asset_name: col-windows-x86_64.exe
           - os: macos-latest
             target: x86_64-apple-darwin
+            arm_target: aarch64-apple-darwin
             artifact_name: col
-            asset_name: col-macos-x86_64
+            asset_name: col-macos-universal
 
     steps:
     - uses: actions/checkout@v5
+
+    - name: Install LLVM 18 (Ubuntu)
+      if: matrix.os == 'ubuntu-latest'
+      run: |
+        wget https://apt.llvm.org/llvm.sh
+        chmod +x llvm.sh
+        sudo ./llvm.sh 18
+        sudo apt-get install -y llvm-18-dev libclang-18-dev libpolly-18-dev
+        echo "LLVM_SYS_180_PREFIX=/usr/lib/llvm-18" >> $GITHUB_ENV
+    
+    - name: Install LLVM 18 & Rust Targets (macOS)
+      if: matrix.os == 'macos-latest'
+      run: |
+        brew install llvm@18
+        LLVM_PATH=$(brew --prefix llvm@18)
+        echo "LLVM_SYS_180_PREFIX=$LLVM_PATH" >> $GITHUB_ENV
+        rustup target add x86_64-apple-darwin aarch64-apple-darwin
+        echo "CC=$LLVM_PATH/bin/clang" >> $GITHUB_ENV
+        echo "CXX=$LLVM_PATH/bin/clang++" >> $GITHUB_ENV
+
+    - name: Install LLVM 18 (Windows)
+      if: matrix.os == 'windows-latest'
+      run: |
+        choco install llvm --version=18.1.8 --allow-downgrade
+        echo "LLVM_SYS_180_PREFIX=C:\Program Files\LLVM" >> $env:GITHUB_ENV
     
     - name: Install Rust
       uses: dtolnay/rust-toolchain@stable
       with:
-        targets: ${{ matrix.target }}
-        
+        targets: ${{ matrix.os != 'macos-latest' && matrix.target || '' }}
+
     - name: Cache cargo registry
       uses: actions/cache@v4
       with:
         path: ~/.cargo/registry
         key: ${{ runner.os }}-cargo-registry-${{ hashFiles('**/Cargo.lock') }}
-        
+
     - name: Cache cargo index
       uses: actions/cache@v4
       with:
         path: ~/.cargo/git
         key: ${{ runner.os }}-cargo-index-${{ hashFiles('**/Cargo.lock') }}
-        
+
     - name: Cache cargo build
       uses: actions/cache@v4
       with:
         path: target
         key: ${{ runner.os }}-cargo-build-target-${{ hashFiles('**/Cargo.lock') }}
 
-    - name: Build release
+    - name: Build release (Linux/Windows)
+      if: matrix.os != 'macos-latest'
       run: cargo build --release --target ${{ matrix.target }}
-      
+
+    - name: Build and Combine (macOS Universal Binary)
+      if: matrix.os == 'macos-latest'
+      run: |
+        cargo build --release --target ${{ matrix.target }}
+        cargo build --release --target ${{ matrix.arm_target }}
+        lipo -create \
+             target/${{ matrix.target }}/release/${{ matrix.artifact_name }} \
+             target/${{ matrix.arm_target }}/release/${{ matrix.artifact_name }} \
+             -output target/release/${{ matrix.asset_name }}
+        echo "FINAL_ARTIFACT_PATH=target/release/${{ matrix.asset_name }}" >> $GITHUB_ENV
+        echo "FINAL_ARTIFACT_NAME=${{ matrix.asset_name }}" >> $GITHUB_ENV
+    
     - name: Upload artifact
       uses: actions/upload-artifact@v4
       with:
-        name: ${{ matrix.asset_name }}
-        path: target/${{ matrix.target }}/release/${{ matrix.artifact_name }}
+        name: ${{ env.FINAL_ARTIFACT_NAME || matrix.asset_name }}
+        path: ${{ env.FINAL_ARTIFACT_PATH || format('target/{0}/release/{1}', matrix.target, matrix.artifact_name) }}
+
+---
 
   security:
     name: Security Audit
     runs-on: ubuntu-latest
     if: github.event.pull_request.draft == false
     steps:
-    - uses: actions/checkout@v5
     - uses: rustsec/audit-check@v1.4.1
       with:
-        token: ${{ secrets.GITHUB_TOKEN }}
+        token: ${{ secrets.GITHUB_TOKEN }}

.github/workflows/coverage.yml

@@ -17,6 +17,14 @@ jobs:
     steps:
     - uses: actions/checkout@v5
 
+    - name: Install LLVM 18
+      run: |
+        wget https://apt.llvm.org/llvm.sh
+        chmod +x llvm.sh
+        sudo ./llvm.sh 18
+        sudo apt-get install -y llvm-18-dev libclang-18-dev libpolly-18-dev
+        echo "LLVM_SYS_180_PREFIX=/usr/lib/llvm-18" >> $GITHUB_ENV
+    
     - name: Install Rust
       uses: dtolnay/rust-toolchain@stable
       with:

.github/workflows/release.yml

@@ -68,6 +68,28 @@ jobs:
     steps:
     - uses: actions/checkout@v5
 
+    - name: Install LLVM 18 (Ubuntu)
+      if: matrix.os == 'ubuntu-latest'
+      run: |
+        wget https://apt.llvm.org/llvm.sh
+        chmod +x llvm.sh
+        sudo ./llvm.sh 18
+        sudo apt-get install -y llvm-18-dev libclang-18-dev libpolly-18-dev
+        echo "LLVM_SYS_180_PREFIX=/usr/lib/llvm-18" >> $GITHUB_ENV
+    
+    - name: Install LLVM 18 (macOS)
+      if: matrix.os == 'macos-latest'
+      run: |
+        brew install llvm@18
+        echo "/opt/homebrew/opt/llvm@18/bin" >> $GITHUB_PATH
+        echo "LLVM_SYS_180_PREFIX=/opt/homebrew/opt/llvm@18" >> $GITHUB_ENV
+    
+    - name: Install LLVM 18 (Windows)
+      if: matrix.os == 'windows-latest'
+      run: |
+        choco install llvm --version=18.1.8
+        echo "LLVM_SYS_180_PREFIX=C:\Program Files\LLVM" >> $env:GITHUB_ENV
+    
     - name: Install Rust
       uses: dtolnay/rust-toolchain@stable
       with:
@@ -110,6 +132,14 @@ jobs:
     steps:
     - uses: actions/checkout@v5
 
+    - name: Install LLVM 18
+      run: |
+        wget https://apt.llvm.org/llvm.sh
+        chmod +x llvm.sh
+        sudo ./llvm.sh 18
+        sudo apt-get install -y llvm-18-dev libclang-18-dev libpolly-18-dev
+        echo "LLVM_SYS_180_PREFIX=/usr/lib/llvm-18" >> $GITHUB_ENV
+    
     - name: Install Rust
       uses: dtolnay/rust-toolchain@stable
 

.github/workflows/update-deps.yml

@@ -15,6 +15,14 @@ jobs:
       with:
         token: ${{ secrets.GITHUB_TOKEN }}
 
+    - name: Install LLVM 18
+      run: |
+        wget https://apt.llvm.org/llvm.sh
+        chmod +x llvm.sh
+        sudo ./llvm.sh 18
+        sudo apt-get install -y llvm-18-dev libclang-18-dev libpolly-18-dev
+        echo "LLVM_SYS_180_PREFIX=/usr/lib/llvm-18" >> $GITHUB_ENV
+        
     - name: Install Rust
       uses: dtolnay/rust-toolchain@stable
 

Cargo.lock

@@ -8,3 +8,5 @@ ariadne = "0.5.1"
 chumsky = "0.11.1"
 logos = "0.15.1"
 owo-colors = "4.2.3"
+
+inkwell = { version = "0.6.0", features = ["llvm18-1"] }