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 rotation 0-360. Omit the value argument to get a reusable function for repeated conversions.

Use gsap.utils.random(min, max, snapIncrement) for an immediate value, or pass true as the last argument to get a reusable function. In tween vars, 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 function you can call later with any value, which is useful in scroll handlers and tween callbacks.

Yes, use gsap.utils.snap(snapTo, value) to round to the nearest multiple or nearest value in an array. In tweens, use the snap property like { x: 200, snap: { x: 20 } } for grid-aligned animation.

Use gsap.utils.selector(scope) with a DOM element or React ref to get a scoped selector function. Selectors like q(".box") then only match descendants of that container, not the whole document.

mapRange and normalize operate only on numbers and do not handle units like px or %. Use gsap.utils.getUnit to read a unit and gsap.utils.unitize to append one when unit-aware conversion is needed.