{-# LANGUAGE BangPatterns #-} {-# LANGUAGE CPP #-} {-# LANGUAGE ConstraintKinds #-} {-# LANGUAGE DefaultSignatures #-} {-# LANGUAGE DeriveAnyClass #-} {-# LANGUAGE DeriveGeneric #-} {-# LANGUAGE DerivingStrategies #-} {-# LANGUAGE FlexibleContexts #-} {-# LANGUAGE FlexibleInstances #-} {-# LANGUAGE GADTs #-} {-# LANGUAGE GeneralizedNewtypeDeriving #-} {-# LANGUAGE NamedFieldPuns #-} {-# LANGUAGE OverloadedStrings #-} {-# LANGUAGE PolyKinds #-} {-# LANGUAGE RecordWildCards #-} {-# LANGUAGE ScopedTypeVariables #-} {-# LANGUAGE TypeFamilies #-} {-# LANGUAGE UndecidableInstances #-} {-# LANGUAGE ViewPatterns #-} module Ide.Types where #ifdef mingw32_HOST_OS import qualified System.Win32.Process as P (getCurrentProcessId) #else import Control.Monad (void) import qualified System.Posix.Process as P (getProcessID) import System.Posix.Signals #endif import Control.Lens ((^.)) import Data.Aeson hiding (defaultOptions) import qualified Data.DList as DList import qualified Data.Default import Data.Dependent.Map (DMap) import qualified Data.Dependent.Map as DMap import Data.GADT.Compare import Data.List.NonEmpty (NonEmpty (..), toList) import qualified Data.Map as Map import Data.Maybe import Data.Semigroup import Data.String import qualified Data.Text as T import Data.Text.Encoding (encodeUtf8) import Development.IDE.Graph import GHC (DynFlags) import GHC.Generics import Ide.Plugin.Config import Ide.Plugin.Properties import Language.LSP.Server (LspM, getVirtualFile) import Language.LSP.Types hiding (SemanticTokenAbsolute (length, line), SemanticTokenRelative (length), SemanticTokensEdit (_start)) import Language.LSP.Types.Capabilities (ClientCapabilities (ClientCapabilities), TextDocumentClientCapabilities (_codeAction, _documentSymbol)) import Language.LSP.Types.Lens as J (HasChildren (children), HasCommand (command), HasContents (contents), HasDeprecated (deprecated), HasEdit (edit), HasKind (kind), HasName (name), HasOptions (..), HasRange (range), HasTextDocument (..), HasTitle (title), HasUri (..)) import Language.LSP.VFS import OpenTelemetry.Eventlog import Options.Applicative (ParserInfo) import System.IO.Unsafe import Text.Regex.TDFA.Text () -- --------------------------------------------------------------------- newtype IdePlugins ideState = IdePlugins { ipMap :: [(PluginId, PluginDescriptor ideState)]} deriving newtype (Monoid, Semigroup) -- | Hooks for modifying the 'DynFlags' at different times of the compilation -- process. Plugins can install a 'DynFlagsModifications' via -- 'pluginModifyDynflags' in their 'PluginDescriptor'. data DynFlagsModifications = DynFlagsModifications { -- | Invoked immediately at the package level. Changes to the 'DynFlags' -- made in 'dynFlagsModifyGlobal' are guaranteed to be seen everywhere in -- the compilation pipeline. dynFlagsModifyGlobal :: DynFlags -> DynFlags -- | Invoked just before the parsing step, and reset immediately -- afterwards. 'dynFlagsModifyParser' allows plugins to enable language -- extensions only during parsing. for example, to let them enable -- certain pieces of syntax. , dynFlagsModifyParser :: DynFlags -> DynFlags } instance Semigroup DynFlagsModifications where DynFlagsModifications g1 p1 <> DynFlagsModifications g2 p2 = DynFlagsModifications (g2 . g1) (p2 . p1) instance Monoid DynFlagsModifications where mempty = DynFlagsModifications id id -- --------------------------------------------------------------------- newtype IdeCommand state = IdeCommand (state -> IO ()) instance Show (IdeCommand st) where show _ = "" -- --------------------------------------------------------------------- data PluginDescriptor ideState = PluginDescriptor { pluginId :: !PluginId , pluginRules :: !(Rules ()) , pluginCommands :: ![PluginCommand ideState] , pluginHandlers :: PluginHandlers ideState , pluginConfigDescriptor :: ConfigDescriptor , pluginNotificationHandlers :: PluginNotificationHandlers ideState , pluginModifyDynflags :: DynFlagsModifications , pluginCli :: Maybe (ParserInfo (IdeCommand ideState)) } -- | An existential wrapper of 'Properties' data CustomConfig = forall r. CustomConfig (Properties r) -- | Describes the configuration a plugin. -- A plugin may be configurable in such form: -- @ -- { -- "plugin-id": { -- "globalOn": true, -- "codeActionsOn": true, -- "codeLensOn": true, -- "config": { -- "property1": "foo" -- } -- } -- } -- @ -- @globalOn@, @codeActionsOn@, and @codeLensOn@ etc. are called generic configs, -- which can be inferred from handlers registered by the plugin. -- @config@ is called custom config, which is defined using 'Properties'. data ConfigDescriptor = ConfigDescriptor { -- | Whether or not to generate generic configs. configEnableGenericConfig :: Bool, -- | Whether or not to generate @diagnosticsOn@ config. -- Diagnostics emit in arbitrary shake rules, -- so we can't know statically if the plugin produces diagnostics configHasDiagnostics :: Bool, -- | Custom config. configCustomConfig :: CustomConfig } mkCustomConfig :: Properties r -> CustomConfig mkCustomConfig = CustomConfig defaultConfigDescriptor :: ConfigDescriptor defaultConfigDescriptor = ConfigDescriptor True False (mkCustomConfig emptyProperties) -- | Methods that can be handled by plugins. -- 'ExtraParams' captures any extra data the IDE passes to the handlers for this method -- Only methods for which we know how to combine responses can be instances of 'PluginMethod' class HasTracing (MessageParams m) => PluginMethod m where -- | Parse the configuration to check if this plugin is enabled pluginEnabled :: SMethod m -> PluginId -> Config -> Bool -- | How to combine responses from different plugins combineResponses :: SMethod m -> Config -- ^ IDE Configuration -> ClientCapabilities -> MessageParams m -> NonEmpty (ResponseResult m) -> ResponseResult m default combineResponses :: Semigroup (ResponseResult m) => SMethod m -> Config -> ClientCapabilities -> MessageParams m -> NonEmpty (ResponseResult m) -> ResponseResult m combineResponses _method _config _caps _params = sconcat instance PluginMethod TextDocumentCodeAction where pluginEnabled _ = pluginEnabledConfig plcCodeActionsOn combineResponses _method _config (ClientCapabilities _ textDocCaps _ _ _) (CodeActionParams _ _ _ _ context) resps = fmap compat $ List $ filter wasRequested $ (\(List x) -> x) $ sconcat resps where compat :: (Command |? CodeAction) -> (Command |? CodeAction) compat x@(InL _) = x compat x@(InR action) | Just _ <- textDocCaps >>= _codeAction >>= _codeActionLiteralSupport = x | otherwise = InL cmd where cmd = mkLspCommand "hls" "fallbackCodeAction" (action ^. title) (Just cmdParams) cmdParams = [toJSON (FallbackCodeActionParams (action ^. edit) (action ^. command))] wasRequested :: (Command |? CodeAction) -> Bool wasRequested (InL _) = True wasRequested (InR ca) | Nothing <- _only context = True | Just (List allowed) <- _only context -- See https://github.com/microsoft/language-server-protocol/issues/970 -- This is somewhat vague, but due to the hierarchical nature of action kinds, we -- should check whether the requested kind is a *prefix* of the action kind. -- That means, for example, we will return actions with kinds `quickfix.import` and -- `quickfix.somethingElse` if the requested kind is `quickfix`. , Just caKind <- ca ^. kind = any (\k -> k `codeActionKindSubsumes` caKind) allowed | otherwise = False instance PluginMethod TextDocumentCodeLens where pluginEnabled _ = pluginEnabledConfig plcCodeLensOn instance PluginMethod TextDocumentRename where pluginEnabled _ = pluginEnabledConfig plcRenameOn instance PluginMethod TextDocumentHover where pluginEnabled _ = pluginEnabledConfig plcHoverOn combineResponses _ _ _ _ (catMaybes . toList -> hs) = h where r = listToMaybe $ mapMaybe (^. range) hs h = case foldMap (^. contents) hs of HoverContentsMS (List []) -> Nothing hh -> Just $ Hover hh r instance PluginMethod TextDocumentDocumentSymbol where pluginEnabled _ = pluginEnabledConfig plcSymbolsOn combineResponses _ _ (ClientCapabilities _ tdc _ _ _) params xs = res where uri' = params ^. textDocument . uri supportsHierarchy = Just True == (tdc >>= _documentSymbol >>= _hierarchicalDocumentSymbolSupport) dsOrSi = fmap toEither xs res | supportsHierarchy = InL $ sconcat $ fmap (either id (fmap siToDs)) dsOrSi | otherwise = InR $ sconcat $ fmap (either (List . concatMap dsToSi) id) dsOrSi siToDs (SymbolInformation name kind _tags dep (Location _uri range) cont) = DocumentSymbol name cont kind Nothing dep range range Nothing dsToSi = go Nothing go :: Maybe T.Text -> DocumentSymbol -> [SymbolInformation] go parent ds = let children' :: [SymbolInformation] children' = concatMap (go (Just name')) (fromMaybe mempty (ds ^. children)) loc = Location uri' (ds ^. range) name' = ds ^. name si = SymbolInformation name' (ds ^. kind) Nothing (ds ^. deprecated) loc parent in [si] <> children' instance PluginMethod TextDocumentCompletion where pluginEnabled _ = pluginEnabledConfig plcCompletionOn combineResponses _ conf _ _ (toList -> xs) = snd $ consumeCompletionResponse limit $ combine xs where limit = maxCompletions conf combine :: [List CompletionItem |? CompletionList] -> (List CompletionItem |? CompletionList) combine cs = go True mempty cs go !comp acc [] = InR (CompletionList comp (List $ DList.toList acc)) go comp acc (InL (List ls) : rest) = go comp (acc <> DList.fromList ls) rest go comp acc (InR (CompletionList comp' (List ls)) : rest) = go (comp && comp') (acc <> DList.fromList ls) rest -- boolean disambiguators isCompleteResponse, isIncompleteResponse :: Bool isIncompleteResponse = True isCompleteResponse = False consumeCompletionResponse limit it@(InR (CompletionList _ (List xx))) = case splitAt limit xx of -- consumed all the items, return the result as is (_, []) -> (limit - length xx, it) -- need to crop the response, set the 'isIncomplete' flag (xx', _) -> (0, InR (CompletionList isIncompleteResponse (List xx'))) consumeCompletionResponse n (InL (List xx)) = consumeCompletionResponse n (InR (CompletionList isCompleteResponse (List xx))) instance PluginMethod TextDocumentFormatting where pluginEnabled _ pid conf = (PluginId $ formattingProvider conf) == pid combineResponses _ _ _ _ (x :| _) = x instance PluginMethod TextDocumentRangeFormatting where pluginEnabled _ pid conf = (PluginId $ formattingProvider conf) == pid combineResponses _ _ _ _ (x :| _) = x instance PluginMethod TextDocumentPrepareCallHierarchy where pluginEnabled _ = pluginEnabledConfig plcCallHierarchyOn instance PluginMethod TextDocumentSelectionRange where pluginEnabled _ = pluginEnabledConfig plcSelectionRangeOn combineResponses _ _ _ _ (x :| _) = x instance PluginMethod CallHierarchyIncomingCalls where pluginEnabled _ = pluginEnabledConfig plcCallHierarchyOn instance PluginMethod CallHierarchyOutgoingCalls where pluginEnabled _ = pluginEnabledConfig plcCallHierarchyOn instance PluginMethod CustomMethod where pluginEnabled _ _ _ = True combineResponses _ _ _ _ (x :| _) = x -- --------------------------------------------------------------------- -- | Methods which have a PluginMethod instance data IdeMethod (m :: Method FromClient Request) = PluginMethod m => IdeMethod (SMethod m) instance GEq IdeMethod where geq (IdeMethod a) (IdeMethod b) = geq a b instance GCompare IdeMethod where gcompare (IdeMethod a) (IdeMethod b) = gcompare a b -- | Methods which have a PluginMethod instance data IdeNotification (m :: Method FromClient Notification) = HasTracing (MessageParams m) => IdeNotification (SMethod m) instance GEq IdeNotification where geq (IdeNotification a) (IdeNotification b) = geq a b instance GCompare IdeNotification where gcompare (IdeNotification a) (IdeNotification b) = gcompare a b -- | Combine handlers for the newtype PluginHandler a (m :: Method FromClient Request) = PluginHandler (PluginId -> a -> MessageParams m -> LspM Config (NonEmpty (Either ResponseError (ResponseResult m)))) newtype PluginNotificationHandler a (m :: Method FromClient Notification) = PluginNotificationHandler (PluginId -> a -> VFS -> MessageParams m -> LspM Config ()) newtype PluginHandlers a = PluginHandlers (DMap IdeMethod (PluginHandler a)) newtype PluginNotificationHandlers a = PluginNotificationHandlers (DMap IdeNotification (PluginNotificationHandler a)) instance Semigroup (PluginHandlers a) where (PluginHandlers a) <> (PluginHandlers b) = PluginHandlers $ DMap.unionWithKey go a b where go _ (PluginHandler f) (PluginHandler g) = PluginHandler $ \pid ide params -> (<>) <$> f pid ide params <*> g pid ide params instance Monoid (PluginHandlers a) where mempty = PluginHandlers mempty instance Semigroup (PluginNotificationHandlers a) where (PluginNotificationHandlers a) <> (PluginNotificationHandlers b) = PluginNotificationHandlers $ DMap.unionWithKey go a b where go _ (PluginNotificationHandler f) (PluginNotificationHandler g) = PluginNotificationHandler $ \pid ide vfs params -> f pid ide vfs params >> g pid ide vfs params instance Monoid (PluginNotificationHandlers a) where mempty = PluginNotificationHandlers mempty type PluginMethodHandler a m = a -> PluginId -> MessageParams m -> LspM Config (Either ResponseError (ResponseResult m)) type PluginNotificationMethodHandler a m = a -> VFS -> PluginId -> MessageParams m -> LspM Config () -- | Make a handler for plugins with no extra data mkPluginHandler :: PluginMethod m => SClientMethod m -> PluginMethodHandler ideState m -> PluginHandlers ideState mkPluginHandler m f = PluginHandlers $ DMap.singleton (IdeMethod m) (PluginHandler f') where f' pid ide params = pure <$> f ide pid params -- | Make a handler for plugins with no extra data mkPluginNotificationHandler :: HasTracing (MessageParams m) => SClientMethod (m :: Method FromClient Notification) -> PluginNotificationMethodHandler ideState m -> PluginNotificationHandlers ideState mkPluginNotificationHandler m f = PluginNotificationHandlers $ DMap.singleton (IdeNotification m) (PluginNotificationHandler f') where f' pid ide vfs = f ide vfs pid defaultPluginDescriptor :: PluginId -> PluginDescriptor ideState defaultPluginDescriptor plId = PluginDescriptor plId mempty mempty mempty defaultConfigDescriptor mempty mempty Nothing newtype CommandId = CommandId T.Text deriving (Show, Read, Eq, Ord) instance IsString CommandId where fromString = CommandId . T.pack data PluginCommand ideState = forall a. (FromJSON a) => PluginCommand { commandId :: CommandId , commandDesc :: T.Text , commandFunc :: CommandFunction ideState a } -- --------------------------------------------------------------------- type CommandFunction ideState a = ideState -> a -> LspM Config (Either ResponseError Value) -- --------------------------------------------------------------------- newtype PluginId = PluginId T.Text deriving (Show, Read, Eq, Ord) instance IsString PluginId where fromString = PluginId . T.pack configForPlugin :: Config -> PluginId -> PluginConfig configForPlugin config (PluginId plugin) = Map.findWithDefault Data.Default.def plugin (plugins config) -- | Checks that a given plugin is both enabled and the specific feature is -- enabled pluginEnabledConfig :: (PluginConfig -> Bool) -> PluginId -> Config -> Bool pluginEnabledConfig f pid config = plcGlobalOn pluginConfig && f pluginConfig where pluginConfig = configForPlugin config pid -- --------------------------------------------------------------------- -- | Format the given Text as a whole or only a @Range@ of it. -- Range must be relative to the text to format. -- To format the whole document, read the Text from the file and use 'FormatText' -- as the FormattingType. data FormattingType = FormatText | FormatRange Range type FormattingMethod m = ( J.HasOptions (MessageParams m) FormattingOptions , J.HasTextDocument (MessageParams m) TextDocumentIdentifier , ResponseResult m ~ List TextEdit ) type FormattingHandler a = a -> FormattingType -> T.Text -> NormalizedFilePath -> FormattingOptions -> LspM Config (Either ResponseError (List TextEdit)) mkFormattingHandlers :: forall a. FormattingHandler a -> PluginHandlers a mkFormattingHandlers f = mkPluginHandler STextDocumentFormatting (provider STextDocumentFormatting) <> mkPluginHandler STextDocumentRangeFormatting (provider STextDocumentRangeFormatting) where provider :: forall m. FormattingMethod m => SMethod m -> PluginMethodHandler a m provider m ide _pid params | Just nfp <- uriToNormalizedFilePath $ toNormalizedUri uri = do mf <- getVirtualFile $ toNormalizedUri uri case mf of Just vf -> do let typ = case m of STextDocumentFormatting -> FormatText STextDocumentRangeFormatting -> FormatRange (params ^. J.range) _ -> error "mkFormattingHandlers: impossible" f ide typ (virtualFileText vf) nfp opts Nothing -> pure $ Left $ responseError $ T.pack $ "Formatter plugin: could not get file contents for " ++ show uri | otherwise = pure $ Left $ responseError $ T.pack $ "Formatter plugin: uriToFilePath failed for: " ++ show uri where uri = params ^. J.textDocument . J.uri opts = params ^. J.options -- --------------------------------------------------------------------- responseError :: T.Text -> ResponseError responseError txt = ResponseError InvalidParams txt Nothing -- --------------------------------------------------------------------- data FallbackCodeActionParams = FallbackCodeActionParams { fallbackWorkspaceEdit :: Maybe WorkspaceEdit , fallbackCommand :: Maybe Command } deriving (Generic, ToJSON, FromJSON) -- --------------------------------------------------------------------- otSetUri :: SpanInFlight -> Uri -> IO () otSetUri sp (Uri t) = setTag sp "uri" (encodeUtf8 t) class HasTracing a where traceWithSpan :: SpanInFlight -> a -> IO () traceWithSpan _ _ = pure () instance {-# OVERLAPPABLE #-} (HasTextDocument a doc, HasUri doc Uri) => HasTracing a where traceWithSpan sp a = otSetUri sp (a ^. J.textDocument . J.uri) instance HasTracing Value instance HasTracing ExecuteCommandParams instance HasTracing DidChangeWatchedFilesParams where traceWithSpan sp DidChangeWatchedFilesParams{_changes} = setTag sp "changes" (encodeUtf8 $ fromString $ show _changes) instance HasTracing DidChangeWorkspaceFoldersParams instance HasTracing DidChangeConfigurationParams instance HasTracing InitializeParams instance HasTracing (Maybe InitializedParams) instance HasTracing WorkspaceSymbolParams where traceWithSpan sp (WorkspaceSymbolParams _ _ query) = setTag sp "query" (encodeUtf8 query) instance HasTracing CallHierarchyIncomingCallsParams instance HasTracing CallHierarchyOutgoingCallsParams -- --------------------------------------------------------------------- {-# NOINLINE pROCESS_ID #-} pROCESS_ID :: T.Text pROCESS_ID = unsafePerformIO getPid mkLspCommand :: PluginId -> CommandId -> T.Text -> Maybe [Value] -> Command mkLspCommand plid cn title args' = Command title cmdId args where cmdId = mkLspCmdId pROCESS_ID plid cn args = List <$> args' mkLspCmdId :: T.Text -> PluginId -> CommandId -> T.Text mkLspCmdId pid (PluginId plid) (CommandId cid) = pid <> ":" <> plid <> ":" <> cid -- | Get the operating system process id for the running server -- instance. This should be the same for the lifetime of the instance, -- and different from that of any other currently running instance. getPid :: IO T.Text getPid = T.pack . show <$> getProcessID getProcessID :: IO Int installSigUsr1Handler :: IO () -> IO () #ifdef mingw32_HOST_OS getProcessID = fromIntegral <$> P.getCurrentProcessId installSigUsr1Handler _ = return () #else getProcessID = fromIntegral <$> P.getProcessID installSigUsr1Handler h = void $ installHandler sigUSR1 (Catch h) Nothing #endif