Module place 

Where something new goes when nothing said exactly where.

Each step is separate on purpose: a pointer position is honoured exactly, so only the steps a caller asks for are taken. What size a new thing is, and what counts as occupied, belong to the document — these take both as arguments.

Functions

beside

The frame of a new item that a band was just dropped at, sized width by height and placed so at lands on the edge facing source.

centred

The frame an item of width by height occupies centred on centre, snapped to the grid.

pushed_clear

Pushes frame out past source along whichever axis frame is already further along, leaving gap between them. A frame already clear of source is left alone — this is for something dropped so close to where it came from that it would land on top of it.

settled_below

Jumps frame down past whatever is covering it until it clears everything in occupied, and reports where it came to rest.