feat: Complete SwiftUI Implementation of v0.9 Basic Catalog

renderers/swift/.gitignore

@@ -0,0 +1,15 @@
+# Build artifacts
+.build/
+
+# Swift Package Manager
+.swiftpm/
+
+# Xcode
+.DS_Store
+*.playground/
+DerivedData/
+
+# User-specific workspace/project files
+**/*.xcodeproj/project.xcworkspace/
+**/*.xcodeproj/xcuserdata/
+**/*.xcworkspace/xcuserdata/

renderers/swift/Package.swift

@@ -0,0 +1,23 @@
+// swift-tools-version: 6.0
+import PackageDescription
+
+let package = Package(
+    name: "A2UI",
+    platforms: [
+		.iOS(.v18),
+		.macOS(.v15)
+    ],
+    products: [
+        .library(
+            name: "A2UI",
+            targets: ["A2UI"]),
+    ],
+    targets: [
+        .target(
+            name: "A2UI",
+            dependencies: []),
+        .testTarget(
+            name: "A2UITests",
+            dependencies: ["A2UI"]),
+    ]
+)

renderers/swift/README.md

@@ -0,0 +1,41 @@
+# A2UI Swift Renderer
+
+This directory contains the source code for the A2UI Swift Renderer.
+
+It is a native Swift package that provides the necessary components to parse and render A2UI protocol messages within a SwiftUI application.
+
+## Key Components:
+
+-   **A2UIParser**: Deserializes A2UI JSON messages into Swift data models.
+-   **A2UIDataStore**: Manages the state of the UI surface and its components.
+-   **A2UISurfaceView**: A SwiftUI view that orchestrates the rendering of the entire A2UI surface.
+-   **A2UIComponentRenderer**: A view responsible for dynamically rendering individual A2UI components (e.g., Text, Button, Card) as native SwiftUI views.
+
+For an example of how to use this renderer, please see the sample application in `samples/client/swift`.
+
+## Usage
+
+To use this package in your Xcode project:
+
+1.  Go to **File > Add Packages...**
+2.  In the "Add Package" dialog, click **Add Local...**
+3.  Navigate to this directory (`renderers/swift`) and click **Add Package**.
+4.  Select the `A2UI` library to be added to your application target.
+
+## Running Tests
+
+You can run the included unit tests using either Xcode or the command line.
+
+### Xcode
+
+1.  Open the `Package.swift` file in this directory with Xcode.
+2.  Go to the **Test Navigator** (Cmd+6).
+3.  Click the play button to run all tests.
+
+### Command Line
+
+Navigate to this directory in your terminal and run:
+
+```bash
+swift test
+```

renderers/swift/Sources/A2UI/Components/AudioPlayer/A2UIAudioPlayerView.swift

@@ -0,0 +1,127 @@
+import SwiftUI
+import AVKit
+
+struct A2UIAudioPlayerView: View {
+    let properties: AudioPlayerProperties
+    @Environment(SurfaceState.self) var surface
+    @State private var player: AVPlayer?
+    @State private var isPlaying: Bool = false
+    @State private var volume: Double = 1.0
+    @State private var currentTime: Double = 0
+    @State private var duration: Double = 0
+    @State private var isEditing: Bool = false
+    @State private var timeObserverToken: Any?
+
+    var body: some View {
+        VStack(alignment: .leading, spacing: 8) {
+            HStack {
+                Button(action: {
+                    togglePlay()
+                }) {
+                    Image(systemName: isPlaying ? "pause.fill" : "play.fill")
+                        .font(.title)
+                }
+
+                VStack(alignment: .leading) {
+                    Text(surface.resolve(properties.description) ?? "Audio Player")
+                        .font(.caption)
+
+                    Slider(value: $currentTime, in: 0...max(duration, 0.01)) { editing in
+                        isEditing = editing
+                        if !editing {
+                            player?.seek(to: CMTime(seconds: currentTime, preferredTimescale: 600))
+                        }
+                    }
+
+                    HStack {
+                        Text(formatTime(currentTime))
+                        Spacer()
+                        Text(formatTime(duration))
+                    }
+                    .font(.system(size: 10, design: .monospaced))
+                    .foregroundColor(.secondary)
+                }
+            }
+
+            HStack {
+                Image(systemName: "speaker.fill")
+                    .foregroundColor(.secondary)
+                Slider(value: $volume, in: 0...1)
+                    .onChange(of: volume) { _, newValue in
+                        player?.volume = Float(newValue)
+                    }
+                Image(systemName: "speaker.wave.3.fill")
+                    .foregroundColor(.secondary)
+            }
+        }
+        .padding()
+        .background(Color.secondary.opacity(0.1))
+        .cornerRadius(8)
+        .onAppear {
+            setupPlayer()
+        }
+        .onDisappear {
+            if let token = timeObserverToken {
+                player?.removeTimeObserver(token)
+                timeObserverToken = nil
+            }
+            player?.pause()
+            player = nil
+        }
+    }
+
+    private func setupPlayer() {
+        if let urlString = surface.resolve(properties.url), let url = URL(string: urlString) {
+            let avPlayer = AVPlayer(url: url)
+            player = avPlayer
+            volume = Double(avPlayer.volume)
+            isPlaying = false
+            currentTime = 0
+            duration = 0
+
+            // Observe time
+            timeObserverToken = avPlayer.addPeriodicTimeObserver(forInterval: CMTime(seconds: 0.5, preferredTimescale: 600), queue: .main) { time in
+                Task { @MainActor in
+                    if !isEditing {
+                        currentTime = time.seconds
+                    }
+                }
+            }
+
+            // Observe duration
+            Task {
+                if let duration = try? await avPlayer.currentItem?.asset.load(.duration) {
+                    self.duration = duration.seconds
+                }
+            }
+        }
+    }
+
+    private func togglePlay() {
+        if isPlaying {
+            player?.pause()
+        } else {
+            player?.play()
+        }
+        isPlaying.toggle()
+    }
+
+    private func formatTime(_ seconds: Double) -> String {
+        let minutes = Int(seconds) / 60
+        let seconds = Int(seconds) % 60
+        return String(format: "%d:%02d", minutes, seconds)
+    }
+}
+
+#Preview {
+    let surface = SurfaceState(id: "test")
+    let dataStore = A2UIDataStore()
+
+    A2UIAudioPlayerView(properties: AudioPlayerProperties(
+        url: .init(literal: "https://www.soundhelix.com/examples/mp3/SoundHelix-Song-1.mp3"),
+        description: .init(literal: "Sample Audio")
+    ))
+    .padding()
+    .environment(surface)
+    .environment(dataStore)
+}

renderers/swift/Sources/A2UI/Components/AudioPlayer/AudioPlayerProperties.swift

@@ -0,0 +1,6 @@
+import Foundation
+
+public struct AudioPlayerProperties: Codable, Sendable {
+    public let url: BoundValue<String>
+    public let description: BoundValue<String>?
+}

renderers/swift/Sources/A2UI/Components/Button/A2UIButtonView.swift

@@ -0,0 +1,76 @@
+import SwiftUI
+
+struct A2UIButtonView: View {
+    @Environment(SurfaceState.self) var surface
+    let id: String
+    let properties: ButtonProperties
+    let checks: [CheckRule]?
+
+    init(id: String, properties: ButtonProperties, checks: [CheckRule]? = nil) {
+        self.id = id
+        self.properties = properties
+        self.checks = checks
+    }
+
+    var body: some View {
+		let variant = properties.variant ?? .primary
+        let isDisabled = if let checks = checks {
+            errorMessage(surface: surface, checks: checks) != nil
+        } else {
+            false
+        }
+
+        Button(action: {
+            performAction()
+        }) {
+            A2UIComponentRenderer(componentId: properties.child)
+                .padding(.horizontal, 8)
+                .padding(.vertical, 4)
+        }
+        .disabled(isDisabled)
+        .applyButtonStyle(variant: variant)
+        #if os(iOS)
+		.tint(variant == .primary ? .blue : .gray)
+        #endif
+    }
+
+    private func performAction() {
+        surface.trigger(action: properties.action)
+    }
+}
+
+extension View {
+    @ViewBuilder
+    func applyButtonStyle(variant: ButtonVariant) -> some View {
+		if variant == .borderless {
+            self.buttonStyle(.borderless)
+        } else {
+            self.buttonStyle(.bordered)
+        }
+    }
+}
+
+#Preview {
+    let surface = SurfaceState(id: "test")
+    let dataStore = A2UIDataStore()
+
+    // Add a text component for the button child
+    surface.components["t1"] = ComponentInstance(id: "t1", component: .text(TextProperties(text: .init(literal: "Click Me"), variant: nil)))
+
+	return VStack(spacing: 20) {
+        A2UIButtonView(id: "b1", properties: ButtonProperties(
+            child: "t1",
+            action: .custom(name: "primary_action", context: nil),
+			variant: .primary
+        ))
+
+        A2UIButtonView(id: "b2", properties: ButtonProperties(
+            child: "t1",
+            action: .custom(name: "borderless_action", context: nil),
+			variant: .borderless
+        ))
+    }
+    .padding()
+    .environment(surface)
+    .environment(dataStore)
+}

renderers/swift/Sources/A2UI/Components/Button/ButtonProperties.swift

@@ -0,0 +1,19 @@
+import Foundation
+
+public struct ButtonProperties: Codable, Sendable {
+    public let child: String
+    public let action: Action
+    public let variant: ButtonVariant?
+
+    public init(child: String, action: Action, variant: ButtonVariant? = nil) {
+        self.child = child
+        self.action = action
+        self.variant = variant
+    }
+}
+
+public enum ButtonVariant: String, Codable, Sendable, CaseIterable, Identifiable {
+	public var id: String { self.rawValue }
+	case primary
+	case borderless
+}

renderers/swift/Sources/A2UI/Components/Card/A2UICardView.swift

@@ -0,0 +1,27 @@
+import SwiftUI
+
+struct A2UICardView: View {
+    let properties: CardProperties
+
+    var body: some View {
+        A2UIComponentRenderer(componentId: properties.child)
+            .padding()
+            .background(
+                RoundedRectangle(cornerRadius: 12)
+                    .fill(Color(white: 0.95))
+            )
+            .shadow(color: Color.black.opacity(0.1), radius: 4, x: 0, y: 2)
+    }
+}
+
+#Preview {
+    let surface = SurfaceState(id: "test")
+    let dataStore = A2UIDataStore()
+
+    surface.components["t1"] = ComponentInstance(id: "t1", component: .text(TextProperties(text: .init(literal: "Card Content"), variant: .h3)))
+
+    return A2UICardView(properties: CardProperties(child: "t1"))
+        .padding()
+        .environment(surface)
+        .environment(dataStore)
+}

renderers/swift/Sources/A2UI/Components/Card/CardProperties.swift

@@ -0,0 +1,5 @@
+import Foundation
+
+public struct CardProperties: Codable, Sendable {
+    public let child: String
+}

renderers/swift/Sources/A2UI/Components/CheckBox/A2UICheckBoxView.swift

@@ -0,0 +1,40 @@
+import SwiftUI
+
+struct A2UICheckBoxView: View {
+    let id: String
+    let properties: CheckBoxProperties
+    @Environment(SurfaceState.self) var surface
+    @State private var isOn: Bool = false
+
+    init(id: String, properties: CheckBoxProperties) {
+        self.id = id
+        self.properties = properties
+    }
+
+    var body: some View {
+        Toggle(isOn: $isOn) {
+            Text(resolveValue(surface, binding: properties.label) ?? "")
+        }
+        .onChange(of: isOn) { _, newValue in
+            updateBinding(surface: surface, binding: properties.value, newValue: newValue)
+            surface.runChecks(for: id)
+        }
+        .onAppear {
+            isOn = resolveValue(surface, binding: properties.value) ?? false
+            surface.runChecks(for: id)
+        }
+    }
+}
+
+#Preview {
+    let surface = SurfaceState(id: "test")
+    let dataStore = A2UIDataStore()
+
+    A2UICheckBoxView(id: "cb1", properties: CheckBoxProperties(
+        label: .init(literal: "Check this box"),
+        value: .init(literal: true)
+    ))
+    .padding()
+    .environment(surface)
+    .environment(dataStore)
+}