mini_racer-csim 0.21.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 8c0d4cbd8123f6177c8411ad1d9e32ff4e8a1a0de0515eb5f030672dd11f3f44
+  data.tar.gz: faba5c80bf42ca1638d37c20f5f7849cd406e10fe5f00bc926fd696824237cdf
+SHA512:
+  metadata.gz: c0d8f9dcc469cd52b999e31e2c677a205aabe343804b70990a7978b2302d2df505c595a38b5de1db16e70358fabea42c950f2ff3b2509f9a94f87f178b0df229
+  data.tar.gz: 5dc7c4ff2147e0a8815eb63d024350db82b2eaade805bb8c5d4834deff7a950a8f44b73cb9d3943f948ce1fda51c82aba464f2384a4e333c5bcfbabad5f6ca6c

data/CHANGELOG

@@ -0,0 +1,351 @@
+- (Unreleased)
+  - Add `Context#perform_microtask_checkpoint` to synchronously drain the V8 microtask queue, useful for spec-compliant `dispatchEvent` sequencing inside Ruby callbacks
+  - Expose V8 ScriptCompiler::CachedData via Context#compile / MiniRacer::Script (#411)
+    - script = ctx.compile(src, filename:, cached_data:, produce_cache:) → Script handle
+    - script.run replays compiled bytecode without re-parsing
+    - script.cached_data persists V8's per-script bytecode cache when produce_cache: true
+    - script.cache_rejected? reports source/version mismatches
+    - MiniRacer::V8_CACHED_DATA_VERSION_TAG for cache-key invalidation
+    - produce_cache defaults to false; passing true from inside a host-fn callback raises (V8's CreateCodeCache corrupts parser state when re-entered, so warm the cache from the top level)
+    - Cross-process reuse requires both processes to load byte-identical snapshot data via Snapshot#dump / Snapshot.load (Snapshot.new(src) is non-deterministic) and is incompatible with Platform.set_flags!(:single_threaded) (V8 embeds per-process state in the blob under single-threaded mode)
+    - TruffleRuby shim falls back to source replay (no equivalent in GraalJS)
+  - Add ES module API via `Context#compile_module` / `MiniRacer::Module` (#421): `compile_module(source, filename:)` returns a Module handle bound to the Context (and exposes `filename` to the module as `import.meta.url`); `Module#instantiate { |specifier, referrer_url| ... }` walks static imports via a Ruby-side resolver block (the referrer URL is the importing module's filename, so relative specifiers can be resolved); `Module#evaluate` runs the module body; `Module#namespace` returns the Module Namespace Object as a Hash; `Module#status` exposes V8's lifecycle state; `Module#dispose` / `Module#disposed?` mirror `Script`'s eager handle release. `Context#dynamic_import_resolver=` handles JS `import(...)` expressions (resolver receives specifier + referrer URL, returns a `MiniRacer::Module`; the loaded module is evaluated if pending). Top-level await is not supported in this round (evaluate raises if the evaluation promise stays pending). The TruffleRuby shim raises `NotImplementedError`.
+  - Add an opt-in JavaScript host namespace via `Context.new(host_namespace:)` (à la Deno's `Deno`/Bun's `Bun`); when enabled it exposes `<namespace>.drainMicrotasks()`, an inline (no Ruby round-trip) microtask checkpoint for draining between synchronous JS operations
+
+- 0.21.1 - 25-05-2026
+  - Run `:single_threaded` V8 dispatches on a reusable mini_racer-owned native thread so V8 does not execute on Ruby-owned threads
+  - Stop and join the reusable `:single_threaded` runner when contexts are disposed
+  - Document `:single_threaded` fork-safety requirements for pre-fork contexts
+
+- 0.21.0 - 16-04-2026
+  - Add MiniRacer::Binary for returning Uint8Array to JavaScript from attached Ruby callbacks
+
+- 0.20.0 - 24-02-2026
+  - Add Snapshot.load to restore snapshots from binary data, enabling disk persistence
+
+- 0.19.2 - 24-12-2025
+  - upgrade to node 24.12.0
+
+- 0.19.1 - 20-10-2025
+  - JS code can now catch ruby exceptions - Ben Noordhuis
+  - Retain string encoding when raising exceptions - Ben Noordhuis
+  - Fix object identity bug with Ruby to JS conversion - Benjamin Wood
+
+- 0.19.0 - 24-06-2025
+  - upgrade to node 24.1.0 
+
+- 0.18.1 - 03-04-2025
+  - Convert round doubles to fixnum for very big floats - this has better parity with JavaScript - Ben Noorhuis
+
+- 0.18.0 - 05-03-2025
+  - Time for a major release
+  - Handle ActiveSupport TimeWithZone objects during serialization - Sam Saffron
+
+- 0.18.0.pre1 - 06-02-2025
+  - Updated to node 23.6.1.0 
+
+- 0.17.0.pre13 - 04-02-2025
+  - Only issue idle GC once post dispatch - reduces CPU usage for auto cleanup - Sam Saffron
+
+- 0.17.0.pre12 - 23-01-2025
+  - Corrected off-by-one error with object serialization - Ben Noordhuis
+
+- 0.17.0.pre11 - 21-01-2025
+  - Corrected encoding bug with deserialization of strings - Ben Noordhuis
+
+- 0.17.0.pre10 - 20-01-2025
+  - Added back support for partially deserialized objects (objects that do not translate across boundaries are returned as Error properties) - Ben Noordhuis
+
+- 0.17.0.pre9 - 13-01-2025
+  - For backwards compatibility convert v8 return values to UTF-8 (invalidly encoded string still get returned using V8 encoding)
+
+- 0.17.0.pre8 - 11-01-2025
+  - Fix handling of UTF 32 LE and Ascii encoding strings - Ben Noordhuis
+  - Handle rare edge case in V8 serialization - Ben Noordhuis
+
+- 0.17.0.pre7 - 10-01-2025
+
+  - Objects containing non serializable properties will return an Error object vs raising an exception. Ben Noordhuis
+  - Truffle support was added back Eregon
+
+- 0.17.0.pre6 - 08-01-2025
+
+  - Moved all mini_racer interaction with v8 to a dedicated native thread to avoid cross VM stack contamination. Ben Noordhuis
+
+- 0.17.0.pre5 - 30-09-2024
+
+  - Handle segfault from JSON.stringify
+  - Fix segfaults around symbol conversion
+  - Fix crash on invalid date object
+
+
+- 0.17.0.pre4 - 18-09-2024
+
+  - Attempt to change compilation flags to disable strict aliasing to see if it resolves stability issues
+
+- 0.17.0.pre3 - 15-09-2024
+
+  - Text clang based Linux v8 build, in case there is an edge case with GCC compilation
+
+- 0.17.0.pre2 - 09-09-2024
+
+  - Test build to see if disabling Maglev optimisations resolves segfault issues
+
+- 0.17.0.pre - 05-09-2024
+
+  - Test build to see if disabling concurrent GC marking resolves segfault
+
+- 0.16.0 - 05-09-2024
+
+  - Sadly still seeing segfaults, reverted back 18.19.0.0
+
+- 0.15.0 - 05-09-2024
+
+  - Use libv8-node 22.7.0 - this corrects issues with multithreaded behavior and forking in single threaded mode.
+
+- 0.14.1 - 14-08-2024
+
+  - No longer use mini_racer_loader if LD_PRELOAD is defined and adds a malloc provider. This resolves segfaults when people LD_PRELOAD jemalloc or tcmalloc.
+
+- 0.14.0 - 06-08-2024
+
+  - Node 22.5.1.0 is not stable in production, reverting to last known good build
+
+- 0.13.0 - 29-07-2024
+
+  - Target Node to 22.5.1.0 0 - corrects segfault in earlier release
+  - Remove Ruby 3.0 which is EOL (use ealier version of gem if needed)
+
+- 0.9.0 - 25-03-2024
+
+  - Target Node to 18.19.0.0
+
+- 0.8.0 - 29-05-2023
+
+  - Target Node to 18.16.0.0
+  - Drop supporting EOL'd Ruby 2.7
+
+- 0.7.0 - 26-05-2023
+
+  - Target Node to 17.9.1.0
+
+- 0.6.4 - 25-05-2022
+
+  - Target Node 16.19.0.0
+
+- 0.6.3 - 16-08-2022
+
+  - Truffle ruby support! Thanks to Brandon Fish and the truffle team
+  - Hide libv8 symbols on ELF targets
+  - Slightly shrunk binary size
+  - Simplified timeout implementation
+  - Some stability fixes
+
+- 17-01-2022 - 0.6.2
+
+  - Fix support for compilation on 2.6, llvm compiles
+  - Stability patches to handle rare memory leaks
+  - Corrected re-raising of exceptions to support strings
+  - During early termination of context under certain conditions MiniRacer could crash
+
+- 0.6.1 - 31-12-2021
+
+  - Added support for single threaded platform: `MiniRacer::Platform.set_flags! :single_threaded`
+  must be called prior to booting ANY MiniRacer::Context
+
+- 0.6.0 - 11-04-2021
+
+  - Ruby 3.1 support
+  - Fixes memory leak in heap snapshotting
+  - Improved compilation ergonomics in clang
+  - Migrated internal storage in c extension to TypedData
+
+
+- 0.5.0
+
+  - Fixes issues on aarch (Apple M1)
+  - Update to use libv8-node 16.x (#210) [Loic Nageleisen]
+  - FEATURE: Configurable max marshal stack depth (#202) [seanmakesgames]
+  - Ruby 2.3 and 2.4 are EOL, we no longer support them
+
+- 0.4.0 - 08-04-2021
+
+  - FEATURE: upgrade to libv8 node 15.14.0 (v8 8.6.395.17)
+  - Promote 0.4.0.beta1 to release, using libv8-node release path
+
+
+- 0.4.0.beta1 - 23-07-2020
+
+  - FIX: on downgrade mkmf was picking the wrong version of libv8, this fix will correct future issues
+  - FEATURE: upgraded libv8 to use node libv8 build which supports M1 and various ARM builds v8 moved to (8.6.395.17)
+
+
+- 0.3.1 - 22-07-2020
+
+  - FIX: specify that libv8 must be larger than 8.4.255 but smaller than 8.5, this avoids issues going forward
+
+- 0.3.0 - 29-06-2020
+
+  - FEATURE: upgraded to libv8 version 8.4.255.0
+
+
+- 0.2.15 - 15-05-2020
+
+  - FEATURE: basic wasm support via pump_message_loop
+
+
+- 0.2.14 - 15-05-2020
+
+  - FIX: ensure_gc_after_idle should take in milliseconds like the rest of the APIs not seconds
+  - FEATURE: strict params on MiniRacer::Context.new
+
+
+- 0.2.13 - 15-05-2020
+
+  - FIX: edge case around ensure_gc_after_idle possibly firing when context is not idle
+
+
+- 0.2.12 - 14-05-2020
+
+  - FEATURE: isolate.low_memory_notification which can force a full GC
+  - FEATURE: MiniRacer::Context.new(ensure_gc_after_idle: 2) - to force full GC 2 seconds after context is idle, this allows you to conserve memory on isolates
+
+
+- 0.2.11
+
+  - FIX: dumping heap snapshots was not flushing the file leading to corrupt snapshots
+  - FIX: a use-after-free shutdown crash
+
+- 0.2.10 - 22-04-2020
+  - FEATURE: memory softlimit support for nogvl_context_call
+
+- 0.2.9 - 09-01-2020
+
+  - FIX: correct segfault when JS returns a Symbol and properly cast to ruby symbol
+
+- 0.2.8 - 11-11-2019
+
+
+  - FIX: ensure thread live cycle is properly accounter for following file descriptor fix
+
+- 0.2.7 - 11-11-2019
+
+  - FIX: release the file descriptor for timeout pipe earlier (this avoids holding too many files open in Ruby 2.7)
+
+- 0.2.6 - 14-05-2019
+
+  - FEATURE: add support for write_heap_snapshot which helps you analyze memory
+
+- 0.2.5 - 25-04-2019
+
+  - FIX: Compatibility fixes for V8 7 and above @ignisf
+  - FIX: Memory leak in gc_callback @messense
+  - IMPROVEMENT: Added example of sourcemap support @ianks
+  - URGENT: you will need this release for latest version of libv8 to work
+
+- 0.2.4 - 02-11-2018
+
+  - FIX: deadlock releasing context when shared isolates are used
+  - FEATURE: include js backtrace when snapshots do not compile
+
+- 0.2.3 - 28-09-2018
+
+  - Drop all conditional logic from Mini Racer compilation for clang, always
+    rely on MacOS being High Sierra or up
+
+- 0.2.2 - 26-09-2018
+
+  - WORKAROUND: RUBY_PLATFORM is hardcoded on Ruby compile and can not be
+    trusted for feature detection, use a different technique when checking for
+    macOS Mojave
+
+- 0.2.1 - 25-09-2018
+
+  - FEATURE: Mojave macOS support
+
+- 0.2.0 - 06-07-2018
+
+  - FEATURE: context#call to allow for cheaper invocation of functions
+  - FIX: rare memory leak when terminating a long running attached function
+  - FIX: rare segfault when terminating a long running attached function
+  - FIX: Reimplement Isolate#idle_notification using idle_notification_deadline, API remains the same @ignisf
+  - Account for changes in the upstream V8 API @ignisf
+  - Support for libv8 6.7
+
+- 0.1.15 - 23-08-2017
+
+  - bump dependency of libv8 to 6.3
+
+- 0.1.14 - 23-08-2017
+
+  - libv8 erroneously bumped to beta, reverted change
+
+- 0.1.13 - 23-08-2017
+
+  - Fix: amend array buffer allocator to use v8 6.0 compatible allocator @ignisf
+
+- 0.1.12 - 18-07-2017
+
+  - Feature: upgrade libv8 to 5.9
+  - Fix: warning when running with ruby warnings enabled (missed @disposed initialize)
+
+- 0.1.11 - 18-07-2017
+
+  - Feature: upgrade libv8 to 5.7
+
+
+- 0.1.10 - 13-07-2017
+
+  - Fix leak: memory leak when disposing a context (20 bytes per context)
+  - Feature: added #heap_stats so you can get visibility from context to actual memory usage of isolate
+  - Feature: added #dispose so you reclaim all v8 memory right away as opposed to waiting for GC
+  - Feature: you can now specify filename in an eval eg: eval('a = 1', filename: 'my_awesome.js')
+
+
+- 0.1.9 - 09-03-2017
+
+  - Perf: speed up ruby/node boundary performance when moving large objects
+
+- 0.1.8 - 06-02-2017
+
+  - Fix: Include math.h to fix use of undeclared identifier floor with rbx. See #51
+
+- 0.1.7 - 02-11-2016
+
+  - Fix: if for some reason an isolate was forked don't free it and raise a warning instead to avoid hanging process
+
+- 0.1.6 - 25-10-2016
+
+  - Fix: timeout behavior was incorrect, in some cases stop could be called on already stopped contexts
+
+- 0.1.5 - 10-10-2016
+
+  - Support for snapshots, shared isolates, runtime flags thanks to @wk8
+  - Fix timeout behavior when it occurs in an attached Ruby method
+
+- 0.1.4 - 19-05-2016
+
+  - Set upper bound for libv8 inclusion @ignisf
+  - Support conversion of Date, Time and DateTime from Ruby to JS @seanmakesgames
+  - Support conversion of large numbers back from Ruby to JS @seanmakesgames
+
+- 0.1.3 - 17-05-2016
+
+  - Support more conversions from Ruby back to JS (Hash, Symbol, Array)
+  - Support attaching nested objects
+
+
+- 0.1.2 - 17-05-2016
+
+  - Gemspec specifies minimal version of Ruby (2.0)
+  - Implement #load on Context to load files
+
+
+- 0.1.1
+
+  - Added unblock function so SIGINT does not lead to a crash
+
+
+- 0.1.1.beta.1 - 14-05-2016
+
+  - First release

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,49 @@
+# Contributor Code of Conduct
+
+As contributors and maintainers of this project, and in the interest of
+fostering an open and welcoming community, we pledge to respect all people who
+contribute through reporting issues, posting feature requests, updating
+documentation, submitting pull requests or patches, and other activities.
+
+We are committed to making participation in this project a harassment-free
+experience for everyone, regardless of level of experience, gender, gender
+identity and expression, sexual orientation, disability, personal appearance,
+body size, race, ethnicity, age, religion, or nationality.
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery
+* Personal attacks
+* Trolling or insulting/derogatory comments
+* Public or private harassment
+* Publishing other's private information, such as physical or electronic
+  addresses, without explicit permission
+* Other unethical or unprofessional conduct
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+By adopting this Code of Conduct, project maintainers commit themselves to
+fairly and consistently applying these principles to every aspect of managing
+this project. Project maintainers who do not follow or enforce the Code of
+Conduct may be permanently removed from the project team.
+
+This code of conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community.
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting a project maintainer at sam.saffron@gmail.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. Maintainers are
+obligated to maintain confidentiality with regard to the reporter of an
+incident.
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 1.3.0, available at
+[http://contributor-covenant.org/version/1/3/0/][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/3/0/

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2016-2019, the mini_racer project authors.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.