Better documents and test `ReplacementOptions`

[lramos15]

Right now it's unclear if replacement options act on the key or value and how to make it act on one vs the other. This should be enhanced with better documentation and more unit tests.

[AlvaroRausell]

Could it be that here we are using data?.properties in baseData instead of properties?