complete redo of code, update readme with examples, add Pool and Heap types, mitigate potential confusion over older sources, document all classes with haxe docs