rusty_racer 0.2.3 → 0.2.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9a799692e0bcc6c18bbba590786cd92b0f3cd5c05c65be4da085ec3a739ae2ee
-  data.tar.gz: 0ca41e25987f9f721437abbfc1278c43d7aa688c996a1824cb342d4b1672ed70
+  metadata.gz: 488967c6324cc118d0cf37974c23566725c7c6ce14ba48572330075d1b2dff66
+  data.tar.gz: 48f562d20d1217e91a9727d1fa348312c51c49b9f82607f3bd2803247e76976c
 SHA512:
-  metadata.gz: c63a41df38fbacdfc440a4bb61ff8f780315d2ce267a55d698505a7601557ba76a3762896dd12a4989aaf34d27ba2a7eb9c751a7249e7a71ae572a37d5af6133
-  data.tar.gz: e8deb0c3a86b25577996ee84d15f2163f6a2a8eab952d3c8592e4513f6e2cb483f3734ec7947dff22bad19cea9c5239284edd910473058baea5761921c510b8f
+  metadata.gz: faad4323b59c0eca2d69f66bb9698a41ab5837c0f417710b0f125ca39c0fad22e3d399f8fe730bd2c526a1e9cfe34ad9b8c8be5fdbc47b5c8a6e860eb23308f7
+  data.tar.gz: 304a7388700465fcfc86a8e7ffeba87c9bd95455075bce889277abe44193f8f407326a136cfe0be39738d53061603d249f153f031866c9570bddec424ac5b807

data/README.md

@@ -93,6 +93,8 @@ ran to completion. When the value is incidental, say so: `#eval_void`,
 result. A statement list has a completion value whether you want one or not, so
 plumbing an object into a global (`globalThis.win = someProxy`) is enough to
 make a plain `#eval` fail after every one of its writes has landed.
+`#eval_primitive` sits between the two: it returns the completion value only
+where it is a primitive, and nil for an object or a symbol, which it never reads.
 
 ES modules (the embedder owns the URL→module registry):
 
@@ -114,6 +116,12 @@ loop here (see below), a `true` graph whose `await` never settles returns from
 `evaluate` with the module body still suspended, and `status` reports
 `:evaluated` either way — so `graph_async?` is what distinguishes the two.
 
+A rejected evaluation — a top-level throw, or a top-level `await` that rejects —
+raises from `evaluate`. Pass `report:` the name of a function on the context's
+global to have it called with the reason instead (HTML's "report the
+exception"), at once for a throw and as it settles for an `await`:
+`app.evaluate(report: "reportError")`.
+
 Classic `<script>`s work the same way: `ctx.compile("1 + 1").run` # => 2.
 
 ### Resource limits
@@ -203,6 +211,12 @@ Also available:
   `microtasks: :auto` also drains at the end of each outermost eval/call/evaluate;
   `microtasks: :explicit` leaves it fully manual. There is no event loop or timers
   either way.
+- **`Isolate#pump_message_loop`** — runs the tasks V8 posts instead of running
+  inline, most visibly `FinalizationRegistry` cleanup callbacks: a microtask
+  checkpoint never runs them, so without a pump a collected target's callback
+  never fires. It drains every pending task without blocking, then a microtask
+  checkpoint; with nothing pending it is a no-op. The callbacks are ordinary JS,
+  so the pump is capped by `timeout_ms` like an `eval`.
 - **`Isolate#terminate`**, **`Isolate#dynamic_import_resolver=`**,
   **`Context#reset`** (below), and **`Platform.set_flags!`**.
 
@@ -217,7 +231,10 @@ warm isolate — a per-visit reset that avoids rebuilding the VM. Its contract:
   (or to an empty realm, with no snapshot).
 - **Runtime mutations are dropped.** Anything set on the realm at runtime is gone.
 - **Host fns are dropped.** Functions `attach`/`attach_many`'d into the realm are
-  released (their GC roots freed); re-attach them after a reset.
+  released — the isolate stops holding them, so whatever they captured becomes
+  collectable; re-attach them after a reset. One the embedder kept hold of (through
+  another realm, say) throws `unknown host function` when called; it never runs
+  what was attached after it.
 - **Modules and classic scripts are dropped.** Handles compiled in the realm die
   with the old context.
 - **The realm id and the shared same-origin token are preserved** — the id keeps

data/ext/rusty_racer/Cargo.toml

@@ -5,12 +5,16 @@
 # links and loads with no custom archive.
 [package]
 name = "rusty_racer"
-version = "0.2.3"
+version = "0.2.5"
 edition = "2024"
 publish = false
 
+# cdylib: the standalone gem extension (.so Ruby loads directly).
+# lib (rlib): lets an embedder link rusty_racer as a Rust library and build its
+# own cdylib — capybara-simulated links rusty_racer + a native DOM into one
+# extension and calls rusty_racer::install_classes from its own magnus init.
 [lib]
-crate-type = ["cdylib"]
+crate-type = ["lib", "cdylib"]
 
 [dependencies]
 # rb-sys: exposes magnus::rb_sys (protect — catch a Ruby raise from a host