Organize Macro Examples into Type-Specific Directories

This commit restructures the macro examples into type-specific directories, streamlining the search process for newcomers and enhancing overall accessibility

Author: Matejkob

Examples/Sources/MacroExamples/Implementation/DictionaryIndirectionMacro.swift renamed to Examples/Sources/MacroExamples/Implementation/ComplexMacros/DictionaryIndirectionMacro.swift

@@ -16,13 +16,13 @@ import SwiftSyntaxMacros
 /// Implementation of the `#fontLiteral` macro, which is similar in spirit
 /// to the built-in expressions `#colorLiteral`, `#imageLiteral`, etc., but in
 /// a small macro.
-public struct FontLiteralMacro: ExpressionMacro {
+public enum FontLiteralMacro: ExpressionMacro {
   public static func expansion(
-    of macro: some FreestandingMacroExpansionSyntax,
+    of node: some FreestandingMacroExpansionSyntax,
     in context: some MacroExpansionContext
-  ) -> ExprSyntax {
+  ) throws -> ExprSyntax {
     let argList = replaceFirstLabel(
-      of: macro.arguments,
+      of: node.arguments,
       with: "fontLiteralName"
     )
     return ".init(\(argList))"
@@ -40,6 +40,8 @@ private func replaceFirstLabel(
   }
 
   var tuple = tuple
-  tuple[tuple.startIndex] = firstElement.with(\.label, .identifier(newLabel))
+  tuple[tuple.startIndex] = firstElement
+    .with(\.label, .identifier(newLabel))
+    .with(\.colon, .colonToken())
   return tuple
 }

Examples/Sources/MacroExamples/Implementation/ObservableMacro.swift renamed to Examples/Sources/MacroExamples/Implementation/ComplexMacros/ObservableMacro.swift

@@ -23,7 +23,7 @@ import SwiftSyntaxMacros
 ///  will expand to
 ///
 ///     (x + y, "x + y")
-public struct StringifyMacro: ExpressionMacro {
+public enum StringifyMacro: ExpressionMacro {
   public static func expansion(
     of node: some FreestandingMacroExpansionSyntax,
     in context: some MacroExpansionContext

Examples/Sources/MacroExamples/Implementation/OptionSetMacro.swift renamed to Examples/Sources/MacroExamples/Implementation/ComplexMacros/OptionSetMacro.swift

@@ -16,12 +16,11 @@ import SwiftSyntaxMacros
 
 /// Creates a non-optional URL from a static string. The string is checked to
 /// be valid during compile time.
-public struct URLMacro: ExpressionMacro {
+public enum URLMacro: ExpressionMacro {
   public static func expansion(
     of node: some FreestandingMacroExpansionSyntax,
     in context: some MacroExpansionContext
   ) throws -> ExprSyntax {
-
     guard let argument = node.arguments.first?.expression,
       let segments = argument.as(StringLiteralExprSyntax.self)?.segments,
       segments.count == 1,

Examples/Sources/MacroExamples/Implementation/AddBlocker.swift renamed to Examples/Sources/MacroExamples/Implementation/Expression/AddBlocker.swift

@@ -16,12 +16,12 @@ import SwiftSyntaxMacros
 
 /// Implementation of the `myWarning` macro, which mimics the behavior of the
 /// built-in `#warning`.
-public struct WarningMacro: ExpressionMacro {
+public enum WarningMacro: ExpressionMacro {
   public static func expansion(
-    of macro: some FreestandingMacroExpansionSyntax,
+    of node: some FreestandingMacroExpansionSyntax,
     in context: some MacroExpansionContext
   ) throws -> ExprSyntax {
-    guard let firstElement = macro.arguments.first,
+    guard let firstElement = node.arguments.first,
       let stringLiteral = firstElement.expression
         .as(StringLiteralExprSyntax.self),
       stringLiteral.segments.count == 1,
@@ -32,10 +32,10 @@ public struct WarningMacro: ExpressionMacro {
 
     context.diagnose(
       Diagnostic(
-        node: Syntax(macro),
+        node: Syntax(node),
         message: SimpleDiagnosticMessage(
           message: messageString.content.description,
-          diagnosticID: MessageID(domain: "test", id: "error"),
+          diagnosticID: MessageID(domain: "test123", id: "error"),
           severity: .warning
         )
       )

Examples/Sources/MacroExamples/Implementation/FontLiteralMacro.swift renamed to Examples/Sources/MacroExamples/Implementation/Expression/FontLiteralMacro.swift

@@ -13,25 +13,11 @@
 import SwiftSyntax
 import SwiftSyntaxMacros
 
-extension TokenSyntax {
-  fileprivate var initialUppercased: String {
-    let name = self.text
-    guard let initial = name.first else {
-      return name
-    }
-
-    return "\(initial.uppercased())\(name.dropFirst())"
-  }
-}
-
-public struct CaseDetectionMacro: MemberMacro {
-  public static func expansion<
-    Declaration: DeclGroupSyntax,
-    Context: MacroExpansionContext
-  >(
+public enum CaseDetectionMacro: MemberMacro {
+  public static func expansion(
     of node: AttributeSyntax,
-    providingMembersOf declaration: Declaration,
-    in context: Context
+    providingMembersOf declaration: some DeclGroupSyntax,
+    in context: some MacroExpansionContext
   ) throws -> [DeclSyntax] {
     declaration.memberBlock.members
       .compactMap { $0.decl.as(EnumCaseDeclSyntax.self) }
@@ -50,3 +36,14 @@ public struct CaseDetectionMacro: MemberMacro {
       }
   }
 }
+
+extension TokenSyntax {
+  fileprivate var initialUppercased: String {
+    let name = self.text
+    guard let initial = name.first else {
+      return name
+    }
+
+    return "\(initial.uppercased())\(name.dropFirst())"
+  }
+}

Examples/Sources/MacroExamples/Implementation/StringifyMacro.swift renamed to Examples/Sources/MacroExamples/Implementation/Expression/StringifyMacro.swift

@@ -13,14 +13,12 @@
 import SwiftSyntax
 import SwiftSyntaxMacros
 
-public struct CustomCodable: MemberMacro {
-
+public enum CustomCodable: MemberMacro {
   public static func expansion(
     of node: AttributeSyntax,
     providingMembersOf declaration: some DeclGroupSyntax,
     in context: some MacroExpansionContext
   ) throws -> [DeclSyntax] {
-
     let memberList = declaration.memberBlock.members
 
     let cases = memberList.compactMap({ member -> String? in
@@ -53,8 +51,6 @@ public struct CustomCodable: MemberMacro {
 
       """
 
-    return [
-      codingKeys
-    ]
+    return [codingKeys]
   }
 }