New api: generate mappings from a descriptor object

Not ready to merge
document use case for function