this should be finished w/ similar API docs to `wm_object` pre-merge if possible