docs: update documentation for May 12 compiler fixes

- CLJNIM_RECOMMENDATIONS.md: mark all 12 recommendations as implemented
- README.md: add --lib-path, first-class functions, multi-arity, rest params
- User guides (EN/BG): add sections for docstrings, multi-arity, rest params,
  keyword-as-function, first-class functions, loop/recur, --lib-path flag
- TASKS.md: add Phase 11 with all BRing compiler fixes
This commit is contained in:
2026-05-12 14:10:31 +03:00
parent a1a65f1c27
commit 7adace4ee1
5 changed files with 307 additions and 109 deletions
+12
View File
@@ -58,6 +58,7 @@ Hello, native world!
| 🇬🇧 English | [docs/en/index.md](docs/en/index.md) | Getting started, architecture, AI integration, API reference |
| 🇧🇬 Български | [docs/bg/index.md](docs/bg/index.md) | Първи стъпки, архитектура, AI интеграция, API справочник |
| 🧪 Test Suite | [docs/en/07-clojure-test-suite.md](docs/en/07-clojure-test-suite.md) | Cross-dialect compliance with [jank-lang/clojure-test-suite](https://github.com/jank-lang/clojure-test-suite) |
| 🛠️ Recommendations | [CLJNIM_RECOMMENDATIONS.md](CLJNIM_RECOMMENDATIONS.md) | Compiler limitations, workarounds, and fixes (Bulgarian) |
## ✨ What Makes This Unique?
@@ -127,6 +128,11 @@ No JNI, no JVM bridging, no Java interop overhead.
| AI integration (DeepSeek, OpenAI, MiMo) | ✅ |
| Cross-compilation targets (JS, WASM, shared libs) | ✅ |
| Self-hosted REPL with tree-walking interpreter | ✅ |
| First-class functions (defn as values) | ✅ |
| Multi-arity `defn` | ✅ |
| `&` rest parameters | ✅ |
| Keyword-as-function `(:key map)` | ✅ |
| `--lib-path` CLI flag + `CLJNIM_LIB_PATH` | ✅ |
| 276+ unit tests | ✅ |
| [jank-lang/clojure-test-suite](https://github.com/jank-lang/clojure-test-suite) compliance | ✅ |
@@ -192,6 +198,12 @@ make build
./cljnim --help
```
### Custom Library Path
Use `--lib-path` to point to your project's Nim runtime libraries:
```bash
./cljnim --lib-path ./my_project/lib run app.clj
```
## 🏗️ Architecture
```