Merge pull request #10 from purescript/star

Add Star

Author: paf31

docs/Data/Profunctor/Star.md

@@ -0,0 +1,27 @@
+## Module Data.Profunctor.Star
+
+#### `Star`
+
+``` purescript
+newtype Star f a b
+  = Star (a -> f b)
+```
+
+`Star` turns a `Functor` into a `Profunctor`.
+
+##### Instances
+``` purescript
+instance profunctorStar :: (Functor f) => Profunctor (Star f)
+instance strongStar :: (Functor f) => Strong (Star f)
+instance choiceStar :: (Applicative f) => Choice (Star f)
+```
+
+#### `runStar`
+
+``` purescript
+runStar :: forall f a b. Star f a b -> a -> f b
+```
+
+Unwrap a value of type `Star f a b`.
+
+

src/Data/Profunctor/Star.purs

@@ -0,0 +1,27 @@
+module Data.Profunctor.Star where
+
+import Prelude
+
+import Data.Tuple
+import Data.Either
+import Data.Profunctor
+import Data.Profunctor.Strong
+import Data.Profunctor.Choice
+
+-- | `Star` turns a `Functor` into a `Profunctor`.
+newtype Star f a b = Star (a -> f b)
+
+-- | Unwrap a value of type `Star f a b`.
+runStar :: forall f a b. Star f a b -> a -> f b
+runStar (Star f) = f
+
+instance profunctorStar :: (Functor f) => Profunctor (Star f) where
+  dimap f g (Star ft) = Star (f >>> ft >>> map g)
+
+instance strongStar :: (Functor f) => Strong (Star f) where
+  first  (Star f) = Star \(Tuple s x) -> map (`Tuple` x) (f s)
+  second (Star f) = Star \(Tuple x s) -> map (Tuple x) (f s)
+
+instance choiceStar :: (Applicative f) => Choice (Star f) where
+  left  (Star f) = Star $ either (map Left <<< f) (pure <<< Right)
+  right (Star f) = Star $ either (pure <<< Left) (map Right <<< f)