@swf2es/player 0.0.0-stage → 0.1.0

package/dist/avm1/clips.js

@@ -0,0 +1,230 @@
+// The display objects an AVM1 movie's scripts make and take away:
+// attachMovie's, createEmptyMovieClip's, createTextField's and
+// duplicateMovieClip's, each placed and made at once, constructed as its
+// registered class with its init object's properties, and removeMovieClip's
+// removal of what is at a depth scripts place at.
+// The depths and the order of construction follow Ruffle's
+// (https://github.com/ruffle-rs/ruffle) construct_as_avm1_object: MIT OR
+// Apache-2.0, Copyright (c) 2018-2022 Ruffle LLC and Ruffle contributors.
+import { ClipEvent } from "@swf2es/format";
+import { avm1 } from "@swf2es/runtime";
+import { Container, construct, displayFor, EMPTY_TIMELINE, MovieClip, TextObject, } from "../display/display.js";
+import { ClipNative, DEPTH_BIAS, nativeOf } from "./globals/MovieClip.js";
+import { asciiLower } from "./paths.js";
+import { BLOCK, CONSTRUCT, NO_ARGS, Queued } from "./queue.js";
+import { NO_HANDLERS } from "./swf.js";
+/** The highest timeline depth scripts place at, 2^31 - 16777220, as Ruffle has it. */
+const MAX_DEPTH = 2130706428;
+/** The depth from which removeMovieClip removes nothing. */
+const MAX_REMOVE_DEPTH = 2130706416;
+/** The blocks of a clip's construct events. */
+export function constructBlocks(native) {
+    const blocks = [];
+    for (const h of native.handlers ?? NO_HANDLERS) {
+        if (h.events & ClipEvent.construct) {
+            blocks.push(h.block);
+        }
+    }
+    return blocks;
+}
+/** Whether a character is one a timeline places. */
+function isDisplayCharacter(c) {
+    const type = c?.type;
+    return (type === "sprite" ||
+        type === "shape" ||
+        type === "morph" ||
+        type === "button" ||
+        type === "text" ||
+        type === "static" ||
+        type === "bitmap");
+}
+/** What the movie's scripts place on and take off the display list. */
+export class ScriptClips {
+    movie;
+    /** The display object a script is making, which it constructs itself; its children are the timeline's. */
+    scripted = null;
+    constructor(movie) {
+        this.movie = movie;
+    }
+    /**
+     * attachMovie: the character exported as `name` placed in `parent` at
+     * AVM1 depth `depth` as `instance`, made as a script makes one; null
+     * where there is no such character or the depth is out of range.
+     */
+    attachMovie(parent, name, instance, depth, init) {
+        const timelineDepth = (depth + DEPTH_BIAS) | 0;
+        if (timelineDepth < 0 || timelineDepth > MAX_DEPTH) {
+            return null;
+        }
+        const swf = this.movie.swfOf(parent);
+        const id = swf.exports.get(asciiLower(name));
+        const character = id === undefined ? undefined : swf.library?.characters.get(id);
+        if (!isDisplayCharacter(character)) {
+            return null;
+        }
+        const child = displayFor(character, parent.library);
+        return this.scriptPlace(parent, child, character, instance, timelineDepth, init);
+    }
+    /** createEmptyMovieClip: an empty clip in `parent` at AVM1 depth `depth` as `instance`. */
+    createEmptyMovieClip(parent, instance, depth) {
+        const child = new MovieClip(EMPTY_TIMELINE, parent.library);
+        return this.scriptPlace(parent, child, null, instance, (depth + DEPTH_BIAS) | 0, null);
+    }
+    /** createTextField: an empty field in `parent` at AVM1 depth `depth` as `instance`. */
+    createTextField(parent, instance, depth, [x, y, width, height]) {
+        const field = new TextObject(null);
+        field.fonts = parent.library.fonts;
+        field.width = width;
+        field.height = height;
+        field.matrix = { ...field.matrix, tx: x, ty: y };
+        return this.scriptPlace(parent, field, null, instance, (depth + DEPTH_BIAS) | 0, null);
+    }
+    /**
+     * duplicateMovieClip and CloneSprite: a new one of `d`'s character, or an
+     * empty clip for a script's, beside it at timeline depth `depth` as
+     * `name`, with its matrix, colour and clip actions; null where `d` has
+     * no clip for a parent or the depth is out of range.
+     */
+    duplicate(d, name, depth, init) {
+        const parent = this.movie.levelOf(d) !== null ? null : d.parent;
+        if (!(parent instanceof MovieClip) || this.movie.removed(d) || depth < 0 || depth > MAX_DEPTH) {
+            return null;
+        }
+        const character = d.character;
+        let child;
+        if (isDisplayCharacter(character)) {
+            child = displayFor(character, parent.library);
+        }
+        else if (d instanceof MovieClip) {
+            child = new MovieClip(EMPTY_TIMELINE, parent.library);
+        }
+        else {
+            return null;
+        }
+        child.matrix = { ...d.matrix };
+        child.colorTransform = d.colorTransform === null ? null : { ...d.colorTransform };
+        const native = nativeOf(d);
+        if (native !== null && native.handlers !== null) {
+            this.handed.set(child, native);
+        }
+        return this.scriptPlace(parent, child, isDisplayCharacter(character) ? character : null, name, depth, init);
+    }
+    /** The clips a duplicate takes the clip actions of, until it is made. */
+    handed = new WeakMap();
+    /**
+     * removeMovieClip and RemoveSprite: `d` removed, where it is at a depth
+     * scripts place at (a timeline's clip swapped there too), as Flash
+     * removes only those.
+     */
+    remove(d) {
+        const parent = this.movie.levelOf(d) !== null ? null : d.parent;
+        const depth = d.depth;
+        if (!(parent instanceof Container) ||
+            depth === null ||
+            depth < DEPTH_BIAS ||
+            depth >= MAX_REMOVE_DEPTH ||
+            this.movie.removed(d)) {
+            return;
+        }
+        parent.removeAtDepth(depth);
+    }
+    /**
+     * A display object a script made, put in `parent` at timeline depth
+     * `depth` as `name` and made: its first frame entered, its children
+     * placed, its load queued; then its construct events, its init
+     * object's properties, before them up to SWF 6, its class's constructor
+     * and its onConstruct at once, its initialize events queued as it was
+     * made (adl:
+     * Ruffle runs neither event, and onConstruct only for
+     * createEmptyMovieClip's).
+     */
+    scriptPlace(parent, child, character, name, depth, init) {
+        child.name = name;
+        parent.placeAtDepth(child, depth);
+        const outer = this.scripted;
+        this.scripted = child;
+        try {
+            if (character !== null) {
+                construct(child, character, parent.library);
+            }
+            else {
+                this.movie.made(child);
+                if (child instanceof MovieClip) {
+                    child.enterFirstFrame();
+                }
+            }
+        }
+        finally {
+            this.scripted = outer;
+        }
+        const face = child.avm1;
+        const native = face?.display;
+        if (face === null || !(native instanceof ClipNative)) {
+            return child;
+        }
+        const version = this.movie.swfOf(child).version;
+        const constr = this.movie.classes.classOf(child);
+        if (constr !== null) {
+            face.define("__proto__", avm1.get(constr, "prototype", version), avm1.DONT_ENUM | avm1.DONT_DELETE);
+        }
+        // It is constructed as the queue's constructions are: a function returning in it
+        // runs only initializations queued (the corpus's register_and_init_order).
+        const pass = this.movie.queue.priority;
+        this.movie.queue.priority = CONSTRUCT;
+        try {
+            // A SWF 6 sets the init object's properties before the construct events, a later one
+            // after (adl).
+            if (version <= 6) {
+                this.initProperties(face, init, version);
+            }
+            for (const block of constructBlocks(native)) {
+                this.movie.queue.runOne(new Queued(BLOCK, child, native.swf, block), []);
+            }
+            if (version > 6) {
+                this.initProperties(face, init, version);
+            }
+            if (constr !== null) {
+                this.construct(child, face, constr);
+            }
+            // Then its onConstruct, from MovieClip's prototype or its class's, what it
+            // throws caught there (adl, and the corpus's movieclip_onconstruct).
+            const cx = this.movie.activationOf(child);
+            if (cx !== null) {
+                this.movie.rt.callMethod(cx, face, "onConstruct", NO_ARGS, version);
+            }
+        }
+        finally {
+            this.movie.queue.priority = pass;
+        }
+        return child;
+    }
+    /** An init object's properties set on `face`, in the reverse of for..in's order, as Flash sets them. */
+    initProperties(face, init, version) {
+        const cx = init === null ? null : this.movie.activationOf(this.movie.root);
+        if (init === null || cx === null) {
+            return;
+        }
+        this.movie.rt.call(cx, () => {
+            const names = avm1.keys(init, version);
+            for (let i = names.length - 1; i >= 0; i--) {
+                avm1.set(face, names[i], avm1.get(init, names[i], version), version);
+            }
+        });
+    }
+    /** `constr` run on the clip's object as its constructor, as `new` runs one. */
+    construct(clip, face, constr) {
+        const cx = this.movie.activationOf(clip);
+        if (cx === null) {
+            return;
+        }
+        const version = this.movie.swfOf(clip).version;
+        face.define("__constructor__", constr, avm1.DONT_ENUM);
+        if (version < 7) {
+            face.define("constructor", constr, avm1.DONT_ENUM);
+        }
+        this.movie.rt.call(cx, () => {
+            constr.callConstructor(face, NO_ARGS, version, 1);
+        });
+    }
+}
+//# sourceMappingURL=clips.js.map

package/dist/avm1/clips.js.map

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

package/dist/avm1/compile.d.ts

@@ -0,0 +1,8 @@
+import type { ActionBlocks, Codegen } from "@swf2es/codegen";
+import { avm1 } from "@swf2es/runtime";
+/**
+ * Stable region arrays let the runtime and ExternalInterface identify a
+ * block before it is compiled; its functions keep that same array after.
+ */
+export declare function lazyBlocks(codegen: Codegen, bytes: Uint8Array, actions: ActionBlocks, rt: avm1.Runtime): avm1.Blocks;
+//# sourceMappingURL=compile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"compile.d.ts","sourceRoot":"","sources":["../../src/avm1/compile.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAKvC;;;GAGG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,YAAY,EACrB,EAAE,EAAE,IAAI,CAAC,OAAO,GACf,IAAI,CAAC,MAAM,CAkCb"}

package/dist/avm1/compile.js

@@ -0,0 +1,141 @@
+import { avm1 } from "@swf2es/runtime";
+import { evaluateFunction } from "../scripting/evaluate.js";
+let scripts = 0;
+/**
+ * Stable region arrays let the runtime and ExternalInterface identify a
+ * block before it is compiled; its functions keep that same array after.
+ */
+export function lazyBlocks(codegen, bytes, actions, rt) {
+    const script = ++scripts;
+    const version = actions.version;
+    const evaluate = (entry, name) => {
+        // AVM1 identifies its callers by region arrays, including on engines
+        // whose Function stack frames do not name their sourceURL.
+        const source = `export default function (rt) {\nconst V = rt.version(${version});\n${version < 5 ? "const V5 = rt.version(5);\n" : ""}return [\n${entry}\n];\n}\n`;
+        const factory = evaluateFunction(source, `swf2es-avm1-${script}-${name}.js`);
+        return factory(rt)[0];
+    };
+    const blocks = actions.blocks.map((_, index) => {
+        const regions = [];
+        regions.push((cx) => {
+            const entry = codegen.compileActionBlocks(bytes, actions, [index]).get(index);
+            if (entry === undefined) {
+                throw new Error(`swf2es: no compiled AVM1 block ${index}`);
+            }
+            const compiled = evaluate(entry, `${index}`);
+            regions.length = 0;
+            for (const region of compiled) {
+                regions.push(region);
+            }
+            return regions[0](cx);
+        });
+        return regions;
+    });
+    const units = unitsOf(codegen, bytes, actions, blocks, rt.realm.units, evaluate);
+    for (const regions of blocks) {
+        rt.realm.units.set(regions, units);
+    }
+    return blocks;
+}
+/**
+ * A SWF's units, each compiled as control first goes on in it: first the
+ * one of a region and bytes that end at the next bound of a block, which
+ * most regions can run, else the region's own (codegen's module.ts).
+ */
+function unitsOf(codegen, bytes, actions, blocks, known, evaluate) {
+    const bounds = blockBounds(bytes.length, actions);
+    // By offset, twice and once more for SWF 5's functions; by key, those of a region alone.
+    const first = new Map();
+    const own = new avm1.OwnUnits();
+    // Units of the same code are one, as the module writes them once: by
+    // the code's hash and length, the code itself not kept.
+    const byCode = new Map();
+    const units = {
+        blocks,
+        unit(at, end, bound, five) {
+            const index = at * 2 + (five ? 1 : 0);
+            let unit = first.get(index);
+            if (unit === undefined) {
+                const segment = segmentEnd(bounds, bytes.length, at);
+                const compiled = codegen.compileActionUnit(bytes, actions, {
+                    at,
+                    end: segment,
+                    bound: segment,
+                    five,
+                });
+                // One that only its own region runs never runs as a first choice.
+                unit = { ...compiled, code: compiled.high >= 0 ? compiled.code : null, regions: null };
+                first.set(index, unit);
+            }
+            if (unit.high >= 0 && unit.high <= end && unit.reach <= bound) {
+                if (unit.regions === null) {
+                    unit.regions = regionsOf(unit.code ?? "", at);
+                    unit.code = null;
+                }
+                return unit.regions;
+            }
+            let regions = own.get(at, end, bound, five);
+            if (regions === undefined) {
+                const { code } = codegen.compileActionUnit(bytes, actions, { at, end, bound, five });
+                regions = regionsOf(code, at);
+                own.set(at, end, bound, five, regions);
+            }
+            return regions;
+        },
+    };
+    const regionsOf = (code, at) => {
+        const hash = hashOf(code);
+        const same = byCode.get(hash);
+        for (const regions of same ?? []) {
+            // The regions' source is the code they were made of.
+            if (`[${regions.join(", ")}]` === code) {
+                return regions;
+            }
+        }
+        const regions = evaluate(code, `at-${at}`);
+        known.set(regions, units);
+        if (same === undefined) {
+            byCode.set(hash, [regions]);
+        }
+        else {
+            same.push(regions);
+        }
+        return regions;
+    };
+    return units;
+}
+/** FNV-1a of `text`'s code units, and its length. */
+function hashOf(text) {
+    let hash = 0x811c9dc5;
+    for (let i = 0; i < text.length; i++) {
+        hash = Math.imul(hash ^ text.charCodeAt(i), 0x01000193);
+    }
+    return (hash >>> 0) * 0x100000 + (text.length & 0xfffff);
+}
+/** The starts and ends of the SWF's blocks within its bytes, ascending, once each. */
+function blockBounds(size, actions) {
+    const bounds = new Set();
+    for (const { offset, length } of actions.blocks) {
+        if (offset >= 0 && length >= 0 && offset + length <= size) {
+            bounds.add(offset);
+            bounds.add(offset + length);
+        }
+    }
+    return [...bounds].sort((a, b) => a - b);
+}
+/** The first of `bounds` past `at`, else the SWF's end, as codegen's units.ts finds it. */
+function segmentEnd(bounds, size, at) {
+    let low = 0;
+    let high = bounds.length;
+    while (low < high) {
+        const mid = (low + high) >>> 1;
+        if (bounds[mid] <= at) {
+            low = mid + 1;
+        }
+        else {
+            high = mid;
+        }
+    }
+    return low < bounds.length ? bounds[low] : size;
+}
+//# sourceMappingURL=compile.js.map

package/dist/avm1/compile.js.map

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

package/dist/avm1/external.d.ts

@@ -0,0 +1,44 @@
+import type { avm1 } from "@swf2es/runtime";
+import type { ExternalInterfaceHost } from "../hosts.js";
+import type { Avm1 } from "./avm1.js";
+import type { ExternalHost } from "./globals/ExternalInterface.js";
+import type { Avm1Swf } from "./swf.js";
+type Value = avm1.Value;
+/** The page's ExternalInterface, and the SWFs that call out to the page. */
+export declare class ExternalCalls implements ExternalHost {
+    private readonly movie;
+    private readonly host;
+    /** Each SWF's blocks, by which a function's or block's code is known as that SWF's. */
+    private readonly codeSwfs;
+    /** The URLs of every SWF that has had code to run, unloaded ones too. */
+    private readonly codeUrls;
+    constructor(movie: Avm1, host: ExternalInterfaceHost | null);
+    get realm(): avm1.Realm;
+    /**
+     * The page's ExternalInterface, where it lets the code calling use it:
+     * the SWF whose block or function is running, known by its code; where
+     * a native is called with no code of a SWF's running, as a timer, a
+     * network callback or the page's call calls one straight, every SWF that
+     * has run code so far must be allowed, as AS3's natives ask when they
+     * cannot tell their caller (hosts.ts's allows). The clip a function was
+     * made in is not enough: a load can put another SWF in it.
+     */
+    externalBridge(): ExternalInterfaceHost | null;
+    /**
+     * The URL of the SWF whose code is running, known by its blocks; where
+     * no SWF's code is running, as a timer, a network callback or the page
+     * calls a native straight, every URL of a SWF that has had code.
+     */
+    callerUrls(): string[];
+    /** `swf`'s code compiled: its blocks known as its own, and its URL among those that ran code. */
+    ownCode(swf: Avm1Swf): void;
+    /**
+     * `body`, the page's call into a callback, run between frames or inside
+     * a call out, in the root's activation as a timer's callback runs, and
+     * what it queued run after it: what it returned, undefined where it did
+     * not run or threw.
+     */
+    callIn(body: () => Value): Value;
+}
+export {};
+//# sourceMappingURL=external.d.ts.map

package/dist/avm1/external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"external.d.ts","sourceRoot":"","sources":["../../src/avm1/external.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAExC,KAAK,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;AAExB,4EAA4E;AAC5E,qBAAa,aAAc,YAAW,YAAY;IAO9C,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPvB,uFAAuF;IACvF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyC;IAClE,yEAAyE;IACzE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAE9C,YACmB,KAAK,EAAE,IAAI,EACX,IAAI,EAAE,qBAAqB,GAAG,IAAI,EACjD;IAEJ,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAEtB;IAED;;;;;;;;OAQG;IACH,cAAc,IAAI,qBAAqB,GAAG,IAAI,CAQ7C;IAED;;;;OAIG;IACH,UAAU,IAAI,MAAM,EAAE,CAKrB;IAED,iGAAiG;IACjG,OAAO,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAQ1B;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,KAAK,CAoB/B;CACF"}

package/dist/avm1/external.js

@@ -0,0 +1,80 @@
+/** The page's ExternalInterface, and the SWFs that call out to the page. */
+export class ExternalCalls {
+    movie;
+    host;
+    /** Each SWF's blocks, by which a function's or block's code is known as that SWF's. */
+    codeSwfs = new WeakMap();
+    /** The URLs of every SWF that has had code to run, unloaded ones too. */
+    codeUrls = new Set();
+    constructor(movie, host) {
+        this.movie = movie;
+        this.host = host;
+    }
+    get realm() {
+        return this.movie.realm;
+    }
+    /**
+     * The page's ExternalInterface, where it lets the code calling use it:
+     * the SWF whose block or function is running, known by its code; where
+     * a native is called with no code of a SWF's running, as a timer, a
+     * network callback or the page's call calls one straight, every SWF that
+     * has run code so far must be allowed, as AS3's natives ask when they
+     * cannot tell their caller (hosts.ts's allows). The clip a function was
+     * made in is not enough: a load can put another SWF in it.
+     */
+    externalBridge() {
+        const host = this.host;
+        const allows = host?.allows;
+        if (host === null || allows === undefined) {
+            return host;
+        }
+        return this.callerUrls().every((url) => allows.call(host, url)) ? host : null;
+    }
+    /**
+     * The URL of the SWF whose code is running, known by its blocks; where
+     * no SWF's code is running, as a timer, a network callback or the page
+     * calls a native straight, every URL of a SWF that has had code.
+     */
+    callerUrls() {
+        // A unit's code is its SWF's blocks'.
+        const code = this.movie.realm.current?.code ?? [];
+        const caller = this.codeSwfs.get(this.movie.realm.units.get(code)?.blocks[0] ?? code);
+        return caller !== undefined ? [caller.url] : [...this.codeUrls];
+    }
+    /** `swf`'s code compiled: its blocks known as its own, and its URL among those that ran code. */
+    ownCode(swf) {
+        for (const block of swf.blocks) {
+            this.codeSwfs.set(block, swf);
+        }
+        if (swf.blocks.length > 0) {
+            this.codeUrls.add(swf.url);
+        }
+    }
+    /**
+     * `body`, the page's call into a callback, run between frames or inside
+     * a call out, in the root's activation as a timer's callback runs, and
+     * what it queued run after it: what it returned, undefined where it did
+     * not run or threw.
+     */
+    callIn(body) {
+        const movie = this.movie;
+        const root = movie.root;
+        const cx = root === null || movie.halted || !movie.loaded ? null : movie.activationOf(root);
+        if (cx === null) {
+            return undefined;
+        }
+        let result;
+        movie.timers.begin();
+        try {
+            movie.rt.call(cx, () => {
+                result = body();
+            });
+            movie.queue.run();
+        }
+        finally {
+            movie.timers.end();
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=external.js.map

package/dist/avm1/external.js.map

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

package/dist/avm1/focus.d.ts

@@ -0,0 +1,68 @@
+import { avm1 } from "@swf2es/runtime";
+import { type DisplayObject, MovieClip } from "../display/display.js";
+import type { Avm1 } from "./avm1.js";
+/** What the tab order reads of the movie's objects, their AS2 properties as code reads them. */
+export interface TabHost {
+    /** A tabEnabled set, or undefined where none is. */
+    tabEnabled(d: DisplayObject): boolean | undefined;
+    /** tabChildren, true where it is not set. */
+    tabChildren(d: DisplayObject): boolean;
+    /** A tabIndex set, as an int, or undefined where none is. */
+    tabIndex(d: DisplayObject): number | undefined;
+    buttonMode(clip: MovieClip): boolean;
+}
+/** The movie's focus: the object that has it, its highlight, and Tab's and Enter's moves of it. */
+export declare class FocusTracker implements TabHost {
+    private readonly movie;
+    /** `_global.Selection`, whose listeners hear the focus move. */
+    selectionFace: avm1.Avm1Object | null;
+    /** The button or clip with the focus. */
+    focusedObject: DisplayObject | null;
+    /**
+     * Whether keyboard navigation shows the focus (Ruffle's highlight): a
+     * focused object's onKeyDown and onKeyUp fire while it is not inactive,
+     * and Enter and Space press it while it is visible.
+     */
+    highlight: "inactive" | "visible" | "hidden";
+    constructor(movie: Avm1);
+    get focused(): DisplayObject | null;
+    /**
+     * Focus `d`, or none: where it changes, the one that had it hears
+     * onKillFocus(new), `d` onSetFocus(old), then Selection's listeners
+     * onSetFocus(old, new), at once, not queued (Ruffle's FocusTracker). The
+     * highlight shows where `d` may show it.
+     */
+    focus(d: DisplayObject | null): void;
+    /**
+     * A field given the focus, again too, has all its text selected, after
+     * the focus's events, which see none (Ruffle's update_edittext_selection;
+     * the corpus's `selection` and `edittext_programmatic_focus`).
+     */
+    private selectFocused;
+    /** Whether a script may focus `d`: a button, or a clip below the root in button mode or with focusEnabled true. */
+    focusable(d: DisplayObject): boolean;
+    /**
+     * Whether the focus shows on `d`: not the root, something drawn, and its
+     * `_focusrect`, from SWF 6 its own where it has one, else the stage's.
+     */
+    private highlightable;
+    tabEnabled(d: DisplayObject): boolean | undefined;
+    tabChildren(d: DisplayObject): boolean;
+    buttonMode(clip: MovieClip): boolean;
+    /** A tabIndex as an int: a number's or a boolean's, any other value's the least; -1 is none (Ruffle). */
+    tabIndex(d: DisplayObject): number | undefined;
+    /** Tab, or Shift+Tab: the focus to the next object in the tab order, or the one before, round. */
+    tab(reverse: boolean): boolean;
+    /**
+     * Enter or Space on what has the focus, where the highlight shows: a press
+     * and a release of it. Whether it was pressed, the key then the SWF's.
+     */
+    activate(): boolean;
+    /**
+     * The pointer's input, which hides the focus's highlight until Tab moves
+     * the focus again: a left press always, and, below SWF 9, any press,
+     * release or move.
+     */
+    pointerInput(type: "move" | "down" | "up", button: number): void;
+}
+//# sourceMappingURL=focus.d.ts.map

package/dist/avm1/focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../src/avm1/focus.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EAIL,KAAK,aAAa,EAClB,SAAS,EAEV,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAItC,gGAAgG;AAChG,MAAM,WAAW,OAAO;IACtB,oDAAoD;IACpD,UAAU,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;IAClD,6CAA6C;IAC7C,WAAW,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC;IACvC,6DAA6D;IAC7D,QAAQ,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAAC;IAC/C,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC;CACtC;AAmFD,mGAAmG;AACnG,qBAAa,YAAa,YAAW,OAAO;IAY9B,OAAO,CAAC,QAAQ,CAAC,KAAK;IAXlC,gEAAgE;IAChE,aAAa,EAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAQ;IAC7C,yCAAyC;IACzC,aAAa,EAAE,aAAa,GAAG,IAAI,CAAQ;IAC3C;;;;OAIG;IACH,SAAS,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAc;IAE1D,YAA6B,KAAK,EAAE,IAAI,EAAI;IAE5C,IAAI,OAAO,IAAI,aAAa,GAAG,IAAI,CAElC;IAED;;;;;OAKG;IACH,KAAK,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,IAAI,CAsDnC;IAED;;;;OAIG;IACH,OAAO,CAAC,aAAa;IAQrB,mHAAmH;IACnH,SAAS,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,CAYnC;IAED;;;OAGG;IACH,OAAO,CAAC,aAAa;IA2BrB,UAAU,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,GAAG,SAAS,CAGhD;IAED,WAAW,CAAC,CAAC,EAAE,aAAa,GAAG,OAAO,CAGrC;IAED,UAAU,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAEnC;IAED,yGAAyG;IACzG,QAAQ,CAAC,CAAC,EAAE,aAAa,GAAG,MAAM,GAAG,SAAS,CAW7C;IAED,kGAAkG;IAClG,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAiB7B;IAED;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAclB;IAED;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAQ/D;CACF"}