A complete JavaScript engine and runtime environment for classic
Amiga computers. Built from scratch in C, targeting MC68000 and
AmigaOS 2.0+. Inspired by Node.js, adapted for the Amiga platform.
Features
--------
* JavaScript engine (ES5.1 + ES6+ features)
- Arrow functions, classes with inheritance
- Template literals, destructuring, spread/rest
- for-of loops, default parameters
- Regex literal syntax /pattern/flags
- Optional chaining (?.), nullish coalescing (??)
- let/const block scoping, numeric separators
- async/await, Promises
- Automatic Semicolon Insertion (ASI)
- Closures, prototype chain
* Built-in objects and functions
- console (log, error, warn, time/timeEnd, assert)
- Math (18 functions), JSON (with reviver/replacer)
- Date, RegExp, Buffer, Error (with stack traces)
- Promise (then/catch/finally/all/race/allSettled/any)
- Map, Set, WeakMap, WeakSet, Symbol
- setTimeout/setInterval/clearTimeout
- crypto (MD5, SHA-256 hashing)
- process.nextTick, queueMicrotask
* String methods: 25+ (charAt, indexOf, slice, split,
replace, trim, includes, startsWith, padStart, etc.)
* Array methods: 28+ (push, pop, map, filter, reduce,
sort, find, forEach, every, some, splice, flat, etc.)
* Object: keys, values, entries, assign, create, freeze,
seal, is, fromEntries, defineProperty/ies,
getPrototypeOf, getters/setters
* Amiga Intuition GUI bindings
- Open windows with title, size, position
- Graphics: lines, rectangles, circles, text, pixels
- Mouse and keyboard event handling
- System requesters (alert, confirm)
- Screen information query
* Node.js-compatible module system
- require() with module caching
- CommonJS exports (module.exports)
- Native modules: fs, http, net, buffer, os,
child_process, crypto, intuition
- JS modules: path, events, url, querystring, util,
stream, assert, repl
* File I/O (fs module)
- readFileSync, writeFileSync, appendFileSync
- existsSync, unlinkSync, renameSync, statSync
- Full AmigaOS path support (Volume:dir/file)
* HTTP server and client
- http.createServer() — non-blocking, 8 concurrent
- http.get(), http.post(), http.request()
- Automatic redirect following (301/302/307)
- 10-second socket timeout
- Requires bsdsocket.library (e.g. Roadshow, Miami)
* OS integration
- process.platform ("amigaos"), process.arch ("m68k")
- process.argv, process.env, process.cwd(), process.exit
- os.cpus() (detects 68000/020/030/040/060)
- os.freemem(), os.version() (Kickstart version)
- child_process.execSync() via SystemTagList()
* Interactive REPL with command history (arrow up/down)
* Error messages with filename and line number
Usage
-----
NodeAmiga script.js Execute a JavaScript file
NodeAmiga -e "code" Evaluate inline JavaScript
NodeAmiga Start interactive REPL
NodeAmiga -help Show help
NodeAmiga -v Show version
NodeAmiga --ast script.js Print AST (debug)
Installation
------------
1. Copy NodeAmiga to C: or any directory in your path
2. Copy the libs/ directory to PROGDIR: (same directory
as NodeAmiga), or to LIBS:node/
3. Optional: copy examples/ for demo scripts
Quick test:
NodeAmiga -e "console.log('Hello Amiga!')"
NodeAmiga examples/hello.js
NodeAmiga examples/gui_hello.js
NodeAmiga examples/fibonacci.js
System Requirements
-------------------
* MC68000 or higher CPU
* AmigaOS 2.04 (Kickstart 37) or higher
* Minimum 1 MB RAM (2+ MB recommended for scripts)
* bsdsocket.library for networking features
(Roadshow, Miami, AmiTCP, or similar)
* No FPU required (software floating-point)
Technical Details
-----------------
* Engine: custom-built lexer, recursive descent parser
with Pratt precedence climbing, tree-walking interpreter
* Memory: reference counting (no GC pauses), arena
allocator for AST, integer cache 0-255
* Stack: auto-allocates 64 KB via StackSwap
Included Examples
-----------------
hello.js Platform info and greeting
fibonacci.js Recursive/iterative/memoized benchmark
file_io.js File read/write/append operations
http_server.js HTTP server with routing
http_client.js HTTP GET and POST requests
classes.js ES6 classes with inheritance
closures.js Closures, IIFE, module pattern
array_fun.js map/filter/reduce/sort with real data
regex.js RegExp /literal/ syntax and methods
events.js EventEmitter custom events
promises.js Promise chains, all, race
timers.js setTimeout and setInterval
buffer.js Binary data manipulation
streams.js Readable/Writable/Transform streams
sysinfo.js Full system information display
todo_app.js TODO app with file persistence
mini_grep.js Pattern search in files
url_parser.js URL and query string parsing
calculator.js Recursive descent expression parser
json_db.js JSON file-based database
myip.js Fetch public IP from internet
nettime.js Internet time via HTTP API
weather.js Weather info for a city
download.js Download file and save to disk
gui_hello.js Simplest Intuition window from JS
gui_demo.js Interactive drawing with mouse events
Known Limitations
-----------------
* No ES modules (import/export), use require()
* No Proxy, generators/yield
* No tagged template literals
* HTTPS: detects AmiSSL, full integration planned
* WeakMap/WeakSet: no true weak refs (refcounting)
* await is synchronous (spin-waits on event loop)
Credits
-------
Juen/Project R3D+Appendix+Nah-Kolor
|
aminet net>