@swmansion/popcorn 0.3.2 → 0.4.0-next.0

package/dist/runtimes/crypto/manifest.json

@@ -0,0 +1 @@
+{"vm":{"version":"29.0.6","capabilities":{"crypto":true},"preloaded":["atomics","counters","erl_init","erl_prim_loader","erl_tracer","erlang","erts_code_purger","erts_dirty_process_signal_handler","erts_internal","erts_literal_area_collector","erts_trace_cleaner","init","persistent_term","prim_buffer","prim_eval","prim_file","prim_inet","prim_net","prim_socket","prim_zip","socket_registry","wasm","zlib"]}}

package/dist/tar.d.ts

@@ -0,0 +1,4 @@
+type OnDir = (path: string) => void;
+type OnFile = (path: string, data: Uint8Array<ArrayBuffer>) => void;
+export declare function extractTar(data: Uint8Array, onDir: OnDir, onFile: OnFile): void;
+export {};

package/dist/types.d.ts

@@ -1,77 +1,122 @@
-export declare const INIT_VM_TIMEOUT_MS = 30000;
-export declare const CALL_TIMEOUT_MS = 60000;
-export declare const HEARTBEAT_TIMEOUT_MS = 60000;
-export declare const HEARTBEAT_INTERVAL_MS = 500;
-export declare const MAX_RELOAD_N = 3;
-export type AnySerializable = any;
-export type ElixirEvent = {
-    eventName: string;
-    payload: AnySerializable;
+type CreateModuleFn<Mod> = (overrides?: Partial<Mod>) => Promise<Mod>;
+/**
+ * A message value. JavaScript sends use these BEAM conversions:
+ *
+ * - Strings become UTF-8 binaries. Booleans become `true` and `false` atoms.
+ * - Integers become integers. Other finite numbers become floats.
+ * - Arrays become lists.
+ * - Plain objects become maps with binary string keys.
+ * - `null` and `undefined` become the `nil` atom.
+ * - `atom()` and `tuple()` create atoms and tuples. PIDs retain their BEAM identity.
+ *
+ * Cycles, class instances, functions, symbols, bigints, unsafe integers, and non-finite numbers cause `bridge:unserializable`.
+ */
+export type AnyValue = unknown;
+declare const pidBrand: unique symbol;
+/**
+ * An opaque BEAM process identifier received from the VM.
+ *
+ * Valid only with the Popcorn instance and boot that produced it.
+ */
+export type Pid = {
+    readonly [pidBrand]: true;
 };
-export type CallRequest = {
-    requestId: number;
-    process: string;
-    args: AnySerializable;
-};
-export type CastRequest = {
-    requestId: number;
-    process: string;
-    args: AnySerializable;
-};
-/** Messages sent from parent window to iframe */
-export type IframeRequest = {
-    type: "popcorn-call";
-    value: CallRequest;
+/** Internal wire target. The public `send` accepts `string | Pid` instead. */
+export type BeamTarget = {
+    name: string;
 } | {
-    type: "popcorn-cast";
-    value: CastRequest;
+    pid: Uint8Array;
 };
-export type CallResponse = {
-    requestId: number;
-    error?: AnySerializable;
-    data?: AnySerializable;
+export type BeamSendPayload = {
+    target: BeamTarget;
+    etf: Uint8Array<ArrayBuffer>;
 };
-export type CallAck = {
-    requestId: number;
+export type BeamBootOptions = {
+    otpAssetsRoot: string;
+    /**
+     * Emulator flags before `--`.
+     *
+     * Overrides the default scheduler flags.
+     * Use `schedulers()` to set thread counts.
+     */
+    emulatorArgs?: string[];
+    /** Erlang arguments after the boot arguments, such as `-eval` expressions. */
+    extraArgs?: string[];
+    /** VM environment variables. */
+    env?: Record<string, string>;
+    ttySize: TtySize;
+    createModule: CreateModuleFn<EmscriptenModule>;
+    emit: (event: BeamEvent) => void;
 };
-/** Messages sent from iframe to parent window */
-export type IframeResponse = {
-    type: "popcorn-event";
-    value: ElixirEvent;
+export type BeamEvent = {
+    type: "otp:stdout";
+    payload: Uint8Array;
+} | {
+    type: "otp:stderr";
+    payload: Uint8Array;
 } | {
-    type: "popcorn-call";
-    value: CallResponse;
+    type: "otp:stdin-consumed";
+    payload: number;
 } | {
-    type: "popcorn-callAck";
-    value: CallAck;
+    type: "otp:error";
+    payload: OtpErrorPayload;
 } | {
-    type: "popcorn-stdout";
-    value: string;
+    type: "otp:message";
+    payload: AnyValue;
 } | {
-    type: "popcorn-stderr";
-    value: string;
+    type: "otp:run_js";
+    payload: RunJsRequest;
+} | {
+    type: "otp:tracked-value-delete";
+    payload: number;
+};
+export type RunJsRequest = {
+    code: string;
+    args: AnyValue;
+    replyTo: Uint8Array;
+    return: "value" | "ref";
+};
+/**
+ * VM shutdown notification.
+ *
+ * An `exit` carries a status code, including zero for a normal exit.
+ */
+export type OtpErrorPayload = {
+    kind: "abort";
+    data: string;
 } | {
-    type: "popcorn-heartbeat";
-    value: null;
+    kind: "error";
+    data: string;
 } | {
-    type: "popcorn-reload";
-    value: string | null;
+    kind: "exit";
+    data: number;
 };
-/** Union of all messages (requests and responses) */
-export type Message = IframeRequest | IframeResponse;
-export declare const MESSAGES: {
-    readonly EVENT: "popcorn-event";
-    readonly CALL: "popcorn-call";
-    readonly CAST: "popcorn-cast";
-    readonly CALL_ACK: "popcorn-callAck";
-    readonly STDOUT: "popcorn-stdout";
-    readonly STDERR: "popcorn-stderr";
-    readonly HEARTBEAT: "popcorn-heartbeat";
-    readonly RELOAD: "popcorn-reload";
+/** Terminal dimensions in character cells, from 1 to 65,535 per dimension. */
+export type TtySize = {
+    columns: number;
+    rows: number;
 };
-export declare const EVENT_NAMES: {
-    readonly ELIXIR_READY: "popcorn_elixir_ready";
-    readonly APP_READY: "popcorn_app_ready";
-    readonly SET_DEFAULT_RECEIVER: "popcorn_set_default_receiver";
+/** Emscripten Module interface (subset exposed after instantiation). */
+export type EmscriptenModule = {
+    ENV: Record<string, string>;
+    FS_mkdirTree: (path: string) => void;
+    FS_createDataFile: (parent: string, name: string | null, data: Uint8Array, canRead: boolean, canWrite: boolean, canOwn: boolean) => void;
+    HEAPU8: Uint8Array;
+    ccall: (ident: string, returnType: string | null, argTypes: string[], args: unknown[]) => AnyValue;
+    print: (text: string) => void;
+    printErr: (text: string) => void;
+    onExit: (code: number) => void;
+    onAbort: (text: string) => void;
+    arguments: string[];
+    preRun: ((mod: EmscriptenModule) => void)[];
+    _malloc: (size: number) => number;
+    _free: (ptr: number) => void;
+    onBeamMessage?: (text: string) => void | Promise<void>;
+    onError?: (text: string) => void | Promise<void>;
+    onStdinConsumed?: (size: number) => void;
+    onTrackedValueDelete?: (key: number) => void;
+    onTtyChunk?: (fd: number, chunk: Uint8Array) => void;
+    addRunDependency: (id: string) => void;
+    removeRunDependency: (id: string) => void;
 };
-export declare function isMessageType(type: string): type is Message["type"];
+export {};

package/dist/utils.d.ts

@@ -0,0 +1,7 @@
+export declare function dirname(path: string): string;
+export declare function fetchBinary(url: string): Promise<Uint8Array | null>;
+export declare function fetchJson<T>(url: string): Promise<T | null>;
+export declare function base64ToBytes(b64: string): Uint8Array;
+export declare function check(ok: boolean, msg?: string): asserts ok;
+export declare function unreachable(): never;
+export declare function objectWithKeys<K extends string>(value: unknown, keys: K[]): null | Record<K, unknown>;

package/dist/worker.d.ts

@@ -0,0 +1 @@
+export {};