@wasm-gaming/rsdkv4-wasm 0.2.0 → 0.3.0

package/dist/rsdkv4/engine-specs.js

@@ -0,0 +1,382 @@
+// ---- Introspectable property definitions ----
+/**
+ * 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/rsdkv4/rsdkv4.options.d.ts

@@ -160,6 +160,11 @@ export interface Rsdkv4InputDefaults {
 /**
  * The engine's own default bindings. See {@link Rsdkv4InputDefaults}.
  *
+ * Directions are the arrow keys. This build's `ProcessInput()` also reads `KeyW`,
+ * `KeyA`, `KeyS` and `KeyD` as a second set of them, and takes those three scancodes
+ * off `x`, `y` and `z` to do it — so the table below is what a *claiming* host should
+ * bind, and the engine under SDL polling answers to both.
+ *
  * This replaces the old `RSDKV4_KEYMAP`, which nothing read and which was wrong in
  * three ways for want of ever being checked against the engine: it listed 9 of the
  * 14 buttons, and bound `select` to `ShiftLeft` where the engine's default is `Tab`.
@@ -283,12 +288,15 @@ export interface Rsdkv4Assets {
 export interface Rsdkv4Storage {
     /**
      * Per-game folder for the pack, the settings and the save file, so two games do not
-     * overwrite each other. Examples: `"sonic1"`, `"rsdkv4/Sonic2"`.
+     * overwrite each other. Examples: `"sonic-1"`, `"sonic-2/profile-a"`.
      *
-     * It is a path under the engine's working root *and* the OPFS directory the SDK
-     * mirrors save data into, which is what lets a host read `<namespace>/SData.bin`
-     * itself. Anything that is not a usable relative path normalises to `"default"` —
-     * including the object you get from interpolating a game record by mistake.
+     * Relative to the engine's own folder: the SDK always prefixes `rsdkv4/`, so the
+     * files land in `rsdkv4/<namespace>/` — in WASMFS (`/data/rsdkv4/<namespace>`) and in
+     * OPFS alike — and no namespace can reach another engine's files. A host reads the
+     * resolved path from `play.storagePath`. Segments are cleaned (`.`/`..` dropped,
+     * odd characters → `_`); anything unusable normalises to `"default"`, including the
+     * object you get from interpolating a game record by mistake. A leading `rsdkv4/`
+     * (the old convention) is stripped with a warning.
      *
      * @defaultValue `"default"`
      */

package/dist/rsdkv4/rsdkv4.options.d.ts.map

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

package/dist/rsdkv4/rsdkv4.options.js

@@ -51,6 +51,11 @@ export const RSDKV4_BUTTONS = [
 /**
  * The engine's own default bindings. See {@link Rsdkv4InputDefaults}.
  *
+ * Directions are the arrow keys. This build's `ProcessInput()` also reads `KeyW`,
+ * `KeyA`, `KeyS` and `KeyD` as a second set of them, and takes those three scancodes
+ * off `x`, `y` and `z` to do it — so the table below is what a *claiming* host should
+ * bind, and the engine under SDL polling answers to both.
+ *
  * This replaces the old `RSDKV4_KEYMAP`, which nothing read and which was wrong in
  * three ways for want of ever being checked against the engine: it listed 9 of the
  * 14 buttons, and bound `select` to `ShiftLeft` where the engine's default is `Tab`.
@@ -168,7 +173,7 @@ export const RSDKV4_SPEC = {
         namespace: {
             default: 'default',
             live: false,
-            description: "Folder for this game's pack, settings and save file.",
+            description: "Folder for this game's pack, settings and save file, inside the engine's own rsdkv4/ folder (OPFS rsdkv4/<namespace>/).",
         },
         persist: {
             enum: ['opfs', null],

package/dist/rsdkv4/rsdkv4.options.js.map

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

package/dist/rsdkv4/rsdkv4.sdk.d.ts

@@ -7,7 +7,7 @@
  * const play = await new Rsdkv4SDK()
  *   .mount(document.querySelector('#stage'))
  *   .assets({ data: () => library.readBytes('Sonic2') })
- *   .storage({ namespace: 'rsdkv4/Sonic2' })
+ *   .storage({ namespace: 'sonic-2' })        // → OPFS rsdkv4/sonic-2/
  *   .config({ startMenu: 'host' })
  *   .on('saves', ({ detail }) => paintSlots(detail))
  *   .start({ slot: 0 });
@@ -54,6 +54,32 @@ export declare const RSDKV4_VIDEO: {
     readonly baseHeight: 240;
     readonly aspect: "16:9";
 };
+/**
+ * Where an engine keeps one namespace: `<engineId>/<namespace>`, relative to the OPFS
+ * root (which is WASMFS `/data`). Written with nothing rsdkv4-specific in it, so it can
+ * move verbatim into engine-specs.
+ *
+ * The host's namespace is cleaned segment by segment: blanks dropped, `.` and `..`
+ * dropped (they used to survive, and `'../x'` walked out of the work root), anything
+ * outside `[A-Za-z0-9._-]` turned into `_`. Nothing usable left means `'default'`.
+ * A namespace that already starts with the engine id has it stripped once, so a host
+ * written against the old convention (`'rsdkv4/Sonic1'`) lands where it always did.
+ */
+export declare function storagePath(engineId: string, namespace: unknown): {
+    namespace: string;
+    path: string;
+    prefixed: boolean;
+};
+/**
+ * A screen of RSDKv4's own in-canvas Dev Menu (Debug.cpp), as {@link
+ * RsdkDevMenuBridge.open} names them.
+ *
+ * `'categories'` is the engine's `SELECT A STAGE LIST` — PRESENTATION / REGULAR /
+ * SPECIAL / BONUS — and `'stages'` the scene list under one of them. Those two are the
+ * only native way to reach the BONUS list: the packs' own menu scenes (Sonic 1 and 2's
+ * `LEVEL SELECT` and `STAGE MENU`) can load a regular stage and nothing else.
+ */
+export type RsdkDevMenuScreen = 'main' | 'player' | 'categories' | 'stages';
 /** RSDKv4-specific bridge for a host's debug/stage-select UI. */
 export interface RsdkDevMenuBridge {
     getStageList(): Array<{
@@ -64,6 +90,26 @@ export interface RsdkDevMenuBridge {
     }>;
     loadStage(categoryIdx: number, stageIdx: number): void;
     setPaused(paused: boolean): void;
+    /**
+     * Whether the loaded wasm carries {@link open}. False means an engine built before
+     * the bridge existed — a host should hide the button rather than offer a dead one.
+     */
+    readonly canOpen: boolean;
+    /**
+     * Open the engine's own Dev Menu at `screen`, with `category` selecting the stage
+     * list for `'categories'` (preselected) and `'stages'` (listed). Categories are the
+     * engine's own indices, the ones {@link getStageList} is ordered by — 2 is BONUS.
+     *
+     * This is what Escape does natively: the request is handed to the engine thread
+     * (`ENGINE_INITDEVMENU`) and the menu comes up on its next frame, so **the running
+     * stage is torn down** — `initDevMenu()` clears graphics and animation data. Save
+     * files are untouched; the current run is not.
+     *
+     * The menu is driven by the engine's own input and does not run while the SDK holds
+     * a pause, so resume before calling. Returns false when the engine cannot be reached
+     * or the wasm predates the bridge ({@link canOpen}).
+     */
+    open(screen?: RsdkDevMenuScreen, category?: number): boolean;
 }
 /**
  * A row of the engine's GAME OPTIONS screen (differs between Sonic 1 and 2), as the
@@ -128,6 +174,34 @@ export interface RsdkInputBridge {
     release(): PromisePlay<Rsdkv4Payloads>;
     /** Whether a claim is held. The `options()` descriptor deliberately will not say. */
     readonly claimed: boolean;
+    /**
+     * What the engine has held **right now**, as the bitmask a claim writes: bit 0 is
+     * `up`, bit 13 is `select`, in {@link RSDKV4_BUTTONS} order.
+     *
+     * This is the read-back to the claim's write, and it answers the one question no
+     * amount of listening on the page can: *did the button reach the engine?* A key
+     * that fires `keydown` in the browser and never lights a bit here died between SDL
+     * and `ProcessInput()`; one that lights the bit and changes nothing on screen was
+     * received and the game chose not to act on it. Those two are otherwise the same
+     * silence, and telling them apart is the difference between a real input bug and
+     * Sonic simply refusing to roll while a direction is held.
+     *
+     * Works whether or not a claim is held — under SDL polling it is the keyboard and
+     * the pad as the engine read them. `0` when the engine is not up.
+     *
+     * Two things it is not. It is `hold`, not `press`: a button reads the same on the
+     * frame it goes down and on the hundredth frame it stays down. And it is the
+     * engine's view *after* the B→A fold, so in-stage the jump key `x` lights `a` and
+     * `b` never lights at all — which is the fold working, not a lost button.
+     */
+    readonly mask: number;
+    /**
+     * {@link mask}, spelled as the fourteen named booleans — the same shape a claim
+     * hands over, so a host can diff what it sent against what arrived.
+     *
+     * A fresh object on every read; it is a snapshot, not a live view.
+     */
+    readonly held: Rsdkv4Buttons;
 }
 /**
  * What `start()` and `restart()` hand back: the contract's chainable promise, narrowed
@@ -209,6 +283,12 @@ export declare class Rsdkv4Play extends EnginePlayBase<Rsdkv4Payloads> {
     get persistent(): boolean;
     /** The normalised {@link Rsdkv4Storage.namespace} this session actually used. */
     get namespace(): string;
+    /**
+     * Where this session's files live, relative to the OPFS root: `rsdkv4/<namespace>`.
+     * The path a host walks with `navigator.storage.getDirectory()` to stage a
+     * `Data.rsdk` before booting, or to read `SData.bin` after.
+     */
+    get storagePath(): string;
     /**
      * Input ownership, named. `play.input.claim(buttons)` and `play.input.release()`
      * are exactly `options({ buttons })` and `options({ buttons: null })` — same state,
@@ -229,7 +309,7 @@ export declare class Rsdkv4Play extends EnginePlayBase<Rsdkv4Payloads> {
 export declare class Rsdkv4SDK extends EngineSDKBase<Rsdkv4Payloads> {
     static readonly id = "rsdkv4";
     /** Kept in step with package.json by `node scripts/sync-version.mjs`. */
-    static readonly version = "0.2.0";
+    static readonly version = "0.3.0";
     static readonly name = "Retro Software Development Kit v4";
     static readonly description = "RSDKv4 compiled to WebAssembly via Emscripten. One game-agnostic WASM binary runs both Sonic 1 and Sonic 2 \u2014 the difference is only which Data.rsdk the host supplies at runtime. Ships none of the game: the player provides their own Data.rsdk, and it never leaves their browser.";
     protected createPlay(init: EngineInit<Rsdkv4Payloads>, events: EventEmitter<Rsdkv4Events_>): Rsdkv4Play;

package/dist/rsdkv4/rsdkv4.sdk.d.ts.map

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