Files
dimgigov 79cd9c08d8 chore: rebrand Clojure/Nim → Bara Lang across codebase
- Bulk replace Clojure/Nim → Bara Lang in src/, lib/, examples/, benchmarks/,
  experiments/, books/, LICENSE, cljnim.nimble, PLAN.md, AI_AGENT.md
- Rename book chapters: 05-clojure-nim.md → 05-bara-lang.md (en + bg)
- Update all chapter index links and anchors
- Replace project-specific 'Clojure' references with 'Bara Lang' in
  experiments/, src/ai_assist.nim, src/tui_screens.nim, src/emitter.nim,
  src/reader.nim, src/types.nim, lib/cljnim_runtime*.nim
- Keep legitimate JVM Clojure/ClojureScript/Clojure CLR references intact
2026-05-11 12:23:29 +03:00
..

Bara Lang Experiments

Unconventional compilation targets that JVM Clojure cannot do.

Projects

Experiment Status Description
web-target/ Working Clojure → Nim → JavaScript for browsers
native-lib/ Working Clojure → Nim → C shared library (.so)
wasm-target/ 🏗️ Skeleton Clojure → Nim → WASM via Emscripten

web-target — Bara Lang in the Browser

cd web-target
./build.sh
node -e "require('./build/math.js'); console.log(jsSquare(7))"
# → 49

Unique: No JVM, no JavaScript source code — pure Bara Lang compiled to JS.

native-lib — Bara Lang as a C Library

cd native-lib
./build.sh
cd test_client && make && LD_LIBRARY_PATH=../build ./test_client
# → c_square(7) = 49
# → c_factorial(5) = 120

Unique: Call Bara Lang functions from Python, Rust, Go, C via FFI.

wasm-target — Bara Lang at Native Speed in Browser

cd wasm-target
# Install Emscripten first, then:
./build.sh
# Open www/index.html in browser

Unique: Bara Lang running as WebAssembly — faster than ClojureScript, smaller than JVM.

Architecture

All experiments share the same pipeline:

Bara Lang Source (.clj)
       ↓
   cljnim compile-lib
       ↓
   Nim Source (.nim) with exported procs
       ↓
   Target-specific wrapper
       ↓
   nim c --target=...
       ↓
   JS / .so / .wasm

Adding a New Experiment

  1. Create a folder: experiments/my-target/
  2. Write Clojure example in examples/
  3. Write Nim wrapper in my_wrappers.nim
  4. Write build.sh using cljnim compile-lib
  5. Add row to the table above