@swf2es/player 0.0.0-stage → 0.1.0

package/dist/hosts.d.ts

@@ -0,0 +1,406 @@
+import type { avm2 } from "@swf2es/runtime";
+import type { BitmapStore } from "./bitmap/bitmap.js";
+import type { DisplayObject } from "./display/display.js";
+import type { FromWorker, ToWorker, WorkerInit } from "./workers/protocol.js";
+type Value = avm2.Value;
+/**
+ * Opens the page a request asks for in the browser window or frame named,
+ * "_self", "_blank", "_parent", "_top" or a name of the page's; null asks
+ * for a new window, as Flash's does when no window is given.
+ */
+export type Navigate = (request: FetchRequest, window: string | null) => void;
+/**
+ * The browser's navigation, deliberately conservative, as a SWF is not to
+ * be trusted by the page that embeds it: only an http: or https: URL opens,
+ * so a javascript: one cannot run in the embedding page; a target that
+ * would replace the page or a frame around it is refused, as Ruffle's web
+ * navigator refuses it without script access; and every other target opens
+ * a new window, since a name reaches the window or frame of that name,
+ * noopener or not, so a SWF cannot reuse a window it named. A GET opens in
+ * window.open without an opener; a POST is a form submitted to a new
+ * window, the only way a browser posts into one, its body read as form
+ * data. A host that trusts its SWFs further gives a navigate of its own.
+ * Null where there is no window to open, as in node.
+ */
+export declare function browserNavigate(): Navigate | null;
+/**
+ * Where the host keeps shared objects' bytes, by key: the browser's
+ * localStorage by default, else memory.
+ */
+export interface SharedObjectStorage {
+    get(key: string): Uint8Array | null;
+    set(key: string, bytes: Uint8Array): void;
+    remove(key: string): void;
+}
+/**
+ * The default storage: localStorage, base64 under a prefix, where the host
+ * has it and lets it be read; memory otherwise. localStorage is first reached
+ * when a SWF first uses a shared object, since merely reading it can throw
+ * (a SecurityError where site data is blocked). A write it refuses, a full
+ * quota say, throws, which flush reports as Error #2130.
+ */
+export declare function defaultStorage(): SharedObjectStorage;
+/** What Capabilities reports of the system the player runs on. */
+export interface PlatformCapabilities {
+    /** "Windows 10", "Mac OS 10.15.7", "Linux"... */
+    os: string;
+    /** "Adobe Windows", "Adobe Macintosh" or "Adobe Linux". */
+    manufacturer: string;
+    /** The platform and the player's version: "WIN 32,0,0,465". */
+    version: string;
+    /** A language code: "en", or with its country for Chinese and Portuguese ("zh-CN"). */
+    language: string;
+    /** The user's locale, as a BCP 47 tag: flash.globalization's default. */
+    locale: string;
+    /** "PlugIn", "ActiveX", "StandAlone", "External" or "Desktop". */
+    playerType: string;
+}
+/** The platform as the host's browser reports it, a Linux plugin's where it has none. */
+export declare function platformCapabilities(): PlatformCapabilities;
+/** How many touches the browser's screen takes at once, as Multitouch.maxTouchPoints reports; 0 without a browser. */
+export declare function hostTouchPoints(): number;
+/** The host side of playerglobal's synchronous ExternalInterface protocol. */
+export interface ExternalInterfaceHost {
+    /**
+     * JavaScript source from playerglobal; the host decides whether to
+     * evaluate it, null declining. A host without it evaluates none, and
+     * AVM1's calls then go as XML without being written as JavaScript.
+     */
+    evalJS?(source: string): string | null;
+    /** An XML invocation when evalJS declined the call. */
+    callOut(request: string): string | null;
+    /**
+     * The SWF's callback `name`, playerglobal's wrapper of its closure, or
+     * null as it is removed. Called with `args`, AVM2 values, the closure
+     * gets them as they are and the result is JavaScript source (_toJS);
+     * with null, `request` is an XML invocation, as Flash's plug-in sends
+     * one, whose arguments playerglobal converts, and the result is XML
+     * (_toXML) for a `returntype="xml"` request: a host needs no eval.
+     */
+    addCallback(name: string, callback: ((request: string, args: Value[] | null) => Value) | null): void;
+    objectID?: string | null;
+    /**
+     * Whether the SWF at `url`, whose code is calling, may use the bridge, as
+     * Flash checked allowScriptAccess against the calling SWF's domain, not
+     * the main one's; one it refuses finds ExternalInterface unavailable.
+     * Where the caller cannot be told, as from a timer, it is asked for every
+     * loaded SWF, and all must be allowed. Every SWF may where this is left out.
+     */
+    allows?(url: string): boolean;
+}
+/** Screen values reported by flash.system.Capabilities, captured when the player starts. */
+export interface ScreenCapabilities {
+    screenResolutionX: number;
+    screenResolutionY: number;
+    pixelAspectRatio: number;
+    screenDPI: number;
+}
+type Affine = {
+    a: number;
+    b: number;
+    c: number;
+    d: number;
+    tx: number;
+    ty: number;
+};
+/** A renderer's part in BitmapData.draw of a display object. */
+export interface Drawer {
+    /** `o` through `m` into a w x h texture at `samples` a side, read back as premultiplied ARGB. */
+    snapshot(o: DisplayObject, m: Affine, width: number, height: number, samples: number): Uint32Array;
+    /**
+     * `o` the same, composited source over into `store` at (x, y) on the GPU,
+     * left there until read; false, having done nothing, where it cannot.
+     */
+    drawInto(store: BitmapStore, o: DisplayObject, m: Affine, x: number, y: number, width: number, height: number, samples: number): boolean;
+}
+/** A host request's bytes and transport result; a local file reports status 0. */
+export interface FetchResult {
+    bytes: Uint8Array | null;
+    status: number;
+    headers: readonly (readonly [name: string, value: string])[];
+    /** Set for `file:` URLs: Flash reports status 0 and leaves the URL out of #2032. */
+    local?: boolean;
+    /** The URL the bytes came from, after any redirect, where it differs from the one asked for. */
+    url?: string;
+}
+/**
+ * What a request is for, as Flash's security model tells them apart: a
+ * Loader's or a Sound's "content", which Flash let a SWF load from any
+ * domain to display or play; a URLLoader's or URLStream's "data", which it
+ * let a SWF read from another domain only as that domain's policy file
+ * allowed; sendToURL's "send", whose response no one reads; and "movie",
+ * the SWF an embedding plays, which the player never asks for itself.
+ */
+export type FetchPurpose = "movie" | "content" | "data" | "send";
+/** The request the player asks its host to send. */
+export interface FetchRequest {
+    url: string;
+    method: string;
+    headers: readonly (readonly [name: string, value: string])[];
+    body: Uint8Array | null;
+    /** What it is for, for a host that judges requests as Flash did; a browser's fetch ignores it. */
+    purpose?: FetchPurpose;
+}
+/** A TCP connection supplied by the embedding host. */
+export interface SocketTransport {
+    send(bytes: Uint8Array): void;
+    close(): void;
+}
+/** A connection's ends, as Socket's localAddress, localPort, remoteAddress and remotePort read them. */
+export interface SocketEndpoints {
+    localAddress: string;
+    localPort: number;
+    remoteAddress: string;
+    remotePort: number;
+}
+/** Transport notifications; the player delivers them to ActionScript on a frame. */
+export interface SocketEvents {
+    /** Opened, with its ends where the host knows them: a relay's are not the script's to see. */
+    open(endpoints?: SocketEndpoints): void;
+    data(bytes: Uint8Array): void;
+    close(): void;
+    error(message: string): void;
+}
+export interface SocketHost {
+    connect(host: string, port: number, events: SocketEvents): SocketTransport;
+}
+/** A window's place and size on the screen, in pixels, its frame included. */
+export interface WindowBounds {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/**
+ * An AIR application's window, which Stage.nativeWindow reads and moves:
+ * its bounds take the frame in, as AIR's do. What it has no setter for
+ * stays as it is, as a window manager may refuse a size or a state.
+ */
+export interface AirWindow {
+    bounds(): WindowBounds;
+    setBounds?(bounds: WindowBounds): void;
+    title(): string;
+    setTitle?(title: string): void;
+    /** NativeWindowDisplayState's: "normal", "maximized" or "minimized". */
+    displayState(): string;
+    minimize?(): void;
+    maximize?(): void;
+    restore?(): void;
+    /** Whether it has the focus, as NativeWindow.active. */
+    active(): boolean;
+    activate?(): void;
+    visible(): boolean;
+    setVisible?(visible: boolean): void;
+    close?(): void;
+    /** Where the stage's corner is on the screen, the frame's border and title bar from the window's. */
+    stageOffset(): {
+        x: number;
+        y: number;
+    };
+}
+/**
+ * What an AIR application's host gives NativeApplication: the descriptor
+ * it was launched from, the launch's arguments, which its InvokeEvent
+ * carries, and its one window.
+ */
+export interface AirApplication {
+    /** The application descriptor's XML, as applicationDescriptor gives it, and its id. */
+    descriptor: string;
+    id: string;
+    /** What followed the descriptor on the command line, as adl's `--` passes it. */
+    arguments: readonly string[];
+    /** The directory it was launched from, a native path: InvokeEvent's currentDirectory. */
+    currentDirectory?: string | null;
+    window?: AirWindow | null;
+    /** NativeApplication.exit's code; a host without it stops nothing. */
+    exit?(code: number): void;
+}
+/** What is at a path on the host's file system, as flash.filesystem.File reads it. */
+export interface FileStat {
+    directory: boolean;
+    /** In bytes; 0 for a directory. */
+    size: number;
+    /** When it was last changed and when it was made, in ms since 1970. */
+    modified: number;
+    created: number;
+    hidden?: boolean;
+    symbolicLink?: boolean;
+}
+/**
+ * The host's file system, as an AIR application's flash.filesystem.File
+ * sees it: synchronous, as File's properties are, its paths native and
+ * absolute. The directories are those AIR names, its application's (where
+ * its descriptor is) and the application's storage among them.
+ */
+export interface FileSystemHost {
+    /** The system's separator: "/", or "\\" on Windows. */
+    readonly separator: string;
+    readonly directories: {
+        application: string;
+        applicationStorage: string;
+        user: string;
+        documents: string;
+        desktop: string;
+        cache?: string;
+    };
+    /** What is at `path`, or null where nothing is. */
+    stat(path: string): FileStat | null;
+    /** The names in the directory at `path`, or null where it is none. */
+    list(path: string): string[] | null;
+    /**
+     * The bytes of the file at `path`, read at once, as FileStream's open
+     * reads it; null where none can be read. Without it, FileStream finds
+     * nothing to read.
+     */
+    read?(path: string): Uint8Array | null;
+    /**
+     * Writes `bytes` into the file at `path` from `offset`, then makes the
+     * file `length` bytes long, cut short or filled with zeros: FileStream's
+     * writes as they reach the file. A file not there is made, and the
+     * directories it is in. False where it cannot be written. Without it,
+     * the file system is read-only, and what writes fails as on a disk that
+     * refuses it (IOError 3001).
+     */
+    write?(path: string, bytes: Uint8Array, offset: number, length: number): boolean;
+    /** Makes the directory at `path`, and those it is in; false where it cannot. */
+    createDirectory?(path: string): boolean;
+    /** Removes the file or the directory at `path`, with all in it; false where it cannot. */
+    remove?(path: string): boolean;
+    /**
+     * Moves what is at `from` to `to`, where nothing is, making the
+     * directories `to` is in; false where it cannot. Without it, File's
+     * moveTo copies and removes.
+     */
+    move?(from: string, to: string): boolean;
+}
+/**
+ * An AIR application's EncryptedLocalStore, as the host keeps it: its
+ * items' bytes by name, for the next time it runs, encrypted where the
+ * host can. Synchronous, as the class's methods are.
+ */
+export interface EncryptedStoreHost {
+    /** The bytes kept as `name`; null for none. */
+    getItem(name: string): Uint8Array | null;
+    setItem(name: string, bytes: Uint8Array): void;
+    removeItem(name: string): void;
+    /** Every item gone. */
+    reset(): void;
+}
+/** An EncryptedLocalStore of an application's items held in memory, for as long as it plays. */
+export declare function memoryStore(): EncryptedStoreHost;
+/** A WebSocket client connection opened by the host for air.net.WebSocket. */
+export interface WebSocketTransport {
+    /** A text message as a string, a binary one as bytes. */
+    send(data: string | Uint8Array): void;
+    /** A close frame with `code`, 1000 or 3000 to 4999, or with none. */
+    close(code?: number): void;
+}
+/** What befalls the connection; the player delivers each to ActionScript on a frame. */
+export interface WebSocketEvents {
+    /** The handshake is done; the subprotocol the server chose, or "". */
+    open(protocol: string): void;
+    message(data: string | Uint8Array): void;
+    /** The connection has closed: the close frame's code, 1005 for a frame without one, 1006 for none. */
+    close(code: number): void;
+    /** The connection or its handshake failed; after open, a close follows. */
+    error(): void;
+}
+export interface WebSocketHost {
+    /** Opens `url`, offering `protocols`; may throw as the WebSocket constructor does. */
+    connect(url: string, protocols: string[], events: WebSocketEvents): WebSocketTransport;
+}
+/** The global WebSocket's client, a browser's or node's; null where there is none. */
+export declare function globalWebSocketHost(): WebSocketHost | null;
+/**
+ * A module as a ModuleCache keeps it: its source, what compiling it fixed
+ * in the compiler's domain (Codegen.compileModuleLogged), which the player
+ * replays in place of compiling it, and the two's lengths, which it checks.
+ */
+export interface CachedModule {
+    module: string;
+    log: string;
+    lengths: [module: number, log: number];
+    /**
+     * An absolute URL to import the module from, as an ES module, in place
+     * of evaluating `module`, which is then not read: for a page whose
+     * Content-Security-Policy refuses 'unsafe-eval'. A document keeps what
+     * it imports for as long as it lives.
+     */
+    url?: string;
+}
+/**
+ * Where a host keeps the modules the compiler wrote, across page loads, so
+ * that a SWF loaded again is not compiled again (see Code). Keys name the
+ * compiler by the identity its codegen.wasm was stamped with, and a
+ * compiler without one uses no cache. Each call may fail or answer
+ * nothing; the player then compiles, as without one.
+ */
+export interface ModuleCache {
+    /**
+     * The smallest ABC, in bytes, whose module the player asks this cache
+     * for; 8 KB by default, below which a key, a read and a replay cost
+     * about what a compile does. A cache that holds modules compiled ahead
+     * of time asks for every one, so that none is compiled.
+     */
+    readonly minBytes?: number;
+    /** The module stored under `key`, if any. */
+    get(key: string): Promise<CachedModule | undefined>;
+    /** Store `entry` under `key`; a store that is full may evict others, or refuse it. */
+    put(key: string, entry: CachedModule): Promise<void>;
+    /**
+     * Let go of what is stored under `key`, as a module that loaded part of
+     * itself and failed; `entry`, where given, is the one this cache's get
+     * answered that the player could not use, as a chain of caches needs to
+     * tell which of its members gave it.
+     */
+    delete(key: string, entry?: CachedModule): Promise<void>;
+}
+/** What goes to or comes from the system's clipboard: text, and HTML where there is some. */
+export interface ClipboardText {
+    text: string;
+    html?: string;
+}
+/**
+ * The system's clipboard, written outside a copy event: what a script
+ * puts there with System.setClipboard or Clipboard.setData in a mouse or
+ * key handler. A copy or cut event the host binds (bindKeyboard) carries
+ * its own data, and a paste brings the clipboard's with it, so nothing
+ * here reads, as Flash read only in a paste.
+ */
+export interface ClipboardHost {
+    /** Puts `data` on the clipboard; may fail quietly, as a browser refuses it without a user's gesture. */
+    write(data: ClipboardText): void;
+}
+/**
+ * The browser's async Clipboard API, which writes during a user's gesture
+ * without asking; HTML only where ClipboardItem takes it, else the text
+ * alone. Null where there is none, as in node.
+ */
+export declare function browserClipboard(): ClipboardHost | null;
+/** A thread a background flash.system.Worker runs on, as a WorkerHost started it. */
+export interface WorkerThread {
+    post(message: ToWorker): void;
+    /**
+     * Stops it, wherever its scripts are; what it gives resolves once the
+     * thread has stopped, when the Mutexes its worker held are let go.
+     */
+    terminate(): Promise<unknown> | undefined;
+}
+/**
+ * Starts the threads background Workers run on (docs/workers.md): a
+ * Web Worker or a node worker_threads Worker running `@swf2es/player/worker`'s
+ * runWorkerThread, which the host gives codegen's compiled module along with
+ * `init` (@swf2es/player-hosts' webWorkerHost and nodeWorkerHost). Without
+ * one, Worker.isSupported is false and no worker starts.
+ */
+export interface WorkerHost {
+    /**
+     * Starts a thread for `init`: what it posts goes to `receive`, and an
+     * error that ends it to `failed`, from which nothing more comes.
+     */
+    start(init: WorkerInit, receive: (message: FromWorker) => void, failed: (error: unknown) => void): WorkerThread;
+    /** The player that used it is gone: what the host keeps for its threads may go too. */
+    release?(): void;
+}
+export {};
+//# sourceMappingURL=hosts.d.ts.map

package/dist/hosts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hosts.d.ts","sourceRoot":"","sources":["../src/hosts.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAE9E,KAAK,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAC;AAK9E;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,IAAI,QAAQ,GAAG,IAAI,CAgDjD;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACpC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAC1C,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,mBAAmB,CAiCpD;AAuBD,kEAAkE;AAClE,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,EAAE,EAAE,MAAM,CAAC;IACX,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,uFAAuF;IACvF,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,yFAAyF;AACzF,wBAAgB,oBAAoB,IAAI,oBAAoB,CAsB3D;AAED,sHAAsH;AACtH,wBAAgB,eAAe,IAAI,MAAM,CAGxC;AAED,8EAA8E;AAC9E,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;IACH,MAAM,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACvC,uDAAuD;IACvD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACxC;;;;;;;OAOG;IACH,WAAW,CACT,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,KAAK,KAAK,CAAC,GAAG,IAAI,GAClE,IAAI,CAAC;IACR,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;;;OAMG;IACH,MAAM,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED,4FAA4F;AAC5F,MAAM,WAAW,kBAAkB;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,KAAK,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,gEAAgE;AAChE,MAAM,WAAW,MAAM;IACrB,iGAAiG;IACjG,QAAQ,CACN,CAAC,EAAE,aAAa,EAChB,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,WAAW,CAAC;IACf;;;OAGG;IACH,QAAQ,CACN,KAAK,EAAE,WAAW,EAClB,CAAC,EAAE,aAAa,EAChB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;CACZ;AAED,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IAC7D,oFAAoF;IACpF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gGAAgG;IAChG,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjE,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IAC7D,IAAI,EAAE,UAAU,GAAG,IAAI,CAAC;IACxB,kGAAkG;IAClG,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wGAAwG;AACxG,MAAM,WAAW,eAAe;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,oFAAoF;AACpF,MAAM,WAAW,YAAY;IAC3B,8FAA8F;IAC9F,IAAI,CAAC,SAAS,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,eAAe,CAAC;CAC5E;AAED,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,IAAI,YAAY,CAAC;IACvB,SAAS,CAAC,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IACvC,KAAK,IAAI,MAAM,CAAC;IAChB,QAAQ,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,wEAAwE;IACxE,YAAY,IAAI,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,IAAI,CAAC;IAClB,QAAQ,CAAC,IAAI,IAAI,CAAC;IAClB,OAAO,CAAC,IAAI,IAAI,CAAC;IACjB,wDAAwD;IACxD,MAAM,IAAI,OAAO,CAAC;IAClB,QAAQ,CAAC,IAAI,IAAI,CAAC;IAClB,OAAO,IAAI,OAAO,CAAC;IACnB,UAAU,CAAC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;IACpC,KAAK,CAAC,IAAI,IAAI,CAAC;IACf,qGAAqG;IACrG,WAAW,IAAI;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACzC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,uFAAuF;IACvF,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,iFAAiF;IACjF,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,yFAAyF;IACzF,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,MAAM,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC1B,sEAAsE;IACtE,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,sFAAsF;AACtF,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,mDAAmD;IACnD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAAC;IACpC,sEAAsE;IACtE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;IACpC;;;;OAIG;IACH,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACvC;;;;;;;OAOG;IACH,KAAK,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IACjF,gFAAgF;IAChF,eAAe,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IACxC,0FAA0F;IAC1F,MAAM,CAAC,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B;;;;OAIG;IACH,IAAI,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1C;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACzC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,uBAAuB;IACvB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,gGAAgG;AAChG,wBAAgB,WAAW,IAAI,kBAAkB,CAYhD;AAED,8EAA8E;AAC9E,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACtC,qEAAqE;IACrE,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,wFAAwF;AACxF,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IACzC,sGAAsG;IACtG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,2EAA2E;IAC3E,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,sFAAsF;IACtF,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,eAAe,GAAG,kBAAkB,CAAC;CACxF;AAED,sFAAsF;AACtF,wBAAgB,mBAAmB,IAAI,aAAa,GAAG,IAAI,CAwB1D;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IACvC;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,6CAA6C;IAC7C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IACpD,sFAAsF;IACtF,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrD;;;;;OAKG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1D;AAED,6FAA6F;AAC7F,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,wGAAwG;IACxG,KAAK,CAAC,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;CAClC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAqBvD;AAED,qFAAqF;AACrF,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC9B;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,KAAK,CACH,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,EACtC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAC/B,YAAY,CAAC;IAChB,uFAAuF;IACvF,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB"}

package/dist/hosts.js

@@ -0,0 +1,208 @@
+/** Targets that would replace the player's own page or a frame around it. */
+const IN_PLACE = new Set(["_self", "_parent", "_top", ""]);
+/**
+ * The browser's navigation, deliberately conservative, as a SWF is not to
+ * be trusted by the page that embeds it: only an http: or https: URL opens,
+ * so a javascript: one cannot run in the embedding page; a target that
+ * would replace the page or a frame around it is refused, as Ruffle's web
+ * navigator refuses it without script access; and every other target opens
+ * a new window, since a name reaches the window or frame of that name,
+ * noopener or not, so a SWF cannot reuse a window it named. A GET opens in
+ * window.open without an opener; a POST is a form submitted to a new
+ * window, the only way a browser posts into one, its body read as form
+ * data. A host that trusts its SWFs further gives a navigate of its own.
+ * Null where there is no window to open, as in node.
+ */
+export function browserNavigate() {
+    if (typeof globalThis.open !== "function" || typeof document === "undefined") {
+        return null;
+    }
+    return (request, window) => {
+        if (window !== null && IN_PLACE.has(window.toLowerCase())) {
+            return;
+        }
+        let url;
+        try {
+            url = new URL(request.url, globalThis.location?.href);
+        }
+        catch {
+            return;
+        }
+        if (url.protocol !== "http:" && url.protocol !== "https:") {
+            return;
+        }
+        if (request.method.toUpperCase() !== "POST" || !request.body) {
+            globalThis.open(url.href, "_blank", "noopener");
+            return;
+        }
+        if (!document.body) {
+            return;
+        }
+        const form = document.createElement("form");
+        form.method = "POST";
+        form.action = url.href;
+        form.target = "_blank";
+        form.rel = "noopener";
+        form.style.display = "none";
+        for (const [name, value] of new URLSearchParams(new TextDecoder().decode(request.body))) {
+            const input = document.createElement("input");
+            input.type = "hidden";
+            input.name = name;
+            input.value = value;
+            form.append(input);
+        }
+        document.body.append(form);
+        form.submit();
+        form.remove();
+    };
+}
+/**
+ * The default storage: localStorage, base64 under a prefix, where the host
+ * has it and lets it be read; memory otherwise. localStorage is first reached
+ * when a SWF first uses a shared object, since merely reading it can throw
+ * (a SecurityError where site data is blocked). A write it refuses, a full
+ * quota say, throws, which flush reports as Error #2130.
+ */
+export function defaultStorage() {
+    const memory = new Map();
+    const inMemory = {
+        get: (key) => memory.get(key) ?? null,
+        set: (key, bytes) => {
+            memory.set(key, bytes.slice());
+        },
+        remove: (key) => {
+            memory.delete(key);
+        },
+    };
+    let chosen;
+    const storage = () => {
+        if (!chosen) {
+            let local;
+            try {
+                local = globalThis.localStorage;
+                local?.getItem(PREFIX);
+            }
+            catch {
+                local = undefined;
+            }
+            chosen = local ? localStorageOf(local) : inMemory;
+        }
+        return chosen;
+    };
+    return {
+        get: (key) => storage().get(key),
+        set: (key, bytes) => storage().set(key, bytes),
+        remove: (key) => storage().remove(key),
+    };
+}
+const PREFIX = "swf2es:so:";
+function localStorageOf(local) {
+    return {
+        get: (key) => {
+            const text = local.getItem(PREFIX + key);
+            return text === null ? null : Uint8Array.from(atob(text), (c) => c.charCodeAt(0));
+        },
+        set: (key, bytes) => {
+            // In chunks: one String.fromCharCode of every byte overflows the stack.
+            const parts = [];
+            for (let i = 0; i < bytes.length; i += 0x2000) {
+                parts.push(String.fromCharCode(...bytes.subarray(i, i + 0x2000)));
+            }
+            local.setItem(PREFIX + key, btoa(parts.join("")));
+        },
+        remove: (key) => local.removeItem(PREFIX + key),
+    };
+}
+/** The platform as the host's browser reports it, a Linux plugin's where it has none. */
+export function platformCapabilities() {
+    const navigator = globalThis
+        .navigator;
+    const agent = navigator?.userAgent ?? "";
+    const mac = /Mac OS X (\d+)[._](\d+)(?:[._](\d+))?/.exec(agent);
+    const [os, manufacturer, platform] = /Windows/.test(agent)
+        ? ["Windows 10", "Adobe Windows", "WIN"]
+        : mac
+            ? [`Mac OS ${mac[1]}.${mac[2]}${mac[3] ? `.${mac[3]}` : ""}`, "Adobe Macintosh", "MAC"]
+            : ["Linux", "Adobe Linux", "LNX"];
+    // Flash gives the country only where the language needs it.
+    const tag = navigator?.language ?? new Intl.DateTimeFormat().resolvedOptions().locale;
+    const [lang, country] = tag.split("-");
+    const language = (lang === "zh" || lang === "pt") && country ? `${lang}-${country}` : lang;
+    return {
+        os,
+        manufacturer,
+        version: `${platform} 32,0,0,465`,
+        language,
+        locale: tag,
+        playerType: "PlugIn",
+    };
+}
+/** How many touches the browser's screen takes at once, as Multitouch.maxTouchPoints reports; 0 without a browser. */
+export function hostTouchPoints() {
+    const navigator = globalThis.navigator;
+    return navigator?.maxTouchPoints ?? 0;
+}
+/** An EncryptedLocalStore of an application's items held in memory, for as long as it plays. */
+export function memoryStore() {
+    const items = new Map();
+    return {
+        getItem: (name) => items.get(name) ?? null,
+        setItem: (name, bytes) => {
+            items.set(name, bytes);
+        },
+        removeItem: (name) => {
+            items.delete(name);
+        },
+        reset: () => items.clear(),
+    };
+}
+/** The global WebSocket's client, a browser's or node's; null where there is none. */
+export function globalWebSocketHost() {
+    const Client = globalThis.WebSocket;
+    if (typeof Client !== "function") {
+        return null;
+    }
+    return {
+        connect(url, protocols, events) {
+            const socket = new Client(url, protocols);
+            socket.binaryType = "arraybuffer";
+            socket.addEventListener("open", () => events.open(socket.protocol));
+            socket.addEventListener("message", ({ data }) => {
+                events.message(typeof data === "string" ? data : new Uint8Array(data));
+            });
+            socket.addEventListener("close", ({ code }) => events.close(code));
+            socket.addEventListener("error", () => events.error());
+            return {
+                // The natives send bytes of their own, never a view of a shared buffer.
+                send: (data) => socket.send(data),
+                close: (code) => socket.close(code),
+            };
+        },
+    };
+}
+/**
+ * The browser's async Clipboard API, which writes during a user's gesture
+ * without asking; HTML only where ClipboardItem takes it, else the text
+ * alone. Null where there is none, as in node.
+ */
+export function browserClipboard() {
+    const clipboard = globalThis.navigator?.clipboard;
+    if (!clipboard || typeof clipboard.writeText !== "function") {
+        return null;
+    }
+    const Item = globalThis.ClipboardItem;
+    return {
+        write: ({ text, html }) => {
+            const written = html !== undefined && Item && typeof clipboard.write === "function"
+                ? clipboard.write([
+                    new Item({
+                        "text/plain": new Blob([text], { type: "text/plain" }),
+                        "text/html": new Blob([html], { type: "text/html" }),
+                    }),
+                ])
+                : clipboard.writeText(text);
+            written.catch(() => { });
+        },
+    };
+}
+//# sourceMappingURL=hosts.js.map

package/dist/hosts.js.map

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

package/dist/images.d.ts

@@ -0,0 +1,22 @@
+import { type Library } from "./timeline.js";
+/** A decoded image: straight (not premultiplied) RGBA, row by row. */
+export interface DecodedImage {
+    width: number;
+    height: number;
+    rgba: Uint8Array;
+}
+/** Decodes a JPEG, PNG or GIF; null for one it cannot. */
+export type ImageDecode = (data: Uint8Array, format: "jpeg" | "png" | "gif") => Promise<DecodedImage | null>;
+/**
+ * The browser's decoder. A PNG's or GIF's frame comes from WebCodecs'
+ * ImageDecoder as it is, straight alpha (asking `copyTo` for RGBA goes
+ * through premultiplied values and loses low alphas' colours); a JPEG,
+ * opaque, and anything ImageDecoder will not take, through
+ * createImageBitmap and a canvas.
+ */
+export declare function decodeInBrowser(data: Uint8Array, format: "jpeg" | "png" | "gif"): Promise<DecodedImage | null>;
+/** Whether `library` has an image decodeImages has still to decode. */
+export declare function hasUndecoded(library: Library): boolean;
+/** Decode every image of `library` not yet decoded, all at once. */
+export declare function decodeImages(library: Library, decode: ImageDecode | null): Promise<void>;
+//# sourceMappingURL=images.d.ts.map

package/dist/images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"images.d.ts","sourceRoot":"","sources":["../src/images.ts"],"names":[],"mappings":"AAIA,OAAO,EAIL,KAAK,OAAO,EACb,MAAM,eAAe,CAAC;AAEvB,sEAAsE;AACtE,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,UAAU,CAAC;CAClB;AAED,0DAA0D;AAC1D,MAAM,MAAM,WAAW,GAAG,CACxB,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,KAC3B,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;AAElC;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,UAAU,EAChB,MAAM,EAAE,MAAM,GAAG,KAAK,GAAG,KAAK,GAC7B,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAgC9B;AAuCD,uEAAuE;AACvE,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAQtD;AAED,oEAAoE;AACpE,wBAAsB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9F"}