@swf2es/player 0.0.0-stage → 0.1.0

package/dist/avm1/queue.js

@@ -0,0 +1,304 @@
+// The AVM1 action queue: what a frame, an event or a script queues, run by
+// priority, the most urgent first, as Ruffle's
+// (https://github.com/ruffle-rs/ruffle) ActionQueue has it (MIT OR
+// Apache-2.0, Copyright (c) 2018-2022 Ruffle LLC and Ruffle contributors),
+// and the blocks each queued action runs (docs/avm1.md, "The frame").
+import { avm1 } from "@swf2es/runtime";
+import { ClipNative, nativeOf } from "./globals/MovieClip.js";
+// The queue's priorities, which it runs in order: initialize clip events
+// first, then the root's DoInitAction blocks, then constructions, then the
+// rest, frame actions, events and methods, each in the order queued
+// (Ruffle's ActionPriority; adl has a frame's initialize events before its
+// DoInitAction blocks, which Ruffle runs as the SWF loads).
+export const INITIALIZE = 0;
+export const INIT = 1;
+export const CONSTRUCT = 2;
+export const NORMAL = 3;
+// What a queued action is.
+/** A DoAction tag's blocks, `index` the tag's body's offset. */
+export const FRAME = 0;
+/** A block alone, a DoInitAction's or a clip event's, by its index. */
+export const BLOCK = 1;
+/** A timeline's clip's construction: its registered class's prototype and constructor, and its construct events. */
+export const CONSTRUCTION = 2;
+/** An AS2 event method, `name`, of the clip's object. */
+export const METHOD = 3;
+/** The SWF stopped, at a place whose clip actions Flash cannot read. */
+export const HALT = 4;
+/** A broadcaster's message, `name`, to its listeners: Key's and Mouse's, as the player sends them. */
+export const NOTIFY = 5;
+/** A method, `name`, of `object`, called with `args`, as a script would call it. */
+export const CALL = 6;
+/** An action waiting its turn in the frame. */
+export class Queued {
+    kind;
+    clip;
+    swf;
+    index;
+    entry;
+    unload;
+    name;
+    blocks;
+    object;
+    args;
+    constructor(kind, clip, 
+    /** The SWF whose blocks `index` and `blocks` are. */
+    swf = null, index = 0, 
+    /** Which of the clip's frame entries queued a FRAME: blocks of one share their constant pool. */
+    entry = 0, 
+    /** Whether it is an unload's, which runs for a clip removed since. */
+    unload = false, name = "", blocks = NO_BLOCKS, 
+    /** A NOTIFY's broadcaster or a CALL's object, and the arguments. */
+    object = null, args = NO_ARGS) {
+        this.kind = kind;
+        this.clip = clip;
+        this.swf = swf;
+        this.index = index;
+        this.entry = entry;
+        this.unload = unload;
+        this.name = name;
+        this.blocks = blocks;
+        this.object = object;
+        this.args = args;
+    }
+}
+export const NO_BLOCKS = [];
+/** How many queued actions of a priority run before those run are dropped from its queue. */
+const COMPACT_AT = 4096;
+export const NO_ARGS = [];
+/** The queue a movie's actions wait in, by priority, and what runs them. */
+export class ActionQueue {
+    movie;
+    /** The queue, by priority, and how far each has run. */
+    queues = [[], [], [], []];
+    heads = [0, 0, 0, 0];
+    /** Whether the queue is running, which a function's return runs the earlier passes of. */
+    running = false;
+    /** The pass of the action the queue runs, and the pass `next` last took from. */
+    priority = NORMAL;
+    taken = NORMAL;
+    constructor(movie) {
+        this.movie = movie;
+    }
+    enqueue(priority, q) {
+        this.queues[priority].push(q);
+    }
+    /** The next action of priorities `from` to `to`, the most urgent first; null for none. */
+    next(from = INITIALIZE, to = NORMAL) {
+        for (let p = from; p <= to; p++) {
+            const queue = this.queues[p];
+            // Gotos that go back and forth queue each other's frames for as long
+            // as they run, which is forever in a SWF that never stops them: what
+            // has run goes, and so do the clips they removed, so that such a SWF
+            // runs into the script timeout without its memory growing.
+            if (this.heads[p] >= COMPACT_AT) {
+                queue.splice(0, this.heads[p]);
+                this.heads[p] = 0;
+                const movie = this.movie;
+                movie.clips = movie.clips.filter((clip) => !movie.removed(clip));
+            }
+            if (this.heads[p] < queue.length) {
+                this.taken = p;
+                return queue[this.heads[p]++];
+            }
+        }
+        return null;
+    }
+    /**
+     * Run what is queued, by priority, what it queues included: the actions
+     * of a clip still on the display list but an unload's; a frame entry's
+     * blocks sharing a constant pool, each starting with the one the block
+     * before left.
+     */
+    run() {
+        const movie = this.movie;
+        if (!movie.loaded || this.running) {
+            return;
+        }
+        this.running = true;
+        let pool = [];
+        let last = null;
+        try {
+            for (let q = this.next(); q !== null; q = this.next()) {
+                if (movie.halted || movie.rt.disabled) {
+                    continue;
+                }
+                // A goto that queues its own frame again and again loops here, as a jump back does.
+                if (--movie.realm.budget < 0) {
+                    this.timeout();
+                }
+                this.priority = this.taken;
+                if (q.kind === FRAME) {
+                    if (last === null || last.clip !== q.clip || last.entry !== q.entry) {
+                        pool = [];
+                    }
+                    last = q;
+                    if (!this.gone(q.clip)) {
+                        pool = this.runOne(q, pool);
+                    }
+                }
+                else {
+                    this.runOne(q, []);
+                }
+            }
+        }
+        finally {
+            this.running = false;
+            for (let p = 0; p < this.queues.length; p++) {
+                this.queues[p].length = 0;
+                this.heads[p] = 0;
+            }
+        }
+    }
+    /** The queue's own check of the script timeout, which disables the movie's actions past it. */
+    timeout() {
+        const cx = this.movie.activationOf(this.movie.root);
+        if (cx !== null) {
+            this.movie.rt.call(cx, () => this.movie.realm.timeout());
+        }
+    }
+    /**
+     * A function of the SWF's returned to code the queue runs: Flash runs
+     * what was queued by then of the passes before that code's, a frame
+     * action's initializations and constructions, a construction's
+     * initializations (adl, and the corpus's register_and_init_order).
+     */
+    returned() {
+        if (!this.running) {
+            return;
+        }
+        const outer = this.priority;
+        try {
+            for (let q = this.next(INITIALIZE, outer - 1); q !== null; q = this.next(INITIALIZE, outer - 1)) {
+                if (!this.movie.halted && !this.movie.rt.disabled) {
+                    this.priority = this.taken;
+                    this.runOne(q, []);
+                }
+            }
+        }
+        finally {
+            this.priority = outer;
+        }
+    }
+    /**
+     * Whether the clip of a queued action is gone: its actions do not run
+     * but an unload's. One kept a frame for an unload handler is, where it
+     * has clip actions of its own; one without, kept for an onUnload or for
+     * a clip in it, runs what it queued before (adl; Ruffle skips them all).
+     */
+    gone(d) {
+        if (this.movie.removed(d)) {
+            return true;
+        }
+        const native = nativeOf(d);
+        return native?.pending === true && native.handlers !== null;
+    }
+    /** Run one queued action, from constant pool `pool` for a FRAME; the pool it leaves. */
+    runOne(q, pool) {
+        const clip = q.clip;
+        if (q.kind !== FRAME && !q.unload && this.gone(clip)) {
+            return pool;
+        }
+        switch (q.kind) {
+            case FRAME:
+                // A clip a load has filled since runs none of what it queued before.
+                if (q.swf !== this.movie.swfOf(clip)) {
+                    return pool;
+                }
+                for (const index of q.swf.list?.byTag.get(q.index) ?? NO_BLOCKS) {
+                    pool = this.runBlock(q.swf, index, pool, clip);
+                }
+                return pool;
+            case BLOCK:
+                this.runBlock(q.swf, q.index, [], clip);
+                break;
+            case CONSTRUCTION:
+                this.construction(q);
+                break;
+            case METHOD: {
+                const face = clip.avm1;
+                const cx = this.movie.activationOf(clip);
+                if (face !== null && cx !== null && !this.movie.removed(clip)) {
+                    this.movie.rt.callMethod(cx, face, q.name, NO_ARGS, this.movie.swfOf(clip).version);
+                }
+                break;
+            }
+            case HALT:
+                this.movie.halted = true;
+                break;
+            case CALL: {
+                const cx = this.movie.activationOf(clip);
+                if (cx !== null && q.object !== null) {
+                    this.movie.rt.callMethod(cx, q.object, q.name, q.args, this.movie.version);
+                }
+                break;
+            }
+            case NOTIFY: {
+                const cx = this.movie.activationOf(clip);
+                const object = q.object;
+                if (cx !== null && object !== null) {
+                    this.movie.rt.call(cx, () => {
+                        avm1.broadcastMessage(object, q.name, q.args, this.movie.version, (listener) => {
+                            const display = listener.display;
+                            return display instanceof ClipNative && this.movie.removed(display.target);
+                        });
+                    });
+                }
+                break;
+            }
+        }
+        return pool;
+    }
+    /**
+     * A timeline's clip constructed: its registered class's prototype, its
+     * construct events, then the class's constructor on it.
+     */
+    construction(q) {
+        const face = q.clip.avm1;
+        if (face === null) {
+            return;
+        }
+        const constr = this.movie.classes.classOf(q.clip);
+        if (constr !== null) {
+            face.define("__proto__", avm1.get(constr, "prototype", this.movie.swfOf(q.clip).version), avm1.DONT_ENUM | avm1.DONT_DELETE);
+        }
+        for (const block of q.blocks) {
+            this.runBlock(q.swf, block, [], q.clip);
+        }
+        if (constr !== null) {
+            this.movie.scriptClips.construct(q.clip, face, constr);
+        }
+    }
+    /** CallFrame: the actions of `clip`'s frame `frame`, run now in order, each with a pool of its own. */
+    callFrame(clip, frame) {
+        const swf = this.movie.swfOf(clip);
+        for (const command of clip.timeline.frames[frame - 1] ?? []) {
+            if (command.type === "actions") {
+                for (const index of swf.list?.byTag.get(command.tag) ?? []) {
+                    this.runBlock(swf, index, [], clip);
+                }
+            }
+        }
+    }
+    /**
+     * Run `swf`'s block `index` with `clip` as its target, starting from
+     * constant pool `pool`; the pool it leaves.
+     */
+    runBlock(swf, index, pool, clip) {
+        const regions = swf?.blocks[index];
+        const cx = regions ? this.movie.activationOf(clip, pool) : null;
+        if (!regions || cx === null) {
+            return pool;
+        }
+        try {
+            this.movie.rt.run(regions, cx);
+        }
+        catch (error) {
+            if (!(error instanceof avm1.Halt)) {
+                this.movie.onUncaught(error);
+            }
+        }
+        return cx.pool;
+    }
+}
+//# sourceMappingURL=queue.js.map

package/dist/avm1/queue.js.map

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

package/dist/avm1/sound.d.ts

@@ -0,0 +1,36 @@
+import type { avm1 } from "@swf2es/runtime";
+import type { DisplayObject } from "../display/display.js";
+import type { SoundCharacter } from "../display/timeline.js";
+import type { AudioHost, DecodedSound } from "../media/audio.js";
+import { type SoundHost } from "../media/sounds.js";
+import type { Avm1 } from "./avm1.js";
+import { type Avm1SoundTransform, type SoundClassHost } from "./globals/Sound.js";
+/** The movie's sounds, as Sound and the timeline's sounds see them. */
+export declare class Avm1Sounds implements SoundClassHost {
+    private readonly movie;
+    readonly audio: AudioHost | null;
+    /** What the timeline's sounds, and Sound's, play by. */
+    readonly sounds: SoundHost;
+    /** The frames played, which the timeline's sounds count by. */
+    frames: number;
+    /** Each sound decoded once for the device. */
+    private readonly decodes;
+    /** The transforms Sound gave clips, and the global one. */
+    private readonly soundTransforms;
+    private globalSoundTransform;
+    /** The Sounds whose sound ended, for their onSoundComplete after the frame's actions. */
+    private completed;
+    constructor(movie: Avm1, audio: AudioHost | null);
+    get realm(): avm1.Realm;
+    resolve(value: avm1.Value, version: number): DisplayObject | null;
+    /** The DefineSound ExportAssets named `name`, any case, as attachSound finds it. */
+    exportedSound(name: string): SoundCharacter | null;
+    soundTransform(d: DisplayObject | null): Avm1SoundTransform;
+    setSoundTransform(d: DisplayObject | null, transform: Avm1SoundTransform): void;
+    /** A Sound's sound has ended: its onSoundComplete runs once the frame's actions have. */
+    complete(o: avm1.Avm1Object): void;
+    /** Each ended Sound's onSoundComplete, in the root's activation: whether any ran. */
+    soundsCompleted(): boolean;
+    soundClip(character: SoundCharacter): Promise<DecodedSound> | null;
+}
+//# sourceMappingURL=sound.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sound.d.ts","sourceRoot":"","sources":["../../src/avm1/sound.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAa,MAAM,uBAAuB,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,KAAK,SAAS,EAAe,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EACL,KAAK,kBAAkB,EAGvB,KAAK,cAAc,EACpB,MAAM,oBAAoB,CAAC;AAI5B,uEAAuE;AACvE,qBAAa,UAAW,YAAW,cAAc;IAc7C,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAdlC,wDAAwD;IACxD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,+DAA+D;IAC/D,MAAM,SAAK;IACX,8CAA8C;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwD;IAChF,2DAA2D;IAC3D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAoD;IACpF,OAAO,CAAC,oBAAoB,CAA4B;IACxD,yFAAyF;IACzF,OAAO,CAAC,SAAS,CAAyB;IAE1C,YACmB,KAAK,EAAE,IAAI,EACnB,KAAK,EAAE,SAAS,GAAG,IAAI,EA0BjC;IAED,IAAI,KAAK,IAAI,IAAI,CAAC,KAAK,CAEtB;IAED,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAEhE;IAED,oFAAoF;IACpF,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAKjD;IAED,cAAc,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,GAAG,kBAAkB,CAE1D;IAED,iBAAiB,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,EAAE,SAAS,EAAE,kBAAkB,GAAG,IAAI,CAQ9E;IAED,yFAAyF;IACzF,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAEjC;IAED,qFAAqF;IACrF,eAAe,IAAI,OAAO,CAiBzB;IAED,SAAS,CAAC,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAajE;CACF"}

package/dist/avm1/sound.js

@@ -0,0 +1,107 @@
+import { updateMixes } from "../media/sounds.js";
+import { FULL, mixOfTransform, } from "./globals/Sound.js";
+import { asciiLower } from "./paths.js";
+import { NO_ARGS } from "./queue.js";
+/** The movie's sounds, as Sound and the timeline's sounds see them. */
+export class Avm1Sounds {
+    movie;
+    audio;
+    /** What the timeline's sounds, and Sound's, play by. */
+    sounds;
+    /** The frames played, which the timeline's sounds count by. */
+    frames = 0;
+    /** Each sound decoded once for the device. */
+    decodes = new WeakMap();
+    /** The transforms Sound gave clips, and the global one. */
+    soundTransforms = new WeakMap();
+    globalSoundTransform = FULL;
+    /** The Sounds whose sound ended, for their onSoundComplete after the frame's actions. */
+    completed = [];
+    constructor(movie, audio) {
+        this.movie = movie;
+        this.audio = audio;
+        const media = this;
+        this.sounds = {
+            get audio() {
+                return media.audio;
+            },
+            get now() {
+                return movie.timers.now();
+            },
+            get frames() {
+                return media.frames;
+            },
+            get frameRate() {
+                return movie.frameRate;
+            },
+            soundClip: (character) => this.soundClip(character),
+            ownMix: (d) => {
+                const t = this.soundTransforms.get(d);
+                return t === undefined ? undefined : mixOfTransform(t);
+            },
+            get mixer() {
+                return mixOfTransform(media.globalSoundTransform);
+            },
+            scriptSounds: () => 0,
+        };
+    }
+    get realm() {
+        return this.movie.realm;
+    }
+    resolve(value, version) {
+        return this.movie.resolve(value, version);
+    }
+    /** The DefineSound ExportAssets named `name`, any case, as attachSound finds it. */
+    exportedSound(name) {
+        const swf = this.movie.currentSwf();
+        const id = swf.exports.get(asciiLower(name));
+        const character = id === undefined ? undefined : swf.library?.characters.get(id);
+        return character?.type === "sound" ? character : null;
+    }
+    soundTransform(d) {
+        return d === null ? this.globalSoundTransform : (this.soundTransforms.get(d) ?? FULL);
+    }
+    setSoundTransform(d, transform) {
+        if (d === null) {
+            this.globalSoundTransform = transform;
+        }
+        else {
+            this.soundTransforms.set(d, transform);
+        }
+        updateMixes(this.sounds);
+    }
+    /** A Sound's sound has ended: its onSoundComplete runs once the frame's actions have. */
+    complete(o) {
+        this.completed.push(o);
+    }
+    /** Each ended Sound's onSoundComplete, in the root's activation: whether any ran. */
+    soundsCompleted() {
+        const completed = this.completed;
+        this.completed = [];
+        const movie = this.movie;
+        const root = movie.root;
+        if (completed.length === 0 || root === null) {
+            return false;
+        }
+        const cx = movie.activationOf(root);
+        for (const o of completed) {
+            if (cx !== null && !movie.halted) {
+                movie.rt.callMethod(cx, o, "onSoundComplete", NO_ARGS, movie.version);
+            }
+        }
+        return true;
+    }
+    soundClip(character) {
+        const audio = this.audio;
+        if (audio === null) {
+            return null;
+        }
+        let clip = this.decodes.get(character);
+        if (clip === undefined) {
+            clip = Promise.resolve().then(() => audio.decode(character.definition));
+            this.decodes.set(character, clip);
+        }
+        return clip;
+    }
+}
+//# sourceMappingURL=sound.js.map

package/dist/avm1/sound.js.map

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

package/dist/avm1/swf.d.ts

@@ -0,0 +1,90 @@
+import { type ActionList, type Place, type Swf } from "@swf2es/format";
+import type { avm1 } from "@swf2es/runtime";
+import type { MovieClip } from "../display/display.js";
+import type { Library } from "../display/timeline.js";
+/**
+ * Where in a frame Flash stops the SWF at a place whose clip actions it
+ * cannot read: it reads them as the first of the place's events comes, so
+ * as it places the clip for load and initialize, before any of the
+ * frame's actions; after the frame's DoInitActions for construct; at the
+ * next frame for enterFrame, the frame's actions run. A place of other
+ * events stops it as one comes to the clip (`dispatch`).
+ */
+export type Stop = "place" | "construct" | "enterFrame";
+/** The first of `events`, a place's field of all events, by which Flash stops. */
+export declare function stopOf(events: number): Stop | null;
+/** What happens as the root enters a frame, before its places and DoAction blocks. */
+interface RootFrame {
+    /** Its ExportAssets' names, which attachMovie and registerClass find characters by. */
+    exports: {
+        id: number;
+        name: string;
+    }[];
+    /** Its DoInitAction blocks, by index, with the sprite each is of. */
+    inits: {
+        sprite: number;
+        block: number;
+    }[];
+    /** Where a place in the frame whose clip actions Flash cannot read stops the SWF. */
+    stop: Stop | null;
+    /** The frame's last ScriptLimits: its recursion depth and script timeout, in seconds. */
+    limits: [number, number] | null;
+}
+/** A clip action: the block, the events it runs for, and keyPress's key code. */
+export interface Handler {
+    events: number;
+    key: number;
+    block: number;
+}
+export declare const NO_HANDLERS: Handler[];
+/** A button's condition block: the transitions it runs on, and its key (0 for none). */
+export interface ButtonHandler {
+    conditions: number;
+    key: number;
+    block: number;
+}
+/**
+ * One AVM1 SWF the player runs, the main one or one loadMovie loaded: its
+ * blocks, its library and what its root's frames export and initialize,
+ * which its own code and timelines use, not another's (Ruffle's per-movie
+ * library). Every SWF shares the player's realm, `_global` among it.
+ */
+export declare class Avm1Swf {
+    readonly library: Library | null;
+    readonly list: ActionList | null;
+    readonly version: number;
+    /** Its URL, which `_url` gives. */
+    readonly url: string;
+    /** Its length in bytes, which getBytesTotal and getBytesLoaded give for its root. */
+    readonly length: number;
+    /** Its size as it came, compressed, which MovieClipLoader.getProgress gives. */
+    readonly size: number;
+    /** Its module's blocks, by index. */
+    blocks: avm1.Blocks;
+    /** By its root's frame, 1 the first. */
+    readonly frames: Map<number, RootFrame>;
+    /** The sprites whose DoInitAction has run. */
+    readonly initialized: Set<number>;
+    /** Exported characters by name in lower case, as attachMovie finds them, and each one's name. */
+    readonly exports: Map<string, number>;
+    readonly exportNames: Map<number, string>;
+    /** Each button character's condition blocks, by its id, gathered from the action list once. */
+    buttonHandlers: Map<number, ButtonHandler[]> | null;
+    /** The clip that plays it as its root: level 0's, a level's or the clip it was loaded into. */
+    root: MovieClip | null;
+    constructor(library: Library | null, list: ActionList | null, version: number, 
+    /** Its URL, which `_url` gives. */
+    url: string, 
+    /** Its length in bytes, which getBytesTotal and getBytesLoaded give for its root. */
+    length: number, 
+    /** Its size as it came, compressed, which MovieClipLoader.getProgress gives. */
+    size?: number);
+}
+/** Each root frame's exports, DoInitAction blocks, the tags Flash cannot read and its ScriptLimits. */
+export declare function readRootFrames(swf: Swf, into: Avm1Swf): void;
+/** A place's clip actions, with the events each runs for, as `swf`'s action list has them. */
+export declare function handlersOf(place: Place, swf: Avm1Swf): Handler[] | null;
+/** `id`'s condition blocks: a DefineButton's one, or a DefineButton2's, one a BUTTONCONDACTION. */
+export declare function handlersOfButton(swf: Avm1Swf, id: number): readonly ButtonHandler[];
+export {};
+//# sourceMappingURL=swf.d.ts.map

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

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