@swf2es/cli 0.0.0-stage → 0.1.1

package/dist/aot.d.ts

@@ -0,0 +1,98 @@
+import { AIR_API_VERSION, API_VERSION, type Codegen } from "@swf2es/codegen";
+import { type ActionList } from "@swf2es/format";
+export { AIR_API_VERSION, API_VERSION };
+export interface AbcInput {
+    /** DoABC2's name, "" for a DoABC or a bare ABC. */
+    name: string;
+    /** DoABC2's lazy flag: its scripts run on first use, not when it loads. */
+    lazy: boolean;
+    abc: Uint8Array;
+}
+export interface Input {
+    kind: "swf" | "abc";
+    /** The SWF's version, 0 for a bare ABC. */
+    version: number;
+    abcs: AbcInput[];
+    /** An AVM1 SWF's action blocks; null for an AS3 SWF or an ABC. */
+    avm1: Avm1Input | null;
+}
+export interface Avm1Input {
+    /** The SWF's decompressed bytes, which the blocks' ranges are of. */
+    bytes: Uint8Array;
+    actions: ActionList;
+}
+/** An AVM1 SWF's module. */
+export interface ActionsModule {
+    /** The ES module's source. */
+    module: string;
+    /** SHA-256 of the SWF's decompressed bytes, as the key names it. */
+    hash: string;
+    /**
+     * The SHA-256 of its key, codegen's actionsKey, as the player's module
+     * cache is to look it up; null for a compiler without an identity.
+     */
+    key: string | null;
+    /** How many blocks it has an entry for. */
+    blocks: number;
+}
+export interface Module {
+    name: string;
+    /** SHA-256 of the ABC, as the player and the cache key name it. */
+    hash: string;
+    lazy: boolean;
+    /** The ES module's source. */
+    module: string;
+    /**
+     * What compiling it fixed in the compiler's domain, which the player
+     * replays in its place (Codegen.compileModuleLogged); null where it
+     * cannot be.
+     */
+    log: string | null;
+    /**
+     * The SHA-256 of its key, as the player's module cache looks it up when
+     * it loads the SWF as its main movie (codegen's moduleKey); null for a
+     * compiler without an identity, or a module without a log.
+     */
+    key: string | null;
+}
+/** Input the command cannot compile, with why. */
+export declare class InputError extends Error {
+}
+/**
+ * The ABCs of a SWF, in tag order as the player links them, or a bare ABC
+ * as one; for an AVM1 SWF its action blocks instead, as the player runs
+ * its code as AVM1 and never compiles its DoABCs.
+ */
+export declare function readInput(bytes: Uint8Array): Input;
+export declare function sha256(bytes: Uint8Array): string;
+export declare class RejectedError extends Error {
+    readonly what: string;
+    readonly verifyError: number;
+    /** A library's, not the input's. */
+    readonly library: boolean;
+    constructor(what: string, verifyError: number, 
+    /** A library's, not the input's. */
+    library: boolean);
+}
+/**
+ * The libraries' modules, those asked for by `keepLibraries`, and the
+ * ABCs' modules, in order, compiled at `apiVersion`: Flash Player's, or
+ * AIR_API_VERSION for a host that plays them as AIR does (the player's
+ * `air`), whose keys are its alone. The libraries compile whether kept or
+ * not: the player compiles each, and what a compile resolves of an ABC is
+ * what later ABCs compile against.
+ */
+export declare function compileAhead(codegen: Codegen, libraries: {
+    name: string;
+    abc: Uint8Array;
+}[], abcs: AbcInput[], keepLibraries?: boolean, apiVersion?: number): {
+    libraries: Module[];
+    libraryInputs: {
+        name: string;
+        abc: Uint8Array;
+    }[];
+    abcs: Module[];
+};
+/** An AVM1 SWF's action blocks' module, as the player is to compile it, and its key. */
+export declare function compileActionsAhead(codegen: Codegen, input: Avm1Input): ActionsModule;
+//# sourceMappingURL=aot.d.ts.map

package/dist/aot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aot.d.ts","sourceRoot":"","sources":["../src/aot.ts"],"names":[],"mappings":"AASA,OAAO,EACL,eAAe,EACf,WAAW,EAEX,KAAK,OAAO,EAIb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,KAAK,UAAU,EAAgD,MAAM,gBAAgB,CAAC;AAG/F,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,CAAC;AAExC,MAAM,WAAW,QAAQ;IACvB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,UAAU,CAAC;CACjB;AAED,MAAM,WAAW,KAAK;IACpB,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IACpB,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,kEAAkE;IAClE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,qEAAqE;IACrE,KAAK,EAAE,UAAU,CAAC;IAClB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,4BAA4B;AAC5B,MAAM,WAAW,aAAa;IAC5B,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,8BAA8B;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB;;;;OAIG;IACH,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAID,kDAAkD;AAClD,qBAAa,UAAW,SAAQ,KAAK;CAAG;AAExC;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,UAAU,GAAG,KAAK,CA2ClD;AAED,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAEhD;AAED,qBAAa,aAAc,SAAQ,KAAK;IAEpC,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO;IAJ3B,YACW,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM;IAC5B,oCAAoC;IAC3B,OAAO,EAAE,OAAO,EAG1B;CACF;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,UAAU,CAAA;CAAE,EAAE,EAC9C,IAAI,EAAE,QAAQ,EAAE,EAChB,aAAa,UAAQ,EACrB,UAAU,SAAc,GACvB;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,aAAa,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,UAAU,CAAA;KAAE,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CA0D7F;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,GAAG,aAAa,CAOrF"}

package/dist/aot.js

@@ -0,0 +1,145 @@
+// Ahead-of-time compilation: a SWF's ABCs compiled as the player compiles
+// them for a SWF it loads as its main movie, so that each module is byte
+// for byte what the browser would compile (the JIT/AOT invariant in
+// docs/architecture/overview.md). The steps are Code's in packages/player, in the
+// same order: the libraries added to the root domain, each compiled as it
+// is added, then the SWF's DoABCs all added to a child of the root before
+// any of them compiles. An AVM1 SWF's action blocks compile to one module
+// of their own (compileActionsAhead), which needs no library.
+import { createHash } from "node:crypto";
+import { AIR_API_VERSION, API_VERSION, actionsKey, libraryLog, moduleKey, } from "@swf2es/codegen";
+import { isAs3, readActions, readDoAbc, readSwf, tags } from "@swf2es/format";
+import { avm2 } from "@swf2es/runtime";
+export { AIR_API_VERSION, API_VERSION };
+const SIGNATURES = new Set(["FWS", "CWS", "ZWS"]);
+/** Input the command cannot compile, with why. */
+export class InputError extends Error {
+}
+/**
+ * The ABCs of a SWF, in tag order as the player links them, or a bare ABC
+ * as one; for an AVM1 SWF its action blocks instead, as the player runs
+ * its code as AVM1 and never compiles its DoABCs.
+ */
+export function readInput(bytes) {
+    const signature = String.fromCharCode(...bytes.subarray(0, 3));
+    if (!SIGNATURES.has(signature)) {
+        // ABC headers name a minor and major version: 46 for Flash, 47 for AIR float.
+        if (bytes.length < 4 || (bytes[2] !== 46 && bytes[2] !== 47) || bytes[3] !== 0) {
+            throw new InputError("neither a SWF nor an ABC");
+        }
+        return { kind: "abc", version: 0, abcs: [{ name: "", lazy: false, abc: bytes }], avm1: null };
+    }
+    let swf;
+    try {
+        swf = readSwf(bytes);
+    }
+    catch (e) {
+        throw new InputError(`a truncated or corrupt SWF (${e.message})`);
+    }
+    const version = swf.header.version;
+    if (!isAs3(swf)) {
+        return {
+            kind: "swf",
+            version,
+            abcs: [],
+            avm1: { bytes: swf.bytes, actions: readActions(swf) },
+        };
+    }
+    // A DoABC cut short would reach codegen as a malformed ABC and read as
+    // the code's error; a SWF cut elsewhere the player plays, as far as it goes.
+    const last = swf.tags.at(-1);
+    if (swf.truncated && (last?.code === tags.DoABC || last?.code === tags.DoABC2)) {
+        throw new InputError("a truncated SWF: the file ends inside a DoABC tag");
+    }
+    const abcs = [];
+    for (const t of swf.tags) {
+        if (t.code === tags.DoABC || t.code === tags.DoABC2) {
+            abcs.push(readDoAbc(swf.bytes, t));
+        }
+    }
+    return { kind: "swf", version, abcs, avm1: null };
+}
+export function sha256(bytes) {
+    return createHash("sha256").update(bytes).digest("hex");
+}
+export class RejectedError extends Error {
+    what;
+    verifyError;
+    library;
+    constructor(what, verifyError, 
+    /** A library's, not the input's. */
+    library) {
+        super(`${what} was rejected: VerifyError #${verifyError}`);
+        this.what = what;
+        this.verifyError = verifyError;
+        this.library = library;
+    }
+}
+/**
+ * The libraries' modules, those asked for by `keepLibraries`, and the
+ * ABCs' modules, in order, compiled at `apiVersion`: Flash Player's, or
+ * AIR_API_VERSION for a host that plays them as AIR does (the player's
+ * `air`), whose keys are its alone. The libraries compile whether kept or
+ * not: the player compiles each, and what a compile resolves of an ABC is
+ * what later ABCs compile against.
+ */
+export function compileAhead(codegen, libraries, abcs, keepLibraries = false, apiVersion = API_VERSION) {
+    codegen.reset(apiVersion);
+    if (abcs.some(({ abc }) => {
+        const version = codegen.abcVersion(abc);
+        return version?.major === 47 && version.minor >= 16;
+    }) &&
+        !avm2.hasFloatLibrary(libraries.map((lib) => lib.abc))) {
+        libraries = [...libraries, { name: "float", abc: avm2.floatLibrary }];
+    }
+    const hashes = [];
+    const builtins = [];
+    const add = (what, abc, builtin, domain) => {
+        const error = codegen.add(abc, builtin, domain);
+        if (error) {
+            throw new RejectedError(what, error, builtin);
+        }
+        hashes.push(sha256(abc));
+        builtins.push(builtin);
+        return hashes.length - 1;
+    };
+    // Keyed before it compiles, as the player keys it before it asks its cache.
+    const compile = (index, libraryDigest) => {
+        const keyText = codegen.identity === null
+            ? null
+            : moduleKey(codegen, index, { hashes, builtins }, libraryDigest);
+        const { module, log } = codegen.compileModuleLogged(hashes, index);
+        const key = keyText === null || log === null ? null : sha256Text(keyText);
+        return { hash: hashes[index], module, log, key };
+    };
+    const libraryModules = [];
+    for (const { name, abc } of libraries) {
+        const index = add(`library ${name}`, abc, true, 0);
+        const compiled = compile(index, null);
+        if (keepLibraries) {
+            libraryModules.push({ name, lazy: false, ...compiled });
+        }
+    }
+    // The main movie's application domain, a child of the root's, as the player's mainDomain.
+    const domain = codegen.childDomain(0);
+    const indices = abcs.map(({ name, abc }, i) => add(`ABC ${i}${name ? ` (${name})` : ""}`, abc, false, domain));
+    // The libraries' part of the log, by its digest, as the player's keys name it once a SWF is added.
+    const count = libraries.length;
+    const digest = indices.length > 0
+        ? { count, digest: sha256Text(libraryLog(codegen, indices[0], count)) }
+        : null;
+    const modules = abcs.map(({ name, lazy }, i) => ({ name, lazy, ...compile(indices[i], digest) }));
+    return { libraries: libraryModules, libraryInputs: libraries, abcs: modules };
+}
+/** An AVM1 SWF's action blocks' module, as the player is to compile it, and its key. */
+export function compileActionsAhead(codegen, input) {
+    const { bytes, actions } = input;
+    const hash = sha256(bytes);
+    const key = codegen.identity === null ? null : sha256Text(actionsKey(codegen, hash, actions.version));
+    const module = codegen.compileActionsModule(bytes, actions);
+    return { module, hash, key, blocks: actions.blocks.length };
+}
+function sha256Text(text) {
+    return createHash("sha256").update(text, "utf8").digest("hex");
+}
+//# sourceMappingURL=aot.js.map

package/dist/aot.js.map

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

package/dist/args.d.ts

@@ -0,0 +1,31 @@
+export interface Command {
+    name: string;
+    /** One line for the list of commands. */
+    summary: string;
+    usage: string;
+    main(argv: string[]): Promise<void>;
+}
+/** The options every command takes, which parseArgs' options spread. */
+export declare const COMMON_OPTIONS: {
+    readonly help: {
+        readonly type: "boolean";
+        readonly short: "h";
+    };
+    readonly version: {
+        readonly type: "boolean";
+        readonly short: "v";
+    };
+};
+export declare const COMMON_USAGE = "  -h, --help           show this\n  -v, --version        print the compiler's version";
+export declare function printVersion(): void;
+/**
+ * `command`'s arguments as `parse` reads them, a mistake in them a usage
+ * error; null once -h or -v has been answered, and the command is done.
+ */
+export declare function parse<T extends {
+    values: {
+        help?: boolean;
+        version?: boolean;
+    };
+}>(command: Command, read: () => T): T | null;
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAED,wEAAwE;AACxE,eAAO,MAAM,cAAc;aACzB,IAAI;iBAAI,IAAI,EAAE,SAAS;iBAAE,KAAK,EAAE,GAAG;;aACnC,OAAO;iBAAI,IAAI,EAAE,SAAS;iBAAE,KAAK,EAAE,GAAG;;CAC9B,CAAC;AAEX,eAAO,MAAM,YAAY,0FAC2B,CAAC;AAErD,wBAAgB,YAAY,IAAI,IAAI,CAEnC;AAED;;;GAGG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,EAC/E,OAAO,EAAE,OAAO,EAChB,IAAI,EAAE,MAAM,CAAC,GACZ,CAAC,GAAG,IAAI,CAmBV"}

package/dist/args.js

@@ -0,0 +1,37 @@
+// What every command shares of its command line: the options all take,
+// and a mistake in it reported as a usage error.
+import { COMPILER_VERSION } from "@swf2es/codegen";
+import { usageError } from "./output.js";
+/** The options every command takes, which parseArgs' options spread. */
+export const COMMON_OPTIONS = {
+    help: { type: "boolean", short: "h" },
+    version: { type: "boolean", short: "v" },
+};
+export const COMMON_USAGE = `  -h, --help           show this
+  -v, --version        print the compiler's version`;
+export function printVersion() {
+    console.log(`swf2es ${COMPILER_VERSION}`);
+}
+/**
+ * `command`'s arguments as `parse` reads them, a mistake in them a usage
+ * error; null once -h or -v has been answered, and the command is done.
+ */
+export function parse(command, read) {
+    let parsed;
+    try {
+        parsed = read();
+    }
+    catch (e) {
+        usageError(e.message, command.name);
+    }
+    if (parsed.values.help) {
+        console.log(command.usage);
+        return null;
+    }
+    if (parsed.values.version) {
+        printVersion();
+        return null;
+    }
+    return parsed;
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,iDAAiD;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAUzC,wEAAwE;AACxE,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;IACrC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;CAChC,CAAC;AAEX,MAAM,CAAC,MAAM,YAAY,GAAG;oDACwB,CAAC;AAErD,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,GAAG,CAAC,UAAU,gBAAgB,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,KAAK,CACnB,OAAgB,EAChB,IAAa;IAEb,IAAI,MAAS,CAAC;IACd,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,EAAE,CAAC;IAClB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,UAAU,CAAE,CAAW,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC1B,YAAY,EAAE,CAAC;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/commands/compile.d.ts

@@ -0,0 +1,3 @@
+import { type Command } from "../args.js";
+export declare const compile: Command;
+//# sourceMappingURL=compile.d.ts.map

package/dist/commands/compile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/commands/compile.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAgC,KAAK,OAAO,EAAS,MAAM,YAAY,CAAC;AAwF/E,eAAO,MAAM,OAAO,EAAE,OA6HrB,CAAC"}

package/dist/commands/compile.js

@@ -0,0 +1,233 @@
+// swf2es compile: a SWF's or an ABC's modules, ahead of time, as the player
+// compiles them for its main movie, with a manifest; an AVM1 SWF's one
+// module of its action blocks.
+import { mkdir, readFile, rm, writeFile } from "node:fs/promises";
+import { basename, extname, join } from "node:path";
+import { parseArgs } from "node:util";
+import { COMPILER_VERSION, createCodegen } from "@swf2es/codegen";
+import { airLibrary, builtinLibrary, playerglobalLibrary } from "@swf2es/player/libraries";
+import { AIR_API_VERSION, API_VERSION, compileActionsAhead, compileAhead, InputError, RejectedError, readInput, sha256, } from "../aot.js";
+import { COMMON_OPTIONS, COMMON_USAGE, parse } from "../args.js";
+import { codegenModule, read, readLibraries, writing } from "../files.js";
+import { fail, usageError } from "../output.js";
+const USAGE = `usage: swf2es compile <file.swf|file.abc> [options]
+       swf2es <file.swf|file.abc> [options]
+
+Compiles the ABCs of a SWF (its DoABC and DoABC2 tags, in order), or a bare
+ABC, to ES modules as the player compiles them for a SWF it loads as its
+main movie, byte for byte. Writes a .js file per ABC, a .log file of what
+its compile fixed, which the player replays in its place, and a
+manifest.json naming them, their ABCs' hashes, the keys the player's
+module cache looks them up by, and the compiler. An AVM1 SWF (one whose
+FileAttributes has no ActionScript 3 flag) compiles to one module of its
+action blocks, avm1.js, which takes no library.
+
+options:
+  -o, --out <dir>      where to write (default: <file name>.swf2es)
+  --lib <file.abc>     a library the code links against, loaded into the
+                       root domain in the order given; repeat for each.
+                       Default: what the player loads, which swf2es ships:
+                       avmplus' builtin.abc and the player's playerglobal,
+                       and with --air AIR's library after them
+  --emit-libraries     write the libraries' modules too
+  --air                compile for a player that plays the SWF as AIR does
+                       (its \`air\` option), AIR's API defined; a player
+                       in the other mode looks none of the modules up.
+                       Refused for an AVM1 SWF, which has no API versions
+  -q, --quiet          print nothing but errors
+${COMMON_USAGE}
+
+exit status: 0 on success, 2 for a mistake in the command line, 1 for
+anything else (an unreadable or rejected input or library, or an output
+that cannot be written)`;
+const OPTIONS = {
+    out: { type: "string", short: "o" },
+    lib: { type: "string", multiple: true },
+    "emit-libraries": { type: "boolean" },
+    air: { type: "boolean" },
+    quiet: { type: "boolean", short: "q" },
+    ...COMMON_OPTIONS,
+};
+/**
+ * manifest.json's format: 2 added each module's log, key and lengths, and
+ * named the compiler by its stamped identity rather than its file's hash.
+ * An AVM1 SWF's `avm1` entry, which a reader of the ABCs' entries need not
+ * know, came later without a new version.
+ */
+const MANIFEST_VERSION = 2;
+/** What a previous run wrote to `out`, as its manifest names it, so that no stale module stays beside a new manifest. */
+async function removeModules(out) {
+    let old;
+    try {
+        old = JSON.parse(await readFile(join(out, "manifest.json"), "utf8"));
+    }
+    catch {
+        return;
+    }
+    const entries = [old?.libraries, old?.abcs, [old?.avm1]].flatMap((list) => Array.isArray(list) ? list : []);
+    // Only names this command writes: a manifest edited by hand names nothing else to delete.
+    for (const entry of entries) {
+        const name = entry?.module;
+        if (typeof name === "string" && /^((abc|lib)-\d+|avm1)\.js$/.test(name)) {
+            for (const file of [name, name.replace(/\.js$/, ".log")]) {
+                await writing(join(out, file), () => rm(join(out, file), { force: true }));
+            }
+        }
+    }
+}
+/**
+ * The libraries the player loads, as @swf2es/web gives them, AIR's after
+ * the rest for an AIR player; the manifest's names tell swf2es's
+ * playerglobal from Flash Player's.
+ */
+function playerLibraries(air = false) {
+    const libraries = [
+        { name: "builtin", abc: builtinLibrary },
+        { name: "playerglobal-swf2es", abc: playerglobalLibrary },
+    ];
+    return air ? [...libraries, { name: "air", abc: airLibrary }] : libraries;
+}
+export const compile = {
+    name: "compile",
+    summary: "compile a SWF's or an ABC's modules ahead of time, with a manifest",
+    usage: USAGE,
+    async main(argv) {
+        const parsed = parse(compile, () => parseArgs({ args: argv, allowPositionals: true, options: OPTIONS }));
+        if (!parsed) {
+            return;
+        }
+        const { values, positionals } = parsed;
+        if (positionals.length !== 1) {
+            usageError(`expected one input file, got ${positionals.length}`, "compile");
+        }
+        const file = positionals[0];
+        const bytes = await read(file, "input");
+        let input;
+        try {
+            input = readInput(bytes);
+        }
+        catch (e) {
+            fail(e instanceof InputError ? `${file}: ${e.message}` : String(e.stack ?? e));
+        }
+        const out = values.out ?? `${basename(file, extname(file))}.swf2es`;
+        if (input.avm1) {
+            // AVM1 has no API versions: its module is the same for every player.
+            if (values.air) {
+                usageError(`${file} is an AVM1 SWF, which --air does not apply to`, "compile");
+            }
+            await compileAvm1(file, bytes, input.avm1, out, values.quiet ?? false);
+            return;
+        }
+        const libs = values.lib ? await readLibraries(values.lib) : playerLibraries(values.air);
+        if (input.abcs.length === 0) {
+            fail(`${file}: no DoABC or DoABC2 tag, so no ActionScript 3 to compile`);
+        }
+        const codegen = await createCodegen(await codegenModule());
+        const started = performance.now();
+        let compiled;
+        try {
+            compiled = compileAhead(codegen, libs, input.abcs, values["emit-libraries"], values.air ? AIR_API_VERSION : API_VERSION);
+        }
+        catch (e) {
+            if (!(e instanceof RejectedError)) {
+                fail(String(e.stack ?? e));
+            }
+            fail(e.library ? e.message : `${file}: ${e.message}`);
+        }
+        const ms = performance.now() - started;
+        await writing(out, () => mkdir(out, { recursive: true }));
+        await removeModules(out);
+        let size = 0;
+        const write = async (file, text) => {
+            await writing(join(out, file), () => writeFile(join(out, file), text));
+            size += Buffer.byteLength(text);
+            return file;
+        };
+        // A module, its log beside it, and what a host's precompiled module cache
+        // looks it up by and checks it with: the key and the two's lengths.
+        const entry = async (name, m) => {
+            const module = await write(`${name}.js`, m.module);
+            if (m.log === null || m.key === null) {
+                return { module };
+            }
+            const log = await write(`${name}.log`, m.log);
+            return { module, log, key: m.key, lengths: [m.module.length, m.log.length] };
+        };
+        // The compiler is named by the identity stamped into its binary, which
+        // the keys name too, so that a host can tell what another build wrote;
+        // an ABC by its hash, as its module names it, with the ABCs it was
+        // linked against.
+        const manifest = {
+            manifestVersion: MANIFEST_VERSION,
+            compiler: { name: "swf2es", version: COMPILER_VERSION, identity: codegen.identity },
+            // The version the modules were compiled at, which their keys name too.
+            apiVersion: codegen.apiVersion,
+            input: {
+                file: basename(file),
+                kind: input.kind,
+                version: input.version,
+                sha256: sha256(bytes),
+            },
+            libraries: await Promise.all(compiled.libraryInputs.map(async ({ name, abc }, i) => {
+                const m = compiled.libraries[i];
+                const lib = { name, sha256: sha256(abc) };
+                return m ? { ...lib, ...(await entry(`lib-${i}`, m)) } : lib;
+            })),
+            abcs: await Promise.all(compiled.abcs.map(async (m, i) => ({
+                name: m.name,
+                sha256: m.hash,
+                lazy: m.lazy,
+                ...(await entry(`abc-${i}`, m)),
+            }))),
+        };
+        const manifestPath = join(out, "manifest.json");
+        await writing(manifestPath, () => writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`));
+        if (!values.quiet) {
+            const count = compiled.abcs.length + compiled.libraries.length;
+            console.log(`${file}: ${count} module${count === 1 ? "" : "s"}, ${size} bytes, ` +
+                `compiled in ${Math.round(ms)} ms, in ${out}`);
+        }
+    },
+};
+/**
+ * An AVM1 SWF's module, avm1.js, and its manifest: the module's key, as
+ * the player's module cache is to look it up, the SHA-256 of the SWF's
+ * decompressed bytes it names, its length and how many blocks it has.
+ */
+async function compileAvm1(file, bytes, avm1, out, quiet) {
+    const codegen = await createCodegen(await codegenModule());
+    const started = performance.now();
+    const compiled = compileActionsAhead(codegen, avm1);
+    const ms = performance.now() - started;
+    await writing(out, () => mkdir(out, { recursive: true }));
+    await removeModules(out);
+    const module = "avm1.js";
+    await writing(join(out, module), () => writeFile(join(out, module), compiled.module));
+    const manifest = {
+        manifestVersion: MANIFEST_VERSION,
+        compiler: { name: "swf2es", version: COMPILER_VERSION, identity: codegen.identity },
+        apiVersion: API_VERSION,
+        input: {
+            file: basename(file),
+            kind: "swf",
+            version: avm1.actions.version,
+            sha256: sha256(bytes),
+        },
+        libraries: [],
+        abcs: [],
+        avm1: {
+            module,
+            sha256: compiled.hash,
+            blocks: compiled.blocks,
+            ...(compiled.key === null ? {} : { key: compiled.key, length: compiled.module.length }),
+        },
+    };
+    const manifestPath = join(out, "manifest.json");
+    await writing(manifestPath, () => writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`));
+    if (!quiet) {
+        const size = Buffer.byteLength(compiled.module);
+        const blocks = `${compiled.blocks} AVM1 block${compiled.blocks === 1 ? "" : "s"}`;
+        console.log(`${file}: ${blocks}, 1 module, ${size} bytes, compiled in ${Math.round(ms)} ms, in ${out}`);
+    }
+}
+//# sourceMappingURL=compile.js.map

package/dist/commands/compile.js.map

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

package/dist/commands/help.d.ts

@@ -0,0 +1,6 @@
+import { type Command } from "../args.js";
+export declare const help: Command;
+export declare const commands: Map<string, Command>;
+/** The command's own usage: its commands, and the bare form compile keeps. */
+export declare function usage(): string;
+//# sourceMappingURL=help.d.ts.map

package/dist/commands/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgC,KAAK,OAAO,EAAS,MAAM,YAAY,CAAC;AAK/E,eAAO,MAAM,IAAI,EAAE,OAkClB,CAAC;AAEF,eAAO,MAAM,QAAQ,sBAAyE,CAAC;AAE/F,8EAA8E;AAC9E,wBAAgB,KAAK,IAAI,MAAM,CAa9B"}