wasm-game-ts 0.1.0

package/README.md

@@ -0,0 +1,57 @@
+# wasm-game-ts
+
+Browser-first TypeScript framework for running a deterministic WASM game runtime in a WebWorker and rendering via OffscreenCanvas.
+
+## What it expects from the WASM module
+
+Exports (WASM -> host):
+- `init(random_seed: i32, module_hash: i32) -> i32`  (HostState* offset)
+- `update_start(input_bytes: i32) -> i32`            (returns ptr for host to write inputs)
+- `update_end(render_for_player: i32) -> void`       (process + produce render/audio/debug buffers)
+
+Imports (host -> WASM):
+- `env.get_file_bytes(id: i32, ptr: *mut u8) -> usize`
+
+## Render command buffer
+
+The worker renders a binary command buffer written by WASM. Command ids and layouts are defined in:
+`src/worker/renderer.ts`
+
+Rust should match these ids and field layouts exactly.
+
+## Local demo
+
+1) Build dist:
+```bash
+npm install
+npm run build
+```
+
+Run the dev server:
+```bash
+npm run dev
+```
+
+Open:
+
+http://localhost:5173/demo/index.html
+
+Click "Pick Package Folder" and select a folder containing:
+
+- your .wasm (built from your Rust code)
+- any assets you want (manifest is generated automatically by the folder picker)
+
+The demo will start the game and stream keyboard/mouse input for player_id=1.
+
+---
+
+### Commands to run
+
+From `wasm-game-ts/`:
+
+```bash
+npm install
+npm run build
+npm run dev
+# open http://localhost:5173/demo/index.html
+```

package/dist/hash.d.ts

@@ -0,0 +1,3 @@
+export declare function fnv1a32(bytes: Uint8Array): number;
+export declare function u64Hex(x: bigint): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AACA,wBAAgB,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAOjD;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAIxC"}

package/dist/hash.js

@@ -0,0 +1,15 @@
+// Deterministic FNV-1a 32-bit (module_hash input to wasm init).
+export function fnv1a32(bytes) {
+    let h = 0x811c9dc5; // offset basis
+    for (let i = 0; i < bytes.length; i++) {
+        h ^= bytes[i];
+        h = Math.imul(h, 0x01000193); // prime
+    }
+    return h | 0;
+}
+export function u64Hex(x) {
+    // Always 16 hex digits (64-bit)
+    const s = x.toString(16).padStart(16, '0');
+    return `0x${s}`;
+}
+//# sourceMappingURL=hash.js.map

package/dist/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,MAAM,UAAU,OAAO,CAAC,KAAiB;IACvC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,eAAe;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC;QACd,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ;IACxC,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,CAAS;IAC9B,gCAAgC;IAChC,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC3C,OAAO,KAAK,CAAC,EAAE,CAAC;AAClB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './hash.js';
+export * from './keycodes.js';
+export * from './inputs.js';
+export * from './package.js';
+export * from './wasm-game.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from './types.js';
+export * from './hash.js';
+export * from './keycodes.js';
+export * from './inputs.js';
+export * from './package.js';
+export * from './wasm-game.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC"}

package/dist/inputs.d.ts

@@ -0,0 +1,61 @@
+export declare enum InputType {
+    ButtonUp = 0,
+    ButtonDown = 1,
+    MouseMove = 2,
+    MouseWheel = 3,
+    Heartbeat = 4
+}
+export type InputEvent = {
+    type: InputType.ButtonUp;
+    button: number;
+} | {
+    type: InputType.ButtonDown;
+    button: number;
+} | {
+    type: InputType.MouseMove;
+    x: number;
+    y: number;
+} | {
+    type: InputType.MouseWheel;
+    x: number;
+    y: number;
+} | {
+    type: InputType.Heartbeat;
+};
+declare class ByteWriter {
+    private readonly buf;
+    private readonly view;
+    private off;
+    constructor(byteLength: number);
+    u8(v: number): void;
+    i32(v: number): void;
+    f32(v: number): void;
+    finish(): Uint8Array;
+}
+export declare class PlayerInput {
+    readonly playerId: number;
+    private _events;
+    constructor(playerId: number);
+    get events(): readonly InputEvent[];
+    keydown(key: number): void;
+    keyup(key: number): void;
+    mousemove(mouseX: number, mouseY: number): void;
+    mousebuttondown(button: number): void;
+    mousebuttonup(button: number): void;
+    mousewheel(dx: number, dy: number): void;
+    heartbeat(): void;
+    clear(): void;
+    clone(): PlayerInput;
+    toJson(): string;
+    static FromJson(str: string): PlayerInput;
+    byteLength(): number;
+    writeTo(w: ByteWriter): void;
+}
+export declare class FrameInput {
+    private _players;
+    add(playerInput: PlayerInput): void;
+    clear(): void;
+    toBytes(): Uint8Array;
+}
+export {};
+//# sourceMappingURL=inputs.d.ts.map

package/dist/inputs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inputs.d.ts","sourceRoot":"","sources":["../src/inputs.ts"],"names":[],"mappings":"AAAA,oBAAY,SAAS;IACnB,QAAQ,IAAI;IACZ,UAAU,IAAI;IACd,SAAS,IAAI;IACb,UAAU,IAAI;IACd,SAAS,IAAI;CACd;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,SAAS,CAAC,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,SAAS,CAAC,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE,SAAS,CAAC,UAAU,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,SAAS,CAAC,SAAS,CAAA;CAAE,CAAC;AAElC,cAAM,UAAU;IACd,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAW;IAChC,OAAO,CAAC,GAAG,CAAK;gBAEJ,UAAU,EAAE,MAAM;IAK9B,EAAE,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKnB,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKpB,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAKpB,MAAM,IAAI,UAAU;CAIrB;AAED,qBAAa,WAAW;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,OAAO,CAAoB;gBAEvB,QAAQ,EAAE,MAAM;IAI5B,IAAI,MAAM,IAAI,SAAS,UAAU,EAAE,CAElC;IAED,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAI1B,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIxB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/C,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAIrC,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAInC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAIxC,SAAS,IAAI,IAAI;IAIjB,KAAK,IAAI,IAAI;IAIb,KAAK,IAAI,WAAW;IAOpB,MAAM,IAAI,MAAM;IAIhB,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW;IAQzC,UAAU,IAAI,MAAM;IAiBpB,OAAO,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI;CAe7B;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAqB;IAErC,GAAG,CAAC,WAAW,EAAE,WAAW,GAAG,IAAI;IASnC,KAAK,IAAI,IAAI;IAIb,OAAO,IAAI,UAAU;CAQtB"}

package/dist/inputs.js

@@ -0,0 +1,143 @@
+export var InputType;
+(function (InputType) {
+    InputType[InputType["ButtonUp"] = 0] = "ButtonUp";
+    InputType[InputType["ButtonDown"] = 1] = "ButtonDown";
+    InputType[InputType["MouseMove"] = 2] = "MouseMove";
+    InputType[InputType["MouseWheel"] = 3] = "MouseWheel";
+    InputType[InputType["Heartbeat"] = 4] = "Heartbeat";
+})(InputType || (InputType = {}));
+class ByteWriter {
+    constructor(byteLength) {
+        this.off = 0;
+        this.buf = new ArrayBuffer(byteLength);
+        this.view = new DataView(this.buf);
+    }
+    u8(v) {
+        this.view.setUint8(this.off, v & 0xff);
+        this.off += 1;
+    }
+    i32(v) {
+        this.view.setInt32(this.off, v | 0, true);
+        this.off += 4;
+    }
+    f32(v) {
+        this.view.setFloat32(this.off, Number(v), true);
+        this.off += 4;
+    }
+    finish() {
+        // off should equal allocated size, but we return the used slice regardless.
+        return new Uint8Array(this.buf, 0, this.off);
+    }
+}
+export class PlayerInput {
+    constructor(playerId) {
+        this._events = [];
+        this.playerId = playerId | 0;
+    }
+    get events() {
+        return this._events;
+    }
+    keydown(key) {
+        this._events.push({ type: InputType.ButtonDown, button: key | 0 });
+    }
+    keyup(key) {
+        this._events.push({ type: InputType.ButtonUp, button: key | 0 });
+    }
+    mousemove(mouseX, mouseY) {
+        this._events.push({ type: InputType.MouseMove, x: Number(mouseX), y: Number(mouseY) });
+    }
+    mousebuttondown(button) {
+        this._events.push({ type: InputType.ButtonDown, button: button | 0 });
+    }
+    mousebuttonup(button) {
+        this._events.push({ type: InputType.ButtonUp, button: button | 0 });
+    }
+    mousewheel(dx, dy) {
+        this._events.push({ type: InputType.MouseWheel, x: Number(dx), y: Number(dy) });
+    }
+    heartbeat() {
+        this._events.push({ type: InputType.Heartbeat });
+    }
+    clear() {
+        this._events.length = 0;
+    }
+    clone() {
+        const p = new PlayerInput(this.playerId);
+        // deep-ish copy; events are tiny POJOs
+        p._events = this._events.map((e) => ({ ...e }));
+        return p;
+    }
+    toJson() {
+        return JSON.stringify({ playerId: this.playerId, events: this._events });
+    }
+    static FromJson(str) {
+        const obj = JSON.parse(str);
+        const p = new PlayerInput(obj.playerId | 0);
+        // Basic validation/coercion
+        p._events = Array.isArray(obj.events) ? obj.events.map((e) => ({ ...e })) : [];
+        return p;
+    }
+    byteLength() {
+        // Encoding is exactly as your Rust spec:
+        //   input_type: u8
+        //   player_id : i32
+        // + payload:
+        //   button up/down: i32 button
+        //   mouse move/wheel: f32 x, f32 y
+        //   heartbeat: nothing
+        let n = 0;
+        for (const e of this._events) {
+            if (e.type === InputType.ButtonUp || e.type === InputType.ButtonDown)
+                n += 1 + 4 + 4;
+            else if (e.type === InputType.MouseMove || e.type === InputType.MouseWheel)
+                n += 1 + 4 + 4 + 4;
+            else
+                n += 1 + 4;
+        }
+        return n;
+    }
+    writeTo(w) {
+        for (const e of this._events) {
+            w.u8(e.type);
+            w.i32(this.playerId);
+            if (e.type === InputType.ButtonUp || e.type === InputType.ButtonDown) {
+                w.i32(e.button | 0);
+            }
+            else if (e.type === InputType.MouseMove || e.type === InputType.MouseWheel) {
+                const mm = e;
+                w.f32(mm.x);
+                w.f32(mm.y);
+            }
+            else {
+                // Heartbeat: no extra payload
+            }
+        }
+    }
+}
+export class FrameInput {
+    constructor() {
+        this._players = [];
+    }
+    add(playerInput) {
+        // By copy, not by reference.
+        const cloned = playerInput.clone();
+        // Heartbeat default: if the player has no other events this frame,
+        // we add a heartbeat so "presence" is deterministic.
+        if (cloned.events.length === 0)
+            cloned.heartbeat();
+        this._players.push(cloned);
+    }
+    clear() {
+        this._players.length = 0;
+    }
+    toBytes() {
+        let total = 0;
+        for (const p of this._players)
+            total += p.byteLength();
+        const w = new ByteWriter(total);
+        for (const p of this._players)
+            p.writeTo(w);
+        return w.finish();
+    }
+}
+//# sourceMappingURL=inputs.js.map

package/dist/inputs.js.map

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

package/dist/keycodes.d.ts

@@ -0,0 +1,3 @@
+export declare function keycodeFromKeyboardEvent(ev: KeyboardEvent): number;
+export declare function mouseButtonFromPointerEvent(ev: MouseEvent | PointerEvent): number;
+//# sourceMappingURL=keycodes.d.ts.map

package/dist/keycodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keycodes.d.ts","sourceRoot":"","sources":["../src/keycodes.ts"],"names":[],"mappings":"AAGA,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,aAAa,GAAG,MAAM,CAmElE;AAED,wBAAgB,2BAA2B,CAAC,EAAE,EAAE,UAAU,GAAG,YAAY,GAAG,MAAM,CAOjF"}

package/dist/keycodes.js

@@ -0,0 +1,73 @@
+// Browser -> "X11 keysym-ish" mapping used by your Rust KeyCode enum.
+// For a first pass we support the common codes used by WASD + arrows etc.
+export function keycodeFromKeyboardEvent(ev) {
+    const code = ev.code;
+    // Letters: KeyA..KeyZ -> ASCII 'A'..'Z' (0x0041..)
+    if (code.startsWith('Key') && code.length === 4) {
+        const c = code.charCodeAt(3); // 'A'..'Z'
+        return c | 0;
+    }
+    // Digits: Digit0..Digit9 -> ASCII '0'..'9' (0x0030..)
+    if (code.startsWith('Digit') && code.length === 6) {
+        const d = code.charCodeAt(5); // '0'..'9'
+        return d | 0;
+    }
+    switch (code) {
+        case 'Space': return 0x0020;
+        case 'Comma': return 0x002c;
+        case 'Period': return 0x002e;
+        case 'Minus': return 0x002d;
+        case 'Equal': return 0x003d;
+        case 'Slash': return 0x002f;
+        case 'Semicolon': return 0x003b;
+        case 'Quote': return 0x0027;
+        case 'Backquote': return 0x0060;
+        case 'BracketLeft': return 0x005b;
+        case 'BracketRight': return 0x005d;
+        case 'Backslash': return 0x005c;
+        case 'Escape': return 0xff1b;
+        case 'Enter': return 0xff0d;
+        case 'Tab': return 0xff09;
+        case 'Backspace': return 0xff08;
+        case 'Insert': return 0xff63;
+        case 'Delete': return 0xffff;
+        case 'ArrowRight': return 0xff53;
+        case 'ArrowLeft': return 0xff51;
+        case 'ArrowDown': return 0xff54;
+        case 'ArrowUp': return 0xff52;
+        case 'PageUp': return 0xff55;
+        case 'PageDown': return 0xff56;
+        case 'Home': return 0xff50;
+        case 'End': return 0xff57;
+        case 'ShiftLeft': return 0xffe1;
+        case 'ShiftRight': return 0xffe2;
+        case 'ControlLeft': return 0xffe3;
+        case 'ControlRight': return 0xffe4;
+        case 'AltLeft': return 0xffe9;
+        case 'AltRight': return 0xffea;
+        case 'MetaLeft': return 0xffeb;
+        case 'MetaRight': return 0xffec;
+        case 'ContextMenu': return 0xff67;
+    }
+    // Fallback: attempt to map single-character keys (rarely used)
+    if (ev.key && ev.key.length === 1) {
+        const ch = ev.key.toUpperCase();
+        const cc = ch.charCodeAt(0);
+        if (cc >= 0x20 && cc <= 0x7e)
+            return cc;
+    }
+    // Unknown
+    return 0x01ff;
+}
+export function mouseButtonFromPointerEvent(ev) {
+    // DOM: 0 left, 1 middle, 2 right
+    const b = ev.button | 0;
+    if (b === 0)
+        return 0;
+    if (b === 1)
+        return 1;
+    if (b === 2)
+        return 2;
+    return 3;
+}
+//# sourceMappingURL=keycodes.js.map

package/dist/keycodes.js.map

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

package/dist/package.d.ts

@@ -0,0 +1,45 @@
+import type { PackageFileMeta, SerializedPackage } from './types.js';
+export interface PackageFile {
+    id: number;
+    path: string;
+    bytes: Uint8Array;
+    meta: PackageFileMeta;
+}
+export interface WorkerPayloadOptions {
+    transfer?: boolean;
+    wasmIdOverride?: number;
+}
+export declare class ImmutablePackage {
+    readonly files: readonly PackageFile[];
+    readonly wasmId: number;
+    private readonly byId;
+    private readonly byPath;
+    private constructor();
+    /** True if we can pick a folder in this browser (either API or webkitdirectory). */
+    static supportsFolderPicker(): boolean;
+    /** Safari/Brave-friendly folder picker: <input type="file" webkitdirectory multiple> */
+    private static pickFolderViaWebkitInput;
+    /**
+     * Build a package from a FileList (e.g. returned by webkitdirectory picker).
+     * This is also handy if you ever add an explicit <input webkitdirectory> in the demo HTML.
+     */
+    static fromFileList(fileList: FileList, options?: {
+        wasmPath?: string;
+    }): Promise<ImmutablePackage>;
+    listWasmFiles(): PackageFile[];
+    getById(id: number): PackageFile | undefined;
+    getByPath(path: string): PackageFile | undefined;
+    getBytesById(id: number): Uint8Array | null;
+    toWorkerPayload(opts?: WorkerPayloadOptions): {
+        pkg: SerializedPackage;
+        transferables: Transferable[];
+    };
+    static fromDirectoryPicker(options?: {
+        wasmPath?: string;
+    }): Promise<ImmutablePackage>;
+    static fromWasmFilePicker(): Promise<ImmutablePackage>;
+    static fromDirectoryHandle(dir: FileSystemDirectoryHandle, options?: {
+        wasmPath?: string;
+    }): Promise<ImmutablePackage>;
+}
+//# sourceMappingURL=package.d.ts.map

package/dist/package.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.d.ts","sourceRoot":"","sources":["../src/package.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAyB,MAAM,YAAY,CAAC;AAE5F,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAkTD,qBAAa,gBAAgB;IAC3B,QAAQ,CAAC,KAAK,EAAE,SAAS,WAAW,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA2B;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAElD,OAAO;IAQP,oFAAoF;IACpF,MAAM,CAAC,oBAAoB,IAAI,OAAO;IAYtC,wFAAwF;IACxF,OAAO,CAAC,MAAM,CAAC,wBAAwB;IAyFvC;;;OAGG;WACU,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAmK7G,aAAa,IAAI,WAAW,EAAE;IAI9B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI5C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIhD,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAK3C,eAAe,CAAC,IAAI,GAAE,oBAAyB,GAAG;QAAE,GAAG,EAAE,iBAAiB,CAAC;QAAC,aAAa,EAAE,YAAY,EAAE,CAAA;KAAE;WAmB9F,mBAAmB,CAAC,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;WAoCnF,kBAAkB,IAAI,OAAO,CAAC,gBAAgB,CAAC;WA4D/C,mBAAmB,CAAC,GAAG,EAAE,yBAAyB,EAAE,OAAO,GAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAiJjI"}