3.0.0

.github/workflows/examples.yml

@@ -0,0 +1,84 @@
+name: Examples
+
+on:
+  push:
+    branches: ["**"]
+    paths:
+      - 'Examples/**'
+      - 'Sources/**'
+      - 'Package.swift'
+      - '.github/workflows/examples.yml'
+  pull_request:
+    paths:
+      - 'Examples/**'
+      - 'Sources/**'
+      - 'Package.swift'
+      - '.github/workflows/examples.yml'
+
+jobs:
+  test-moderate-examples:
+    name: Test Moderate Examples
+    runs-on: macos-15
+    steps:
+    - uses: actions/checkout@v4
+    - uses: maxim-lobanov/setup-xcode@v1
+      with:
+        xcode-version: 16.2
+    - name: Set up Swift
+      uses: swift-actions/setup-swift@v2
+      with:
+        swift-version: '6.2'
+
+    - name: Test TodoCloud
+      working-directory: Examples/Moderate/TodoCloud
+      run: swift test -v
+
+    - name: Test SettingsKit
+      working-directory: Examples/Moderate/SettingsKit
+      run: swift test -v
+
+    - name: Test DataDashboard
+      working-directory: Examples/Moderate/DataDashboard
+      run: swift test -v
+
+    - name: Test SecureVault
+      working-directory: Examples/Moderate/SecureVault
+      run: swift test -v
+
+  test-focused-examples:
+    name: Test Focused Examples
+    runs-on: macos-15
+    steps:
+    - uses: actions/checkout@v4
+    - uses: maxim-lobanov/setup-xcode@v1
+      with:
+        xcode-version: 16.2
+    - name: Set up Swift
+      uses: swift-actions/setup-swift@v2
+      with:
+        swift-version: '6.2'
+
+    - name: Test SyncNotes
+      working-directory: Examples/Focused/SyncNotes
+      run: swift test -v
+
+    - name: Test MultiPlatformTracker
+      working-directory: Examples/Focused/MultiPlatformTracker
+      run: swift test -v
+
+  test-swiftdata-example:
+    name: Test SwiftData Example
+    runs-on: macos-15
+    steps:
+    - uses: actions/checkout@v4
+    - uses: maxim-lobanov/setup-xcode@v1
+      with:
+        xcode-version: 16.2
+    - name: Set up Swift
+      uses: swift-actions/setup-swift@v2
+      with:
+        swift-version: '6.2'
+
+    - name: Test SwiftDataExample
+      working-directory: Examples/SwiftDataExample
+      run: swift test -v

.github/workflows/macOS.yml

@@ -20,5 +20,15 @@ jobs:
     - uses: actions/checkout@v4
     - name: Build
       run: swift build -v
+      env:
+        APPSTATE_STRICT: "1"
     - name: Run tests
       run: swift test -v
+      env:
+        APPSTATE_STRICT: "1"
+    - name: Build SwiftData example
+      run: swift build -v
+      working-directory: Examples/SwiftDataExample
+    - name: Run SwiftData example
+      run: swift run
+      working-directory: Examples/SwiftDataExample

.github/workflows/ubuntu.yml

@@ -21,5 +21,9 @@ jobs:
       - uses: actions/checkout@v4
       - name: Build for release
         run: swift build -v -c release
+        env:
+          APPSTATE_STRICT: "1"
       - name: Test
         run: swift test -v
+        env:
+          APPSTATE_STRICT: "1"

.github/workflows/windows.yml

@@ -21,5 +21,11 @@ jobs:
 
       # ② Build & test
       - run: swift --version          # sanity-check
-      - run: swift build
-      - run: swift test
+      - name: Build
+        run: swift build
+        env:
+          APPSTATE_STRICT: "1"
+      - name: Test
+        run: swift test
+        env:
+          APPSTATE_STRICT: "1"

.gitignore

@@ -1,8 +1,12 @@
 .DS_Store
 /.build
+.build/
 /Packages
 xcuserdata/
 DerivedData/
 .swiftpm/
 .netrc
-Package.resolved
+Package.resolved
+# xcodegen-generated demo project + derived data
+Examples/DemoApp/*.xcodeproj/
+Examples/DemoApp/.build-dd/

.specsync/.gitignore

@@ -0,0 +1,3 @@
+backup-3x/
+config.local.toml
+hashes.json

.specsync/config.toml

@@ -0,0 +1,12 @@
+# spec-sync v4 configuration
+# Docs: https://github.com/CorvidLabs/spec-sync
+
+specs_dir = "specs"
+source_dirs = ["Sources"]
+exclude_dirs = []
+exclude_patterns = []
+required_sections = ["Purpose", "Public API", "Invariants", "Behavioral Examples", "Error Cases", "Dependencies", "Change Log"]
+enforcement = "strict"
+
+[lifecycle]
+track_history = false

.specsync/registry.toml

@@ -0,0 +1,7 @@
+[registry]
+name = "AppState"
+
+[specs]
+application = "specs/application/application.spec.md"
+property-wrappers = "specs/property-wrappers/property-wrappers.spec.md"
+swiftdata = "specs/swiftdata/swiftdata.spec.md"

.specsync/version

@@ -0,0 +1 @@
+4.3.1

Examples/DemoApp/Sources/AppStateDemoApp.swift

@@ -0,0 +1,78 @@
+import SwiftUI
+
+import DataDashboard
+import MultiPlatformTracker
+import SecureVault
+import SettingsKit
+import SyncNotes
+import TodoCloud
+
+#if canImport(SwiftData)
+import SwiftDataExampleLib
+#endif
+
+// MARK: - App entry point
+
+/// A host app that showcases every AppState example view on a real device or simulator.
+///
+/// Each row drives into the corresponding example's *public* root view, so what you see running
+/// here is exactly the SwiftUI that the example packages ship and test.
+@main
+struct AppStateDemoApp: App {
+    var body: some Scene {
+        WindowGroup {
+            ExampleCatalogView()
+        }
+    }
+}
+
+// MARK: - Catalog
+
+/// The list of examples, grouped the same way the repository organizes them.
+@available(iOS 18.0, *)
+struct ExampleCatalogView: View {
+    var body: some View {
+        NavigationStack {
+            List {
+                Section("Moderate") {
+                    NavigationLink("TodoCloud — @SyncState") {
+                        TodoListView()
+                    }
+                    NavigationLink("SettingsKit — @StoredState + @Slice") {
+                        SettingsView()
+                    }
+                    NavigationLink("DataDashboard — Dependency injection") {
+                        DataDashboard.DashboardView()
+                    }
+                    NavigationLink("SecureVault — @SecureState") {
+                        VaultView()
+                    }
+                }
+
+                Section("Focused") {
+                    NavigationLink("SyncNotes — @SyncState") {
+                        NotesView()
+                    }
+                    NavigationLink("MultiPlatformTracker — @StoredState") {
+                        TrackerView()
+                    }
+                }
+
+                #if canImport(SwiftData)
+                Section("SwiftData (3.0.0)") {
+                    NavigationLink("SwiftData Lab — relationships, queries, migration") {
+                        SwiftDataLabView()
+                    }
+                }
+                #endif
+
+                Section("Stress") {
+                    NavigationLink("Break It — try to crash AppState") {
+                        BreakItView()
+                    }
+                }
+            }
+            .navigationTitle("AppState 3.0.0")
+        }
+    }
+}

Examples/DemoApp/Sources/BreakItView.swift

@@ -0,0 +1,130 @@
+import AppState
+import SwiftUI
+
+#if canImport(SwiftData)
+import SwiftDataExampleLib
+#endif
+
+// MARK: - Break-It stress state
+
+extension Application {
+    /// A counter hammered by the stress harness.
+    fileprivate var stressCounter: State<Int> {
+        state(initial: 0)
+    }
+
+    /// A `UserDefaults`-backed array grown to large sizes by the stress harness.
+    fileprivate var stressLog: StoredState<[Int]> {
+        storedState(initial: [], id: "breakIt.stressLog")
+    }
+}
+
+// MARK: - BreakItView
+
+/// An interactive "try to crash it" screen.
+///
+/// Every button runs an abusive workload against AppState — tight mutation loops, large persisted
+/// arrays, mass SwiftData inserts, rapid `reset` churn, and concurrent off-main writes — and reports
+/// how long it took and that the app is still standing. The point is to *watch it survive* on a real
+/// device or simulator.
+@available(iOS 18.0, *)
+struct BreakItView: View {
+
+    // MARK: - State
+
+    @AppState(\.stressCounter) private var counter: Int
+    @StoredState(\.stressLog) private var log: [Int]
+
+    @State private var lastResult: String = "Tap a button to try to break AppState."
+    @State private var isRunning: Bool = false
+
+    // MARK: - Body
+
+    var body: some View {
+        List {
+            Section {
+                Text(lastResult)
+                    .font(.callout.monospaced())
+                LabeledContent("counter", value: "\(counter)")
+                LabeledContent("stored array", value: "\(log.count) items")
+            } header: {
+                Text("Status")
+            }
+
+            Section {
+                stressButton("Hammer @AppState ×100k") {
+                    for _ in 0..<100_000 { counter &+= 1 }
+                    return "counter survived 100k writes → \(counter)"
+                }
+                stressButton("Grow @StoredState to 20k") {
+                    log = Array(0..<20_000)
+                    return "UserDefaults-backed array → \(log.count) items"
+                }
+                stressButton("Rapid reset churn ×5k") {
+                    for _ in 0..<5_000 {
+                        Application.reset(\.stressCounter)
+                    }
+                    return "survived 5k resets; counter = \(counter)"
+                }
+                stressButton("Concurrent off-main writes ×10k") {
+                    DispatchQueue.concurrentPerform(iterations: 10_000) { index in
+                        _ = Application.dependency(\.logger)
+                        _ = index
+                    }
+                    return "10k concurrent dependency reads, no crash"
+                }
+                #if canImport(SwiftData)
+                stressButton("Mass SwiftData insert ×2k") {
+                    let store = TodoListStore()
+                    store.createList(titled: "Stress \(counter)")
+                    guard let list = store.lists.last else {
+                        return "no list created"
+                    }
+                    let items = TodoItemStore(list: list)
+                    for index in 0..<2_000 {
+                        items.addItem(titled: "Item \(index)", priority: index % 5)
+                    }
+                    let total = Application.modelState(\.allItems).models.count
+                    return "inserted 2k SwiftData items → \(total) total"
+                }
+                stressButton("Cascade-delete everything") {
+                    let store = TodoListStore()
+                    for list in store.lists {
+                        store.delete(list)
+                    }
+                    let remaining = Application.modelState(\.allItems).models.count
+                    return "cascade-deleted all lists → \(remaining) items remain"
+                }
+                #endif
+            } header: {
+                Text("Abusive workloads")
+            } footer: {
+                Text("Each runs synchronously on the main actor, then reports elapsed time. If the app is still responsive afterwards, AppState held up.")
+            }
+
+            Section {
+                Button("Reset everything", role: .destructive) {
+                    Application.reset(\.stressCounter)
+                    log = []
+                    lastResult = "Reset."
+                }
+            }
+        }
+        .navigationTitle("Break It")
+        .disabled(isRunning)
+    }
+
+    // MARK: - Helpers
+
+    private func stressButton(_ title: String, _ work: @escaping () -> String) -> some View {
+        Button(title) {
+            isRunning = true
+            let clock = ContinuousClock()
+            var summary = ""
+            let elapsed = clock.measure { summary = work() }
+            let millis = Double(elapsed.components.attoseconds) / 1_000_000_000_000_000 + Double(elapsed.components.seconds) * 1_000
+            lastResult = "✓ \(summary)\n   (\(String(format: "%.1f", millis)) ms)"
+            isRunning = false
+        }
+    }
+}