@swf2es/player-hosts 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,44 @@
-# Temporary Holding Version
+# @swf2es/player-hosts
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Optional hosts for the [swf2es](https://github.com/swf2es/swf2es) player,
+each a subpath of its own, so that a page loads only what it uses.
+[`@swf2es/web`](https://www.npmjs.com/package/@swf2es/web) uses those it
+needs itself; this package is for a host built on `@swf2es/player`.
+
+```sh
+npm install @swf2es/player-hosts
+```
+
+- `@swf2es/player-hosts/indexeddb`: `indexedDbModuleCache()`, the compiled
+  modules kept in IndexedDB for a page's next visit.
+- `@swf2es/player-hosts/precompiled`: `precompiledModules()` reads what the
+  `swf2es` command compiled ahead of time; `chainCaches()` puts a cache
+  behind it.
+- `@swf2es/player-hosts/websocket`: `webSocketSocketHost()`, flash.net.Socket
+  over a WebSocket relay.
+- `@swf2es/player-hosts/node`: `nodeSocketHost()`, flash.net.Socket over
+  node's TCP, and `nodeWorkerHost()`, flash.system.Worker on worker threads.
+- `@swf2es/player-hosts/workers`: `webWorkerHost()`, flash.system.Worker
+  on Web Workers, which run `@swf2es/player-hosts/web-worker`
+  (`node-worker` is node's).
+- `@swf2es/player-hosts/stage3d`: `stage3DCanvasHost()`, Stage3D's canvas
+  layers in a page (experimental).
+
+```js
+import { indexedDbModuleCache } from "@swf2es/player-hosts/indexeddb";
+import { chainCaches, precompiledModules } from "@swf2es/player-hosts/precompiled";
+
+const moduleCache = chainCaches(
+  precompiledModules("/movie.swf2es/manifest.json"),
+  indexedDbModuleCache(),
+);
+// new Scripting(codegen, { moduleCache, ... })
+```
+
+`dist/thread/` holds copies of the modules a Web Worker loads, which
+resolve without the page's import map.
+
+The [guide](https://swf2es.github.io/swf2es/docs/) has more.
+
+Apache-2.0 ([LICENSE](LICENSE)); the code from elsewhere in its copies of
+the other packages, and its terms, in [LICENSE.third-party](LICENSE.third-party).

package/dist/indexeddb.d.ts

@@ -0,0 +1,27 @@
+import type { ModuleCache } from "@swf2es/player";
+export interface IndexedDbModuleCacheOptions {
+    /** The database's name. */
+    name?: string;
+    /** About how many bytes the modules may take, as UTF-16; the least recently used go first. */
+    maxBytes?: number;
+    /** The IndexedDB to use: the global one by default. */
+    indexedDB?: IDBFactory;
+    /** How long to wait for the database to open, in ms, before doing without it. */
+    openTimeout?: number;
+    /** How long, in ms, to do without a database that did not open before trying again. */
+    retryAfter?: number;
+}
+/** A ModuleCache that a host can close, letting go of its database. */
+export interface IndexedDbModuleCache extends ModuleCache {
+    /** Close the database; a later get or put opens it again. */
+    close(): void;
+}
+/**
+ * A ModuleCache kept in IndexedDB, opened on its first use. A get marks its
+ * module used; a put evicts the least recently used until the modules fit
+ * in `maxBytes`, and stores nothing larger than that, once the page is
+ * idle: a large module's write that a load's next get waited behind took
+ * that get from 4 to 45 ms.
+ */
+export declare function indexedDbModuleCache(options?: IndexedDbModuleCacheOptions): IndexedDbModuleCache;
+//# sourceMappingURL=indexeddb.d.ts.map

package/dist/indexeddb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb.d.ts","sourceRoot":"","sources":["../src/indexeddb.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEhE,MAAM,WAAW,2BAA2B;IAC1C,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,iFAAiF;IACjF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,uFAAuF;IACvF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,uEAAuE;AACvE,MAAM,WAAW,oBAAqB,SAAQ,WAAW;IACvD,6DAA6D;IAC7D,KAAK,IAAI,IAAI,CAAC;CACf;AAeD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,GAAE,2BAAgC,GACxC,oBAAoB,CAsHtB"}

package/dist/indexeddb.js

@@ -0,0 +1,170 @@
+/** The database's version: 2 kept each module with its compile's log, 3 with their lengths too. */
+const VERSION = 3;
+const MODULES = "modules";
+/** Each module's size and last use, apart from it, so that evicting reads no module. */
+const ENTRIES = "entries";
+const USED = "used";
+/**
+ * A ModuleCache kept in IndexedDB, opened on its first use. A get marks its
+ * module used; a put evicts the least recently used until the modules fit
+ * in `maxBytes`, and stores nothing larger than that, once the page is
+ * idle: a large module's write that a load's next get waited behind took
+ * that get from 4 to 45 ms.
+ */
+export function indexedDbModuleCache(options = {}) {
+    const { name = "swf2es-modules", maxBytes = 256 * 1024 * 1024, openTimeout = 2000, retryAfter = 30_000, } = options;
+    let opened = null;
+    // When a database that did not open may be tried again.
+    let retryAt = 0;
+    const database = () => {
+        if (opened === null || (retryAt !== 0 && Date.now() >= retryAt)) {
+            retryAt = 0;
+            const attempt = open(options.indexedDB ?? globalThis.indexedDB, name, openTimeout);
+            opened = attempt;
+            attempt.then((db) => {
+                // Another tab opening a later version: let go, and open again
+                // next time, unless this was let go of already for another.
+                db.onversionchange = () => {
+                    db.close();
+                    if (opened === attempt) {
+                        opened = null;
+                    }
+                };
+            }, () => {
+                if (opened === attempt) {
+                    retryAt = Date.now() + retryAfter;
+                }
+            });
+        }
+        return opened;
+    };
+    return {
+        async get(key) {
+            const db = await database();
+            const stored = await request(db.transaction(MODULES).objectStore(MODULES).get(key));
+            const module = stored;
+            if (typeof module?.module !== "string" ||
+                typeof module.log !== "string" ||
+                !Array.isArray(module.lengths)) {
+                return undefined;
+            }
+            // Marked used apart, in a store no get reads, and not waited for: a
+            // mark that fails leaves the module as read and its last use as it was.
+            try {
+                const entries = db.transaction(ENTRIES, "readwrite").objectStore(ENTRIES);
+                request(entries.get(key)).then((entry) => {
+                    if (entry) {
+                        entries.put({ ...entry, used: Date.now() });
+                    }
+                }, () => { });
+            }
+            catch {
+                // No transaction: its last use stays as it was.
+            }
+            return {
+                module: module.module,
+                log: module.log,
+                lengths: [...module.lengths],
+            };
+        },
+        async put(key, module) {
+            const bytes = (module.module.length + module.log.length) * 2;
+            if (bytes > maxBytes) {
+                return;
+            }
+            const db = await database();
+            await new Promise((resolve) => idle(resolve));
+            const tx = db.transaction([MODULES, ENTRIES], "readwrite");
+            const modules = tx.objectStore(MODULES);
+            const entries = tx.objectStore(ENTRIES);
+            modules.put({ module: module.module, log: module.log, lengths: module.lengths }, key);
+            entries.put({ key, bytes, used: Date.now() });
+            // Oldest first, the one just put among them.
+            const all = await request(entries.index(USED).getAll());
+            let total = 0;
+            for (const entry of all) {
+                total += entry.bytes;
+            }
+            for (const entry of all) {
+                if (total <= maxBytes) {
+                    break;
+                }
+                if (entry.key !== key) {
+                    modules.delete(entry.key);
+                    entries.delete(entry.key);
+                    total -= entry.bytes;
+                }
+            }
+            await done(tx);
+        },
+        async delete(key) {
+            const tx = (await database()).transaction([MODULES, ENTRIES], "readwrite");
+            tx.objectStore(MODULES).delete(key);
+            tx.objectStore(ENTRIES).delete(key);
+            await done(tx);
+        },
+        close() {
+            const was = opened;
+            opened = null;
+            was?.then((db) => db.close()).catch(() => { });
+        },
+    };
+}
+/** Run `f` when the page is next idle, or within a second; soon, where there is no requestIdleCallback. */
+function idle(f) {
+    if (typeof requestIdleCallback === "function") {
+        requestIdleCallback(() => f(), { timeout: 1000 });
+    }
+    else {
+        setTimeout(f, 0);
+    }
+}
+/** The database, made if new; rejected if it does not open within `timeout` ms, as when another tab blocks an upgrade. */
+function open(factory, name, timeout) {
+    return new Promise((resolve, reject) => {
+        let late = false;
+        const timer = setTimeout(() => {
+            late = true;
+            reject(new Error(`IndexedDB ${name} did not open`));
+        }, timeout);
+        const opening = factory.open(name, VERSION);
+        opening.onupgradeneeded = () => {
+            // An older version's modules are another format's: dropped.
+            const db = opening.result;
+            for (const store of [...db.objectStoreNames]) {
+                db.deleteObjectStore(store);
+            }
+            db.createObjectStore(MODULES);
+            db.createObjectStore(ENTRIES, { keyPath: "key" }).createIndex(USED, USED);
+        };
+        opening.onsuccess = () => {
+            clearTimeout(timer);
+            // Given up on already, it is closed.
+            if (late) {
+                opening.result.close();
+            }
+            else {
+                resolve(opening.result);
+            }
+        };
+        opening.onerror = () => {
+            clearTimeout(timer);
+            reject(opening.error);
+        };
+    });
+}
+function request(r) {
+    return new Promise((resolve, reject) => {
+        r.onsuccess = () => resolve(r.result);
+        r.onerror = () => reject(r.error);
+    });
+}
+/** Resolves once `tx` has committed; rejects if it aborts, a quota exceeded say. */
+function done(tx) {
+    return new Promise((resolve, reject) => {
+        tx.oncomplete = () => resolve();
+        tx.onerror = () => reject(tx.error);
+        tx.onabort = () => reject(tx.error ?? new Error("IndexedDB transaction aborted"));
+    });
+}
+//# sourceMappingURL=indexeddb.js.map

package/dist/indexeddb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexeddb.js","sourceRoot":"","sources":["../src/indexeddb.ts"],"names":[],"mappings":"AA0BA,mGAAmG;AACnG,MAAM,OAAO,GAAG,CAAC,CAAC;AAClB,MAAM,OAAO,GAAG,SAAS,CAAC;AAC1B,wFAAwF;AACxF,MAAM,OAAO,GAAG,SAAS,CAAC;AAC1B,MAAM,IAAI,GAAG,MAAM,CAAC;AAQpB;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAO,GAAgC,EAAE;IAEzC,MAAM,EACJ,IAAI,GAAG,gBAAgB,EACvB,QAAQ,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,EAC5B,WAAW,GAAG,IAAI,EAClB,UAAU,GAAG,MAAM,GACpB,GAAG,OAAO,CAAC;IACZ,IAAI,MAAM,GAAgC,IAAI,CAAC;IAC/C,wDAAwD;IACxD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,OAAO,CAAC,EAAE,CAAC;YAChE,OAAO,GAAG,CAAC,CAAC;YACZ,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;YACnF,MAAM,GAAG,OAAO,CAAC;YACjB,OAAO,CAAC,IAAI,CACV,CAAC,EAAE,EAAE,EAAE;gBACL,8DAA8D;gBAC9D,4DAA4D;gBAC5D,EAAE,CAAC,eAAe,GAAG,GAAG,EAAE;oBACxB,EAAE,CAAC,KAAK,EAAE,CAAC;oBACX,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;wBACvB,MAAM,GAAG,IAAI,CAAC;oBAChB,CAAC;gBACH,CAAC,CAAC;YACJ,CAAC,EACD,GAAG,EAAE;gBACH,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;oBACvB,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,UAAU,CAAC;gBACpC,CAAC;YACH,CAAC,CACF,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,OAAO;QACL,KAAK,CAAC,GAAG,CAAC,GAAG;YACX,MAAM,EAAE,GAAG,MAAM,QAAQ,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,OAAO,CAAU,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YAC7F,MAAM,MAAM,GAAG,MAAkC,CAAC;YAClD,IACE,OAAO,MAAM,EAAE,MAAM,KAAK,QAAQ;gBAClC,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ;gBAC9B,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAC9B,CAAC;gBACD,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,oEAAoE;YACpE,wEAAwE;YACxE,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;gBAC1E,OAAO,CAAoB,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAC/C,CAAC,KAAK,EAAE,EAAE;oBACR,IAAI,KAAK,EAAE,CAAC;wBACV,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;oBAC9C,CAAC;gBACH,CAAC,EACD,GAAG,EAAE,GAAE,CAAC,CACT,CAAC;YACJ,CAAC;YAAC,MAAM,CAAC;gBACP,gDAAgD;YAClD,CAAC;YAED,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,OAAO,CAAqB;aACjD,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM;YACnB,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;gBACrB,OAAO;YACT,CAAC;YAED,MAAM,EAAE,GAAG,MAAM,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YACpD,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC;YAC3D,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;YACtF,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,EAAW,CAAC,CAAC;YACvD,6CAA6C;YAC7C,MAAM,GAAG,GAAG,MAAM,OAAO,CAAU,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YACjE,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,KAAK,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;gBACxB,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC;YACvB,CAAC;YAED,KAAK,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;gBACxB,IAAI,KAAK,IAAI,QAAQ,EAAE,CAAC;oBACtB,MAAM;gBACR,CAAC;gBAED,IAAI,KAAK,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;oBACtB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBAC1B,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC;gBACvB,CAAC;YACH,CAAC;YAED,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,KAAK,CAAC,MAAM,CAAC,GAAG;YACd,MAAM,EAAE,GAAG,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC;YAC3E,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpC,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpC,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,CAAC;QACD,KAAK;YACH,MAAM,GAAG,GAAG,MAAM,CAAC;YACnB,MAAM,GAAG,IAAI,CAAC;YACd,GAAG,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAChD,CAAC;KACF,CAAC;AACJ,CAAC;AAED,2GAA2G;AAC3G,SAAS,IAAI,CAAC,CAAa;IACzB,IAAI,OAAO,mBAAmB,KAAK,UAAU,EAAE,CAAC;QAC9C,mBAAmB,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnB,CAAC;AACH,CAAC;AAED,0HAA0H;AAC1H,SAAS,IAAI,CAAC,OAAmB,EAAE,IAAY,EAAE,OAAe;IAC9D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,IAAI,GAAG,KAAK,CAAC;QACjB,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,IAAI,GAAG,IAAI,CAAC;YACZ,MAAM,CAAC,IAAI,KAAK,CAAC,aAAa,IAAI,eAAe,CAAC,CAAC,CAAC;QACtD,CAAC,EAAE,OAAO,CAAC,CAAC;QACZ,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,CAAC,eAAe,GAAG,GAAG,EAAE;YAC7B,4DAA4D;YAC5D,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;YAC1B,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBAC7C,EAAE,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;YAED,EAAE,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;YAC9B,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC5E,CAAC,CAAC;QACF,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE;YACvB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,qCAAqC;YACrC,IAAI,IAAI,EAAE,CAAC;gBACT,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC;QACF,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE;YACrB,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,OAAO,CAAI,CAAa;IAC/B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,CAAC,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,MAAW,CAAC,CAAC;QAC3C,CAAC,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,oFAAoF;AACpF,SAAS,IAAI,CAAC,EAAkB;IAC9B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,EAAE,CAAC,UAAU,GAAG,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;QAChC,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QACpC,EAAE,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/node-worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=node-worker.d.ts.map

package/dist/node-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-worker.d.ts","sourceRoot":"","sources":["../src/node-worker.ts"],"names":[],"mappings":""}

package/dist/node-worker.js

@@ -0,0 +1,12 @@
+// A worker_threads Worker running one background flash.system.Worker (node.ts).
+import { parentPort } from "node:worker_threads";
+import { runWorkerThread } from "@swf2es/player/worker";
+const port = parentPort;
+if (!port) {
+    throw new Error("node-worker.js runs only as a worker_threads Worker");
+}
+runWorkerThread({
+    post: (message) => port.postMessage(message),
+    listen: (receive) => port.on("message", receive),
+});
+//# sourceMappingURL=node-worker.js.map

package/dist/node-worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-worker.js","sourceRoot":"","sources":["../src/node-worker.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,IAAI,GAAG,UAAU,CAAC;AACxB,IAAI,CAAC,IAAI,EAAE,CAAC;IACV,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;AACzE,CAAC;AAED,eAAe,CAAC;IACd,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC;IAC5C,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC;CACjD,CAAC,CAAC"}

package/dist/node.d.ts

@@ -0,0 +1,8 @@
+import type { SocketHost, WorkerHost } from "@swf2es/player";
+/** A host that connects ActionScript sockets to TCP directly from Node. */
+export declare function nodeSocketHost(): SocketHost;
+/** Background workers on worker_threads Workers running node-worker.js, given codegen compiled. */
+export declare function nodeWorkerHost(options: {
+    codegen: WebAssembly.Module;
+}): WorkerHost;
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG7D,2EAA2E;AAC3E,wBAAgB,cAAc,IAAI,UAAU,CAuB3C;AAED,mGAAmG;AACnG,wBAAgB,cAAc,CAAC,OAAO,EAAE;IAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAA;CAAE,GAAG,UAAU,CAcnF"}

package/dist/node.js

@@ -0,0 +1,43 @@
+// Node's TCP transport for flash.net.Socket, and its threads for
+// flash.system.Worker; imported only by hosts that opt in.
+import { connect } from "node:net";
+import { Worker } from "node:worker_threads";
+/** A host that connects ActionScript sockets to TCP directly from Node. */
+export function nodeSocketHost() {
+    return {
+        connect(host, port, events) {
+            const socket = connect({ host, port });
+            socket.on("connect", () => events.open({
+                localAddress: socket.localAddress ?? "",
+                localPort: socket.localPort ?? 0,
+                remoteAddress: socket.remoteAddress ?? "",
+                remotePort: socket.remotePort ?? 0,
+            }));
+            socket.on("data", (bytes) => events.data(bytes));
+            socket.on("close", () => events.close());
+            socket.on("error", () => events.error("Error #2031: Socket Error."));
+            return {
+                // Socket.flush has already combined its pending bytes into one chunk.
+                send: (bytes) => socket.write(bytes),
+                close: () => socket.destroy(),
+            };
+        },
+    };
+}
+/** Background workers on worker_threads Workers running node-worker.js, given codegen compiled. */
+export function nodeWorkerHost(options) {
+    return {
+        start(init, receive, failed) {
+            const worker = new Worker(new URL("./node-worker.js", import.meta.url));
+            worker.on("message", receive);
+            worker.on("error", failed);
+            const start = { codegen: options.codegen, init };
+            worker.postMessage(start);
+            return {
+                post: (message) => worker.postMessage(message),
+                terminate: () => worker.terminate(),
+            };
+        },
+    };
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,2DAA2D;AAC3D,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAI7C,2EAA2E;AAC3E,MAAM,UAAU,cAAc;IAC5B,OAAO;QACL,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM;YACxB,MAAM,MAAM,GAAG,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACvC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CACxB,MAAM,CAAC,IAAI,CAAC;gBACV,YAAY,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE;gBACvC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,CAAC;gBAChC,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,EAAE;gBACzC,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;aACnC,CAAC,CACH,CAAC;YACF,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;YACjD,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACzC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC,CAAC;YAErE,OAAO;gBACL,sEAAsE;gBACtE,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;gBACpC,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,EAAE;aAC9B,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED,mGAAmG;AACnG,MAAM,UAAU,cAAc,CAAC,OAAwC;IACrE,OAAO;QACL,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM;YACzB,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,kBAAkB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;YACxE,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC9B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC3B,MAAM,KAAK,GAAgB,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;YAC9D,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAC1B,OAAO;gBACL,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC;gBAC9C,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE;aACpC,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/precompiled.d.ts

@@ -0,0 +1,31 @@
+import type { ModuleCache } from "@swf2es/player";
+export interface PrecompiledModulesOptions {
+    /** A file the manifest names, or the manifest, read by its URL: fetched by default. */
+    read?: (url: URL) => Promise<string>;
+    /**
+     * Have the player import each module from its URL, as an ES module, not
+     * evaluate its text: for a page whose Content-Security-Policy refuses
+     * 'unsafe-eval'. The document then keeps the modules for as long as it
+     * lives.
+     */
+    importModules?: boolean;
+}
+/**
+ * The modules of the manifest.json at `manifest` (a URL, resolved against
+ * the page's), and the logs beside them. The manifest is read at the first
+ * get, and again at the next if that failed. Asks for every module however
+ * small, so that with each precompiled none compiles.
+ */
+export declare function precompiledModules(manifest: string | URL, options?: PrecompiledModulesOptions): ModuleCache;
+/**
+ * Caches asked in order, the first that holds a module answering, as the
+ * modules compiled ahead of time and then an IndexedDB cache: a module
+ * compiled goes to each. A deletion naming the entry the player could not
+ * use goes only to the member that gave that entry, which then answers
+ * the key no more, so that the player, which asks again once, reads the
+ * next one's; one naming none goes to each. One that fails is passed
+ * over. Asks for the ABCs the member that asks for the smallest does,
+ * every member then asked for them.
+ */
+export declare function chainCaches(...caches: ModuleCache[]): ModuleCache;
+//# sourceMappingURL=precompiled.d.ts.map

package/dist/precompiled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"precompiled.d.ts","sourceRoot":"","sources":["../src/precompiled.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEhE,MAAM,WAAW,yBAAyB;IACxC,uFAAuF;IACvF,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAWD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,GAAG,GAAG,EACtB,OAAO,GAAE,yBAA8B,GACtC,WAAW,CA0Eb;AAWD;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,CA+BjE"}

package/dist/precompiled.js

@@ -0,0 +1,125 @@
+/** The manifest's format this reads, the command's MANIFEST_VERSION: any other names no module. */
+const MANIFEST_VERSION = 2;
+/**
+ * The modules of the manifest.json at `manifest` (a URL, resolved against
+ * the page's), and the logs beside them. The manifest is read at the first
+ * get, and again at the next if that failed. Asks for every module however
+ * small, so that with each precompiled none compiles.
+ */
+export function precompiledModules(manifest, options = {}) {
+    const base = new URL(manifest, globalThis.location?.href);
+    const read = options.read ?? fetchText;
+    let entries = null;
+    const rejected = new Set();
+    const load = async () => {
+        const parsed = JSON.parse(await read(base));
+        const map = new Map();
+        if (parsed?.manifestVersion !== MANIFEST_VERSION) {
+            return map;
+        }
+        for (const e of [parsed.libraries, parsed.abcs].flat()) {
+            const { key, module, log, lengths } = e ?? {};
+            if (typeof key === "string" &&
+                typeof module === "string" &&
+                typeof log === "string" &&
+                Array.isArray(lengths) &&
+                lengths.length === 2) {
+                map.set(key, {
+                    module: new URL(module, base),
+                    log: new URL(log, base),
+                    lengths: [...lengths],
+                });
+            }
+        }
+        return map;
+    };
+    return {
+        minBytes: 0,
+        async get(key) {
+            if (rejected.has(key)) {
+                return undefined;
+            }
+            entries ??= load();
+            let found;
+            try {
+                found = (await entries).get(key);
+            }
+            catch (e) {
+                entries = null;
+                throw e;
+            }
+            if (!found) {
+                return undefined;
+            }
+            // Each file by a URL of its key: a module or log of another build,
+            // which an HTTP cache may hold under the same name, is never this
+            // key's, and an imported module's length is not checked.
+            const { lengths } = found;
+            const [module, log] = [found.module, found.log].map((url) => {
+                const keyed = new URL(url);
+                keyed.search = key;
+                return keyed;
+            });
+            if (options.importModules) {
+                return { module: "", log: await read(log), lengths, url: module.href };
+            }
+            const [text, logText] = await Promise.all([read(module), read(log)]);
+            return { module: text, log: logText, lengths };
+        },
+        async put() { },
+        // Its files cannot be deleted; the key is not answered again on this page.
+        async delete(key) {
+            rejected.add(key);
+        },
+    };
+}
+async function fetchText(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`${url}: HTTP ${response.status}`);
+    }
+    return response.text();
+}
+/**
+ * Caches asked in order, the first that holds a module answering, as the
+ * modules compiled ahead of time and then an IndexedDB cache: a module
+ * compiled goes to each. A deletion naming the entry the player could not
+ * use goes only to the member that gave that entry, which then answers
+ * the key no more, so that the player, which asks again once, reads the
+ * next one's; one naming none goes to each. One that fails is passed
+ * over. Asks for the ABCs the member that asks for the smallest does,
+ * every member then asked for them.
+ */
+export function chainCaches(...caches) {
+    const sizes = caches.flatMap((c) => (c.minBytes === undefined ? [] : [c.minBytes]));
+    // By the entry, not the key: two reads of one key may have been answered by two members.
+    const answered = new WeakMap();
+    // A member that throws at the call skips none of the others.
+    const each = async (members, f) => {
+        await Promise.allSettled(members.map((c) => Promise.resolve().then(() => f(c))));
+    };
+    return {
+        ...(sizes.length ? { minBytes: Math.min(...sizes) } : {}),
+        async get(key) {
+            for (const cache of caches) {
+                try {
+                    const entry = await cache.get(key);
+                    if (entry !== undefined) {
+                        answered.set(entry, cache);
+                        return entry;
+                    }
+                }
+                catch {
+                    // The next may hold it.
+                }
+            }
+            return undefined;
+        },
+        put: (key, entry) => each(caches, (c) => c.put(key, entry)),
+        delete: (key, entry) => {
+            const from = entry && answered.get(entry);
+            return each(from ? [from] : caches, (c) => c.delete(key, entry));
+        },
+    };
+}
+//# sourceMappingURL=precompiled.js.map

package/dist/precompiled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"precompiled.js","sourceRoot":"","sources":["../src/precompiled.ts"],"names":[],"mappings":"AAqBA,mGAAmG;AACnG,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAQ3B;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAAsB,EACtB,OAAO,GAA8B,EAAE;IAEvC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;IACvC,IAAI,OAAO,GAAuC,IAAI,CAAC;IACvD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;QACtB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,MAAM,GAAG,GAAG,IAAI,GAAG,EAAiB,CAAC;QACrC,IAAI,MAAM,EAAE,eAAe,KAAK,gBAAgB,EAAE,CAAC;YACjD,OAAO,GAAG,CAAC;QACb,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACvD,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9C,IACE,OAAO,GAAG,KAAK,QAAQ;gBACvB,OAAO,MAAM,KAAK,QAAQ;gBAC1B,OAAO,GAAG,KAAK,QAAQ;gBACvB,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;gBACtB,OAAO,CAAC,MAAM,KAAK,CAAC,EACpB,CAAC;gBACD,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE;oBACX,MAAM,EAAE,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC;oBAC7B,GAAG,EAAE,IAAI,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC;oBACvB,OAAO,EAAE,CAAC,GAAG,OAAO,CAAqB;iBAC1C,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC,CAAC;IAEF,OAAO;QACL,QAAQ,EAAE,CAAC;QACX,KAAK,CAAC,GAAG,CAAC,GAAW;YACnB,IAAI,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtB,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,OAAO,KAAK,IAAI,EAAE,CAAC;YACnB,IAAI,KAAwB,CAAC;YAC7B,IAAI,CAAC;gBACH,KAAK,GAAG,CAAC,MAAM,OAAO,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACnC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,GAAG,IAAI,CAAC;gBACf,MAAM,CAAC,CAAC;YACV,CAAC;YAED,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,mEAAmE;YACnE,kEAAkE;YAClE,yDAAyD;YACzD,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC;YAC1B,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;gBAC1D,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;gBAC3B,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC;gBACnB,OAAO,KAAK,CAAC;YACf,CAAC,CAAC,CAAC;YACH,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;gBAC1B,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;YACzE,CAAC;YAED,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACrE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QACjD,CAAC;QACD,KAAK,CAAC,GAAG,KAAI,CAAC;QACd,2EAA2E;QAC3E,KAAK,CAAC,MAAM,CAAC,GAAG;YACd,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,GAAQ;IAC/B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,UAAU,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,GAAG,MAAqB;IAClD,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpF,yFAAyF;IACzF,MAAM,QAAQ,GAAG,IAAI,OAAO,EAA6B,CAAC;IAC1D,6DAA6D;IAC7D,MAAM,IAAI,GAAG,KAAK,EAAE,OAAsB,EAAE,CAAwC,EAAE,EAAE;QACtF,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,CAAC,CAAC;IACF,OAAO;QACL,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,KAAK,CAAC,GAAG,CAAC,GAAG;YACX,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC;oBACH,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;oBACnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;wBACxB,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;wBAC3B,OAAO,KAAK,CAAC;oBACf,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,wBAAwB;gBAC1B,CAAC;YACH,CAAC;YAED,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAC3D,MAAM,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;YACrB,MAAM,IAAI,GAAG,KAAK,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;QACnE,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/stage3d.d.ts

@@ -0,0 +1,13 @@
+import type { Context3D, Context3DLifecycle, Stage3DHost } from "@swf2es/player/context3d";
+export interface Stage3DSurface {
+    canvas: HTMLCanvasElement;
+    context: Context3D;
+    /** Called once after resource disposal and listener removal, including failed attachment. */
+    destroy?: () => void;
+}
+/** The caller supplies a positioned, clipped parent, with the display-list canvas
+ * above slots 0..3. The adapter disposes resources before removing a surface. */
+export declare function stage3DCanvasHost(parent: HTMLElement, create: (slot: number) => Stage3DSurface): Stage3DHost;
+/** The surface outlives its lost resources so the browser can signal recovery. */
+export declare function observeLoss(canvas: HTMLCanvasElement, lifecycle: Context3DLifecycle): () => void;
+//# sourceMappingURL=stage3d.d.ts.map

package/dist/stage3d.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stage3d.d.ts","sourceRoot":"","sources":["../src/stage3d.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE3F,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,iBAAiB,CAAC;IAC1B,OAAO,EAAE,SAAS,CAAC;IACnB,6FAA6F;IAC7F,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;CACtB;AAED;iFACiF;AACjF,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,cAAc,GACvC,WAAW,CA6Cb;AAED,kFAAkF;AAClF,wBAAgB,WAAW,CAAC,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,kBAAkB,GAAG,MAAM,IAAI,CAahG"}

package/dist/stage3d.js

@@ -0,0 +1,61 @@
+/** The caller supplies a positioned, clipped parent, with the display-list canvas
+ * above slots 0..3. The adapter disposes resources before removing a surface. */
+export function stage3DCanvasHost(parent, create) {
+    const surfaces = new Map();
+    return {
+        create(slot, lifecycle) {
+            if (surfaces.has(slot)) {
+                throw new Error("Stage3D surface must be removed before recreation");
+            }
+            const surface = create(slot);
+            const detach = observeLoss(surface.canvas, lifecycle);
+            try {
+                surface.canvas.style.position = "absolute";
+                surface.canvas.style.zIndex = String(slot);
+                parent.append(surface.canvas);
+                surfaces.set(slot, { ...surface, detach });
+            }
+            catch (error) {
+                detach();
+                surface.context.dispose();
+                surface.canvas.remove();
+                surface.destroy?.();
+                throw error;
+            }
+            return surface.context;
+        },
+        place(slot, x, y, visible) {
+            const surface = surfaces.get(slot);
+            if (surface) {
+                const style = surface.canvas.style;
+                style.left = `${x}px`;
+                style.top = `${y}px`;
+                style.visibility = visible ? "visible" : "hidden";
+            }
+        },
+        remove(slot) {
+            const surface = surfaces.get(slot);
+            if (surface) {
+                surface.detach();
+                surface.canvas.remove();
+                surfaces.delete(slot);
+                surface.destroy?.();
+            }
+        },
+    };
+}
+/** The surface outlives its lost resources so the browser can signal recovery. */
+export function observeLoss(canvas, lifecycle) {
+    const lost = (event) => {
+        event.preventDefault();
+        lifecycle.lost();
+    };
+    const restored = () => lifecycle.restored();
+    canvas.addEventListener("webglcontextlost", lost);
+    canvas.addEventListener("webglcontextrestored", restored);
+    return () => {
+        canvas.removeEventListener("webglcontextlost", lost);
+        canvas.removeEventListener("webglcontextrestored", restored);
+    };
+}
+//# sourceMappingURL=stage3d.js.map

package/dist/stage3d.js.map

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