Add macros

.swiftpm/xcode/xcshareddata/xcschemes/RefdsDesignPatterns.xcscheme

@@ -0,0 +1,67 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Scheme
+   LastUpgradeVersion = "1600"
+   version = "1.7">
+   <BuildAction
+      parallelizeBuildables = "YES"
+      buildImplicitDependencies = "YES"
+      buildArchitectures = "Automatic">
+      <BuildActionEntries>
+         <BuildActionEntry
+            buildForTesting = "YES"
+            buildForRunning = "YES"
+            buildForProfiling = "YES"
+            buildForArchiving = "YES"
+            buildForAnalyzing = "YES">
+            <BuildableReference
+               BuildableIdentifier = "primary"
+               BlueprintIdentifier = "RefdsDesignPatterns"
+               BuildableName = "RefdsDesignPatterns"
+               BlueprintName = "RefdsDesignPatterns"
+               ReferencedContainer = "container:">
+            </BuildableReference>
+         </BuildActionEntry>
+      </BuildActionEntries>
+   </BuildAction>
+   <TestAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      shouldAutocreateTestPlan = "YES">
+   </TestAction>
+   <LaunchAction
+      buildConfiguration = "Debug"
+      selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
+      selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
+      launchStyle = "0"
+      useCustomWorkingDirectory = "NO"
+      ignoresPersistentStateOnLaunch = "NO"
+      debugDocumentVersioning = "YES"
+      debugServiceExtension = "internal"
+      allowLocationSimulation = "YES">
+   </LaunchAction>
+   <ProfileAction
+      buildConfiguration = "Release"
+      shouldUseLaunchSchemeArgsEnv = "YES"
+      savedToolIdentifier = ""
+      useCustomWorkingDirectory = "NO"
+      debugDocumentVersioning = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "RefdsDesignPatterns"
+            BuildableName = "RefdsDesignPatterns"
+            BlueprintName = "RefdsDesignPatterns"
+            ReferencedContainer = "container:">
+         </BuildableReference>
+      </MacroExpansion>
+   </ProfileAction>
+   <AnalyzeAction
+      buildConfiguration = "Debug">
+   </AnalyzeAction>
+   <ArchiveAction
+      buildConfiguration = "Release"
+      revealArchiveInOrganizer = "YES">
+   </ArchiveAction>
+</Scheme>

Package.swift

@@ -2,6 +2,7 @@
 // The swift-tools-version declares the minimum version of Swift required to build this package.
 
 import PackageDescription
+import CompilerPluginSupport
 
 let package = Package(
     name: "RefdsDesignPatterns",
@@ -21,16 +22,21 @@ let package = Package(
             targets: ["RefdsRedux"]),
     ],
     dependencies: [
-        .package(url: "https://github.com/rafaelesantos/refds-shared.git", branch: "main")
+        .package(url: "https://github.com/rafaelesantos/refds-shared.git", branch: "main"),
+        .package(url: "https://github.com/swiftlang/swift-syntax.git", branch: "main")
     ],
     targets: [
+        .macro(
+            name: "RefdsReduxMacros",
+            dependencies: [
+                .product(name: "SwiftSyntaxMacros", package: "swift-syntax"),
+                .product(name: "SwiftCompilerPlugin", package: "swift-syntax")
+            ]),
         .target(
             name: "RefdsRedux",
             dependencies: [
-                .product(
-                    name: "RefdsShared",
-                    package: "refds-shared"
-                )
-            ]),
+                "RefdsReduxMacros",
+                .product(name: "RefdsShared", package: "refds-shared")
+            ])
     ]
 )

Sources/RefdsRedux/RefdsReduxActionProtocol.swift

@@ -0,0 +1,6 @@
+import Foundation
+
+@attached(extension, conformances: RefdsReduxActionProtocol)
+public macro RefdsReduxAction() = #externalMacro(module: "RefdsReduxMacros", type: "RefdsReduxActionMacro")
+
+public protocol RefdsReduxActionProtocol: Sendable {}

Sources/RefdsRedux/RefdsReduxMiddlewareProtocol.swift

@@ -0,0 +1,18 @@
+import Foundation
+
+@attached(extension, conformances: RefdsReduxMiddlewareProtocol)
+public macro RefdsReduxMiddleware<
+    State: RefdsReduxStateProtocol
+>() = #externalMacro(
+    module: "RefdsReduxMacros",
+    type: "RefdsReduxMiddlewareMacro"
+)
+
+public protocol RefdsReduxMiddlewareProtocol {
+    associatedtype State: RefdsReduxStateProtocol
+
+    func middleware(
+        state: State,
+        action: RefdsReduxActionProtocol
+    ) async -> AsyncStream<RefdsReduxActionProtocol>
+}

Sources/RefdsRedux/RefdsReduxReducerProtocol.swift

@@ -0,0 +1,17 @@
+import Foundation
+
+@attached(extension, conformances: RefdsReduxReducerProtocol)
+public macro RefdsReduxReducer<
+    State: RefdsReduxStateProtocol,
+    Action: RefdsReduxActionProtocol
+>() = #externalMacro(module: "RefdsReduxMacros", type: "RefdsReduxReducerMacro")
+
+public protocol RefdsReduxReducerProtocol {
+    associatedtype State: RefdsReduxStateProtocol
+    associatedtype Action: RefdsReduxActionProtocol
+
+    func reduce(
+        state: State,
+        action: Action
+    ) async -> State
+}

Sources/RefdsRedux/RefdsReduxStateProtocol.swift

@@ -0,0 +1,6 @@
+import Foundation
+
+@attached(extension, conformances: RefdsReduxStateProtocol)
+public macro RefdsReduxState() = #externalMacro(module: "RefdsReduxMacros", type: "RefdsReduxStateMacro")
+
+public protocol RefdsReduxStateProtocol: Sendable, Equatable {}

Sources/RefdsRedux/RefdsReduxStoreProtocol.swift

@@ -0,0 +1,38 @@
+import Foundation
+import SwiftUI
+
+@attached(extension, conformances: RefdsReduxStoreProtocol)
+public macro RefdsReduxStore<
+    State: RefdsReduxStateProtocol
+>() = #externalMacro(
+    module: "RefdsReduxMacros",
+    type: "RefdsReduxStoreMacro"
+)
+
+@MainActor
+public protocol RefdsReduxStoreProtocol: ObservableObject {
+    associatedtype State: RefdsReduxStateProtocol
+
+    var state: State { get set }
+    var reducer: (State, RefdsReduxActionProtocol) async -> State { get }
+    var middlewares: [(State, RefdsReduxActionProtocol) async -> AsyncStream<RefdsReduxActionProtocol>] { get }
+
+    func dispatch(action: RefdsReduxActionProtocol) async
+}
+
+public extension RefdsReduxStoreProtocol {
+    func dispatch(action: RefdsReduxActionProtocol) async {
+        let middlewares = self.middlewares
+        let stateReduced = await reducer(state, action)
+
+        withAnimation(.easeInOut) { state = stateReduced }
+
+        for middleware in middlewares {
+            let actions = await middleware(state, action)
+
+            for await action in actions {
+                await dispatch(action: action)
+            }
+        }
+    }
+}

Sources/RefdsReduxMacros/RefdsReduxActionMacro.swift

@@ -0,0 +1,19 @@
+import SwiftCompilerPlugin
+import SwiftSyntax
+import SwiftSyntaxBuilder
+import SwiftSyntaxMacros
+
+public struct RefdsReduxActionMacro: ExpressionMacro {
+    public static func expansion(
+        of node: some FreestandingMacroExpansionSyntax,
+        in context: some MacroExpansionContext
+    ) -> ExprSyntax {
+        guard let enumDecl = node.as(EnumDeclSyntax.self) else {
+            fatalError("@RefdsReduxAction must be applied to an enum.")
+        }
+        let protocolConformance = """
+        extension \(enumDecl.name.text): RefdsReduxActionProtocol {}
+        """
+        return ExprSyntax(stringLiteral: protocolConformance)
+    }
+}

Sources/RefdsReduxMacros/RefdsReduxMacroPlugin.swift

@@ -0,0 +1,15 @@
+import SwiftCompilerPlugin
+import SwiftSyntax
+import SwiftSyntaxBuilder
+import SwiftSyntaxMacros
+
+@main
+struct RefdsReduxMacroPlugin: CompilerPlugin {
+    let providingMacros: [Macro.Type] = [
+        RefdsReduxActionMacro.self,
+        RefdsReduxStateMacro.self,
+        RefdsReduxReducerMacro.self,
+        RefdsReduxMiddlewareMacro.self,
+        RefdsReduxStoreMacro.self
+    ]
+}

Sources/RefdsReduxMacros/RefdsReduxMiddlewareMacro.swift

@@ -0,0 +1,29 @@
+import SwiftCompilerPlugin
+import SwiftSyntax
+import SwiftSyntaxBuilder
+import SwiftSyntaxMacros
+
+public struct RefdsReduxMiddlewareMacro: ExpressionMacro {
+    public static func expansion(
+        of node: some FreestandingMacroExpansionSyntax,
+        in context: some MacroExpansionContext
+    ) -> ExprSyntax {
+        guard let enumDecl = node.as(EnumDeclSyntax.self) else {
+            fatalError("@RefdsReduxMiddleware must be applied to an enum.")
+        }
+
+        let arguments = node.arguments
+        guard arguments.count == 1,
+              let stateType = arguments.first?.expression.description else {
+            fatalError("@RefdsReduxMiddleware must be applied with State type, e.g. @RefdsReduxMiddleware(State).")
+        }
+
+        let protocolConformance = """
+        extension \(enumDecl.name.text): RefdsReduxMiddlewareProtocol {
+            typealias State = \(stateType)
+        }
+        """
+
+        return ExprSyntax(stringLiteral: protocolConformance)
+    }
+}

Sources/RefdsReduxMacros/RefdsReduxReducerMacro.swift

@@ -0,0 +1,31 @@
+import SwiftCompilerPlugin
+import SwiftSyntax
+import SwiftSyntaxBuilder
+import SwiftSyntaxMacros
+
+public struct RefdsReduxReducerMacro: ExpressionMacro {
+    public static func expansion(
+        of node: some FreestandingMacroExpansionSyntax,
+        in context: some MacroExpansionContext
+    ) -> ExprSyntax {
+        guard let enumDecl = node.as(EnumDeclSyntax.self) else {
+            fatalError("@RefdsReduxReducer must be applied to an enum.")
+        }
+
+        let arguments = node.arguments
+        guard arguments.count == 2,
+              let stateType = arguments.first?.expression.description,
+              let actionType = arguments.last?.expression.description else {
+            fatalError("@RefdsReduxReducer must be applied with State and Action types, e.g. @RefdsReduxReducer(State, Action).")
+        }
+
+        let protocolConformance = """
+        extension \(enumDecl.name.text): RefdsReduxReducerProtocol {
+            typealias State = \(stateType)
+            typealias Action = \(actionType)
+        }
+        """
+
+        return ExprSyntax(stringLiteral: protocolConformance)
+    }
+}

Sources/RefdsReduxMacros/RefdsReduxStateMacro.swift

@@ -0,0 +1,19 @@
+import SwiftCompilerPlugin
+import SwiftSyntax
+import SwiftSyntaxBuilder
+import SwiftSyntaxMacros
+
+public struct RefdsReduxStateMacro: ExpressionMacro {
+    public static func expansion(
+        of node: some FreestandingMacroExpansionSyntax,
+        in context: some MacroExpansionContext
+    ) -> ExprSyntax {
+        guard let enumDecl = node.as(EnumDeclSyntax.self) else {
+            fatalError("@RefdsReduxState must be applied to an enum.")
+        }
+        let protocolConformance = """
+        extension \(enumDecl.name.text): RefdsReduxStateProtocol {}
+        """
+        return ExprSyntax(stringLiteral: protocolConformance)
+    }
+}