Unparsed entities really aren't handled at all.
In general, the parser resolves parsed entities and you never see them.
When writing, the outputter outputs entity references but not the entity's content.
The Entity class represents a parsed entity.
The API is mostly like the API of Element
This one is still being thought out.