feat: synthetic modules

[Sam Gammon (sgammon)]

Summary

Third revision of a dynamic ability to create synthetic JavaScript modules; the first two approaches proved brittle (bytecode hacks and an overridden JS language implementation, respectively). Instead, this approach involves forking and PR-ing up to GraalJs upstream with an actual proposed feature for JavaScript module import hooks.

Supersedes #1220.

Patch to GraalJs:

• Add ability to install custom JS module loaders oracle/graaljs#893

Changes

• GraalJs - Module import hooks
  • Add JSModuleLoaderFactory interface, which can be implemented by consumers
  • Add method to install the module-loader-factory on JSEngine
  • Add JS context option for js.module-loader-factory, which can be either "default" or "handler"
  • Honor js.module-loader-factory when active
  • Make JSRealm call into JSEngine when lazily creating a JSModuleLoader
  • Considerations for CommonJS
• Elide - Use new hooks
  • Install a "module import router" singleton when JS plugin is configured
  • Module registration and resolution (pull from v1/v2)
  • Convert compatible modules (for now, requires ProxyObject compat)
    • node:assert
    • node:path
    • node:os
    • node:zlib

Changelog

feat(graalvm-js): add new `graalvm-js` module for graaljs integration
feat(graalvm-js): initial structure and api for elide's import router
feat(graalvm-js): implement commonjs module loading support
feat(graalvm-js): implement esm module loading support
feat(graalvm-ts): move js realm patcher to `graalvm-js` module
feat(graalvm-ts): use new delegated module facilities
feat(graalvm): initialize javascript when plugin is added
feat(graalvm): enable `node:assert` for injection
feat(graalvm): enable `node:path` for injection
feat(graalvm): enable `node:zlib` for injection
feat(graalvm): enable `node:os` for injection
chore: reintroduce graalvm/graaljs modules and pins
chore: mark js realm patcher as deprecated
test: add test scripts for node paths

[codecov]

Codecov Report

Attention: Patch coverage is 17.44792% with 317 lines in your changes missing coverage. Please review.

Project coverage is 52.17%. Comparing base (64d9c28) to head (d06cae3).
Report is 4 commits behind head on main.

Files with missing lines	Patch %	Lines
...me/lang/javascript/ElideUniversalJsModuleLoader.kt	0.00%	216 Missing and 2 partials ⚠️
...main/kotlin/elide/runtime/gvm/loader/ModuleInfo.kt	0.00%	19 Missing ⚠️
...elide/runtime/lang/javascript/SyntheticJSModule.kt	0.00%	18 Missing ⚠️
.../kotlin/elide/runtime/gvm/loader/ModuleRegistry.kt	0.00%	14 Missing ⚠️
...ide/runtime/lang/javascript/ElideJsModuleRouter.kt	0.00%	11 Missing ⚠️
...e/lang/javascript/DelegatedModuleLoaderRegistry.kt	0.00%	10 Missing ⚠️
...ain/kotlin/elide/runtime/node/fs/NodeFilesystem.kt	33.33%	6 Missing ⚠️
...in/kotlin/elide/runtime/node/asserts/NodeAssert.kt	81.48%	5 Missing ⚠️
.../elide/runtime/lang/javascript/JSRealmPatcher.java	0.00%	3 Missing ⚠️
...de/runtime/lang/javascript/JavaScriptExtensions.kt	0.00%	3 Missing ⚠️
... and 6 more

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1227      +/-   ##
==========================================
- Coverage   53.16%   52.17%   -1.00%     
==========================================
  Files         429      435       +6     
  Lines       17244    17531     +287     
  Branches     3125     3136      +11     
==========================================
- Hits         9168     9147      -21     
- Misses       7058     7354     +296     
- Partials     1018     1030      +12     

Flag	Coverage Δ
jvm	52.17% <17.44%> (-1.00%)	⬇️
lib	52.17% <17.44%> (-1.00%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Files with missing lines	Coverage Δ
...in/elide/runtime/plugins/AbstractLanguageConfig.kt	0.00% <ø> (ø)
...main/kotlin/elide/runtime/plugins/python/Python.kt	78.26% <ø> (ø)
...elide/runtime/gvm/internals/vfs/AbstractBaseVFS.kt	79.59% <100.00%> (ø)
...e/runtime/gvm/internals/vfs/AbstractDelegateVFS.kt	66.91% <ø> (ø)
.../runtime/gvm/internals/vfs/EmbeddedGuestVFSImpl.kt	68.94% <100.00%> (-1.62%)	⬇️
...tlin/elide/runtime/intrinsics/js/node/AssertAPI.kt	40.74% <ø> (-2.12%)	⬇️
...lide/runtime/node/childProcess/NodeChildProcess.kt	65.40% <100.00%> (-0.08%)	⬇️
...otlin/elide/runtime/node/os/NodeOperatingSystem.kt	84.52% <100.00%> (-0.68%)	⬇️
...rc/main/kotlin/elide/runtime/node/zlib/NodeZlib.kt	74.62% <100.00%> (-0.22%)	⬇️
...main/kotlin/elide/runtime/plugins/js/JavaScript.kt	85.59% <100.00%> (-7.54%)	⬇️
... and 16 more

... and 2 files with indirect coverage changes

---

Continue to review full report in Codecov by Sentry.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 64d9c28...d06cae3. Read the comment docs.