@swf2es/cli 0.1.16 → 0.1.18

package/dist/as3-types.d.ts

@@ -0,0 +1,27 @@
+import type { AbcSurface } from "@swf2es/format";
+/** A library the ABCs link against, whose declarations are written elsewhere. */
+export interface DeclaredLibrary {
+    abcs: AbcSurface[];
+    /** The type its instance interfaces are keyed in by qualified name, as the output spells it. */
+    classes: string;
+}
+export interface DeclarationsOptions {
+    /** The ABCs whose classes are declared, in the order they load: the first definition of a name wins. */
+    abcs: AbcSurface[];
+    /** The maps' names: `${name}Classes` and `${name}Statics`. */
+    name: string;
+    /** What the ABCs link against, in the order they load, before the ABCs. */
+    libraries: DeclaredLibrary[];
+    /** The comment the output starts with, without its `// ` prefixes. */
+    header: string[];
+    /** The import declarations the output needs for `ref`, `value` and the libraries' maps. */
+    imports: string[];
+    /** How the output spells @swf2es/runtime's avm2 Ref and Value types. */
+    ref: string;
+    value: string;
+    /** Parameter names for a method whose ABC has none, by its class's qualified name and its own. */
+    paramNames?: (qualified: string, method: string) => string[] | undefined;
+}
+/** The declarations of the classes `options.abcs` define, as a TypeScript module. */
+export declare function as3Declarations(options: DeclarationsOptions): string;
+//# sourceMappingURL=as3-types.d.ts.map

package/dist/as3-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"as3-types.d.ts","sourceRoot":"","sources":["../src/as3-types.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAuB,UAAU,EAAY,MAAM,gBAAgB,CAAC;AAEhF,iFAAiF;AACjF,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,gGAAgG;IAChG,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,wGAAwG;IACxG,IAAI,EAAE,UAAU,EAAE,CAAC;IACnB,8DAA8D;IAC9D,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,sEAAsE;IACtE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,2FAA2F;IAC3F,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,wEAAwE;IACxE,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,kGAAkG;IAClG,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,EAAE,GAAG,SAAS,CAAC;CAC1E;AAwHD,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAsPpE"}

package/dist/as3-types.js

@@ -0,0 +1,299 @@
+// TypeScript declarations of the classes ABCs define: for each class, an
+// interface of its instances' public members and one of its class
+// object's, as natives and hosts reach them through Runtime.prop, setProp
+// and callProp (docs/architecture/runtime.md, "AS3 classes in
+// TypeScript"). The libraries the ABCs link against name the classes they
+// extend and the types they use; what none defines is `Value`.
+//
+// Only type imports, so that node runs this file as it is
+// (tools/as3-types.ts); the command reads the ABCs (commands/types.ts).
+/** A name as the surface spells it ("Array", "flash.geom::Point", "{package:@v0}::uint"), taken apart. */
+function parseName(raw) {
+    if (raw.startsWith("{")) {
+        const end = raw.lastIndexOf("}::");
+        // One namespace, or the same one in several API versions: the first's kind and URI.
+        const ns = raw.slice(1, end).split(",")[0];
+        const colon = ns.indexOf(":");
+        const kind = colon < 0 ? ns : ns.slice(0, colon);
+        return {
+            kind: kind.replace(/#\d+$/, ""),
+            uri: (colon < 0 ? "" : ns.slice(colon + 1)).replace(/@v\d+$/, ""),
+            local: raw.slice(end + 3),
+        };
+    }
+    const at = raw.lastIndexOf("::");
+    return {
+        kind: "package",
+        uri: at < 0 ? "" : raw.slice(0, at),
+        local: at < 0 ? raw : raw.slice(at + 2),
+    };
+}
+/**
+ * A class's qualified name, "flash.geom::Rectangle" or a top-level
+ * "Array", or null for one no other ABC can name; the builtin's Vector
+ * classes, internal to __AS3__.vec, as the types of Vectors.
+ */
+function classKey(raw) {
+    const n = parseName(raw);
+    if (n.kind === "package" || (n.kind === "internal" && n.uri === "__AS3__.vec")) {
+        return n.uri ? `${n.uri}::${n.local}` : n.local;
+    }
+    return null;
+}
+const IDENTIFIER = /^[A-Za-z_$][\w$]*$/;
+/** Words a parameter may not be named. */
+const RESERVED = new Set(("break case catch class const continue debugger default delete do else enum export " +
+    "extends false finally for function if implements import in instanceof interface let " +
+    "new null package private protected public return static super switch this throw true " +
+    "try typeof var void while with yield await arguments eval").split(" "));
+function memberName(local) {
+    return IDENTIFIER.test(local) && local !== "constructor" ? local : JSON.stringify(local);
+}
+/** The public members of `traits`, a getter and a setter of one name as one property. */
+function membersOf(traits, isInterface) {
+    const out = new Map();
+    for (const t of traits) {
+        const n = parseName(t.name);
+        // An interface's methods are in its own namespace, and public in each class that implements it.
+        if (n.kind !== "package" && !(isInterface && n.kind === "namespace")) {
+            continue;
+        }
+        switch (t.kind) {
+            case "slot":
+            case "const":
+                out.set(n.local, {
+                    kind: "property",
+                    type: t.type,
+                    readable: true,
+                    writable: t.kind === "slot",
+                    constant: t.kind === "const",
+                });
+                break;
+            case "getter":
+            case "setter": {
+                const had = out.get(n.local);
+                const type = t.kind === "getter" ? t.method.returns : (t.method.params[0]?.type ?? "*");
+                const was = had?.kind === "property" ? had : null;
+                out.set(n.local, {
+                    kind: "property",
+                    type: t.kind === "getter" || !was ? type : was.type,
+                    readable: t.kind === "getter" || (was?.readable ?? false),
+                    writable: t.kind === "setter" || (was?.writable ?? false),
+                    constant: false,
+                });
+                break;
+            }
+            case "method":
+                out.set(n.local, { kind: "method", method: t.method });
+                break;
+        }
+    }
+    return out;
+}
+/** The declarations of the classes `options.abcs` define, as a TypeScript module. */
+export function as3Declarations(options) {
+    const { ref, value } = options;
+    const definitions = new Map();
+    const define = (abcs, own, library) => {
+        for (const abc of abcs) {
+            for (const script of abc.scripts) {
+                for (const t of script.traits) {
+                    const key = t.kind === "class" ? classKey(t.name) : null;
+                    if (t.kind === "class" && key !== null && !definitions.has(key)) {
+                        definitions.set(key, { key, cls: t.class, own, library });
+                    }
+                }
+            }
+        }
+    };
+    for (const library of options.libraries) {
+        define(library.abcs, false, library);
+    }
+    define(options.abcs, true);
+    // Each class's interface's name: its qualified name as an identifier,
+    // "As3_flash_geom_Rectangle", and its class object's with a $ after it,
+    // told apart by a number where two would meet.
+    const keys = [...definitions.keys()].sort();
+    const identifiers = new Map();
+    const taken = new Set();
+    for (const key of keys) {
+        const base = `As3_${key.replace(/::|\./g, "_").replace(/[^\w$]/g, "_")}`;
+        let id = base;
+        for (let i = 2; taken.has(id) || taken.has(`${id}$`); i++) {
+            id = `${base}_${i}`;
+        }
+        taken.add(id);
+        taken.add(`${id}$`);
+        identifiers.set(key, id);
+    }
+    // The libraries' classes the output names, each by an alias of its map's entry.
+    const used = new Set();
+    const named = (key) => {
+        const d = definitions.get(key);
+        if (!d.own) {
+            used.add(key);
+        }
+        return identifiers.get(key);
+    };
+    const tsType = (raw) => {
+        if (raw === "*") {
+            return value;
+        }
+        if (raw === "void") {
+            return "void";
+        }
+        const vector = raw.match(/^(.*?)\.<(.*)>$/);
+        if (vector) {
+            const element = classKey(vector[2]);
+            const store = element === "int" || element === "uint"
+                ? element
+                : element === "Number"
+                    ? "double"
+                    : "object";
+            const key = `__AS3__.vec::Vector$${store}`;
+            return definitions.has(key) ? `${ref}<${named(key)}> | null` : value;
+        }
+        const key = classKey(raw);
+        switch (key) {
+            case "int":
+            case "uint":
+            case "Number":
+            case "float":
+                return "number";
+            case "void":
+                return "void";
+            case "Boolean":
+                return "boolean";
+            case "String":
+                return "string | null";
+            case "Object":
+            case null:
+                return value;
+        }
+        return definitions.has(key) ? `${ref}<${named(key)}> | null` : value;
+    };
+    // What each class declares, its bases' included, for telling an override from a new member.
+    const declared = new Map();
+    const allMembers = (key, seen = new Set()) => {
+        const known = declared.get(key);
+        if (known) {
+            return known;
+        }
+        const all = new Map();
+        const d = definitions.get(key);
+        if (d && !seen.has(key)) {
+            seen.add(key);
+            const isInterface = d.cls.flags.includes("interface");
+            const bases = isInterface ? d.cls.interfaces : d.cls.super ? [d.cls.super] : [];
+            for (const base of bases) {
+                const b = classKey(base);
+                if (b !== null) {
+                    for (const [name, m] of allMembers(b, seen)) {
+                        all.set(name, m);
+                    }
+                }
+            }
+            for (const [name, m] of membersOf(d.cls.instance, isInterface)) {
+                const had = all.get(name);
+                // An accessor's override may declare one half alone: the other is still the base's.
+                if (m.kind === "property" && had?.kind === "property" && !m.constant) {
+                    all.set(name, {
+                        ...had,
+                        readable: m.readable || had.readable,
+                        writable: m.writable || had.writable,
+                    });
+                }
+                else {
+                    all.set(name, m);
+                }
+            }
+        }
+        declared.set(key, all);
+        return all;
+    };
+    const params = (key, member, m) => {
+        const names = options.paramNames?.(key, member);
+        const seen = new Set();
+        const name = (i, given) => {
+            const n = given ?? names?.[i];
+            const ok = n !== undefined && IDENTIFIER.test(n) && !RESERVED.has(n) && !seen.has(n);
+            const out = ok ? n : `arg${i}`;
+            seen.add(out);
+            return out;
+        };
+        const list = m.params.map((p, i) => `${name(i, p.name)}${p.default ? "?" : ""}: ${tsType(p.type)}`);
+        if (m.flags.includes("rest")) {
+            const rest = names?.[m.params.length];
+            const n = rest && IDENTIFIER.test(rest) && !RESERVED.has(rest) ? rest : "rest";
+            list.push(`...${seen.has(n) ? "rest" : n}: ${value}[]`);
+        }
+        return list.join(", ");
+    };
+    const memberLines = (key, members) => {
+        const lines = [];
+        for (const name of [...members.keys()].sort()) {
+            const m = members.get(name);
+            if (m.kind === "method") {
+                lines.push(`  ${memberName(name)}(${params(key, name, m.method)}): ${tsType(m.method.returns)};`);
+                continue;
+            }
+            if (!m.readable) {
+                lines.push("  /** Write-only: reading it throws, as in AS3. */");
+            }
+            lines.push(`  ${m.writable ? "" : "readonly "}${memberName(name)}: ${tsType(m.type)};`);
+        }
+        return lines;
+    };
+    const block = (head, lines) => lines.length ? [`${head} {`, ...lines, "}"] : [`${head} {}`];
+    const body = [];
+    const own = keys.filter((k) => definitions.get(k).own);
+    for (const key of own) {
+        const d = definitions.get(key);
+        const id = identifiers.get(key);
+        const isInterface = d.cls.flags.includes("interface");
+        const bases = (isInterface ? d.cls.interfaces : d.cls.super ? [d.cls.super] : [])
+            .map(classKey)
+            .filter((b) => b !== null && definitions.has(b));
+        const inherited = new Map();
+        for (const b of bases) {
+            for (const [name, m] of allMembers(b)) {
+                inherited.set(name, m);
+            }
+        }
+        // A member a base declares stays the base's, but for an accessor this class makes writable.
+        const mine = new Map();
+        for (const [name, m] of allMembers(key)) {
+            const had = inherited.get(name);
+            if (had === undefined ||
+                (had.kind === "property" && m.kind === "property" && m.writable && !had.writable)) {
+                mine.set(name, m);
+            }
+        }
+        body.push("", ...block(`export interface ${id}${bases.length ? ` extends ${bases.map(named).join(", ")}` : ""}`, memberLines(key, mine)), "", ...block(`export interface ${id}$`, memberLines(key, membersOf(d.cls.static, false))));
+    }
+    const aliases = [];
+    for (const key of [...used].sort()) {
+        const library = definitions.get(key).library;
+        aliases.push(`type ${identifiers.get(key)} = ${library.classes}[${JSON.stringify(key)}];`);
+    }
+    const map = (suffix) => own.map((k) => `  ${JSON.stringify(k)}: ${identifiers.get(k)}${suffix};`);
+    return [
+        ...options.header.map((line) => (line ? `// ${line}` : "//")),
+        "",
+        ...options.imports,
+        ...(aliases.length ? ["", ...aliases] : []),
+        "",
+        "/** Each class's instances' public members, by the class's qualified name. */",
+        `export interface ${options.name}Classes {`,
+        ...map(""),
+        "}",
+        "",
+        "/** Each class object's public members, its static ones, by the class's qualified name. */",
+        `export interface ${options.name}Statics {`,
+        ...map("$"),
+        "}",
+        ...body,
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=as3-types.js.map

package/dist/as3-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"as3-types.js","sourceRoot":"","sources":["../src/as3-types.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,kEAAkE;AAClE,0EAA0E;AAC1E,8DAA8D;AAC9D,0EAA0E;AAC1E,+DAA+D;AAC/D,EAAE;AACF,0DAA0D;AAC1D,wEAAwE;AAoCxE,0GAA0G;AAC1G,SAAS,SAAS,CAAC,GAAW;IAC5B,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACnC,oFAAoF;QACpF,MAAM,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACjD,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YAC/B,GAAG,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;YACjE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,GAAG,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACjC,OAAO;QACL,IAAI,EAAE,SAAS;QACf,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QACnC,KAAK,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;KACxC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,QAAQ,CAAC,GAAW;IAC3B,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IACzB,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,GAAG,KAAK,aAAa,CAAC,EAAE,CAAC;QAC/E,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IAClD,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,GAAG,oBAAoB,CAAC;AAExC,0CAA0C;AAC1C,MAAM,QAAQ,GAAG,IAAI,GAAG,CACtB,CACE,oFAAoF;IACpF,sFAAsF;IACtF,uFAAuF;IACvF,2DAA2D,CAC5D,CAAC,KAAK,CAAC,GAAG,CAAC,CACb,CAAC;AAEF,SAAS,UAAU,CAAC,KAAa;IAC/B,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC3F,CAAC;AAgBD,yFAAyF;AACzF,SAAS,SAAS,CAAC,MAAkB,EAAE,WAAoB;IACzD,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5B,gGAAgG;QAChG,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,CAAC;YACrE,SAAS;QACX,CAAC;QAED,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;YACf,KAAK,MAAM,CAAC;YACZ,KAAK,OAAO;gBACV,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE;oBACf,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,QAAQ,EAAE,IAAI;oBACd,QAAQ,EAAE,CAAC,CAAC,IAAI,KAAK,MAAM;oBAC3B,QAAQ,EAAE,CAAC,CAAC,IAAI,KAAK,OAAO;iBAC7B,CAAC,CAAC;gBACH,MAAM;YACR,KAAK,QAAQ,CAAC;YACd,KAAK,QAAQ,EAAE,CAAC;gBACd,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC7B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,GAAG,CAAC,CAAC;gBACxF,MAAM,GAAG,GAAG,GAAG,EAAE,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;gBAClD,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE;oBACf,IAAI,EAAE,UAAU;oBAChB,IAAI,EAAE,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI;oBACnD,QAAQ,EAAE,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,GAAG,EAAE,QAAQ,IAAI,KAAK,CAAC;oBACzD,QAAQ,EAAE,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,GAAG,EAAE,QAAQ,IAAI,KAAK,CAAC;oBACzD,QAAQ,EAAE,KAAK;iBAChB,CAAC,CAAC;gBACH,MAAM;YACR,CAAC;YACD,KAAK,QAAQ;gBACX,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;gBACvD,MAAM;QACV,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,eAAe,CAAC,OAA4B;IAC1D,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,OAAO,CAAC;IAC/B,MAAM,WAAW,GAAG,IAAI,GAAG,EAAsB,CAAC;IAClD,MAAM,MAAM,GAAG,CAAC,IAAkB,EAAE,GAAY,EAAE,OAAyB,EAAE,EAAE;QAC7E,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,KAAK,MAAM,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBACjC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;oBAC9B,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;oBACzD,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;wBAChE,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;oBAC5D,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACxC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAE3B,sEAAsE;IACtE,wEAAwE;IACxE,+CAA+C;IAC/C,MAAM,IAAI,GAAG,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,MAAM,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,CAAC;QACzE,IAAI,EAAE,GAAG,IAAI,CAAC;QACd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC1D,EAAE,GAAG,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;QACtB,CAAC;QAED,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACd,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACpB,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,gFAAgF;IAChF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,KAAK,GAAG,CAAC,GAAW,EAAU,EAAE;QACpC,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAe,CAAC;QAC7C,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;YACX,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChB,CAAC;QAED,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,CAAW,CAAC;IACxC,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,GAAW,EAAU,EAAE;QACrC,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACnB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;QAC5C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,MAAM,KAAK,GACT,OAAO,KAAK,KAAK,IAAI,OAAO,KAAK,MAAM;gBACrC,CAAC,CAAC,OAAO;gBACT,CAAC,CAAC,OAAO,KAAK,QAAQ;oBACpB,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,QAAQ,CAAC;YACjB,MAAM,GAAG,GAAG,uBAAuB,KAAK,EAAE,CAAC;YAC3C,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;QACvE,CAAC;QAED,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC1B,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,KAAK,CAAC;YACX,KAAK,MAAM,CAAC;YACZ,KAAK,QAAQ,CAAC;YACd,KAAK,OAAO;gBACV,OAAO,QAAQ,CAAC;YAClB,KAAK,MAAM;gBACT,OAAO,MAAM,CAAC;YAChB,KAAK,SAAS;gBACZ,OAAO,SAAS,CAAC;YACnB,KAAK,QAAQ;gBACX,OAAO,eAAe,CAAC;YACzB,KAAK,QAAQ,CAAC;YACd,KAAK,IAAI;gBACP,OAAO,KAAK,CAAC;QACjB,CAAC;QAED,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC;IACvE,CAAC,CAAC;IAEF,4FAA4F;IAC5F,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;IACxD,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,IAAI,GAAgB,IAAI,GAAG,EAAE,EAAuB,EAAE;QACrF,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;QACtC,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,MAAM,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YACtD,MAAM,KAAK,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAChF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACzB,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;oBACf,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC;wBAC5C,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;oBACnB,CAAC;gBACH,CAAC;YACH,CAAC;YAED,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,WAAW,CAAC,EAAE,CAAC;gBAC/D,MAAM,GAAG,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC1B,oFAAoF;gBACpF,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,GAAG,EAAE,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;oBACrE,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE;wBACZ,GAAG,GAAG;wBACN,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ;wBACpC,QAAQ,EAAE,CAAC,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ;qBACrC,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBACnB,CAAC;YACH,CAAC;QACH,CAAC;QAED,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACvB,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IAEF,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,MAAc,EAAE,CAAY,EAAU,EAAE;QACnE,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,KAAyB,EAAE,EAAE;YACpD,MAAM,CAAC,GAAG,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,EAAE,GAAG,CAAC,KAAK,SAAS,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACrF,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,GAAG,CAAC;QACb,CAAC,CAAC;QACF,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CACvB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CACzE,CAAC;QACF,IAAI,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACtC,MAAM,CAAC,GAAG,IAAI,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;YAC/E,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC,CAAC;IAEF,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,OAA4B,EAAY,EAAE;QAC1E,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YAC9C,MAAM,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAW,CAAC;YACtC,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CACR,KAAK,UAAU,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CACtF,CAAC;gBACF,SAAS;YACX,CAAC;YAED,IAAI,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAChB,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;YACnE,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1F,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,KAAK,GAAG,CAAC,IAAY,EAAE,KAAe,EAAE,EAAE,CAC9C,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,EAAE,GAAG,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;IAE/D,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAgB,CAAC,GAAG,CAAC,CAAC;IACvE,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,MAAM,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAe,CAAC;QAC7C,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,GAAG,CAAW,CAAC;QAC1C,MAAM,WAAW,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;aAC9E,GAAG,CAAC,QAAQ,CAAC;aACb,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,CAAC,KAAK,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAChE,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC5C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;YACtB,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAED,4FAA4F;QAC5F,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;QACvC,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAChC,IACE,GAAG,KAAK,SAAS;gBACjB,CAAC,GAAG,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EACjF,CAAC;gBACD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CACP,EAAE,EACF,GAAG,KAAK,CACN,oBAAoB,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EACxF,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,CACvB,EACD,EAAE,EACF,GAAG,KAAK,CAAC,oBAAoB,EAAE,GAAG,EAAE,WAAW,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,CACtF,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACnC,MAAM,OAAO,GAAI,WAAW,CAAC,GAAG,CAAC,GAAG,CAAgB,CAAC,OAA0B,CAAC;QAChF,OAAO,CAAC,IAAI,CAAC,QAAQ,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,GAAG,GAAG,CAAC,MAAc,EAAE,EAAE,CAC7B,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC;IAC5E,OAAO;QACL,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7D,EAAE;QACF,GAAG,OAAO,CAAC,OAAO;QAClB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3C,EAAE;QACF,+EAA+E;QAC/E,oBAAoB,OAAO,CAAC,IAAI,WAAW;QAC3C,GAAG,GAAG,CAAC,EAAE,CAAC;QACV,GAAG;QACH,EAAE;QACF,4FAA4F;QAC5F,oBAAoB,OAAO,CAAC,IAAI,WAAW;QAC3C,GAAG,GAAG,CAAC,GAAG,CAAC;QACX,GAAG;QACH,GAAG,IAAI;QACP,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC"}

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

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

package/dist/commands/help.js

@@ -4,6 +4,7 @@ import { COMMON_OPTIONS, COMMON_USAGE, parse } from "../args.js";
 import { usageError } from "../output.js";
 import { compile } from "./compile.js";
 import { run } from "./run.js";
+import { types } from "./types.js";
 const help = {
     name: "help",
     summary: "show the commands, or a command's usage",
@@ -33,7 +34,7 @@ ${COMMON_USAGE}`,
         console.log(command.usage);
     },
 };
-export const commands = new Map([compile, run, help].map((c) => [c.name, c]));
+export const commands = new Map([compile, run, types, help].map((c) => [c.name, c]));
 /** The command's own usage: its commands, and the bare form compile keeps. */
 export function usage() {
     const width = Math.max(...[...commands.keys()].map((n) => n.length));

package/dist/commands/help.js.map

@@ -1 +1 @@
-{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAgB,KAAK,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B,MAAM,IAAI,GAAY;IACpB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,yCAAyC;IAClD,KAAK,EAAE;;;;;EAKP,YAAY,EAAE;IACd,KAAK,CAAC,IAAI,CAAC,IAAI;QACb,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,CAC9B,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAC3E,CAAC;QACF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;QAC/B,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,UAAU,CAAC,qCAAqC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,UAAU,CAAC,cAAc,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAkB,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAE/F,8EAA8E;AAC9E,MAAM,UAAU,KAAK;IACnB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1F,OAAO;;;;EAIP,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;;;EAGf,YAAY;;mDAEqC,CAAC;AACpD,CAAC"}
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,YAAY,EAAgB,KAAK,EAAE,MAAM,YAAY,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAEnC,MAAM,IAAI,GAAY;IACpB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,yCAAyC;IAClD,KAAK,EAAE;;;;;EAKP,YAAY,EAAE;IACd,KAAK,CAAC,IAAI,CAAC,IAAI;QACb,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,CAC9B,SAAS,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAC3E,CAAC;QACF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;QACT,CAAC;QAED,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;QAC/B,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,UAAU,CAAC,qCAAqC,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QACxE,CAAC;QAED,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;YACrB,OAAO;QACT,CAAC;QAED,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,UAAU,CAAC,cAAc,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAC7B,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CACpD,CAAC;AAEF,8EAA8E;AAC9E,MAAM,UAAU,KAAK;IACnB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACrE,MAAM,IAAI,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1F,OAAO;;;;EAIP,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;;;EAGf,YAAY;;mDAEqC,CAAC;AACpD,CAAC"}

package/dist/commands/types.d.ts

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

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

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

package/dist/commands/types.js

@@ -0,0 +1,104 @@
+// swf2es types: TypeScript declarations of the classes a SWF's or an ABC's
+// code defines (as3-types.ts), extending those of the libraries the player
+// links it against, for a host or a native to reach its objects by.
+import { writeFile } from "node:fs/promises";
+import { basename } from "node:path";
+import { parseArgs } from "node:util";
+import { readAbcSurface } from "@swf2es/format";
+import { airLibrary, builtinLibrary, playerglobalLibrary } from "@swf2es/player/libraries";
+import { InputError, readInput } from "../aot.js";
+import { COMMON_OPTIONS, COMMON_USAGE, parse } from "../args.js";
+import { as3Declarations } from "../as3-types.js";
+import { read, writing } from "../files.js";
+import { fail, usageError } from "../output.js";
+const USAGE = `usage: swf2es types <file.swf|file.abc> [options]
+
+Writes TypeScript declarations of the classes a SWF's ABCs (its DoABC and
+DoABC2 tags) or a bare ABC define: for each class, an interface of its
+instances' public members and one of its class object's (statics), keyed
+by qualified name in Classes and Statics, for @swf2es/runtime's
+Runtime.prop, setProp and callProp. A class extends the declarations of
+the one it extends in the libraries the player loads, builtin.abc and
+the player's playerglobal (@swf2es/player/as3-types); a type that none
+defines is avm2.Value.
+
+options:
+  -o, --out <file>     where to write (default: standard output)
+  --name <prefix>      the maps' names' prefix: <prefix>Classes and
+                       <prefix>Statics (default: none)
+  --air                resolve types against AIR's library too, as the
+                       player links an AIR application's SWF
+${COMMON_USAGE}
+
+exit status: 0 on success, 2 for a mistake in the command line, 1 for
+anything else (an unreadable, malformed or AVM1 input, or an output that
+cannot be written)`;
+const OPTIONS = {
+    out: { type: "string", short: "o" },
+    name: { type: "string" },
+    air: { type: "boolean" },
+    ...COMMON_OPTIONS,
+};
+function surfaceOf(abc, what) {
+    try {
+        return readAbcSurface(abc);
+    }
+    catch (e) {
+        fail(`${what}: a malformed ABC (${e.message})`);
+    }
+}
+export const types = {
+    name: "types",
+    summary: "write TypeScript declarations of a SWF's or an ABC's classes",
+    usage: USAGE,
+    async main(argv) {
+        const parsed = parse(types, () => 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}`, "types");
+        }
+        const name = values.name ?? "";
+        if (name && !/^[A-Za-z_$][\w$]*$/.test(name)) {
+            usageError(`--name ${name} is not an identifier`, "types");
+        }
+        const file = positionals[0];
+        let input;
+        try {
+            input = readInput(await read(file, "input"));
+        }
+        catch (e) {
+            fail(e instanceof InputError ? `${file}: ${e.message}` : String(e.stack ?? e));
+        }
+        if (input.avm1) {
+            fail(`${file} is an AVM1 SWF, which defines no classes`);
+        }
+        const abcs = input.abcs.map((a, i) => surfaceOf(a.abc, `${file}, ABC ${i}`));
+        const libraries = [builtinLibrary, playerglobalLibrary, ...(values.air ? [airLibrary] : [])];
+        const text = as3Declarations({
+            abcs,
+            name,
+            libraries: [{ abcs: libraries.map((l) => surfaceOf(l, "a library")), classes: "As3Classes" }],
+            header: [
+                `TypeScript declarations of ${basename(file)}'s classes: each one's public`,
+                "members, for @swf2es/runtime's Runtime.prop, setProp and callProp.",
+                `Generated by swf2es types${values.air ? " --air" : ""}.`,
+            ],
+            imports: [
+                'import type { As3Classes } from "@swf2es/player/as3-types";',
+                'import type { avm2 } from "@swf2es/runtime";',
+            ],
+            ref: "avm2.Ref",
+            value: "avm2.Value",
+        });
+        const out = values.out;
+        if (out === undefined) {
+            process.stdout.write(text);
+            return;
+        }
+        await writing(out, () => writeFile(out, text));
+    },
+};
+//# sourceMappingURL=types.js.map

package/dist/commands/types.js.map

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

package/dist/index.d.ts

@@ -1,5 +1,10 @@
-/** The ahead-of-time compiler and avmshell's way of running ABCs as a library, for a host that does without the command. */
+/**
+ * The ahead-of-time compiler, avmshell's way of running ABCs and the
+ * declarations of ABCs' classes as a library, for a host that does without
+ * the command.
+ */
 export { type AbcInput, type ActionsModule, AIR_API_VERSION, API_VERSION, type Avm1Input, compileActionsAhead, compileAhead, type Input, type Module, RejectedError, readInput, sha256, } from "./aot.js";
+export { as3Declarations, type DeclarationsOptions, type DeclaredLibrary } from "./as3-types.js";
 export { evaluateModule, runShell, type ShellCompiler, type ShellLibrary, type ShellModule, type ShellOptions, shellDomain, } from "./shell.js";
 export { nodeShellThreads, type ShellThreads, type ShellThreadsOptions } from "./threads.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4HAA4H;AAC5H,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,eAAe,EACf,WAAW,EACX,KAAK,SAAS,EACd,mBAAmB,EACnB,YAAY,EACZ,KAAK,KAAK,EACV,KAAK,MAAM,EACX,aAAa,EACb,SAAS,EACT,MAAM,GACP,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,cAAc,EACd,QAAQ,EACR,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EACL,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,eAAe,EACf,WAAW,EACX,KAAK,SAAS,EACd,mBAAmB,EACnB,YAAY,EACZ,KAAK,KAAK,EACV,KAAK,MAAM,EACX,aAAa,EACb,SAAS,EACT,MAAM,GACP,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAE,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjG,OAAO,EACL,cAAc,EACd,QAAQ,EACR,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,5 +1,10 @@
-/** The ahead-of-time compiler and avmshell's way of running ABCs as a library, for a host that does without the command. */
+/**
+ * The ahead-of-time compiler, avmshell's way of running ABCs and the
+ * declarations of ABCs' classes as a library, for a host that does without
+ * the command.
+ */
 export { AIR_API_VERSION, API_VERSION, compileActionsAhead, compileAhead, RejectedError, readInput, sha256, } from "./aot.js";
+export { as3Declarations } from "./as3-types.js";
 export { evaluateModule, runShell, shellDomain, } from "./shell.js";
 export { nodeShellThreads } from "./threads.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4HAA4H;AAC5H,OAAO,EAGL,eAAe,EACf,WAAW,EAEX,mBAAmB,EACnB,YAAY,EAGZ,aAAa,EACb,SAAS,EACT,MAAM,GACP,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,cAAc,EACd,QAAQ,EAKR,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAA+C,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAGL,eAAe,EACf,WAAW,EAEX,mBAAmB,EACnB,YAAY,EAGZ,aAAa,EACb,SAAS,EACT,MAAM,GACP,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,eAAe,EAAkD,MAAM,gBAAgB,CAAC;AACjG,OAAO,EACL,cAAc,EACd,QAAQ,EAKR,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,gBAAgB,EAA+C,MAAM,cAAc,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swf2es/cli",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "swf2es command line: ahead-of-time compile SWF and ABC files, and run ABCs as avmshell does",
   "keywords": [
     "swf",
@@ -41,9 +41,9 @@
     "LICENSE.third-party"
   ],
   "dependencies": {
-    "@swf2es/format": "0.1.16",
-    "@swf2es/codegen": "0.1.16",
-    "@swf2es/runtime": "0.1.16",
-    "@swf2es/player": "0.1.16"
+    "@swf2es/format": "0.1.18",
+    "@swf2es/player": "0.1.18",
+    "@swf2es/codegen": "0.1.18",
+    "@swf2es/runtime": "0.1.18"
   }
 }

package/src/as3-types.ts

@@ -0,0 +1,403 @@
+// TypeScript declarations of the classes ABCs define: for each class, an
+// interface of its instances' public members and one of its class
+// object's, as natives and hosts reach them through Runtime.prop, setProp
+// and callProp (docs/architecture/runtime.md, "AS3 classes in
+// TypeScript"). The libraries the ABCs link against name the classes they
+// extend and the types they use; what none defines is `Value`.
+//
+// Only type imports, so that node runs this file as it is
+// (tools/as3-types.ts); the command reads the ABCs (commands/types.ts).
+
+import type { AbcClass, AbcMethod, AbcSurface, AbcTrait } from "@swf2es/format";
+
+/** A library the ABCs link against, whose declarations are written elsewhere. */
+export interface DeclaredLibrary {
+  abcs: AbcSurface[];
+  /** The type its instance interfaces are keyed in by qualified name, as the output spells it. */
+  classes: string;
+}
+
+export interface DeclarationsOptions {
+  /** The ABCs whose classes are declared, in the order they load: the first definition of a name wins. */
+  abcs: AbcSurface[];
+  /** The maps' names: `${name}Classes` and `${name}Statics`. */
+  name: string;
+  /** What the ABCs link against, in the order they load, before the ABCs. */
+  libraries: DeclaredLibrary[];
+  /** The comment the output starts with, without its `// ` prefixes. */
+  header: string[];
+  /** The import declarations the output needs for `ref`, `value` and the libraries' maps. */
+  imports: string[];
+  /** How the output spells @swf2es/runtime's avm2 Ref and Value types. */
+  ref: string;
+  value: string;
+  /** Parameter names for a method whose ABC has none, by its class's qualified name and its own. */
+  paramNames?: (qualified: string, method: string) => string[] | undefined;
+}
+
+/** A name's namespace kind and URI, and its local name. */
+interface Name {
+  kind: string;
+  uri: string;
+  local: string;
+}
+
+/** A name as the surface spells it ("Array", "flash.geom::Point", "{package:@v0}::uint"), taken apart. */
+function parseName(raw: string): Name {
+  if (raw.startsWith("{")) {
+    const end = raw.lastIndexOf("}::");
+    // One namespace, or the same one in several API versions: the first's kind and URI.
+    const ns = raw.slice(1, end).split(",")[0];
+    const colon = ns.indexOf(":");
+    const kind = colon < 0 ? ns : ns.slice(0, colon);
+    return {
+      kind: kind.replace(/#\d+$/, ""),
+      uri: (colon < 0 ? "" : ns.slice(colon + 1)).replace(/@v\d+$/, ""),
+      local: raw.slice(end + 3),
+    };
+  }
+
+  const at = raw.lastIndexOf("::");
+  return {
+    kind: "package",
+    uri: at < 0 ? "" : raw.slice(0, at),
+    local: at < 0 ? raw : raw.slice(at + 2),
+  };
+}
+
+/**
+ * A class's qualified name, "flash.geom::Rectangle" or a top-level
+ * "Array", or null for one no other ABC can name; the builtin's Vector
+ * classes, internal to __AS3__.vec, as the types of Vectors.
+ */
+function classKey(raw: string): string | null {
+  const n = parseName(raw);
+  if (n.kind === "package" || (n.kind === "internal" && n.uri === "__AS3__.vec")) {
+    return n.uri ? `${n.uri}::${n.local}` : n.local;
+  }
+
+  return null;
+}
+
+const IDENTIFIER = /^[A-Za-z_$][\w$]*$/;
+
+/** Words a parameter may not be named. */
+const RESERVED = new Set(
+  (
+    "break case catch class const continue debugger default delete do else enum export " +
+    "extends false finally for function if implements import in instanceof interface let " +
+    "new null package private protected public return static super switch this throw true " +
+    "try typeof var void while with yield await arguments eval"
+  ).split(" "),
+);
+
+function memberName(local: string): string {
+  return IDENTIFIER.test(local) && local !== "constructor" ? local : JSON.stringify(local);
+}
+
+/** A class's public members, by local name: what a property or a method declares. */
+type Member =
+  | { kind: "property"; type: string; readable: boolean; writable: boolean; constant: boolean }
+  | { kind: "method"; method: AbcMethod };
+
+interface Definition {
+  key: string;
+  cls: AbcClass;
+  /** Whether the output declares it, rather than a library's. */
+  own: boolean;
+  /** The library whose map declares it, if not own. */
+  library?: DeclaredLibrary;
+}
+
+/** The public members of `traits`, a getter and a setter of one name as one property. */
+function membersOf(traits: AbcTrait[], isInterface: boolean): Map<string, Member> {
+  const out = new Map<string, Member>();
+  for (const t of traits) {
+    const n = parseName(t.name);
+    // An interface's methods are in its own namespace, and public in each class that implements it.
+    if (n.kind !== "package" && !(isInterface && n.kind === "namespace")) {
+      continue;
+    }
+
+    switch (t.kind) {
+      case "slot":
+      case "const":
+        out.set(n.local, {
+          kind: "property",
+          type: t.type,
+          readable: true,
+          writable: t.kind === "slot",
+          constant: t.kind === "const",
+        });
+        break;
+      case "getter":
+      case "setter": {
+        const had = out.get(n.local);
+        const type = t.kind === "getter" ? t.method.returns : (t.method.params[0]?.type ?? "*");
+        const was = had?.kind === "property" ? had : null;
+        out.set(n.local, {
+          kind: "property",
+          type: t.kind === "getter" || !was ? type : was.type,
+          readable: t.kind === "getter" || (was?.readable ?? false),
+          writable: t.kind === "setter" || (was?.writable ?? false),
+          constant: false,
+        });
+        break;
+      }
+      case "method":
+        out.set(n.local, { kind: "method", method: t.method });
+        break;
+    }
+  }
+
+  return out;
+}
+
+/** The declarations of the classes `options.abcs` define, as a TypeScript module. */
+export function as3Declarations(options: DeclarationsOptions): string {
+  const { ref, value } = options;
+  const definitions = new Map<string, Definition>();
+  const define = (abcs: AbcSurface[], own: boolean, library?: DeclaredLibrary) => {
+    for (const abc of abcs) {
+      for (const script of abc.scripts) {
+        for (const t of script.traits) {
+          const key = t.kind === "class" ? classKey(t.name) : null;
+          if (t.kind === "class" && key !== null && !definitions.has(key)) {
+            definitions.set(key, { key, cls: t.class, own, library });
+          }
+        }
+      }
+    }
+  };
+  for (const library of options.libraries) {
+    define(library.abcs, false, library);
+  }
+
+  define(options.abcs, true);
+
+  // Each class's interface's name: its qualified name as an identifier,
+  // "As3_flash_geom_Rectangle", and its class object's with a $ after it,
+  // told apart by a number where two would meet.
+  const keys = [...definitions.keys()].sort();
+  const identifiers = new Map<string, string>();
+  const taken = new Set<string>();
+  for (const key of keys) {
+    const base = `As3_${key.replace(/::|\./g, "_").replace(/[^\w$]/g, "_")}`;
+    let id = base;
+    for (let i = 2; taken.has(id) || taken.has(`${id}$`); i++) {
+      id = `${base}_${i}`;
+    }
+
+    taken.add(id);
+    taken.add(`${id}$`);
+    identifiers.set(key, id);
+  }
+
+  // The libraries' classes the output names, each by an alias of its map's entry.
+  const used = new Set<string>();
+  const named = (key: string): string => {
+    const d = definitions.get(key) as Definition;
+    if (!d.own) {
+      used.add(key);
+    }
+
+    return identifiers.get(key) as string;
+  };
+
+  const tsType = (raw: string): string => {
+    if (raw === "*") {
+      return value;
+    }
+
+    if (raw === "void") {
+      return "void";
+    }
+
+    const vector = raw.match(/^(.*?)\.<(.*)>$/);
+    if (vector) {
+      const element = classKey(vector[2]);
+      const store =
+        element === "int" || element === "uint"
+          ? element
+          : element === "Number"
+            ? "double"
+            : "object";
+      const key = `__AS3__.vec::Vector$${store}`;
+      return definitions.has(key) ? `${ref}<${named(key)}> | null` : value;
+    }
+
+    const key = classKey(raw);
+    switch (key) {
+      case "int":
+      case "uint":
+      case "Number":
+      case "float":
+        return "number";
+      case "void":
+        return "void";
+      case "Boolean":
+        return "boolean";
+      case "String":
+        return "string | null";
+      case "Object":
+      case null:
+        return value;
+    }
+
+    return definitions.has(key) ? `${ref}<${named(key)}> | null` : value;
+  };
+
+  // What each class declares, its bases' included, for telling an override from a new member.
+  const declared = new Map<string, Map<string, Member>>();
+  const allMembers = (key: string, seen: Set<string> = new Set()): Map<string, Member> => {
+    const known = declared.get(key);
+    if (known) {
+      return known;
+    }
+
+    const all = new Map<string, Member>();
+    const d = definitions.get(key);
+    if (d && !seen.has(key)) {
+      seen.add(key);
+      const isInterface = d.cls.flags.includes("interface");
+      const bases = isInterface ? d.cls.interfaces : d.cls.super ? [d.cls.super] : [];
+      for (const base of bases) {
+        const b = classKey(base);
+        if (b !== null) {
+          for (const [name, m] of allMembers(b, seen)) {
+            all.set(name, m);
+          }
+        }
+      }
+
+      for (const [name, m] of membersOf(d.cls.instance, isInterface)) {
+        const had = all.get(name);
+        // An accessor's override may declare one half alone: the other is still the base's.
+        if (m.kind === "property" && had?.kind === "property" && !m.constant) {
+          all.set(name, {
+            ...had,
+            readable: m.readable || had.readable,
+            writable: m.writable || had.writable,
+          });
+        } else {
+          all.set(name, m);
+        }
+      }
+    }
+
+    declared.set(key, all);
+    return all;
+  };
+
+  const params = (key: string, member: string, m: AbcMethod): string => {
+    const names = options.paramNames?.(key, member);
+    const seen = new Set<string>();
+    const name = (i: number, given: string | undefined) => {
+      const n = given ?? names?.[i];
+      const ok = n !== undefined && IDENTIFIER.test(n) && !RESERVED.has(n) && !seen.has(n);
+      const out = ok ? n : `arg${i}`;
+      seen.add(out);
+      return out;
+    };
+    const list = m.params.map(
+      (p, i) => `${name(i, p.name)}${p.default ? "?" : ""}: ${tsType(p.type)}`,
+    );
+    if (m.flags.includes("rest")) {
+      const rest = names?.[m.params.length];
+      const n = rest && IDENTIFIER.test(rest) && !RESERVED.has(rest) ? rest : "rest";
+      list.push(`...${seen.has(n) ? "rest" : n}: ${value}[]`);
+    }
+
+    return list.join(", ");
+  };
+
+  const memberLines = (key: string, members: Map<string, Member>): string[] => {
+    const lines: string[] = [];
+    for (const name of [...members.keys()].sort()) {
+      const m = members.get(name) as Member;
+      if (m.kind === "method") {
+        lines.push(
+          `  ${memberName(name)}(${params(key, name, m.method)}): ${tsType(m.method.returns)};`,
+        );
+        continue;
+      }
+
+      if (!m.readable) {
+        lines.push("  /** Write-only: reading it throws, as in AS3. */");
+      }
+
+      lines.push(`  ${m.writable ? "" : "readonly "}${memberName(name)}: ${tsType(m.type)};`);
+    }
+
+    return lines;
+  };
+
+  const block = (head: string, lines: string[]) =>
+    lines.length ? [`${head} {`, ...lines, "}"] : [`${head} {}`];
+
+  const body: string[] = [];
+  const own = keys.filter((k) => (definitions.get(k) as Definition).own);
+  for (const key of own) {
+    const d = definitions.get(key) as Definition;
+    const id = identifiers.get(key) as string;
+    const isInterface = d.cls.flags.includes("interface");
+    const bases = (isInterface ? d.cls.interfaces : d.cls.super ? [d.cls.super] : [])
+      .map(classKey)
+      .filter((b): b is string => b !== null && definitions.has(b));
+    const inherited = new Map<string, Member>();
+    for (const b of bases) {
+      for (const [name, m] of allMembers(b)) {
+        inherited.set(name, m);
+      }
+    }
+
+    // A member a base declares stays the base's, but for an accessor this class makes writable.
+    const mine = new Map<string, Member>();
+    for (const [name, m] of allMembers(key)) {
+      const had = inherited.get(name);
+      if (
+        had === undefined ||
+        (had.kind === "property" && m.kind === "property" && m.writable && !had.writable)
+      ) {
+        mine.set(name, m);
+      }
+    }
+
+    body.push(
+      "",
+      ...block(
+        `export interface ${id}${bases.length ? ` extends ${bases.map(named).join(", ")}` : ""}`,
+        memberLines(key, mine),
+      ),
+      "",
+      ...block(`export interface ${id}$`, memberLines(key, membersOf(d.cls.static, false))),
+    );
+  }
+
+  const aliases: string[] = [];
+  for (const key of [...used].sort()) {
+    const library = (definitions.get(key) as Definition).library as DeclaredLibrary;
+    aliases.push(`type ${identifiers.get(key)} = ${library.classes}[${JSON.stringify(key)}];`);
+  }
+
+  const map = (suffix: string) =>
+    own.map((k) => `  ${JSON.stringify(k)}: ${identifiers.get(k)}${suffix};`);
+  return [
+    ...options.header.map((line) => (line ? `// ${line}` : "//")),
+    "",
+    ...options.imports,
+    ...(aliases.length ? ["", ...aliases] : []),
+    "",
+    "/** Each class's instances' public members, by the class's qualified name. */",
+    `export interface ${options.name}Classes {`,
+    ...map(""),
+    "}",
+    "",
+    "/** Each class object's public members, its static ones, by the class's qualified name. */",
+    `export interface ${options.name}Statics {`,
+    ...map("$"),
+    "}",
+    ...body,
+    "",
+  ].join("\n");
+}

package/src/commands/help.ts

@@ -4,6 +4,7 @@ import { COMMON_OPTIONS, COMMON_USAGE, type Command, parse } from "../args.js";
 import { usageError } from "../output.js";
 import { compile } from "./compile.js";
 import { run } from "./run.js";
+import { types } from "./types.js";
 
 const help: Command = {
   name: "help",
@@ -41,7 +42,9 @@ ${COMMON_USAGE}`,
   },
 };
 
-export const commands = new Map<string, Command>([compile, run, help].map((c) => [c.name, c]));
+export const commands = new Map<string, Command>(
+  [compile, run, types, help].map((c) => [c.name, c]),
+);
 
 /** The command's own usage: its commands, and the bare form compile keeps. */
 export function usage(): string {

package/src/commands/types.ts

@@ -0,0 +1,114 @@
+// swf2es types: TypeScript declarations of the classes a SWF's or an ABC's
+// code defines (as3-types.ts), extending those of the libraries the player
+// links it against, for a host or a native to reach its objects by.
+import { writeFile } from "node:fs/promises";
+import { basename } from "node:path";
+import { parseArgs } from "node:util";
+import { type AbcSurface, readAbcSurface } from "@swf2es/format";
+import { airLibrary, builtinLibrary, playerglobalLibrary } from "@swf2es/player/libraries";
+import { InputError, readInput } from "../aot.js";
+import { COMMON_OPTIONS, COMMON_USAGE, type Command, parse } from "../args.js";
+import { as3Declarations } from "../as3-types.js";
+import { read, writing } from "../files.js";
+import { fail, usageError } from "../output.js";
+
+const USAGE = `usage: swf2es types <file.swf|file.abc> [options]
+
+Writes TypeScript declarations of the classes a SWF's ABCs (its DoABC and
+DoABC2 tags) or a bare ABC define: for each class, an interface of its
+instances' public members and one of its class object's (statics), keyed
+by qualified name in Classes and Statics, for @swf2es/runtime's
+Runtime.prop, setProp and callProp. A class extends the declarations of
+the one it extends in the libraries the player loads, builtin.abc and
+the player's playerglobal (@swf2es/player/as3-types); a type that none
+defines is avm2.Value.
+
+options:
+  -o, --out <file>     where to write (default: standard output)
+  --name <prefix>      the maps' names' prefix: <prefix>Classes and
+                       <prefix>Statics (default: none)
+  --air                resolve types against AIR's library too, as the
+                       player links an AIR application's SWF
+${COMMON_USAGE}
+
+exit status: 0 on success, 2 for a mistake in the command line, 1 for
+anything else (an unreadable, malformed or AVM1 input, or an output that
+cannot be written)`;
+
+const OPTIONS = {
+  out: { type: "string", short: "o" },
+  name: { type: "string" },
+  air: { type: "boolean" },
+  ...COMMON_OPTIONS,
+} as const;
+
+function surfaceOf(abc: Uint8Array, what: string): AbcSurface {
+  try {
+    return readAbcSurface(abc);
+  } catch (e) {
+    fail(`${what}: a malformed ABC (${(e as Error).message})`);
+  }
+}
+
+export const types: Command = {
+  name: "types",
+  summary: "write TypeScript declarations of a SWF's or an ABC's classes",
+  usage: USAGE,
+  async main(argv) {
+    const parsed = parse(types, () =>
+      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}`, "types");
+    }
+
+    const name = values.name ?? "";
+    if (name && !/^[A-Za-z_$][\w$]*$/.test(name)) {
+      usageError(`--name ${name} is not an identifier`, "types");
+    }
+
+    const file = positionals[0];
+    let input: ReturnType<typeof readInput>;
+    try {
+      input = readInput(await read(file, "input"));
+    } catch (e) {
+      fail(e instanceof InputError ? `${file}: ${e.message}` : String((e as Error).stack ?? e));
+    }
+
+    if (input.avm1) {
+      fail(`${file} is an AVM1 SWF, which defines no classes`);
+    }
+
+    const abcs = input.abcs.map((a, i) => surfaceOf(a.abc, `${file}, ABC ${i}`));
+    const libraries = [builtinLibrary, playerglobalLibrary, ...(values.air ? [airLibrary] : [])];
+    const text = as3Declarations({
+      abcs,
+      name,
+      libraries: [{ abcs: libraries.map((l) => surfaceOf(l, "a library")), classes: "As3Classes" }],
+      header: [
+        `TypeScript declarations of ${basename(file)}'s classes: each one's public`,
+        "members, for @swf2es/runtime's Runtime.prop, setProp and callProp.",
+        `Generated by swf2es types${values.air ? " --air" : ""}.`,
+      ],
+      imports: [
+        'import type { As3Classes } from "@swf2es/player/as3-types";',
+        'import type { avm2 } from "@swf2es/runtime";',
+      ],
+      ref: "avm2.Ref",
+      value: "avm2.Value",
+    });
+
+    const out = values.out;
+    if (out === undefined) {
+      process.stdout.write(text);
+      return;
+    }
+
+    await writing(out, () => writeFile(out, text));
+  },
+};

package/src/index.ts

@@ -1,4 +1,8 @@
-/** The ahead-of-time compiler and avmshell's way of running ABCs as a library, for a host that does without the command. */
+/**
+ * The ahead-of-time compiler, avmshell's way of running ABCs and the
+ * declarations of ABCs' classes as a library, for a host that does without
+ * the command.
+ */
 export {
   type AbcInput,
   type ActionsModule,
@@ -13,6 +17,7 @@ export {
   readInput,
   sha256,
 } from "./aot.js";
+export { as3Declarations, type DeclarationsOptions, type DeclaredLibrary } from "./as3-types.js";
 export {
   evaluateModule,
   runShell,