It is a little confusing, yes. The documentation does refer to an object, but it has always been returned as an array and this is seen in the code example for the image field where array values are used. I’m sure that the documentation will eventually be updated. The best way to get concerns like this to the developer is to open a new support ticket here https://support.advancedcustomfields.com/new-ticket/.
