add "mod" function to FlxMath

flixel/math/FlxMath.hx

@@ -573,4 +573,21 @@ class FlxMath
 	{
 		return (n > 0) ? n : -n;
 	}
+
+	/**
+	 * Performs a modulo operation on two numbers.
+	 * This function differs from the built-in `%` operator in that it always
+	 * returns a positive result even with negative numbers involved.
+	 * For example, `-5 % 3` would return `-2` (truncated division),
+	 * while `mod(-5, 3)` would return `1` (Euclidean division).
+	 * 
+	 * @param a The dividend.
+	 * @param b The divisor.
+	 * @return `a mod b`.
+	 */
+	public static inline function mod(a:Float, b:Float):Float
+	{
+		b = Math.abs(b);
+		return a - b * Math.floor(a / b);
+	}
 }

tests/unit/src/flixel/math/FlxMathTest.hx

@@ -102,4 +102,16 @@ class FlxMathTest extends FlxTest
 		// #2126
 		Assert.areEqual(1521730678.942, FlxMath.roundDecimal(1521730678.942, 3));
 	}
+
+	@Test
+	function testMod()
+	{
+		Assert.areEqual(0, FlxMath.mod(8, 4));
+		Assert.areEqual(3, FlxMath.mod(8, 5));
+		Assert.areEqual(0.355, FlxMath.mod(0.941, 0.586));
+		Assert.areEqual(1, FlxMath.mod(-5, 3));
+		Assert.areEqual(1, FlxMath.mod(-5, -3));
+		Assert.areEqual(0.128, FlxMath.mod(-0.834, 0.481));
+		Assert.areEqual(2.5, FlxMath.mod(9, -6.5));
+	}
 }