@swf2es/runtime 0.0.0-stage → 0.1.0

package/dist/avm1/objects.d.ts

@@ -0,0 +1,245 @@
+import { type DisplayNative } from "./host.js";
+import { type Value } from "./values.js";
+/** Not listed by for..in. */
+export declare const DONT_ENUM = 1;
+/** Not removed by delete. */
+export declare const DONT_DELETE = 2;
+/** Not changed by a set. */
+export declare const READ_ONLY = 4;
+/** The bits from 0x8 up, which hide a property from SWFs before a version (ASSetPropFlags). */
+export declare const VERSION_BITS = 65528;
+export declare const VERSION_6 = 128;
+export declare const VERSION_7 = 1024;
+export declare const VERSION_8 = 4096;
+export declare const VERSION_9 = 8192;
+export declare const VERSION_10 = 16384;
+/** Whether a property of `flags` is there for a SWF of `version`. */
+export declare const allowed: (flags: number, version: number) => boolean;
+/** Whether a SWF of `version` finds names in their case: from 7. */
+export declare const caseSensitive: (version: number) => boolean;
+/**
+ * A name as a SWF up to 6 compares it: each code unit folded to Flash's
+ * lower case (`case.ts`), which is not JavaScript's: `ΑΣ` and `ασ`
+ * are one name, `İ` and `i` too, `ẞ` and `ß` are not.
+ */
+export declare function fold(name: string): string;
+/**
+ * Mark from now on each object a property named `names` is added to, in
+ * any case: so that a host that asks every object of a chain for those
+ * names, as the pointer asks each clip for onPress and the rest, passes
+ * by those never given one.
+ */
+export declare function markNames(names: readonly string[]): void;
+/** A property: a value, or a getter and maybe a setter (addProperty), and its attributes. */
+export declare class Property {
+    /** As it was first set, which for..in lists. */
+    readonly name: string;
+    value: Value;
+    flags: number;
+    get: Avm1Object | null;
+    set: Avm1Object | null;
+    /** How many calls of its getter, setter or watcher are running, for the recursion limit. */
+    calls: number;
+    /** When it was added: for..in lists an object's properties in this order, reversed. */
+    seq: number;
+    constructor(
+    /** As it was first set, which for..in lists. */
+    name: string, value: Value, flags: number);
+}
+/** What `watch` keeps for a name. */
+export interface Watcher {
+    readonly name: string;
+    callback: Avm1Object;
+    data: Value;
+    /** How many of its calls are running, where the name has no property to count them. */
+    calls: number;
+}
+/**
+ * What a function's activation object makes as it is first asked for:
+ * `arguments` and `super`, which most functions never read.
+ */
+export interface LazyLocals {
+    local(o: Avm1Object, name: string, version: number): Property | undefined;
+}
+/** A native function: `self` is an object (a primitive boxed), as Flash gives natives. */
+export type Native = (self: Avm1Object, args: Value[], version: number) => Value;
+/**
+ * A native that takes `this` as it is, a primitive unboxed: String's
+ * methods, which would otherwise box every string they are called on.
+ */
+export type RawNative = (self: Value, args: Value[], version: number) => Value;
+/** Boxing primitives as natives' `this`: the realm's. */
+export interface Boxer {
+    box(value: Value, version: number): Avm1Object;
+}
+/**
+ * `name` as an index of an array's elements: digits with no leading zero
+ * (`0` itself, `12`, not `012` nor `1.0`), -1 for any other name.
+ */
+export declare function elementIndex(name: string): number;
+export declare class Avm1Object {
+    /** By exact name, in the order they were added. */
+    readonly props: Map<string, Property>;
+    /**
+     * By folded name, the first added of each name folding changes, once a
+     * SWF up to 6 needs it; UNCHANGED while there is none.
+     */
+    private folded;
+    /** The property named `__proto__`, if any. */
+    private protoProp;
+    /** By the name each watches, as set. */
+    watchers: Watcher[] | null;
+    /** Whether it is an array, whose `length` follows its elements: what Array's constructor makes. */
+    array: boolean;
+    /**
+     * An array's elements by index while each of 0 to n - 1 is there, none
+     * of them in `props`; null once one is missing, and for any other object.
+     */
+    elems: Property[] | null;
+    /**
+     * The primitive a String, Number or Boolean object boxes, a Date's
+     * DateCell, undefined for any other.
+     */
+    primitive: Value;
+    /** A function's activation object's `arguments` and `super`, until it has made them. */
+    lazy: LazyLocals | null;
+    /** A prototype's interfaces' prototypes, which ImplementsOp gives it, for InstanceOf. */
+    interfaces: Avm1Object[] | null;
+    /** A display object's side, where it is a clip's, a button's or a text field's AVM1 object (host.ts). */
+    display: DisplayNative | null;
+    /** Whether it has ever had a property named as markNames asks, in any case: it may have one still. */
+    marked: boolean;
+    /** An object whose `__proto__` is `proto`, or without one. */
+    constructor(proto?: Value);
+    /** The prototype, `__proto__`'s value. */
+    get proto(): Value;
+    /**
+     * The prototype a SWF of `version` walks to: none where `__proto__` is
+     * hidden from it, as a function's is from SWF 5.
+     */
+    protoFor(version: number): Value;
+    /** The own property of exactly `name`, an element or in `props`. */
+    exact(name: string): Property | undefined;
+    /** The own property `name` names for a SWF of `version`, whatever its attributes. */
+    own(name: string, version: number): Property | undefined;
+    /**
+     * The own property a SWF up to 6 finds for `name`, folded `key`, once
+     * the exact name missed: the one spelt `key`, else the first added
+     * whose name folds to it.
+     */
+    ownFolded(name: string, key: string): Property | undefined;
+    /**
+     * Set `name` to a value with `flags`, as a builtin is defined: in its
+     * case, replacing what it had, a getter included, where it was.
+     */
+    define(name: string, value: Value, flags: number): Property;
+    /** A new property, last in the order: the prototype where `proto`. */
+    add(name: string, value: Value, flags: number, proto?: boolean): Property;
+    remove(p: Property): void;
+    /** Its own properties in the order they were added: its elements among the rest. */
+    ownProperties(): Property[];
+    /**
+     * An own property set as Array's methods set an element they delete
+     * first: its value, no attributes, last in the order.
+     */
+    renew(p: Property, value: Value): void;
+    /** Its elements moved into `props`, as a hole needs: in the order they were added. */
+    sparse(): void;
+    /** The watcher of `name` for a SWF of `version`. */
+    watcher(name: string, version: number): Watcher | undefined;
+    /** What `typeof` says of it. */
+    typeOf(): string;
+    private index;
+}
+/**
+ * A function. Natives are TypeScript; one called with `new` runs
+ * `construct` where it has one, as Flash's native constructors (Object,
+ * Array...) do otherwise than when called. Those DefineFunction makes are
+ * functions.ts's ScriptFunction.
+ */
+export declare class Avm1Function extends Avm1Object {
+    readonly realm: Boxer;
+    readonly native: Native;
+    readonly construct: Native | null;
+    /** Whether `native` takes `this` unboxed, a RawNative. */
+    readonly raw: boolean;
+    constructor(proto: Value, realm: Boxer, native: Native, construct?: Native | null, 
+    /** Whether `native` takes `this` unboxed, a RawNative. */
+    raw?: boolean);
+    typeOf(): string;
+    /**
+     * Call it with `self` as `this`; `depth`, how far up `this`'s prototypes
+     * it was found, is what `super` starts from in a ScriptFunction.
+     */
+    call(self: Value, args: Value[], version: number, _depth?: number): Value;
+    /** Run it on `self`, the object `new` made, where it has no `construct`. */
+    initialize(self: Avm1Object, args: Value[], version: number): void;
+    /** Run it as a constructor of `self`, made already, as `super()` runs its class's. */
+    callConstructor(self: Avm1Object, args: Value[], version: number, _depth: number): Value;
+}
+/** Call `fn` if it is a function; anything else gives undefined, as Flash does. */
+export declare function invoke(fn: Value, self: Value, args: Value[], version: number, depth?: number): Value;
+/** How far up its object's prototypes `get` found what it gave last, a getter's value too: 0 its own. */
+export declare let foundDepth: number;
+/**
+ * The first own property `name` names on `o` or its prototypes, whatever
+ * its attributes: whether the name is there, as the scope chain asks.
+ */
+export declare function find(o: Avm1Object, name: string, version: number): Property | undefined;
+/**
+ * `o[name]`: the first property its version sees on `o` or its
+ * prototypes, its getter called with `self` as `this`, or what a
+ * `__resolve` on the chain gives for the name.
+ */
+export declare function get(o: Avm1Object, name: string, version: number, self?: Value, resolving?: boolean): Value;
+/**
+ * What the watcher of `name` on `o` gives for a set of `value` over `old`,
+ * `value` where it has none, or where as many of its calls run as may.
+ */
+export declare function watched(o: Avm1Object, name: string, old: Value, value: Value, version: number): Value;
+/**
+ * `o[name] = value`: the watcher of the name on `o` first, which gives the
+ * value set; then an own property's setter, or the first getter's setter
+ * on the prototypes, or the value stored on `o`, unless read-only.
+ */
+export declare function set(o: Avm1Object, name: string, value: Value, version: number): void;
+/**
+ * An array's `length` as a set changes it: elements past a shorter one go,
+ * an index past it grows it. Under a watcher, adl sets `length` twice, as
+ * the array and then as the set: the watcher is told of both, the first
+ * one's value is the length cut to and kept, the second's what is stored.
+ */
+export declare function arraySet(a: Avm1Object, name: string, value: Value, version: number): void;
+/**
+ * An array's `length` grown to `length` by an element set past it, its
+ * watcher told, though what it gives is not kept (adl); past 2^31 - 1 the
+ * int wraps, shorter, and deletes.
+ */
+export declare function growTo(a: Avm1Object, length: number, version: number): void;
+/**
+ * The elements of `a` from `length` to `old` deleted, as a shorter
+ * `length` deletes them; those that cannot be deleted stay.
+ */
+export declare function truncate(a: Avm1Object, length: number, old: number): void;
+/** An array's own `length`, as an int, converted as a SWF of `version` converts it. */
+export declare function lengthOf(o: Avm1Object, version?: number): number;
+/** `delete o[name]`: whether an own property went, which DontDelete keeps. */
+export declare function removeOwn(o: Avm1Object, name: string, version: number): boolean;
+/**
+ * The names for..in visits on `o`, in Flash's order: its prototypes' first,
+ * the deepest's first, but those `o` lists itself, then its own, the last
+ * added first; DontEnum ones left out. An own DontEnum property does not
+ * hide a prototype's of the same name (adl).
+ */
+export declare function keys(o: Avm1Object, version: number, out?: string[], depth?: number): string[];
+/** Whether `name` is on `o` or its prototypes, whatever its attributes. */
+export declare function has(o: Avm1Object, name: string, version: number): boolean;
+/**
+ * The value of `p`, which `find` found for `name` on `o`, as the scope
+ * chain reads it: a plain one's own, else as `get` gives it. The reused
+ * display property lets go of its value, a clip's AVM1 object perhaps.
+ */
+export declare function foundValue(p: Property, o: Avm1Object, name: string, version: number): Value;
+/** `name` as a property's name: the string a value converts to. */
+export declare const nameOf: (value: Value, version: number) => string;
+//# sourceMappingURL=objects.d.ts.map

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

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