@swmansion/popcorn 0.4.0-next.4 → 0.4.0-next.5

package/README.md

@@ -4,7 +4,7 @@ Run Elixir in a browser with OTP/BEAM compiled to WebAssembly.
 This prerelease replaces the AtomVM runtime used by Popcorn 0.3.x.
 
 Start with the
-[versioned Popcorn guide](https://popcorn.hexdocs.pm/0.4.0-next.4/introduction.html).
+[versioned Popcorn guide](https://popcorn.hexdocs.pm/0.4.0-next.5/introduction.html).
 It includes a complete Mix and Vite tutorial.
 
 ## Install
@@ -13,12 +13,12 @@ It includes a complete Mix and Vite tutorial.
 npm install @swmansion/popcorn@next
 ```
 
-Add `{:popcorn, "0.4.0-next.4"}` to your Elixir application's dependencies.
+Add `{:popcorn, "0.4.0-next.5"}` to your Elixir application's dependencies.
 Run `mix deps.get` before building the JavaScript application. The bundler
 plugins invoke Mix locally to compile and package application and
 standard-library code.
 
-Use the toolchain pinned in [mise.toml](https://github.com/software-mansion/popcorn/blob/v0.4.0-next.4/mise.toml).
+Use the toolchain pinned in [mise.toml](https://github.com/software-mansion/popcorn/blob/v0.4.0-next.5/mise.toml).
 The packager checks host OTP compatibility against the selected runtime's manifest.
 
 ## Configure Vite
@@ -94,4 +94,4 @@ Serve `.wasm` as `application/wasm`. Serve compressed `.tar.gz` files with `Cont
 The package also emits uncompressed tar files and Brotli variants. Brotli uses standard effort by default. Set `brotliEffort: "max"` for maximum compression in release builds.
 
 The JavaScript bridge currently requires a Content Security Policy that permits `unsafe-eval`.
-See the [versioned Elixir API](https://popcorn.hexdocs.pm/0.4.0-next.4/) for interoperability details.
+See the [versioned Elixir API](https://popcorn.hexdocs.pm/0.4.0-next.5/) for interoperability details.

package/dist/index.mjs

@@ -636,6 +636,8 @@ class Popcorn {
         };
         this.ttySize = { ...ttySize };
         this.output = resolveOutputHandlers(opts);
+        if (opts.onEvent)
+            this.onEvent(opts.onEvent);
         this.spawnWorker();
     }
     spawnWorker() {
@@ -650,7 +652,7 @@ class Popcorn {
     /**
      * Creates an instance and waits for {@link boot}.
      *
-     * For startup messages, use the constructor and register {@link onEvent} before boot.
+     * Use `opts.onEvent` to receive messages sent during startup.
      *
      * @returns Ok tuple or `runtime:eval-unavailable` if the page blocks JavaScript evaluation.
      */

package/dist/plugins/vite.mjs

@@ -43,6 +43,7 @@ function popcorn(options) {
     let dirty = false;
     let outDir;
     let assetsDir = "assets";
+    let workerDerivedOtpRoot = `/@fs${distDir}/otp/`;
     // Dev/preview: pack once at server startup, then re-pack lazily after the
     // app's compiled beams change. A single in-flight promise dedupes concurrent
     // requests; a change during a re-pack re-sets `dirty` so it isn't lost.
@@ -78,7 +79,7 @@ function popcorn(options) {
             return;
         }
         const requestPath = decodeURIComponent(new URL(url, "http://localhost").pathname);
-        const requestRoot = [`/${assetsDir}/otp/`, `/@fs${distDir}/otp/`].find((root) => requestPath.startsWith(root));
+        const requestRoot = [`/${assetsDir}/otp/`, workerDerivedOtpRoot].find((root) => requestPath.startsWith(root));
         if (requestRoot === undefined) {
             next();
             return;
@@ -146,6 +147,10 @@ function popcorn(options) {
             config.server.fs.allow.push(distDir);
             outDir = resolve(config.root, config.build.outDir);
             assetsDir = config.build.assetsDir;
+            const servedDistDir = isUnder(config.root, distDir)
+                ? `/${relative(config.root, distDir)}`
+                : `/@fs${distDir}`;
+            workerDerivedOtpRoot = `${servedDistDir}/otp/`;
         },
         async configureServer(server) {
             const rootDir = resolve(options.rootDir);

package/dist/popcorn.d.ts

@@ -70,6 +70,8 @@ export type PopcornOpts<Output extends TtyOutput = "text"> = {
      * Defaults to console output.
      */
     onError?: (event: OtpErrorPayload) => void;
+    /** Receives BEAM message payloads, including messages sent during startup. */
+    onEvent?: (event: PopcornEvent) => void;
     /**
      * Module worker URL.
      *
@@ -97,9 +99,7 @@ export type GenServer = {
     /**
      * Calls a GenServer by registered name or {@link Pid} and waits for its reply.
      *
-     * Requires a running `Popcorn.Proxy`, registered as `popcorn_proxy` by default.
-     *
-     * @param opts - `timeoutMs` defaults to 5 000 ms. `proxy` allows to select another registered proxy.
+     * @param opts - `timeoutMs` defaults to 5 000 ms. `proxy` allows to select another registered proxy (see `Popcorn.Proxy`).
      * @returns A {@link Result} with the reply or a bridge, VM, timeout, or GenServer error.
      *
      * GenServer failures use `genserver:noproc`, `genserver:exit`, or `genserver:unserializable`.
@@ -154,7 +154,7 @@ export declare class Popcorn<Output extends TtyOutput = "text"> {
     /**
      * Creates an instance and waits for {@link boot}.
      *
-     * For startup messages, use the constructor and register {@link onEvent} before boot.
+     * Use `opts.onEvent` to receive messages sent during startup.
      *
      * @returns Ok tuple or `runtime:eval-unavailable` if the page blocks JavaScript evaluation.
      */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swmansion/popcorn",
-  "version": "0.4.0-next.4",
+  "version": "0.4.0-next.5",
   "description": "JS bindings for BEAM/OTP in WebAssembly",
   "type": "module",
   "license": "Apache-2.0",