mapNumberRange

1/**
2 * Maps a number from one range to another.
3 *
4 * @param value - The input number.
5 * @param inMin - The lower bound of the input range.
6 * @param inMax - The upper bound of the input range.
7 * @param outMin - The lower bound of the output range.
8 * @param outMax - The upper bound of the output range.
9 * @returns The value mapped to the new range.
10 */
11export function mapNumberRange(
12  value: number,
13  inMin: number,
14  inMax: number,
15  outMin: number,
16  outMax: number
17): number {
18  if (inMin === inMax) return outMin;
19  return ((value - inMin) / (inMax - inMin)) * (outMax - outMin) + outMin;
20}

1test('mapNumberRange - normal mapping', () => {
2  expect(mapNumberRange(50, 0, 100, 0, 1)).toBe(0.5);
3});
4
5test('mapNumberRange - reverse mapping', () => {
6  expect(mapNumberRange(0.5, 0, 1, 0, 100)).toBe(50);
7});
8
9test('mapNumberRange - input at minimum', () => {
10  expect(mapNumberRange(0, 0, 100, 10, 20)).toBe(10);
11});
12
13test('mapNumberRange - input at maximum', () => {
14  expect(mapNumberRange(100, 0, 100, 10, 20)).toBe(20);
15});
16
17test('mapNumberRange - inverted output range', () => {
18  expect(mapNumberRange(25, 0, 100, 100, 0)).toBe(75);
19});
20
21test('mapNumberRange - zero input range', () => {
22  expect(mapNumberRange(42, 5, 5, 10, 20)).toBe(10);
23});