@swf2es/runtime 0.0.0-stage → 0.1.0

package/dist/avm2/natives/shell-workers.js

@@ -0,0 +1,405 @@
+// avmshell's workers, as avmplus' Aggregate and Isolate keep them: each
+// worker's state, parent and shared properties in memory every thread
+// sees, so that a worker's state and what another worker set are seen at
+// once, while the primordial spins in System.sleep. The memory is a
+// SharedArrayBuffer where there is one, as node always has; elsewhere an
+// ArrayBuffer, and there are no other threads to start.
+//
+// The host starts the threads (RuntimeOptions.workers); each runs a
+// runtime made with its worker's ShellWorkerInit, which the runtime finds
+// here by its id.
+import { fromUtf8, utf8 } from "./bytearray.js";
+import { Sync } from "./sync.js";
+/** avmplus' Isolate::State. */
+export const NEW = 1;
+export const CANSTART = 2;
+export const STARTING = 3;
+export const RUNNING = 4;
+export const FINISHING = 5;
+export const TERMINATED = 6;
+export const FAILED = 7;
+export const ABORTED = 8;
+export const EXCEPTION = 9;
+/** Worker.state's names for each, as WorkerObjectBase::get_state reports them. */
+export const STATE_NAMES = [
+    "",
+    "new",
+    "new",
+    "new",
+    "running",
+    "running",
+    "terminated",
+    "failed",
+    "aborted",
+    "exception",
+];
+// The control memory's words: the table's lock, the workers made, the
+// table's version and the next item token; then each worker's state and
+// parent, two words a worker.
+const LOCK = 0;
+const COUNT = 1;
+const VERSION = 2;
+const TOKEN = 3;
+const WORKERS = 4;
+const CONTROL_MAX = 16 << 20;
+const TABLE_MAX = 256 << 20;
+/**
+ * How a shared property is kept: AMF3, a ByteArray's bytes, a Mutex or a
+ * Condition by its address in the sync memory (a byte, 0 for a Mutex, then
+ * an int32), a Number's float64, or a shareable ByteArray's memory by its
+ * id, as a float64.
+ */
+export const ITEM_AMF = 0;
+export const ITEM_BYTES = 1;
+export const ITEM_SYNC = 2;
+export const ITEM_NUMBER = 3;
+export const ITEM_SHARED = 4;
+/** Growable memory, shared where SharedArrayBuffer is. */
+function growable(length, max) {
+    const shared = typeof SharedArrayBuffer === "function";
+    const ctor = (shared ? SharedArrayBuffer : ArrayBuffer);
+    return new ctor(length, { maxByteLength: max });
+}
+function grow(buffer, length) {
+    const b = buffer;
+    if (b.byteLength >= length) {
+        return;
+    }
+    if (b.grow) {
+        b.grow(length);
+    }
+    else {
+        b.resize?.(length);
+    }
+}
+/** New memory for the workers of a primordial, itself worker 0, running, whose Mutexes live in `sync`. */
+export function newWorkersMemory(sync) {
+    const memory = {
+        control: growable((WORKERS + 2) * 4, CONTROL_MAX),
+        table: growable(4, TABLE_MAX),
+        sync,
+    };
+    const control = new Int32Array(memory.control);
+    control[COUNT] = 1;
+    control[WORKERS] = RUNNING;
+    control[WORKERS + 1] = -1;
+    return memory;
+}
+/** Wait up to `ms` on `word` while it holds `value`, spinning where this thread cannot block. */
+function waitOn(words, index, value, ms) {
+    try {
+        Atomics.wait(words, index, value, ms);
+    }
+    catch {
+        // An ArrayBuffer's, or a browser's main thread, which cannot block.
+    }
+}
+/** Thrown in a worker that was terminated, as avmplus interrupts it: its code stops. */
+export class WorkerTerminated extends Error {
+    constructor() {
+        super("swf2es: the worker was terminated");
+    }
+}
+/** The workers as one VM sees them, over the memory they share. */
+export class Workers {
+    memory;
+    self;
+    control;
+    /** The Mutexes' and Conditions' memory, told which workers have ended. */
+    sync;
+    /** The table as last read, and its version. */
+    entries = new Map();
+    version = 0;
+    /**
+     * This VM's object for each property whose identity it keeps, a
+     * ByteArray, by entryKey, with its item's token.
+     */
+    objects = new Map();
+    constructor(memory, 
+    /** The worker this VM runs. */
+    self) {
+        this.memory = memory;
+        this.self = self;
+        this.control = new Int32Array(memory.control);
+        this.sync = new Sync(memory.sync, self);
+    }
+    /** A worker's state; one past those made has none. */
+    state(id) {
+        return this.words(id) ? Atomics.load(this.control, WORKERS + 2 * id) : 0;
+    }
+    parent(id) {
+        return this.words(id) ? Atomics.load(this.control, WORKERS + 2 * id + 1) : -1;
+    }
+    /** Move worker `id` from `from` to `to`; whether it was in `from`. */
+    transition(id, from, to) {
+        return Atomics.compareExchange(this.control, WORKERS + 2 * id, from, to) === from;
+    }
+    setState(id, to) {
+        Atomics.store(this.control, WORKERS + 2 * id, to);
+    }
+    /** A new worker of this one's, NEW. */
+    create() {
+        return this.locked(() => {
+            const id = this.control[COUNT];
+            // The views track the memory's length as it grows.
+            grow(this.memory.control, (WORKERS + 2 * (id + 1)) * 4);
+            this.control[WORKERS + 2 * id] = NEW;
+            this.control[WORKERS + 2 * id + 1] = this.self;
+            this.sync.addThread(id);
+            Atomics.store(this.control, COUNT, id + 1);
+            return id;
+        });
+    }
+    /** The workers made so far, by id. */
+    count() {
+        return Atomics.load(this.control, COUNT);
+    }
+    get(id, key) {
+        if (Atomics.load(this.control, VERSION) !== this.version) {
+            this.locked(() => this.read());
+        }
+        return this.entries.get(entryKey(id, key));
+    }
+    /** Set worker `id`'s property `key`, or delete it with a null `item`; the item's token. */
+    set(id, key, item) {
+        return this.locked(() => {
+            this.read();
+            let token = 0;
+            if (item) {
+                token = Atomics.add(this.control, TOKEN, 1) + 1;
+                const entry = { id, key, kind: item.kind, writer: this.self, token, bytes: item.bytes };
+                this.entries.set(entryKey(id, key), entry);
+            }
+            else {
+                this.entries.delete(entryKey(id, key));
+            }
+            this.write();
+            return token;
+        });
+    }
+    /**
+     * Terminate worker `id`, started and not yet ended, and the workers it
+     * started, theirs and so on, whose threads stop with its own: each
+     * `terminated`, its properties let go, as Isolate::releaseActiveResources.
+     * The workers terminated, none where `id` was not running. Done holding
+     * the lock, so that none of them is in the table then, and none takes
+     * the lock again (see locked): its thread may be stopped anywhere once
+     * this returns. Their threads may run on until they are stopped, so the
+     * sync memory refuses them anything more, and keeps the locks they hold
+     * until the caller says their threads have stopped (Sync.end).
+     */
+    terminate(id) {
+        return this.locked(() => {
+            const state = this.state(id);
+            if (state <= NEW || state > RUNNING) {
+                return new Set();
+            }
+            const ended = new Set([id]);
+            // A worker's number is above its parent's.
+            for (let d = id + 1; d < this.count(); d++) {
+                const s = this.state(d);
+                if (ended.has(this.parent(d)) && s > NEW && s <= RUNNING) {
+                    ended.add(d);
+                }
+            }
+            // Their properties first: once a worker holding the lock is
+            // terminated, another may take the lock from it (see locked).
+            this.drop(ended);
+            for (const d of ended) {
+                this.setState(d, TERMINATED);
+                this.sync.stop(d);
+            }
+            return ended;
+        });
+    }
+    /** This VM's worker has ended, as `to`, its properties let go; unless it was terminated already. */
+    end(to) {
+        this.locked(() => {
+            // Its state last, as in terminate; one that terminated itself is so.
+            if (this.state(this.self) === RUNNING) {
+                const terminated = this.sync.terminated;
+                this.drop(new Set([this.self]));
+                this.sync.end(this.self);
+                this.setState(this.self, terminated ? TERMINATED : to);
+            }
+        }, true);
+    }
+    /**
+     * This VM's worker terminates itself: its code stops, and once it has,
+     * it is terminated and what it held let go (endShellWorker).
+     */
+    terminateSelf() {
+        this.sync.stop(this.self);
+    }
+    /** Whether this VM's worker was terminated, by another or by itself: its code is to stop. */
+    get terminated() {
+        return this.self !== 0 && (this.state(this.self) > RUNNING || this.sync.terminated);
+    }
+    /** Remove the properties of the workers `ids`, holding the lock. */
+    drop(ids) {
+        this.read();
+        let changed = false;
+        for (const [k, e] of this.entries) {
+            if (ids.has(e.id)) {
+                this.entries.delete(k);
+                changed = true;
+            }
+        }
+        if (changed) {
+            this.write();
+        }
+    }
+    words(id) {
+        return id >= 0 && id < Atomics.load(this.control, COUNT);
+    }
+    /**
+     * Run `f` holding the table's lock, whose word holds its holder's id
+     * plus one. A worker's thread is stopped only after it was terminated
+     * under the lock (terminate), and a terminated worker changes nothing
+     * holding it: it throws WorkerTerminated instead. It may still take the
+     * lock to find that out, as it can have been waiting for it while it
+     * was terminated, and be stopped there; so a lock held by a worker that
+     * was terminated is taken from it.
+     */
+    locked(f, ending = false) {
+        const me = this.self + 1;
+        for (;;) {
+            const holder = Atomics.compareExchange(this.control, LOCK, 0, me);
+            if (holder === 0) {
+                break;
+            }
+            if (holder !== 1 &&
+                this.state(holder - 1) > RUNNING &&
+                Atomics.compareExchange(this.control, LOCK, holder, me) === holder) {
+                break;
+            }
+            waitOn(this.control, LOCK, holder, 1);
+        }
+        try {
+            if (this.self !== 0 &&
+                (this.state(this.self) > RUNNING || (!ending && this.sync.terminated))) {
+                throw new WorkerTerminated();
+            }
+            return f();
+        }
+        finally {
+            Atomics.compareExchange(this.control, LOCK, me, 0);
+            Atomics.notify(this.control, LOCK);
+        }
+    }
+    /** The table from memory: its length, then each entry. */
+    read() {
+        this.version = Atomics.load(this.control, VERSION);
+        const table = new Uint8Array(this.memory.table);
+        const view = new DataView(this.memory.table);
+        const end = 4 + view.getUint32(0, true);
+        this.entries.clear();
+        let at = 4;
+        while (at < end) {
+            const id = view.getUint32(at, true);
+            const keyLength = view.getInt32(at + 4, true);
+            at += 8;
+            const key = keyLength < 0 ? null : fromUtf8(table.slice(at, at + keyLength));
+            at += Math.max(keyLength, 0);
+            const kind = table[at];
+            const writer = view.getUint32(at + 1, true);
+            const token = view.getUint32(at + 5, true);
+            const length = view.getUint32(at + 9, true);
+            at += 13;
+            const bytes = table.slice(at, at + length);
+            at += length;
+            this.entries.set(entryKey(id, key), { id, key, kind, writer, token, bytes });
+        }
+    }
+    /**
+     * The table into memory, its length first, in one copy: a thread
+     * stopped mid-way leaves the old table or the new one.
+     */
+    write() {
+        const parts = [];
+        let length = 0;
+        for (const e of this.entries.values()) {
+            const key = e.key === null ? null : utf8(e.key);
+            const head = new Uint8Array(8);
+            const headView = new DataView(head.buffer);
+            headView.setUint32(0, e.id, true);
+            headView.setInt32(4, key === null ? -1 : key.length, true);
+            const item = new Uint8Array(13);
+            const itemView = new DataView(item.buffer);
+            item[0] = e.kind;
+            itemView.setUint32(1, e.writer, true);
+            itemView.setUint32(5, e.token, true);
+            itemView.setUint32(9, e.bytes.length, true);
+            parts.push(head);
+            if (key) {
+                parts.push(key);
+            }
+            parts.push(item, e.bytes);
+            length += head.length + (key?.length ?? 0) + item.length + e.bytes.length;
+        }
+        const out = new Uint8Array(4 + length);
+        new DataView(out.buffer).setUint32(0, length, true);
+        let at = 4;
+        for (const p of parts) {
+            out.set(p, at);
+            at += p.length;
+        }
+        grow(this.memory.table, out.length);
+        new Uint8Array(this.memory.table).set(out);
+        this.version = Atomics.add(this.control, VERSION, 1) + 1;
+    }
+}
+/** A property's key among all the workers'. */
+export const entryKey = (id, key) => `${id}${key === null ? "" : `:${key}`}`;
+/**
+ * A background worker's thread has begun, as avmplus' core once set up:
+ * whether it is to run, which it is not once terminated.
+ */
+export function startShellWorker(init) {
+    return new Workers(init.memory, init.id).transition(init.id, CANSTART, RUNNING);
+}
+/**
+ * A background worker's code has ended, normally or by an exception
+ * nothing caught; its properties are let go, as when avmplus deletes its
+ * core. One terminated meanwhile stays so.
+ */
+export function endShellWorker(init, exception) {
+    try {
+        new Workers(init.memory, init.id).end(exception ? EXCEPTION : TERMINATED);
+    }
+    catch (e) {
+        if (!(e instanceof WorkerTerminated)) {
+            throw e;
+        }
+    }
+    finally {
+        // Its code has ended, and asks nothing more of the sync memory: the
+        // locks it held are free to take, a terminated one's too.
+        new Sync(init.memory.sync, init.id).end(init.id);
+    }
+}
+/** Whether a background worker was terminated: its thread's end is then no failure. */
+export function shellWorkerTerminated(init) {
+    return new Workers(init.memory, init.id).terminated;
+}
+/** Sleep `ms` milliseconds, as System.sleep: blocking where the thread can, else spinning. */
+export function sleep(ms) {
+    if (ms <= 0) {
+        return;
+    }
+    const end = Date.now() + ms;
+    if (typeof SharedArrayBuffer === "function") {
+        const word = new Int32Array(new SharedArrayBuffer(4));
+        try {
+            Atomics.wait(word, 0, 0, ms);
+            return;
+        }
+        catch {
+            // A browser's main thread, which cannot block.
+        }
+    }
+    while (Date.now() < end) {
+        // Spin.
+    }
+}
+//# sourceMappingURL=shell-workers.js.map

package/dist/avm2/natives/shell-workers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-workers.js","sourceRoot":"","sources":["../../../src/avm2/natives/shell-workers.ts"],"names":[],"mappings":"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"}

package/dist/avm2/natives/shell.d.ts

@@ -0,0 +1,12 @@
+import type { ClassHook } from "../hooks.js";
+import type { Runtime } from "../runtime.js";
+import { type Natives } from "./define.js";
+/** avmshell's System, File and Domain natives, for `rt`, and its Worker's. */
+export declare function shellNatives(rt: Runtime): Natives;
+/**
+ * As ShellWorkerClass: Worker.current is the primordial worker, made with
+ * the class. And avmshell's classes that test how a native class may limit
+ * its construction.
+ */
+export declare const shellHooks: Record<string, ClassHook>;
+//# sourceMappingURL=shell.d.ts.map

package/dist/avm2/natives/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../../src/avm2/natives/shell.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAa7C,OAAO,EAAY,KAAK,OAAO,EAAuB,MAAM,aAAa,CAAC;AAkF1E,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CA0ajD;AAgJD;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CA0BhD,CAAC"}