rusty_racer 0.1.0 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 724aca7618b9458b51912665ca47d521dfde28b7c1aa96ebb053206919cc4cec
-  data.tar.gz: ba40ef90042ceec6fecc771f0c02ec4c3e241c2abf2881a77ab78d9b05bde4f7
+  metadata.gz: b0b742605170382bce639eaa6c8acd1917f6ed4e6f8a5d4f83d40701ffb14b25
+  data.tar.gz: ce873858c2a28e9903ca9abec1cc72e061f3561f1cf2c8d5b0ff3694d613ec55
 SHA512:
-  metadata.gz: 82c58b671e6080fd000bab244a6144a44d9112ab30b2d23ea81e1cf9ea4fa6ee74a18a2e21e636b6d32267aeb6f5502e0c7cf6002f503d27aa7d46be201d0b78
-  data.tar.gz: 89773bf8f89d17192c17114518a7eb8e9a6dd041b1b0e3e3ac52d8c2cc274f2b9a9e5aa1d59a4a39c1f15cdeb304ab851055efd65bab21c9ce859acdf12c9549
+  metadata.gz: 1e3960b00b14c62813d731ee85c8f41cca8f04a0ff7657446f205dda2f24c5e11fd07b00da000b1d7be503bb00f083cf389f3736fac8d6344343a6ec26a3a11e
+  data.tar.gz: 3ee0d6217b064b70362a7e2475e5db840a0b613922f91a418d3548464066ea1824d1c073870e5d9d6da4cdc351fa481e490d667520123675f2b7d730a926d23e

data/README.md

@@ -9,6 +9,34 @@ Embed [V8](https://v8.dev/) in Ruby, built on [rusty_v8](https://crates.io/crate
 > is **thread-confined**: every operation must happen on that owner thread, or it
 > raises. `Isolate#terminate` is the exception — it is safe from any thread.
 
+## Highlights
+
+- **ES modules**, including dynamic `import()` with an embedder-owned resolver —
+  not just classic scripts.
+- **Faithful value marshalling**: `BigInt`, `Date`, `Map`, `Set`, typed binary
+  (`Uint8Array`/`ArrayBuffer` ↔ binary `String`), and shared/cyclic object
+  graphs all round-trip — no lossy JSON hop.
+- **In-thread execution** — V8 runs on the calling Ruby thread, with no dedicated
+  V8 thread and no per-op thread hop; fast when you run many small ops.
+- **Drop-in [ExecJS](#execjs) runtime** — any ExecJS consumer switches with no
+  code change.
+- **Snapshots, realms (`Context`s), host callbacks, and a bytecode cache.**
+- **Precompiled gems** bundle V8 for Linux/macOS × Ruby 3.3–4.0 — no V8 build,
+  no Rust toolchain.
+
+### Compared to mini_racer
+
+[mini_racer](https://github.com/rubyjs/mini_racer) is the mature, widely-deployed
+incumbent — if you want a battle-tested binding or **Windows** support, reach for
+it. rusty_racer differs where it counts for some workloads: native **ES modules +
+dynamic import** (mini_racer is eval/classic-script oriented); **richer
+marshalling** (the types above round-trip natively instead of through a
+JSON-shaped projection); and **in-thread execution** with no per-op thread hop,
+which is faster for overhead-dominated workloads (lots of tiny `eval`/`call`) and
+at parity once the per-op JS work dominates. It is also younger and
+**experimental** — fewer miles, no Windows yet, no per-isolate memory cap. Parity
+with mini_racer is not a goal; the overlap is convergent evolution, not a port.
+
 ## What it can do
 
 Names follow V8's: an `Isolate` is the VM; it hands out `Context`s (v8::Context,
@@ -122,6 +150,28 @@ warm isolate — a per-visit reset that avoids rebuilding the VM. Its contract:
   suspended on the V8 stack (e.g. resetting a realm from inside one of its own
   host fns).
 
+## ExecJS
+
+rusty_racer ships an optional [ExecJS](https://github.com/rails/execjs) runtime,
+so any ExecJS consumer (asset pipelines, CoffeeScript/Babel/Uglify wrappers, …)
+can run on V8-in-Ruby with no code change:
+
+```ruby
+require "rusty_racer/execjs"
+ExecJS.runtime = RustyRacer::ExecJSRuntime.new
+
+ExecJS.eval("'foo bar'.toUpperCase()")   # => "FOO BAR"
+ctx = ExecJS.compile("function add(a, b) { return a + b }")
+ctx.call("add", 1, 2)                     # => 3
+```
+
+The adapter is **opt-in** — `rusty_racer` never requires `execjs` itself, so it
+stays a non-dependency; `require "rusty_racer/execjs"` pulls it in only when you
+ask. Values cross with ExecJS's JSON semantics (functions and `undefined` drop
+out, Dates become ISO strings), matching what ExecJS's external runtimes give, so
+results are identical whatever runtime a library picked. The integration is
+verified against ExecJS's own runtime contract suite (`test/execjs_test.rb`).
+
 ## Threading
 
 An `Isolate` runs V8 **in-thread** on the Ruby thread that created it, and is

data/ext/rusty_racer/Cargo.toml

@@ -4,7 +4,7 @@
 # libv8-rusty needed under the cibuildgem native-per-platform model).
 [package]
 name = "rusty_racer"
-version = "0.1.0"
+version = "0.1.2"
 edition = "2021"
 publish = false
 
@@ -17,7 +17,12 @@ crate-type = ["cdylib"]
 # to root the owner thread).
 magnus = { version = "0.8", features = ["rb-sys"] }
 rb-sys = "0.9"
-v8 = "150.0.0"
+# simdutf: SIMD-accelerated UTF-8/UTF-16 transcoding in rusty_v8's String
+# conversion (to_rust_string_lossy etc.), the path every V8->Ruby string crosses.
+# ~6-8x faster marshalling for non-ASCII results (measured); ASCII is unaffected.
+# Needs the linked archive built with rusty_v8_enable_simdutf=true (libv8-rusty.yml
+# for linux; the v8 crate auto-fetches Deno's _simdutf prebuilt on macOS).
+v8 = { version = "150.0.0", features = ["simdutf"] }
 # pthread stack-bounds query, to set V8's stack limit per op relative to the
 # current native thread (in-thread V8 runs on the Ruby thread's stack).
 libc = "0.2"