Add CustomDump trait

.github/workflows/ci.yml

@@ -20,7 +20,7 @@ jobs:
       matrix:
         xcode: ['26.5']
         config: ['debug', 'release']
-        traits: ['', 'CasePaths', 'IdentifiedCollections']
+        traits: ['', 'CasePaths', 'CustomDump', 'IdentifiedCollections']
     runs-on: macos-26
     steps:
       - uses: actions/checkout@v4
@@ -35,7 +35,7 @@ jobs:
       matrix:
         swift:
           - '6.3'
-        traits: ['', 'CasePaths']
+        traits: ['', 'CasePaths', 'CustomDump', 'IdentifiedCollections']
     runs-on: ubuntu-latest
     container: swift:${{ matrix.swift }}
     steps:

Package.swift

@@ -22,6 +22,10 @@ let package = Package(
       name: "CasePaths",
       description: "Derive Shared cases from Shared enums using CasePaths"
     ),
+    .trait(
+      name: "CustomDump",
+      description: "Pretty-print and diff Sharing's data types using CustomDump"
+    ),
     .trait(
       name: "IdentifiedCollections",
       description: "Derive Shared elements from Shared collections using IdentifiedCollections"
@@ -44,8 +48,21 @@ let package = Package(
       dependencies: [
         "Sharing1",
         "Sharing2",
+        .product(
+          name: "CasePaths",
+          package: "swift-case-paths",
+          condition: .when(
+            traits: ["CasePaths"]
+          )
+        ),
         .product(name: "ConcurrencyExtras", package: "swift-concurrency-extras"),
-        .product(name: "CustomDump", package: "swift-custom-dump"),
+        .product(
+          name: "CustomDump",
+          package: "swift-custom-dump",
+          condition: .when(
+            traits: ["CustomDump"]
+          )
+        ),
         .product(name: "Dependencies", package: "swift-dependencies"),
         .product(
           name: "IdentifiedCollections",
@@ -56,13 +73,6 @@ let package = Package(
         ),
         .product(name: "IssueReporting", package: "xctest-dynamic-overlay"),
         .product(name: "PerceptionCore", package: "swift-perception"),
-        .product(
-          name: "CasePaths",
-          package: "swift-case-paths",
-          condition: .when(
-            traits: ["CasePaths"]
-          )
-        ),
       ],
       resources: [
         .process("PrivacyInfo.xcprivacy")
@@ -72,15 +82,16 @@ let package = Package(
       name: "SharingTests",
       dependencies: [
         "Sharing",
-        .product(name: "CombineSchedulers", package: "combine-schedulers"),
-        .product(name: "DependenciesTestSupport", package: "swift-dependencies"),
         .product(
           name: "CasePaths",
           package: "swift-case-paths",
           condition: .when(
             traits: ["CasePaths"]
           )
         ),
+        .product(name: "CombineSchedulers", package: "combine-schedulers"),
+        .product(name: "CustomDump", package: "swift-custom-dump"),
+        .product(name: "DependenciesTestSupport", package: "swift-dependencies"),
       ],
       exclude: ["Sharing.xctestplan"]
     ),
@@ -103,6 +114,7 @@ package.traits.insert(
       enableAllTraits
         ? package.traits.map(\.name)
         : [
+          "CustomDump",
           "IdentifiedCollections",
         ]
     )

Package@swift-5.9.swift

@@ -56,6 +56,7 @@ let package = Package(
 for target in package.targets {
   target.swiftSettings = target.swiftSettings ?? []
   target.swiftSettings?.append(contentsOf: [
+    .define("CustomDump"),
     .define("IdentifiedCollections"),
   ])
 }

Package@swift-6.0.swift

@@ -67,6 +67,7 @@ let package = Package(
 for target in package.targets {
   target.swiftSettings = target.swiftSettings ?? []
   target.swiftSettings?.append(contentsOf: [
+    .define("CustomDump"),
     .define("IdentifiedCollections"),
     .enableUpcomingFeature("ExistentialAny"),
     .enableUpcomingFeature("ImmutableWeakCaptures"),

Sources/Sharing/Shared.swift

@@ -1,4 +1,3 @@
-public import CustomDump
 import Dependencies
 import Foundation
 public import Observation
@@ -474,25 +473,6 @@ extension Shared: Observable {}
 
 extension Shared: Perceptible {}
 
-extension Shared: CustomDumpRepresentable {
-  public var customDumpValue: Any {
-    wrappedValue
-  }
-}
-
-extension Shared: _CustomDiffObject {
-  public var _customDiffValues: (Any, Any) {
-    (reference.snapshot ?? reference.wrappedValue, reference.wrappedValue)
-  }
-
-  public var _objectIdentifier: ObjectIdentifier {
-    func open(_ reference: some MutableReference<Value>) -> ObjectIdentifier {
-      reference.id
-    }
-    return open(reference)
-  }
-}
-
 #if canImport(SwiftUI)
   extension Shared: DynamicProperty {
     public func update() {

Sources/Sharing/SharedReader.swift

@@ -1,4 +1,3 @@
-public import CustomDump
 import Foundation
 import IssueReporting
 public import Observation
@@ -345,12 +344,6 @@ extension SharedReader: Observable {}
 
 extension SharedReader: Perceptible {}
 
-extension SharedReader: CustomDumpRepresentable {
-  public var customDumpValue: Any {
-    wrappedValue
-  }
-}
-
 #if canImport(SwiftUI)
   extension SharedReader: DynamicProperty {
     public func update() {

Sources/Sharing/Traits/CustomDump.swift

@@ -0,0 +1,28 @@
+#if CustomDump
+  public import CustomDump
+
+  extension Shared: CustomDumpRepresentable {
+    public var customDumpValue: Any {
+      wrappedValue
+    }
+  }
+
+  extension Shared: _CustomDiffObject {
+    public var _customDiffValues: (Any, Any) {
+      (reference.snapshot ?? reference.wrappedValue, reference.wrappedValue)
+    }
+
+    public var _objectIdentifier: ObjectIdentifier {
+      func open(_ reference: some MutableReference<Value>) -> ObjectIdentifier {
+        reference.id
+      }
+      return open(reference)
+    }
+  }
+
+  extension SharedReader: CustomDumpRepresentable {
+    public var customDumpValue: Any {
+      wrappedValue
+    }
+  }
+#endif

Tests/SharingTests/FileStorageTests.swift

@@ -20,7 +20,8 @@
         @Shared(.fileStorage(.fileURL)) var users = [User]()
         #expect($users.loadError == nil)
         expectNoDifference(
-          fileSystem.value, [.fileURL: Data()]
+          fileSystem.value,
+          [.fileURL: Data()]
         )
         $users.withLock { $0.append(.blob) }
         try expectNoDifference(fileSystem.value.users(for: .fileURL), [.blob])
@@ -34,7 +35,8 @@
         @Shared(.utf8String) var string = ""
         #expect($string.loadError == nil)
         expectNoDifference(
-          fileSystem.value, [.utf8StringURL: Data()]
+          fileSystem.value,
+          [.utf8StringURL: Data()]
         )
         $string.withLock { $0 = "hello" }
         expectNoDifference(