feat(api): make ImVec2/ImVec4 math operations immutable (#317)

resolves #302 

Updated math operations (`plus`, `minus`, `times`, `div`) for `ImVec2` and `ImVec4` to return new instances instead of modifying the existing ones, ensuring immutability.

Author: SpaiR

imgui-binding/src/generated/java/imgui/ImVec2.java

@@ -31,35 +31,37 @@ public ImVec2 set(final ImVec2 value) {
     }
 
     public ImVec2 plus(final float x, final float y) {
-        this.x += x;
-        this.y += y;
-        return this;
+        return new ImVec2(this.x + x, this.y + y);
     }
 
     public ImVec2 plus(final ImVec2 value) {
         return plus(value.x, value.y);
     }
 
     public ImVec2 minus(final float x, final float y) {
-        this.x -= x;
-        this.y -= y;
-        return this;
+        return new ImVec2(this.x - x, this.y -y);
     }
 
     public ImVec2 minus(final ImVec2 value) {
         return minus(value.x, value.y);
     }
 
     public ImVec2 times(final float x, final float y) {
-        this.x *= x;
-        this.y *= y;
-        return this;
+        return new ImVec2(this.x * x, this.y * y);
     }
 
     public ImVec2 times(final ImVec2 value) {
         return times(value.x, value.y);
     }
 
+    public ImVec2 div(final float x, final float y) {
+        return new ImVec2(this.x / x, this.y / y);
+    }
+
+    public ImVec2 div(final ImVec2 value) {
+        return div(value.x, value.y);
+    }
+
     @Override
     public String toString() {
         return "ImVec2{"

imgui-binding/src/generated/java/imgui/ImVec4.java

@@ -35,41 +35,37 @@ public ImVec4 set(final ImVec4 value) {
     }
 
     public ImVec4 plus(final float x, final float y, final float z, final float w) {
-        this.x += x;
-        this.y += y;
-        this.z += z;
-        this.w += w;
-        return this;
+        return new ImVec4(this.x + x, this.y + y, this.z + z, this.w + w);
     }
 
     public ImVec4 plus(final ImVec4 value) {
         return plus(value.x, value.y, value.z, value.w);
     }
 
     public ImVec4 minus(final float x, final float y, final float z, final float w) {
-        this.x -= x;
-        this.y -= y;
-        this.z -= z;
-        this.w -= w;
-        return this;
+        return new ImVec4(this.x - x, this.y - y, this.z - z, this.w - w);
     }
 
     public ImVec4 minus(final ImVec4 value) {
         return minus(value.x, value.y, value.z, value.w);
     }
 
     public ImVec4 times(final float x, final float y, final float z, final float w) {
-        this.x *= x;
-        this.y *= y;
-        this.z *= z;
-        this.w *= w;
-        return this;
+        return new ImVec4(this.x * x, this.y * y, this.z * z, this.w * w);
     }
 
     public ImVec4 times(final ImVec4 value) {
         return times(value.x, value.y, value.z, value.w);
     }
 
+    public ImVec4 div(final float x, final float y, final float z, final float w) {
+        return new ImVec4(this.x / x, this.y / y, this.z / z, this.w / w);
+    }
+
+    public ImVec4 div(final ImVec4 value) {
+        return div(value.x, value.y, value.z, value.w);
+    }
+
     @Override
     public String toString() {
         return "ImVec4{"

imgui-binding/src/main/java/imgui/ImVec2.java

@@ -31,35 +31,37 @@ public ImVec2 set(final ImVec2 value) {
     }
 
     public ImVec2 plus(final float x, final float y) {
-        this.x += x;
-        this.y += y;
-        return this;
+        return new ImVec2(this.x + x, this.y + y);
     }
 
     public ImVec2 plus(final ImVec2 value) {
         return plus(value.x, value.y);
     }
 
     public ImVec2 minus(final float x, final float y) {
-        this.x -= x;
-        this.y -= y;
-        return this;
+        return new ImVec2(this.x - x, this.y -y);
     }
 
     public ImVec2 minus(final ImVec2 value) {
         return minus(value.x, value.y);
     }
 
     public ImVec2 times(final float x, final float y) {
-        this.x *= x;
-        this.y *= y;
-        return this;
+        return new ImVec2(this.x * x, this.y * y);
     }
 
     public ImVec2 times(final ImVec2 value) {
         return times(value.x, value.y);
     }
 
+    public ImVec2 div(final float x, final float y) {
+        return new ImVec2(this.x / x, this.y / y);
+    }
+
+    public ImVec2 div(final ImVec2 value) {
+        return div(value.x, value.y);
+    }
+
     @Override
     public String toString() {
         return "ImVec2{"

imgui-binding/src/main/java/imgui/ImVec4.java

@@ -35,41 +35,37 @@ public ImVec4 set(final ImVec4 value) {
     }
 
     public ImVec4 plus(final float x, final float y, final float z, final float w) {
-        this.x += x;
-        this.y += y;
-        this.z += z;
-        this.w += w;
-        return this;
+        return new ImVec4(this.x + x, this.y + y, this.z + z, this.w + w);
     }
 
     public ImVec4 plus(final ImVec4 value) {
         return plus(value.x, value.y, value.z, value.w);
     }
 
     public ImVec4 minus(final float x, final float y, final float z, final float w) {
-        this.x -= x;
-        this.y -= y;
-        this.z -= z;
-        this.w -= w;
-        return this;
+        return new ImVec4(this.x - x, this.y - y, this.z - z, this.w - w);
     }
 
     public ImVec4 minus(final ImVec4 value) {
         return minus(value.x, value.y, value.z, value.w);
     }
 
     public ImVec4 times(final float x, final float y, final float z, final float w) {
-        this.x *= x;
-        this.y *= y;
-        this.z *= z;
-        this.w *= w;
-        return this;
+        return new ImVec4(this.x * x, this.y * y, this.z * z, this.w * w);
     }
 
     public ImVec4 times(final ImVec4 value) {
         return times(value.x, value.y, value.z, value.w);
     }
 
+    public ImVec4 div(final float x, final float y, final float z, final float w) {
+        return new ImVec4(this.x / x, this.y / y, this.z / z, this.w / w);
+    }
+
+    public ImVec4 div(final ImVec4 value) {
+        return div(value.x, value.y, value.z, value.w);
+    }
+
     @Override
     public String toString() {
         return "ImVec4{"

imgui-binding/src/test/java/imgui/ImVec2Test.java

@@ -4,6 +4,8 @@
 import org.junit.jupiter.api.Test;
 
 import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNotSame;
+import static org.junit.jupiter.api.Assertions.assertSame;
 
 class ImVec2Test {
     @Nested
@@ -34,67 +36,104 @@ void fromImVec2() {
     class set {
         @Test
         void withFloats() {
-            final ImVec2 value = new ImVec2().set(1, 2);
+            final ImVec2 original = new ImVec2();
+            final ImVec2 value = original.set(1, 2);
             assertEquals(1, value.x);
             assertEquals(2, value.y);
+            assertSame(original, value);
         }
 
         @Test
         void withImVec2() {
-            final ImVec2 value = new ImVec2().set(new ImVec2(1, 2));
+            final ImVec2 original = new ImVec2();
+            final ImVec2 value = original.set(new ImVec2(1, 2));
             assertEquals(1, value.x);
             assertEquals(2, value.y);
+            assertSame(original, value);
         }
     }
 
     @Nested
     class plus {
         @Test
         void withFloats() {
-            final ImVec2 value = new ImVec2(5, 5).plus(1, 2);
+            final ImVec2 original = new ImVec2(5, 5);
+            final ImVec2 value = original.plus(1, 2);
             assertEquals(6, value.x);
             assertEquals(7, value.y);
+            assertNotSame(original, value);
         }
 
         @Test
         void withImVec2() {
-            final ImVec2 value = new ImVec2(5, 5).plus(new ImVec2(1, 2));
+            final ImVec2 original = new ImVec2(5, 5);
+            final ImVec2 value = original.plus(new ImVec2(1, 2));
             assertEquals(6, value.x);
             assertEquals(7, value.y);
+            assertNotSame(original, value);
         }
     }
 
     @Nested
     class minus {
         @Test
         void withFloats() {
-            final ImVec2 value = new ImVec2(5, 5).minus(1, 2);
+            final ImVec2 original = new ImVec2(5, 5);
+            final ImVec2 value = original.minus(1, 2);
             assertEquals(4, value.x);
             assertEquals(3, value.y);
+            assertNotSame(original, value);
         }
 
         @Test
         void withImVec2() {
-            final ImVec2 value = new ImVec2(5, 5).minus(new ImVec2(1, 2));
+            final ImVec2 original = new ImVec2(5, 5);
+            final ImVec2 value = original.minus(new ImVec2(1, 2));
             assertEquals(4, value.x);
             assertEquals(3, value.y);
+            assertNotSame(original, value);
         }
     }
 
     @Nested
     class times {
         @Test
         void withFloats() {
-            final ImVec2 value = new ImVec2(5, 5).times(1, 2);
+            final ImVec2 original = new ImVec2(5, 5);
+            final ImVec2 value = original.times(1, 2);
             assertEquals(5, value.x);
             assertEquals(10, value.y);
+            assertNotSame(original, value);
         }
 
         @Test
         void withImVec2() {
-            final ImVec2 value = new ImVec2(5, 5).times(new ImVec2(1, 2));
+            final ImVec2 original = new ImVec2(5, 5);
+            final ImVec2 value = original.times(new ImVec2(1, 2));
             assertEquals(5, value.x);
             assertEquals(10, value.y);
+            assertNotSame(original, value);
+        }
+    }
+
+    @Nested
+    class div {
+        @Test
+        void withFloats() {
+            final ImVec2 original = new ImVec2(10, 10);
+            final ImVec2 value = original.div(5, 2);
+            assertEquals(2, value.x);
+            assertEquals(5, value.y);
+            assertNotSame(original, value);
+        }
+
+        @Test
+        void withImVec2() {
+            final ImVec2 original = new ImVec2(10, 10);
+            final ImVec2 value = original.div(new ImVec2(5, 2));
+            assertEquals(2, value.x);
+            assertEquals(5, value.y);
+            assertNotSame(original, value);
         }
     }
 }