@jolly-pixel/engine 1.0.0

package/dist/adapters/navigator.js

@@ -0,0 +1,9 @@
+export class BrowserNavigatorAdapter {
+    getGamepads() {
+        return navigator.getGamepads();
+    }
+    vibrate(pattern) {
+        return navigator.vibrate(pattern);
+    }
+}
+//# sourceMappingURL=navigator.js.map

package/dist/adapters/navigator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"navigator.js","sourceRoot":"","sources":["../../src/adapters/navigator.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,uBAAuB;IAClC,WAAW;QACT,OAAO,SAAS,CAAC,WAAW,EAAE,CAAC;IACjC,CAAC;IAED,OAAO,CACL,OAAuB;QAEvB,OAAO,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;CACF"}

package/dist/adapters/window.d.ts

@@ -0,0 +1,12 @@
+import type { EventTargetAdapter, EventTargetListener } from "./eventTarget.ts";
+import { type NavigatorAdapter } from "./navigator.ts";
+export interface WindowAdapter extends EventTargetAdapter {
+    onbeforeunload?: ((this: Window, ev: BeforeUnloadEvent) => any) | null;
+    navigator: NavigatorAdapter;
+}
+export declare class BrowserWindowAdapter implements WindowAdapter {
+    navigator: NavigatorAdapter;
+    addEventListener(type: string, listener: EventTargetListener): void;
+    removeEventListener(type: string, listener: EventTargetListener): void;
+}
+//# sourceMappingURL=window.d.ts.map

package/dist/adapters/window.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../../src/adapters/window.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,KAAK,gBAAgB,EAEtB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,aAAc,SAAQ,kBAAkB;IACvD,cAAc,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,iBAAiB,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC;IAEvE,SAAS,EAAE,gBAAgB,CAAC;CAC7B;AAED,qBAAa,oBAAqB,YAAW,aAAa;IACxD,SAAS,EAAE,gBAAgB,CAAiC;IAE5D,gBAAgB,CACd,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,mBAAmB;IAK/B,mBAAmB,CACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,mBAAmB;CAIhC"}

package/dist/adapters/window.js

@@ -0,0 +1,11 @@
+import { BrowserNavigatorAdapter } from "./navigator.js";
+export class BrowserWindowAdapter {
+    navigator = new BrowserNavigatorAdapter();
+    addEventListener(type, listener) {
+        window.addEventListener(type, listener);
+    }
+    removeEventListener(type, listener) {
+        window.removeEventListener(type, listener);
+    }
+}
+//# sourceMappingURL=window.js.map

package/dist/adapters/window.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"window.js","sourceRoot":"","sources":["../../src/adapters/window.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,uBAAuB,EACxB,MAAM,gBAAgB,CAAC;AAQxB,MAAM,OAAO,oBAAoB;IAC/B,SAAS,GAAqB,IAAI,uBAAuB,EAAE,CAAC;IAE5D,gBAAgB,CACd,IAAY,EACZ,QAA6B;QAE7B,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED,mBAAmB,CACjB,IAAY,EACZ,QAA6B;QAE7B,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/audio/AudioBackground.d.ts

@@ -0,0 +1,48 @@
+import * as THREE from "three";
+import type { AudioManager } from "./AudioManager.ts";
+import type { VolumeObserver } from "./GlobalAudio.ts";
+export type AudioBackgroundSoundIndex = [playlistIndex: number, trackIndex: number];
+export type AudioBackgroundSoundPath = `${string}.${string}`;
+export interface AudioBackgroundOptions {
+    audioManager: AudioManager;
+    playlists: AudioBackgroundPlaylist[];
+    autoPlay?: boolean | AudioBackgroundSoundPath | AudioBackgroundSoundIndex;
+    onError?: (error: Error) => void;
+}
+export interface AudioBackgroundPlaylist {
+    name: string;
+    tracks: AudioBackgroundTrack[];
+    /**
+     * @default "stop"
+     */
+    onEnd?: "loop" | "stop" | "play-next-playlist";
+    /**
+     * Ignored if `onEnd` is not equal to "play-next-playlist"
+     */
+    nextPlaylistName?: string;
+}
+export interface AudioBackgroundTrack {
+    name: string;
+    path: string;
+    /**
+     * @default 1
+     */
+    volume?: number;
+    metadata?: Record<string, any>;
+}
+export declare class AudioBackground implements VolumeObserver {
+    #private;
+    playlists: AudioBackgroundPlaylist[];
+    audio: null | THREE.Audio;
+    constructor(options: AudioBackgroundOptions);
+    onMasterVolumeChange(masterVolume: number): void;
+    get isPlaying(): boolean;
+    get isPaused(): boolean;
+    get track(): AudioBackgroundTrack | null;
+    play(pathOrIndex?: AudioBackgroundSoundPath | AudioBackgroundSoundIndex): Promise<void>;
+    playNext(): Promise<void>;
+    stop(): void;
+    pause(): void;
+    resume(): void;
+}
+//# sourceMappingURL=AudioBackground.d.ts.map

package/dist/audio/AudioBackground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioBackground.d.ts","sourceRoot":"","sources":["../../src/audio/AudioBackground.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EACV,YAAY,EACb,MAAM,mBAAmB,CAAC;AAC3B,OAAO,KAAK,EACV,cAAc,EACf,MAAM,kBAAkB,CAAC;AAE1B,MAAM,MAAM,yBAAyB,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;AACpF,MAAM,MAAM,wBAAwB,GAAG,GAAG,MAAM,IAAI,MAAM,EAAE,CAAC;AAE7D,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,YAAY,CAAC;IAE3B,SAAS,EAAE,uBAAuB,EAAE,CAAC;IACrC,QAAQ,CAAC,EAAE,OAAO,GAAG,wBAAwB,GAAG,yBAAyB,CAAC;IAC1E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,oBAAoB,CAAC;IAC/C;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,qBAAa,eAAgB,YAAW,cAAc;;IACpD,SAAS,EAAE,uBAAuB,EAAE,CAAM;IAC1C,KAAK,EAAE,IAAI,GAAG,KAAK,CAAC,KAAK,CAAQ;gBAO/B,OAAO,EAAE,sBAAsB;IAkBjC,oBAAoB,CAClB,YAAY,EAAE,MAAM;IA6DtB,IAAI,SAAS,YAEZ;IAED,IAAI,QAAQ,YAEX;IAED,IAAI,KAAK,IAAI,oBAAoB,GAAG,IAAI,CAMvC;IAEK,IAAI,CACR,WAAW,CAAC,EAAE,wBAAwB,GAAG,yBAAyB;IA+B9D,QAAQ;IAoDd,IAAI;IAQJ,KAAK;IAML,MAAM;CAKP"}

package/dist/audio/AudioBackground.js

@@ -0,0 +1,151 @@
+// Import Third-party Dependencies
+import * as THREE from "three";
+export class AudioBackground {
+    playlists = [];
+    audio = null;
+    #audioManager;
+    #onError;
+    #currentIndex = null;
+    constructor(options) {
+        const { playlists, autoPlay = false, audioManager, onError = (err) => console.error(err) } = options;
+        this.playlists = playlists;
+        this.#onError = onError;
+        this.#audioManager = audioManager;
+        if (autoPlay) {
+            this.play(typeof autoPlay === "boolean" ? [0, 0] : autoPlay)
+                .catch(this.#onError);
+        }
+    }
+    onMasterVolumeChange(masterVolume) {
+        if (!this.audio || this.#currentIndex === null) {
+            return;
+        }
+        const track = this.#getTrackByIndex(this.#currentIndex);
+        if (track) {
+            this.audio.setVolume((track.volume ?? 1) * masterVolume);
+        }
+    }
+    #getTrackIndexFromPath(path) {
+        const [playlistName, trackName] = path.split(".");
+        const playlistIndex = this.playlists.findIndex((playlist) => playlist.name === playlistName);
+        if (playlistIndex === -1) {
+            return null;
+        }
+        const trackIndex = this.playlists[playlistIndex].tracks.findIndex((track) => track.name === trackName);
+        if (trackIndex === -1) {
+            return null;
+        }
+        return [playlistIndex, trackIndex];
+    }
+    #getTrackByIndex(index) {
+        const [playlistIndex, trackIndex] = index;
+        return this.playlists[playlistIndex]?.tracks[trackIndex] ?? null;
+    }
+    #getTrackByPath(path) {
+        const [playlistName, trackName] = path.split(".");
+        const playlist = this.playlists.find((playlist) => playlist.name === playlistName);
+        if (!playlist) {
+            return null;
+        }
+        return playlist.tracks.find((track) => track.name === trackName) ?? null;
+    }
+    #getPlaylistByName(name) {
+        const playlist = this.playlists.find((playlist) => playlist.name === name) ?? null;
+        return playlist && playlist.tracks.length > 0 ? playlist : null;
+    }
+    get isPlaying() {
+        return Boolean(this.audio?.isPlaying);
+    }
+    get isPaused() {
+        return Boolean(this.audio && !this.audio.isPlaying);
+    }
+    get track() {
+        if (!this.#currentIndex) {
+            return null;
+        }
+        return this.#getTrackByIndex(this.#currentIndex);
+    }
+    async play(pathOrIndex) {
+        if (typeof pathOrIndex === "undefined") {
+            this.resume();
+            return;
+        }
+        const track = typeof pathOrIndex === "string"
+            ? this.#getTrackByPath(pathOrIndex)
+            : this.#getTrackByIndex(pathOrIndex);
+        if (!track) {
+            throw new Error(`Track not found: ${pathOrIndex}`);
+        }
+        this.#currentIndex = typeof pathOrIndex === "string"
+            ? this.#getTrackIndexFromPath(pathOrIndex)
+            : pathOrIndex;
+        if (this.audio) {
+            this.stop();
+        }
+        this.audio = await this.#audioManager.loadAudio(track.path, {
+            name: track.name,
+            volume: track.volume
+        });
+        this.audio.onEnded = () => this.playNext().catch(this.#onError);
+        this.audio.play();
+    }
+    async playNext() {
+        if (!this.#currentIndex) {
+            return;
+        }
+        const [playlistIndex, trackIndex] = this.#currentIndex;
+        const playlist = this.playlists[playlistIndex];
+        if (!playlist) {
+            return;
+        }
+        const isLastTrackInPlaylist = trackIndex === playlist.tracks.length - 1;
+        if (!isLastTrackInPlaylist) {
+            await this.play([playlistIndex, trackIndex + 1]);
+            return;
+        }
+        const onEnd = playlist.onEnd ?? "stop";
+        switch (onEnd) {
+            case "stop": {
+                this.stop();
+                break;
+            }
+            case "loop": {
+                await this.play([playlistIndex, 0]);
+                break;
+            }
+            case "play-next-playlist": {
+                const nextPlaylist = this.#getPlaylistByName(playlist.nextPlaylistName ?? "");
+                if (nextPlaylist) {
+                    const nextPlaylistIndex = this.playlists.findIndex((pl) => pl.name === nextPlaylist.name);
+                    await this.play([nextPlaylistIndex, 0]);
+                }
+                else {
+                    this.stop();
+                }
+                break;
+            }
+            default: {
+                const exhaustiveCheck = onEnd;
+                throw new Error(`Unhandled onEnd value: ${exhaustiveCheck}`);
+            }
+        }
+    }
+    stop() {
+        if (this.audio) {
+            this.#audioManager.destroyAudio(this.audio);
+            this.audio = null;
+        }
+        this.#currentIndex = null;
+    }
+    pause() {
+        if (this.audio && this.audio.isPlaying) {
+            this.audio.pause();
+        }
+    }
+    resume() {
+        if (this.audio && !this.audio.isPlaying) {
+            this.audio.play();
+        }
+    }
+}
+//# sourceMappingURL=AudioBackground.js.map

package/dist/audio/AudioBackground.js.map

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

package/dist/audio/AudioLibrary.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Store and manage audio assets.
+ */
+export declare class AudioLibrary {
+}
+//# sourceMappingURL=AudioLibrary.d.ts.map

package/dist/audio/AudioLibrary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioLibrary.d.ts","sourceRoot":"","sources":["../../src/audio/AudioLibrary.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,qBAAa,YAAY;CAExB"}

package/dist/audio/AudioLibrary.js

@@ -0,0 +1,6 @@
+/**
+ * Store and manage audio assets.
+ */
+export class AudioLibrary {
+}
+//# sourceMappingURL=AudioLibrary.js.map

package/dist/audio/AudioLibrary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioLibrary.js","sourceRoot":"","sources":["../../src/audio/AudioLibrary.ts"],"names":[],"mappings":"AACA;;GAEG;AACH,MAAM,OAAO,YAAY;CAExB"}

package/dist/audio/AudioManager.d.ts

@@ -0,0 +1,33 @@
+import * as THREE from "three";
+import type { GameInstance } from "../systems/GameInstance.ts";
+import { type AudioListenerAdapter } from "./internals/AudioListener.ts";
+import { type AudioFactory } from "./internals/AudioService.ts";
+export type AudioManager = {
+    loadAudio: (url: string, options?: AudioLoadingOptions) => Promise<THREE.Audio>;
+    loadPositionalAudio: (url: string, options?: AudioLoadingOptions) => Promise<THREE.PositionalAudio>;
+    destroyAudio: (audio: THREE.Audio | THREE.PositionalAudio) => void;
+};
+export interface AudioLoadingOptions {
+    name?: string;
+    /**
+     * @default false
+     */
+    loop?: boolean;
+    /**
+     * @default 1
+     */
+    volume?: number;
+}
+export interface GlobalAudioManagerOptions {
+    listener?: AudioListenerAdapter;
+    audioService?: AudioFactory;
+}
+export declare class GlobalAudioManager implements AudioManager {
+    #private;
+    static fromGameInstance(gameInstance: GameInstance): GlobalAudioManager;
+    constructor(options?: GlobalAudioManagerOptions);
+    loadAudio(url: string, options?: AudioLoadingOptions): Promise<THREE.Audio>;
+    loadPositionalAudio(url: string, options?: AudioLoadingOptions): Promise<THREE.PositionalAudio>;
+    destroyAudio(audio: THREE.Audio | THREE.PositionalAudio): void;
+}
+//# sourceMappingURL=AudioManager.d.ts.map

package/dist/audio/AudioManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioManager.d.ts","sourceRoot":"","sources":["../../src/audio/AudioManager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EACL,KAAK,oBAAoB,EAC1B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,6BAA6B,CAAC;AAMrC,MAAM,MAAM,YAAY,GAAG;IACzB,SAAS,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAChF,mBAAmB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACpG,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,eAAe,KAAK,IAAI,CAAC;CACpE,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,qBAAa,kBAAmB,YAAW,YAAY;;IAIrD,MAAM,CAAC,gBAAgB,CACrB,YAAY,EAAE,YAAY,GACzB,kBAAkB;gBAOnB,OAAO,GAAE,yBAA8B;IAyBnC,SAAS,CACb,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAOjB,mBAAmB,CACvB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC;IAOjC,YAAY,CACV,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,eAAe;CAQ7C"}

package/dist/audio/AudioManager.js

@@ -0,0 +1,47 @@
+// Import Third-party Dependencies
+import * as THREE from "three";
+import {} from "./internals/AudioListener.js";
+import { AudioService } from "./internals/AudioService.js";
+// CONSTANTS
+const kDefaultVolume = 1;
+const kDefaultLoop = false;
+export class GlobalAudioManager {
+    #listener;
+    #audioService;
+    static fromGameInstance(gameInstance) {
+        return new GlobalAudioManager({
+            listener: gameInstance.audio.listener
+        });
+    }
+    constructor(options = {}) {
+        const { listener = new THREE.AudioListener(), audioService = new AudioService({ listener }) } = options;
+        this.#listener = listener;
+        this.#audioService = audioService;
+    }
+    #configureAudio(audio, options) {
+        const { name, loop = kDefaultLoop, volume = kDefaultVolume } = options;
+        audio.setLoop(loop);
+        audio.setVolume(volume * this.#listener.getMasterVolume());
+        if (name) {
+            audio.name = name;
+        }
+    }
+    async loadAudio(url, options = {}) {
+        const audio = await this.#audioService.createAudio(url);
+        this.#configureAudio(audio, options);
+        return audio;
+    }
+    async loadPositionalAudio(url, options = {}) {
+        const audio = await this.#audioService.createPositionalAudio(url);
+        this.#configureAudio(audio, options);
+        return audio;
+    }
+    destroyAudio(audio) {
+        if (audio.isPlaying) {
+            audio.stop();
+        }
+        audio.disconnect();
+        audio.buffer = null;
+    }
+}
+//# sourceMappingURL=AudioManager.js.map

package/dist/audio/AudioManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioManager.js","sourceRoot":"","sources":["../../src/audio/AudioManager.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAI/B,OAAO,EAEN,MAAM,8BAA8B,CAAC;AACtC,OAAO,EACL,YAAY,EAEb,MAAM,6BAA6B,CAAC;AAErC,YAAY;AACZ,MAAM,cAAc,GAAG,CAAC,CAAC;AACzB,MAAM,YAAY,GAAG,KAAK,CAAC;AAyB3B,MAAM,OAAO,kBAAkB;IAC7B,SAAS,CAAuB;IAChC,aAAa,CAAe;IAE5B,MAAM,CAAC,gBAAgB,CACrB,YAA0B;QAE1B,OAAO,IAAI,kBAAkB,CAAC;YAC5B,QAAQ,EAAE,YAAY,CAAC,KAAK,CAAC,QAAQ;SACtC,CAAC,CAAC;IACL,CAAC;IAED,YACE,UAAqC,EAAE;QAEvC,MAAM,EACJ,QAAQ,GAAG,IAAI,KAAK,CAAC,aAAa,EAAE,EACpC,YAAY,GAAG,IAAI,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC,EAC9C,GAAG,OAAO,CAAC;QAEZ,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,aAAa,GAAG,YAAY,CAAC;IACpC,CAAC;IAED,eAAe,CACb,KAA0C,EAC1C,OAA4B;QAE5B,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,YAAY,EAAE,MAAM,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC;QAEvE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpB,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,CAAC,CAAC;QAE3D,IAAI,IAAI,EAAE,CAAC;YACT,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CACb,GAAW,EACX,UAA+B,EAAE;QAEjC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QACxD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAErC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,mBAAmB,CACvB,GAAW,EACX,UAA+B,EAAE;QAEjC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAC;QAClE,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAErC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,YAAY,CACV,KAA0C;QAE1C,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;YACpB,KAAK,CAAC,IAAI,EAAE,CAAC;QACf,CAAC;QACD,KAAK,CAAC,UAAU,EAAE,CAAC;QACnB,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;IACtB,CAAC;CACF"}

package/dist/audio/GlobalAudio.d.ts

@@ -0,0 +1,20 @@
+import * as THREE from "three";
+import { EventEmitter } from "@posva/event-emitter";
+import { type AudioListenerAdapter } from "./internals/AudioListener.ts";
+export type VolumeObserver = {
+    onMasterVolumeChange: (volume: number) => void;
+};
+export type GlobalAudioEvents = {
+    volumechange: [volume: number];
+};
+export declare class GlobalAudio extends EventEmitter<GlobalAudioEvents> {
+    #private;
+    listener: AudioListenerAdapter;
+    constructor(listenerAdapter?: AudioListenerAdapter);
+    get threeAudioListener(): THREE.AudioListener;
+    observe(observer: VolumeObserver): this;
+    unobserve(observer: VolumeObserver): this;
+    get volume(): number;
+    set volume(value: number);
+}
+//# sourceMappingURL=GlobalAudio.d.ts.map

package/dist/audio/GlobalAudio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalAudio.d.ts","sourceRoot":"","sources":["../../src/audio/GlobalAudio.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAEzE,MAAM,MAAM,cAAc,GAAG;IAC3B,oBAAoB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC,CAAC;AAEF,qBAAa,WAAY,SAAQ,YAAY,CAAC,iBAAiB,CAAC;;IAG9D,QAAQ,EAAE,oBAAoB,CAAC;gBAG7B,eAAe,CAAC,EAAE,oBAAoB;IAOxC,IAAI,kBAAkB,IACe,KAAK,CAAC,aAAa,CACvD;IAED,OAAO,CACL,QAAQ,EAAE,cAAc,GACvB,IAAI;IAQP,SAAS,CACP,QAAQ,EAAE,cAAc,GACvB,IAAI;IASP,IAAI,MAAM,IAKD,MAAM,CAHd;IAED,IAAI,MAAM,CACR,KAAK,EAAE,MAAM,EAWd;CACF"}

package/dist/audio/GlobalAudio.js

@@ -0,0 +1,41 @@
+// Import Third-party Dependencies
+import * as THREE from "three";
+import { EventEmitter } from "@posva/event-emitter";
+// Import Internal Dependencies
+import {} from "./internals/AudioListener.js";
+export class GlobalAudio extends EventEmitter {
+    #volumeObservers = [];
+    listener;
+    constructor(listenerAdapter) {
+        super();
+        this.listener = listenerAdapter ?? new THREE.AudioListener();
+    }
+    get threeAudioListener() {
+        return this.listener;
+    }
+    observe(observer) {
+        if (!this.#volumeObservers.includes(observer)) {
+            this.#volumeObservers.push(observer);
+        }
+        return this;
+    }
+    unobserve(observer) {
+        const index = this.#volumeObservers.indexOf(observer);
+        if (index !== -1) {
+            this.#volumeObservers.splice(index, 1);
+        }
+        return this;
+    }
+    get volume() {
+        return this.listener.getMasterVolume();
+    }
+    set volume(value) {
+        this.listener.setMasterVolume(THREE.MathUtils.clamp(value, 0, 1));
+        const newVolume = this.listener.getMasterVolume();
+        for (const observer of this.#volumeObservers) {
+            observer.onMasterVolumeChange(newVolume);
+        }
+        this.emit("volumechange", newVolume);
+    }
+}
+//# sourceMappingURL=GlobalAudio.js.map

package/dist/audio/GlobalAudio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GlobalAudio.js","sourceRoot":"","sources":["../../src/audio/GlobalAudio.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,+BAA+B;AAC/B,OAAO,EAA6B,MAAM,8BAA8B,CAAC;AAUzE,MAAM,OAAO,WAAY,SAAQ,YAA+B;IAC9D,gBAAgB,GAAqB,EAAE,CAAC;IAExC,QAAQ,CAAuB;IAE/B,YACE,eAAsC;QAEtC,KAAK,EAAE,CAAC;QAER,IAAI,CAAC,QAAQ,GAAG,eAAe,IAAI,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC;IAC/D,CAAC;IAED,IAAI,kBAAkB;QACpB,OAAO,IAAI,CAAC,QAA0C,CAAC;IACzD,CAAC;IAED,OAAO,CACL,QAAwB;QAExB,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CACP,QAAwB;QAExB,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtD,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;IACzC,CAAC;IAED,IAAI,MAAM,CACR,KAAa;QAEb,IAAI,CAAC,QAAQ,CAAC,eAAe,CAC3B,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CACnC,CAAC;QACF,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;QAClD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YAC7C,QAAQ,CAAC,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;IACvC,CAAC;CACF"}

package/dist/audio/internals/AudioBuffer.d.ts

@@ -0,0 +1,23 @@
+import * as THREE from "three";
+export interface AudioBufferCache {
+    get(key: string): AudioBuffer | undefined;
+    set(key: string, buffer: AudioBuffer): void;
+    has(key: string): boolean;
+    clear(): void;
+}
+export declare class InMemoryAudioBufferCache implements AudioBufferCache {
+    #private;
+    get(key: string): AudioBuffer | undefined;
+    set(key: string, buffer: AudioBuffer): void;
+    has(key: string): boolean;
+    clear(): void;
+}
+export interface AudioBufferLoader {
+    load(url: string): Promise<AudioBuffer>;
+}
+export declare class ThreeAudioBufferLoader implements AudioBufferLoader {
+    #private;
+    constructor(manager?: THREE.LoadingManager);
+    load(url: string): Promise<AudioBuffer>;
+}
+//# sourceMappingURL=AudioBuffer.d.ts.map

package/dist/audio/internals/AudioBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioBuffer.d.ts","sourceRoot":"","sources":["../../../src/audio/internals/AudioBuffer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAAC;IAC1C,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC5C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,qBAAa,wBAAyB,YAAW,gBAAgB;;IAG/D,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAI3C,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB,KAAK,IAAI,IAAI;CAGd;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACzC;AAED,qBAAa,sBAAuB,YAAW,iBAAiB;;gBAI5D,OAAO,CAAC,EAAE,KAAK,CAAC,cAAc;IAKhC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAOxC"}

package/dist/audio/internals/AudioBuffer.js

@@ -0,0 +1,28 @@
+// Import Third-party Dependencies
+import * as THREE from "three";
+export class InMemoryAudioBufferCache {
+    #cache = new Map();
+    get(key) {
+        return this.#cache.get(key);
+    }
+    set(key, buffer) {
+        this.#cache.set(key, buffer);
+    }
+    has(key) {
+        return this.#cache.has(key);
+    }
+    clear() {
+        this.#cache.clear();
+    }
+}
+export class ThreeAudioBufferLoader {
+    #manager;
+    constructor(manager) {
+        this.#manager = manager;
+    }
+    load(url) {
+        const audioLoader = new THREE.AudioLoader(this.#manager);
+        return audioLoader.loadAsync(url);
+    }
+}
+//# sourceMappingURL=AudioBuffer.js.map

package/dist/audio/internals/AudioBuffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioBuffer.js","sourceRoot":"","sources":["../../../src/audio/internals/AudioBuffer.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAS/B,MAAM,OAAO,wBAAwB;IACnC,MAAM,GAAG,IAAI,GAAG,EAAuB,CAAC;IAExC,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,MAAmB;QAClC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAC/B,CAAC;IAED,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK;QACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF;AAMD,MAAM,OAAO,sBAAsB;IACjC,QAAQ,CAAmC;IAE3C,YACE,OAA8B;QAE9B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;IAC1B,CAAC;IAED,IAAI,CAAC,GAAW;QACd,MAAM,WAAW,GAAG,IAAI,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEzD,OAAO,WAAW,CAAC,SAAS,CAC1B,GAAG,CACJ,CAAC;IACJ,CAAC;CACF"}

package/dist/audio/internals/AudioListener.d.ts

@@ -0,0 +1,5 @@
+export type AudioListenerAdapter = {
+    getMasterVolume: () => number;
+    setMasterVolume: (value: number) => void;
+};
+//# sourceMappingURL=AudioListener.d.ts.map

package/dist/audio/internals/AudioListener.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioListener.d.ts","sourceRoot":"","sources":["../../../src/audio/internals/AudioListener.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG;IACjC,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C,CAAC"}

package/dist/audio/internals/AudioListener.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=AudioListener.js.map

package/dist/audio/internals/AudioListener.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioListener.js","sourceRoot":"","sources":["../../../src/audio/internals/AudioListener.ts"],"names":[],"mappings":""}

package/dist/audio/internals/AudioService.d.ts

@@ -0,0 +1,19 @@
+import * as THREE from "three";
+import { type AudioBufferCache, type AudioBufferLoader } from "./AudioBuffer.ts";
+import type { AudioListenerAdapter } from "./AudioListener.ts";
+export interface AudioFactory {
+    createAudio(url: string): Promise<THREE.Audio>;
+    createPositionalAudio(url: string): Promise<THREE.PositionalAudio>;
+}
+export interface AudioServiceOptions {
+    listener?: AudioListenerAdapter;
+    cache?: AudioBufferCache;
+    loader?: AudioBufferLoader;
+}
+export declare class AudioService implements AudioFactory {
+    #private;
+    constructor(options: AudioServiceOptions);
+    createAudio(url: string): Promise<THREE.Audio>;
+    createPositionalAudio(url: string): Promise<THREE.PositionalAudio>;
+}
+//# sourceMappingURL=AudioService.d.ts.map

package/dist/audio/internals/AudioService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioService.d.ts","sourceRoot":"","sources":["../../../src/audio/internals/AudioService.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,EACL,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EAGvB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,MAAM,WAAW,YAAY;IAC3B,WAAW,CACT,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACxB,qBAAqB,CACnB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,MAAM,CAAC,EAAE,iBAAiB,CAAC;CAC5B;AAED,qBAAa,YAAa,YAAW,YAAY;;gBAM7C,OAAO,EAAE,mBAAmB;IA0BxB,WAAW,CACf,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC;IAWjB,qBAAqB,CACzB,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC;CAUlC"}

package/dist/audio/internals/AudioService.js

@@ -0,0 +1,36 @@
+// Import Third-party Dependencies
+import * as THREE from "three";
+// Import Internal Dependencies
+import { InMemoryAudioBufferCache, ThreeAudioBufferLoader } from "./AudioBuffer.js";
+export class AudioService {
+    #listener;
+    #cache;
+    #loader;
+    constructor(options) {
+        const { listener = new THREE.AudioListener(), cache = new InMemoryAudioBufferCache(), loader = new ThreeAudioBufferLoader() } = options;
+        this.#listener = listener;
+        this.#cache = cache;
+        this.#loader = loader;
+    }
+    async #loadAudioBuffer(url) {
+        if (this.#cache.has(url)) {
+            return this.#cache.get(url);
+        }
+        const buffer = await this.#loader.load(url);
+        this.#cache.set(url, buffer);
+        return buffer;
+    }
+    async createAudio(url) {
+        const buffer = await this.#loadAudioBuffer(url);
+        const audio = new THREE.Audio(this.#listener);
+        audio.setBuffer(buffer);
+        return audio;
+    }
+    async createPositionalAudio(url) {
+        const buffer = await this.#loadAudioBuffer(url);
+        const audio = new THREE.PositionalAudio(this.#listener);
+        audio.setBuffer(buffer);
+        return audio;
+    }
+}
+//# sourceMappingURL=AudioService.js.map

package/dist/audio/internals/AudioService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AudioService.js","sourceRoot":"","sources":["../../../src/audio/internals/AudioService.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAClC,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,+BAA+B;AAC/B,OAAO,EAGL,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,kBAAkB,CAAC;AAkB1B,MAAM,OAAO,YAAY;IACvB,SAAS,CAAuB;IAChC,MAAM,CAAmB;IACzB,OAAO,CAAoB;IAE3B,YACE,OAA4B;QAE5B,MAAM,EACJ,QAAQ,GAAG,IAAI,KAAK,CAAC,aAAa,EAAE,EACpC,KAAK,GAAG,IAAI,wBAAwB,EAAE,EACtC,MAAM,GAAG,IAAI,sBAAsB,EAAE,EACtC,GAAG,OAAO,CAAC;QAEZ,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,gBAAgB,CACpB,GAAW;QAEX,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;QAC/B,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;QAE7B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,WAAW,CACf,GAAW;QAEX,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAEhD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAC3B,IAAI,CAAC,SAA2C,CACjD,CAAC;QACF,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAExB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,qBAAqB,CACzB,GAAW;QAEX,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC;QAEhD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,eAAe,CACrC,IAAI,CAAC,SAA2C,CACjD,CAAC;QACF,KAAK,CAAC,SAAS,CAAC,MAAO,CAAC,CAAC;QAEzB,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/components/camera/Camera3DControls.d.ts

@@ -0,0 +1,31 @@
+import * as THREE from "three";
+import type { InputKeyboardAction } from "../../controls/types.ts";
+import type { MouseEventButton } from "../../controls/Input.class.ts";
+import { Actor } from "../../actor/Actor.ts";
+import { Behavior } from "../script/Behavior.ts";
+export interface Camera3DControlsOptions {
+    bindings?: {
+        forward?: InputKeyboardAction;
+        backward?: InputKeyboardAction;
+        left?: InputKeyboardAction;
+        right?: InputKeyboardAction;
+        up?: InputKeyboardAction;
+        down?: InputKeyboardAction;
+        lookAround?: Exclude<keyof typeof MouseEventButton, "scrollUp" | "scrollDown">;
+    };
+    maxRollUp?: number;
+    maxRollDown?: number;
+    rotationSpeed?: number;
+    speed?: number;
+}
+export declare class Camera3DControls extends Behavior {
+    #private;
+    camera: THREE.PerspectiveCamera;
+    maxRollUp: number;
+    maxRollDown: number;
+    constructor(actor: Actor, options?: Camera3DControlsOptions);
+    set speed(speed: number);
+    set rollSpeed(speed: number);
+    update(): void;
+}
+//# sourceMappingURL=Camera3DControls.d.ts.map

package/dist/components/camera/Camera3DControls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Camera3DControls.d.ts","sourceRoot":"","sources":["../../../src/components/camera/Camera3DControls.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,EAAE;QACT,OAAO,CAAC,EAAE,mBAAmB,CAAC;QAC9B,QAAQ,CAAC,EAAE,mBAAmB,CAAC;QAC/B,IAAI,CAAC,EAAE,mBAAmB,CAAC;QAC3B,KAAK,CAAC,EAAE,mBAAmB,CAAC;QAC5B,EAAE,CAAC,EAAE,mBAAmB,CAAC;QACzB,IAAI,CAAC,EAAE,mBAAmB,CAAC;QAC3B,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,OAAO,gBAAgB,EAAE,UAAU,GAAG,YAAY,CAAC,CAAC;KAChF,CAAC;IACF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,gBAAiB,SAAQ,QAAQ;;IAC5C,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC;IAGhC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;gBAKlB,KAAK,EAAE,KAAK,EACZ,OAAO,GAAE,uBAA4B;IAyBvC,IAAI,KAAK,CACP,KAAK,EAAE,MAAM,EAGd;IAED,IAAI,SAAS,CACX,KAAK,EAAE,MAAM,EAGd;IAgBD,MAAM;CAqCP"}