--- /dev/null
+%
+% (c) The AQUA Project, Glasgow University, 1993-1998
+%
+\section[TcRules]{Typechecking transformation rules}
+
+\begin{code}
+module TcRules ( tcRules ) where
+
+#include "HsVersions.h"
+
+import HsSyn ( RuleDecl(..), LRuleDecl, RuleBndr(..), mkHsDictLet )
+import TcRnMonad
+import TcSimplify ( tcSimplifyToDicts, tcSimplifyInferCheck )
+import TcMType ( newFlexiTyVarTy, zonkQuantifiedTyVar, tcSkolSigTyVars )
+import TcType ( tyVarsOfTypes, openTypeKind, SkolemInfo(..), substTyWith, mkTyVarTys )
+import TcHsType ( UserTypeCtxt(..), tcHsPatSigType )
+import TcExpr ( tcMonoExpr )
+import TcEnv ( tcExtendIdEnv, tcExtendTyVarEnv )
+import Inst ( instToId )
+import Id ( idType, mkLocalId )
+import Name ( Name )
+import SrcLoc ( noLoc, unLoc )
+import Outputable
+\end{code}
+
+\begin{code}
+tcRules :: [LRuleDecl Name] -> TcM [LRuleDecl TcId]
+tcRules decls = mappM (wrapLocM tcRule) decls
+
+tcRule :: RuleDecl Name -> TcM (RuleDecl TcId)
+tcRule (HsRule name act vars lhs fv_lhs rhs fv_rhs)
+ = addErrCtxt (ruleCtxt name) $
+ traceTc (ptext SLIT("---- Rule ------")
+ <+> ppr name) `thenM_`
+ newFlexiTyVarTy openTypeKind `thenM` \ rule_ty ->
+
+ -- Deal with the tyvars mentioned in signatures
+ tcRuleBndrs vars (\ ids ->
+ -- Now LHS and RHS
+ getLIE (tcMonoExpr lhs rule_ty) `thenM` \ (lhs', lhs_lie) ->
+ getLIE (tcMonoExpr rhs rule_ty) `thenM` \ (rhs', rhs_lie) ->
+ returnM (ids, lhs', rhs', lhs_lie, rhs_lie)
+ ) `thenM` \ (ids, lhs', rhs', lhs_lie, rhs_lie) ->
+
+ -- Check that LHS has no overloading at all
+ getLIE (tcSimplifyToDicts lhs_lie) `thenM` \ (lhs_binds, lhs_dicts) ->
+
+ -- Gather the template variables and tyvars
+ let
+ tpl_ids = map instToId lhs_dicts ++ ids
+
+ -- IMPORTANT! We *quantify* over any dicts that appear in the LHS
+ -- Reason:
+ -- a) The particular dictionary isn't important, because its value
+ -- depends only on the type
+ -- e.g gcd Int $fIntegralInt
+ -- Here we'd like to match against (gcd Int any_d) for any 'any_d'
+ --
+ -- b) We'd like to make available the dictionaries bound
+ -- on the LHS in the RHS, so quantifying over them is good
+ -- See the 'lhs_dicts' in tcSimplifyAndCheck for the RHS
+
+ -- We initially quantify over any tyvars free in *either* the rule
+ -- *or* the bound variables. The latter is important. Consider
+ -- ss (x,(y,z)) = (x,z)
+ -- RULE: forall v. fst (ss v) = fst v
+ -- The type of the rhs of the rule is just a, but v::(a,(b,c))
+ --
+ -- We also need to get the free tyvars of the LHS; but we do that
+ -- during zonking (see TcHsSyn.zonkRule)
+ --
+ forall_tvs = tyVarsOfTypes (rule_ty : map idType tpl_ids)
+ in
+ -- RHS can be a bit more lenient. In particular,
+ -- we let constant dictionaries etc float outwards
+ --
+ -- NB: tcSimplifyInferCheck zonks the forall_tvs, and
+ -- knocks out any that are constrained by the environment
+ tcSimplifyInferCheck (text "tcRule")
+ forall_tvs
+ lhs_dicts rhs_lie `thenM` \ (forall_tvs1, rhs_binds) ->
+ mappM zonkQuantifiedTyVar forall_tvs1 `thenM` \ forall_tvs2 ->
+ -- This zonk is exactly the same as the one in TcBinds.tcBindWithSigs
+
+ returnM (HsRule name act
+ (map (RuleBndr . noLoc) (forall_tvs2 ++ tpl_ids)) -- yuk
+ (mkHsDictLet lhs_binds lhs') fv_lhs
+ (mkHsDictLet rhs_binds rhs') fv_rhs)
+ where
+
+tcRuleBndrs [] thing_inside = thing_inside []
+tcRuleBndrs (RuleBndr var : vars) thing_inside
+ = do { ty <- newFlexiTyVarTy openTypeKind
+ ; let id = mkLocalId (unLoc var) ty
+ ; tcExtendIdEnv [id] $
+ tcRuleBndrs vars (\ids -> thing_inside (id:ids)) }
+tcRuleBndrs (RuleBndrSig var rn_ty : vars) thing_inside
+-- e.g x :: a->a
+-- The tyvar 'a' is brought into scope first, just as if you'd written
+-- a::*, x :: a->a
+ = do { let ctxt = RuleSigCtxt (unLoc var)
+ ; (tyvars, ty) <- tcHsPatSigType ctxt rn_ty
+ ; let skol_tvs = tcSkolSigTyVars (SigSkol ctxt) tyvars
+ id_ty = substTyWith tyvars (mkTyVarTys skol_tvs) ty
+ id = mkLocalId (unLoc var) id_ty
+ ; tcExtendTyVarEnv skol_tvs $
+ tcExtendIdEnv [id] $
+ tcRuleBndrs vars (\ids -> thing_inside (id:ids)) }
+
+ruleCtxt name = ptext SLIT("When checking the transformation rule") <+>
+ doubleQuotes (ftext name)
+\end{code}
+
+
+
+