collapse should flat collection items

[Lupennat]

collapse method should collapse elements of type collection.

I added a test to verify that the implementation is correct and added an example in the documentation.