Short:        JavaScript runtime (Node.js-like)
Author:       Juen/Project R3D+Appendix+Nah-Kolor
Uploader:     biuro cdlabel info (Pawel Nowak)
Type:         dev/lang
Version:      0.11.0
Requires:     68000+, 1 MB RAM, bsdsocket.library (for networking)
Architecture: m68k-amigaos >= 2.0.4

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, super(), static methods
   - Template literals, tagged templates
   - Destructuring, spread/rest, default parameters
   - for-of loops, 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, dir, time/timeEnd, table)
   - Math (27 functions incl. cbrt/fround/clz32/imul)
   - JSON (with reviver/replacer)
   - Date (full API incl. UTC, getUTC*/setUTC*)
   - RegExp (lookahead, non-capturing groups, quantifiers,
     lazy quantifiers, named groups, flags g/i/m/s/u/y)
   - Buffer (hex/base64)
   - Promise (then/catch/finally/all/race/allSettled)
   - Map, Set, WeakMap, WeakSet, Symbol
   - setTimeout/setInterval/clearTimeout
   - crypto (MD5, SHA-256), structuredClone
   - TextEncoder, TextDecoder
   - process.stdout.write, process.stdin.read
   - process.hrtime, process.nextTick, queueMicrotask

 * String methods: 29+ (charAt, indexOf, slice, split,
   replace, replaceAll, trim, includes, startsWith,
   padStart, normalize, localeCompare, codePointAt, etc.)

 * Array methods: 33+ (push, pop, map, filter, reduce,
   reduceRight, sort, find, findLast, findLastIndex,
   forEach, every, some, splice, flat, flatMap, entries,
   keys, values, copyWithin, at, Array.from/of/isArray)

 * Object: keys, values, entries, assign, create, freeze,
   seal, is, fromEntries, defineProperty/ies, hasOwn,
   getPrototypeOf, setPrototypeOf, getOwnPropertyNames,
   getOwnPropertyDescriptor(s), preventExtensions,
   isExtensible, getters/setters

 * Number: isInteger, isFinite, isNaN, isSafeInteger,
   parseInt, parseFloat, toString(radix), toFixed,
   toExponential, toPrecision, constants (EPSILON,
   MAX_SAFE_INTEGER, MIN_SAFE_INTEGER, NaN, Infinity)

 * Global functions: encodeURIComponent, decodeURIComponent,
   encodeURI, decodeURI, parseInt, parseFloat, isNaN,
   isFinite, eval()

 * Symbol: Symbol(), Symbol.for/keyFor, well-known symbols,
   Symbol as property key, Iterator protocol (Symbol.iterator)

 * 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)
   - ES modules: import/export (default, named, namespace)
   - Native modules: fs, http, net, buffer, os,
     child_process, crypto, intuition, readline, dns
   - JS modules: path, events, url, querystring, util,
     stream, assert, repl, timers

 * File I/O (fs module)
   - readFileSync, writeFileSync, appendFileSync
   - existsSync, unlinkSync, renameSync, statSync
   - readdirSync, mkdirSync, rmdirSync, copyFileSync
   - Full AmigaOS path support (Volume:dir/file)

 * HTTP/HTTPS server and client
   - http.createServer() ? non-blocking, 8 concurrent
   - http.get(), http.post(), http.request()
   - HTTPS via AmiSSL (build with -DENABLE_AMISSL)
   - Automatic redirect following (301/302/307)
   - 10-second socket timeout, dns.lookup()
   - 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 types: Error, TypeError, RangeError, ReferenceError,
   SyntaxError, EvalError, URIError

 * Error messages with filename and line number

 * Compiler: bundle JS + interpreter into standalone executable
   - NodeAmiga -compile MyApp script.js
   - Automatic require() and import dependency resolution
   - All JS modules bundled into single executable
   - No NodeAmiga, no libs/ needed to run the output

Usage
-----

  NodeAmiga script.js              Execute a JavaScript file
  NodeAmiga -e "code"              Evaluate inline JavaScript
  NodeAmiga -compile out script    Compile JS to standalone executable
  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

Compile to standalone exe:

  NodeAmiga -compile Hello examples/hello.js
  Hello
  ; Runs without NodeAmiga or libs/ !

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 Proxy, generators/yield
  * await is synchronous (spin-waits on event loop)

Version History
---------------

  0.11.0 (2026-03-26) 
    - NEW: fs.readdirSync, mkdirSync, rmdirSync, copyFileSync
    - NEW: Array: reduceRight, entries, keys, values,
      findLast, findLastIndex, copyWithin
    - NEW: Object: getOwnPropertyNames, hasOwn, getPrototypeOf,
      getOwnPropertyDescriptor(s), setPrototypeOf,
      preventExtensions, isExtensible, isPrototypeOf,
      propertyIsEnumerable
    - NEW: Number.prototype.toExponential, toPrecision
    - NEW: Math: cbrt, fround, clz32, imul + constants
    - NEW: String: codePointAt, fromCodePoint, localeCompare,
      normalize, raw, replace with callback
    - NEW: encodeURI/decodeURI, encodeURIComponent/decodeURIComponent
    - NEW: console.dir (JSON-formatted output)
    - NEW: ES modules (import/export) with default, named, namespace
    - NEW: RegExp: {n}/{n,}/{n,m} quantifiers, lazy (*?/+?/??),
      non-capturing groups (?:), lookahead (?=)/(?!),
      named groups (?<name>), flags s/u/y
    - NEW: Symbol as property key, Iterator protocol
    - NEW: eval() global function
    - NEW: EvalError, URIError error types
    - NEW: Date.UTC(), getUTC*/setUTC* (15 methods)
    - NEW: Class static methods
    - NEW: Destructuring assignment without var/let/const
    - NEW: Compiler (-compile) ? bundle JS into standalone executable
    - FIX: Function.prototype.bind() partial application
    - FIX: ES module export function declarations
    - FIX: instanceof Error for all Error subtypes
    - Tests: 960+ assertions covering all features
    - FIX: String.fromCharCode, Number.isInteger/isFinite/
      isNaN/isSafeInteger now work correctly
    - FIX: Number.prototype.toString(radix) for hex/bin/oct
    - FIX: querystring.unescape percent decoding
    - Removed 68040/68060 builds (focus on 68000/68020)
    - HTTPS support via AmiSSL
    - Interactive REPL with readline and history
    - Buffer hex/base64 encoding
    - Tagged template literals
    - Promise chain fixes
	

Credits
-------

  Juen/Project R3D+Appendix+Nah-Kolor