gsap-utils

Use gsap.utils.mapRange(inMin, inMax, outMin, outMax, value) to convert a value between ranges, such as mapping scroll progress 0-1 to 0-360 degrees. Omit the value argument to get a reusable function you can call repeatedly with the same configuration.

Use gsap.utils.random(min, max) for a number in a range, or pass an array to pick a random element. In tween vars you can use the string form like "random(-100, 100, 5)" and GSAP evaluates it per target.

clamp returns a value when you pass all three arguments: clamp(min, max, value). If you omit the value argument, it returns a reusable function that accepts the value later, which is useful in mousemove handlers or tween callbacks.

Use gsap.utils.selector(scope) with a DOM element or React ref to get a scoped selector function. The returned function finds elements only within that container, so selectors like ".box" match descendants of the component rather than the whole document.

random is the exception to the omit-the-value pattern used by other utils. To get a reusable function, pass true as the last argument, for example gsap.utils.random(-200, 500, 10, true), and the returned function produces a new random value on each call.

No, mapRange and normalize work on plain numbers only and do not parse units. Use gsap.utils.getUnit to read a unit string and gsap.utils.unitize to append a unit when building CSS or tween values.