feat: expose more programatic API via CLI

Author: andreiltd

README.md

@@ -351,6 +351,8 @@ Before being able to use `componentize-js` with AOT support (ex. via `npm link`,
 npm run build:weval
 ```
 
+(`npm run build` will also execute the weval build)
+
 This will produce `lib/starlingmonkey_embedding_weval.wasm` and `lib/starlingmonkey_ics.wevalcache`.
 
 To clean up a local installation (i.e. remove the installation of StarlingMonkey):

crates/spidermonkey-embedding-splicer/src/splice.rs

@@ -759,7 +759,7 @@ fn synthesize_import_functions(
             .unwrap();
 
         // Save the idx parameter to local at the start of the function,
-        // so that orignal code does not oeverwrit it.
+        // so that original code does not overwrite it.
         let idx_local = builder.add_local(DataType::I32);
         builder.inject_at(
             0,

src/cli.js

@@ -12,12 +12,16 @@ export async function componentizeCmd(jsSource, opts) {
     worldName: opts.worldName,
     runtimeArgs: opts.runtimeArgs,
     enableAot: opts.aot,
+    engine: opts.engine,
     disableFeatures: opts.disable,
     preview2Adapter: opts.preview2Adapter,
     debugBindings: opts.debugBindings,
     debugBuild: opts.useDebugBuild,
     enableWizerLogging: opts.enableWizerLogging,
     wizerBin: opts.wizerBin,
+    wevalBin: opts.wevalBin,
+    aotCache: opts.aotCacheDir,
+    aotMinStackSizeBytes: opts.aotMinStackSize,
   });
   await writeFile(opts.out, component);
 }
@@ -31,6 +35,10 @@ program
   .option('-n, --world-name <name>', 'WIT world to build')
   .option('--runtime-args <string>', 'arguments to pass to the runtime')
   .option('--aot', 'enable AOT compilation')
+  .option(
+    '--engine <path>',
+    'provide a custom ComponentizeJS engine build path',
+  )
   .addOption(
     new Option('-d, --disable <feature...>', 'disable WASI features').choices(
       DEFAULT_FEATURES,
@@ -50,6 +58,18 @@ program
     '--wizer-bin <path>',
     'specify a path to a local wizer binary',
   )
+  .option(
+    '--weval-bin <path>',
+    'specify a path to a local weval binary',
+  )
+  .option(
+    '--aot-cache-dir <path>',
+    'specify a custom AOT weval cache path',
+  )
+  .option(
+    '--aot-min-stack-size <bytes>',
+    'set the minimum stack size (RUST_MIN_STACK) for weval AOT compilation',
+  )
   .requiredOption('-o, --out <out>', 'output component file')
   .action(asyncAction(componentizeCmd));