@phalanx-engine/math 0.1.0

package/README.md

@@ -0,0 +1,124 @@
+# Phalanx Math
+
+Deterministic fixed-point math library for Phalanx Engine. Ensures identical calculations across all platforms and hardware for lockstep multiplayer games.
+
+## Overview
+
+This library wraps `@hastom/fixed-point` to provide a Unity/Quantum-style API for deterministic arithmetic. All clients using the same operations will produce identical results, preventing desync in lockstep multiplayer games.
+
+## Installation
+
+```bash
+pnpm add @phalanx-engine/math
+```
+
+## Usage
+
+```typescript
+import { FP, FPVector2, FPVector3 } from '@phalanx-engine/math';
+
+// Create fixed-point numbers
+const speed = FP.FromFloat(5.5);
+const deltaTime = FP.FromFloat(0.016);
+
+// Arithmetic operations
+const distance = FP.Mul(speed, deltaTime);
+
+// 2D vectors
+const velocity = FPVector2.FromFloat(3, 4);
+const length = FPVector2.Magnitude(velocity); // 5
+
+// 3D positions (for game entities)
+const position = FPVector3.FromFloat(10, 0, 20);
+const target = FPVector3.FromFloat(15, 0, 25);
+const dist = FPVector3.Distance(position, target);
+
+// Convert back to numbers for rendering
+console.log(FP.ToFloat(dist));
+```
+
+## API
+
+### FP
+
+Unified namespace for fixed-point operations (Unity/Quantum style):
+
+#### Creation
+- `FP.FromFloat(value: number)` - Create from JavaScript number
+- `FP.FromString(value: string)` - Create from string representation
+- `FP.FromInt(value: number | bigint)` - Create from integer
+- `FP.ToFloat(fp: FixedPoint)` - Convert back to JavaScript number
+
+#### Constants
+- `FP._0`, `FP._1` - Zero and One (Quantum naming)
+- `FP.Pi`, `FP.Pi2`, `FP.PiOver2` - Pi constants
+
+#### Arithmetic
+- `FP.Add`, `FP.Sub`, `FP.Mul`, `FP.Div`, `FP.Neg` - Basic arithmetic
+
+#### Math Functions
+- `FP.Sqrt`, `FP.Abs` - Unary operations
+- `FP.Floor`, `FP.Ceil`, `FP.Round` - Rounding
+- `FP.Min`, `FP.Max`, `FP.Clamp` - Range operations
+- `FP.Lerp` - Linear interpolation
+
+#### Comparison
+- `FP.Eq`, `FP.Lt`, `FP.Lte`, `FP.Gt`, `FP.Gte` - Comparisons
+
+#### Trigonometry
+- `FP.Sin`, `FP.Cos`, `FP.Atan2` - Deterministic approximations
+
+### FPVector2
+
+2D vector operations for game logic:
+
+#### Creation
+- `FPVector2.Create(x, y)` - Create from FixedPoint values
+- `FPVector2.FromFloat(x, y)` - Create from numbers
+
+#### Constants
+- `FPVector2.Zero`, `FPVector2.One` - Common vectors
+- `FPVector2.Up`, `FPVector2.Right` - Direction vectors
+
+#### Operations
+- `FPVector2.Add`, `FPVector2.Sub`, `FPVector2.Scale` - Vector arithmetic
+- `FPVector2.Magnitude`, `FPVector2.SqrMagnitude` - Length (Unity naming)
+- `FPVector2.Normalize`, `FPVector2.Dot` - Geometric operations
+- `FPVector2.Distance`, `FPVector2.SqrDistance` - Distance calculations
+- `FPVector2.Lerp` - Interpolation
+- `FPVector2.ToFloat` - Convert for rendering
+
+### FPVector3
+
+3D vector operations for entity positions:
+
+#### Creation
+- `FPVector3.Create(x, y, z)` - Create from FixedPoint values
+- `FPVector3.FromFloat(x, y, z)` - Create from numbers
+
+#### Constants
+- `FPVector3.Zero`, `FPVector3.One` - Common vectors
+- `FPVector3.Up`, `FPVector3.Right`, `FPVector3.Forward` - Direction vectors
+
+#### Operations
+- `FPVector3.Add`, `FPVector3.Sub`, `FPVector3.Scale` - Vector arithmetic
+- `FPVector3.Magnitude`, `FPVector3.SqrMagnitude` - Length (Unity naming)
+- `FPVector3.Normalize`, `FPVector3.Dot`, `FPVector3.Cross` - Geometric operations
+- `FPVector3.Distance`, `FPVector3.SqrDistance` - Distance calculations
+- `FPVector3.Lerp` - Interpolation
+- `FPVector3.ToFloat` - Convert for rendering
+
+## Why Fixed-Point?
+
+JavaScript's `Number` type uses IEEE 754 floating-point, which can produce slightly different results on different platforms/hardware. In lockstep multiplayer, even tiny differences compound over time, causing desync.
+
+Fixed-point math uses integer arithmetic with a fixed decimal scale, guaranteeing identical results everywhere.
+
+## Performance Considerations
+
+Fixed-point operations using BigInt are slower than native floats. For most games, this overhead is negligible. If you encounter performance issues:
+
+1. Profile to confirm fixed-point math is the bottleneck
+2. Consider batching operations
+3. Only use fixed-point for deterministic simulation; use floats for visual-only calculations
+

package/dist/FixedMath.d.ts

@@ -0,0 +1,246 @@
+/**
+ * Fixed-Point Math Module
+ *
+ * Provides deterministic fixed-point arithmetic for game calculations.
+ * All clients using the same operations will produce identical results.
+ *
+ * This module wraps @hastom/fixed-point library to provide a Unity/Quantum-style API.
+ *
+ * @example
+ * ```typescript
+ * import { FP, FPVector3 } from '@phalanx-engine/math';
+ *
+ * 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));
+ * ```
+ */
+import { FixedPoint } from '@hastom/fixed-point';
+export { FixedPoint };
+/**
+ * FP - Fixed-point number creation, conversion, and math utilities
+ * Quantum-style unified API for all fixed-point operations
+ */
+export declare const FP: {
+    /**
+     * Create a fixed-point number from a JavaScript number
+     *
+     * WARNING: This uses toFixed(15) to ensure deterministic conversion across
+     * different JavaScript engines (V8/Chrome, JSC/Safari, SpiderMonkey/Firefox).
+     * Native toString() can produce different results for the same float.
+     *
+     * @param value - Number to convert
+     * @param precision - Decimal precision (default: 18)
+     */
+    FromFloat: (value: number, precision?: number) => FixedPoint;
+    /**
+     * Create a fixed-point number from a string representation
+     * @param value - String representation (e.g., "10.5")
+     * @param precision - Decimal precision (default: 18)
+     */
+    FromString: (value: string, precision?: number) => FixedPoint;
+    /**
+     * Create a fixed-point number from an integer
+     * @param value - Integer value
+     * @param precision - Decimal precision (default: 18)
+     */
+    FromInt: (value: number | bigint, precision?: number) => FixedPoint;
+    /**
+     * Convert a fixed-point number back to a JavaScript number
+     */
+    ToFloat: (fp: FixedPoint) => number;
+    /**
+     * Get the raw bigint base value from a FixedPoint
+     * Used for SoA storage in BigInt64Array
+     *
+     * Note: This requires storing the precision separately or assuming
+     * all values use DEFAULT_PRECISION (18).
+     */
+    ToRaw: (fp: FixedPoint) => bigint;
+    /**
+     * Create a FixedPoint from a raw bigint base value
+     * Used for reading from SoA storage (BigInt64Array)
+     *
+     * @param raw - The raw bigint base value
+     * @param precision - The precision (default: 18)
+     */
+    FromRaw: (raw: bigint, precision?: number) => FixedPoint;
+    /** Zero constant */
+    _0: FixedPoint;
+    /** One constant */
+    _1: FixedPoint;
+    /** Pi constant */
+    Pi: FixedPoint;
+    /** 2*Pi constant (Quantum naming) */
+    Pi2: FixedPoint;
+    /** Pi/2 constant (Quantum naming) */
+    PiOver2: FixedPoint;
+    /** Add two fixed-point numbers */
+    Add: (a: FixedPoint, b: FixedPoint) => FixedPoint;
+    /** Subtract two fixed-point numbers */
+    Sub: (a: FixedPoint, b: FixedPoint) => FixedPoint;
+    /** Multiply two fixed-point numbers */
+    Mul: (a: FixedPoint, b: FixedPoint) => FixedPoint;
+    /** Divide two fixed-point numbers */
+    Div: (a: FixedPoint, b: FixedPoint) => FixedPoint;
+    /** Negate a fixed-point number */
+    Neg: (a: FixedPoint) => FixedPoint;
+    /** Square root of a fixed-point number */
+    Sqrt: (a: FixedPoint) => FixedPoint;
+    /** Absolute value of a fixed-point number */
+    Abs: (a: FixedPoint) => FixedPoint;
+    /** Floor of a fixed-point number */
+    Floor: (a: FixedPoint) => FixedPoint;
+    /** Ceiling of a fixed-point number */
+    Ceil: (a: FixedPoint) => FixedPoint;
+    /** Round a fixed-point number */
+    Round: (a: FixedPoint) => FixedPoint;
+    /** Minimum of two fixed-point numbers */
+    Min: (a: FixedPoint, b: FixedPoint) => FixedPoint;
+    /** Maximum of two fixed-point numbers */
+    Max: (a: FixedPoint, b: FixedPoint) => FixedPoint;
+    /** Check if two fixed-point numbers are equal */
+    Eq: (a: FixedPoint, b: FixedPoint) => boolean;
+    /** Check if first is less than second */
+    Lt: (a: FixedPoint, b: FixedPoint) => boolean;
+    /** Check if first is less than or equal to second */
+    Lte: (a: FixedPoint, b: FixedPoint) => boolean;
+    /** Check if first is greater than second */
+    Gt: (a: FixedPoint, b: FixedPoint) => boolean;
+    /** Check if first is greater than or equal to second */
+    Gte: (a: FixedPoint, b: FixedPoint) => boolean;
+    /**
+     * Linear interpolation between two values
+     * @param a - Start value
+     * @param b - End value
+     * @param t - Interpolation factor (0-1)
+     */
+    Lerp: (a: FixedPoint, b: FixedPoint, t: FixedPoint) => FixedPoint;
+    /** Clamp a value between min and max */
+    Clamp: (value: FixedPoint, min: FixedPoint, max: FixedPoint) => FixedPoint;
+    /**
+     * Sine approximation using Taylor series (deterministic)
+     * Note: Input should be in radians
+     */
+    Sin: (x: FixedPoint) => FixedPoint;
+    /**
+     * Cosine approximation using Taylor series (deterministic)
+     * Note: Input should be in radians
+     */
+    Cos: (x: FixedPoint) => FixedPoint;
+    /**
+     * Approximate atan2 (deterministic)
+     * Returns angle in radians
+     */
+    Atan2: (y: FixedPoint, x: FixedPoint) => FixedPoint;
+};
+/**
+ * Fixed-point 2D vector interface
+ */
+export interface FPVector2 {
+    x: FixedPoint;
+    y: FixedPoint;
+}
+/**
+ * FPVector2 - Fixed-point 2D vector utilities (Unity/Quantum style)
+ */
+export declare const FPVector2: {
+    /** Create a new vector from FixedPoint values */
+    Create: (x: FixedPoint, y: FixedPoint) => FPVector2;
+    /** Create a vector from float numbers */
+    FromFloat: (x: number, y: number) => FPVector2;
+    /** Zero vector */
+    Zero: FPVector2;
+    /** One vector (1, 1) */
+    One: FPVector2;
+    /** Up direction (0, 1) - Unity convention */
+    Up: FPVector2;
+    /** Right direction (1, 0) - Unity convention */
+    Right: FPVector2;
+    /** Add two vectors */
+    Add: (a: FPVector2, b: FPVector2) => FPVector2;
+    /** Subtract two vectors */
+    Sub: (a: FPVector2, b: FPVector2) => FPVector2;
+    /** Scale a vector by a scalar */
+    Scale: (v: FPVector2, s: FixedPoint) => FPVector2;
+    /** Get the magnitude (length) of a vector - Unity naming */
+    Magnitude: (v: FPVector2) => FixedPoint;
+    /** Get the squared magnitude of a vector (faster than Magnitude) - Unity naming */
+    SqrMagnitude: (v: FPVector2) => FixedPoint;
+    /** Normalize a vector (returns new vector) */
+    Normalize: (v: FPVector2) => FPVector2;
+    /** Dot product of two vectors */
+    Dot: (a: FPVector2, b: FPVector2) => FixedPoint;
+    /** Distance between two vectors */
+    Distance: (a: FPVector2, b: FPVector2) => FixedPoint;
+    /** Squared distance between two vectors (faster than Distance) */
+    SqrDistance: (a: FPVector2, b: FPVector2) => FixedPoint;
+    /** Linear interpolation between two vectors */
+    Lerp: (a: FPVector2, b: FPVector2, t: FixedPoint) => FPVector2;
+    /** Convert to plain object with float values (for display/serialization) */
+    ToFloat: (v: FPVector2) => {
+        x: number;
+        y: number;
+    };
+};
+/**
+ * Fixed-point 3D vector interface
+ * Renamed from FPPosition for clarity (Quantum uses FPVector3)
+ */
+export interface FPVector3 {
+    x: FixedPoint;
+    y: FixedPoint;
+    z: FixedPoint;
+}
+/**
+ * FPVector3 - Fixed-point 3D vector utilities (Unity/Quantum style)
+ */
+export declare const FPVector3: {
+    /** Create a new 3D vector from FixedPoint values */
+    Create: (x: FixedPoint, y: FixedPoint, z: FixedPoint) => FPVector3;
+    /** Create a 3D vector from float numbers */
+    FromFloat: (x: number, y: number, z: number) => FPVector3;
+    /** Zero vector */
+    Zero: FPVector3;
+    /** One vector (1, 1, 1) */
+    One: FPVector3;
+    /** Up direction (0, 1, 0) - Unity convention */
+    Up: FPVector3;
+    /** Right direction (1, 0, 0) - Unity convention */
+    Right: FPVector3;
+    /** Forward direction (0, 0, 1) - Unity convention */
+    Forward: FPVector3;
+    /** Add two 3D vectors */
+    Add: (a: FPVector3, b: FPVector3) => FPVector3;
+    /** Subtract two 3D vectors */
+    Sub: (a: FPVector3, b: FPVector3) => FPVector3;
+    /** Scale a 3D vector by a scalar */
+    Scale: (v: FPVector3, s: FixedPoint) => FPVector3;
+    /** Get the magnitude (length) of a 3D vector - Unity naming */
+    Magnitude: (v: FPVector3) => FixedPoint;
+    /** Get the squared magnitude of a 3D vector (faster than Magnitude) - Unity naming */
+    SqrMagnitude: (v: FPVector3) => FixedPoint;
+    /** Normalize a 3D vector (returns new vector) */
+    Normalize: (v: FPVector3) => FPVector3;
+    /** Dot product of two 3D vectors */
+    Dot: (a: FPVector3, b: FPVector3) => FixedPoint;
+    /** Cross product of two 3D vectors */
+    Cross: (a: FPVector3, b: FPVector3) => FPVector3;
+    /** Distance between two 3D vectors */
+    Distance: (a: FPVector3, b: FPVector3) => FixedPoint;
+    /** Squared distance between two 3D vectors (faster than Distance) */
+    SqrDistance: (a: FPVector3, b: FPVector3) => FixedPoint;
+    /** Linear interpolation between two 3D vectors */
+    Lerp: (a: FPVector3, b: FPVector3, t: FixedPoint) => FPVector3;
+    /** Convert to plain object with float values (for display/serialization) */
+    ToFloat: (v: FPVector3) => {
+        x: number;
+        y: number;
+        z: number;
+    };
+};
+//# 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":"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"}

package/dist/FixedMath.js

@@ -0,0 +1,420 @@
+/**
+ * Fixed-Point Math Module
+ *
+ * Provides deterministic fixed-point arithmetic for game calculations.
+ * All clients using the same operations will produce identical results.
+ *
+ * This module wraps @hastom/fixed-point library to provide a Unity/Quantum-style API.
+ *
+ * @example
+ * ```typescript
+ * import { FP, FPVector3 } from '@phalanx-engine/math';
+ *
+ * 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));
+ * ```
+ */
+import { FixedPoint, fpFromDecimal, fpFromInt } from '@hastom/fixed-point';
+// Re-export FixedPoint class as the number type
+export { FixedPoint };
+/** Default precision for fixed-point operations (5 decimal places) */
+const DEFAULT_PRECISION = 5;
+/**
+ * FP - Fixed-point number creation, conversion, and math utilities
+ * Quantum-style unified API for all fixed-point operations
+ */
+export const FP = {
+    // ============ Creation ============
+    /**
+     * Create a fixed-point number from a JavaScript number
+     *
+     * WARNING: This uses toFixed(15) to ensure deterministic conversion across
+     * different JavaScript engines (V8/Chrome, JSC/Safari, SpiderMonkey/Firefox).
+     * Native toString() can produce different results for the same float.
+     *
+     * @param value - Number to convert
+     * @param precision - Decimal precision (default: 18)
+     */
+    FromFloat: (value, precision = DEFAULT_PRECISION) => {
+        // Use toFixed(precision) for deterministic conversion across all JS engines
+        // This ensures the same string representation regardless of browser
+        // and stays within the precision limit of the fixed-point library
+        return fpFromDecimal(value.toFixed(precision), precision);
+    },
+    /**
+     * Create a fixed-point number from a string representation
+     * @param value - String representation (e.g., "10.5")
+     * @param precision - Decimal precision (default: 18)
+     */
+    FromString: (value, precision = DEFAULT_PRECISION) => {
+        return fpFromDecimal(value, precision);
+    },
+    /**
+     * Create a fixed-point number from an integer
+     * @param value - Integer value
+     * @param precision - Decimal precision (default: 18)
+     */
+    FromInt: (value, precision = DEFAULT_PRECISION) => {
+        return fpFromInt(BigInt(value), 0, precision);
+    },
+    /**
+     * Convert a fixed-point number back to a JavaScript number
+     */
+    ToFloat: (fp) => {
+        return fp.toDecimal();
+    },
+    /**
+     * Get the raw bigint base value from a FixedPoint
+     * Used for SoA storage in BigInt64Array
+     *
+     * Note: This requires storing the precision separately or assuming
+     * all values use DEFAULT_PRECISION (18).
+     */
+    ToRaw: (fp) => {
+        return fp.base;
+    },
+    /**
+     * Create a FixedPoint from a raw bigint base value
+     * Used for reading from SoA storage (BigInt64Array)
+     *
+     * @param raw - The raw bigint base value
+     * @param precision - The precision (default: 18)
+     */
+    FromRaw: (raw, precision = DEFAULT_PRECISION) => {
+        return new FixedPoint(raw, BigInt(precision));
+    },
+    // ============ Constants (Quantum naming convention) ============
+    /** Zero constant */
+    _0: fpFromInt(0n, 0, DEFAULT_PRECISION),
+    /** One constant */
+    _1: fpFromInt(1n, 0, DEFAULT_PRECISION),
+    /** Pi constant */
+    Pi: fpFromDecimal('3.14159', DEFAULT_PRECISION),
+    /** 2*Pi constant (Quantum naming) */
+    Pi2: fpFromDecimal('6.28318', DEFAULT_PRECISION),
+    /** Pi/2 constant (Quantum naming) */
+    PiOver2: fpFromDecimal('1.57079', DEFAULT_PRECISION),
+    // ============ Arithmetic Operations ============
+    /** Add two fixed-point numbers */
+    Add: (a, b) => a.add(b),
+    /** Subtract two fixed-point numbers */
+    Sub: (a, b) => a.sub(b),
+    /** Multiply two fixed-point numbers */
+    Mul: (a, b) => a.mul(b),
+    /** Divide two fixed-point numbers */
+    Div: (a, b) => a.div(b),
+    /** Negate a fixed-point number */
+    Neg: (a) => a.neg(),
+    // ============ Math Functions ============
+    /** Square root of a fixed-point number */
+    Sqrt: (a) => a.sqrt(),
+    /** Absolute value of a fixed-point number */
+    Abs: (a) => a.abs(),
+    /** Floor of a fixed-point number */
+    Floor: (a) => a.floor(),
+    /** Ceiling of a fixed-point number */
+    Ceil: (a) => a.ceil(),
+    /** Round a fixed-point number */
+    Round: (a) => a.round(),
+    /** Minimum of two fixed-point numbers */
+    Min: (a, b) => FixedPoint.min(a, b),
+    /** Maximum of two fixed-point numbers */
+    Max: (a, b) => FixedPoint.max(a, b),
+    // ============ Comparison ============
+    /** Check if two fixed-point numbers are equal */
+    Eq: (a, b) => a.eq(b),
+    /** Check if first is less than second */
+    Lt: (a, b) => a.lt(b),
+    /** Check if first is less than or equal to second */
+    Lte: (a, b) => a.lte(b),
+    /** Check if first is greater than second */
+    Gt: (a, b) => a.gt(b),
+    /** Check if first is greater than or equal to second */
+    Gte: (a, b) => a.gte(b),
+    // ============ Interpolation & Clamping ============
+    /**
+     * Linear interpolation between two values
+     * @param a - Start value
+     * @param b - End value
+     * @param t - Interpolation factor (0-1)
+     */
+    Lerp: (a, b, t) => {
+        return a.add(b.sub(a).mul(t));
+    },
+    /** Clamp a value between min and max */
+    Clamp: (value, min, max) => {
+        return FixedPoint.min(FixedPoint.max(value, min), max);
+    },
+    // ============ Trigonometry ============
+    /**
+     * Sine approximation using Taylor series (deterministic)
+     * Note: Input should be in radians
+     */
+    Sin: (x) => {
+        // Normalize to [-PI, PI] range
+        const twoPi = FP.Pi2;
+        const pi = FP.Pi;
+        // Simple modulo approximation
+        let normalized = x;
+        while (normalized.gt(pi)) {
+            normalized = normalized.sub(twoPi);
+        }
+        while (normalized.lt(pi.neg())) {
+            normalized = normalized.add(twoPi);
+        }
+        // Taylor series: sin(x) ≈ x - x³/3! + x⁵/5! - x⁷/7!
+        const x2 = normalized.mul(normalized);
+        const x3 = x2.mul(normalized);
+        const x5 = x3.mul(x2);
+        const x7 = x5.mul(x2);
+        const fact3 = FP.FromInt(6);
+        const fact5 = FP.FromInt(120);
+        const fact7 = FP.FromInt(5040);
+        return normalized.sub(x3.div(fact3)).add(x5.div(fact5)).sub(x7.div(fact7));
+    },
+    /**
+     * Cosine approximation using Taylor series (deterministic)
+     * Note: Input should be in radians
+     */
+    Cos: (x) => {
+        // cos(x) = sin(x + PI/2)
+        return FP.Sin(x.add(FP.PiOver2));
+    },
+    /**
+     * Approximate atan2 (deterministic)
+     * Returns angle in radians
+     */
+    Atan2: (y, x) => {
+        // Simple approximation using polynomial
+        const pi = FP.Pi;
+        const halfPi = FP.PiOver2;
+        const zero = FP._0;
+        if (x.isZero() && y.isZero()) {
+            return zero;
+        }
+        if (x.isZero()) {
+            return y.isPositive() ? halfPi : halfPi.neg();
+        }
+        const absY = y.abs();
+        const absX = x.abs();
+        let angle;
+        if (absX.gte(absY)) {
+            const ratio = absY.div(absX);
+            // Approximate atan using polynomial: atan(t) ≈ t - t³/3 + t⁵/5
+            const t2 = ratio.mul(ratio);
+            const t3 = t2.mul(ratio);
+            const t5 = t3.mul(t2);
+            angle = ratio.sub(t3.div(FP.FromInt(3))).add(t5.div(FP.FromInt(5)));
+        }
+        else {
+            const ratio = absX.div(absY);
+            const t2 = ratio.mul(ratio);
+            const t3 = t2.mul(ratio);
+            const t5 = t3.mul(t2);
+            angle = halfPi.sub(ratio.sub(t3.div(FP.FromInt(3))).add(t5.div(FP.FromInt(5))));
+        }
+        // Adjust for quadrant
+        if (x.isNegative()) {
+            angle = pi.sub(angle);
+        }
+        if (y.isNegative()) {
+            angle = angle.neg();
+        }
+        return angle;
+    },
+};
+/**
+ * FPVector2 - Fixed-point 2D vector utilities (Unity/Quantum style)
+ */
+export const FPVector2 = {
+    // ============ Creation ============
+    /** Create a new vector from FixedPoint values */
+    Create: (x, y) => ({ x, y }),
+    /** Create a vector from float numbers */
+    FromFloat: (x, y) => ({
+        x: FP.FromFloat(x),
+        y: FP.FromFloat(y),
+    }),
+    // ============ Constants ============
+    /** Zero vector */
+    Zero: { x: FP._0, y: FP._0 },
+    /** One vector (1, 1) */
+    One: { x: FP._1, y: FP._1 },
+    /** Up direction (0, 1) - Unity convention */
+    Up: { x: FP._0, y: FP._1 },
+    /** Right direction (1, 0) - Unity convention */
+    Right: { x: FP._1, y: FP._0 },
+    // ============ Operations ============
+    /** Add two vectors */
+    Add: (a, b) => ({
+        x: a.x.add(b.x),
+        y: a.y.add(b.y),
+    }),
+    /** Subtract two vectors */
+    Sub: (a, b) => ({
+        x: a.x.sub(b.x),
+        y: a.y.sub(b.y),
+    }),
+    /** Scale a vector by a scalar */
+    Scale: (v, s) => ({
+        x: v.x.mul(s),
+        y: v.y.mul(s),
+    }),
+    /** Get the magnitude (length) of a vector - Unity naming */
+    Magnitude: (v) => {
+        return v.x.mul(v.x).add(v.y.mul(v.y)).sqrt();
+    },
+    /** Get the squared magnitude of a vector (faster than Magnitude) - Unity naming */
+    SqrMagnitude: (v) => {
+        return v.x.mul(v.x).add(v.y.mul(v.y));
+    },
+    /** Normalize a vector (returns new vector) */
+    Normalize: (v) => {
+        const len = FPVector2.Magnitude(v);
+        if (len.isZero()) {
+            return { x: FP._0, y: FP._0 };
+        }
+        return {
+            x: v.x.div(len),
+            y: v.y.div(len),
+        };
+    },
+    /** Dot product of two vectors */
+    Dot: (a, b) => {
+        return a.x.mul(b.x).add(a.y.mul(b.y));
+    },
+    /** Distance between two vectors */
+    Distance: (a, b) => {
+        const dx = b.x.sub(a.x);
+        const dy = b.y.sub(a.y);
+        return dx.mul(dx).add(dy.mul(dy)).sqrt();
+    },
+    /** Squared distance between two vectors (faster than Distance) */
+    SqrDistance: (a, b) => {
+        const dx = b.x.sub(a.x);
+        const dy = b.y.sub(a.y);
+        return dx.mul(dx).add(dy.mul(dy));
+    },
+    /** Linear interpolation between two vectors */
+    Lerp: (a, b, t) => ({
+        x: FP.Lerp(a.x, b.x, t),
+        y: FP.Lerp(a.y, b.y, t),
+    }),
+    // ============ Conversion ============
+    /** Convert to plain object with float values (for display/serialization) */
+    ToFloat: (v) => ({
+        x: v.x.toDecimal(),
+        y: v.y.toDecimal(),
+    }),
+};
+/**
+ * FPVector3 - Fixed-point 3D vector utilities (Unity/Quantum style)
+ */
+export const FPVector3 = {
+    // ============ Creation ============
+    /** Create a new 3D vector from FixedPoint values */
+    Create: (x, y, z) => ({
+        x,
+        y,
+        z,
+    }),
+    /** Create a 3D vector from float numbers */
+    FromFloat: (x, y, z) => ({
+        x: FP.FromFloat(x),
+        y: FP.FromFloat(y),
+        z: FP.FromFloat(z),
+    }),
+    // ============ Constants ============
+    /** Zero vector */
+    Zero: { x: FP._0, y: FP._0, z: FP._0 },
+    /** One vector (1, 1, 1) */
+    One: { x: FP._1, y: FP._1, z: FP._1 },
+    /** Up direction (0, 1, 0) - Unity convention */
+    Up: { x: FP._0, y: FP._1, z: FP._0 },
+    /** Right direction (1, 0, 0) - Unity convention */
+    Right: { x: FP._1, y: FP._0, z: FP._0 },
+    /** Forward direction (0, 0, 1) - Unity convention */
+    Forward: { x: FP._0, y: FP._0, z: FP._1 },
+    // ============ Operations ============
+    /** Add two 3D vectors */
+    Add: (a, b) => ({
+        x: a.x.add(b.x),
+        y: a.y.add(b.y),
+        z: a.z.add(b.z),
+    }),
+    /** Subtract two 3D vectors */
+    Sub: (a, b) => ({
+        x: a.x.sub(b.x),
+        y: a.y.sub(b.y),
+        z: a.z.sub(b.z),
+    }),
+    /** Scale a 3D vector by a scalar */
+    Scale: (v, s) => ({
+        x: v.x.mul(s),
+        y: v.y.mul(s),
+        z: v.z.mul(s),
+    }),
+    /** Get the magnitude (length) of a 3D vector - Unity naming */
+    Magnitude: (v) => {
+        return v.x.mul(v.x).add(v.y.mul(v.y)).add(v.z.mul(v.z)).sqrt();
+    },
+    /** Get the squared magnitude of a 3D vector (faster than Magnitude) - Unity naming */
+    SqrMagnitude: (v) => {
+        return v.x.mul(v.x).add(v.y.mul(v.y)).add(v.z.mul(v.z));
+    },
+    /** Normalize a 3D vector (returns new vector) */
+    Normalize: (v) => {
+        const len = FPVector3.Magnitude(v);
+        if (len.isZero()) {
+            return { x: FP._0, y: FP._0, z: FP._0 };
+        }
+        return {
+            x: v.x.div(len),
+            y: v.y.div(len),
+            z: v.z.div(len),
+        };
+    },
+    /** Dot product of two 3D vectors */
+    Dot: (a, b) => {
+        return a.x.mul(b.x).add(a.y.mul(b.y)).add(a.z.mul(b.z));
+    },
+    /** Cross product of two 3D vectors */
+    Cross: (a, b) => ({
+        x: a.y.mul(b.z).sub(a.z.mul(b.y)),
+        y: a.z.mul(b.x).sub(a.x.mul(b.z)),
+        z: a.x.mul(b.y).sub(a.y.mul(b.x)),
+    }),
+    /** Distance between two 3D vectors */
+    Distance: (a, b) => {
+        const dx = b.x.sub(a.x);
+        const dy = b.y.sub(a.y);
+        const dz = b.z.sub(a.z);
+        return dx.mul(dx).add(dy.mul(dy)).add(dz.mul(dz)).sqrt();
+    },
+    /** Squared distance between two 3D vectors (faster than Distance) */
+    SqrDistance: (a, b) => {
+        const dx = b.x.sub(a.x);
+        const dy = b.y.sub(a.y);
+        const dz = b.z.sub(a.z);
+        return dx.mul(dx).add(dy.mul(dy)).add(dz.mul(dz));
+    },
+    /** Linear interpolation between two 3D vectors */
+    Lerp: (a, b, t) => ({
+        x: FP.Lerp(a.x, b.x, t),
+        y: FP.Lerp(a.y, b.y, t),
+        z: FP.Lerp(a.z, b.z, t),
+    }),
+    // ============ Conversion ============
+    /** Convert to plain object with float values (for display/serialization) */
+    ToFloat: (v) => ({
+        x: v.x.toDecimal(),
+        y: v.y.toDecimal(),
+        z: v.z.toDecimal(),
+    }),
+};
+//# sourceMappingURL=FixedMath.js.map

package/dist/FixedMath.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Phalanx Math - Deterministic Fixed-Point Math Library
+ *
+ * Provides cross-platform deterministic arithmetic for lockstep multiplayer games.
+ * All operations produce identical results regardless of hardware or platform.
+ *
+ * @packageDocumentation
+ */
+export { FixedPoint, FP, FPVector2, FPVector3, } from './FixedMath.js';
+export type { FPVector2 as FPVector2Interface, FPVector3 as FPVector3Interface, } from './FixedMath.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAEL,UAAU,EAEV,EAAE,EACF,SAAS,EACT,SAAS,GACV,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAEV,SAAS,IAAI,kBAAkB,EAE/B,SAAS,IAAI,kBAAkB,GAChC,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,14 @@
+/**
+ * Phalanx Math - Deterministic Fixed-Point Math Library
+ *
+ * Provides cross-platform deterministic arithmetic for lockstep multiplayer games.
+ * All operations produce identical results regardless of hardware or platform.
+ *
+ * @packageDocumentation
+ */
+export { 
+// Core types
+FixedPoint, 
+// Unified API (Unity/Quantum style)
+FP, FPVector2, FPVector3, } from './FixedMath.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO;AACL,aAAa;AACb,UAAU;AACV,oCAAoC;AACpC,EAAE,EACF,SAAS,EACT,SAAS,GACV,MAAM,gBAAgB,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@phalanx-engine/math",
+  "version": "0.1.0",
+  "description": "Deterministic fixed-point math library for Phalanx Engine - ensures identical calculations across all platforms",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "keywords": [
+    "fixed-point",
+    "deterministic",
+    "math",
+    "game-math",
+    "cross-platform",
+    "phalanx"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/phaeton-forge/phalanx-engine.git",
+    "directory": "phalanx-math"
+  },
+  "bugs": "https://github.com/phaeton-forge/phalanx-engine/issues",
+  "homepage": "https://github.com/phaeton-forge/phalanx-engine/tree/main/phalanx-math#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=24.0.0 <25.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@hastom/fixed-point": "^4.3.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "rimraf": "^5.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rimraf dist",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
+}