{-# LANGUAGE CPP #-}
-- The following warning id disabled so that we do not see warnings during
-- compilation caused by the intentional use of ListT.
#if __GLASGOW_HASKELL__ < 800
{-# OPTIONS_GHC -fno-warn-warnings-deprecations #-}
#else
{-# OPTIONS_GHC -Wno-deprecations #-}
#endif
-- |
-- Copyright  : (c) Ivan Perez and Manuel Baerenz, 2016
-- License    : BSD3
-- Maintainer : ivan.perez@keera.co.uk
--
-- 'MSF's with a list monadic layer.
--
-- This module contains functions to work with MSFs that include a 'ListT'
-- monadic layer. MSFs on a list monad may produce multiple outputs and
-- continuations, or none. This enables the possibility for spawning new MSFs,
-- or stopping MSFs, at will.
--
-- A common use case is to be able to dynamically spawn new interactive
-- elements in applications (e.g., a game object that splits in two, or that
-- fires to an enemy).
--
-- WARNING: the ListT transformer is considered dangerous, and imposes
-- additional constraints on the inner monad in order for the combination of
-- the monad and the transformer to be a monad. Use at your own risk.
module Control.Monad.Trans.MSF.List
    {-# WARNING "This module uses the ListT transformer, which is considered deprecated." #-}
    ( module Control.Monad.Trans.MSF.List
    , module Control.Monad.Trans.List
    )
  where

-- External imports
#if !MIN_VERSION_base(4,8,0)
import Control.Applicative ((<$>))
#endif

import Control.Monad.Trans.List hiding (liftCallCC, liftCatch)

-- Internal imports
import Data.MonadicStreamFunction.InternalCore (MSF (MSF, unMSF))

-- * List monad

-- | Run an 'MSF' in the 'ListT' transformer (i.e., multiple MSFs producing
-- each producing one output), by applying the input stream to each MSF in the
-- list transformer and concatenating the outputs of the MSFs together.
--
-- An MSF in the ListT transformer can spawn into more than one MSF, or none,
-- so the outputs produced at each individual step are not guaranteed to all
-- have the same length.
widthFirst :: (Functor m, Monad m) => MSF (ListT m) a b -> MSF m a [b]
widthFirst :: MSF (ListT m) a b -> MSF m a [b]
widthFirst MSF (ListT m) a b
msf = [MSF (ListT m) a b] -> MSF m a [b]
forall (m :: * -> *) a a.
Monad m =>
[MSF (ListT m) a a] -> MSF m a [a]
widthFirst' [MSF (ListT m) a b
msf]
  where
    widthFirst' :: [MSF (ListT m) a a] -> MSF m a [a]
widthFirst' [MSF (ListT m) a a]
msfs = (a -> m ([a], MSF m a [a])) -> MSF m a [a]
forall (m :: * -> *) a b. (a -> m (b, MSF m a b)) -> MSF m a b
MSF ((a -> m ([a], MSF m a [a])) -> MSF m a [a])
-> (a -> m ([a], MSF m a [a])) -> MSF m a [a]
forall a b. (a -> b) -> a -> b
$ \a
a -> do
      ([a]
bs, [MSF (ListT m) a a]
msfs') <- [(a, MSF (ListT m) a a)] -> ([a], [MSF (ListT m) a a])
forall a b. [(a, b)] -> ([a], [b])
unzip ([(a, MSF (ListT m) a a)] -> ([a], [MSF (ListT m) a a]))
-> ([[(a, MSF (ListT m) a a)]] -> [(a, MSF (ListT m) a a)])
-> [[(a, MSF (ListT m) a a)]]
-> ([a], [MSF (ListT m) a a])
forall b c a. (b -> c) -> (a -> b) -> a -> c
. [[(a, MSF (ListT m) a a)]] -> [(a, MSF (ListT m) a a)]
forall (t :: * -> *) a. Foldable t => t [a] -> [a]
concat ([[(a, MSF (ListT m) a a)]] -> ([a], [MSF (ListT m) a a]))
-> m [[(a, MSF (ListT m) a a)]] -> m ([a], [MSF (ListT m) a a])
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
<$> (MSF (ListT m) a a -> m [(a, MSF (ListT m) a a)])
-> [MSF (ListT m) a a] -> m [[(a, MSF (ListT m) a a)]]
forall (t :: * -> *) (m :: * -> *) a b.
(Traversable t, Monad m) =>
(a -> m b) -> t a -> m (t b)
mapM (ListT m (a, MSF (ListT m) a a) -> m [(a, MSF (ListT m) a a)]
forall (m :: * -> *) a. ListT m a -> m [a]
runListT (ListT m (a, MSF (ListT m) a a) -> m [(a, MSF (ListT m) a a)])
-> (MSF (ListT m) a a -> ListT m (a, MSF (ListT m) a a))
-> MSF (ListT m) a a
-> m [(a, MSF (ListT m) a a)]
forall b c a. (b -> c) -> (a -> b) -> a -> c
. (MSF (ListT m) a a -> a -> ListT m (a, MSF (ListT m) a a))
-> a -> MSF (ListT m) a a -> ListT m (a, MSF (ListT m) a a)
forall a b c. (a -> b -> c) -> b -> a -> c
flip MSF (ListT m) a a -> a -> ListT m (a, MSF (ListT m) a a)
forall (m :: * -> *) a b. MSF m a b -> a -> m (b, MSF m a b)
unMSF a
a) [MSF (ListT m) a a]
msfs
      ([a], MSF m a [a]) -> m ([a], MSF m a [a])
forall (m :: * -> *) a. Monad m => a -> m a
return ([a]
bs, [MSF (ListT m) a a] -> MSF m a [a]
widthFirst' [MSF (ListT m) a a]
msfs')

-- | Build an 'MSF' in the 'ListT' transformer by broadcasting the input stream
-- value to each MSF in a given list.
sequenceS :: Monad m => [MSF m a b] -> MSF (ListT m) a b
sequenceS :: [MSF m a b] -> MSF (ListT m) a b
sequenceS [MSF m a b]
msfs = (a -> ListT m (b, MSF (ListT m) a b)) -> MSF (ListT m) a b
forall (m :: * -> *) a b. (a -> m (b, MSF m a b)) -> MSF m a b
MSF ((a -> ListT m (b, MSF (ListT m) a b)) -> MSF (ListT m) a b)
-> (a -> ListT m (b, MSF (ListT m) a b)) -> MSF (ListT m) a b
forall a b. (a -> b) -> a -> b
$ \a
a -> m [(b, MSF (ListT m) a b)] -> ListT m (b, MSF (ListT m) a b)
forall (m :: * -> *) a. m [a] -> ListT m a
ListT (m [(b, MSF (ListT m) a b)] -> ListT m (b, MSF (ListT m) a b))
-> m [(b, MSF (ListT m) a b)] -> ListT m (b, MSF (ListT m) a b)
forall a b. (a -> b) -> a -> b
$ [m (b, MSF (ListT m) a b)] -> m [(b, MSF (ListT m) a b)]
forall (t :: * -> *) (m :: * -> *) a.
(Traversable t, Monad m) =>
t (m a) -> m (t a)
sequence ([m (b, MSF (ListT m) a b)] -> m [(b, MSF (ListT m) a b)])
-> [m (b, MSF (ListT m) a b)] -> m [(b, MSF (ListT m) a b)]
forall a b. (a -> b) -> a -> b
$ a -> MSF m a b -> m (b, MSF (ListT m) a b)
forall (m :: * -> *) a b.
Monad m =>
a -> MSF m a b -> m (b, MSF (ListT m) a b)
apply a
a (MSF m a b -> m (b, MSF (ListT m) a b))
-> [MSF m a b] -> [m (b, MSF (ListT m) a b)]
forall (f :: * -> *) a b. Functor f => (a -> b) -> f a -> f b
<$> [MSF m a b]
msfs
  where
    apply :: a -> MSF m a b -> m (b, MSF (ListT m) a b)
apply a
a MSF m a b
msf = do
      (b
b, MSF m a b
msf') <- MSF m a b -> a -> m (b, MSF m a b)
forall (m :: * -> *) a b. MSF m a b -> a -> m (b, MSF m a b)
unMSF MSF m a b
msf a
a
      (b, MSF (ListT m) a b) -> m (b, MSF (ListT m) a b)
forall (m :: * -> *) a. Monad m => a -> m a
return (b
b, [MSF m a b] -> MSF (ListT m) a b
forall (m :: * -> *) a b.
Monad m =>
[MSF m a b] -> MSF (ListT m) a b
sequenceS [MSF m a b
msf'])

-- | Apply an 'MSF' to every input.
mapMSF :: Monad m => MSF m a b -> MSF m [a] [b]
mapMSF :: MSF m a b -> MSF m [a] [b]
mapMSF = ([a] -> m ([b], MSF m [a] [b])) -> MSF m [a] [b]
forall (m :: * -> *) a b. (a -> m (b, MSF m a b)) -> MSF m a b
MSF (([a] -> m ([b], MSF m [a] [b])) -> MSF m [a] [b])
-> (MSF m a b -> [a] -> m ([b], MSF m [a] [b]))
-> MSF m a b
-> MSF m [a] [b]
forall b c a. (b -> c) -> (a -> b) -> a -> c
. MSF m a b -> [a] -> m ([b], MSF m [a] [b])
forall (m :: * -> *) a t.
Monad m =>
MSF m a t -> [a] -> m ([t], MSF m [a] [t])
consume
  where
    consume :: Monad m => MSF m a t -> [a] -> m ([t], MSF m [a] [t])
    consume :: MSF m a t -> [a] -> m ([t], MSF m [a] [t])
consume MSF m a t
sf []     = ([t], MSF m [a] [t]) -> m ([t], MSF m [a] [t])
forall (m :: * -> *) a. Monad m => a -> m a
return ([], MSF m a t -> MSF m [a] [t]
forall (m :: * -> *) a b. Monad m => MSF m a b -> MSF m [a] [b]
mapMSF MSF m a t
sf)
    consume MSF m a t
sf (a
a:[a]
as) = do
      (t
b, MSF m a t
sf')   <- MSF m a t -> a -> m (t, MSF m a t)
forall (m :: * -> *) a b. MSF m a b -> a -> m (b, MSF m a b)
unMSF MSF m a t
sf a
a
      ([t]
bs, MSF m [a] [t]
sf'') <- MSF m a t -> [a] -> m ([t], MSF m [a] [t])
forall (m :: * -> *) a t.
Monad m =>
MSF m a t -> [a] -> m ([t], MSF m [a] [t])
consume MSF m a t
sf' [a]
as
      t
b t -> m ([t], MSF m [a] [t]) -> m ([t], MSF m [a] [t])
`seq` ([t], MSF m [a] [t]) -> m ([t], MSF m [a] [t])
forall (m :: * -> *) a. Monad m => a -> m a
return (t
bt -> [t] -> [t]
forall a. a -> [a] -> [a]
:[t]
bs, MSF m [a] [t]
sf'')