Improve documentation, release version 1.2

Improve code cleanliness to avoid future bugs.

Fix parser freezes, blocking issue for Rhapsode.

Switch to new namespace for consistency with other modules like css-syntax.

Draft alternate API.