1-----------------------------------------------------------------------------
3-- Module : Language.PureScript.TypeChecker
4-- Copyright : (c) Phil Freeman 2013
7-- Maintainer : Phil Freeman <paf31@cantab.net>
8-- Stability : experimental
12-- The top-level type checker, which checks all declarations in a module.
14-----------------------------------------------------------------------------
16{-# LANGUAGE FlexibleInstances #-}
18module Language.PureScript.TypeChecker (
23import Language.PureScript.TypeChecker.Monad as T
24import Language.PureScript.TypeChecker.Kinds as T
25import Language.PureScript.TypeChecker.Types as T
26import Language.PureScript.TypeChecker.Synonyms as T
29import Data.List (nub, (\\))
30import Data.Foldable (for_)
32import qualified Data.Map as M
34import Control.Monad.State
35import Control.Monad.Error.Class (MonadError(..))
37import Language.PureScript.Types
38import Language.PureScript.Names
39import Language.PureScript.Kinds
40import Language.PureScript.AST
41import Language.PureScript.TypeClassDictionaries
42import Language.PureScript.Environment
43import Language.PureScript.Errors
45addDataType :: ModuleName -> DataDeclType -> ProperName -> [(String, Maybe Kind)] -> [(ProperName, [Type])] -> Kind -> Check ()
46addDataType moduleName dtype name args dctors ctorKind = do
48 putEnv $ env { types = M.insert (Qualified (Just moduleName) name) (ctorKind, DataType args dctors) (types env) }
49 forM_ dctors $ \(dctor, tys) ->
50 rethrow (onErrorMessages (ErrorInDataConstructor dctor)) $
51 addDataConstructor moduleName dtype name (map fst args) dctor tys
53addDataConstructor :: ModuleName -> DataDeclType -> ProperName -> [String] -> ProperName -> [Type] -> Check ()
54addDataConstructor moduleName dtype name args dctor tys = do
56 mapM_ checkTypeSynonyms tys
57 let retTy = foldl TypeApp (TypeConstructor (Qualified (Just moduleName) name)) (map TypeVar args)
58 let dctorTy = foldr function retTy tys
59 let polyType = mkForAll args dctorTy
60 let fields = [Ident ("value" ++ show n) | n <- [0..(length tys - 1)]]
61 putEnv $ env { dataConstructors = M.insert (Qualified (Just moduleName) dctor) (dtype, name, polyType, fields) (dataConstructors env) }
63addTypeSynonym :: ModuleName -> ProperName -> [(String, Maybe Kind)] -> Type -> Kind -> Check ()
64addTypeSynonym moduleName name args ty kind = do
67 putEnv $ env { types = M.insert (Qualified (Just moduleName) name) (kind, TypeSynonym) (types env)
68 , typeSynonyms = M.insert (Qualified (Just moduleName) name) (args, ty) (typeSynonyms env) }
70valueIsNotDefined :: ModuleName -> Ident -> Check ()
71valueIsNotDefined moduleName name = do
73 case M.lookup (moduleName, name) (names env) of
74 Just _ -> throwError . errorMessage $ RedefinedIdent name
77addValue :: ModuleName -> Ident -> Type -> NameKind -> Check ()
78addValue moduleName name ty nameKind = do
80 putEnv (env { names = M.insert (moduleName, name) (ty, nameKind, Defined) (names env) })
82addTypeClass :: ModuleName -> ProperName -> [(String, Maybe Kind)] -> [Constraint] -> [Declaration] -> Check ()
83addTypeClass moduleName pn args implies ds =
84 let members = map toPair ds in
85 modify $ \st -> st { checkEnv = (checkEnv st) { typeClasses = M.insert (Qualified (Just moduleName) pn) (args, members, implies) (typeClasses . checkEnv $ st) } }
87 toPair (TypeDeclaration ident ty) = (ident, ty)
88 toPair (PositionedDeclaration _ _ d) = toPair d
89 toPair _ = error "Invalid declaration in TypeClassDeclaration"
91addTypeClassDictionaries :: Maybe ModuleName -> M.Map (Qualified ProperName) (M.Map (Qualified Ident) TypeClassDictionaryInScope) -> Check ()
92addTypeClassDictionaries mn entries =
93 modify $ \st -> st { checkEnv = (checkEnv st) { typeClassDictionaries = insertState st } }
94 where insertState st = M.insertWith (M.unionWith M.union) mn entries (typeClassDictionaries . checkEnv $ st)
96checkDuplicateTypeArguments :: [String] -> Check ()
97checkDuplicateTypeArguments args = for_ firstDup $ \dup ->
98 throwError . errorMessage $ DuplicateTypeArgument dup
100 firstDup :: Maybe String
101 firstDup = listToMaybe $ args \\ nub args
103checkTypeClassInstance :: ModuleName -> Type -> Check ()
104checkTypeClassInstance _ (TypeVar _) = return ()
105checkTypeClassInstance _ (TypeConstructor ctor) = do
107 when (ctor `M.member` typeSynonyms env) . throwError . errorMessage $ TypeSynonymInstance
109checkTypeClassInstance m (TypeApp t1 t2) = checkTypeClassInstance m t1 >> checkTypeClassInstance m t2
110checkTypeClassInstance _ ty = throwError . errorMessage $ InvalidInstanceHead ty
113-- Check that type synonyms are fully-applied in a type
115checkTypeSynonyms :: Type -> Check ()
116checkTypeSynonyms = void . replaceAllTypeSynonyms
119-- Type check all declarations in a module
121-- At this point, many declarations will have been desugared, but it is still necessary to
123-- * Kind-check all types and add them to the @Environment@
125-- * Type-check all values and add them to the @Environment@
127-- * Bring type class instances into scope
129-- * Process module imports
131typeCheckAll :: Maybe ModuleName -> ModuleName -> [DeclarationRef] -> [Declaration] -> Check [Declaration]
132typeCheckAll mainModuleName moduleName exps = go
134 go :: [Declaration] -> Check [Declaration]
136 go (DataDeclaration dtype name args dctors : rest) = do
137 rethrow (onErrorMessages (ErrorInTypeConstructor name)) $ do
138 when (dtype == Newtype) $ checkNewtype dctors
139 checkDuplicateTypeArguments $ map fst args
140 ctorKind <- kindsOf True moduleName name args (concatMap snd dctors)
141 let args' = args `withKinds` ctorKind
142 addDataType moduleName dtype name args' dctors ctorKind
144 return $ DataDeclaration dtype name args dctors : ds
146 checkNewtype :: [(ProperName, [Type])] -> Check ()
147 checkNewtype [(_, [_])] = return ()
148 checkNewtype [(_, _)] = throwError . errorMessage $ InvalidNewtype
149 checkNewtype _ = throwError . errorMessage $ InvalidNewtype
150 go (d@(DataBindingGroupDeclaration tys) : rest) = do
151 rethrow (onErrorMessages ErrorInDataBindingGroup) $ do
152 let syns = mapMaybe toTypeSynonym tys
153 let dataDecls = mapMaybe toDataDecl tys
154 (syn_ks, data_ks) <- kindsOfAll moduleName syns (map (\(_, name, args, dctors) -> (name, args, concatMap snd dctors)) dataDecls)
155 forM_ (zip dataDecls data_ks) $ \((dtype, name, args, dctors), ctorKind) -> do
156 checkDuplicateTypeArguments $ map fst args
157 let args' = args `withKinds` ctorKind
158 addDataType moduleName dtype name args' dctors ctorKind
159 forM_ (zip syns syn_ks) $ \((name, args, ty), kind) -> do
160 checkDuplicateTypeArguments $ map fst args
161 let args' = args `withKinds` kind
162 addTypeSynonym moduleName name args' ty kind
166 toTypeSynonym (TypeSynonymDeclaration nm args ty) = Just (nm, args, ty)
167 toTypeSynonym (PositionedDeclaration _ _ d') = toTypeSynonym d'
168 toTypeSynonym _ = Nothing
169 toDataDecl (DataDeclaration dtype nm args dctors) = Just (dtype, nm, args, dctors)
170 toDataDecl (PositionedDeclaration _ _ d') = toDataDecl d'
171 toDataDecl _ = Nothing
172 go (TypeSynonymDeclaration name args ty : rest) = do
173 rethrow (onErrorMessages (ErrorInTypeSynonym name)) $ do
174 checkDuplicateTypeArguments $ map fst args
175 kind <- kindsOf False moduleName name args [ty]
176 let args' = args `withKinds` kind
177 addTypeSynonym moduleName name args' ty kind
179 return $ TypeSynonymDeclaration name args ty : ds
180 go (TypeDeclaration _ _ : _) = error "Type declarations should have been removed"
181 go (ValueDeclaration name nameKind [] (Right val) : rest) = do
182 d <- rethrow (onErrorMessages (ErrorInValueDeclaration name)) $ do
183 valueIsNotDefined moduleName name
184 [(_, (val', ty))] <- typesOf mainModuleName moduleName [(name, val)]
185 addValue moduleName name ty nameKind
186 return $ ValueDeclaration name nameKind [] $ Right val'
189 go (ValueDeclaration{} : _) = error "Binders were not desugared"
190 go (BindingGroupDeclaration vals : rest) = do
191 d <- rethrow (onErrorMessages (ErrorInBindingGroup (map (\(ident, _, _) -> ident) vals))) $ do
192 forM_ (map (\(ident, _, _) -> ident) vals) $ \name ->
193 valueIsNotDefined moduleName name
194 tys <- typesOf mainModuleName moduleName $ map (\(ident, _, ty) -> (ident, ty)) vals
195 vals' <- forM [ (name, val, nameKind, ty)
196 | (name, nameKind, _) <- vals
197 , (name', (val, ty)) <- tys
199 ] $ \(name, val, nameKind, ty) -> do
200 addValue moduleName name ty nameKind
201 return (name, nameKind, val)
202 return $ BindingGroupDeclaration vals'
205 go (d@(ExternDataDeclaration name kind) : rest) = do
207 putEnv $ env { types = M.insert (Qualified (Just moduleName) name) (kind, ExternData) (types env) }
210 go (d@(ExternDeclaration name ty) : rest) = do
211 rethrow (onErrorMessages (ErrorInForeignImport name)) $ do
213 kind <- kindOf moduleName ty
214 guardWith (errorMessage (ExpectedType kind)) $ kind == Star
215 case M.lookup (moduleName, name) (names env) of
216 Just _ -> throwError . errorMessage $ RedefinedIdent name
217 Nothing -> putEnv (env { names = M.insert (moduleName, name) (ty, External, Defined) (names env) })
220 go (d@(FixityDeclaration _ name) : rest) = do
223 guardWith (errorMessage (OrphanFixityDeclaration name)) $ M.member (moduleName, Op name) $ names env
225 go (d@(ImportDeclaration importedModule _ _) : rest) = do
226 instances <- lookupTypeClassDictionaries $ Just importedModule
227 addTypeClassDictionaries (Just moduleName) instances
230 go (d@(TypeClassDeclaration pn args implies tys) : rest) = do
231 addTypeClass moduleName pn args implies tys
234 go (d@(TypeInstanceDeclaration dictName deps className tys _) : rest) = do
235 goInstance d dictName deps className tys rest
236 go (d@(ExternInstanceDeclaration dictName deps className tys) : rest) = do
237 goInstance d dictName deps className tys rest
238 go (PositionedDeclaration pos com d : rest) =
239 rethrowWithPosition pos $ do
240 (d' : rest') <- go (d : rest)
241 return (PositionedDeclaration pos com d' : rest')
242 goInstance :: Declaration -> Ident -> [Constraint] -> Qualified ProperName -> [Type] -> [Declaration] -> Check [Declaration]
243 goInstance d dictName deps className tys rest = do
244 mapM_ (checkTypeClassInstance moduleName) tys
245 forM_ deps $ mapM_ (checkTypeClassInstance moduleName) . snd
246 let dict = TypeClassDictionaryInScope (Qualified (Just moduleName) dictName) className tys (Just deps) TCDRegular isInstanceExported
247 addTypeClassDictionaries (Just moduleName) . M.singleton className $ M.singleton (canonicalizeDictionary dict) dict
253 isInstanceExported :: Bool
254 isInstanceExported = any exportsInstance exps
256 exportsInstance :: DeclarationRef -> Bool
257 exportsInstance (TypeInstanceRef name) | name == dictName = True
258 exportsInstance (PositionedDeclarationRef _ _ r) = exportsInstance r
259 exportsInstance _ = False
262 -- This function adds the argument kinds for a type constructor so that they may appear in the externs file,
263 -- extracted from the kind of the type constructor itself.
265 withKinds :: [(String, Maybe Kind)] -> Kind -> [(String, Maybe Kind)]
267 withKinds (s@(_, Just _ ):ss) (FunKind _ k) = s : withKinds ss k
268 withKinds ( (s, Nothing):ss) (FunKind k1 k2) = (s, Just k1) : withKinds ss k2
269 withKinds _ _ = error "Invalid arguments to peelKinds"
272-- Type check an entire module and ensure all types and classes defined within the module that are
273-- required by exported members are also exported.
275typeCheckModule :: Maybe ModuleName -> Module -> Check Module
276typeCheckModule _ (Module _ _ _ Nothing) = error "exports should have been elaborated"
277typeCheckModule mainModuleName (Module coms mn decls (Just exps)) = rethrow (onErrorMessages (ErrorInModule mn)) $ do
278 modify (\s -> s { checkCurrentModule = Just mn })
279 decls' <- typeCheckAll mainModuleName mn exps decls
280 forM_ exps $ \e -> do
281 checkTypesAreExported e
282 checkClassMembersAreExported e
283 checkClassesAreExported e
284 return $ Module coms mn decls' (Just exps)
287 checkMemberExport :: (Type -> [DeclarationRef]) -> DeclarationRef -> Check ()
288 checkMemberExport extract dr@(ValueRef name) = do
289 ty <- lookupVariable mn (Qualified (Just mn) name)
290 case filter (not . exported) (extract ty) of
292 hidden -> throwError . errorMessage $ TransitiveExportError dr hidden
294 exported e = any (exports e) exps
295 exports (TypeRef pn1 _) (TypeRef pn2 _) = pn1 == pn2
296 exports (ValueRef id1) (ValueRef id2) = id1 == id2
297 exports (TypeClassRef pn1) (TypeClassRef pn2) = pn1 == pn2
298 exports (TypeInstanceRef id1) (TypeInstanceRef id2) = id1 == id2
299 exports (PositionedDeclarationRef _ _ r1) r2 = exports r1 r2
300 exports r1 (PositionedDeclarationRef _ _ r2) = exports r1 r2
302 checkMemberExport _ _ = return ()
304 -- Check that all the type constructors defined in the current module that appear in member types
305 -- have also been exported from the module
306 checkTypesAreExported :: DeclarationRef -> Check ()
307 checkTypesAreExported = checkMemberExport findTcons
309 findTcons :: Type -> [DeclarationRef]
310 findTcons = everythingOnTypes (++) go
312 go (TypeConstructor (Qualified (Just mn') name)) | mn' == mn = [TypeRef name (error "Data constructors unused in checkTypesAreExported")]
315 -- Check that all the classes defined in the current module that appear in member types have also
316 -- been exported from the module
317 checkClassesAreExported :: DeclarationRef -> Check ()
318 checkClassesAreExported = checkMemberExport findClasses
320 findClasses :: Type -> [DeclarationRef]
321 findClasses = everythingOnTypes (++) go
323 go (ConstrainedType cs _) = mapMaybe (fmap TypeClassRef . extractCurrentModuleClass . fst) cs
325 extractCurrentModuleClass :: Qualified ProperName -> Maybe ProperName
326 extractCurrentModuleClass (Qualified (Just mn') name) | mn == mn' = Just name
327 extractCurrentModuleClass _ = Nothing
329 checkClassMembersAreExported :: DeclarationRef -> Check ()
330 checkClassMembersAreExported dr@(TypeClassRef name) = do
331 let members = ValueRef `map` head (mapMaybe findClassMembers decls)
332 let missingMembers = members \\ exps
333 unless (null missingMembers) $ throwError . errorMessage $ TransitiveExportError dr members
335 findClassMembers :: Declaration -> Maybe [Ident]
336 findClassMembers (TypeClassDeclaration name' _ _ ds) | name == name' = Just $ map extractMemberName ds
337 findClassMembers (PositionedDeclaration _ _ d) = findClassMembers d
338 findClassMembers _ = Nothing
339 extractMemberName :: Declaration -> Ident
340 extractMemberName (PositionedDeclaration _ _ d) = extractMemberName d
341 extractMemberName (TypeDeclaration memberName _) = memberName
342 extractMemberName _ = error "Unexpected declaration in typeclass member list"
343 checkClassMembersAreExported _ = return ()
keysesc to close
- j k
- move down, up
- enter
- open
- esc
- back, or up a level
- 1 2 3 4
- readme, files, commits, refs
- /
- filter
- y
- copy the clone command
- c
- compare the chosen commit with another (or shift-click both)
- ?
- show or hide this list