share a curated SwiftUI gallery across iOS, macOS, and visionOS examples

Replaces the per-platform example views with a single `WaveformGalleryView`
(in Example/Shared/) that the three example apps wrap. The gallery is a
single scrolling page with sections covering every public rendering surface:

  - Interactive playground (renderer + style + damping + color picker, all
    driving one preview)
  - Renderers section (Linear default / .up / .down / Circular / Ring)
  - Styles section (filled, outlined, gradient, gradient-outlined, striped)
  - Channel selection (merged, specific(0), specific(1), stereo)
  - Custom-shape examples (WaveformView trailing closure, bare WaveformShape)

LazyVStack at the outer and per-section level — sections only instantiate
when scrolled into view. This keeps the number of concurrent `WaveformView`
analyses small, which matters because macOS AVFoundation hangs indefinitely
when too many `AVAssetReader` instances target the same audio URL at once.

Other changes:
- iOS `SwiftUIExampleView` reduced to a Gallery / Live picker, with the
  live-recording UI rebuilt against `WaveformLiveCanvas` directly.
- macOS / visionOS `ContentView`s become thin wrappers around the gallery.
- Bundle `example_stereo.m4a` in iOS and visionOS targets (previously
  macOS-only) so the gallery's stereo demos work everywhere.
- Carry the iOS app icon into the macOS (with all 1x/2x size variants
  generated from the 1024 source) and visionOS (front/middle/back layers)
  targets so the apps share visual identity.
- Project file updated: new `Shared/` group, new shared file referenced
  by all three targets' Sources phase, additional resource entries for
  the stereo audio.

Author: dmrschmidt

Example/DSWaveformImageExample-VisionOS/Assets.xcassets/AppIcon.solidimagestack/Back.solidimagestacklayer/Content.imageset/Contents.json

@@ -1,6 +1,7 @@
 {
   "images" : [
     {
+      "filename" : "Icon.png",
       "idiom" : "vision",
       "scale" : "2x"
     }

Example/DSWaveformImageExample-VisionOS/Assets.xcassets/AppIcon.solidimagestack/Back.solidimagestacklayer/Content.imageset/Icon.png

@@ -1,6 +1,7 @@
 {
   "images" : [
     {
+      "filename" : "Icon.png",
       "idiom" : "vision",
       "scale" : "2x"
     }

Example/DSWaveformImageExample-VisionOS/Assets.xcassets/AppIcon.solidimagestack/Front.solidimagestacklayer/Content.imageset/Contents.json

@@ -1,6 +1,7 @@
 {
   "images" : [
     {
+      "filename" : "Icon.png",
       "idiom" : "vision",
       "scale" : "2x"
     }

Example/DSWaveformImageExample-VisionOS/Assets.xcassets/AppIcon.solidimagestack/Front.solidimagestacklayer/Content.imageset/Icon.png

@@ -3,34 +3,8 @@ import DSWaveformImage
 import DSWaveformImageViews
 
 struct ContentView: View {
-    private static let colors = [UIColor.systemPink, UIColor.systemBlue, UIColor.systemGreen]
-    private static var randomColor: UIColor {
-        colors[Int.random(in: 0..<colors.count)]
-    }
-
-    @State private var audioURL: URL = Bundle.main.url(forResource: "example_sound", withExtension: "m4a")!
-
-    @State var configuration: Waveform.Configuration = Waveform.Configuration(
-        style: .gradient([.red, .green])
-    )
-
     var body: some View {
-        VStack {
-            Text("SwiftUI example")
-                .font(.largeTitle.bold())
-
-            Button {
-                configuration = configuration.with(style: .striped(.init(color: Self.randomColor)))
-            } label: {
-                Label("switch color randomly", systemImage: "arrow.triangle.2.circlepath")
-            }
-            .font(.body.bold())
-            .padding()
-            .background(Color(UIColor.systemGray).opacity(0.6))
-            .cornerRadius(10)
-
-            WaveformView(audioURL: audioURL, configuration: configuration, renderer: CircularWaveformRenderer())
-        }
+        WaveformGalleryView()
     }
 }
 

Example/DSWaveformImageExample-VisionOS/Assets.xcassets/AppIcon.solidimagestack/Middle.solidimagestacklayer/Content.imageset/Contents.json

@@ -3,68 +3,61 @@ import DSWaveformImageViews
 import SwiftUI
 
 struct SwiftUIExampleView: View {
-    private enum ActiveTab: Hashable {
-        case recorder, shape, overview
+    private enum Tab: Hashable {
+        case gallery
+        case recorder
     }
 
-    private static let colors = [UIColor.systemPink, UIColor.systemBlue, UIColor.systemGreen]
-    private static var randomColor: UIColor { colors.randomElement()! }
-
-    private static var audioURLs: [URL?] = [
-        Bundle.main.url(forResource: "example_sound", withExtension: "m4a"),
-        Bundle.main.url(forResource: "example_sound_2", withExtension: "m4a")
-    ]
-    private static func randomURL(_ current: URL?) -> URL? { audioURLs.filter { $0 != current }.randomElement()! }
-
-    @StateObject private var audioRecorder: AudioRecorder = AudioRecorder()
-
-    @State private var configuration: Waveform.Configuration = Waveform.Configuration(
-        style: .striped(Waveform.Style.StripeConfig(color: Self.randomColor, width: 3, lineCap: .round)),
-        verticalScalingFactor: 0.9
-    )
-
-    @State private var liveConfiguration: Waveform.Configuration = Waveform.Configuration(
-        style: .striped(.init(color: randomColor, width: 3, spacing: 3))
-    )
-
-    @State private var audioURL: URL? = audioURLs.first!
-    @State private var samples: [Float] = []
-    @State private var silence: Bool = true
-    @State private var selection: ActiveTab = .overview
+    @State private var tab: Tab = .gallery
 
     var body: some View {
-        VStack {
-            Text("SwiftUI examples")
-                .font(.largeTitle.bold())
-
-            Picker("Hey", selection: $selection) {
-                Text("Recorder").tag(ActiveTab.recorder)
-                Text("Shape").tag(ActiveTab.shape)
-                Text("Overview").tag(ActiveTab.overview)
+        VStack(spacing: 0) {
+            Picker("Section", selection: $tab) {
+                Label("Gallery", systemImage: "rectangle.grid.2x2").tag(Tab.gallery)
+                Label("Live", systemImage: "mic.circle.fill").tag(Tab.recorder)
             }
             .pickerStyle(.segmented)
+            .labelsHidden()
             .padding(.horizontal)
+            .padding(.top, 12)
 
-            switch selection {
-            case .recorder: recordingExample
-            case .shape: shape
-            case .overview: overview
+            switch tab {
+            case .gallery: WaveformGalleryView()
+            case .recorder: LiveRecordingTab()
             }
         }
-        .padding(.vertical, 20)
     }
+}
+
+private struct LiveRecordingTab: View {
+    @StateObject private var audioRecorder = AudioRecorder()
+    @State private var silence: Bool = true
+    @State private var configuration: Waveform.Configuration = Waveform.Configuration(
+        style: .striped(.init(color: .systemIndigo, width: 3, spacing: 3))
+    )
+
+    var body: some View {
+        VStack(spacing: 16) {
+            VStack(alignment: .leading, spacing: 4) {
+                Text("Live recording")
+                    .font(.title2.weight(.semibold))
+                Text("WaveformLiveCanvas streams microphone amplitude into a circular renderer.")
+                    .font(.callout)
+                    .foregroundStyle(.secondary)
+            }
+            .frame(maxWidth: .infinity, alignment: .leading)
+            .padding(.horizontal)
+            .padding(.top, 16)
 
-    @ViewBuilder
-    private var recordingExample: some View {
-        VStack {
             WaveformLiveCanvas(
                 samples: audioRecorder.samples,
-                configuration: liveConfiguration,
+                configuration: configuration,
                 renderer: CircularWaveformRenderer(kind: .circle),
                 shouldDrawSilencePadding: silence
             )
+            .padding(.horizontal)
 
-            Toggle("draw silence", isOn: $silence)
+            Toggle("Pad silence", isOn: $silence)
                 .controlSize(.mini)
                 .padding(.horizontal)
 
@@ -75,136 +68,8 @@ struct SwiftUIExampleView: View {
                 isRecording: $audioRecorder.isRecording
             )
             .padding(.horizontal)
-        }
-    }
-
-    @ViewBuilder
-    private var shape: some View {
-        VStack {
-            Text("WaveformView").font(.monospaced(.title.bold())())
 
-            HStack {
-                Button {
-                    configuration = configuration.with(style: .striped(Waveform.Style.StripeConfig(color: Self.randomColor, width: 3, lineCap: .round)))
-                    liveConfiguration = liveConfiguration.with(style: .striped(.init(color: Self.randomColor, width: 3, spacing: 3)))
-                } label: {
-                    Label("color", systemImage: "dice")
-                        .frame(maxWidth: .infinity)
-                }
-                .font(.body.bold())
-                .padding(8)
-                .background(Color(.systemGray6))
-                .cornerRadius(10)
-
-                Button {
-                    audioURL = Self.randomURL(audioURL)
-                    print("will draw \(audioURL!)")
-                } label: {
-                    Label("waveform", systemImage: "dice")
-                        .frame(maxWidth: .infinity)
-                }
-                .font(.body.bold())
-                .padding(8)
-                .background(Color(.systemGray6))
-                .cornerRadius(10)
-            }
-            .padding(.horizontal)
-
-            // the if let is left here intentionally to illustrate how to deal with optional URLs
-            // as this was asked in an older GitHub issue
-            if let audioURL {
-                WaveformView(audioURL: audioURL, configuration: configuration)
-
-                WaveformView(
-                    audioURL: audioURL,
-                    configuration: configuration,
-                    renderer: CircularWaveformRenderer(kind: .ring(0.7))
-                ) { shape in
-                    // you may completely override the shape styling this way
-                    shape
-                        .stroke(
-                            LinearGradient(colors: [.red, Color(Self.randomColor)], startPoint: .zero, endPoint: .topTrailing),
-                            style: StrokeStyle(lineWidth: 3, lineCap: .round))
-                }
-
-                Divider()
-                Text("WaveformShape").font(.monospaced(.title.bold())())
-
-                /// **Note:** It's possible, but discouraged to use WaveformShape directly.
-                /// As Shapes should not do any expensive computations, the analyzing should happen outside,
-                /// hence making the API a tiny bit clumsy if used directly, since we do require to know the size,
-                /// even though the Shape of course intrinsically knows its size already.
-                GeometryReader { geometry in
-                    WaveformShape(samples: samples)
-                        .fill(Color.orange)
-                        .task {
-                            do {
-                                let samplesNeeded = Int(geometry.size.width * configuration.scale)
-                                let samples = try await WaveformAnalyzer().samples(fromAudioAt: audioURL, count: samplesNeeded)
-                                await MainActor.run { self.samples = samples }
-                            } catch {
-                                assertionFailure(error.localizedDescription)
-                            }
-                        }
-                }
-            }
-        }
-    }
-
-    @ViewBuilder
-    private var overview: some View {
-        if let audioURL {
-            HStack {
-                VStack {
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .filled(.red)))
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .outlined(.blue, 0.5)))
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .gradient([.yellow, .orange])))
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .gradientOutlined([.yellow, .orange], 1)))
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .striped(.init(color: .red, width: 2, spacing: 1))))
-                    
-                    // Multi-channel examples
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .filled(.blue)), renderer: LinearWaveformRenderer(channelSelection: .specific(0)))
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .filled(.red)), renderer: LinearWaveformRenderer(channelSelection: .specific(1)))
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .gradient([.blue, .cyan])), renderer: LinearWaveformRenderer.stereo)
-
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .striped(.init(color: .black)))) { shape in
-                        shape // override the shape styling
-                            .stroke(LinearGradient(colors: [.blue, .pink], startPoint: .bottom, endPoint: .top), lineWidth: 3)
-                    } placeholder: {
-                        ProgressView()
-                    }
-                }
-
-                VStack {
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .filled(.red)), renderer: CircularWaveformRenderer())
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .outlined(.blue, 0.5)), renderer: CircularWaveformRenderer())
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .gradient([.yellow, .orange])), renderer: CircularWaveformRenderer())
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .gradientOutlined([.yellow, .orange], 1)), renderer: CircularWaveformRenderer())
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .striped(.init(color: .red, width: 2, spacing: 2))), renderer: CircularWaveformRenderer())
-
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .striped(.init(color: .black))), renderer: CircularWaveformRenderer()) { shape in
-                        shape // override the shape styling
-                            .stroke(LinearGradient(colors: [.blue, .pink], startPoint: .bottom, endPoint: .top), lineWidth: 3)
-                    } placeholder: {
-                        ProgressView()
-                    }
-                }
-
-                VStack {
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .filled(.red)), renderer: CircularWaveformRenderer(kind: .ring(0.5)))
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .outlined(.blue, 0.5)), renderer: CircularWaveformRenderer(kind: .ring(0.5)))
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .gradient([.yellow, .orange])), renderer: CircularWaveformRenderer(kind: .ring(0.5)))
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .gradientOutlined([.yellow, .orange], 1)), renderer: CircularWaveformRenderer(kind: .ring(0.5)))
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .striped(.init(color: .red, width: 2, spacing: 2))), renderer: CircularWaveformRenderer(kind: .ring(0.5)))
-
-                    WaveformView(audioURL: audioURL, configuration: .init(style: .striped(.init(color: .black))), renderer: CircularWaveformRenderer(kind: .ring(0.5))) { shape in
-                        shape // override the shape styling
-                            .stroke(LinearGradient(colors: [.blue, .pink], startPoint: .bottom, endPoint: .top), lineWidth: 3)
-                    } placeholder: {
-                        ProgressView()
-                    }
-                }
-            }
+            Spacer(minLength: 0)
         }
     }
 }
@@ -229,9 +94,7 @@ private class AudioRecorder: NSObject, ObservableObject, RecordingDelegate {
 
     override init() {
         audioManager = SCAudioManager()
-
         super.init()
-
         audioManager.prepareAudioRecording()
         audioManager.recordingDelegate = self
     }
@@ -250,16 +113,13 @@ private class AudioRecorder: NSObject, ObservableObject, RecordingDelegate {
     // MARK: - RecordingDelegate
 
     func audioManager(_ manager: SCAudioManager!, didAllowRecording flag: Bool) {}
-
     func audioManager(_ manager: SCAudioManager!, didFinishRecordingSuccessfully flag: Bool) {}
 
     func audioManager(_ manager: SCAudioManager!, didUpdateRecordProgress progress: CGFloat) {
         let linear = 1 - pow(10, manager.lastAveragePower() / 20)
-
         // Here we add the same sample 3 times to speed up the animation.
         // Usually you'd just add the sample once.
         recordingTime = audioManager.currentRecordingTime
         samples += [linear, linear, linear]
     }
 }
-

Example/DSWaveformImageExample-VisionOS/Assets.xcassets/AppIcon.solidimagestack/Middle.solidimagestacklayer/Content.imageset/Icon.png

@@ -1,51 +1,61 @@
 {
   "images" : [
     {
+      "filename" : "Icon-16.png",
       "idiom" : "mac",
       "scale" : "1x",
       "size" : "16x16"
     },
     {
+      "filename" : "Icon-32.png",
       "idiom" : "mac",
       "scale" : "2x",
       "size" : "16x16"
     },
     {
+      "filename" : "Icon-32.png",
       "idiom" : "mac",
       "scale" : "1x",
       "size" : "32x32"
     },
     {
+      "filename" : "Icon-64.png",
       "idiom" : "mac",
       "scale" : "2x",
       "size" : "32x32"
     },
     {
+      "filename" : "Icon-128.png",
       "idiom" : "mac",
       "scale" : "1x",
       "size" : "128x128"
     },
     {
+      "filename" : "Icon-256.png",
       "idiom" : "mac",
       "scale" : "2x",
       "size" : "128x128"
     },
     {
+      "filename" : "Icon-256.png",
       "idiom" : "mac",
       "scale" : "1x",
       "size" : "256x256"
     },
     {
+      "filename" : "Icon-512.png",
       "idiom" : "mac",
       "scale" : "2x",
       "size" : "256x256"
     },
     {
+      "filename" : "Icon-512.png",
       "idiom" : "mac",
       "scale" : "1x",
       "size" : "512x512"
     },
     {
+      "filename" : "Icon-1024.png",
       "idiom" : "mac",
       "scale" : "2x",
       "size" : "512x512"