Shadows module review

[natestemen]

The shadows module needs to be refactored/tested if we are going to ship it with 1.0. We should either do that, or add it to an "experimental" extra package where we make less guarantees about the stability of the module.

[natestemen]

previous issue: #2209