add a few new top level properties
new there's a test suite!