JsModuleBundle class

A set of ES modules compiled to QuickJS bytecode ahead of time.

Loading modules from source makes QuickJS call the module loader for every import, which is synchronous in the engine. A bundle resolves the whole import graph once, at build time: install registers every module in the context first, so evaluating the entry links against modules that are already there and the loader is never called.

final bundle = JsModuleBundle.compileSources(
  entry: 'main.js',
  sources: {
    'main.js': "import {greet} from './greet.js'; globalThis.out = greet();",
    'greet.js': "export const greet = () => 'hi';",
  },
);
final runtime = getJavascriptRuntime();
final result = bundle.evaluate(runtime);

Module names are the specifiers import resolves to. QuickJS normalizes only a leading ./ / ../ against the importing module's name, so keys should be paths relative to one common root ('main.js', 'lib/util.js').

Bytecode is tied to the QuickJS build shipped with this package. Compile in the same process (or the same app version) that evaluates it; see doc/wiki/api/bytecode.md.