feat(packages/stdlib): mapRange util

packages/stdlib/src/math/mapRange/index.test.ts

@@ -0,0 +1,46 @@
+import { describe, expect, it } from 'vitest';
+import { mapRange } from './index';
+
+describe('mapRange', () => {
+    it('should map values from one range to another', () => {
+        // value at midpoint
+        expect(mapRange(5, 0, 10, 0, 100)).toBe(50);
+    
+        // value at min
+        expect(mapRange(0, 0, 10, 0, 100)).toBe(0);
+    
+        // value at max
+        expect(mapRange(10, 0, 10, 0, 100)).toBe(100);
+    
+        // value outside range (below)
+        expect(mapRange(-5, 0, 10, 0, 100)).toBe(0);
+    
+        // value outside range (above)
+        expect(mapRange(15, 0, 10, 0, 100)).toBe(100);
+    
+        // value at midpoint of negative range
+        expect(mapRange(75, 50, 100, -50, 50)).toBe(0);
+    
+        // value at midpoint of negative range
+        expect(mapRange(-25, -50, 0, 0, 100)).toBe(50);
+      });
+    
+      it('should handle floating-point numbers correctly', () => {
+        // floating-point value
+        expect(mapRange(3.5, 0, 10, 0, 100)).toBe(35);
+    
+        // positive floating-point ranges
+        expect(mapRange(1.25, 0, 2.5, 0, 100)).toBe(50);
+    
+        // negative floating-point value
+        expect(mapRange(-2.5, -5, 0, 0, 100)).toBe(50);
+
+        // negative floating-point ranges
+        expect(mapRange(-1.25, -2.5, 0, 0, 100)).toBe(50);
+      });
+    
+      it('should handle edge cases', () => {
+        // input range is zero (should return output min)
+        expect(mapRange(5, 0, 0, 0, 100)).toBe(0);
+      });
+});