Swift 6.2 Back-port (#141)

* Bring in changes from Swift 6.2

* wip

* wip

* wip

* wip

* Remove macro compatibility check

* Revert "Remove macro compatibility check"

This reverts commit 6fa5ce7.

* fix

* wip

* remove for now

* wip

* wip

* wip

* wip

* rename

* wip

* wip

Author: stephencelis

.github/workflows/ci.yml

@@ -18,9 +18,9 @@ jobs:
     name: macOS
     strategy:
       matrix:
-        xcode: ['15.4']
+        xcode: ['16.4']
         config: ['debug', 'release']
-    runs-on: macos-14
+    runs-on: macos-15
     steps:
       - uses: actions/checkout@v4
       - name: Select Xcode ${{ matrix.xcode }}
@@ -61,15 +61,3 @@ jobs:
 
       - name: Build
         run: swift build --swift-sdk wasm32-unknown-wasi -Xlinker -z -Xlinker stack-size=$((1024 * 1024))
-
-  check-macro-compatibility:
-    name: Check Macro Compatibility
-    runs-on: macos-latest
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-      - name: Run Swift Macro Compatibility Check
-        uses: Matejkob/swift-macro-compatibility-check@v1
-        with:
-          run-tests: false
-          major-versions-only: true

Example/Example.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved

@@ -1,4 +1,4 @@
-PLATFORM_IOS = iOS Simulator,id=$(call udid_for,iOS 17.2,iPhone \d\+ Pro [^M])
+PLATFORM_IOS = iOS Simulator,id=$(call udid_for,iOS 18.5,iPhone \d\+ Pro [^M])
 
 test-compatibility:
 	xcodebuild \

Makefile

@@ -1,4 +1,4 @@
-// swift-tools-version: 5.9
+// swift-tools-version: 6.0
 
 import CompilerPluginSupport
 import PackageDescription
@@ -12,13 +12,19 @@ let package = Package(
     .watchOS(.v6),
   ],
   products: [
-    .library(name: "Perception", targets: ["Perception"]),
-    .library(name: "PerceptionCore", targets: ["PerceptionCore"]),
+    .library(
+      name: "PerceptionCore",
+      targets: ["PerceptionCore"]
+    ),
+    .library(
+      name: "Perception",
+      targets: ["Perception"]
+    ),
   ],
   dependencies: [
-    .package(url: "https://github.com/pointfreeco/swift-macro-testing", from: "0.1.0"),
+    .package(url: "https://github.com/pointfreeco/swift-macro-testing", from: "0.6.0"),
+    .package(url: "https://github.com/pointfreeco/xctest-dynamic-overlay", from: "1.6.0"),
     .package(url: "https://github.com/swiftlang/swift-syntax", "509.0.0"..<"602.0.0"),
-    .package(url: "https://github.com/pointfreeco/xctest-dynamic-overlay", from: "1.2.2"),
   ],
   targets: [
     .target(
@@ -34,31 +40,31 @@ let package = Package(
         .product(name: "IssueReporting", package: "xctest-dynamic-overlay"),
       ]
     ),
-    .testTarget(
-      name: "PerceptionTests",
-      dependencies: ["Perception"]
-    ),
-
     .macro(
       name: "PerceptionMacros",
       dependencies: [
         .product(name: "SwiftSyntaxMacros", package: "swift-syntax"),
         .product(name: "SwiftCompilerPlugin", package: "swift-syntax"),
       ]
     ),
+    .testTarget(
+      name: "PerceptionTests",
+      dependencies: ["Perception"]
+    ),
     .testTarget(
       name: "PerceptionMacrosTests",
       dependencies: [
         "PerceptionMacros",
         .product(name: "MacroTesting", package: "swift-macro-testing"),
       ]
     ),
-  ]
+  ],
+  swiftLanguageModes: [.v5]
 )
 
-for target in package.targets where target.type != .system {
-  target.swiftSettings = target.swiftSettings ?? []
-  target.swiftSettings?.append(contentsOf: [
-    .enableExperimentalFeature("StrictConcurrency"),
-  ])
-}
+#if !os(Windows)
+  // Add the documentation compiler plugin if possible
+  package.dependencies.append(
+    .package(url: "https://github.com/apple/swift-docc-plugin", from: "1.0.0")
+  )
+#endif

Package.resolved

@@ -5,7 +5,7 @@
 [![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fpointfreeco%2Fswift-perception%2Fbadge%3Ftype%3Dswift-versions)](https://swiftpackageindex.com/pointfreeco/swift-perception)
 [![](https://img.shields.io/endpoint?url=https%3A%2F%2Fswiftpackageindex.com%2Fapi%2Fpackages%2Fpointfreeco%2Fswift-perception%2Fbadge%3Ftype%3Dplatforms)](https://swiftpackageindex.com/pointfreeco/swift-perception)
 
-Observation tools for platforms that do not officially support observation.
+Swift's Observation tools, back-ported to more platforms.
 
 ## Learn More
 
@@ -18,11 +18,11 @@ host the [Point-Free][pointfreeco] video series which explores advanced Swift la
 
 ## Overview
 
-The Perception library provides tools that mimic `@Observable` and `withObservationTracking` in
-Swift 5.9, but they are backported to work all the way back to iOS 13, macOS 10.15, tvOS 13 and
-watchOS 6. This means you can start taking advantage of Swift 5.9's observation tools today,
-even if you can't drop support for older Apple platforms. Using this library's tools works almost
-exactly as using the official tools, but with one small exception.
+The Perception library back-ports `@Observable`, `withObservationTracking`, and `Observations` all
+the way back to iOS 13, macOS 10.15, tvOS 13 and watchOS 6. This means you can take advantage of
+all of Swift's observation tools today, even if you can't drop support for older Apple platforms.
+Using this library's tools works almost exactly as using the official tools, with one small
+exception.
 
 To begin, mark a class as being observable by using the `@Perceptible` macro instead of the
 `@Observable` macro:
@@ -54,26 +54,33 @@ struct FeatureView: View {
   var body: some View {
     WithPerceptionTracking {
       Form {
-        Text(model.count.description)
+        Text("\(model.count)")
         Button("Increment") { model.count += 1 }
       }
     }
   }
 }
 ```
 
-It's unfortunate to have to wrap your view's content in `WithPerceptionTracking`, however if you
-forget then you will helpfully get a runtime warning letting you know that observation is not
-set up correctly:
+It's unfortunate to have to wrap your view's content in `WithPerceptionTracking`, but if you forget
+then you will helpfully get a runtime warning letting you know that observation is not set up
+correctly:
 
-> 🟣 Runtime Warning: Perceptible state was accessed but is not being tracked. Track changes
-> to state by wrapping your view in a 'WithPerceptionTracking' view. This must also be done
-> for any escaping, trailing closures, such as 'GeometryReader', `LazyVStack` (and all lazy
-> views), navigation APIs ('sheet', 'popover', 'fullScreenCover', etc.), and others.
+> 🟣 Runtime Warning: Perceptible state was accessed from a view but is not being tracked.
+
+Finally, the `Observations` async sequence has been back-ported as `Perceptions`, which can be used
+to observe changes to perceptible and observable objects over time:
+
+```swift
+let counts = Perceptions { model.count }
+for await count in counts {
+  print("Count changed: \(count)")
+}
+```
 
 ### Bindable
 
-SwiftUI's `@Bindable` property wrapper has also been backported to support perceptible objects. You
+SwiftUI's `@Bindable` property wrapper has also been back-ported to support perceptible objects. You
 can simply qualify the property wrapper with the `Perception` module:
 
 ```swift
@@ -87,7 +94,7 @@ struct FeatureView: View {
 ### Environment
 
 SwiftUI's `@Environment` property wrapper and `environment` view modifier's support for observation
-has also been backported to support perceptible objects using the exact same APIs:
+has also been back-ported to support perceptible objects using the exact same APIs:
 
 ```swift
 struct FeatureView: View {
@@ -102,13 +109,14 @@ struct FeatureView: View {
 
 ## Community
 
-If you want to discuss this library or have a question about how to use it to solve
-a particular problem, there are a number of places you can discuss with fellow
+If you want to discuss this library or have a question about how to use it to solve a particular
+problem, there are a number of places you can discuss with fellow
 [Point-Free](https://www.pointfree.co) enthusiasts:
 
-* For long-form discussions, we recommend the
-[discussions](https://github.com/pointfreeco/swift-perception/discussions) tab of this repo.
-* For casual chat, we recommend the [Point-Free Community Slack](https://pointfree.co/slack-invite).
+  * For long-form discussions, we recommend the
+    [discussions](https://github.com/pointfreeco/swift-perception/discussions) tab of this repo.
+  * For casual chat, we recommend the
+    [Point-Free Community Slack](https://pointfree.co/slack-invite).
 
 ## Documentation
 
@@ -119,6 +127,6 @@ The latest documentation for the Perception APIs is available [here][docs].
 This library is released under the MIT license. See [LICENSE](LICENSE) for details.
 
 [pointfreeco]: https://www.pointfree.co
-[mbrandonw]: https://twitter.com/mbrandonw
-[stephencelis]: https://twitter.com/stephencelis
+[mbrandonw]: https://x.com/mbrandonw
+[stephencelis]: https://x.com/stephencelis
 [docs]: https://swiftpackageindex.com/pointfreeco/swift-perception/main/documentation/perception

Package.swift

@@ -0,0 +1,23 @@
+# ``Perception``
+
+Swift's Observation tools, back-ported to more platforms.
+
+## Overview
+
+The core functionality of this library is defined in
+[`PerceptionCore`](<doc:/PerceptionCore>), which this module automatically exports.
+
+This module also contains all of the macros that support the core functionality of the library.
+
+See [`PerceptionCore`](<doc:/PerceptionCore>) for general library usage.
+
+## Topics
+
+### Perceptible conformance
+
+- ``Perceptible()``
+
+### Macros
+
+- ``PerceptionTracked()``
+- ``PerceptionIgnored()``