@blcklab/anyo-player 0.5.0

package/dist/internal/FrameworkAdapterController.d.ts

@@ -0,0 +1,46 @@
+import { AnyoPlayerError } from '../errors.js';
+import type { AnyoPlayer, AnyoPlayerEventMap, AnyoPlayerOptions, AnyoPlayerSource } from '../types.js';
+export type AnyoPlayerAdapterOptions = Omit<AnyoPlayerOptions, 'container' | 'canvas' | 'source'>;
+export type AnyoPlayerFactory = (options: AnyoPlayerOptions) => AnyoPlayer;
+export interface FrameworkAdapterCallbacks {
+    playerchange?: (player: AnyoPlayer | null) => void;
+    ready?: (event: AnyoPlayerEventMap['ready']) => void;
+    error?: (error: AnyoPlayerError) => void;
+    statechange?: (event: AnyoPlayerEventMap['statechange']) => void;
+    phasechange?: (event: AnyoPlayerEventMap['phasechange']) => void;
+    worldreplaced?: (event: AnyoPlayerEventMap['worldreplaced']) => void;
+    themechange?: (event: AnyoPlayerEventMap['themechange']) => void;
+    disposed?: () => void;
+}
+/**
+ * Shared lifecycle authority for framework adapters.
+ *
+ * The controller deliberately owns no rendering or input behavior. It only
+ * constructs the framework-neutral Player, forwards a small event surface,
+ * serializes source replacement, and awaits teardown between generations.
+ */
+export declare class FrameworkAdapterController {
+    private readonly factory;
+    private callbacks;
+    private playerValue;
+    private generation;
+    private sourceRevision;
+    private sourceValue;
+    private disposalPromise;
+    private sourceQueue;
+    private eventCleanups;
+    constructor(callbacks?: FrameworkAdapterCallbacks, factory?: AnyoPlayerFactory);
+    get player(): AnyoPlayer | null;
+    get source(): AnyoPlayerSource | null;
+    setCallbacks(callbacks: FrameworkAdapterCallbacks): void;
+    mount(container: HTMLElement, source: AnyoPlayerSource | null | undefined, options?: AnyoPlayerAdapterOptions): Promise<AnyoPlayer | null>;
+    requirePlayer(): Promise<AnyoPlayer>;
+    setSource(source: AnyoPlayerSource | null | undefined): Promise<void>;
+    load(source?: AnyoPlayerSource): Promise<void>;
+    activate(): Promise<void>;
+    replaceWorld(source: AnyoPlayerSource): Promise<void>;
+    disposeAsync(): Promise<void>;
+    private bindPlayerEvents;
+    private clearPlayerEvents;
+}
+//# sourceMappingURL=FrameworkAdapterController.d.ts.map

package/dist/internal/FrameworkAdapterController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FrameworkAdapterController.d.ts","sourceRoot":"","sources":["../../src/internal/FrameworkAdapterController.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAiB,MAAM,cAAc,CAAA;AAC7D,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,aAAa,CAAA;AAEpB,MAAM,MAAM,wBAAwB,GAAG,IAAI,CACzC,iBAAiB,EACjB,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAClC,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,EAAE,iBAAiB,KAAK,UAAU,CAAA;AAE1E,MAAM,WAAW,yBAAyB;IACxC,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAA;IAClD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC,KAAK,IAAI,CAAA;IACpD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;IACxC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,aAAa,CAAC,KAAK,IAAI,CAAA;IAChE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,aAAa,CAAC,KAAK,IAAI,CAAA;IAChE,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,eAAe,CAAC,KAAK,IAAI,CAAA;IACpE,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,CAAC,aAAa,CAAC,KAAK,IAAI,CAAA;IAChE,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAA;CACtB;AAMD;;;;;;GAMG;AACH,qBAAa,0BAA0B;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,SAAS,CAA2B;IAC5C,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,cAAc,CAAI;IAC1B,OAAO,CAAC,WAAW,CAAgC;IACnD,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,WAAW,CAAmC;IACtD,OAAO,CAAC,aAAa,CAAwB;gBAG3C,SAAS,GAAE,yBAA8B,EACzC,OAAO,GAAE,iBAAoC;IAM/C,IAAI,MAAM,IAAI,UAAU,GAAG,IAAI,CAE9B;IAED,IAAI,MAAM,IAAI,gBAAgB,GAAG,IAAI,CAEpC;IAED,YAAY,CAAC,SAAS,EAAE,yBAAyB,GAAG,IAAI;IAIlD,KAAK,CACT,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,EAC3C,OAAO,GAAE,wBAA6B,GACrC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAoCvB,aAAa,IAAI,OAAO,CAAC,UAAU,CAAC;IAU1C,SAAS,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAiC/D,IAAI,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAM9C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAKzB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3D,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC7B,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,iBAAiB;CAG1B"}

package/dist/internal/FrameworkAdapterController.js

@@ -0,0 +1,165 @@
+import { createAnyoPlayer } from '../createAnyoPlayer.js';
+import { AnyoPlayerError, toPlayerError } from '../errors.js';
+function hasSource(source) {
+    return source !== null && source !== undefined;
+}
+/**
+ * Shared lifecycle authority for framework adapters.
+ *
+ * The controller deliberately owns no rendering or input behavior. It only
+ * constructs the framework-neutral Player, forwards a small event surface,
+ * serializes source replacement, and awaits teardown between generations.
+ */
+export class FrameworkAdapterController {
+    factory;
+    callbacks;
+    playerValue = null;
+    generation = 0;
+    sourceRevision = 0;
+    sourceValue = null;
+    disposalPromise = null;
+    sourceQueue = Promise.resolve();
+    eventCleanups = [];
+    constructor(callbacks = {}, factory = createAnyoPlayer) {
+        this.callbacks = callbacks;
+        this.factory = factory;
+    }
+    get player() {
+        return this.playerValue;
+    }
+    get source() {
+        return this.sourceValue;
+    }
+    setCallbacks(callbacks) {
+        this.callbacks = callbacks;
+    }
+    async mount(container, source, options = {}) {
+        this.sourceValue = source ?? null;
+        if (this.playerValue)
+            return this.playerValue;
+        const generation = ++this.generation;
+        if (this.disposalPromise)
+            await this.disposalPromise;
+        if (generation !== this.generation)
+            return null;
+        let player;
+        try {
+            player = this.factory({
+                ...options,
+                container,
+                ...(hasSource(this.sourceValue) ? { source: this.sourceValue } : {}),
+            });
+        }
+        catch (cause) {
+            const error = toPlayerError(cause, 'PLAYER_INVALID_STATE', 'The framework adapter could not create Anyo Player.');
+            this.callbacks.error?.(error);
+            throw error;
+        }
+        if (generation !== this.generation) {
+            await player.disposeAsync();
+            return null;
+        }
+        this.playerValue = player;
+        this.bindPlayerEvents(player);
+        this.callbacks.playerchange?.(player);
+        return player;
+    }
+    async requirePlayer() {
+        if (this.playerValue)
+            return this.playerValue;
+        if (this.disposalPromise)
+            await this.disposalPromise;
+        if (this.playerValue)
+            return this.playerValue;
+        throw new AnyoPlayerError('PLAYER_INVALID_STATE', 'The framework adapter is not mounted.');
+    }
+    setSource(source) {
+        this.sourceValue = source ?? null;
+        const revision = ++this.sourceRevision;
+        const player = this.playerValue;
+        if (!player || !hasSource(this.sourceValue))
+            return Promise.resolve();
+        const nextSource = this.sourceValue;
+        const operation = this.sourceQueue
+            .catch(() => undefined)
+            .then(async () => {
+            if (revision !== this.sourceRevision ||
+                player !== this.playerValue ||
+                this.generation <= 0)
+                return;
+            try {
+                await player.replaceWorld(nextSource);
+            }
+            catch (cause) {
+                if (revision !== this.sourceRevision || player !== this.playerValue)
+                    return;
+                const error = toPlayerError(cause, 'PLAYER_WORLD_REPLACE_FAILED', 'The framework adapter could not replace the active Anyo world.');
+                this.callbacks.error?.(error);
+                throw error;
+            }
+        });
+        this.sourceQueue = operation;
+        return operation;
+    }
+    async load(source) {
+        if (source !== undefined)
+            this.sourceValue = source;
+        const player = await this.requirePlayer();
+        await player.load(source);
+    }
+    async activate() {
+        const player = await this.requirePlayer();
+        await player.activate();
+    }
+    async replaceWorld(source) {
+        this.sourceValue = source;
+        const player = await this.requirePlayer();
+        await player.replaceWorld(source);
+    }
+    disposeAsync() {
+        if (this.disposalPromise)
+            return this.disposalPromise;
+        ++this.generation;
+        ++this.sourceRevision;
+        const player = this.playerValue;
+        this.playerValue = null;
+        this.clearPlayerEvents();
+        this.callbacks.playerchange?.(null);
+        if (!player)
+            return Promise.resolve();
+        const disposal = player.disposeAsync()
+            .catch(cause => {
+            const error = toPlayerError(cause, 'PLAYER_DISPOSED', 'The framework adapter could not dispose Anyo Player cleanly.');
+            this.callbacks.error?.(error);
+        })
+            .then(() => {
+            this.callbacks.disposed?.();
+        })
+            .finally(() => {
+            if (this.disposalPromise === disposal)
+                this.disposalPromise = null;
+        });
+        this.disposalPromise = disposal;
+        return disposal;
+    }
+    bindPlayerEvents(player) {
+        this.clearPlayerEvents();
+        const forward = (event) => {
+            this.eventCleanups.push(player.on(event, payload => {
+                const callback = this.callbacks[event];
+                callback?.(payload);
+            }));
+        };
+        forward('ready');
+        forward('error');
+        forward('statechange');
+        forward('phasechange');
+        forward('worldreplaced');
+        forward('themechange');
+    }
+    clearPlayerEvents() {
+        for (const cleanup of this.eventCleanups.splice(0))
+            cleanup();
+    }
+}
+//# sourceMappingURL=FrameworkAdapterController.js.map

package/dist/internal/FrameworkAdapterController.js.map

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

package/dist/internal/FullscreenController.d.ts

@@ -0,0 +1,29 @@
+import { AnyoPlayerError } from '../errors.js';
+import type { AnyoPlayerFullscreenOptions } from '../types.js';
+export interface FullscreenControllerCallbacks {
+    onChange(fullscreen: boolean): void;
+    onError(error: AnyoPlayerError): void;
+}
+export declare class FullscreenController {
+    private readonly document;
+    private readonly target;
+    private readonly enabled;
+    private readonly callbacks;
+    private lastValue;
+    private requestPending;
+    private disposed;
+    constructor(container: HTMLElement, canvas: HTMLCanvasElement, options: false | AnyoPlayerFullscreenOptions | undefined, callbacks: FullscreenControllerCallbacks);
+    get fullscreen(): boolean;
+    get available(): boolean;
+    enter(): Promise<void>;
+    exit(): Promise<void>;
+    toggle(): Promise<void>;
+    dispose(): void;
+    private get fullscreenElement();
+    private assertUsable;
+    private emitChange;
+    private readonly handleChange;
+    private readonly handleNativeError;
+    private createFailure;
+}
+//# sourceMappingURL=FullscreenController.d.ts.map

package/dist/internal/FullscreenController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FullscreenController.d.ts","sourceRoot":"","sources":["../../src/internal/FullscreenController.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAC9C,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA;AAW9D,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,UAAU,EAAE,OAAO,GAAG,IAAI,CAAA;IACnC,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI,CAAA;CACtC;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA+B;IACzD,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAQ;gBAGtB,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,KAAK,GAAG,2BAA2B,GAAG,SAAS,EACxD,SAAS,EAAE,6BAA6B;IAc1C,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,IAAI,SAAS,IAAI,OAAO,CAKvB;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBrB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAK7B,OAAO,IAAI,IAAI;IAWf,OAAO,KAAK,iBAAiB,GAE5B;IAED,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,UAAU;IAOlB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAG5B;IAED,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAGjC;IAED,OAAO,CAAC,aAAa;CAOtB"}

package/dist/internal/FullscreenController.js

@@ -0,0 +1,122 @@
+import { AnyoPlayerError } from '../errors.js';
+export class FullscreenController {
+    document;
+    target;
+    enabled;
+    callbacks;
+    lastValue = false;
+    requestPending = false;
+    disposed = false;
+    constructor(container, canvas, options, callbacks) {
+        this.document = container.ownerDocument;
+        this.target = (options !== false && options?.target === 'canvas' ? canvas : container);
+        this.enabled = options !== false && options?.enabled !== false;
+        this.callbacks = callbacks;
+        if (this.enabled) {
+            this.document.addEventListener('fullscreenchange', this.handleChange);
+            this.document.addEventListener('fullscreenerror', this.handleNativeError);
+            this.document.addEventListener('webkitfullscreenchange', this.handleChange);
+            this.document.addEventListener('webkitfullscreenerror', this.handleNativeError);
+        }
+    }
+    get fullscreen() {
+        return this.fullscreenElement === this.target;
+    }
+    get available() {
+        return this.enabled && (typeof this.target.requestFullscreen === 'function'
+            || typeof this.target.webkitRequestFullscreen === 'function');
+    }
+    async enter() {
+        this.assertUsable();
+        if (this.fullscreen)
+            return;
+        const request = this.target.requestFullscreen?.bind(this.target)
+            ?? this.target.webkitRequestFullscreen?.bind(this.target);
+        if (!request) {
+            throw new AnyoPlayerError('PLAYER_FULLSCREEN_UNAVAILABLE', 'Fullscreen is not available for this Anyo Player in the current browser or embedding context.');
+        }
+        this.requestPending = true;
+        try {
+            await request();
+            this.emitChange();
+        }
+        catch (cause) {
+            throw this.createFailure(cause);
+        }
+        finally {
+            this.requestPending = false;
+        }
+    }
+    async exit() {
+        this.assertUsable();
+        if (!this.fullscreen)
+            return;
+        const exit = this.document.exitFullscreen?.bind(this.document)
+            ?? this.document.webkitExitFullscreen?.bind(this.document);
+        if (!exit) {
+            const error = new AnyoPlayerError('PLAYER_FULLSCREEN_UNAVAILABLE', 'The browser cannot exit fullscreen for this Anyo Player.');
+            this.callbacks.onError(error);
+            throw error;
+        }
+        this.requestPending = true;
+        try {
+            await exit();
+            this.emitChange();
+        }
+        catch (cause) {
+            throw this.createFailure(cause);
+        }
+        finally {
+            this.requestPending = false;
+        }
+    }
+    async toggle() {
+        if (this.fullscreen)
+            await this.exit();
+        else
+            await this.enter();
+    }
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        if (this.enabled) {
+            this.document.removeEventListener('fullscreenchange', this.handleChange);
+            this.document.removeEventListener('fullscreenerror', this.handleNativeError);
+            this.document.removeEventListener('webkitfullscreenchange', this.handleChange);
+            this.document.removeEventListener('webkitfullscreenerror', this.handleNativeError);
+        }
+    }
+    get fullscreenElement() {
+        return this.document.fullscreenElement ?? this.document.webkitFullscreenElement ?? null;
+    }
+    assertUsable() {
+        if (this.disposed) {
+            throw new AnyoPlayerError('PLAYER_DISPOSED', 'Anyo Player fullscreen controls were disposed.');
+        }
+        if (!this.enabled) {
+            throw new AnyoPlayerError('PLAYER_FULLSCREEN_UNAVAILABLE', 'Fullscreen is disabled for this Anyo Player.');
+        }
+    }
+    emitChange() {
+        const fullscreen = this.fullscreen;
+        if (fullscreen === this.lastValue)
+            return;
+        this.lastValue = fullscreen;
+        this.callbacks.onChange(fullscreen);
+    }
+    handleChange = () => {
+        if (this.disposed)
+            return;
+        this.emitChange();
+    };
+    handleNativeError = (event) => {
+        if (this.disposed || this.requestPending)
+            return;
+        this.callbacks.onError(this.createFailure(event));
+    };
+    createFailure(cause) {
+        return new AnyoPlayerError('PLAYER_FULLSCREEN_FAILED', 'Anyo Player could not change fullscreen mode. Check browser permissions and iframe allow policies.', { cause });
+    }
+}
+//# sourceMappingURL=FullscreenController.js.map

package/dist/internal/FullscreenController.js.map

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

package/dist/internal/GamepadController.d.ts

@@ -0,0 +1,54 @@
+import type { AnyoPlayerGamepadOptions, AnyoPlayerGamepadState, AnyoPlayerInputAction, AnyoPlayerInputBindingMap } from '../types.js';
+import type { ExplorationInputTarget } from './DesktopInputController.js';
+interface GamepadControllerCallbacks {
+    onEnterRequest(index: number): boolean;
+    onExitRequest(): void;
+    onAction(action: 'interact' | 'pause'): void;
+    onActionValue(action: AnyoPlayerInputAction, value: number, pressed: boolean): void;
+    onGamepadsChange(gamepads: readonly AnyoPlayerGamepadState[], activeGamepad: number | null): void;
+    onWarning(message: string): void;
+}
+export declare class GamepadController {
+    private readonly callbacks;
+    private readonly window;
+    private readonly navigator;
+    private bindings;
+    private target;
+    private active;
+    private disposed;
+    private frameHandle;
+    private gamepadsValue;
+    private activeGamepadValue;
+    private reportedActiveGamepadValue;
+    private previousActions;
+    private lastTimestamp;
+    private awaitNeutral;
+    private readonly enabledValue;
+    private readonly requestedIndex;
+    private readonly deadZone;
+    private lookSensitivity;
+    private invertY;
+    constructor(canvas: HTMLCanvasElement, options: boolean | AnyoPlayerGamepadOptions | undefined, bindings: AnyoPlayerInputBindingMap, callbacks: GamepadControllerCallbacks);
+    get enabled(): boolean;
+    get entered(): boolean;
+    get gamepads(): readonly AnyoPlayerGamepadState[];
+    get activeGamepad(): number | null;
+    setLookSettings(scale: number, invertY: boolean): void;
+    configure(bindings: AnyoPlayerInputBindingMap): void;
+    bind(target: ExplorationInputTarget): void;
+    unbind(): void;
+    activate(index: number): boolean;
+    deactivate(): void;
+    pollNow(timestamp?: number): void;
+    dispose(): void;
+    private emitGamepadsChange;
+    private actionValue;
+    private selectGamepad;
+    private install;
+    private uninstall;
+    private readonly handleConnection;
+    private schedule;
+    private cancelSchedule;
+}
+export {};
+//# sourceMappingURL=GamepadController.d.ts.map

package/dist/internal/GamepadController.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GamepadController.d.ts","sourceRoot":"","sources":["../../src/internal/GamepadController.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EAErB,yBAAyB,EAC1B,MAAM,aAAa,CAAA;AACpB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAA;AAEzE,UAAU,0BAA0B;IAClC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;IACtC,aAAa,IAAI,IAAI,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,IAAI,CAAA;IAC5C,aAAa,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IACnF,gBAAgB,CAAC,QAAQ,EAAE,SAAS,sBAAsB,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAA;IACjG,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CACjC;AAwDD,qBAAa,iBAAiB;IAwB1B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAvB5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;IAC/C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;IACnD,OAAO,CAAC,QAAQ,CAA2B;IAC3C,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,WAAW,CAAsB;IACzC,OAAO,CAAC,aAAa,CAAwC;IAC7D,OAAO,CAAC,kBAAkB,CAAsB;IAChD,OAAO,CAAC,0BAA0B,CAA2B;IAC7D,OAAO,CAAC,eAAe,CAA2C;IAClE,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,YAAY,CAAQ;IAC5B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAQ;IACjC,OAAO,CAAC,eAAe,CAAQ;IAC/B,OAAO,CAAC,OAAO,CAAQ;gBAGrB,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,OAAO,GAAG,wBAAwB,GAAG,SAAS,EACvD,QAAQ,EAAE,yBAAyB,EAClB,SAAS,EAAE,0BAA0B;IAaxD,IAAI,OAAO,IAAI,OAAO,CAA6B;IACnD,IAAI,OAAO,IAAI,OAAO,CAAuB;IAC7C,IAAI,QAAQ,IAAI,SAAS,sBAAsB,EAAE,CAA2D;IAC5G,IAAI,aAAa,IAAI,MAAM,GAAG,IAAI,CAAmC;IAErE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAKtD,SAAS,CAAC,QAAQ,EAAE,yBAAyB,GAAG,IAAI;IAKpD,IAAI,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAS1C,MAAM,IAAI,IAAI;IAMd,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAUhC,UAAU,IAAI,IAAI;IAYlB,OAAO,CAAC,SAAS,SAAa,GAAG,IAAI;IA+ErC,OAAO,IAAI,IAAI;IAWf,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,WAAW;IAiBnB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,OAAO;IAKf,OAAO,CAAC,SAAS;IAKjB,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAEhC;IAED,OAAO,CAAC,QAAQ;IAUhB,OAAO,CAAC,cAAc;CAKvB"}