I was excited by the improvements and shininess in the Drupal 8, but I found the mysterious Typed Data API lurking beneath the surface. I jumped down the scarcely-documented hole over a year ago. I followed this white rabbit collecting the pieces of the API puzzle that I need for my module. I have not found the end.