Low-level Nim bindings for JavaScriptCore, Apple's JavaScript engine.

C names are preserved verbatim so upstream code stays greppable. Uses the JavaScriptCore framework on macOS.

Basic example:

import javascriptcore

withGlobalContext(ctx):
  var ex: JSValueRef = nil
  let res = evalScript(ctx, "1 + 2", exception = ex)
  assert ex == nil
  var ex2: JSValueRef = nil
  assert JSValueToNumber(ctx, res, addr ex2) == 3.0

The raw API (JSEvaluateScript, JSObjectMakeFunctionWithCallback, ...) returns exactly what C returns, including nil on failure: always check the exception out-param. helpers adds newJSString, $, evalScript and withGlobalContext on top.

Define jscStatic (or jscNoPkgConfig) to skip the automatic link flags and supply your own. Define jscStaticLib with the path to a custom static libjavascriptcore archive to link it directly (jscIncludeDir optionally points at its headers).