93 lines
2.2 KiB
Markdown
93 lines
2.2 KiB
Markdown
|
# 🌐 Nyash WebAssembly Project
|
||
|
|
|
||
|
|
Nyash programming language running in the browser via WebAssembly!
|
||
|
|
|
||
|
|
## 🚀 Quick Start
|
||
|
|
|
||
|
|
```bash
|
||
|
|
# Install wasm-pack (if not already installed)
|
||
|
|
cargo install wasm-pack
|
||
|
|
|
||
|
|
# Build WASM module
|
||
|
|
cd /mnt/c/git/nyash
|
||
|
|
wasm-pack build --target web --out-dir projects/nyash-wasm/pkg
|
||
|
|
|
||
|
|
# Start local server
|
||
|
|
cd projects/nyash-wasm
|
||
|
|
python3 -m http.server 8000
|
||
|
|
|
||
|
|
# Open browser
|
||
|
|
# Navigate to: http://localhost:8000/nyash_playground.html
|
||
|
|
```
|
||
|
|
|
||
|
|
## 🎯 Features
|
||
|
|
|
||
|
|
- **🐱 Full Nyash Language** - Complete interpreter running in browser
|
||
|
|
- **📦 ConsoleBox** - Browser console integration
|
||
|
|
- **🔍 DebugBox** - Real-time debugging in browser
|
||
|
|
- **⚡ All Operators** - NOT/AND/OR/Division fully supported
|
||
|
|
- **🎮 Interactive Playground** - Code editor with examples
|
||
|
|
|
||
|
|
## 📁 File Structure
|
||
|
|
|
||
|
|
```
|
||
|
|
projects/nyash-wasm/
|
||
|
|
├── README.md # This file
|
||
|
|
├── nyash_playground.html # Interactive playground
|
||
|
|
├── build.sh # Build script
|
||
|
|
└── pkg/ # Generated WASM files (after build)
|
||
|
|
├── nyash_rust.js
|
||
|
|
├── nyash_rust_bg.wasm
|
||
|
|
└── ...
|
||
|
|
```
|
||
|
|
|
||
|
|
## 🎨 Example Code
|
||
|
|
|
||
|
|
```nyash
|
||
|
|
// Browser console output
|
||
|
|
console = new ConsoleBox()
|
||
|
|
console.log("Hello from Nyash in Browser!")
|
||
|
|
|
||
|
|
// Math with new operators
|
||
|
|
x = 10
|
||
|
|
y = 3
|
||
|
|
console.log("Division: " + (x / y)) // 3.333...
|
||
|
|
console.log("Logic: " + (x > 5 and y < 5)) // true
|
||
|
|
|
||
|
|
// Debugging
|
||
|
|
debug = new DebugBox()
|
||
|
|
debug.startTracking()
|
||
|
|
debug.trackBox(x, "my_number")
|
||
|
|
console.log(debug.memoryReport())
|
||
|
|
```
|
||
|
|
|
||
|
|
## 🔧 Development
|
||
|
|
|
||
|
|
### Build Process
|
||
|
|
1. Rust code compiled to WebAssembly using wasm-bindgen
|
||
|
|
2. NyashWasm struct exported with eval() method
|
||
|
|
3. ConsoleBox uses web-sys for browser console access
|
||
|
|
4. HTML playground provides interactive interface
|
||
|
|
|
||
|
|
### Architecture
|
||
|
|
```
|
||
|
|
Browser JavaScript
|
||
|
|
↓
|
||
|
|
NyashWasm.eval(code)
|
||
|
|
↓
|
||
|
|
NyashInterpreter (Rust)
|
||
|
|
↓
|
||
|
|
ConsoleBox → web_sys::console
|
||
|
|
```
|
||
|
|
|
||
|
|
## 🎉 Coming Soon
|
||
|
|
|
||
|
|
- **DOMBox** - DOM manipulation from Nyash
|
||
|
|
- **CanvasBox** - Graphics and games
|
||
|
|
- **EventBox** - Mouse/keyboard event handling
|
||
|
|
- **HTTPBox** - Network requests
|
||
|
|
- **Sample Apps** - Snake game, Calculator, etc.
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
**Everything is Box, even in the browser! 🐱**
|