Added Publishable subclassing support

.github/workflows/pull-request.yml

@@ -12,7 +12,7 @@ concurrency:
   cancel-in-progress: true
 
 env:
-  XCODE_VERSION: "26.1"
+  XCODE_VERSION: "26.0"
 
 jobs:
   prepare:
@@ -88,16 +88,16 @@ jobs:
             destination="platform=macOS,variant=Mac Catalyst"
             ;;
           ios)
-            destination="platform=iOS Simulator,name=iPhone 17 Pro Max,OS=26.1"
+            destination="platform=iOS Simulator,name=iPhone 17 Pro Max,OS=26.0.1"
             ;;
           tvos)
-            destination="platform=tvOS Simulator,name=Apple TV 4K (3rd generation),OS=26.1"
+            destination="platform=tvOS Simulator,name=Apple TV 4K (3rd generation),OS=26.0"
             ;;
           watchos)
-            destination="platform=watchOS Simulator,name=Apple Watch Series 11 (46mm),OS=26.1"
+            destination="platform=watchOS Simulator,name=Apple Watch Series 11 (46mm),OS=26.0"
             ;;
           visionos)
-            destination="platform=visionOS Simulator,name=Apple Vision Pro,OS=26.1"
+            destination="platform=visionOS Simulator,name=Apple Vision Pro,OS=26.0"
             ;;
           *)
             echo "Unknown platform: ${{ matrix.platform }}"

.github/workflows/release.yml

@@ -6,7 +6,7 @@ on:
       - '*'
 
 env:
-  XCODE_VERSION: "26.1"
+  XCODE_VERSION: "26.0"
 
 jobs:
   release:

.swiftlint.tests.yml

@@ -1,3 +1,4 @@
 disabled_rules:
     - function_body_length
+    - type_body_length
     - no_magic_numbers

.swiftlint.yml

@@ -8,7 +8,7 @@ opt_in_rules:
     - anonymous_argument_in_multiline_closure
     - array_init
     - async_without_await
-    # attributes
+    # attributes (swiftformat)
     # balanced_xctest_lifecycle
     # closure_body_length
     - closure_end_indentation
@@ -27,7 +27,7 @@ opt_in_rules:
     - discouraged_assert
     - discouraged_none_name
     - discouraged_object_literal
-    - discouraged_optional_boolean
+    # discouraged_optional_boolean
     - discouraged_optional_collection
     - empty_collection_literal
     - empty_count
@@ -55,9 +55,9 @@ opt_in_rules:
     - ibinspectable_in_extension
     - identical_operands
     - implicit_return
-    # implicitly_unwrapped_optional
+    - implicitly_unwrapped_optional
     # incompatible_concurrency_annotation
-    # indentation_width
+    # indentation_width (swiftformat)
     - joined_default_parameter
     - last_where
     - legacy_multiple
@@ -67,7 +67,7 @@ opt_in_rules:
     - local_doc_comment
     - lower_acl_than_parent
     # missing_docs
-    - modifier_order
+    # modifier_order (swiftformat)
     - multiline_arguments
     - multiline_arguments_brackets
     - multiline_function_chains
@@ -144,7 +144,7 @@ opt_in_rules:
     # vertical_whitespace_opening_braces
     - weak_delegate
     - xct_specific_matcher
-    # yoda_condition
+    # yoda_condition (swiftformat)
 
 analyzer_rules:
     - capture_variable
@@ -173,6 +173,7 @@ identifier_name:
     excluded: [id, ui, x, y, z, dx, dy, dz]
 
 line_length:
+    ignores_multiline_strings: true
     ignores_comments: true
 
 nesting:
@@ -189,10 +190,6 @@ type_contents_order:
     order: [[case], [type_alias, associated_type], [subtype], [type_property], [instance_property], [ib_inspectable], [ib_outlet], [initializer], [deinitializer], [type_method], [view_life_cycle_method], [ib_action, ib_segue_action], [other_method], [subscript]]
 
 custom_rules:
-    global_actor_attribute_order:
-        name: "Global actor attribute order"
-        message: "Global actor should be the first attribute."
-        regex: "(?-s)(@.+[^,\\s]\\s+@.*Actor\\s)"
     sendable_attribute_order:
         name: "Sendable attribute order"
         message: "Sendable should be the first attribute."
@@ -204,4 +201,4 @@ custom_rules:
     empty_line_after_type_declaration:
         name: "Empty line after type declaration"
         message: "Type declaration should start with an empty line."
-        regex: "( |^)(actor|class|struct|enum|protocol|extension) (?!var)[^\\{]*? \\{(?!\\s*\\}) *\\n? *\\S"
+        regex: "( |^)(actor|class|struct|enum|protocol|extension) (?!var)[^\\n\\{]*? \\{(?!\\s*\\}) *\\n? *\\S"

Macros/RelayMacros/Combine/Common/ObservableMacro.swift

@@ -0,0 +1,14 @@
+//
+//  ObservableMacro.swift
+//  Relay
+//
+//  Created by Kamil Strzelecki on 23/11/2025.
+//  Copyright © 2025 Kamil Strzelecki. All rights reserved.
+//
+
+import SwiftSyntaxMacros
+
+internal enum ObservableMacro {
+
+    static let attribute: AttributeSyntax = "@Observable"
+}

Macros/RelayMacros/Combine/Common/ObservationIgnoredMacro.swift

@@ -0,0 +1,25 @@
+//
+//  ObservationIgnoredMacro.swift
+//  Relay
+//
+//  Created by Kamil Strzelecki on 22/11/2025.
+//  Copyright © 2025 Kamil Strzelecki. All rights reserved.
+//
+
+import SwiftSyntaxMacros
+
+internal enum ObservationIgnoredMacro {
+
+    static let attribute: AttributeSyntax = "@ObservationIgnored"
+}
+
+extension Property {
+
+    var isStoredObservationTracked: Bool {
+        kind == .stored
+            && mutability == .mutable
+            && underlying.typeScopeSpecifier == nil
+            && underlying.overrideSpecifier == nil
+            && !underlying.attributes.contains(like: ObservationIgnoredMacro.attribute)
+    }
+}

Macros/RelayMacros/Combine/Common/PropertyPublisherDeclBuilder.swift

@@ -0,0 +1,187 @@
+//
+//  PropertyPublisherDeclBuilder.swift
+//  Relay
+//
+//  Created by Kamil Strzelecki on 12/01/2025.
+//  Copyright © 2025 Kamil Strzelecki. All rights reserved.
+//
+
+import SwiftSyntaxMacros
+
+internal struct PropertyPublisherDeclBuilder: ClassDeclBuilder, MemberBuilding {
+
+    let declaration: ClassDeclSyntax
+    let properties: PropertiesList
+    let trimmedSuperclassType: TypeSyntax?
+    let preferredGlobalActorIsolation: GlobalActorIsolation?
+
+    func build() -> [DeclSyntax] {
+        [
+            """
+            \(inheritedGlobalActorIsolation)\(inheritedAccessControlLevelAllowingOpen)\(inheritedFinalModifier)\
+            class PropertyPublisher: \(inheritanceClause()) {
+
+                private final unowned let object: \(trimmedType)
+
+                \(objectWillChangeDidChangePublishers())
+
+                \(initializer())
+
+                \(deinitializer())
+
+                \(storedPropertiesPublishers().formatted())
+
+                \(computedPropertiesPublishers().formatted())
+
+                \(memoizedPropertiesPublishers().formatted())
+            }
+            """
+        ]
+    }
+
+    private func inheritanceClause() -> TypeSyntax {
+        if let trimmedSuperclassType {
+            "\(trimmedSuperclassType).PropertyPublisher"
+        } else {
+            "Relay.AnyPropertyPublisher"
+        }
+    }
+
+    private func objectWillChangeDidChangePublishers() -> MemberBlockItemListSyntax {
+        let notation = CamelCaseNotation(string: trimmedType.description)
+        let prefix = notation.joined(as: .lowerCamelCase)
+
+        return """
+        \(inheritedAccessControlLevel)final var \
+        \(raw: prefix)WillChange: some Publisher<\(trimmedType), Never> {
+            willChange.map { [unowned object] _ in
+                object 
+            }
+        }
+
+        \(inheritedAccessControlLevel)final var \
+        \(raw: prefix)DidChange: some Publisher<\(trimmedType), Never> {
+            didChange.map { [unowned object] _ in
+                object 
+            }
+        }
+        """
+    }
+
+    private func initializer() -> MemberBlockItemListSyntax {
+        """
+        \(inheritedAccessControlLevel)init(object: \(trimmedType)) {
+            self.object = object
+            super.init(object: object)
+        }
+        """
+    }
+
+    private func deinitializer() -> MemberBlockItemListSyntax {
+        """
+        \(inheritedGlobalActorIsolation)deinit {
+            \(storedPropertiesSubjectsFinishCalls().formatted())
+        }
+        """
+    }
+
+    @CodeBlockItemListBuilder
+    private func storedPropertiesSubjectsFinishCalls() -> CodeBlockItemListSyntax {
+        for property in properties.all where property.isStoredPublisherTracked {
+            let call = storedPropertySubjectFinishCall(for: property)
+            if let ifConfigCall = property.underlying.applyingEnclosingIfConfig(to: call) {
+                ifConfigCall
+            } else {
+                call
+            }
+        }
+    }
+
+    private func storedPropertySubjectFinishCall(for property: Property) -> CodeBlockItemListSyntax {
+        "_\(property.trimmedName).send(completion: .finished)"
+    }
+
+    @MemberBlockItemListBuilder
+    private func storedPropertiesPublishers() -> MemberBlockItemListSyntax {
+        for property in properties.all where property.isStoredPublisherTracked {
+            let publisher = storedPropertyPublisher(for: property)
+            if let ifConfigPublisher = property.underlying.applyingEnclosingIfConfig(to: publisher) {
+                ifConfigPublisher
+            } else {
+                publisher
+            }
+        }
+    }
+
+    private func storedPropertyPublisher(for property: Property) -> MemberBlockItemListSyntax {
+        // Stored properties cannot be made potentially unavailable
+        let accessControlLevel = AccessControlLevel.forSibling(of: property.underlying)
+        let name = property.trimmedName
+        let type = property.inferredType
+
+        return """
+        fileprivate final let _\(name) = PassthroughSubject<\(type), Never>()
+        \(accessControlLevel)final var \(name): some Publisher<\(type), Never> {
+            _storedPropertyPublisher(_\(name), for: \\.\(name), object: object)
+        }
+        """
+    }
+
+    @MemberBlockItemListBuilder
+    private func computedPropertiesPublishers() -> MemberBlockItemListSyntax {
+        for property in properties.all where property.isComputedPublisherTracked {
+            let publisher = computedPropertyPublisher(for: property)
+            if let ifConfigPublisher = property.underlying.applyingEnclosingIfConfig(to: publisher) {
+                ifConfigPublisher
+            } else {
+                publisher
+            }
+        }
+    }
+
+    private func computedPropertyPublisher(for property: Property) -> MemberBlockItemListSyntax {
+        let accessControlLevel = AccessControlLevel.forSibling(of: property.underlying)
+        let availability = property.availability?.trimmed.withTrailingNewline
+        let name = property.trimmedName
+        let type = property.inferredType
+
+        return """
+        \(availability)\(accessControlLevel)final var \(name): some Publisher<\(type), Never> {
+            _computedPropertyPublisher(for: \\.\(name), object: object)
+        }
+        """
+    }
+
+    @MemberBlockItemListBuilder
+    private func memoizedPropertiesPublishers() -> MemberBlockItemListSyntax {
+        for member in declaration.memberBlock.members {
+            if let extractionResult = MemoizedMacro.extract(from: member.decl) {
+                let declaration = extractionResult.declaration
+
+                if !declaration.attributes.contains(like: PublisherIgnoredMacro.attribute) {
+                    let publisher = memoizedPropertyPublisher(for: extractionResult)
+                    if let ifConfigPublisher = declaration.applyingEnclosingIfConfig(to: publisher) {
+                        ifConfigPublisher
+                    } else {
+                        publisher
+                    }
+                }
+            }
+        }
+    }
+
+    private func memoizedPropertyPublisher(
+        for extractionResult: MemoizedMacro.ExtractionResult
+    ) -> MemberBlockItemListSyntax {
+        let accessControlLevel = extractionResult.preferredAccessControlLevel?.inheritedBySibling()
+        let availability = extractionResult.declaration.availability?.trimmed.withTrailingNewline
+        let name = extractionResult.propertyName
+        let type = extractionResult.trimmedReturnType
+
+        return """
+        \(availability)\(accessControlLevel)final var \(raw: name): some Publisher<\(type), Never> {
+            _computedPropertyPublisher(for: \\.\(raw: name), object: object)
+        }
+        """
+    }
+}

Macros/RelayMacros/Publishable/PublisherDeclBuilder.swift → Macros/RelayMacros/Combine/Common/PublisherDeclBuilder.swift

@@ -11,10 +11,13 @@ import SwiftSyntaxMacros
 internal struct PublisherDeclBuilder: ClassDeclBuilder, MemberBuilding {
 
     let declaration: ClassDeclSyntax
-    let properties: PropertiesList
+    let trimmedSuperclassType: TypeSyntax?
 
     func build() -> [DeclSyntax] {
         [
+            """
+            private final lazy var _publisher = PropertyPublisher(object: self)
+            """,
             """
             /// A ``PropertyPublisher`` which exposes `Combine` publishers for all mutable 
             /// or computed instance properties of this object.
@@ -23,7 +26,9 @@ internal struct PublisherDeclBuilder: ClassDeclBuilder, MemberBuilding {
             /// the original object has been deallocated may result in a crash. Always access it directly 
             /// through the object that exposes it.
             ///
-            \(inheritedAccessControlLevel)private(set) lazy var publisher = PropertyPublisher(object: self)
+            \(inheritedOverrideModifier)\(inheritedAccessControlLevelAllowingOpen)var publisher: PropertyPublisher {
+                _publisher
+            }
             """
         ]
     }