This updates JSONOutput to have type hints, helping callers use the

right arguments, and fixes some bad documentation.
It also fixes up a less-than-ideal exception for .append(), which was

raising a (documented) AttributeError if trying to append to a

non-list.
We now have unit tests covering all of the class, ensuring we don't

regress.

Unit tests pass.