@phalanx-engine/client 0.1.0

package/dist/DesyncDetector.d.ts

@@ -0,0 +1,80 @@
+/**
+ * DesyncDetector - Handles desync detection for lockstep synchronization
+ *
+ * Stores local state hashes and compares them with remote hashes
+ * received from other players via the server.
+ */
+import { EventEmitter } from './EventEmitter.js';
+/**
+ * Configuration for desync detection
+ */
+export interface DesyncConfig {
+    /** Whether desync detection is enabled */
+    enabled: boolean;
+    /** Maximum number of hashes to store (default: 100) */
+    maxStoredHashes?: number;
+}
+/**
+ * Event emitted when a desync is detected
+ */
+export interface DesyncEvent {
+    /** The tick where desync occurred */
+    tick: number;
+    /** The local hash for this tick */
+    localHash: string;
+    /** Hashes from all players (playerId -> hash) */
+    remoteHashes: Record<string, string>;
+}
+/**
+ * Events emitted by DesyncDetector
+ */
+export interface DesyncDetectorEvents {
+    desync: (event: DesyncEvent) => void;
+}
+/**
+ * DesyncDetector - Internal class for managing desync detection
+ *
+ * The game computes state hashes and submits them via the client.
+ * This class stores local hashes and compares with remote hashes
+ * when the server broadcasts a comparison.
+ */
+export declare class DesyncDetector extends EventEmitter<DesyncDetectorEvents> {
+    private config;
+    private hashHistory;
+    /**
+     * Configure the desync detector
+     */
+    configure(config: Partial<DesyncConfig>): void;
+    /**
+     * Check if desync detection is enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Record local hash (called by game via client.submitStateHash)
+     * @param tick - The tick this hash is for
+     * @param hash - Hash computed by game
+     */
+    recordLocalHash(tick: number, hash: string): void;
+    /**
+     * Get local hash for a specific tick
+     * @param tick - The tick to get hash for
+     * @returns The hash string or undefined if not found
+     */
+    getLocalHash(tick: number): string | undefined;
+    /**
+     * Compare local hash with remote hashes
+     * @param tick - The tick to compare
+     * @param remoteHashes - Hashes from all players (playerId -> hash)
+     * @returns true if all hashes match, false if desync detected
+     */
+    compareWithRemote(tick: number, remoteHashes: Record<string, string>): boolean;
+    /**
+     * Clear all stored hashes
+     */
+    clear(): void;
+    /**
+     * Get the current configuration
+     */
+    getConfig(): Required<DesyncConfig>;
+}
+//# sourceMappingURL=DesyncDetector.d.ts.map

package/dist/DesyncDetector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesyncDetector.d.ts","sourceRoot":"","sources":["../src/DesyncDetector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0CAA0C;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;CACtC;AAED;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,YAAY,CAAC,oBAAoB,CAAC;IACpE,OAAO,CAAC,MAAM,CAGZ;IACF,OAAO,CAAC,WAAW,CAAkC;IAErD;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI;IAS9C;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;;OAIG;IACH,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAYjD;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI9C;;;;;OAKG;IACH,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO;IAiB9E;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,YAAY,CAAC;CAGpC"}

package/dist/DesyncDetector.js

@@ -0,0 +1,93 @@
+/**
+ * DesyncDetector - Handles desync detection for lockstep synchronization
+ *
+ * Stores local state hashes and compares them with remote hashes
+ * received from other players via the server.
+ */
+import { EventEmitter } from './EventEmitter.js';
+/**
+ * DesyncDetector - Internal class for managing desync detection
+ *
+ * The game computes state hashes and submits them via the client.
+ * This class stores local hashes and compares with remote hashes
+ * when the server broadcasts a comparison.
+ */
+export class DesyncDetector extends EventEmitter {
+    config = {
+        enabled: true,
+        maxStoredHashes: 100,
+    };
+    hashHistory = new Map();
+    /**
+     * Configure the desync detector
+     */
+    configure(config) {
+        if (config.enabled !== undefined) {
+            this.config.enabled = config.enabled;
+        }
+        if (config.maxStoredHashes !== undefined) {
+            this.config.maxStoredHashes = config.maxStoredHashes;
+        }
+    }
+    /**
+     * Check if desync detection is enabled
+     */
+    isEnabled() {
+        return this.config.enabled;
+    }
+    /**
+     * Record local hash (called by game via client.submitStateHash)
+     * @param tick - The tick this hash is for
+     * @param hash - Hash computed by game
+     */
+    recordLocalHash(tick, hash) {
+        if (!this.config.enabled)
+            return;
+        this.hashHistory.set(tick, hash);
+        // Prune old hashes
+        if (this.hashHistory.size > this.config.maxStoredHashes) {
+            const oldestTick = Math.min(...this.hashHistory.keys());
+            this.hashHistory.delete(oldestTick);
+        }
+    }
+    /**
+     * Get local hash for a specific tick
+     * @param tick - The tick to get hash for
+     * @returns The hash string or undefined if not found
+     */
+    getLocalHash(tick) {
+        return this.hashHistory.get(tick);
+    }
+    /**
+     * Compare local hash with remote hashes
+     * @param tick - The tick to compare
+     * @param remoteHashes - Hashes from all players (playerId -> hash)
+     * @returns true if all hashes match, false if desync detected
+     */
+    compareWithRemote(tick, remoteHashes) {
+        const localHash = this.hashHistory.get(tick);
+        if (!localHash) {
+            // Can't compare - no local hash for this tick
+            return true;
+        }
+        const allMatch = Object.values(remoteHashes).every((h) => h === localHash);
+        if (!allMatch) {
+            this.emit('desync', { tick, localHash, remoteHashes });
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Clear all stored hashes
+     */
+    clear() {
+        this.hashHistory.clear();
+    }
+    /**
+     * Get the current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+//# sourceMappingURL=DesyncDetector.js.map

package/dist/DesyncDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DesyncDetector.js","sourceRoot":"","sources":["../src/DesyncDetector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AA+BjD;;;;;;GAMG;AACH,MAAM,OAAO,cAAe,SAAQ,YAAkC;IAC5D,MAAM,GAA2B;QACvC,OAAO,EAAE,IAAI;QACb,eAAe,EAAE,GAAG;KACrB,CAAC;IACM,WAAW,GAAwB,IAAI,GAAG,EAAE,CAAC;IAErD;;OAEG;IACH,SAAS,CAAC,MAA6B;QACrC,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;QACvC,CAAC;QACD,IAAI,MAAM,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,eAAe,GAAG,MAAM,CAAC,eAAe,CAAC;QACvD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACH,eAAe,CAAC,IAAY,EAAE,IAAY;QACxC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;YAAE,OAAO;QAEjC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAEjC,mBAAmB;QACnB,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YACxD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;YACxD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QACtC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,YAAY,CAAC,IAAY;QACvB,OAAO,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,IAAY,EAAE,YAAoC;QAClE,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,8CAA8C;YAC9C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;QAE3E,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;YACvD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;CACF"}

package/dist/DeterministicRandom.d.ts

@@ -0,0 +1,78 @@
+import prand from 'pure-rand';
+/**
+ * Deterministic Random Number Generator
+ *
+ * Wrapper around pure-rand library for deterministic pseudo-random number generation.
+ * All clients initialized with the same seed will produce identical sequences.
+ *
+ * @example
+ * ```typescript
+ * const rng = new DeterministicRandom(12345);
+ * const damage = rng.intRange(10, 20); // Same on all clients with same seed
+ * ```
+ */
+export declare class DeterministicRandom {
+    private rng;
+    /**
+     * Create a new deterministic RNG with the given seed
+     * @param seed - A number seed value
+     */
+    constructor(seed: number);
+    /**
+     * Generate next random 32-bit integer and advance state
+     */
+    private nextInt;
+    /**
+     * Get next random float in range [0, 1)
+     */
+    float(): number;
+    /**
+     * Get next random float in range [min, max)
+     * @param min - Minimum value (inclusive)
+     * @param max - Maximum value (exclusive)
+     */
+    floatRange(min: number, max: number): number;
+    /**
+     * Get next random integer in range [min, max]
+     * @param min - Minimum value (inclusive)
+     * @param max - Maximum value (inclusive)
+     */
+    intRange(min: number, max: number): number;
+    /**
+     * Get next random integer in range [0, max)
+     * @param max - Maximum value (exclusive)
+     */
+    int(max: number): number;
+    /**
+     * Get next random boolean
+     * @param probability - Probability of true (default 0.5)
+     */
+    boolean(probability?: number): boolean;
+    /**
+     * Get a random element from an array
+     * @param array - Array to pick from
+     */
+    pick<T>(array: readonly T[]): T;
+    /**
+     * Shuffle an array in place using Fisher-Yates algorithm
+     * @param array - Array to shuffle
+     * @returns The same array, shuffled
+     */
+    shuffle<T>(array: T[]): T[];
+    /**
+     * Create a fork of this RNG with independent state
+     * Useful for parallel simulations that need separate random streams
+     */
+    fork(): DeterministicRandom;
+    /**
+     * Get current generator for serialization
+     * Note: pure-rand generators are immutable, so this returns a copy
+     */
+    getGenerator(): prand.RandomGenerator;
+    /**
+     * Set generator from previously saved state
+     * @param generator - Previously saved generator
+     */
+    setGenerator(generator: prand.RandomGenerator): void;
+}
+//# sourceMappingURL=DeterministicRandom.d.ts.map

package/dist/DeterministicRandom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeterministicRandom.d.ts","sourceRoot":"","sources":["../src/DeterministicRandom.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,WAAW,CAAC;AAE9B;;;;;;;;;;;GAWG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,GAAG,CAAwB;IAEnC;;;OAGG;gBACS,IAAI,EAAE,MAAM;IAKxB;;OAEG;IACH,OAAO,CAAC,OAAO;IAMf;;OAEG;IACH,KAAK,IAAI,MAAM;IAMf;;;;OAIG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAI5C;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAQ1C;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIxB;;;OAGG;IACH,OAAO,CAAC,WAAW,GAAE,MAAY,GAAG,OAAO;IAI3C;;;OAGG;IACH,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC;IAO/B;;;;OAIG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAU3B;;;OAGG;IACH,IAAI,IAAI,mBAAmB;IAM3B;;;OAGG;IACH,YAAY,IAAI,KAAK,CAAC,eAAe;IAIrC;;;OAGG;IACH,YAAY,CAAC,SAAS,EAAE,KAAK,CAAC,eAAe,GAAG,IAAI;CAGrD"}

package/dist/DeterministicRandom.js

@@ -0,0 +1,122 @@
+import prand from 'pure-rand';
+/**
+ * Deterministic Random Number Generator
+ *
+ * Wrapper around pure-rand library for deterministic pseudo-random number generation.
+ * All clients initialized with the same seed will produce identical sequences.
+ *
+ * @example
+ * ```typescript
+ * const rng = new DeterministicRandom(12345);
+ * const damage = rng.intRange(10, 20); // Same on all clients with same seed
+ * ```
+ */
+export class DeterministicRandom {
+    rng;
+    /**
+     * Create a new deterministic RNG with the given seed
+     * @param seed - A number seed value
+     */
+    constructor(seed) {
+        // Use xoroshiro128+ algorithm - fast and high quality
+        this.rng = prand.xoroshiro128plus(seed);
+    }
+    /**
+     * Generate next random 32-bit integer and advance state
+     */
+    nextInt() {
+        const [value, next] = this.rng.next();
+        this.rng = next;
+        return value;
+    }
+    /**
+     * Get next random float in range [0, 1)
+     */
+    float() {
+        // Use unsigned 32-bit integer for conversion
+        const value = this.nextInt() >>> 0;
+        return value / 0x100000000;
+    }
+    /**
+     * Get next random float in range [min, max)
+     * @param min - Minimum value (inclusive)
+     * @param max - Maximum value (exclusive)
+     */
+    floatRange(min, max) {
+        return min + this.float() * (max - min);
+    }
+    /**
+     * Get next random integer in range [min, max]
+     * @param min - Minimum value (inclusive)
+     * @param max - Maximum value (inclusive)
+     */
+    intRange(min, max) {
+        min = Math.floor(min);
+        max = Math.floor(max);
+        const [value, next] = prand.uniformIntDistribution(min, max)(this.rng);
+        this.rng = next;
+        return value;
+    }
+    /**
+     * Get next random integer in range [0, max)
+     * @param max - Maximum value (exclusive)
+     */
+    int(max) {
+        return this.intRange(0, max - 1);
+    }
+    /**
+     * Get next random boolean
+     * @param probability - Probability of true (default 0.5)
+     */
+    boolean(probability = 0.5) {
+        return this.float() < probability;
+    }
+    /**
+     * Get a random element from an array
+     * @param array - Array to pick from
+     */
+    pick(array) {
+        if (array.length === 0) {
+            throw new Error('Cannot pick from empty array');
+        }
+        return array[this.intRange(0, array.length - 1)];
+    }
+    /**
+     * Shuffle an array in place using Fisher-Yates algorithm
+     * @param array - Array to shuffle
+     * @returns The same array, shuffled
+     */
+    shuffle(array) {
+        for (let i = array.length - 1; i > 0; i--) {
+            const j = this.intRange(0, i);
+            const temp = array[i];
+            array[i] = array[j];
+            array[j] = temp;
+        }
+        return array;
+    }
+    /**
+     * Create a fork of this RNG with independent state
+     * Useful for parallel simulations that need separate random streams
+     */
+    fork() {
+        // Generate a new seed from current state
+        const newSeed = this.nextInt();
+        return new DeterministicRandom(newSeed >>> 0);
+    }
+    /**
+     * Get current generator for serialization
+     * Note: pure-rand generators are immutable, so this returns a copy
+     */
+    getGenerator() {
+        return this.rng;
+    }
+    /**
+     * Set generator from previously saved state
+     * @param generator - Previously saved generator
+     */
+    setGenerator(generator) {
+        this.rng = generator;
+    }
+}
+//# sourceMappingURL=DeterministicRandom.js.map

package/dist/DeterministicRandom.js.map

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

package/dist/EventEmitter.d.ts

@@ -0,0 +1,65 @@
+/**
+ * EventEmitter - Generic typed event emitter
+ *
+ * Provides a type-safe event subscription system with support for:
+ * - Multiple handlers per event
+ * - One-time handlers (once)
+ * - Unsubscribe functions
+ * - Removing all listeners
+ */
+/**
+ * Generic event emitter with type-safe event handling
+ * @typeParam TEvents - Interface mapping event names to handler signatures
+ */
+export declare class EventEmitter<TEvents extends {
+    [K in keyof TEvents]: (...args: any[]) => void;
+}> {
+    private handlers;
+    /**
+     * Subscribe to an event
+     * @param event Event name
+     * @param handler Event handler function
+     * @returns Unsubscribe function
+     */
+    on<K extends keyof TEvents>(event: K, handler: TEvents[K]): () => void;
+    /**
+     * Subscribe to an event once (automatically unsubscribes after first call)
+     * @param event Event name
+     * @param handler Event handler function
+     */
+    once<K extends keyof TEvents>(event: K, handler: TEvents[K]): void;
+    /**
+     * Unsubscribe from an event
+     * @param event Event name
+     * @param handler Event handler function to remove
+     */
+    off<K extends keyof TEvents>(event: K, handler: TEvents[K]): void;
+    /**
+     * Remove all event listeners
+     */
+    removeAllListeners(): void;
+    /**
+     * Remove all listeners for a specific event
+     * @param event Event name
+     */
+    removeListeners<K extends keyof TEvents>(event: K): void;
+    /**
+     * Emit an event to all subscribers
+     * @param event Event name
+     * @param args Event arguments
+     */
+    protected emit<K extends keyof TEvents>(event: K, ...args: Parameters<TEvents[K]>): void;
+    /**
+     * Check if there are any listeners for an event
+     * @param event Event name
+     * @returns True if there are listeners
+     */
+    hasListeners<K extends keyof TEvents>(event: K): boolean;
+    /**
+     * Get the number of listeners for an event
+     * @param event Event name
+     * @returns Number of listeners
+     */
+    listenerCount<K extends keyof TEvents>(event: K): number;
+}
+//# sourceMappingURL=EventEmitter.d.ts.map

package/dist/EventEmitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventEmitter.d.ts","sourceRoot":"","sources":["../src/EventEmitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AAEH,qBAAa,YAAY,CAEvB,OAAO,SAAS;KAAG,CAAC,IAAI,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI;CAAE;IAGlE,OAAO,CAAC,QAAQ,CAA2C;IAE3D;;;;;OAKG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAYtE;;;;OAIG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IASlE;;;;OAIG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAKjE;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;;OAGG;IACH,eAAe,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAIxD;;;;OAIG;IACH,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,MAAM,OAAO,EACpC,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAC9B,IAAI;IAaP;;;;OAIG;IACH,YAAY,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO;IAKxD;;;;OAIG;IACH,aAAa,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM;CAGzD"}

package/dist/EventEmitter.js

@@ -0,0 +1,102 @@
+/**
+ * EventEmitter - Generic typed event emitter
+ *
+ * Provides a type-safe event subscription system with support for:
+ * - Multiple handlers per event
+ * - One-time handlers (once)
+ * - Unsubscribe functions
+ * - Removing all listeners
+ */
+/**
+ * Generic event emitter with type-safe event handling
+ * @typeParam TEvents - Interface mapping event names to handler signatures
+ */
+export class EventEmitter {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    handlers = new Map();
+    /**
+     * Subscribe to an event
+     * @param event Event name
+     * @param handler Event handler function
+     * @returns Unsubscribe function
+     */
+    on(event, handler) {
+        if (!this.handlers.has(event)) {
+            this.handlers.set(event, new Set());
+        }
+        this.handlers.get(event).add(handler);
+        return () => {
+            this.off(event, handler);
+        };
+    }
+    /**
+     * Subscribe to an event once (automatically unsubscribes after first call)
+     * @param event Event name
+     * @param handler Event handler function
+     */
+    once(event, handler) {
+        const wrapper = ((...args) => {
+            this.off(event, wrapper);
+            handler(...args);
+        });
+        this.on(event, wrapper);
+    }
+    /**
+     * Unsubscribe from an event
+     * @param event Event name
+     * @param handler Event handler function to remove
+     */
+    off(event, handler) {
+        const eventHandlers = this.handlers.get(event);
+        eventHandlers?.delete(handler);
+    }
+    /**
+     * Remove all event listeners
+     */
+    removeAllListeners() {
+        this.handlers.clear();
+    }
+    /**
+     * Remove all listeners for a specific event
+     * @param event Event name
+     */
+    removeListeners(event) {
+        this.handlers.delete(event);
+    }
+    /**
+     * Emit an event to all subscribers
+     * @param event Event name
+     * @param args Event arguments
+     */
+    emit(event, ...args) {
+        const eventHandlers = this.handlers.get(event);
+        if (eventHandlers) {
+            for (const handler of eventHandlers) {
+                try {
+                    handler(...args);
+                }
+                catch (error) {
+                    console.error(`Error in event handler for ${String(event)}:`, error);
+                }
+            }
+        }
+    }
+    /**
+     * Check if there are any listeners for an event
+     * @param event Event name
+     * @returns True if there are listeners
+     */
+    hasListeners(event) {
+        const eventHandlers = this.handlers.get(event);
+        return eventHandlers !== undefined && eventHandlers.size > 0;
+    }
+    /**
+     * Get the number of listeners for an event
+     * @param event Event name
+     * @returns Number of listeners
+     */
+    listenerCount(event) {
+        return this.handlers.get(event)?.size ?? 0;
+    }
+}
+//# sourceMappingURL=EventEmitter.js.map

package/dist/EventEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EventEmitter.js","sourceRoot":"","sources":["../src/EventEmitter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH;;;GAGG;AAEH,MAAM,OAAO,YAAY;IAIvB,8DAA8D;IACtD,QAAQ,GAAiC,IAAI,GAAG,EAAE,CAAC;IAE3D;;;;;OAKG;IACH,EAAE,CAA0B,KAAQ,EAAE,OAAmB;QACvD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAEvC,OAAO,GAAG,EAAE;YACV,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3B,CAAC,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,IAAI,CAA0B,KAAQ,EAAE,OAAmB;QACzD,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,IAA4B,EAAE,EAAE;YACnD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACxB,OAAqD,CAAC,GAAG,IAAI,CAAC,CAAC;QAClE,CAAC,CAAe,CAAC;QAEjB,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,GAAG,CAA0B,KAAQ,EAAE,OAAmB;QACxD,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/C,aAAa,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED;;;OAGG;IACH,eAAe,CAA0B,KAAQ;QAC/C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED;;;;OAIG;IACO,IAAI,CACZ,KAAQ,EACR,GAAG,IAA4B;QAE/B,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,aAAa,EAAE,CAAC;YAClB,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;gBACpC,IAAI,CAAC;oBACF,OAAqD,CAAC,GAAG,IAAI,CAAC,CAAC;gBAClE,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;gBACvE,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,YAAY,CAA0B,KAAQ;QAC5C,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/C,OAAO,aAAa,KAAK,SAAS,IAAI,aAAa,CAAC,IAAI,GAAG,CAAC,CAAC;IAC/D,CAAC;IAED;;;;OAIG;IACH,aAAa,CAA0B,KAAQ;QAC7C,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;IAC7C,CAAC;CACF"}

package/dist/FixedMath.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Fixed-Point Math Module
+ *
+ * Re-exports from phalanx-math for convenience.
+ * The canonical implementation is in phalanx-math.
+ *
+ * @example
+ * ```typescript
+ * import { FP, FPVector3 } from '@phalanx-engine/client';
+ *
+ * const position = FPVector3.FromFloat(10.5, 0, 20.3);
+ * const target = FPVector3.FromFloat(5.0, 0, 10.0);
+ *
+ * const distance = FPVector3.Distance(position, target);
+ *
+ * // Convert back to number for display
+ * console.log(FP.ToFloat(distance));
+ * ```
+ */
+export { FixedPoint, FP, FPVector2, FPVector3, } from '@phalanx-engine/math';
+export type { FPVector2 as FPVector2Interface, FPVector3 as FPVector3Interface } from '@phalanx-engine/math';
+//# sourceMappingURL=FixedMath.d.ts.map

package/dist/FixedMath.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FixedMath.d.ts","sourceRoot":"","sources":["../src/FixedMath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAEL,UAAU,EAEV,EAAE,EACF,SAAS,EACT,SAAS,GACV,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EAAE,SAAS,IAAI,kBAAkB,EAAE,SAAS,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/FixedMath.js

@@ -0,0 +1,26 @@
+/**
+ * Fixed-Point Math Module
+ *
+ * Re-exports from phalanx-math for convenience.
+ * The canonical implementation is in phalanx-math.
+ *
+ * @example
+ * ```typescript
+ * import { FP, FPVector3 } from '@phalanx-engine/client';
+ *
+ * const position = FPVector3.FromFloat(10.5, 0, 20.3);
+ * const target = FPVector3.FromFloat(5.0, 0, 10.0);
+ *
+ * const distance = FPVector3.Distance(position, target);
+ *
+ * // Convert back to number for display
+ * console.log(FP.ToFloat(distance));
+ * ```
+ */
+// Re-export everything from phalanx-math
+export { 
+// Core type
+FixedPoint, 
+// Unified API (Unity/Quantum style)
+FP, FPVector2, FPVector3, } from '@phalanx-engine/math';
+//# sourceMappingURL=FixedMath.js.map

package/dist/FixedMath.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FixedMath.js","sourceRoot":"","sources":["../src/FixedMath.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,yCAAyC;AACzC,OAAO;AACL,YAAY;AACZ,UAAU;AACV,oCAAoC;AACpC,EAAE,EACF,SAAS,EACT,SAAS,GACV,MAAM,sBAAsB,CAAC"}