rewrite to work with loop-drop-setup
allow null `chunkPositions`
start updating readme for new api