New api: generate mappings from a descriptor object

Not ready to merge
multi line
(etc)