glazier-react-0.5.0.0: src/Glazier/React/Widget.hs
{-# LANGUAGE FlexibleContexts #-}
{-# LANGUAGE FlexibleInstances #-}
{-# LANGUAGE GADTs #-}
{-# LANGUAGE MultiParamTypeClasses #-}
{-# LANGUAGE TypeFamilies #-}
module Glazier.React.Widget where
import qualified Control.Disposable as CD
import Control.Lens
import Control.Monad.Free.Church
import qualified Data.DList as D
import qualified Glazier as G
import qualified Glazier.React.Maker as R
import qualified Glazier.React.Markup as R
import qualified Glazier.React.Model as R
type family CommandOf w where
CommandOf (Widget c a o m p) = c
type family ActionOf w where
ActionOf (Widget c a o m p) = a
type family OutlineOf w where
OutlineOf (Widget c a o m p) = o
type family ModelOf w where
ModelOf (Widget c a o m p) = m
type family PlanOf w where
PlanOf (Widget c a o m p) = p
type SceneOf w = R.Scene (ModelOf w) (PlanOf w)
type FrameOf w = R.Frame (ModelOf w) (PlanOf w)
type GizmoOf w = R.Gizmo (ModelOf w) (PlanOf w)
type WindowOf w = G.WindowT (SceneOf w) (R.ReactMlT Identity) ()
type GadgetOf w = G.GadgetT (ActionOf w) (GizmoOf w) Identity (D.DList (CommandOf w))
-- | tag used to choose Schema that contains Gizmos
data WithGizmo
-- | tag used to choose Schema that contains Outlines
data WithOutline
-- | You can't use type family as a type variable for a data type. The workaround is to use
-- a tag to choose between different type family functions.
-- ModelType takes a tag to choose between Gizmo or Outline.
-- This enables creating a @data@ type that can specialize to
-- using the tag.
type family SchemaType tag w where
SchemaType WithGizmo w = GizmoOf w
SchemaType WithOutline w = OutlineOf w
-- | Record of functions for a widget. Contains everything you need to make the model,
-- render, and run the event processing.
-- This is a GADT to enforce the Disposing and ToOutline constraints at the time
-- of creating the Widget record.
data Widget c a o m p where
Widget
:: (CD.Disposing m, CD.Disposing p, R.ToOutline m o)
=> (o -> F (R.Maker a) m)
-> (R.Frame m p -> F (R.Maker a) p)
-> G.WindowT (R.Scene m p) (R.ReactMlT Identity) ()
-> G.GadgetT a (R.Gizmo m p) Identity (D.DList c)
-> Widget c a o m p
-- | This typeclass is convenient as it carries the 'Disposing Model' and 'Disposing Plan' constraints
-- and allows treating 'Widget c a m p' as a type 'w'
class (CD.Disposing (ModelOf w)
, CD.Disposing (PlanOf w)
, R.ToOutline (ModelOf w) (OutlineOf w)) => IsWidget w where
-- | Make a Model from an Outline
mkModel :: w -> OutlineOf w -> F (R.Maker (ActionOf w)) (ModelOf w)
-- | Given an empty frame, make the Plan that uses the frame for rendering
mkPlan :: w -> R.Frame (ModelOf w) (PlanOf w) -> F (R.Maker (ActionOf w)) (PlanOf w)
-- | Rendering function that uses the Scene of Model and Plan
window :: w -> G.WindowT (R.Scene (ModelOf w) (PlanOf w)) (R.ReactMlT Identity) ()
-- | Update function that processes Action to update the Frame and Scene
gadget :: w -> G.GadgetT (ActionOf w) (R.Gizmo (ModelOf w) (PlanOf w)) Identity (D.DList (CommandOf w))
instance (CD.Disposing m, CD.Disposing p, R.ToOutline m o) => IsWidget (Widget c a o m p) where
mkModel (Widget f _ _ _) = f
mkPlan (Widget _ f _ _) = f
window (Widget _ _ f _) = f
gadget (Widget _ _ _ f) = f
-- | Make the required Frame and Plan for a Model
mkGizmo :: IsWidget w => w -> ModelOf w -> F (R.Maker (ActionOf w)) (R.Gizmo (ModelOf w) (PlanOf w))
mkGizmo w mdl = do
frm <- R.mkEmptyFrame
scn <- R.Scene mdl <$> mkPlan w frm
R.putFrame frm scn
pure (R.Gizmo scn frm)
-- | Make the required Frame and Plan from an Outline
mkGizmo' ::
IsWidget w =>
w
-> OutlineOf w
-> F (R.Maker (ActionOf w)) (R.Gizmo (ModelOf w) (PlanOf w))
mkGizmo' w i = mkModel w i >>= mkGizmo w