feat: add conditional logic, CLI versioning, LLVM 21 integration, and CI release workflow

Author: VictorFrancelino

.github/workflows/release.yml

@@ -0,0 +1,78 @@
+name: Release SimpleScript
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  build:
+    name: Build for ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        include:
+          - os: ubuntu-latest
+            artifact_name: simplescript-linux
+            asset_name: simplescript-v0.5.0-linux-x86_64.tar.gz
+          - os: windows-latest
+            artifact_name: simplescript.exe
+            asset_name: simplescript-v0.5.0-windows-x86_64.zip
+          - os: macos-latest
+            artifact_name: simplescript
+            asset_name: simplescript-v0.5.0-macos-arm64.tar.gz
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Zig
+        uses: goto-bus-stop/setup-zig@v2
+        with:
+          version: 0.15.2
+
+      - name: Install LLVM 21 (Linux)
+        if: matrix.os == 'ubuntu-latest'
+        run: |
+          wget https://apt.llvm.org/llvm.sh
+          chmod +x llvm.sh
+          sudo ./llvm.sh 21
+          sudo apt-get install -y llvm-21-dev libclang-21-dev
+
+      - name: Install LLVM 21 (Windows)
+        if: matrix.os == 'windows-latest'
+        run: |
+          choco install llvm --version=21.1.8 -y
+          echo "C:\Program Files\LLVM\bin" >> $GITHUB_PATH
+
+      - name: Install LLVM 21 (macOS)
+        if: matrix.os == 'macos-latest'
+        run: |
+          brew install llvm@21
+          echo "/opt/homebrew/opt/llvm@21/bin" >> $GITHUB_PATH
+
+      - name: Build SimpleScript
+        run: zig build -Doptimize=ReleaseSafe
+
+      - name: Package Release (Linux/macOS)
+        if: matrix.os != 'windows-latest'
+        run: |
+          mkdir -p dist/bin
+          cp zig-out/bin/simplescript dist/bin/
+          cp -r examples dist/
+          tar -czvf ${{ matrix.asset_name }} -C dist .
+
+      - name: Package Release (Windows)
+        if: matrix.os == 'windows-latest'
+        run: |
+          mkdir dist\bin
+          copy zig-out\bin\simplescript.exe dist\bin\
+          xcopy /E /I examples dist\examples
+          powershell Compress-Archive -Path dist\* -DestinationPath ${{ matrix.asset_name }}
+
+      - name: Upload Release Assets
+        uses: softprops/action-gh-release@v2
+        with:
+          files: ${{ matrix.asset_name }}
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -1,70 +1,28 @@
+# Compiled files
+*
+!*/
+!*.ss
+!*.zig
+!*.zig.zon
+!*.md
+!*.txt
+!*.yml
+!.gitignore
+!build.zig
+!LICENSE
+
 # Zig build artifacts
 zig-cache/
 zig-out/
+.zig-out/
 .zig-cache/
 
-# Compiled files
-*.o
-*.obj
-*.exe
-*.out
-*.so
-*.dylib
-*.dll
-*.a
-*.lib
-
-# Executables generated by SimpleScript
-saida.o
-benchmark
-teste
-hello
-loops
-fibonacci
-
-# Backup files
-src_backup/
-src_backup_*/
-*.bak
-*.swp
-*.swo
-*~
-
 # IDEs and Editors
 .vscode/
 .idea/
 *.sublime-*
 *.code-workspace
 
-# macOS
-.DS_Store
-.AppleDouble
-.LSOverride
-
-# Linux
-.directory
-.Trash-*
-
-# Windows
-Thumbs.db
-ehthumbs.db
-Desktop.ini
-$RECYCLE.BIN/
-
-# Logs
+# Temp/Logs
 *.log
-
-# Temps
 tmp/
-temp/
-*.tmp
-
-# Archives
-*.zip
-*.tar.gz
-*.rar
-
-# Profiling
-*.prof
-callgrind.out.*
-perf.data*

build.zig

@@ -13,9 +13,17 @@ pub fn build(b: *std.Build) void {
     }),
   });
 
+  const llvm_config = "llvm-config-21";
+
+  const include_path = b.run(&[_][]const u8{ llvm_config, "--includedir" });
+  const lib_path = b.run(&[_][]const u8{ llvm_config, "--libdir" });
+
+  exe.addIncludePath(.{ .cwd_relative = std.mem.trim(u8, include_path, " \n\r") });
+  exe.addLibraryPath(.{ .cwd_relative = std.mem.trim(u8, lib_path, " \n\r") });
+
   exe.linkLibC();
   exe.linkSystemLibrary("c++");
-  exe.linkSystemLibrary("LLVM-18");
+  exe.linkSystemLibrary("LLVM-21");
 
   if (target.result.os.tag == .linux) exe.linkSystemLibrary("z");
 

build.zig.zon

@@ -1,6 +1,6 @@
 .{
   .name = .simplescript,
-  .version = "0.4.0",
+  .version = "0.5.0",
   .fingerprint = 0x24ab81ec52649174,
   .minimum_zig_version = "0.15.2",
   .dependencies = .{},

examples/conditions.ss

@@ -0,0 +1,40 @@
+// Conditional Logic and Comparisons
+// Supports if, else if, and else blocks with boolean expressions
+
+var age: int = 18
+
+say('Checking age status...')
+if age >= 18 {
+  say('Status: You are an adult')
+} else if age >= 0 {
+  say('Status: You are a minor')
+} else {
+  say('ERROR: Invalid age value')
+}
+
+// Boolean literals usage
+say('Boolean testing:')
+if true {
+  say('True branch works')
+} else {
+  say('This should not print')
+}
+
+// String comparisons
+var name: str = "Victor Francelino"
+say('Checking identity for:', name)
+
+if name != "SimpleScript" {
+  say('The strings are different')
+} else {
+  say('The strings are equal')
+}
+
+// Integer equality check
+var target: int = 16
+
+if target == 16 {
+  say('Target confirmed: 16')
+} else {
+  say('Target mismatch')
+}

examples/hello.ss

@@ -1,16 +1,21 @@
 // Hello World in SimpleScript
 // Showcases basic types and the 'say' function
 
+// The 'say' function can print multiple arguments separated by spaces
 say('--- Welcome to SimpleScript ---')
 
+// Constants are immutable after initialization
 const language: str = 'SimpleScript'
-const version: float = 0.4
+const version: float = 0.5
 
 say('Language:', language)
 say('Version:', version)
 
+// Variables can be reassigned
 var a: int = 10
 var b: int = 20
+
+// SimpleScript supports standard operator precedence
 var result: int = (a + b) * 2
 
 say('Expression result (10 + 20) * 2:', result)

examples/loops.ss

@@ -1,21 +1,22 @@
-// Demonstrates loops with static and dynamic ranges
+// Loops with Static and Dynamic Ranges
 
 say('Counting 0 to 4:')
 for i in 0..5 {
-  say(i)
+  say('Number:', i)
 }
 
 say('Using variables for range (5 to 9):')
 var start: int = 0
-var end: int = 5
+var end: int = 10
 for i in start..end {
-  say(i)
+  say('Dynamic index:', i)
 }
 
 say('Calculating sum of 0 to 9:')
 var sum: int = 0
 for i in 0..10 {
+  // Variables can be updated using their current value
   sum = sum + i
 }
 
-say('Total sum:', sum)
+say('Total sum of 0..9 is:', sum)

examples/swap.ss

@@ -1,23 +1,24 @@
-// The magic of Multiple Assignment (Swap)
-// No temporary variables needed!
+// Multiple Assignment and Value Swapping
+// In SimpleScript, you don't need temporary variables to swap values!
 
 var player_1: int = 500
 var player_2: int = 1000
 
-say('Initial Scores:', player_1, player_2)
+say('Initial Scores -> P1:', player_1, '| P2:', player_2)
 
 say('Swapping scores...')
+
+// Multiple values are evaluated and assigned simultaneously
 player_1, player_2 = player_2, player_1
 
-say('New Scores:', player_1, player_2)
+say('New Scores -> P1:', player_1, '| P2:', player_2)
 
-// Triple swap showcase
+// It also works for rotating multiple values
 var r: int = 255
 var g: int = 128
 var b: int = 0
 
 say('RGB values:', r, g, b)
-
 say('Rotating RGB values...')
 
 r, g, b = g, b, r

src/compiler.zig

@@ -37,6 +37,7 @@ pub const Variable = struct {
 pub const Compiler = struct {
   allocator: std.mem.Allocator,
   locals: std.StringHashMap(Variable),
+  scope_level: u32 = 0,
 
   context: llvm.LLVMContextRef,
   module: llvm.LLVMModuleRef,
@@ -129,6 +130,14 @@ pub const Compiler = struct {
     _ = llvm.LLVMBuildRet(self.builder, zero);
   }
 
+  pub fn enterScope(self: *Compiler) void {
+    self.scope_level += 1;
+  }
+
+  pub fn exitScope(self: *Compiler) void {
+    self.scope_level -= 1;
+  }
+
   pub fn printString(self: *Compiler, str_value: llvm.LLVMValueRef) !void {
     const fmt_str = llvm.LLVMBuildGlobalStringPtr(self.builder, "%s", "fmt.str");
     var args = [_]llvm.LLVMValueRef{ fmt_str, str_value };