values helper should accept one or more hash maps

[seancorfield]

Currently, values expects a sequence of either hash maps or sequences (column values) and returns {:values <arg>}.

Based on how many other helpers work, intuition would expect (values map1 map2 map3) to return {:values [map1 map2 map3]}.

Enhance it to support this and update the docs and examples around it.

[seancorfield]

It turns out this is harder than it looks.

The values helper is (currently) a generic-1 so it always treats it as a single argument. We can change that easily but...

...while we can clearly treat multiple arguments as a sequence of rows, the single argument case is tricky. A single argument with all hash maps could still be a row where all columns are JSON, and similarly for a single argument with all sequences (vectors). A single argument with mixed data pretty much has to be a row but we can't tell in those other cases and we don't want to break backward compatibility.