@swf2es/runtime 0.0.0-stage → 0.1.1

package/dist/avm1/control.js

@@ -0,0 +1,281 @@
+import { Avm1Throw } from "./errors.js";
+import { Avm1Object } from "./objects.js";
+import { MAX_SCOPES, SCOPE_With, Scope } from "./scope.js";
+/** A With's object, or a catch's variable, on the scope chain. */
+const HELD_Scope = 0;
+const HELD_Try = 1;
+/** A finally reached by a throw: `value` is thrown again as control leaves it. */
+const HELD_Thrown = 2;
+/** A finally reached by a Return, whose value is on the stack: it returns as control leaves it. */
+const HELD_Returned = 3;
+/** A Try's catch that a throw does not land in. */
+const NO_CATCH = -2;
+export class Held {
+    kind;
+    from;
+    to;
+    value;
+    constructor(kind, 
+    /** The blocks it holds over, from `from` to `to`, excluded. */
+    from, to, 
+    /** A finally's thrown value. */
+    value = undefined) {
+        this.kind = kind;
+        this.from = from;
+        this.to = to;
+        this.value = value;
+    }
+    holds(block) {
+        return this.from <= block && block < this.to;
+    }
+    /** Whether a scope holds as control goes to `block`: one of its body's, or the first past it. */
+    admits(block) {
+        return this.from <= block && block <= this.to;
+    }
+}
+const isScope = (h) => h.kind === HELD_Scope;
+/** A scope: the chain it made, and the chain under it, which it gives back as it comes off. */
+class ScopeHeld extends Held {
+    chain;
+    below;
+    constructor(from, to, chain, below) {
+        super(HELD_Scope, from, to);
+        this.chain = chain;
+        this.below = below;
+    }
+}
+/** A Try's handlers, held over its try and catch bodies. */
+class TryHeld extends Held {
+    catchFrom;
+    finallyFrom;
+    finallyTo;
+    catchAt;
+    into;
+    height;
+    constructor(from, 
+    /** Where the catch body starts: before it, a throw is the catch's. */
+    catchFrom, 
+    /** The finally body's blocks, none where it has none. */
+    finallyFrom, finallyTo, 
+    /** Where a throw lands for the catch, -1 for the region's exit, NO_CATCH for none. */
+    catchAt, 
+    /** The catch's variable, or its register. */
+    into, 
+    /** The operand stack's height as the Try ran, which a throw cuts it back to. */
+    height) {
+        super(HELD_Try, from, finallyFrom);
+        this.catchFrom = catchFrom;
+        this.finallyFrom = finallyFrom;
+        this.finallyTo = finallyTo;
+        this.catchAt = catchAt;
+        this.into = into;
+        this.height = height;
+    }
+}
+function heldOf(cx) {
+    let held = cx.held;
+    if (held === null) {
+        held = [];
+        cx.held = held;
+    }
+    return held;
+}
+/** `object` on top of the scope chain, held over the blocks from `from` to `to`. */
+function pushScope(cx, object, from, to) {
+    const below = cx.scope;
+    cx.scope = new Scope(below, SCOPE_With, object);
+    heldOf(cx).push(new ScopeHeld(from, to, cx.scope, below));
+}
+/**
+ * Keeps of `held`, from index `from` up, the entries `keep` says, and the
+ * scope chain as the scopes kept make it: the top one's, or with none
+ * kept, the chain under the first one taken off.
+ */
+function keepFrom(cx, held, from, keep) {
+    let n = from;
+    let top = null;
+    let base = null;
+    for (let i = from; i < held.length; i++) {
+        const h = held[i];
+        if (keep(h)) {
+            held[n++] = h;
+            if (h instanceof ScopeHeld) {
+                top = h.chain;
+            }
+        }
+        else if (h instanceof ScopeHeld && base === null) {
+            base = h.below;
+        }
+    }
+    held.length = n;
+    if (top !== null) {
+        cx.scope = top;
+    }
+    else if (base !== null) {
+        cx.scope = base;
+    }
+}
+/**
+ * Control going to the start of block `at`: the scopes on top that do not
+ * hold there come off at once, as adl looks only at the top one.
+ */
+function reach(cx, held, at) {
+    let n = held.length;
+    while (n > 0 && held[n - 1].kind === HELD_Scope && !held[n - 1].admits(at)) {
+        n--;
+    }
+    if (n < held.length) {
+        keepFrom(cx, held, n, () => false);
+    }
+}
+function cut(st, height) {
+    if (st.length > height) {
+        st.length = height;
+    }
+}
+/**
+ * With: `value`, a primitive boxed, on the scope chain over the body's
+ * blocks; false, the body skipped, for undefined and null, and where the
+ * chain holds MAX_SCOPES already (adl).
+ */
+export function enterWith(cx, value, from, to, version) {
+    if (value === undefined || value === null || cx.scope.depth >= MAX_SCOPES) {
+        return false;
+    }
+    pushScope(cx, cx.realm.box(value, version), from, to);
+    return true;
+}
+/** Try: its handlers, held over its try and catch bodies. */
+export function enterTry(cx, from, catchFrom, finallyFrom, finallyTo, catchAt, into) {
+    heldOf(cx).push(new TryHeld(from, catchFrom, finallyFrom, finallyTo, catchAt, into, cx.st.length));
+}
+/**
+ * Where control goes from the block `at`, where `error` was thrown: the
+ * catch of the first Try whose try body holds it, its variable set, or the
+ * finally of the first whose try or catch body does, which throws the
+ * value again as control leaves it. The stack is cut back to its height
+ * as that Try ran. Another error, a bug's or the host's, a recursion
+ * limit's, passes through, as does a value no Try catches.
+ */
+export function caught(cx, error, at) {
+    const held = cx.held;
+    if (!(error instanceof Avm1Throw) || held === null) {
+        throw error;
+    }
+    cx.into = -1;
+    for (let i = held.length - 1; i >= 0; i--) {
+        const h = held[i];
+        if (!(h instanceof TryHeld) || !h.holds(at)) {
+            continue;
+        }
+        if (at < h.catchFrom && h.catchAt !== NO_CATCH) {
+            // The scopes where it was thrown hold over the catch body too, under
+            // its variable's (adl).
+            const from = h.catchFrom;
+            const to = h.finallyFrom;
+            keepFrom(cx, held, i + 1, isScope);
+            for (let j = i + 1; j < held.length; j++) {
+                held[j].from = from;
+                held[j].to = to;
+            }
+            cut(cx.st, h.height);
+            const into = h.into;
+            if (typeof into === "number") {
+                cx.into = into;
+                cx.thrown = error.value;
+            }
+            else {
+                const scope = new Avm1Object();
+                scope.add(into, error.value, 0);
+                pushScope(cx, scope, from, to);
+            }
+            return h.catchAt;
+        }
+        if (h.finallyFrom < h.finallyTo) {
+            // The finally's mark goes under the scopes, which come off as control goes there.
+            held[i] = new Held(HELD_Thrown, h.finallyFrom, h.finallyTo, error.value);
+            keepFrom(cx, held, i + 1, isScope);
+            cut(cx.st, h.height);
+            reach(cx, held, h.finallyFrom);
+            return h.finallyFrom;
+        }
+    }
+    throw error;
+}
+/**
+ * Control going to block `to` (-1: the exit) across the bounds of a body:
+ * the Trys that do not hold over it come off, and a finally that a throw
+ * or a Return reached throws or returns as control leaves it, even by a
+ * jump. The scopes on top that do not hold there come off; those whose
+ * body it is the first block past, after its first action (V.scopes).
+ */
+export function leave(cx, to) {
+    const held = cx.held;
+    if (held !== null) {
+        for (let i = held.length - 1; i >= 0; i--) {
+            const h = held[i];
+            if (h.holds(to)) {
+                break;
+            }
+            if (h.kind === HELD_Scope) {
+                continue;
+            }
+            held.splice(i, 1);
+            if (h.kind === HELD_Thrown) {
+                throw new Avm1Throw(h.value);
+            }
+            if (h.kind === HELD_Returned) {
+                return returned(cx);
+            }
+        }
+    }
+    if (to < 0) {
+        cx.ret = undefined;
+    }
+    else if (held !== null) {
+        reach(cx, held, to);
+    }
+    return to;
+}
+/** The scopes that do not hold over block `at`, where control is, come off. */
+export function scopes(cx, at) {
+    const held = cx.held;
+    if (held === null) {
+        return;
+    }
+    let n = held.length;
+    while (n > 0 && held[n - 1].kind === HELD_Scope && !held[n - 1].holds(at)) {
+        n--;
+    }
+    if (n < held.length) {
+        keepFrom(cx, held, n, () => false);
+    }
+}
+/**
+ * Return, its value on top of the stack: the finally of the first Try
+ * whose try or catch body holds control runs first, the stack cut back to
+ * its height as that Try ran with the value left on top, and the value is
+ * popped as control leaves it, the stack's top then (adl); a finally's own
+ * throw or Return gives way to this one.
+ */
+export function returned(cx) {
+    const held = cx.held;
+    if (held !== null) {
+        for (let i = held.length - 1; i >= 0; i--) {
+            const h = held[i];
+            if (h instanceof TryHeld && h.finallyFrom < h.finallyTo) {
+                const st = cx.st;
+                const value = st.pop();
+                cut(st, h.height);
+                st.push(value);
+                held[i] = new Held(HELD_Returned, h.finallyFrom, h.finallyTo);
+                keepFrom(cx, held, i + 1, isScope);
+                reach(cx, held, h.finallyFrom);
+                return h.finallyFrom;
+            }
+        }
+    }
+    cx.ret = cx.st.pop();
+    return -1;
+}
+//# sourceMappingURL=control.js.map

package/dist/avm1/control.js.map

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

package/dist/avm1/errors.d.ts

@@ -0,0 +1,49 @@
+import type { Value } from "./values.js";
+/** An action the runtime does not do yet: it ends the block it is in. */
+export declare class NotYet extends Error {
+    name: string;
+}
+/**
+ * Thrown once the host has stopped the SWF at an action Flash cannot read,
+ * to end whatever runs; the player takes it for no error.
+ */
+export declare class Halt extends Error {
+    name: string;
+}
+/**
+ * Thrown after a call, a `new` or a CallFrame that took the clip whose
+ * code runs off the display list: that code's activation returns there,
+ * a function's with undefined, and the code that called it goes on to its
+ * own check (adl; Ruffle's continue_if_base_clip_exists). One instance,
+ * thrown as a signal and never shown.
+ */
+export declare class BaseRemoved extends Error {
+    name: string;
+}
+export declare const BASE_REMOVED: BaseRemoved;
+/**
+ * Thrown past Flash's recursion limit: Flash disables every action of the
+ * movie from there, and its timelines play on.
+ */
+export declare class Disabled extends Error {
+    name: string;
+}
+/**
+ * Thrown as scripts run past the script timeout, Flash's 15 seconds or a
+ * ScriptLimits tag's: Flash asks whether to stop them, and stopped, the
+ * movie's actions are disabled as past the recursion limit (Ruffle halts
+ * its AVM1 so too).
+ */
+export declare class TimedOut extends Disabled {
+    name: string;
+}
+/**
+ * A value AVM1 code throws (Throw), which a Try's catch or finally takes
+ * and which, caught by none, ends the block as Flash ends it, silently.
+ */
+export declare class Avm1Throw extends Error {
+    readonly value: Value;
+    name: string;
+    constructor(value: Value);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/avm1/errors.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,yEAAyE;AACzE,qBAAa,MAAO,SAAQ,KAAK;IACtB,IAAI,SAAgB;CAC9B;AAED;;;GAGG;AACH,qBAAa,IAAK,SAAQ,KAAK;IACpB,IAAI,SAAc;CAC5B;AAED;;;;;;GAMG;AACH,qBAAa,WAAY,SAAQ,KAAK;IAC3B,IAAI,SAAqB;CACnC;AAED,eAAO,MAAM,YAAY,aAA0D,CAAC;AAEpF;;;GAGG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACxB,IAAI,SAAkB;CAChC;AAED;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,QAAQ;IAC3B,IAAI,SAAkB;CAChC;AAED;;;GAGG;AACH,qBAAa,SAAU,SAAQ,KAAK;IAGtB,QAAQ,CAAC,KAAK,EAAE,KAAK;IAFxB,IAAI,SAAe;IAE5B,YAAqB,KAAK,EAAE,KAAK,EAEhC;CACF"}

package/dist/avm1/errors.js

@@ -0,0 +1,51 @@
+/** An action the runtime does not do yet: it ends the block it is in. */
+export class NotYet extends Error {
+    name = "Avm1NotYet";
+}
+/**
+ * Thrown once the host has stopped the SWF at an action Flash cannot read,
+ * to end whatever runs; the player takes it for no error.
+ */
+export class Halt extends Error {
+    name = "Avm1Halt";
+}
+/**
+ * Thrown after a call, a `new` or a CallFrame that took the clip whose
+ * code runs off the display list: that code's activation returns there,
+ * a function's with undefined, and the code that called it goes on to its
+ * own check (adl; Ruffle's continue_if_base_clip_exists). One instance,
+ * thrown as a signal and never shown.
+ */
+export class BaseRemoved extends Error {
+    name = "Avm1BaseRemoved";
+}
+export const BASE_REMOVED = new BaseRemoved("the clip whose code runs was removed");
+/**
+ * Thrown past Flash's recursion limit: Flash disables every action of the
+ * movie from there, and its timelines play on.
+ */
+export class Disabled extends Error {
+    name = "Avm1Disabled";
+}
+/**
+ * Thrown as scripts run past the script timeout, Flash's 15 seconds or a
+ * ScriptLimits tag's: Flash asks whether to stop them, and stopped, the
+ * movie's actions are disabled as past the recursion limit (Ruffle halts
+ * its AVM1 so too).
+ */
+export class TimedOut extends Disabled {
+    name = "Avm1TimedOut";
+}
+/**
+ * A value AVM1 code throws (Throw), which a Try's catch or finally takes
+ * and which, caught by none, ends the block as Flash ends it, silently.
+ */
+export class Avm1Throw extends Error {
+    value;
+    name = "Avm1Throw";
+    constructor(value) {
+        super("an AVM1 value thrown and not caught");
+        this.value = value;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/avm1/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/avm1/errors.ts"],"names":[],"mappings":"AAKA,yEAAyE;AACzE,MAAM,OAAO,MAAO,SAAQ,KAAK;IACtB,IAAI,GAAG,YAAY,CAAC;CAC9B;AAED;;;GAGG;AACH,MAAM,OAAO,IAAK,SAAQ,KAAK;IACpB,IAAI,GAAG,UAAU,CAAC;CAC5B;AAED;;;;;;GAMG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,GAAG,iBAAiB,CAAC;CACnC;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,WAAW,CAAC,sCAAsC,CAAC,CAAC;AAEpF;;;GAGG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,IAAI,GAAG,cAAc,CAAC;CAChC;AAED;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,QAAQ;IAC3B,IAAI,GAAG,cAAc,CAAC;CAChC;AAED;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAGb,KAAK;IAFjB,IAAI,GAAG,WAAW,CAAC;IAE5B,YAAqB,KAAY;QAC/B,KAAK,CAAC,qCAAqC,CAAC,CAAC;qBAD1B,KAAK;IAE1B,CAAC;CACF"}

package/dist/avm1/functions.d.ts

@@ -0,0 +1,94 @@
+import { Activation, type Region } from "./activation.js";
+import type { Target } from "./host.js";
+import { Avm1Function, Avm1Object, type Property } from "./objects.js";
+import type { Realm } from "./realm.js";
+import { Scope } from "./scope.js";
+import { type Value } from "./values.js";
+/** A DefineFunction or DefineFunction2's function. */
+export declare class ScriptFunction extends Avm1Function {
+    readonly world: Realm;
+    /** The region of its body. */
+    readonly region: Region;
+    /** Its block's regions, which DefineFunction in its body makes functions of. */
+    readonly code: Region[];
+    /** Its parameters' names, null for those in a register. */
+    readonly params: (string | null)[];
+    /** DefineFunction2's flags, 0 for a DefineFunction. */
+    readonly flags: number;
+    /** The version of the SWF that defined it. */
+    readonly version: number;
+    /** The scope chain it was defined in, which it closes over from SWF 6. */
+    readonly scope: Scope;
+    /** The constant pool of the activation that defined it, as it was then. */
+    readonly pool: Value[];
+    /** The clip whose code defined it, its activation's base clip, its target from SWF 6. */
+    readonly target: Target;
+    readonly clip: Avm1Object;
+    /**
+     * The `this` of the activation that defined it, which is its own where
+     * DefineFunction2 preloads or suppresses `this`; undefined from SWF 5,
+     * whose functions close over nothing (adl; Ruffle takes the caller's).
+     */
+    readonly definer: Value;
+    constructor(proto: Value, world: Realm, 
+    /** The region of its body. */
+    region: Region, 
+    /** Its block's regions, which DefineFunction in its body makes functions of. */
+    code: Region[], 
+    /** Its parameters' names, null for those in a register. */
+    params: (string | null)[], 
+    /** DefineFunction2's flags, 0 for a DefineFunction. */
+    flags: number, 
+    /** The version of the SWF that defined it. */
+    version: number, 
+    /** The scope chain it was defined in, which it closes over from SWF 6. */
+    scope: Scope, 
+    /** The constant pool of the activation that defined it, as it was then. */
+    pool: Value[], 
+    /** The clip whose code defined it, its activation's base clip, its target from SWF 6. */
+    target: Target, clip: Avm1Object, 
+    /**
+     * The `this` of the activation that defined it, which is its own where
+     * DefineFunction2 preloads or suppresses `this`; undefined from SWF 5,
+     * whose functions close over nothing (adl; Ruffle takes the caller's).
+     */
+    definer: Value);
+    /**
+     * Run its body with `self` as `this`, `depth` how far up `this`'s
+     * prototypes it was found (which `super` starts from), in an activation
+     * of its own above the scope it closes over, or from SWF 5 above the
+     * clip of `this` or of the caller's target, as Flash 5 ran functions.
+     */
+    call(self: Value, args: Value[], version: number, depth?: number): Value;
+    /** As a constructor: its result is the object `new` made, whatever the body returns. */
+    initialize(self: Avm1Object, args: Value[], version: number): void;
+    callConstructor(self: Avm1Object, args: Value[], version: number, depth: number): Value;
+}
+/**
+ * `super` in a method: an object whose prototype is the one above where
+ * the method was found, whose methods run with the method's `this`.
+ */
+export declare class Avm1Super extends Avm1Object {
+    /** The `this` of the method that made it. */
+    readonly self: Avm1Object;
+    /** How far up `self`'s prototypes the method was found. */
+    readonly depth: number;
+    constructor(
+    /** The `this` of the method that made it. */
+    self: Avm1Object, 
+    /** How far up `self`'s prototypes the method was found. */
+    depth: number, version: number);
+}
+/**
+ * `super` for an activation, undefined where it has none: a plain call has
+ * none, nor does a SWF 5 (adl).
+ */
+export declare function superOf(cx: Activation, self: Value, version: number): Value;
+/** A function's `arguments`: an array of them, with `callee` and `caller`. */
+export declare function argumentsOf(cx: Activation, args: Value[], version: number): Avm1Object;
+/**
+ * `arguments` or `super` on a function's activation object `o`, as a
+ * lookup first misses it; any other name stays missing.
+ */
+export declare function pendingLocal(cx: Activation, o: Avm1Object, name: string, version: number): Property | undefined;
+//# sourceMappingURL=functions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../src/avm1/functions.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,UAAU,EAAoC,KAAK,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAG5F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAmB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAA6B,KAAK,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAe,KAAK,KAAK,EAAE,MAAM,aAAa,CAAC;AAUtD,sDAAsD;AACtD,qBAAa,cAAe,SAAQ,YAAY;IAG5C,QAAQ,CAAC,KAAK,EAAE,KAAK;IACrB,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,gFAAgF;IAChF,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE;IAClC,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM;IACtB,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,EAAE,KAAK;IACrB,2EAA2E;IAC3E,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE;IACtB,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU;IACzB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,KAAK;IAzBzB,YACE,KAAK,EAAE,KAAK,EACH,KAAK,EAAE,KAAK;IACrB,8BAA8B;IACrB,MAAM,EAAE,MAAM;IACvB,gFAAgF;IACvE,IAAI,EAAE,MAAM,EAAE;IACvB,2DAA2D;IAClD,MAAM,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE;IAClC,uDAAuD;IAC9C,KAAK,EAAE,MAAM;IACtB,8CAA8C;IACrC,OAAO,EAAE,MAAM;IACxB,0EAA0E;IACjE,KAAK,EAAE,KAAK;IACrB,2EAA2E;IAClE,IAAI,EAAE,KAAK,EAAE;IACtB,yFAAyF;IAChF,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU;IACzB;;;;OAIG;IACM,OAAO,EAAE,KAAK,EAGxB;IAED;;;;;OAKG;IACM,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,KAAK,CAmG3E;IAED,wFAAwF;IAC/E,UAAU,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1E;IAEQ,eAAe,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,KAAK,CAE/F;CACF;AAgBD;;;GAGG;AACH,qBAAa,SAAU,SAAQ,UAAU;IAErC,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,UAAU;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM;IAJxB;IACE,6CAA6C;IACpC,IAAI,EAAE,UAAU;IACzB,2DAA2D;IAClD,KAAK,EAAE,MAAM,EACtB,OAAO,EAAE,MAAM,EAGhB;CACF;AAgBD;;;GAGG;AACH,wBAAgB,OAAO,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,CAI3E;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,CAKtF;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,UAAU,EACd,CAAC,EAAE,UAAU,EACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,QAAQ,GAAG,SAAS,CAgBtB"}