default to returning a flat list of matches. subtree-related fixes to scan
function

operators to Match class so it can be ordered. Protect Match attributes via
@property

mutate canonical version

for which an optional variable is not present