chore: bump version to 0.1.5

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Cargo.lock

@@ -770,7 +770,7 @@ dependencies = [
 
 [[package]]
 name = "lux"
-version = "0.1.3"
+version = "0.1.4"
 dependencies = [
  "lsp-server",
  "lsp-types",

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "lux"
-version = "0.1.3"
+version = "0.1.5"
 edition = "2021"
 description = "A functional programming language with first-class effects, schema evolution, and behavioral types"
 license = "MIT"

flake.nix

@@ -44,7 +44,7 @@
             printf "\n"
             printf "  \033[1;35m╦  ╦ ╦╦ ╦\033[0m\n"
             printf "  \033[1;35m║  ║ ║╔╣\033[0m\n"
-            printf "  \033[1;35m╩═╝╚═╝╩ ╩\033[0m  v0.1.3\n"
+            printf "  \033[1;35m╩═╝╚═╝╩ ╩\033[0m  v0.1.5\n"
             printf "\n"
             printf "  Functional language with first-class effects\n"
             printf "\n"
@@ -62,7 +62,7 @@
 
         packages.default = pkgs.rustPlatform.buildRustPackage {
           pname = "lux";
-          version = "0.1.3";
+          version = "0.1.5";
           src = ./.;
           cargoLock.lockFile = ./Cargo.lock;
 
@@ -79,7 +79,7 @@
           };
         in muslPkgs.rustPlatform.buildRustPackage {
           pname = "lux";
-          version = "0.1.3";
+          version = "0.1.5";
           src = ./.;
           cargoLock.lockFile = ./Cargo.lock;
 

scripts/validate.sh

@@ -2,7 +2,7 @@
 set -euo pipefail
 
 # Lux Full Validation Script
-# Runs all checks: Rust tests, package tests, type checking, formatting, linting.
+# Runs all checks: Rust tests, package tests, type checking, example compilation.
 # Run after every committable change to ensure no regressions.
 
 # cd to repo root (directory containing this script's parent)
@@ -11,6 +11,8 @@ cd "$SCRIPT_DIR/.."
 
 LUX="$(pwd)/target/release/lux"
 PACKAGES_DIR="$(pwd)/../packages"
+PROJECTS_DIR="$(pwd)/projects"
+EXAMPLES_DIR="$(pwd)/examples"
 RED='\033[0;31m'
 GREEN='\033[0;32m'
 CYAN='\033[0;36m'
@@ -30,7 +32,7 @@ fail() { printf "${RED}FAIL${NC} %s\n" "${1:-}"; FAILED=$((FAILED + 1)); }
 
 # --- Rust checks ---
 step "cargo check"
-if nix develop --command cargo check 2>&1 | grep -q "Finished"; then ok; else fail; fi
+if nix develop --command cargo check 2>/dev/null; then ok; else fail; fi
 
 step "cargo test"
 OUTPUT=$(nix develop --command cargo test 2>&1 || true)
@@ -39,7 +41,7 @@ if echo "$RESULT" | grep -q "0 failed"; then ok "$RESULT"; else fail "$RESULT";
 
 # --- Build release binary ---
 step "cargo build --release"
-if nix develop --command cargo build --release 2>&1 | grep -q "Finished"; then ok; else fail; fi
+if nix develop --command cargo build --release 2>/dev/null; then ok; else fail; fi
 
 # --- Package tests ---
 for pkg in path frontmatter xml rss markdown; do
@@ -64,7 +66,6 @@ for pkg in path frontmatter xml rss markdown; do
 done
 
 # --- Project checks ---
-PROJECTS_DIR="$(pwd)/projects"
 for proj_dir in "$PROJECTS_DIR"/*/; do
     proj=$(basename "$proj_dir")
     if [ -f "$proj_dir/main.lux" ]; then
@@ -83,6 +84,123 @@ for proj_dir in "$PROJECTS_DIR"/*/; do
     done
 done
 
+# === Compilation & Interpreter Checks ===
+
+# --- Interpreter: examples ---
+# Skip: http_api, http, http_router, http_server (network), postgres_demo (db),
+#        random, property_testing (Random effect), shell (Process), json (File I/O),
+#        file_io (File I/O), test_math, test_lists (Test effect), stress_shared_rc,
+#        test_rc_comparison (internal tests), modules/* (need cwd)
+INTERP_SKIP="http_api http http_router http_server postgres_demo random property_testing shell json file_io test_math test_lists stress_shared_rc test_rc_comparison"
+for f in "$EXAMPLES_DIR"/*.lux; do
+    name=$(basename "$f" .lux)
+    skip=false
+    for s in $INTERP_SKIP; do [ "$name" = "$s" ] && skip=true; done
+    $skip && continue
+    step "interpreter (examples/$name)"
+    if timeout 10 "$LUX" "$f" >/dev/null 2>&1; then ok; else fail; fi
+done
+
+# --- Interpreter: examples/standard ---
+# Skip: guessing_game (reads stdin)
+for f in "$EXAMPLES_DIR"/standard/*.lux; do
+    [ -f "$f" ] || continue
+    name=$(basename "$f" .lux)
+    [ "$name" = "guessing_game" ] && continue
+    step "interpreter (standard/$name)"
+    if timeout 10 "$LUX" "$f" >/dev/null 2>&1; then ok; else fail; fi
+done
+
+# --- Interpreter: examples/showcase ---
+# Skip: task_manager (parse error in current version)
+for f in "$EXAMPLES_DIR"/showcase/*.lux; do
+    [ -f "$f" ] || continue
+    name=$(basename "$f" .lux)
+    [ "$name" = "task_manager" ] && continue
+    step "interpreter (showcase/$name)"
+    if timeout 10 "$LUX" "$f" >/dev/null 2>&1; then ok; else fail; fi
+done
+
+# --- Interpreter: projects ---
+# Skip: guessing-game (Random), rest-api (HttpServer)
+PROJ_INTERP_SKIP="guessing-game rest-api"
+for proj_dir in "$PROJECTS_DIR"/*/; do
+    proj=$(basename "$proj_dir")
+    [ -f "$proj_dir/main.lux" ] || continue
+    skip=false
+    for s in $PROJ_INTERP_SKIP; do [ "$proj" = "$s" ] && skip=true; done
+    $skip && continue
+    step "interpreter (project: $proj)"
+    if timeout 10 "$LUX" "$proj_dir/main.lux" >/dev/null 2>&1; then ok; else fail; fi
+done
+
+# --- JS compilation: examples ---
+# Skip files that fail JS compilation (unsupported features)
+JS_SKIP="http_api http http_router postgres_demo property_testing json test_lists test_rc_comparison"
+for f in "$EXAMPLES_DIR"/*.lux; do
+    name=$(basename "$f" .lux)
+    skip=false
+    for s in $JS_SKIP; do [ "$name" = "$s" ] && skip=true; done
+    $skip && continue
+    step "compile JS (examples/$name)"
+    if "$LUX" compile "$f" --target js -o /tmp/lux_validate.js >/dev/null 2>&1; then ok; else fail; fi
+done
+
+# --- JS compilation: examples/standard ---
+# Skip: stdlib_demo (uses String.toUpper not in JS backend)
+for f in "$EXAMPLES_DIR"/standard/*.lux; do
+    [ -f "$f" ] || continue
+    name=$(basename "$f" .lux)
+    [ "$name" = "stdlib_demo" ] && continue
+    step "compile JS (standard/$name)"
+    if "$LUX" compile "$f" --target js -o /tmp/lux_validate.js >/dev/null 2>&1; then ok; else fail; fi
+done
+
+# --- JS compilation: examples/showcase ---
+# Skip: task_manager (unsupported features)
+for f in "$EXAMPLES_DIR"/showcase/*.lux; do
+    [ -f "$f" ] || continue
+    name=$(basename "$f" .lux)
+    [ "$name" = "task_manager" ] && continue
+    step "compile JS (showcase/$name)"
+    if "$LUX" compile "$f" --target js -o /tmp/lux_validate.js >/dev/null 2>&1; then ok; else fail; fi
+done
+
+# --- JS compilation: projects ---
+# Skip: json-parser, rest-api (unsupported features)
+JS_PROJ_SKIP="json-parser rest-api"
+for proj_dir in "$PROJECTS_DIR"/*/; do
+    proj=$(basename "$proj_dir")
+    [ -f "$proj_dir/main.lux" ] || continue
+    skip=false
+    for s in $JS_PROJ_SKIP; do [ "$proj" = "$s" ] && skip=true; done
+    $skip && continue
+    step "compile JS (project: $proj)"
+    if "$LUX" compile "$proj_dir/main.lux" --target js -o /tmp/lux_validate.js >/dev/null 2>&1; then ok; else fail; fi
+done
+
+# --- C compilation: examples ---
+# Only compile examples known to work with C backend
+C_EXAMPLES="hello factorial pipelines tailcall jit_test"
+for name in $C_EXAMPLES; do
+    f="$EXAMPLES_DIR/$name.lux"
+    [ -f "$f" ] || continue
+    step "compile C (examples/$name)"
+    if "$LUX" compile "$f" -o /tmp/lux_validate_bin >/dev/null 2>&1; then ok; else fail; fi
+done
+
+# --- C compilation: examples/standard ---
+C_STD_EXAMPLES="hello_world factorial fizzbuzz primes guessing_game"
+for name in $C_STD_EXAMPLES; do
+    f="$EXAMPLES_DIR/standard/$name.lux"
+    [ -f "$f" ] || continue
+    step "compile C (standard/$name)"
+    if "$LUX" compile "$f" -o /tmp/lux_validate_bin >/dev/null 2>&1; then ok; else fail; fi
+done
+
+# --- Cleanup ---
+rm -f /tmp/lux_validate.js /tmp/lux_validate_bin
+
 # --- Summary ---
 printf "\n${BOLD}═══ Validation Summary ═══${NC}\n"
 if [ $FAILED -eq 0 ]; then

src/codegen/c_backend.rs

@@ -279,7 +279,7 @@ impl CBackend {
                 Declaration::Let(let_decl) => {
                     // Skip run expressions - they're handled in the main wrapper
                     if !matches!(&let_decl.value, Expr::Run { .. }) {
-                        self.emit_global_let(&let_decl.name, &let_decl.value)?;
+                        self.emit_global_let(&let_decl.name)?;
                     }
                 }
                 _ => {}
@@ -5561,9 +5561,9 @@ impl CBackend {
         }
     }
 
-    fn emit_global_let(&mut self, name: &Ident, value: &Expr) -> Result<(), CGenError> {
+    fn emit_global_let(&mut self, name: &Ident) -> Result<(), CGenError> {
-        let val = self.emit_expr(value)?;
+        // Declare global variable without initializer (initialized in main)
-        self.writeln(&format!("static LuxInt {} = {};", name.name, val));
+        self.writeln(&format!("static LuxInt {} = 0;", name.name));
         self.writeln("");
         Ok(())
     }
@@ -5574,12 +5574,16 @@ impl CBackend {
             matches!(d, Declaration::Function(f) if f.name.name == "main")
         });
 
-        // Check for top-level run expressions
+        // Check for top-level run expressions or let bindings
         let has_run = program.declarations.iter().any(|d| {
             matches!(d, Declaration::Let(let_decl) if matches!(&let_decl.value, Expr::Run { .. }))
         });
 
-        if has_main || has_run {
+        let has_global_lets = program.declarations.iter().any(|d| {
+            matches!(d, Declaration::Let(let_decl) if !matches!(&let_decl.value, Expr::Run { .. }))
+        });
+
+        if has_main || has_run || has_global_lets {
             self.writeln("int main(int argc, char** argv) {");
             self.indent += 1;
 
@@ -5588,6 +5592,16 @@ impl CBackend {
             self.writeln("lux_argv = argv;");
             self.writeln("");
 
+            // Initialize top-level let bindings (non-run) inside main
+            for decl in &program.declarations {
+                if let Declaration::Let(let_decl) = decl {
+                    if !matches!(&let_decl.value, Expr::Run { .. }) {
+                        let val = self.emit_expr(&let_decl.value)?;
+                        self.writeln(&format!("{} = {};", let_decl.name.name, val));
+                    }
+                }
+            }
+
             // Execute top-level let bindings with run expressions
             // Track if main was already called via a run expression
             let mut main_called_via_run = false;

src/codegen/js_backend.rs

@@ -69,6 +69,8 @@ pub struct JsBackend {
     has_handlers: bool,
     /// Variable substitutions for let binding
     var_substitutions: HashMap<String, String>,
+    /// Effects actually used in the program (for tree-shaking runtime)
+    used_effects: HashSet<String>,
 }
 
 impl JsBackend {
@@ -90,6 +92,7 @@ impl JsBackend {
             effectful_functions: HashSet::new(),
             has_handlers: false,
             var_substitutions: HashMap::new(),
+            used_effects: HashSet::new(),
         }
     }
 
@@ -97,9 +100,6 @@ impl JsBackend {
     pub fn generate(&mut self, program: &Program) -> Result<String, JsGenError> {
         self.output.clear();
 
-        // Emit runtime helpers
-        self.emit_runtime();
-
         // First pass: collect all function names, types, and effects
         for decl in &program.declarations {
             match decl {
@@ -116,6 +116,12 @@ impl JsBackend {
             }
         }
 
+        // Collect used effects for tree-shaking
+        self.collect_used_effects(program);
+
+        // Emit runtime helpers (tree-shaken based on used effects)
+        self.emit_runtime();
+
         // Emit type constructors
         for decl in &program.declarations {
             if let Declaration::Type(t) = decl {
@@ -163,32 +169,181 @@ impl JsBackend {
         Ok(self.output.clone())
     }
 
-    /// Emit the minimal Lux runtime
+    /// Collect all effects used in the program for runtime tree-shaking
+    fn collect_used_effects(&mut self, program: &Program) {
+        for decl in &program.declarations {
+            match decl {
+                Declaration::Function(f) => {
+                    for effect in &f.effects {
+                        self.used_effects.insert(effect.name.clone());
+                    }
+                    self.collect_effects_from_expr(&f.body);
+                }
+                Declaration::Let(l) => {
+                    self.collect_effects_from_expr(&l.value);
+                }
+                Declaration::Handler(h) => {
+                    self.used_effects.insert(h.effect.name.clone());
+                    for imp in &h.implementations {
+                        self.collect_effects_from_expr(&imp.body);
+                    }
+                }
+                _ => {}
+            }
+        }
+    }
+
+    /// Recursively collect effect names from an expression
+    fn collect_effects_from_expr(&mut self, expr: &Expr) {
+        match expr {
+            Expr::EffectOp { effect, args, .. } => {
+                self.used_effects.insert(effect.name.clone());
+                for arg in args {
+                    self.collect_effects_from_expr(arg);
+                }
+            }
+            Expr::Run { expr, handlers, .. } => {
+                self.collect_effects_from_expr(expr);
+                for (effect, handler) in handlers {
+                    self.used_effects.insert(effect.name.clone());
+                    self.collect_effects_from_expr(handler);
+                }
+            }
+            Expr::Call { func, args, .. } => {
+                self.collect_effects_from_expr(func);
+                for arg in args {
+                    self.collect_effects_from_expr(arg);
+                }
+            }
+            Expr::Lambda { body, effects, .. } => {
+                for effect in effects {
+                    self.used_effects.insert(effect.name.clone());
+                }
+                self.collect_effects_from_expr(body);
+            }
+            Expr::Let { value, body, .. } => {
+                self.collect_effects_from_expr(value);
+                self.collect_effects_from_expr(body);
+            }
+            Expr::If { condition, then_branch, else_branch, .. } => {
+                self.collect_effects_from_expr(condition);
+                self.collect_effects_from_expr(then_branch);
+                self.collect_effects_from_expr(else_branch);
+            }
+            Expr::Match { scrutinee, arms, .. } => {
+                self.collect_effects_from_expr(scrutinee);
+                for arm in arms {
+                    self.collect_effects_from_expr(&arm.body);
+                    if let Some(guard) = &arm.guard {
+                        self.collect_effects_from_expr(guard);
+                    }
+                }
+            }
+            Expr::Block { statements, result, .. } => {
+                for stmt in statements {
+                    match stmt {
+                        Statement::Expr(e) => self.collect_effects_from_expr(e),
+                        Statement::Let { value, .. } => self.collect_effects_from_expr(value),
+                    }
+                }
+                self.collect_effects_from_expr(result);
+            }
+            Expr::BinaryOp { left, right, .. } => {
+                self.collect_effects_from_expr(left);
+                self.collect_effects_from_expr(right);
+            }
+            Expr::UnaryOp { operand, .. } => {
+                self.collect_effects_from_expr(operand);
+            }
+            Expr::Field { object, .. } => {
+                self.collect_effects_from_expr(object);
+            }
+            Expr::TupleIndex { object, .. } => {
+                self.collect_effects_from_expr(object);
+            }
+            Expr::Record { spread, fields, .. } => {
+                if let Some(s) = spread {
+                    self.collect_effects_from_expr(s);
+                }
+                for (_, expr) in fields {
+                    self.collect_effects_from_expr(expr);
+                }
+            }
+            Expr::Tuple { elements, .. } | Expr::List { elements, .. } => {
+                for el in elements {
+                    self.collect_effects_from_expr(el);
+                }
+            }
+            Expr::Resume { value, .. } => {
+                self.collect_effects_from_expr(value);
+            }
+            Expr::Literal(_) | Expr::Var(_) => {}
+        }
+    }
+
+    /// Emit the Lux runtime, tree-shaken based on used effects
     fn emit_runtime(&mut self) {
+        let uses_console = self.used_effects.contains("Console");
+        let uses_random = self.used_effects.contains("Random");
+        let uses_time = self.used_effects.contains("Time");
+        let uses_http = self.used_effects.contains("Http");
+        let uses_dom = self.used_effects.contains("Dom");
+        let uses_html = self.used_effects.contains("Html") || uses_dom;
+
         self.writeln("// Lux Runtime");
         self.writeln("const Lux = {");
         self.indent += 1;
 
-        // Option helpers
+        // Core helpers — always emitted
         self.writeln("Some: (value) => ({ tag: \"Some\", value }),");
         self.writeln("None: () => ({ tag: \"None\" }),");
         self.writeln("");
-
-        // Result helpers
         self.writeln("Ok: (value) => ({ tag: \"Ok\", value }),");
         self.writeln("Err: (error) => ({ tag: \"Err\", error }),");
         self.writeln("");
-
-        // List helpers
         self.writeln("Cons: (head, tail) => [head, ...tail],");
         self.writeln("Nil: () => [],");
         self.writeln("");
 
-        // Default handlers for effects
+        // Default handlers — only include effects that are used
         self.writeln("defaultHandlers: {");
         self.indent += 1;
 
-        // Console effect
+        if uses_console {
+            self.emit_console_handler();
+        }
+        if uses_random {
+            self.emit_random_handler();
+        }
+        if uses_time {
+            self.emit_time_handler();
+        }
+        if uses_http {
+            self.emit_http_handler();
+        }
+        if uses_dom {
+            self.emit_dom_handler();
+        }
+
+        self.indent -= 1;
+        self.writeln("},");
+
+        // HTML rendering — only if Html or Dom effects are used
+        if uses_html {
+            self.emit_html_helpers();
+        }
+
+        // TEA runtime — only if Dom is used
+        if uses_dom {
+            self.emit_tea_runtime();
+        }
+
+        self.indent -= 1;
+        self.writeln("};");
+        self.writeln("");
+    }
+
+    fn emit_console_handler(&mut self) {
         self.writeln("Console: {");
         self.indent += 1;
         self.writeln("print: (msg) => console.log(msg),");
@@ -207,8 +362,9 @@ impl JsBackend {
         self.writeln("readInt: () => parseInt(Lux.defaultHandlers.Console.readLine(), 10)");
         self.indent -= 1;
         self.writeln("},");
+    }
 
-        // Random effect
+    fn emit_random_handler(&mut self) {
         self.writeln("Random: {");
         self.indent += 1;
         self.writeln("int: (min, max) => Math.floor(Math.random() * (max - min + 1)) + min,");
@@ -216,16 +372,18 @@ impl JsBackend {
         self.writeln("float: () => Math.random()");
         self.indent -= 1;
         self.writeln("},");
+    }
 
-        // Time effect
+    fn emit_time_handler(&mut self) {
         self.writeln("Time: {");
         self.indent += 1;
         self.writeln("now: () => Date.now(),");
         self.writeln("sleep: (ms) => new Promise(resolve => setTimeout(resolve, ms))");
         self.indent -= 1;
         self.writeln("},");
+    }
 
-        // Http effect (browser/Node compatible)
+    fn emit_http_handler(&mut self) {
         self.writeln("Http: {");
         self.indent += 1;
         self.writeln("get: async (url) => {");
@@ -287,8 +445,9 @@ impl JsBackend {
         self.writeln("}");
         self.indent -= 1;
         self.writeln("},");
+    }
 
-        // Dom effect (browser only - stubs for Node.js)
+    fn emit_dom_handler(&mut self) {
         self.writeln("Dom: {");
         self.indent += 1;
 
@@ -316,7 +475,6 @@ impl JsBackend {
         self.indent -= 1;
         self.writeln("},");
 
-        // Element creation
         self.writeln("createElement: (tag) => {");
         self.indent += 1;
         self.writeln("if (typeof document === 'undefined') return null;");
@@ -331,7 +489,6 @@ impl JsBackend {
         self.indent -= 1;
         self.writeln("},");
 
-        // DOM manipulation
         self.writeln("appendChild: (parent, child) => {");
         self.indent += 1;
         self.writeln("if (parent && child) parent.appendChild(child);");
@@ -356,7 +513,6 @@ impl JsBackend {
         self.indent -= 1;
         self.writeln("},");
 
-        // Content
         self.writeln("setTextContent: (el, text) => {");
         self.indent += 1;
         self.writeln("if (el) el.textContent = text;");
@@ -381,7 +537,6 @@ impl JsBackend {
         self.indent -= 1;
         self.writeln("},");
 
-        // Attributes
         self.writeln("setAttribute: (el, name, value) => {");
         self.indent += 1;
         self.writeln("if (el) el.setAttribute(name, value);");
@@ -408,7 +563,6 @@ impl JsBackend {
         self.indent -= 1;
         self.writeln("},");
 
-        // Classes
         self.writeln("addClass: (el, className) => {");
         self.indent += 1;
         self.writeln("if (el) el.classList.add(className);");
@@ -433,7 +587,6 @@ impl JsBackend {
         self.indent -= 1;
         self.writeln("},");
 
-        // Styles
         self.writeln("setStyle: (el, property, value) => {");
         self.indent += 1;
         self.writeln("if (el) el.style[property] = value;");
@@ -446,7 +599,6 @@ impl JsBackend {
         self.indent -= 1;
         self.writeln("},");
 
-        // Form elements
         self.writeln("getValue: (el) => {");
         self.indent += 1;
         self.writeln("return el ? el.value : '';");
@@ -471,7 +623,6 @@ impl JsBackend {
         self.indent -= 1;
         self.writeln("},");
 
-        // Events
         self.writeln("addEventListener: (el, event, handler) => {");
         self.indent += 1;
         self.writeln("if (el) el.addEventListener(event, handler);");
@@ -484,7 +635,6 @@ impl JsBackend {
         self.indent -= 1;
         self.writeln("},");
 
-        // Focus
         self.writeln("focus: (el) => {");
         self.indent += 1;
         self.writeln("if (el && el.focus) el.focus();");
@@ -497,7 +647,6 @@ impl JsBackend {
         self.indent -= 1;
         self.writeln("},");
 
-        // Document
         self.writeln("getBody: () => {");
         self.indent += 1;
         self.writeln("if (typeof document === 'undefined') return null;");
@@ -512,7 +661,6 @@ impl JsBackend {
         self.indent -= 1;
         self.writeln("},");
 
-        // Window
         self.writeln("getWindow: () => {");
         self.indent += 1;
         self.writeln("if (typeof window === 'undefined') return null;");
@@ -545,7 +693,6 @@ impl JsBackend {
         self.indent -= 1;
         self.writeln("},");
 
-        // Scroll
         self.writeln("scrollTo: (x, y) => {");
         self.indent += 1;
         self.writeln("if (typeof window !== 'undefined') window.scrollTo(x, y);");
@@ -558,7 +705,6 @@ impl JsBackend {
         self.indent -= 1;
         self.writeln("},");
 
-        // Dimensions
         self.writeln("getBoundingClientRect: (el) => {");
         self.indent += 1;
         self.writeln("if (!el) return { top: 0, left: 0, width: 0, height: 0, right: 0, bottom: 0 };");
@@ -574,13 +720,11 @@ impl JsBackend {
         self.indent -= 1;
         self.writeln("}");
 
-        self.indent -= 1;
-        self.writeln("}");
-
         self.indent -= 1;
         self.writeln("},");
+    }
 
-        // HTML rendering helpers
+    fn emit_html_helpers(&mut self) {
         self.writeln("");
         self.writeln("// HTML rendering");
         self.writeln("renderHtml: (node) => {");
@@ -682,8 +826,9 @@ impl JsBackend {
         self.writeln("return el;");
         self.indent -= 1;
         self.writeln("},");
+    }
 
-        // TEA (The Elm Architecture) runtime
+    fn emit_tea_runtime(&mut self) {
         self.writeln("");
         self.writeln("// The Elm Architecture (TEA) runtime");
         self.writeln("app: (config) => {");
@@ -727,7 +872,6 @@ impl JsBackend {
         self.indent -= 1;
         self.writeln("},");
 
-        // Simple app (for string-based views like the counter example)
         self.writeln("");
         self.writeln("// Simple TEA app (string-based view)");
         self.writeln("simpleApp: (config) => {");
@@ -757,7 +901,6 @@ impl JsBackend {
         self.indent -= 1;
         self.writeln("},");
 
-        // Diff and patch (basic implementation for view_deps optimization)
         self.writeln("");
         self.writeln("// Basic diff - checks if model fields changed");
         self.writeln("hasChanged: (oldModel, newModel, ...paths) => {");
@@ -777,11 +920,7 @@ impl JsBackend {
         self.writeln("}");
         self.writeln("return false;");
         self.indent -= 1;
-        self.writeln("}");
+        self.writeln("},");
-
-        self.indent -= 1;
-        self.writeln("};");
-        self.writeln("");
     }
 
     /// Collect type information from a type declaration
@@ -3920,7 +4059,7 @@ line3"
 
     #[test]
     fn test_js_runtime_generated() {
-        // Test that the Lux runtime is properly generated
+        // Test that the Lux runtime core is always generated
         use crate::parser::Parser;
 
         let source = r#"
@@ -3931,21 +4070,51 @@ line3"
         let mut backend = JsBackend::new();
         let js_code = backend.generate(&program).expect("Should generate");
 
-        // Check that Lux runtime includes key functions
+        // Core runtime is always present
         assert!(js_code.contains("const Lux = {"), "Lux object should be defined");
         assert!(js_code.contains("Some:"), "Option Some should be defined");
         assert!(js_code.contains("None:"), "Option None should be defined");
-        assert!(js_code.contains("renderHtml:"), "renderHtml should be defined");
+
-        assert!(js_code.contains("renderToDom:"), "renderToDom should be defined");
+        // Console-only program should NOT include Dom, Html, or TEA sections
-        assert!(js_code.contains("escapeHtml:"), "escapeHtml should be defined");
+        assert!(!js_code.contains("Dom:"), "Dom handler should not be in Console-only program");
-        assert!(js_code.contains("app:"), "TEA app should be defined");
+        assert!(!js_code.contains("renderHtml:"), "renderHtml should not be in Console-only program");
-        assert!(js_code.contains("simpleApp:"), "simpleApp should be defined");
+        assert!(!js_code.contains("app:"), "TEA app should not be in Console-only program");
-        assert!(js_code.contains("hasChanged:"), "hasChanged should be defined");
+        assert!(!js_code.contains("Http:"), "Http should not be in Console-only program");
+
+        // Console should be present
+        assert!(js_code.contains("Console:"), "Console handler should exist");
+    }
+
+    #[test]
+    fn test_js_runtime_tree_shaking_all_effects() {
+        // Test that all effects are included when all are used
+        use crate::parser::Parser;
+
+        let source = r#"
+            fn main(): Unit with {Console, Dom} = {
+                Console.print("Hello")
+                let _ = Dom.getElementById("app")
+                ()
+            }
+        "#;
+
+        let program = Parser::parse_source(source).expect("Should parse");
+        let mut backend = JsBackend::new();
+        let js_code = backend.generate(&program).expect("Should generate");
+
+        assert!(js_code.contains("Console:"), "Console handler should exist");
+        assert!(js_code.contains("Dom:"), "Dom handler should exist");
+        assert!(js_code.contains("renderHtml:"), "renderHtml should be defined when Dom is used");
+        assert!(js_code.contains("renderToDom:"), "renderToDom should be defined when Dom is used");
+        assert!(js_code.contains("escapeHtml:"), "escapeHtml should be defined when Dom is used");
+        assert!(js_code.contains("app:"), "TEA app should be defined when Dom is used");
+        assert!(js_code.contains("simpleApp:"), "simpleApp should be defined when Dom is used");
+        assert!(js_code.contains("hasChanged:"), "hasChanged should be defined when Dom is used");
     }
 
     #[test]
     fn test_js_runtime_default_handlers() {
-        // Test that default handlers are properly generated
+        // Test that only used effect handlers are generated
         use crate::parser::Parser;
 
         let source = r#"
@@ -3956,12 +4125,12 @@ line3"
         let mut backend = JsBackend::new();
         let js_code = backend.generate(&program).expect("Should generate");
 
-        // Check that default handlers include all effects
+        // Only Console should be present
         assert!(js_code.contains("Console:"), "Console handler should exist");
-        assert!(js_code.contains("Random:"), "Random handler should exist");
+        assert!(!js_code.contains("Random:"), "Random handler should not exist in Console-only program");
-        assert!(js_code.contains("Time:"), "Time handler should exist");
+        assert!(!js_code.contains("Time:"), "Time handler should not exist in Console-only program");
-        assert!(js_code.contains("Http:"), "Http handler should exist");
+        assert!(!js_code.contains("Http:"), "Http handler should not exist in Console-only program");
-        assert!(js_code.contains("Dom:"), "Dom handler should exist");
+        assert!(!js_code.contains("Dom:"), "Dom handler should not exist in Console-only program");
     }
 
     #[test]

src/lexer.rs

@@ -42,6 +42,7 @@ pub enum TokenKind {
     Effect,
     Handler,
     Run,
+    Handle,
     Resume,
     Type,
     True,
@@ -140,6 +141,7 @@ impl fmt::Display for TokenKind {
             TokenKind::Effect => write!(f, "effect"),
             TokenKind::Handler => write!(f, "handler"),
             TokenKind::Run => write!(f, "run"),
+            TokenKind::Handle => write!(f, "handle"),
             TokenKind::Resume => write!(f, "resume"),
             TokenKind::Type => write!(f, "type"),
             TokenKind::Import => write!(f, "import"),
@@ -771,6 +773,7 @@ impl<'a> Lexer<'a> {
             "effect" => TokenKind::Effect,
             "handler" => TokenKind::Handler,
             "run" => TokenKind::Run,
+            "handle" => TokenKind::Handle,
             "resume" => TokenKind::Resume,
             "type" => TokenKind::Type,
             "import" => TokenKind::Import,
@@ -789,6 +792,8 @@ impl<'a> Lexer<'a> {
             "commutative" => TokenKind::Commutative,
             "where" => TokenKind::Where,
             "assume" => TokenKind::Assume,
+            "and" => TokenKind::And,
+            "or" => TokenKind::Or,
             "true" => TokenKind::Bool(true),
             "false" => TokenKind::Bool(false),
             _ => TokenKind::Ident(ident.to_string()),

src/main.rs

@@ -193,10 +193,12 @@ fn main() {
                     eprintln!("       lux compile <file.lux> --run");
                     eprintln!("       lux compile <file.lux> --emit-c [-o file.c]");
                     eprintln!("       lux compile <file.lux> --target js [-o file.js]");
+                    eprintln!("       lux compile <file.lux> --watch");
                     std::process::exit(1);
                 }
                 let run_after = args.iter().any(|a| a == "--run");
                 let emit_c = args.iter().any(|a| a == "--emit-c");
+                let watch = args.iter().any(|a| a == "--watch");
                 let target_js = args.iter()
                     .position(|a| a == "--target")
                     .and_then(|i| args.get(i + 1))
@@ -212,6 +214,16 @@ fn main() {
                 } else {
                     compile_to_c(&args[2], output_path, run_after, emit_c);
                 }
+
+                if watch {
+                    // Build the args to replay for each recompilation (without --watch)
+                    let compile_args: Vec<String> = args.iter()
+                        .skip(1)
+                        .filter(|a| a.as_str() != "--watch")
+                        .cloned()
+                        .collect();
+                    watch_and_rerun(&args[2], &compile_args);
+                }
             }
             "repl" => {
                 // Start REPL
@@ -1351,6 +1363,64 @@ fn watch_file(path: &str) {
     }
 }
 
+fn watch_and_rerun(path: &str, compile_args: &[String]) {
+    use std::time::{Duration, SystemTime};
+    use std::path::Path;
+
+    let file_path = Path::new(path);
+    if !file_path.exists() {
+        eprintln!("File not found: {}", path);
+        std::process::exit(1);
+    }
+
+    println!();
+    println!("Watching {} for changes (Ctrl+C to stop)...", path);
+
+    let mut last_modified = std::fs::metadata(file_path)
+        .and_then(|m| m.modified())
+        .unwrap_or(SystemTime::UNIX_EPOCH);
+
+    loop {
+        std::thread::sleep(Duration::from_millis(500));
+
+        let modified = match std::fs::metadata(file_path).and_then(|m| m.modified()) {
+            Ok(m) => m,
+            Err(_) => continue,
+        };
+
+        if modified > last_modified {
+            last_modified = modified;
+
+            // Clear screen
+            print!("\x1B[2J\x1B[H");
+
+            println!("=== Compiling {} ===", path);
+            println!();
+
+            let result = std::process::Command::new(std::env::current_exe().unwrap())
+                .args(compile_args)
+                .status();
+
+            match result {
+                Ok(status) if status.success() => {
+                    println!();
+                    println!("=== Success ===");
+                }
+                Ok(_) => {
+                    println!();
+                    println!("=== Failed ===");
+                }
+                Err(e) => {
+                    eprintln!("Error running compiler: {}", e);
+                }
+            }
+
+            println!();
+            println!("Watching for changes...");
+        }
+    }
+}
+
 fn serve_static_files(dir: &str, port: u16) {
     use std::io::{Write, BufRead, BufReader};
     use std::net::TcpListener;

src/parser.rs

@@ -245,6 +245,7 @@ impl Parser {
             TokenKind::Trait => Ok(Declaration::Trait(self.parse_trait_decl(visibility, doc)?)),
             TokenKind::Impl => Ok(Declaration::Impl(self.parse_impl_decl()?)),
             TokenKind::Run => Err(self.error("Bare 'run' expressions are not allowed at top level. Use 'let _ = run ...' or 'let result = run ...'")),
+            TokenKind::Handle => Err(self.error("Bare 'handle' expressions are not allowed at top level. Use 'let _ = handle ...' or 'let result = handle ...'")),
             _ => Err(self.error("Expected declaration (fn, effect, handler, type, trait, impl, or let)")),
         }
     }
@@ -1775,6 +1776,7 @@ impl Parser {
             TokenKind::Let => self.parse_let_expr(),
             TokenKind::Fn => self.parse_lambda_expr(),
             TokenKind::Run => self.parse_run_expr(),
+            TokenKind::Handle => self.parse_handle_expr(),
             TokenKind::Resume => self.parse_resume_expr(),
 
             // Delimiters
@@ -2151,6 +2153,40 @@ impl Parser {
         })
     }
 
+    fn parse_handle_expr(&mut self) -> Result<Expr, ParseError> {
+        let start = self.current_span();
+        self.expect(TokenKind::Handle)?;
+
+        let expr = Box::new(self.parse_call_expr()?);
+
+        self.expect(TokenKind::With)?;
+        self.expect(TokenKind::LBrace)?;
+        self.skip_newlines();
+
+        let mut handlers = Vec::new();
+        while !self.check(TokenKind::RBrace) {
+            let effect = self.parse_ident()?;
+            self.expect(TokenKind::Eq)?;
+            let handler = self.parse_expr()?;
+            handlers.push((effect, handler));
+
+            self.skip_newlines();
+            if self.check(TokenKind::Comma) {
+                self.advance();
+            }
+            self.skip_newlines();
+        }
+
+        let end = self.current_span();
+        self.expect(TokenKind::RBrace)?;
+
+        Ok(Expr::Run {
+            expr,
+            handlers,
+            span: start.merge(end),
+        })
+    }
+
     fn parse_resume_expr(&mut self) -> Result<Expr, ParseError> {
         let start = self.current_span();
         self.expect(TokenKind::Resume)?;