gsap-utils

Call gsap.utils.mapRange(inMin, inMax, outMin, outMax, value) to convert a value from one range to another, such as mapping scroll progress 0-1 to 0-360 degrees. Omit the value argument to get a reusable function for repeated conversions.

Omit the final value argument for most utilities like clamp, mapRange, snap, and wrap to receive a function that accepts the value later. The exception is random, which requires passing true as the last argument to return a reusable function.

Yes, gsap.utils.random(min, max, snapIncrement) snaps the random result to the nearest multiple of the increment, such as random(0, 500, 5) for multiples of 5. It also accepts an array to pick a random element.

Yes, gsap.utils.selector accepts a DOM element or a React ref and handles .current automatically. It returns a scoped selector function so queries like '.box' only match descendants of that component container.

wrap cycles a value back to the start of the range when it exceeds the bounds, useful for infinite loops. wrapYoyo bounces the value back in the opposite direction at the range edges, creating a back-and-forth effect.

Avoid mapRange and normalize when values carry CSS units, since they operate only on plain numbers. Use getUnit and unitize to strip and reattach units when unit-aware conversion is required.