@swf2es/cli 0.0.0-stage → 0.1.0

package/dist/shell.d.ts

@@ -0,0 +1,62 @@
+import { type Codegen } from "@swf2es/codegen";
+import type { Abc, CompileUnit, Runtime, RuntimeOptions, ShellFiles, ShellWorkerHost, ShellWorkerInit } from "@swf2es/runtime/avm2";
+/** What the shell needs of a compiler: a Codegen, or a build of it for tests. */
+export type ShellCompiler = Pick<Codegen, "reset" | "add" | "childDomain" | "found" | "compileModule">;
+/** A module the compiler wrote, loaded: run with a runtime, it gives the ABC. */
+export type ShellModule = (rt: Runtime) => Abc;
+export interface ShellLibrary {
+    name: string;
+    abc: Uint8Array;
+    /** Its module, compiled before for the same libraries before it: linked again but not compiled. */
+    module?: ShellModule;
+}
+export interface ShellOptions {
+    compiler: ShellCompiler;
+    /** The runtime's createRuntime, or another build's. */
+    createRuntime: (options: RuntimeOptions) => Runtime;
+    /** Where trace and print write a line. */
+    print: (line: string) => void;
+    /** Where avmshell's File reads and writes; the runtime keeps them in memory by default. */
+    files?: ShellFiles;
+    /**
+     * Load a module the compiler has just written, `name` naming its script
+     * (which Runtime.codeDomain tells domains by); by default evaluated as a
+     * script of its own.
+     */
+    load?: (js: string, name: string) => ShellModule | Promise<ShellModule>;
+    /** What starts the background workers' threads (RuntimeOptions.workers), as nodeShellThreads does. */
+    workers?: ShellWorkerHost;
+    /** The background worker these ABCs run as, in the thread its host started (RuntimeOptions.worker). */
+    worker?: ShellWorkerInit;
+    /**
+     * The ABCs' API version, as avmshell's -api gives it, whose series is
+     * the run's: Flash Player's latest, 50, by default.
+     */
+    apiVersion?: number;
+}
+/** A module's source as a script of its own: its default export returned, `name` its sourceURL. */
+export declare function evaluateModule(js: string, name: string): ShellModule;
+/**
+ * The compiler for one runtime: the libraries and ABCs added to the root
+ * domain, and RuntimeOptions.compileAbc for those Domain.loadBytes loads.
+ */
+export declare function shellDomain(compiler: ShellCompiler, apiVersion?: number): {
+    /** Add an ABC to the root domain, as avmshell loads its libraries and the ABCs it runs. */
+    add: (bytes: Uint8Array, builtin: boolean) => number;
+    /** The module of the ABC added last. */
+    compile: () => string;
+    /** RuntimeOptions.compileAbc: `bytes` compiled into the unit's domain, evaluated at once. */
+    compileAbc(bytes: Uint8Array, unit: CompileUnit): ShellModule | number;
+};
+/**
+ * Run `abcs` after `libraries` as avmshell runs them, printing what they
+ * trace: avmshell's exit status, 0, or 1 once an ABC is rejected, with
+ * its VerifyError, or throws an exception nothing catches, printed as its
+ * string; the ABCs after it do not run. A library's rejection throws a
+ * RejectedError, and an error of the host's, a JavaScript Error, is thrown.
+ */
+export declare function runShell(libraries: ShellLibrary[], abcs: {
+    name: string;
+    abc: Uint8Array;
+}[], options: ShellOptions): Promise<number>;
+//# sourceMappingURL=shell.d.ts.map

package/dist/shell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../src/shell.ts"],"names":[],"mappings":"AAQA,OAAO,EAAe,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EACV,GAAG,EACH,WAAW,EACX,OAAO,EACP,cAAc,EACd,UAAU,EACV,eAAe,EACf,eAAe,EAEhB,MAAM,sBAAsB,CAAC;AAI9B,iFAAiF;AACjF,MAAM,MAAM,aAAa,GAAG,IAAI,CAC9B,OAAO,EACP,OAAO,GAAG,KAAK,GAAG,aAAa,GAAG,OAAO,GAAG,eAAe,CAC5D,CAAC;AAEF,iFAAiF;AACjF,MAAM,MAAM,WAAW,GAAG,CAAC,EAAE,EAAE,OAAO,KAAK,GAAG,CAAC;AAE/C,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,UAAU,CAAC;IAChB,mGAAmG;IACnG,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,aAAa,CAAC;IACxB,uDAAuD;IACvD,aAAa,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC;IACpD,0CAA0C;IAC1C,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,2FAA2F;IAC3F,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IACxE,sGAAsG;IACtG,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,uGAAuG;IACvG,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAID,mGAAmG;AACnG,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAKpE;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,EAAE,UAAU,SAAc;IA0BzE,2FAA2F;IAC3F,GAAG,UAAU,UAAU,WAAW,OAAO,KAAG,MAAM;IAClD,wCAAwC;IACxC,OAAO,QAAM,MAAM;IACnB,6FAA6F;IAC7F,UAAU,QAAQ,UAAU,QAAQ,WAAW,GAAG,WAAW,GAAG,MAAM;EAgCzE;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,YAAY,EAAE,EACzB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,UAAU,CAAA;CAAE,EAAE,EACzC,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,MAAM,CAAC,CAyDjB"}

package/dist/shell.js

@@ -0,0 +1,135 @@
+// avmshell's way of running ABCs, in node: the libraries it loads (builtin
+// and shell_toplevel), their scripts run on first use, then each ABC given,
+// added to the same domain and its entry point run, until one throws. One
+// compiler domain serves the one runtime, each ABC compiled in the
+// application domain the runtime loads it into, so that an ABC
+// Domain.loadBytes loads compiles against what its domain sees, a
+// sibling's ABCs left out.
+import { createHash } from "node:crypto";
+import { API_VERSION } from "@swf2es/codegen";
+import { floatLibrary, hasFloatLibrary } from "@swf2es/runtime/avm2";
+import { RejectedError } from "./aot.js";
+const sha256 = (bytes) => createHash("sha256").update(bytes).digest("hex");
+/** A module's source as a script of its own: its default export returned, `name` its sourceURL. */
+export function evaluateModule(js, name) {
+    // Strict, as a module is: a sloppy function boxes a primitive `this`, such
+    // as the string a String method is called on.
+    const script = `"use strict";${js.replace(/^export default /, "return ")}//# sourceURL=${name}\n`;
+    return new Function(script)();
+}
+/**
+ * The compiler for one runtime: the libraries and ABCs added to the root
+ * domain, and RuntimeOptions.compileAbc for those Domain.loadBytes loads.
+ */
+export function shellDomain(compiler, apiVersion = API_VERSION) {
+    // The compiler's number for each of the runtime's domains, and the
+    // compiler's index of each ABC loaded into one, in load order.
+    const domains = new Map([[0, 0]]);
+    const abcs = new Map([[0, []]]);
+    // The findings each domain has been told, reported once.
+    const reported = new Map();
+    // Every ABC's hash, in load order, as the compiler names a module's.
+    const hashes = [];
+    let added = 0;
+    let evaluated = 0;
+    compiler.reset(apiVersion);
+    /** Add an ABC to the runtime's domain `domain`: 0, or the VerifyError it was rejected with. */
+    const add = (bytes, builtin, domain = 0) => {
+        const error = compiler.add(bytes, builtin, domains.get(domain));
+        if (!error) {
+            abcs.get(domain)?.push(added++);
+            hashes.push(sha256(bytes));
+        }
+        return error;
+    };
+    return {
+        /** Add an ABC to the root domain, as avmshell loads its libraries and the ABCs it runs. */
+        add: (bytes, builtin) => add(bytes, builtin),
+        /** The module of the ABC added last. */
+        compile: () => compiler.compileModule(hashes),
+        /** RuntimeOptions.compileAbc: `bytes` compiled into the unit's domain, evaluated at once. */
+        compileAbc(bytes, unit) {
+            for (let i = unit.domains.length - 2; i >= 0; i--) {
+                const id = unit.domains[i];
+                if (!domains.has(id)) {
+                    domains.set(id, compiler.childDomain(domains.get(unit.domains[i + 1]) ?? 0));
+                    abcs.set(id, []);
+                }
+            }
+            const domain = unit.domains[0];
+            const at = domains.get(domain) ?? 0;
+            const told = reported.get(domain) ?? new Set();
+            reported.set(domain, told);
+            for (const f of unit.found) {
+                const key = JSON.stringify([f.asType, f.nsKind, f.uri, f.name, f.domain, f.index]);
+                const abc = abcs.get(f.domain)?.[f.index];
+                if (abc !== undefined && !told.has(key)) {
+                    told.add(key);
+                    const { nsKind, uri, name, asType } = f;
+                    compiler.found({ domain: at, nsKind, uri, name, abc, asType });
+                }
+            }
+            const error = add(bytes, false, domain);
+            if (error) {
+                return error;
+            }
+            // A script of its own, by which Runtime.codeDomain finds its frames.
+            return evaluateModule(compiler.compileModule(hashes), `loaded-${evaluated++}.js`);
+        },
+    };
+}
+/**
+ * Run `abcs` after `libraries` as avmshell runs them, printing what they
+ * trace: avmshell's exit status, 0, or 1 once an ABC is rejected, with
+ * its VerifyError, or throws an exception nothing catches, printed as its
+ * string; the ABCs after it do not run. A library's rejection throws a
+ * RejectedError, and an error of the host's, a JavaScript Error, is thrown.
+ */
+export async function runShell(libraries, abcs, options) {
+    if (abcs.some(({ abc }) => abc.length >= 4 && abc[2] === 47 && abc[3] === 0 && (abc[0] | (abc[1] << 8)) >= 16) &&
+        !hasFloatLibrary(libraries.map((lib) => lib.abc))) {
+        libraries = [...libraries, { name: "float", abc: floatLibrary }];
+    }
+    const { print } = options;
+    const load = options.load ?? evaluateModule;
+    const apiVersion = options.apiVersion ?? API_VERSION;
+    const domain = shellDomain(options.compiler, apiVersion);
+    const rt = options.createRuntime({
+        print,
+        apiVersion,
+        // Domain.loadBytes runs the ABC at once, so its module is evaluated, not imported.
+        compileAbc: (bytes, unit) => domain.compileAbc(bytes, unit),
+        ...(options.files ? { files: options.files } : {}),
+        ...(options.workers ? { workers: options.workers } : {}),
+        ...(options.worker ? { worker: options.worker } : {}),
+    });
+    for (const { name, abc, module } of libraries) {
+        const error = domain.add(abc, true);
+        if (error) {
+            throw new RejectedError(`library ${name}`, error, true);
+        }
+        // The libraries' scripts run on first use, as avmshell's builtins do.
+        (module ?? (await load(domain.compile(), `${name}.js`)))(rt);
+    }
+    for (const { name, abc } of abcs) {
+        const error = domain.add(abc, false);
+        if (error) {
+            print(`VerifyError: Error #${error}`);
+            return 1;
+        }
+        const loaded = (await load(domain.compile(), `${name}.js`))(rt);
+        try {
+            rt.run(loaded);
+        }
+        catch (e) {
+            // An AS3 exception nothing caught: avmshell prints it, as its string, and exits with 1.
+            if (e instanceof Error) {
+                throw e;
+            }
+            print(rt.toString(e));
+            return 1;
+        }
+    }
+    return 0;
+}
+//# sourceMappingURL=shell.js.map

package/dist/shell.js.map

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

package/dist/threads.d.ts

@@ -0,0 +1,85 @@
+import type { SharedBytesMemory, ShellWorkerHost, ShellWorkerInit } from "@swf2es/runtime/avm2";
+export interface ShellThreadsOptions {
+    /** codegen.wasm, compiled: each thread instantiates it. */
+    codegen: WebAssembly.Module;
+    /** The libraries the primordial loaded, which each thread loads first. */
+    libraries: {
+        name: string;
+        abc: Uint8Array;
+    }[];
+    /** The primordial's ABCs, which createWorkerFromPrimordial runs. */
+    abcs: {
+        name: string;
+        abc: Uint8Array;
+    }[];
+    /**
+     * Where a thread's lines go, on this thread, once its event loop takes
+     * them; by default each thread writes its own to stdout as it prints
+     * them, as avmshell's threads do.
+     */
+    print?: (line: string) => void;
+    /** The primordial's threads' channel for shared memory, a background thread's parent's; by default a new one. */
+    group?: string;
+    /** The shared memory its parent had seen when the thread started. */
+    memories?: SharedBytesMemory[];
+    /** The API version the primordial's ABCs run at, which its workers' run at too (ShellOptions.apiVersion). */
+    apiVersion?: number;
+}
+/** What a thread is given, as workerData. */
+export interface ShellThreadData {
+    codegen: WebAssembly.Module;
+    libraries: {
+        name: string;
+        abc: Uint8Array;
+    }[];
+    abcs: {
+        name: string;
+        abc: Uint8Array;
+    }[];
+    init: ShellWorkerInit;
+    /** Whether its lines are posted to the thread that started it, rather than written to stdout. */
+    post: boolean;
+    group: string;
+    memories: SharedBytesMemory[];
+    apiVersion?: number;
+}
+/** What the memory thread is given, as workerData. */
+export interface MemoriesData {
+    group: string;
+    /** What the primordial shared before it started. */
+    memories: SharedBytesMemory[];
+    /** Set once it has subscribed to the group's channel. */
+    ready: Int32Array;
+}
+/** What the group's channel carries: a memory shared, and a question for the memory thread and its answer. */
+export type MemoryMessage = {
+    type: "memory";
+    memory: SharedBytesMemory;
+} | {
+    type: "ask";
+    id: number;
+    answered: Int32Array;
+} | {
+    type: "answer";
+    id: number;
+    memory: SharedBytesMemory | null;
+};
+export interface ShellThreads {
+    host: ShellWorkerHost;
+    /** The primordial's threads' channel for shared memory, which a thread it starts is given. */
+    group: string;
+    /**
+     * Stop every thread still running, as avmshell interrupts its workers
+     * when the primordial ends, once what they printed so far has come.
+     */
+    close(): Promise<void>;
+    /**
+     * Wait for every thread to end by itself, those started meanwhile too:
+     * a worker whose code has ended leaves the workers it started running,
+     * as avmshell does, and its thread, which theirs belong to, waits for them.
+     */
+    ended(): Promise<void>;
+}
+/** Threads for the background workers of a primordial that runs `options.abcs`. */
+export declare function nodeShellThreads(options: ShellThreadsOptions): ShellThreads;
+//# sourceMappingURL=threads.d.ts.map

package/dist/threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.d.ts","sourceRoot":"","sources":["../src/threads.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,iBAAiB,EAEjB,eAAe,EACf,eAAe,EAChB,MAAM,sBAAsB,CAAC;AAE9B,MAAM,WAAW,mBAAmB;IAClC,2DAA2D;IAC3D,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC;IAC5B,0EAA0E;IAC1E,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,UAAU,CAAA;KAAE,EAAE,CAAC;IAC/C,oEAAoE;IACpE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,UAAU,CAAA;KAAE,EAAE,CAAC;IAC1C;;;;OAIG;IACH,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,iHAAiH;IACjH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,6GAA6G;IAC7G,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC;IAC5B,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,UAAU,CAAA;KAAE,EAAE,CAAC;IAC/C,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,UAAU,CAAA;KAAE,EAAE,CAAC;IAC1C,IAAI,EAAE,eAAe,CAAC;IACtB,iGAAiG;IACjG,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,sDAAsD;AACtD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,oDAAoD;IACpD,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,yDAAyD;IACzD,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,8GAA8G;AAC9G,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,UAAU,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAA;CAAE,CAAC;AAKrE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,eAAe,CAAC;IACtB,8FAA8F;IAC9F,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,mBAAmB,GAAG,YAAY,CAgI3E"}

package/dist/threads.js

@@ -0,0 +1,145 @@
+// avmshell's background workers on node's threads: each a worker_threads
+// Worker running shell-thread.js, which compiles and runs its worker's
+// ABCs after the same libraries, as runShell runs the primordial's.
+//
+// A shareable ByteArray's memory reaches the other threads on a
+// BroadcastChannel of the primordial's threads, read synchronously
+// (receiveMessageOnPort) when a shared property names memory a thread has
+// not seen: its code never returns to the event loop to take messages.
+// A thread started later is given what its parent has seen. A channel
+// holds only what was posted once it was made, so a thread that was still
+// starting when a memory was shared asks for it the primordial's memory
+// thread (shell-memories.ts), which subscribed before any other thread
+// started, and waits for its answer.
+import { randomUUID } from "node:crypto";
+import { writeSync } from "node:fs";
+import { receiveMessageOnPort, Worker } from "node:worker_threads";
+/** How long a thread waits for the memory thread's answer. */
+const ANSWER_MS = 10_000;
+/** Threads for the background workers of a primordial that runs `options.abcs`. */
+export function nodeShellThreads(options) {
+    // Each thread running, with its exit.
+    const running = new Map();
+    // Only what a thread can be posted: a library's loaded module is not.
+    const libraries = options.libraries.map(({ name, abc }) => ({ name, abc }));
+    const abcs = options.abcs.map(({ name, abc }) => ({ name, abc }));
+    const group = options.group ?? `swf2es-shell-${randomUUID()}`;
+    const channel = new BroadcastChannel(group);
+    // Only read synchronously: it keeps no thread alive.
+    channel.unref();
+    const memories = new Map();
+    for (const memory of options.memories ?? []) {
+        memories.set(memory.id, memory);
+    }
+    // What the other threads shared since, and the memory thread's answers.
+    const receive = () => {
+        for (;;) {
+            const m = receiveMessageOnPort(channel);
+            if (!m) {
+                break;
+            }
+            const message = m.message;
+            if (message.type === "memory" || (message.type === "answer" && message.memory)) {
+                const memory = message.memory;
+                memories.set(memory.id, memory);
+            }
+        }
+    };
+    // The primordial's memory thread, started, and subscribed, before any
+    // other thread, or when the primordial first shares a memory.
+    let keeper = null;
+    const keep = () => {
+        if (keeper || options.group) {
+            return;
+        }
+        const ready = new Int32Array(new SharedArrayBuffer(4));
+        const data = { group, memories: [...memories.values()], ready };
+        keeper = new Worker(new URL("./shell-memories.js", import.meta.url), { workerData: data });
+        keeper.unref();
+        Atomics.wait(ready, 0, 0, ANSWER_MS);
+    };
+    const host = {
+        start(init) {
+            keep();
+            receive();
+            const data = {
+                codegen: options.codegen,
+                libraries,
+                abcs,
+                init,
+                post: options.print !== undefined,
+                group,
+                memories: [...memories.values()],
+                apiVersion: options.apiVersion,
+            };
+            const worker = new Worker(new URL("./shell-thread.js", import.meta.url), {
+                workerData: data,
+                stdout: false,
+                stderr: false,
+            });
+            running.set(worker, new Promise((resolve) => worker.once("exit", resolve)));
+            worker.on("message", (line) => {
+                if (options.print) {
+                    options.print(line);
+                }
+                else {
+                    writeSync(1, `${line}\n`);
+                }
+            });
+            worker.on("error", (e) => {
+                const line = `swf2es: a background worker failed: ${e.stack ?? e}`;
+                if (options.print) {
+                    options.print(line);
+                }
+                else {
+                    writeSync(2, `${line}\n`);
+                }
+            });
+            worker.on("exit", () => running.delete(worker));
+            return {
+                terminate() {
+                    running.delete(worker);
+                    return worker.terminate();
+                },
+            };
+        },
+        share(memory) {
+            keep();
+            if (!memories.has(memory.id)) {
+                memories.set(memory.id, memory);
+                channel.postMessage({ type: "memory", memory });
+            }
+        },
+        shared(id) {
+            if (!memories.has(id)) {
+                receive();
+            }
+            // Shared while this thread was starting: the memory thread has it.
+            if (!memories.has(id) && options.group) {
+                const answered = new Int32Array(new SharedArrayBuffer(4));
+                channel.postMessage({ type: "ask", id, answered });
+                Atomics.wait(answered, 0, 0, ANSWER_MS);
+                receive();
+            }
+            return memories.get(id);
+        },
+    };
+    return {
+        host,
+        group,
+        async close() {
+            await new Promise((resolve) => setImmediate(resolve));
+            await Promise.all([...running.keys()].map((w) => w.terminate()));
+            running.clear();
+            await keeper?.terminate();
+            channel.close();
+            memories.clear();
+        },
+        async ended() {
+            while (running.size) {
+                await Promise.all(running.values());
+            }
+        },
+    };
+}
+//# sourceMappingURL=threads.js.map

package/dist/threads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"threads.js","sourceRoot":"","sources":["../src/threads.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,uEAAuE;AACvE,oEAAoE;AACpE,EAAE;AACF,gEAAgE;AAChE,mEAAmE;AACnE,0EAA0E;AAC1E,uEAAuE;AACvE,sEAAsE;AACtE,0EAA0E;AAC1E,wEAAwE;AACxE,uEAAuE;AACvE,qCAAqC;AAErC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAyDnE,8DAA8D;AAC9D,MAAM,SAAS,GAAG,MAAM,CAAC;AAmBzB,mFAAmF;AACnF,MAAM,UAAU,gBAAgB,CAAC,OAA4B;IAC3D,sCAAsC;IACtC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA4B,CAAC;IACpD,sEAAsE;IACtE,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAClE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,gBAAgB,UAAU,EAAE,EAAE,CAAC;IAC9D,MAAM,OAAO,GAAG,IAAI,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC5C,qDAAqD;IACpD,OAAwC,CAAC,KAAK,EAAE,CAAC;IAClD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IACtD,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QAC5C,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;IAClC,CAAC;IAED,wEAAwE;IACxE,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,SAAS,CAAC;YACR,MAAM,CAAC,GAAG,oBAAoB,CAAC,OAAgB,CAAC,CAAC;YACjD,IAAI,CAAC,CAAC,EAAE,CAAC;gBACP,MAAM;YACR,CAAC;YAED,MAAM,OAAO,GAAG,CAAC,CAAC,OAAwB,CAAC;YAC3C,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/E,MAAM,MAAM,GAAG,OAAO,CAAC,MAA2B,CAAC;gBACnD,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,sEAAsE;IACtE,8DAA8D;IAC9D,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,IAAI,MAAM,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAC5B,OAAO;QACT,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,MAAM,IAAI,GAAiB,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC;QAC9E,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,qBAAqB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3F,MAAM,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;IACvC,CAAC,CAAC;IACF,MAAM,IAAI,GAAoB;QAC5B,KAAK,CAAC,IAAqB;YACzB,IAAI,EAAE,CAAC;YACP,OAAO,EAAE,CAAC;YACV,MAAM,IAAI,GAAoB;gBAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,SAAS;gBACT,IAAI;gBACJ,IAAI;gBACJ,IAAI,EAAE,OAAO,CAAC,KAAK,KAAK,SAAS;gBACjC,KAAK;gBACL,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;gBAChC,UAAU,EAAE,OAAO,CAAC,UAAU;aAC/B,CAAC;YACF,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,mBAAmB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE;gBACvE,UAAU,EAAE,IAAI;gBAChB,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,KAAK;aACd,CAAC,CAAC;YACH,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;YAC5E,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAY,EAAE,EAAE;gBACpC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;oBAClB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACtB,CAAC;qBAAM,CAAC;oBACN,SAAS,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;gBACvB,MAAM,IAAI,GAAG,uCAAuC,CAAC,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC;gBACnE,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;oBAClB,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACtB,CAAC;qBAAM,CAAC;oBACN,SAAS,CAAC,CAAC,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC,CAAC,CAAC;YACH,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAChD,OAAO;gBACL,SAAS;oBACP,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;oBACvB,OAAO,MAAM,CAAC,SAAS,EAAE,CAAC;gBAC5B,CAAC;aACF,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,MAAyB;YAC7B,IAAI,EAAE,CAAC;YACP,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;gBAC7B,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;gBAChC,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAA0B,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC;QACD,MAAM,CAAC,EAAU;YACf,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC;gBACtB,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,mEAAmE;YACnE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;gBACvC,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;gBAC1D,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,QAAQ,EAA0B,CAAC,CAAC;gBAC3E,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;gBACxC,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;KACF,CAAC;IAEF,OAAO;QACL,IAAI;QACJ,KAAK;QACL,KAAK,CAAC,KAAK;YACT,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC;YACtD,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;YACjE,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,MAAM,EAAE,SAAS,EAAE,CAAC;YAC1B,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;QACD,KAAK,CAAC,KAAK;YACT,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;gBACpB,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;YACtC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "@swf2es/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "swf2es command line: ahead-of-time compile SWF and ABC files, and run ABCs as avmshell does",
+  "keywords": [
+    "swf",
+    "flash",
+    "actionscript",
+    "as3",
+    "abc",
+    "avmshell",
+    "compiler",
+    "aot",
+    "cli"
+  ],
+  "homepage": "https://swf2es.github.io/swf2es/",
+  "bugs": "https://github.com/swf2es/swf2es/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/swf2es/swf2es.git",
+    "directory": "packages/cli"
+  },
+  "license": "Apache-2.0 AND MPL-2.0",
+  "type": "module",
+  "engines": {
+    "node": ">=22.18"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "swf2es": "./dist/main.js"
+  },
+  "files": [
+    "dist",
+    "!dist/**/.tsbuildinfo",
+    "src",
+    "LICENSE.third-party"
+  ],
+  "dependencies": {
+    "@swf2es/format": "0.1.0",
+    "@swf2es/player": "0.1.0",
+    "@swf2es/runtime": "0.1.0",
+    "@swf2es/codegen": "0.1.0"
+  }
 }