[Macros] Turn Macro into a declaration node.

Although the declaration of macros doesn't appear in Swift source code
that uses macros, they still operate as declarations within the
language. Rework `Macro` as `MacroDecl`, a generic value declaration,
which appropriate models its place in the language.

The vast majority of this change is in extending all of the various
switches on declaration kinds to account for macros.

lib/IDE/CodeCompletionConsumer.cpp

@@ -60,6 +60,7 @@ static MutableArrayRef<CodeCompletionResult *> copyCodeCompletionResults(
       case CodeCompletionDeclKind::InstanceVar:
       case CodeCompletionDeclKind::LocalVar:
       case CodeCompletionDeclKind::GlobalVar:
+      case CodeCompletionDeclKind::Macro:
         return false;
       }