@phalanx-engine/client 0.1.0

package/dist/SocketManager.js

@@ -0,0 +1,584 @@
+/**
+ * SocketManager - Manages socket.io connection and event handling
+ *
+ * Handles:
+ * - Connection/disconnection to server
+ * - Socket event routing
+ * - Reconnection logic with retries
+ * - Connection state tracking
+ */
+import { io } from 'socket.io-client';
+/**
+ * SocketManager - Handles socket.io connection and event handling
+ */
+export class SocketManager {
+    socket = null;
+    config;
+    callbacks;
+    connectionState = 'disconnected';
+    reconnectAttempts = 0;
+    constructor(config, callbacks) {
+        this.config = config;
+        this.callbacks = callbacks;
+    }
+    // ============================================
+    // CONNECTION
+    // ============================================
+    /**
+     * Connect to the server
+     */
+    async connect() {
+        if (this.connectionState === 'connected') {
+            return;
+        }
+        this.connectionState = 'connecting';
+        return new Promise((resolve, reject) => {
+            const timeout = setTimeout(() => {
+                this.socket?.disconnect();
+                this.connectionState = 'disconnected';
+                reject(new Error('Connection timeout'));
+            }, this.config.connectionTimeoutMs);
+            this.socket = io(this.config.serverUrl, {
+                forceNew: true,
+                transports: [...this.config.socketTransports],
+                reconnection: false, // We handle reconnection ourselves
+                auth: this.config.authToken
+                    ? { token: this.config.authToken }
+                    : undefined,
+            });
+            this.socket.on('connect', () => {
+                clearTimeout(timeout);
+                this.connectionState = 'connected';
+                this.reconnectAttempts = 0;
+                this.setupEventHandlers();
+                this.callbacks.onConnected();
+                resolve();
+            });
+            this.socket.on('connect_error', (error) => {
+                clearTimeout(timeout);
+                this.connectionState = 'disconnected';
+                reject(new Error(`Connection failed: ${error.message}`));
+            });
+        });
+    }
+    /**
+     * Disconnect from the server
+     */
+    disconnect() {
+        if (this.socket) {
+            this.socket.removeAllListeners();
+            this.socket.disconnect();
+            this.socket = null;
+        }
+        this.connectionState = 'disconnected';
+    }
+    /**
+     * Check if connected
+     */
+    isConnected() {
+        return (this.connectionState === 'connected' && this.socket?.connected === true);
+    }
+    /**
+     * Get connection state
+     */
+    getConnectionState() {
+        return this.connectionState;
+    }
+    /**
+     * Update player credentials (after auth)
+     */
+    updateCredentials(playerId, username, authToken) {
+        this.config.playerId = playerId;
+        this.config.username = username;
+        this.config.authToken = authToken;
+    }
+    // ============================================
+    // QUEUE OPERATIONS
+    // ============================================
+    /**
+     * Join the matchmaking queue
+     */
+    async joinQueue() {
+        this.ensureConnected();
+        return new Promise((resolve, reject) => {
+            const errorHandler = (error) => {
+                this.socket?.off('queue-status', statusHandler);
+                reject(new Error(error.message));
+            };
+            const statusHandler = (status) => {
+                this.socket?.off('queue-error', errorHandler);
+                resolve(status);
+            };
+            this.socket.once('queue-status', statusHandler);
+            this.socket.once('queue-error', errorHandler);
+            this.socket.emit('queue-join', {
+                playerId: this.config.playerId,
+                username: this.config.username,
+            });
+        });
+    }
+    /**
+     * Leave the matchmaking queue
+     */
+    leaveQueue() {
+        this.ensureConnected();
+        this.socket.emit('queue-leave', {
+            playerId: this.config.playerId,
+        });
+    }
+    // ============================================
+    // PRIVATE ROOM OPERATIONS
+    // ============================================
+    /**
+     * Create a private room. Resolves with the room code.
+     */
+    async createRoom(gameType) {
+        this.ensureConnected();
+        return new Promise((resolve, reject) => {
+            const errorHandler = (error) => {
+                this.socket?.off('room-created', createdHandler);
+                reject(new Error(error.message));
+            };
+            const createdHandler = (event) => {
+                this.socket?.off('room-error', errorHandler);
+                resolve(event);
+            };
+            this.socket.once('room-created', createdHandler);
+            this.socket.once('room-error', errorHandler);
+            this.socket.emit('room-create', {
+                playerId: this.config.playerId,
+                username: this.config.username,
+                gameType,
+            });
+        });
+    }
+    /**
+     * Join an existing private room by code.
+     * After joining, the server will emit match-found to both players.
+     */
+    joinRoom(code) {
+        this.ensureConnected();
+        this.socket.emit('room-join', {
+            playerId: this.config.playerId,
+            username: this.config.username,
+            code,
+        });
+    }
+    /**
+     * Cancel a previously created private room.
+     */
+    cancelRoom() {
+        this.ensureConnected();
+        this.socket.emit('room-cancel');
+    }
+    /**
+     * Reclaim a private room after the underlying socket was briefly torn
+     * down and reconnected.
+     *
+     * This is the client half of the host-disconnect grace-period contract
+     * introduced server-side in PR #18 and extended with countdown/game-start
+     * snapshotting in PR #19: the server holds the room (and, if the guest
+     * already joined, the running match) open for `HOST_DISCONNECT_GRACE_MS`
+     * so the host's new socket can reclaim it via `room-recover`.
+     *
+     * Typical trigger: a mobile browser kills the WebSocket when the user
+     * switches to a messenger to share the invite link, then re-opens the
+     * tab. The caller (Game / UI layer) should listen for `visibilitychange`
+     * and, when the tab becomes visible again and the socket is dead, call
+     * `connect()` followed by `recoverRoom(code)`.
+     *
+     * Resolves with the `RoomRecoveredEvent` on success. Rejects with the
+     * server's error message on `room-error`, or with `'Recover timeout'`
+     * if the server never answers within `timeoutMs` (default 10 s). The
+     * timeout is important because a stubbornly flaky connection can cause
+     * `socket.emit` to succeed locally but never round-trip — we must not
+     * leave the host hanging on a dead promise while their countdown UI
+     * stays frozen.
+     */
+    async recoverRoom(code, timeoutMs = this.config.recoverRoomTimeoutMs) {
+        this.ensureConnected();
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            const cleanup = () => {
+                this.socket?.off('room-recovered', recoveredHandler);
+                this.socket?.off('room-error', errorHandler);
+                clearTimeout(timer);
+            };
+            const recoveredHandler = (event) => {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                resolve(event);
+            };
+            const errorHandler = (error) => {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                reject(new Error(error.message));
+            };
+            const timer = setTimeout(() => {
+                if (settled)
+                    return;
+                settled = true;
+                cleanup();
+                reject(new Error('Recover timeout'));
+            }, timeoutMs);
+            this.socket.once('room-recovered', recoveredHandler);
+            this.socket.once('room-error', errorHandler);
+            this.socket.emit('room-recover', {
+                playerId: this.config.playerId,
+                username: this.config.username,
+                code,
+            });
+        });
+    }
+    /**
+     * Register a handler for room-recovered events. Exposed alongside the
+     * one-shot `recoverRoom` promise so callers that want to observe
+     * recoveries initiated elsewhere (e.g. for analytics) can do so.
+     */
+    onRoomRecovered(handler) {
+        this.socket?.on('room-recovered', handler);
+    }
+    /**
+     * Register a handler for room-expired events.
+     */
+    onRoomExpired(handler) {
+        this.socket?.on('room-expired', handler);
+    }
+    /**
+     * Register a handler for room-cancelled events.
+     */
+    onRoomCancelled(handler) {
+        this.socket?.on('room-cancelled', handler);
+    }
+    /**
+     * Wait for match found event
+     */
+    async waitForMatch() {
+        this.ensureConnected();
+        return new Promise((resolve) => {
+            this.socket.once('match-found', (data) => {
+                resolve(data);
+            });
+        });
+    }
+    /**
+     * Wait for countdown to complete
+     */
+    async waitForCountdown(onCountdown) {
+        this.ensureConnected();
+        return new Promise((resolve) => {
+            const countdownHandler = (data) => {
+                this.callbacks.onCountdown(data);
+                onCountdown?.(data);
+                if (data.seconds === 0) {
+                    this.socket?.off('countdown', countdownHandler);
+                    resolve();
+                }
+            };
+            this.socket.on('countdown', countdownHandler);
+        });
+    }
+    /**
+     * Wait for game start event
+     */
+    async waitForGameStart() {
+        this.ensureConnected();
+        return new Promise((resolve) => {
+            this.socket.once('game-start', (data) => {
+                resolve(data);
+            });
+        });
+    }
+    // ============================================
+    // COMMANDS
+    // ============================================
+    /**
+     * Submit commands with acknowledgment
+     */
+    async submitCommands(tick, commands) {
+        this.ensureConnected();
+        return new Promise((resolve) => {
+            this.socket.once('submit-commands-ack', (ack) => {
+                resolve(ack);
+            });
+            this.socket.emit('submit-commands', { tick, commands });
+        });
+    }
+    /**
+     * Submit commands without acknowledgment (fire and forget)
+     */
+    submitCommandsAsync(tick, commands) {
+        this.ensureConnected();
+        this.socket.emit('submit-commands', { tick, commands });
+    }
+    /**
+     * Send state hash for desync detection
+     * @param tick - The tick this hash is for
+     * @param hash - The state hash string
+     */
+    sendStateHash(tick, hash) {
+        this.ensureConnected();
+        this.socket.emit('state-hash', { tick, hash });
+    }
+    /**
+     * Send a pause-game request to the server (fire-and-forget)
+     */
+    sendPauseGame() {
+        this.ensureConnected();
+        this.socket.emit('pause-game');
+    }
+    /**
+     * Send a resume-game request to the server (fire-and-forget)
+     */
+    sendResumeGame() {
+        this.ensureConnected();
+        this.socket.emit('resume-game');
+    }
+    /**
+     * Notify the server that this client has finished loading and is ready to receive ticks.
+     */
+    sendReady() {
+        this.ensureConnected();
+        this.socket.emit('client-ready');
+    }
+    // ============================================
+    // RECONNECTION
+    // ============================================
+    /**
+     * Reconnect to a specific match
+     */
+    async reconnectToMatch(matchId) {
+        this.ensureConnected();
+        return new Promise((resolve, reject) => {
+            const statusHandler = (status) => {
+                this.callbacks.onReconnectStatus(status);
+                if (!status.success) {
+                    this.socket?.off('reconnect-state', stateHandler);
+                    reject(new Error(status.reason || 'Reconnection failed'));
+                }
+            };
+            const stateHandler = (state) => {
+                this.socket?.off('reconnect-status', statusHandler);
+                // Do NOT invoke `callbacks.onReconnectState` here — the global
+                // `reconnect-state` handler registered in `setupEventHandlers`
+                // already fires for this same message. Calling it twice would
+                // drive downstream state updates (and any synthetic countdown /
+                // game-start replays) through the client twice per server event.
+                resolve(state);
+            };
+            this.socket.once('reconnect-status', statusHandler);
+            this.socket.once('reconnect-state', stateHandler);
+            this.socket.emit('reconnect-match', {
+                playerId: this.config.playerId,
+                matchId,
+            });
+        });
+    }
+    /**
+     * Attempt automatic reconnection with retries
+     */
+    async attemptReconnection() {
+        if (!this.config.autoReconnect) {
+            throw new Error('Auto-reconnect is disabled');
+        }
+        const savedMatchId = this.callbacks.getCurrentMatchId();
+        this.connectionState = 'reconnecting';
+        while (this.reconnectAttempts < this.config.maxReconnectAttempts) {
+            this.reconnectAttempts++;
+            this.callbacks.onReconnecting(this.reconnectAttempts);
+            try {
+                await this.delay(this.config.reconnectDelayMs);
+                await this.connect();
+                if (savedMatchId) {
+                    await this.reconnectToMatch(savedMatchId);
+                }
+                return;
+            }
+            catch {
+                // Continue to next attempt
+            }
+        }
+        this.callbacks.onReconnectFailed();
+        throw new Error('Max reconnection attempts reached');
+    }
+    // ============================================
+    // PRIVATE METHODS
+    // ============================================
+    setupEventHandlers() {
+        if (!this.socket)
+            return;
+        if (this.config.debug) { }
+        // Match found
+        this.socket.on('match-found', (data) => {
+            if (this.config.debug) { }
+            this.callbacks.onMatchFound(data);
+        });
+        // Game start
+        this.socket.on('game-start', (data) => {
+            if (this.config.debug) { }
+            this.callbacks.onGameStart(data);
+        });
+        // Countdown
+        this.socket.on('countdown', (data) => {
+            if (this.config.debug) { }
+            this.callbacks.onCountdown(data);
+        });
+        // Tick synchronization
+        this.socket.on('tick-sync', (data) => {
+            this.callbacks.onTickSync(data);
+        });
+        // Commands batch
+        this.socket.on('commands-batch', (data) => {
+            this.callbacks.onCommandsBatch(data);
+        });
+        // Player events
+        this.socket.on('player-disconnected', (data) => {
+            this.callbacks.onPlayerDisconnected(data);
+        });
+        this.socket.on('player-reconnected', (data) => {
+            this.callbacks.onPlayerReconnected(data);
+        });
+        this.socket.on('player-ready', (data) => {
+            this.callbacks.onPlayerReady(data);
+        });
+        // Match end
+        this.socket.on('match-end', (data) => {
+            this.callbacks.onMatchEnd(data);
+        });
+        // Reconnect-state — unlike `reconnectToMatch` which attaches a
+        // one-shot listener for the explicit reconnect flow, this global
+        // handler catches snapshots delivered out-of-band, e.g. by the
+        // private-room host-recover path where the client initiates
+        // `room-recover` and the server proactively emits reconnect-state
+        // to wire the socket back into a match that started while the host
+        // was offline.
+        //
+        // When the snapshot reports an in-flight countdown or an already
+        // emitted `game-start`, we fan it out through the same `countdown`
+        // / `game-start` callbacks the normal lifecycle uses, so client
+        // code that blocks on `waitForCountdown` / `waitForGameStart`
+        // wakes up instead of hanging forever waiting for events that
+        // were broadcast while the socket was dead.
+        this.socket.on('reconnect-state', (data) => {
+            this.callbacks.onReconnectState(data);
+            // Fan the snapshot out through the same socket event bus that
+            // `setupEventHandlers` and `waitForCountdown`/`waitForGameStart`
+            // listen on. Using `socket.emit` against the local socket would
+            // send to the server, not the local listeners — socket.io-client
+            // has no public "emit-to-self", so we replay through every
+            // registered listener instead. This wakes callers blocked in
+            // `waitForCountdown` / `waitForGameStart` on top of firing the
+            // normal callback hooks.
+            if (typeof data.countdownSecondsRemaining === 'number' &&
+                data.countdownSecondsRemaining >= 0) {
+                this.emitSyntheticLocal('countdown', {
+                    seconds: data.countdownSecondsRemaining,
+                });
+            }
+            // Only synthesize `game-start` when the snapshot shows the client
+            // is still in a pre-play phase. For an in-progress match (state
+            // `playing` / `paused` / `finished`) the caller is doing a normal
+            // mid-match reconnect, and PhalanxClient's `onGameStart` callback
+            // would reset `currentTick` to 0 — clobbering the authoritative
+            // tick that `onReconnectState` just applied. In that case the
+            // client is already past the game-start transition, so there's
+            // nothing to replay.
+            if (data.gameStartEmitted === true &&
+                (data.state === 'countdown' || data.state === 'waiting-for-ready')) {
+                const gameStart = {
+                    matchId: data.matchId,
+                    ...(typeof data.randomSeed === 'number'
+                        ? { randomSeed: data.randomSeed }
+                        : {}),
+                };
+                this.emitSyntheticLocal('game-start', gameStart);
+            }
+        });
+        // Hash comparison (for desync detection)
+        this.socket.on('hash-comparison', (data) => {
+            this.callbacks.onHashComparison(data);
+        });
+        // Pause events
+        this.socket.on('game-paused', (data) => {
+            this.callbacks.onGamePaused(data);
+        });
+        this.socket.on('game-resumed', (data) => {
+            this.callbacks.onGameResumed(data);
+        });
+        // Private room events
+        this.socket.on('room-error', (data) => {
+            this.callbacks.onRoomError(data);
+        });
+        this.socket.on('room-expired', (data) => {
+            this.callbacks.onRoomExpired(data);
+        });
+        this.socket.on('room-cancelled', (data) => {
+            this.callbacks.onRoomCancelled(data);
+        });
+        this.socket.on('room-recovered', (data) => {
+            this.callbacks.onRoomRecovered(data);
+        });
+        // Disconnection handling
+        this.socket.on('disconnect', () => {
+            const wasPlaying = this.callbacks.isPlaying();
+            this.connectionState = 'disconnected';
+            this.callbacks.onDisconnected();
+            if (wasPlaying && this.config.autoReconnect) {
+                this.attemptReconnection().catch(() => {
+                    // Reconnection failed, already emitted reconnectFailed event
+                });
+            }
+        });
+        // Error handling
+        this.socket.on('error', (error) => {
+            this.callbacks.onError(error);
+        });
+    }
+    ensureConnected() {
+        if (!this.socket || !this.isConnected()) {
+            throw new Error('Not connected to server. Call connect() first.');
+        }
+    }
+    /**
+     * Replay `payload` through every listener currently registered for
+     * `event` on the local socket.
+     *
+     * socket.io-client's `socket.emit` sends to the server, so there is
+     * no public API to dispatch a server→client event against the
+     * client's own handlers. For the private-room recover path we need
+     * exactly that: the server already decided that, e.g., countdown
+     * should show "3", and we want every listener the application has
+     * wired up — including one-shot promises inside `waitForCountdown`
+     * / `waitForGameStart` — to observe the value as if the server had
+     * broadcast it on the wire.
+     *
+     * Iterating a snapshot of `socket.listeners(event)` (rather than
+     * the live list) is deliberate: a listener may call `socket.off`
+     * on itself during handling (e.g. `waitForCountdown`'s handler
+     * unsubscribes on `seconds === 0`), which would mutate the array
+     * under us and skip siblings.
+     */
+    emitSyntheticLocal(event, payload) {
+        if (!this.socket)
+            return;
+        const listeners = this.socket.listeners(event).slice();
+        for (const listener of listeners) {
+            try {
+                listener(payload);
+            }
+            catch (err) {
+                if (this.config.debug) {
+                    console.error(`[SocketManager] synthetic "${event}" listener threw:`, err);
+                }
+            }
+        }
+    }
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=SocketManager.js.map

package/dist/SocketManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocketManager.js","sourceRoot":"","sources":["../src/SocketManager.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,EAAE,EAAU,MAAM,kBAAkB,CAAC;AAyG9C;;GAEG;AACH,MAAM,OAAO,aAAa;IAChB,MAAM,GAAkB,IAAI,CAAC;IAC7B,MAAM,CAAsB;IAC5B,SAAS,CAAyB;IAElC,eAAe,GAAoB,cAAc,CAAC;IAClD,iBAAiB,GAAW,CAAC,CAAC;IAEtC,YAAY,MAA2B,EAAE,SAAiC;QACxE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,+CAA+C;IAC/C,aAAa;IACb,+CAA+C;IAE/C;;OAEG;IACH,KAAK,CAAC,OAAO;QACX,IAAI,IAAI,CAAC,eAAe,KAAK,WAAW,EAAE,CAAC;YACzC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,eAAe,GAAG,YAAY,CAAC;QAEpC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,CAAC;gBAC1B,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;gBACtC,MAAM,CAAC,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC,CAAC;YAC1C,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;YAEpC,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE;gBACtC,QAAQ,EAAE,IAAI;gBACd,UAAU,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC;gBAC7C,YAAY,EAAE,KAAK,EAAE,mCAAmC;gBACxD,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;oBACzB,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE;oBAClC,CAAC,CAAC,SAAS;aACd,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;gBAC7B,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC;gBACnC,IAAI,CAAC,iBAAiB,GAAG,CAAC,CAAC;gBAC3B,IAAI,CAAC,kBAAkB,EAAE,CAAC;gBAC1B,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;gBAC7B,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,eAAe,EAAE,CAAC,KAAK,EAAE,EAAE;gBACxC,YAAY,CAAC,OAAO,CAAC,CAAC;gBACtB,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;gBACtC,MAAM,CAAC,IAAI,KAAK,CAAC,sBAAsB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC3D,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,IAAI,CAAC,MAAM,CAAC,kBAAkB,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACrB,CAAC;QAED,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,CACL,IAAI,CAAC,eAAe,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CACxE,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,eAAe,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,iBAAiB,CAAC,QAAgB,EAAE,QAAgB,EAAE,SAAkB;QACtE,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,SAAS,CAAC;IACpC,CAAC;IAED,+CAA+C;IAC/C,mBAAmB;IACnB,+CAA+C;IAE/C;;OAEG;IACH,KAAK,CAAC,SAAS;QACb,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,YAAY,GAAG,CAAC,KAAmB,EAAE,EAAE;gBAC3C,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;gBAChD,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YACnC,CAAC,CAAC;YAEF,MAAM,aAAa,GAAG,CAAC,MAAwB,EAAE,EAAE;gBACjD,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;gBAC9C,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC,CAAC;YAEF,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,cAAc,EAAE,aAAa,CAAC,CAAC;YACjD,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;YAE/C,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,YAAY,EAAE;gBAC9B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC9B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;aAC/B,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,aAAa,EAAE;YAC/B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,+CAA+C;IAC/C,0BAA0B;IAC1B,+CAA+C;IAE/C;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,QAAiB;QAChC,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,YAAY,GAAG,CAAC,KAAqB,EAAE,EAAE;gBAC7C,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;gBACjD,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YACnC,CAAC,CAAC;YAEF,MAAM,cAAc,GAAG,CAAC,KAAuB,EAAE,EAAE;gBACjD,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;gBAC7C,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC,CAAC;YAEF,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;YAClD,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;YAE9C,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,aAAa,EAAE;gBAC/B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC9B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC9B,QAAQ;aACT,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,IAAY;QACnB,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,WAAW,EAAE;YAC7B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;YAC9B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;YAC9B,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACnC,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,KAAK,CAAC,WAAW,CACf,IAAY,EACZ,YAAoB,IAAI,CAAC,MAAM,CAAC,oBAAoB;QAEpD,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,OAAO,GAAG,KAAK,CAAC;YAEpB,MAAM,OAAO,GAAG,GAAS,EAAE;gBACzB,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;gBACrD,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;gBAC7C,YAAY,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC,CAAC;YAEF,MAAM,gBAAgB,GAAG,CAAC,KAAyB,EAAQ,EAAE;gBAC3D,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC,CAAC;YAEF,MAAM,YAAY,GAAG,CAAC,KAAqB,EAAQ,EAAE;gBACnD,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;YACnC,CAAC,CAAC;YAEF,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC5B,IAAI,OAAO;oBAAE,OAAO;gBACpB,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;YACvC,CAAC,EAAE,SAAS,CAAC,CAAC;YAEd,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,gBAAgB,CAAC,CAAC;YACtD,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,CAAC;YAE9C,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,cAAc,EAAE;gBAChC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC9B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC9B,IAAI;aACL,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,OAA4C;QAC1D,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,OAA0C;QACtD,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,eAAe,CAAC,OAA4C;QAC1D,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY;QAChB,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC,IAAqB,EAAE,EAAE;gBACzD,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB,CACpB,WAA6C;QAE7C,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,MAAM,gBAAgB,GAAG,CAAC,IAAoB,EAAE,EAAE;gBAChD,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBACjC,WAAW,EAAE,CAAC,IAAI,CAAC,CAAC;gBAEpB,IAAI,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,CAAC;oBACvB,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;oBAChD,OAAO,EAAE,CAAC;gBACZ,CAAC;YACH,CAAC,CAAC;YAEF,IAAI,CAAC,MAAO,CAAC,EAAE,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB;QACpB,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,IAAoB,EAAE,EAAE;gBACvD,OAAO,CAAC,IAAI,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,+CAA+C;IAC/C,WAAW;IACX,+CAA+C;IAE/C;;OAEG;IACH,KAAK,CAAC,cAAc,CAClB,IAAY,EACZ,QAAyB;QAEzB,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,qBAAqB,EAAE,CAAC,GAAsB,EAAE,EAAE;gBAClE,OAAO,CAAC,GAAG,CAAC,CAAC;YACf,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,mBAAmB,CAAC,IAAY,EAAE,QAAyB;QACzD,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED;;;;OAIG;IACH,aAAa,CAAC,IAAY,EAAE,IAAY;QACtC,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,aAAa;QACX,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,SAAS;QACP,IAAI,CAAC,eAAe,EAAE,CAAC;QACvB,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACpC,CAAC;IAED,+CAA+C;IAC/C,eAAe;IACf,+CAA+C;IAE/C;;OAEG;IACH,KAAK,CAAC,gBAAgB,CAAC,OAAe;QACpC,IAAI,CAAC,eAAe,EAAE,CAAC;QAEvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,aAAa,GAAG,CAAC,MAA4B,EAAE,EAAE;gBACrD,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;gBACzC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpB,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;oBAClD,MAAM,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,qBAAqB,CAAC,CAAC,CAAC;gBAC5D,CAAC;YACH,CAAC,CAAC;YAEF,MAAM,YAAY,GAAG,CAAC,KAA0B,EAAE,EAAE;gBAClD,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;gBACpD,+DAA+D;gBAC/D,+DAA+D;gBAC/D,8DAA8D;gBAC9D,gEAAgE;gBAChE,iEAAiE;gBACjE,OAAO,CAAC,KAAK,CAAC,CAAC;YACjB,CAAC,CAAC;YAEF,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,kBAAkB,EAAE,aAAa,CAAC,CAAC;YACrD,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;YAEnD,IAAI,CAAC,MAAO,CAAC,IAAI,CAAC,iBAAiB,EAAE;gBACnC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC9B,OAAO;aACR,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB;QACvB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChD,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,CAAC;QACxD,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;QAEtC,OAAO,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC;YACjE,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACzB,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YAEtD,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;gBAC/C,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;gBAErB,IAAI,YAAY,EAAE,CAAC;oBACjB,MAAM,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;gBAC5C,CAAC;gBAED,OAAO;YACT,CAAC;YAAC,MAAM,CAAC;gBACP,2BAA2B;YAC7B,CAAC;QACH,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACvD,CAAC;IAED,+CAA+C;IAC/C,kBAAkB;IAClB,+CAA+C;IAEvC,kBAAkB;QACxB,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QAEzB,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAI,CAAC;QAE7B,cAAc;QACd,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,IAAqB,EAAE,EAAE;YACtD,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAM,CAAC;YAC/B,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,aAAa;QACb,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,IAAoB,EAAE,EAAE;YACpD,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAM,CAAC;YAC/B,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,YAAY;QACZ,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,IAAoB,EAAE,EAAE;YACnD,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAM,CAAC;YAC/B,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,uBAAuB;QACvB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,IAAmB,EAAE,EAAE;YAClD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,iBAAiB;QACjB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,IAAwB,EAAE,EAAE;YAC5D,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,gBAAgB;QAChB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,qBAAqB,EAAE,CAAC,IAA6B,EAAE,EAAE;YACtE,IAAI,CAAC,SAAS,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,IAA4B,EAAE,EAAE;YACpE,IAAI,CAAC,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,IAAsB,EAAE,EAAE;YACxD,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,YAAY;QACZ,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,IAAmB,EAAE,EAAE;YAClD,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,+DAA+D;QAC/D,iEAAiE;QACjE,+DAA+D;QAC/D,4DAA4D;QAC5D,kEAAkE;QAClE,mEAAmE;QACnE,eAAe;QACf,EAAE;QACF,iEAAiE;QACjE,mEAAmE;QACnE,gEAAgE;QAChE,8DAA8D;QAC9D,8DAA8D;QAC9D,4CAA4C;QAC5C,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,IAAyB,EAAE,EAAE;YAC9D,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;YACtC,8DAA8D;YAC9D,iEAAiE;YACjE,gEAAgE;YAChE,iEAAiE;YACjE,2DAA2D;YAC3D,6DAA6D;YAC7D,+DAA+D;YAC/D,yBAAyB;YACzB,IACE,OAAO,IAAI,CAAC,yBAAyB,KAAK,QAAQ;gBAClD,IAAI,CAAC,yBAAyB,IAAI,CAAC,EACnC,CAAC;gBACD,IAAI,CAAC,kBAAkB,CAAC,WAAW,EAAE;oBACnC,OAAO,EAAE,IAAI,CAAC,yBAAyB;iBACf,CAAC,CAAC;YAC9B,CAAC;YACD,kEAAkE;YAClE,gEAAgE;YAChE,kEAAkE;YAClE,kEAAkE;YAClE,gEAAgE;YAChE,8DAA8D;YAC9D,+DAA+D;YAC/D,qBAAqB;YACrB,IACE,IAAI,CAAC,gBAAgB,KAAK,IAAI;gBAC9B,CAAC,IAAI,CAAC,KAAK,KAAK,WAAW,IAAI,IAAI,CAAC,KAAK,KAAK,mBAAmB,CAAC,EAClE,CAAC;gBACD,MAAM,SAAS,GAAmB;oBAChC,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,GAAG,CAAC,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ;wBACrC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE;wBACjC,CAAC,CAAC,EAAE,CAAC;iBACR,CAAC;gBACF,IAAI,CAAC,kBAAkB,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;YACnD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,yCAAyC;QACzC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,iBAAiB,EAAE,CAAC,IAAyB,EAAE,EAAE;YAC9D,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACxC,CAAC,CAAC,CAAC;QAEH,eAAe;QACf,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,IAAqB,EAAE,EAAE;YACtD,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,IAAsB,EAAE,EAAE;YACxD,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,sBAAsB;QACtB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,IAAoB,EAAE,EAAE;YACpD,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,IAAsB,EAAE,EAAE;YACxD,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,IAAwB,EAAE,EAAE;YAC5D,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,IAAwB,EAAE,EAAE;YAC5D,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,yBAAyB;QACzB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE;YAChC,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,CAAC;YAC9C,IAAI,CAAC,eAAe,GAAG,cAAc,CAAC;YACtC,IAAI,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;YAEhC,IAAI,UAAU,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;gBAC5C,IAAI,CAAC,mBAAmB,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE;oBACpC,6DAA6D;gBAC/D,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,iBAAiB;QACjB,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAmB,EAAE,EAAE;YAC9C,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,eAAe;QACrB,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;QACpE,CAAC;IACH,CAAC;IAGD;;;;;;;;;;;;;;;;;;OAkBG;IACK,kBAAkB,CAAC,KAAa,EAAE,OAAgB;QACxD,IAAI,CAAC,IAAI,CAAC,MAAM;YAAE,OAAO;QACzB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC;QACvD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACF,QAAoC,CAAC,OAAO,CAAC,CAAC;YACjD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;oBACtB,OAAO,CAAC,KAAK,CACX,8BAA8B,KAAK,mBAAmB,EACtD,GAAG,CACJ,CAAC;gBACJ,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,EAAU;QACtB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/StateHasher.d.ts

@@ -0,0 +1,76 @@
+/**
+ * StateHasher - Deterministic state hasher using FNV-1a algorithm
+ *
+ * Works only with primitives - game-agnostic by design.
+ * Games use this to hash their own state structure.
+ *
+ * @example
+ * ```typescript
+ * const hash = new StateHasher()
+ *   .addInt(tick)
+ *   .addInt(entityCount)
+ *   .addFloat(entity.x)
+ *   .addFloat(entity.y)
+ *   .addString(entity.state)
+ *   .finalize();
+ * ```
+ */
+export declare class StateHasher {
+    private static readonly FNV_OFFSET;
+    private static readonly FNV_PRIME;
+    private static readonly FLOAT_PRECISION;
+    private hash;
+    constructor();
+    /**
+     * Add an integer to the hash
+     * @param value - Integer value to hash
+     * @returns this (for chaining)
+     */
+    addInt(value: number): this;
+    /**
+     * Add a float to the hash (converted to fixed-point for determinism)
+     * @param value - Float value to hash
+     * @returns this (for chaining)
+     */
+    addFloat(value: number): this;
+    /**
+     * Add a string to the hash
+     * @param value - String value to hash
+     * @returns this (for chaining)
+     */
+    addString(value: string): this;
+    /**
+     * Add a boolean to the hash
+     * @param value - Boolean value to hash
+     * @returns this (for chaining)
+     */
+    addBool(value: boolean): this;
+    /**
+     * Add multiple integers (useful for arrays)
+     * @param values - Array of integers to hash
+     * @returns this (for chaining)
+     */
+    addIntArray(values: number[]): this;
+    /**
+     * Add multiple floats (useful for positions, etc.)
+     * @param values - Array of floats to hash
+     * @returns this (for chaining)
+     */
+    addFloatArray(values: number[]): this;
+    /**
+     * Finalize and get the hash as a hex string
+     * @returns 8-character hex string (32-bit hash)
+     */
+    finalize(): string;
+    /**
+     * Reset hasher to initial state (for reuse)
+     * @returns this (for chaining)
+     */
+    reset(): this;
+    /**
+     * Create a new hasher (static factory)
+     * @returns New StateHasher instance
+     */
+    static create(): StateHasher;
+}
+//# sourceMappingURL=StateHasher.d.ts.map