mini_racer_rs 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 41191c7e0a6bf53c0371de7ba31f7067b3d83b0095579d6955a75a9021c4a5b0
-  data.tar.gz: 7b0424bbabd9fcd45122dc81b6b449e3c30d7ffb218ec43eff973ae4d8c70772
+  metadata.gz: aeb35a422c03ec1f8366cc6794daefa2cbacd69d8e113c0e1cb1d369a274cf07
+  data.tar.gz: e672b7b588ec4eb10e95317af8eea2a5d03aaf7340200b70c307f6a74e988606
 SHA512:
-  metadata.gz: b864cac2b4d1f3108deea75e4bc5a10de16c94ce73be5c5824f7443922a86d94f6d1ff933a1008632c971f1eafdef57a452631661bc82807799b339ff7e15ca5
-  data.tar.gz: '0391a874e20db2b91f6c1916efa0c39f05178b68e9223dc2709aeb2fa6ad6026de9bba898f8bea5f8764193df36c0291fb8af8afab738029db3ef4a537354bb4'
+  metadata.gz: 95f7422df0c8a5f74675fdcdcf9ba1d9e9c3e7278a67b1bd57a4964ee38a022570b2b968db0a3b81af8e6320b2d2bbb9d98489bdfd87b3a8f78edb5971a595f9
+  data.tar.gz: 5288702eb114fe82c194a5071e15c99f36e6d2dbfb7c6541813074b89fb774a446dd84f4198c494306401a26cfda8932a082d8904f28bd468f01cda11bc29dcd

data/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [1.0.1](https://github.com/andymai/mini_racer_rs/compare/v1.0.0...v1.0.1) (2026-10-18)
+
+
+### Performance
+
+* **engine:** build small call arguments in the runner and write primitive results directly ([#83](https://github.com/andymai/mini_racer_rs/issues/83)) ([76afcbd](https://github.com/andymai/mini_racer_rs/commit/76afcbd7bb5df36da6797b95d8dae7049ee80f53))
+
 ## 1.0.0 (2026-10-18)
 
 

data/Cargo.lock

@@ -458,7 +458,7 @@ checksum = "cf8baf1c55e62ffcace7a9f06f4bd9cd3f0c4beb022d3b367256b91b87513d98"
 
 [[package]]
 name = "mini_racer_engine"
-version = "1.0.0"
+version = "1.0.1"
 dependencies = [
  "deno_core_icudata",
  "libc",
@@ -470,7 +470,7 @@ dependencies = [
 
 [[package]]
 name = "mini_racer_rs"
-version = "1.0.0"
+version = "1.0.1"
 dependencies = [
  "magnus",
  "mini_racer_engine",
@@ -481,7 +481,7 @@ dependencies = [
 
 [[package]]
 name = "mini_racer_sync"
-version = "1.0.0"
+version = "1.0.1"
 dependencies = [
  "loom",
  "thiserror",
@@ -489,7 +489,7 @@ dependencies = [
 
 [[package]]
 name = "mini_racer_wire"
-version = "1.0.0"
+version = "1.0.1"
 dependencies = [
  "proptest",
  "thiserror",

data/Cargo.toml

@@ -14,7 +14,7 @@ license = "MIT"
 publish = false
 repository = "https://github.com/andymai/mini_racer_rs"
 rust-version = "1.91"
-version = "1.0.0"
+version = "1.0.1"
 
 [workspace.dependencies]
 deno_core_icudata = "=0.78.0"

data/README.md

@@ -17,7 +17,7 @@ A drop-in replacement for mini_racer, implemented in Rust on V8 15.2.
 
 mini_racer_rs implements the `MiniRacer` Ruby API from mini_racer 0.22.1, with faster Ruby and JavaScript round trips, V8 15.2, prebuilt native gems, fiber scheduler support, and safer handling of difficult values. It defines the `MiniRacer` namespace and ships `lib/mini_racer.rb`, so `require "mini_racer"` and ExecJS continue to work.
 
-> **Pre-release:** Nothing is published to RubyGems.org yet, and the release workflow is held. Install from the repository until the first release. mini_racer_rs is an independent project and is not affiliated with the Discourse staff who maintain mini_racer.
+> mini_racer_rs is an independent project and is not affiliated with the Discourse staff who maintain mini_racer.
 
 ## Highlights
 
@@ -46,7 +46,7 @@ The package switch is one Gemfile line:
 
 Run `bundle install`. Bundler is required because RubyGems may otherwise activate the original `mini_racer` first. Loading both gems raises a `LoadError` that names the conflict. Reverse the Gemfile change to switch back.
 
-Until the first release publishes native gems, build from a checkout as described in [CONTRIBUTING.md](CONTRIBUTING.md). Run `bin/setup`. Source builds require Rust 1.91 or newer and libclang. Once published, installing a native gem will compile nothing.
+On x86_64-linux-gnu, aarch64-linux-gnu, arm64-darwin, and x86_64-darwin, `bundle install` installs a native gem and compiles nothing. Elsewhere, the source gem builds the extension and requires Rust 1.91 or newer and libclang. To build from a checkout, follow [CONTRIBUTING.md](CONTRIBUTING.md) and run `bin/setup`.
 
 ## Quick start
 
@@ -143,8 +143,6 @@ See [COMPATIBILITY.md](COMPATIBILITY.md) for every difference.
 
 - You deploy on musl-based Linux such as Alpine. mini_racer supports it through libv8-node's musl gems, while mini_racer_rs does not install there. Neither gem supports Windows.
 
-- You need a gem from RubyGems.org today. mini_racer_rs is pre-release, while mini_racer is the established gem maintained by Discourse staff.
-
 - Download size matters more than compile time. The largest mini_racer_rs native gem is 65.6 MB because it includes extensions for three Ruby versions. The mini_racer download on x86_64 Linux is 47.1 MB, followed by compilation.
 
 ### Gems that depend on mini_racer

data/crates/mini_racer_engine/src/context.rs

@@ -8,7 +8,9 @@ use mini_racer_sync::{
     Channel, ChannelError, DispatchKind, Inherited, Interrupt, Phase, Side, TermError, ToRuby, lock,
 };
 
-use crate::control::{CallbackReply, ContextConfig, ControlBlock, Depth, JsText, Request, Wire};
+use crate::control::{
+    CallRequest, CallbackReply, ContextConfig, ControlBlock, Depth, JsText, Request, Wire,
+};
 use crate::notify::NotifyFd;
 use crate::process::fork::{self, Generation};
 use crate::process::platform::Mode;
@@ -287,16 +289,14 @@ impl ContextHandle {
         )
     }
 
-    /// `request` is the wire form `mini_racer` sends: one array holding the
-    /// function's dotted path, then its arguments.
-    pub fn call(&self, request: Vec<u8>, host: &mut impl Host) -> Result<Vec<u8>, EngineError> {
+    pub fn call(&self, request: CallRequest, host: &mut impl Host) -> Result<Vec<u8>, EngineError> {
         self.invoke(request, false, host)
     }
 
     /// `call`, then awaits a promise result, as `eval_await` does.
     pub fn call_await(
         &self,
-        request: Vec<u8>,
+        request: CallRequest,
         host: &mut impl Host,
     ) -> Result<Vec<u8>, EngineError> {
         self.invoke(request, true, host)
@@ -304,7 +304,7 @@ impl ContextHandle {
 
     fn invoke(
         &self,
-        request: Vec<u8>,
+        request: CallRequest,
         awaited: bool,
         host: &mut impl Host,
     ) -> Result<Vec<u8>, EngineError> {
@@ -784,6 +784,11 @@ fn adopt(inherited: &ControlBlock, carried: Inherited) -> Held {
     let block = Arc::new(ControlBlock::with_tasks(inherited.config.clone(), tasks));
     *lock(&block.custody) = Some(isolate);
     block.term.adopt(carried);
+    // The isolate keeps whatever termination V8 still held for it.
+    block.termination_requested.store(
+        inherited.termination_requested.load(Ordering::Acquire),
+        Ordering::Release,
+    );
     match start(&block, generation, Start::Adopted) {
         Ok(()) => Held::Block(block),
         Err(_) => orphaned(true, false),

data/crates/mini_racer_engine/src/control.rs

@@ -1,3 +1,4 @@
+use std::sync::atomic::{AtomicBool, Ordering};
 use std::sync::{Arc, Mutex, OnceLock};
 use std::time::{Duration, Instant};
 
@@ -66,6 +67,17 @@ impl From<&str> for JsText {
     }
 }
 
+/// A call in the wire form `mini_racer` sends: one array holding the
+/// function's dotted path, then its arguments.
+///
+/// `objects` and `properties` count the objects the arguments hold and their
+/// properties in all, which decide whether the runner builds the arguments.
+pub struct CallRequest {
+    pub bytes: Vec<u8>,
+    pub objects: usize,
+    pub properties: usize,
+}
+
 pub enum Request {
     Init {
         depth: Depth,
@@ -78,7 +90,7 @@ pub enum Request {
         awaited: bool,
     },
     Call {
-        request: Vec<u8>,
+        request: CallRequest,
         depth: Depth,
         awaited: bool,
     },
@@ -117,13 +129,15 @@ pub enum Request {
 pub struct IsolateTerminator {
     handle: v8::IsolateHandle,
     tasks: Arc<Tasks>,
+    requested: Arc<AtomicBool>,
 }
 
 impl IsolateTerminator {
-    pub fn new(handle: v8::IsolateHandle, tasks: &Arc<Tasks>) -> Self {
+    pub fn new(block: &ControlBlock, handle: v8::IsolateHandle) -> Self {
         Self {
             handle,
-            tasks: Arc::clone(tasks),
+            tasks: Arc::clone(&block.tasks),
+            requested: Arc::clone(&block.termination_requested),
         }
     }
 }
@@ -132,12 +146,14 @@ impl Terminator for IsolateTerminator {
     // A runner awaiting a promise sleeps until a task is due; the ring wakes
     // it to find the termination.
     fn terminate(&self) {
+        self.requested.store(true, Ordering::Release);
         self.handle.terminate_execution();
         self.tasks.ring();
     }
 
     fn cancel(&self) {
         self.handle.cancel_terminate_execution();
+        self.requested.store(false, Ordering::Release);
     }
 }
 
@@ -178,6 +194,10 @@ pub struct ControlBlock {
     // V8's foreground tasks for this context's isolate, which the runner runs
     // while awaiting a promise or pumping.
     pub tasks: Arc<Tasks>,
+    /// Set before anything asks V8 to terminate this context's script, and
+    /// cleared only once V8 has cancelled every such request, so a runner
+    /// building values itself knows when V8's own reader would stop instead.
+    pub termination_requested: Arc<AtomicBool>,
     pub phase: RunnerPhase,
     pub isolate: OnceLock<v8::IsolateHandle>,
     // The isolate a snapshot is being built in on this runner, if any.
@@ -230,6 +250,7 @@ impl ControlBlock {
             timer: Mutex::default(),
             notify: NotifyFd::default(),
             tasks: Arc::new(tasks),
+            termination_requested: Arc::default(),
             phase: RunnerPhase::default(),
             isolate: OnceLock::new(),
             building: Mutex::new(None),

data/crates/mini_racer_engine/src/lib.rs

@@ -4,6 +4,7 @@ mod error;
 mod fast_calls;
 mod notify;
 pub mod process;
+mod request;
 mod runner;
 mod serialize;
 mod snapshot;
@@ -15,6 +16,6 @@ mod spin;
 mod sys;
 
 pub use context::{ContextHandle, Host, Unparker, WaitHandle, WaitOutcome};
-pub use control::{CallbackReply, ContextConfig, JsText};
+pub use control::{CallRequest, CallbackReply, ContextConfig, JsText};
 pub use error::{EngineError, FlagError, InvalidSnapshot, JsError, JsErrorKind, TerminationCause};
 pub use snapshot::{SnapshotBlob, WeakSnapshotBlob};