Update javy and add the quickjs4j-redline-experimental module

Readme.md

@@ -211,6 +211,19 @@ engine.eval("function add(a, b) { return a + b; }");
 
 See the full [JSR-223 scripting documentation](scripting/README.md) for details on bindings, `Compilable`, `Invocable` (`invokeFunction`, `invokeMethod`, `getInterface`), output redirection, and more.
 
+## Native Execution (Experimental)
+
+By default QuickJs4J runs on JVM bytecode. To run it on native code instead, compiled with the experimental [Endive Redline](https://endive.run/docs/experimental/redline) compiler, add:
+
+```xml
+<dependency>
+    <groupId>io.roastedroot</groupId>
+    <artifactId>quickjs4j-redline-experimental</artifactId>
+</dependency>
+```
+
+No code changes are needed. Native code is used on Linux, macOS and Windows (x86_64 and aarch64), with Panama FFM on Java 25+ and jffi on older JDKs. On other platforms, or when a custom memory factory is set with `Engine.builder().withMemoryFactory(...)`, the default bytecode is used.
+
 ## Building a JS/TS Library
 
 To build your JavaScript/TypeScript library, refer to [this example](it/src/it/apicurio-example/src/main/resources/library).

core/pom.xml

@@ -69,6 +69,18 @@
           </execution>
         </executions>
       </plugin>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-jar-plugin</artifactId>
+        <executions>
+          <execution>
+            <!-- the tests are re-run by quickjs4j-redline-experimental -->
+            <goals>
+              <goal>test-jar</goal>
+            </goals>
+          </execution>
+        </executions>
+      </plugin>
 
       <plugin>
         <groupId>org.codehaus.mojo</groupId>

core/src/main/java/io/roastedroot/quickjs4j/core/Engine.java

@@ -11,6 +11,7 @@
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
+import java.util.ServiceLoader;
 import java.util.function.Function;
 import run.endive.log.Logger;
 import run.endive.log.SystemLogger;
@@ -100,9 +101,7 @@ private Engine(
                         });
         this.invokables = invokables;
         instance =
-                Instance.builder(JavyPluginModule.load())
-                        .withMemoryFactory(memoryFactory)
-                        .withMachineFactory(JavyPluginModule::create)
+                instanceBuilder(memoryFactory)
                         .withImportValues(
                                 ImportValues.builder()
                                         .addFunction(wasi.toHostFunctions())
@@ -113,6 +112,23 @@ private Engine(
         exports.initializeRuntime();
     }
 
+    // a custom memory factory can only be honored by the default instance
+    private static Instance.Builder instanceBuilder(Function<MemoryLimits, Memory> memoryFactory) {
+        if (memoryFactory == null) {
+            for (var provider :
+                    ServiceLoader.load(
+                            InstanceBuilderProvider.class, Engine.class.getClassLoader())) {
+                var builder = provider.builder();
+                if (builder.isPresent()) {
+                    return builder.get();
+                }
+            }
+        }
+        return Instance.builder(JavyPluginModule.load())
+                .withMemoryFactory(memoryFactory == null ? ByteArrayMemory::new : memoryFactory)
+                .withMachineFactory(JavyPluginModule::create);
+    }
+
     private String readJavyString(int ptr, int len) {
         var bytes = instance.memory().readBytes(ptr, len);
         return new String(bytes, UTF_8);
@@ -598,9 +614,6 @@ public Engine build() {
             if (mapper == null) {
                 mapper = DEFAULT_OBJECT_MAPPER;
             }
-            if (memoryFactory == null) {
-                memoryFactory = ByteArrayMemory::new;
-            }
             Map<String, Builtins> finalBuiltins = new HashMap<>();
             // TODO: any validation to be done here?
             for (var builtin : builtins) {

core/src/main/java/io/roastedroot/quickjs4j/core/InstanceBuilderProvider.java

@@ -0,0 +1,15 @@
+package io.roastedroot.quickjs4j.core;
+
+import java.util.Optional;
+import run.endive.runtime.Instance;
+
+/**
+ * Service loaded by {@link Engine} to replace the default, build time compiled, javy plugin
+ * instance (e.g. with a native one from quickjs4j-redline-experimental).
+ */
+public interface InstanceBuilderProvider {
+    /**
+     * @return a builder for the javy plugin module, or empty when not supported on this platform
+     */
+    Optional<Instance.Builder> builder();
+}