@wasm-gaming/engine-specs 0.3.0 → 0.3.2

package/dist/engine-specs.js

@@ -1,3 +1,382 @@
 // ---- Introspectable property definitions ----
-export {};
+/**
+ * The listener bookkeeping, shipped rather than described — the one piece of runtime
+ * code in this package.
+ *
+ * It is a **convenience, not a requirement**: the contract stays structural, so an
+ * engine that already owns an emitter satisfies {@link EngineSurface} without this.
+ * What it saves is the part everyone gets subtly wrong — iterating a copy, so a
+ * listener that unsubscribes mid-emit does not corrupt the loop; de-duplicating a
+ * listener registered twice; and keeping one throwing listener from silencing the
+ * rest.
+ *
+ * Hold it **privately** and hand the same instance to every carrier. That is what
+ * makes `sdk.on(…)` and `play.on(…)` one channel rather than two, lets a host
+ * subscribe before the engine exists, and keeps `emit` out of the public API — a host
+ * must not be able to forge an engine event.
+ */
+export class EventEmitter {
+    #listeners = new Map();
+    /** @param listeners Registered immediately — what `EngineInit.on` carries. */
+    constructor(listeners) {
+        for (const type of Object.keys(listeners ?? {})) {
+            const listener = listeners?.[type];
+            if (listener)
+                this.on(type, listener);
+        }
+    }
+    /** Registering the same listener twice registers it once, as `EventTarget` does. */
+    on(type, listener) {
+        let set = this.#listeners.get(type);
+        if (!set)
+            this.#listeners.set(type, (set = new Set()));
+        set.add(listener);
+        return this;
+    }
+    /**
+     * The listener is required, as in `EventTarget`. A convenience `off(type)` dropping
+     * every listener for a type is a footgun on a page where two components subscribed
+     * independently: one unsubscribing would silence the other.
+     */
+    off(type, listener) {
+        const set = this.#listeners.get(type);
+        if (set?.delete(listener) && set.size === 0) {
+            this.#listeners.delete(type);
+        }
+        return this;
+    }
+    /**
+     * Takes the **detail**, and wraps it. The rest tuple is what lets an event with no
+     * detail be emitted as `emit('exit')` while still checking the ones that have one.
+     */
+    emit(type, ...[detail]) {
+        const set = this.#listeners.get(type);
+        if (!set)
+            return;
+        // Built once and frozen: every listener gets this same object, so a mutable one
+        // would let the first rewrite what the rest read.
+        const event = Object.freeze({ type, detail: detail });
+        // A copy: a listener may call `off()` — on itself or another — while this runs.
+        for (const listener of [...set]) {
+            try {
+                listener(event);
+            }
+            catch (thrown) {
+                // One bad listener must neither silence the rest nor vanish. Rethrowing on a
+                // fresh task puts it in front of `window.onerror` with its stack intact.
+                queueMicrotask(() => {
+                    throw thrown;
+                });
+            }
+        }
+    }
+}
+/**
+ * Wrap a promise of a live engine in the chainable surface.
+ *
+ * Exported because it is the single most duplicated function in an engine, and an
+ * engine that does not extend {@link EnginePlayBase} still needs exactly this.
+ *
+ * `on` and `off` do **not** go through the chain: they reach the channel now, so a
+ * listener is live before the promise settles. Routing them through it would bind
+ * after the session opened and lose whatever was emitted while it was opening.
+ */
+export function hydratePlay(inner, events) {
+    const chain = (step) => hydratePlay(inner.then(async (play) => {
+        await step(play);
+        return play;
+    }), events);
+    const hydrated = {
+        then: (onfulfilled, onrejected) => inner.then(onfulfilled, onrejected),
+        catch: (onrejected) => inner.catch(onrejected),
+        finally: (onfinally) => inner.finally(onfinally),
+        [Symbol.toStringTag]: 'PromisePlay',
+        config: ((patch) => patch === undefined
+            ? inner.then((play) => play.config())
+            : chain((play) => play.config(patch))),
+        options: ((patch) => patch === undefined
+            ? inner.then((play) => play.options())
+            : chain((play) => play.options(patch))),
+        assets: ((patch) => patch === undefined
+            ? inner.then((play) => play.assets())
+            : chain((play) => play.assets(patch))),
+        storage: ((patch) => patch === undefined
+            ? inner.then((play) => play.storage())
+            : chain((play) => play.storage(patch))),
+        mount: (target) => chain((play) => play.mount(target)),
+        on: (type, listener) => {
+            events.on(type, listener);
+            return hydrated;
+        },
+        off: (type, listener) => {
+            events.off(type, listener);
+            return hydrated;
+        },
+        restart: (options) => chain((play) => play.restart(options)),
+        destroy: () => inner.then((play) => play.destroy()),
+    };
+    return hydrated;
+}
+/**
+ * The live engine, with everything the contract prescribes already written: state,
+ * the cumulative merge, the descriptors, the chainable promise, and the channel.
+ *
+ * A subclass supplies what only it can know — {@link EnginePlayBase.open} and
+ * {@link EnginePlayBase.close}, optionally {@link EnginePlayBase.mounted} and
+ * {@link EnginePlayBase.patched} — and its properties as an {@link EngineSpec}.
+ *
+ * The spec arrives as a **constructor argument**, not an abstract field, and that is
+ * not a style choice: a subclass field initialiser runs *after* `super()`, so a
+ * `protected abstract spec` would still be `undefined` while this constructor seeded
+ * state from it. Passing it up makes the ordering trap impossible rather than merely
+ * avoided.
+ */
+export class EnginePlayBase {
+    #spec;
+    #state;
+    #events;
+    #target;
+    /** The target {@link EnginePlayBase.mounted} has already been told about. */
+    #attached;
+    /**
+     * @param events The factory's channel. Omitted only when a play is built on its
+     * own; the factory always passes its own, which is what makes `sdk.on(…)` and
+     * `play.on(…)` one channel rather than two.
+     */
+    constructor(spec, init, events) {
+        this.#spec = spec;
+        this.#events = events ?? new EventEmitter(init?.on);
+        this.#state = {
+            config: seed(spec.config, init?.config),
+            options: seed(spec.options, init?.options),
+            assets: seed(spec.assets, init?.assets),
+            storage: seed(spec.storage, init?.storage),
+        };
+        // Recorded, not applied. `mounted()` is overridable, and a subclass's own fields
+        // are still uninitialised while this constructor runs — so the hook is deferred to
+        // the first `restart()`, by which point the subclass is whole.
+        this.#target = init?.mount;
+    }
+    /** The element is already recorded when this runs. */
+    mounted(target) {
+        void target;
+    }
+    /** A payload changed on a running engine — apply what is `live`, ignore the rest. */
+    patched(kind, patch) {
+        void kind;
+        void patch;
+    }
+    /**
+     * Emit one of this engine's own events.
+     *
+     * `protected`, so a typed host cannot forge an engine event — but be exact about
+     * what that buys: TypeScript erases `protected`, so this is a compile-time guard,
+     * not a capability boundary. Plain JavaScript can still reach it. Only the `#`
+     * fields below — the channel and the state — are unreachable at runtime.
+     */
+    emit(type, ...detail) {
+        this.#events.emit(type, ...detail);
+    }
+    /** Where the picture is, for a subclass that needs the element after `mounted()`. */
+    get target() {
+        return this.#target;
+    }
+    config(patch) {
+        // `arguments.length`, not `patch === undefined`: `config(undefined)` is a write of
+        // nothing, not a read.
+        if (arguments.length === 0)
+            return Promise.resolve(this.#describe('config'));
+        return this.#patch('config', patch);
+    }
+    options(patch) {
+        if (arguments.length === 0)
+            return Promise.resolve(this.#describe('options'));
+        return this.#patch('options', patch);
+    }
+    assets(patch) {
+        if (arguments.length === 0)
+            return Promise.resolve(this.#describe('assets'));
+        return this.#patch('assets', patch);
+    }
+    storage(patch) {
+        if (arguments.length === 0)
+            return Promise.resolve(this.#describe('storage'));
+        return this.#patch('storage', patch);
+    }
+    mount(target) {
+        this.#target = target;
+        return this.#run(() => this.#attach());
+    }
+    on(type, listener) {
+        this.#events.on(type, listener);
+        return hydratePlay(Promise.resolve(this), this.#events);
+    }
+    off(type, listener) {
+        this.#events.off(type, listener);
+        return hydratePlay(Promise.resolve(this), this.#events);
+    }
+    restart(options) {
+        return this.#run(async () => {
+            if (options)
+                Object.assign(this.#state.options, options);
+            // A target supplied to the constructor lands here, which is what makes
+            // `new Sdk({ mount: el }).start()` and `new Sdk().mount(el).start()` the same
+            // call — the rule the contract states for everything on the surface.
+            await this.#attach();
+            const opened = { ...this.#state.options };
+            await this.open(opened);
+            this.#emitCore('start', opened);
+        });
+    }
+    async destroy() {
+        await this.#guard(async () => {
+            await this.close();
+            this.#target = undefined;
+            this.#attached = undefined;
+            this.#emitCore('exit', undefined);
+        });
+    }
+    /** Tell the engine where it is, once per distinct target. Reparenting is legal. */
+    async #attach() {
+        if (!this.#target || this.#target === this.#attached)
+            return;
+        this.#attached = this.#target;
+        await this.mounted(this.#target);
+    }
+    // ---- Shared machinery ----
+    /** One getter's answer: the spec, with the current value written into each entry. */
+    #describe(kind) {
+        const spec = this.#spec[kind];
+        const state = this.#state[kind];
+        const out = {};
+        for (const key of Object.keys(spec)) {
+            out[key] = { ...spec[key], value: state[key] };
+        }
+        return out;
+    }
+    /** Cumulative, merged flat, one level — `undefined` is a value, not "leave alone". */
+    #patch(kind, patch) {
+        Object.assign(this.#state[kind], patch);
+        return this.#run(async () => {
+            await this.patched(kind, patch ?? {});
+        });
+    }
+    /** A step, as a link in the chain — and as an `error` event if it throws. */
+    #run(step) {
+        return hydratePlay(this.#guard(step), this.#events);
+    }
+    /**
+     * The rule that errors reach a host **both ways**: the promise rejects *and*
+     * `error` is emitted. Written once here rather than at every throw site.
+     */
+    async #guard(step) {
+        try {
+            await step();
+            return this;
+        }
+        catch (thrown) {
+            const error = thrown instanceof Error ? thrown : new Error(String(thrown));
+            this.#emitCore('error', error);
+            throw error;
+        }
+    }
+    /**
+     * The core events, emitted from here rather than by a subclass.
+     *
+     * The cast is the one thing TypeScript will not check here: `emit` takes a rest
+     * tuple that is conditional on the detail type, and that conditional stays
+     * unresolved while `P` is still a type parameter. It is sound — `EventsOf<P>`
+     * always contains `CoreEvents<P>` by construction — and confining it to this one
+     * method is why the three call sites above read plainly.
+     */
+    #emitCore(type, detail) {
+        // Cast the channel, not the method: pulling `emit` out into a variable would call
+        // it unbound, and it reads its listeners off `this`.
+        const events = this.#events;
+        events.emit(type, detail);
+    }
+}
+/** Starting state: every `default` the spec declares, then whatever `init` overrides. */
+function seed(spec, patch) {
+    const state = {};
+    for (const [key, property] of Object.entries(spec)) {
+        if (property.default !== undefined)
+            state[key] = property.default;
+    }
+    return Object.assign(state, patch);
+}
+/**
+ * The factory, with everything the contract prescribes already written: the
+ * cumulative init, the synchronous chain, the channel that outlives every session,
+ * and one live engine per factory.
+ *
+ * A subclass supplies its static identity and {@link EngineSDKBase.createPlay}.
+ */
+export class EngineSDKBase {
+    #init;
+    #play;
+    /**
+     * Created before any engine exists and handed to every carrier downstream. That is
+     * what lets a host subscribe to an error thrown while the first session opens.
+     */
+    events;
+    constructor(init) {
+        this.#init = { ...init };
+        this.events = new EventEmitter(init?.on);
+    }
+    config(patch) {
+        if (arguments.length === 0)
+            return this.#pending().config();
+        return this.#patch('config', patch);
+    }
+    options(patch) {
+        if (arguments.length === 0)
+            return this.#pending().options();
+        return this.#patch('options', patch);
+    }
+    assets(patch) {
+        if (arguments.length === 0)
+            return this.#pending().assets();
+        return this.#patch('assets', patch);
+    }
+    storage(patch) {
+        if (arguments.length === 0)
+            return this.#pending().storage();
+        return this.#patch('storage', patch);
+    }
+    /** Recorded now, applied when the engine exists — same call as `new Sdk({ mount })`. */
+    mount(target) {
+        this.#init.mount = target;
+        this.#play?.mount(target);
+        return this;
+    }
+    on(type, listener) {
+        this.events.on(type, listener);
+        return this;
+    }
+    off(type, listener) {
+        this.events.off(type, listener);
+        return this;
+    }
+    /**
+     * The only way in. On a live engine it reopens the session rather than building a
+     * second one: a factory governs at most one engine.
+     */
+    start(options) {
+        this.#play ??= this.createPlay(this.#init, this.events);
+        return this.#play.restart(options);
+    }
+    /** Answers a read before there is an engine: the settings the next one will use. */
+    #pending() {
+        return this.#play ?? this.createPlay(this.#init, this.events);
+    }
+    #patch(kind, patch) {
+        this.#init[kind] = { ...this.#init[kind], ...patch };
+        // A live engine gets it too, so the factory does not silently describe a state
+        // the engine is not in.
+        if (this.#play && patch)
+            this.#play[kind](patch);
+        return this;
+    }
+}
 //# sourceMappingURL=engine-specs.js.map

package/dist/engine-specs.js.map

@@ -1 +1 @@
-{"version":3,"file":"engine-specs.js","sourceRoot":"","sources":["../src/engine-specs.ts"],"names":[],"mappings":"AAAA,gDAAgD"}
+{"version":3,"file":"engine-specs.js","sourceRoot":"","sources":["../src/engine-specs.ts"],"names":[],"mappings":"AAAA,gDAAgD;AA+GhD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,YAAY;IACd,UAAU,GAAG,IAAI,GAAG,EAAwC,CAAC;IAEtE,8EAA8E;IAC9E,YAAY,SAA6B;QACvC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,CAAgB,EAAE,CAAC;YAC/D,MAAM,QAAQ,GAAG,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC;YACnC,IAAI,QAAQ;gBAAE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,oFAAoF;IACpF,EAAE,CAAoB,IAAO,EAAE,QAA8B;QAC3D,IAAI,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC;QACvD,GAAG,CAAC,GAAG,CAAC,QAAkC,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAoB,IAAO,EAAE,QAA8B;QAC5D,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,GAAG,EAAE,MAAM,CAAC,QAAkC,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACtE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,IAAI,CACF,IAAO,EACP,GAAG,CAAC,MAAM,CAA0C;QAEpD,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,gFAAgF;QAChF,kDAAkD;QAClD,MAAM,KAAK,GAAyB,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAc,EAAE,CAAC,CAAC;QACpF,gFAAgF;QAChF,KAAK,MAAM,QAAQ,IAAI,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC;YAChC,IAAI,CAAC;gBACF,QAAiC,CAAC,KAAK,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,MAAM,EAAE,CAAC;gBAChB,6EAA6E;gBAC7E,yEAAyE;gBACzE,cAAc,CAAC,GAAG,EAAE;oBAClB,MAAM,MAAM,CAAC;gBACf,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAqID;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,KAA6B,EAC7B,MAAiC;IAEjC,MAAM,KAAK,GAAG,CAAC,IAA6C,EAAkB,EAAE,CAC9E,WAAW,CACT,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;QACxB,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,EACF,MAAM,CACP,CAAC;IAEJ,MAAM,QAAQ,GAAmB;QAC/B,IAAI,EAAE,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;QACtE,KAAK,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC;QAC9C,OAAO,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;QAChD,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,aAAa;QAEnC,MAAM,EAAE,CAAC,CAAC,KAA4B,EAAE,EAAE,CACxC,KAAK,KAAK,SAAS;YACjB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACrC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAA6B;QACtE,OAAO,EAAE,CAAC,CAAC,KAA6B,EAAE,EAAE,CAC1C,KAAK,KAAK,SAAS;YACjB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACtC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAA8B;QACxE,MAAM,EAAE,CAAC,CAAC,KAA4B,EAAE,EAAE,CACxC,KAAK,KAAK,SAAS;YACjB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACrC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAA6B;QACtE,OAAO,EAAE,CAAC,CAAC,KAA6B,EAAE,EAAE,CAC1C,KAAK,KAAK,SAAS;YACjB,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YACtC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAA8B;QAExE,KAAK,EAAE,CAAC,MAAmB,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEnE,EAAE,EAAE,CAA8B,IAAO,EAAE,QAAwC,EAAE,EAAE;YACrF,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC1B,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,GAAG,EAAE,CAA8B,IAAO,EAAE,QAAwC,EAAE,EAAE;YACtF,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAC3B,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,OAAO,EAAE,CAAC,OAA+B,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACpF,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;KACpD,CAAC;IACF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAgB,cAAc;IAGzB,KAAK,CAAgB;IACrB,MAAM,CAA+C;IACrD,OAAO,CAA4B;IAC5C,OAAO,CAA0B;IACjC,6EAA6E;IAC7E,SAAS,CAA0B;IAEnC;;;;OAIG;IACH,YAAY,IAAmB,EAAE,IAAoB,EAAE,MAAkC;QACvF,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,MAAM,IAAI,IAAI,YAAY,CAAc,IAAI,EAAE,EAAE,CAAC,CAAC;QACjE,IAAI,CAAC,MAAM,GAAG;YACZ,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC;YACvC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC;YAC1C,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC;YACvC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC;SAC3C,CAAC;QACF,iFAAiF;QACjF,mFAAmF;QACnF,+DAA+D;QAC/D,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,KAAK,CAAC;IAC7B,CAAC;IAcD,sDAAsD;IAC5C,OAAO,CAAC,MAAmB;QACnC,KAAK,MAAM,CAAC;IACd,CAAC;IAED,qFAAqF;IAC3E,OAAO,CAAC,IAAiB,EAAE,KAAa;QAChD,KAAK,IAAI,CAAC;QACV,KAAK,KAAK,CAAC;IACb,CAAC;IAED;;;;;;;OAOG;IACO,IAAI,CACZ,IAAO,EACP,GAAG,MAAmE;QAEtE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,qFAAqF;IACrF,IAAc,MAAM;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAMD,MAAM,CAAC,KAA4B;QACjC,mFAAmF;QACnF,uBAAuB;QACvB,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC7E,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAID,OAAO,CACL,KAA6B;QAE7B,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAID,MAAM,CAAC,KAA4B;QACjC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC7E,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAID,OAAO,CACL,KAA6B;QAE7B,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;QAC9E,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,MAAmB;QACvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,EAAE,CAA8B,IAAO,EAAE,QAAwC;QAC/E,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAChC,OAAO,WAAW,CAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED,GAAG,CACD,IAAO,EACP,QAAwC;QAExC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACjC,OAAO,WAAW,CAAI,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,CAAC,OAA+B;QACrC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAC1B,IAAI,OAAO;gBAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACzD,uEAAuE;YACvE,8EAA8E;YAC9E,qEAAqE;YACrE,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAkB,CAAC;YAC1D,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxB,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;YAC3B,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;YACnB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;YACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;YAC3B,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,mFAAmF;IACnF,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,SAAS;YAAE,OAAO;QAC7D,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC;QAC9B,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACnC,CAAC;IAED,6BAA6B;IAE7B,qFAAqF;IACrF,SAAS,CAAwB,IAAO;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAA0C,CAAC;QACvE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,GAAG,GAAgD,EAAE,CAAC;QAC5D,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACpC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACjD,CAAC;QACD,OAAO,GAAiC,CAAC;IAC3C,CAAC;IAED,sFAAsF;IACtF,MAAM,CAAC,IAAiB,EAAE,KAAyB;QACjD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,CAAC,CAAC;QACxC,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAC1B,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,6EAA6E;IAC7E,IAAI,CAAC,IAAyB;QAC5B,OAAO,WAAW,CAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;IACzD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM,CAAC,IAAyB;QACpC,IAAI,CAAC;YACH,MAAM,IAAI,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,MAAM,KAAK,GAAG,MAAM,YAAY,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;YAC3E,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC/B,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;;;;;;;OAQG;IACH,SAAS,CAAgC,IAAO,EAAE,MAAwB;QACxE,kFAAkF;QAClF,qDAAqD;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAuE,CAAC;QAC5F,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC;CACF;AAED,yFAAyF;AACzF,SAAS,IAAI,CAAC,IAAY,EAAE,KAAyB;IACnD,MAAM,KAAK,GAA4B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAA6C,CAAC,EAAE,CAAC;QAC5F,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS;YAAE,KAAK,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,OAAO,CAAC;IACpE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAgB,aAAa;IAGxB,KAAK,CAAgB;IAC9B,KAAK,CAAgC;IAErC;;;OAGG;IACgB,MAAM,CAA4B;IAErD,YAAY,IAAoB;QAC9B,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,IAAI,YAAY,CAAc,IAAI,EAAE,EAAE,CAAC,CAAC;IACxD,CAAC;IAUD,MAAM,CAAC,KAA4B;QACjC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAID,OAAO,CAAC,KAA6B;QACnC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAID,MAAM,CAAC,KAA4B;QACjC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,CAAC;QAC5D,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACtC,CAAC;IAID,OAAO,CAAC,KAA6B;QACnC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,CAAC;QAC7D,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED,wFAAwF;IACxF,KAAK,CAAC,MAAmB;QACvB,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC;QAC1B,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,EAAE,CAA8B,IAAO,EAAE,QAAwC;QAC/E,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,GAAG,CAA8B,IAAO,EAAE,QAAwC;QAChF,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAA+B;QACnC,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACxD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,CAAC;IAED,oFAAoF;IACpF,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,CAAC,IAAiB,EAAE,KAAyB;QACjD,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;QACrD,+EAA+E;QAC/E,wBAAwB;QACxB,IAAI,IAAI,CAAC,KAAK,IAAI,KAAK;YAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAc,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wasm-gaming/engine-specs",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "The wasm-gaming engine contract: the single shared JS API every WASM game/emulator engine and the host app conform to. TypeScript types, no runtime dependencies.",
   "type": "module",
   "types": "./dist/engine-specs.d.ts",