@swf2es/runtime 0.0.0-stage → 0.1.1

package/dist/avm2/options.d.ts

@@ -0,0 +1,105 @@
+import type { Abc, CompileUnit } from "./descriptors.js";
+import type { SharedBytesMemory } from "./natives/bytearray.js";
+import type { SyncInit, SyncMemory } from "./natives/sync.js";
+import type { Runtime } from "./runtime.js";
+export interface RuntimeOptions {
+    /** Where trace and print write a line. */
+    print?: (line: string) => void;
+    /**
+     * Behave as the debugger player: error messages carry avmplus' text
+     * ("Error #1009: Cannot access ..."), and System.isDebugger is true. By
+     * default they are the release player's and avmshell's, "Error #1009".
+     */
+    debugger?: boolean;
+    /**
+     * An ABC compiled for avmshell's Domain.loadBytes, which runs it at once:
+     * its module, or the VerifyError it was rejected with. The host compiles
+     * it, as the runtime does not include the compiler, into the domain
+     * `unit` names, with its findings; without it loadBytes is unsupported.
+     * Each module it evaluates needs a script of its own in stacks, a
+     * sourceURL comment, for Domain.currentDomain to find its code (see
+     * Runtime.codeDomain).
+     */
+    compileAbc?: (abc: Uint8Array, unit: CompileUnit) => ((rt: Runtime) => Abc) | number;
+    /** Where avmshell's File reads and writes: by default in memory, empty at the start. */
+    files?: ShellFiles;
+    /**
+     * The SWF version whose behaviour avmplus keeps where it changed (its
+     * BugCompatibility): avmshell's, 31, by default. A player sets its main
+     * SWF's.
+     */
+    swfVersion?: number;
+    /**
+     * The API version of user code, which the host resets codegen with too:
+     * Flash Player's, format's API_VERSION, by default; AIR's,
+     * AIR_API_VERSION, for an AIR host; one of neither series is a
+     * RangeError (checkApiVersion). What the
+     * runtime looks up by a string, as getDefinitionByName, JSON and AMF
+     * do, and what describeType lists, is what code of this version sees.
+     */
+    apiVersion?: number;
+    /**
+     * What starts avmshell's background workers, each on a thread of its
+     * own; without it a Worker can be made but not started.
+     */
+    workers?: ShellWorkerHost;
+    /** The background worker this runtime runs, as its host's thread was given it; by default the primordial. */
+    worker?: ShellWorkerInit;
+    /**
+     * The memory this runtime's Mutexes and Conditions live in, shared with
+     * the other workers of its primordial, and the worker it runs: by
+     * default, for avmshell's workers, worker's; else memory of its own, as
+     * the primordial's (natives/sync.ts).
+     */
+    sync?: SyncInit;
+}
+/** Starts the threads of avmshell's background workers. */
+export interface ShellWorkerHost {
+    /**
+     * Start a thread that runs `init`'s worker: a runtime made with
+     * `worker: init`, in which init.code runs as avmshell runs an ABC, or,
+     * when it is null, the ABCs the primordial was given, as
+     * createWorkerFromPrimordial has them. What it prints goes where the
+     * primordial's does.
+     */
+    start(init: ShellWorkerInit): ShellThread;
+    /**
+     * Make a shareable ByteArray's memory known to every thread of the
+     * primordial's, those started later too, before a shared property names
+     * it; without it, one is shared only with this thread.
+     */
+    share?(memory: SharedBytesMemory): void;
+    /** The memory another thread shared by `id`, or undefined if it has not come. */
+    shared?(id: number): SharedBytesMemory | undefined;
+}
+export interface ShellThread {
+    /** Stop the thread, wherever its code is; what it gives resolves once the thread has stopped. */
+    terminate(): Promise<unknown> | undefined;
+}
+/** What a background worker's thread is given, which crosses to it as it is (structured clone). */
+export interface ShellWorkerInit {
+    /** The worker's number among those its primordial made, 0 being the primordial. */
+    id: number;
+    memory: ShellWorkersMemory;
+    /** The ABC it runs, or null for the primordial's. */
+    code: Uint8Array | null;
+}
+/** The memory the workers share: their states and parents, and their shared properties. */
+export interface ShellWorkersMemory {
+    control: ArrayBuffer | SharedArrayBuffer;
+    table: ArrayBuffer | SharedArrayBuffer;
+    /** Their Mutexes and Conditions. */
+    sync: SyncMemory;
+}
+/** avmshell's file system, as its File sees it. */
+export interface ShellFiles {
+    /** A file's bytes, or null if it cannot be opened. */
+    read(name: string): Uint8Array | null;
+    /** Whether the file could be written. */
+    write(name: string, bytes: Uint8Array): boolean;
+}
+/** Files that live as long as the runtime. */
+export declare function memoryFiles(): ShellFiles;
+/** Where output goes by default: the host's console. */
+export declare function defaultPrint(line: string): void;
+//# sourceMappingURL=options.d.ts.map

package/dist/avm2/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/avm2/options.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,WAAW,cAAc;IAC7B,0CAA0C;IAC1C,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,KAAK,CAAC,CAAC,EAAE,EAAE,OAAO,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC;IACrF,wFAAwF;IACxF,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,6GAA6G;IAC7G,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB;;;;;OAKG;IACH,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED,2DAA2D;AAC3D,MAAM,WAAW,eAAe;IAC9B;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAAC;IAC1C;;;;OAIG;IACH,KAAK,CAAC,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxC,iFAAiF;IACjF,MAAM,CAAC,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;CACpD;AAED,MAAM,WAAW,WAAW;IAC1B,iGAAiG;IACjG,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;CAC3C;AAED,mGAAmG;AACnG,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,kBAAkB,CAAC;IAC3B,qDAAqD;IACrD,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;CACzB;AAED,2FAA2F;AAC3F,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,WAAW,GAAG,iBAAiB,CAAC;IACzC,KAAK,EAAE,WAAW,GAAG,iBAAiB,CAAC;IACvC,oCAAoC;IACpC,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACtC,yCAAyC;IACzC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC;CACjD;AAED,8CAA8C;AAC9C,wBAAgB,WAAW,IAAI,UAAU,CASxC;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE/C"}

package/dist/avm2/options.js

@@ -0,0 +1,17 @@
+// What a host gives a runtime when it makes one, and what it does without.
+/** Files that live as long as the runtime. */
+export function memoryFiles() {
+    const files = new Map();
+    return {
+        read: (name) => files.get(name) ?? null,
+        write: (name, bytes) => {
+            files.set(name, bytes.slice());
+            return true;
+        },
+    };
+}
+/** Where output goes by default: the host's console. */
+export function defaultPrint(line) {
+    globalThis.console?.log(line);
+}
+//# sourceMappingURL=options.js.map

package/dist/avm2/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/avm2/options.ts"],"names":[],"mappings":"AAAA,2EAA2E;AA6G3E,8CAA8C;AAC9C,MAAM,UAAU,WAAW;IACzB,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IAC5C,OAAO;QACL,IAAI,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI;QACvC,KAAK,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACrB,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YAC/B,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,YAAY,CAAC,IAAY;IACtC,UAAwD,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;AAC/E,CAAC"}

package/dist/avm2/player-messages.d.ts

@@ -0,0 +1,3 @@
+/** Every error message the debugger player knows: avmplus' own, and Flash Player's over them. */
+export declare const errorMessages: Record<number, string>;
+//# sourceMappingURL=player-messages.d.ts.map

package/dist/avm2/player-messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"player-messages.d.ts","sourceRoot":"","sources":["../../src/avm2/player-messages.ts"],"names":[],"mappings":"AAsiBA,iGAAiG;AACjG,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAsC,CAAC"}