API for inserting items into document should return new item ids

Maybe to give some context: currently there is no simple strategy to insert an entire subtree of items.