Initial commit

.editorconfig

@@ -0,0 +1,12 @@
+root = true
+
+[*]
+end_of_line = lf
+charset = utf-8
+trim_trailing_whitespace = true
+insert_final_newline = true
+indent_style = tab
+
+[*.yml]
+indent_style = space
+indent_size = 2

.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

.gitignore

@@ -0,0 +1,3 @@
+node_modules
+package-lock.json
+yarn.lock

.npmrc

@@ -0,0 +1 @@
+package-lock=false

implementation.d.ts

@@ -0,0 +1,4 @@
+/**
+Constrain a value between an upper and lower bound.
+*/
+export default function clamp(number: number, min: number, max: number): number;

implementation.js

@@ -0,0 +1,24 @@
+import esAbstract from 'es-abstract';
+
+// ToNumber() abstract method (https://tc39.es/ecma262/#sec-tonumber) (https://github.com/ljharb/es-abstract/blob/8bc0b761dc26bd7335664ee9eb7095d9fc9d82db/2021/ToNumber.js#L39-L62)
+const {ToNumber: toNumber} = esAbstract;
+
+export default function clamp(number, min, max) {
+	number = toNumber(number);
+	min = toNumber(min);
+	max = toNumber(max);
+
+	if (min > max) {
+		throw new RangeError('The minimum value cannot be higher than the maximum value');
+	}
+
+	if (number < min) {
+		return min;
+	}
+
+	if (number > max) {
+		return max;
+	}
+
+	return number;
+}