buildanything 1.7.1 → 2.0.0

package/skills/ios/swift-accessibility/resources/audit-template.swift

@@ -0,0 +1,128 @@
+// AccessibilityAuditTests.swift
+// Drop-in XCUITest file for automated accessibility auditing.
+// Requires a platform that supports performAccessibilityAudit().
+// The helper methods below skip gracefully on older deployment targets.
+//
+// Usage:
+// 1. Add this file to your UI test target
+// 2. Add navigation steps for each screen in your app
+// 3. Run tests — failures indicate accessibility issues
+//
+// These tests use performAccessibilityAudit() to catch:
+// - Missing accessibility labels
+// - Low color contrast (WCAG thresholds)
+// - Touch targets below 44x44pt
+// - Text that doesn't scale with Dynamic Type
+// - Clipped or truncated text
+// - Incorrect accessibility traits
+
+import XCTest
+
+final class AccessibilityAuditTests: XCTestCase {
+
+    let app = XCUIApplication()
+
+    override func setUpWithError() throws {
+        continueAfterFailure = false
+        app.launch()
+    }
+
+    // MARK: - Full Audit (All Checks)
+
+    /// Audits the launch screen with all accessibility checks.
+    /// Add one test method per key screen in your app.
+    func testLaunchScreenAccessibility() throws {
+        try performAudit()
+    }
+
+    // MARK: - Per-Screen Audits
+    //
+    // Copy this pattern for each screen. Navigate to the screen,
+    // then run the audit.
+    //
+    // func testSettingsScreenAccessibility() throws {
+    //     app.tabBars.buttons["Settings"].tap()
+    //     try performAudit()
+    // }
+    //
+    // func testProfileScreenAccessibility() throws {
+    //     app.tabBars.buttons["Profile"].tap()
+    //     try performAudit()
+    // }
+
+    // MARK: - Filtered Audits
+
+    /// Contrast and labels only — the two most common failures.
+    func testContrastAndLabels() throws {
+        try performAudit([.contrast, .sufficientElementDescription])
+    }
+
+    /// Touch targets and element detection.
+    func testHitRegionsAndDetection() throws {
+        try performAudit([.hitRegion, .elementDetection])
+    }
+
+    /// Dynamic Type scaling and text clipping.
+    func testDynamicTypeSupport() throws {
+        try performAudit([.dynamicType, .textClipped])
+    }
+
+    // MARK: - Audit with Known Issue Exclusions
+
+    /// Full audit that ignores specific known issues.
+    /// Replace the example exclusion with your own.
+    func testAuditWithExclusions() throws {
+        try performAudit(.all) { issue in
+            // Example: ignore contrast issues on branded splash logo
+            // if issue.auditType == .contrast,
+            //    issue.element?.identifier == "splashLogo" {
+            //     return true  // true = ignore this issue
+            // }
+            return false  // false = fail on this issue
+        }
+    }
+
+    // MARK: - Multi-Screen Regression Test
+
+    /// Navigates through key screens and audits each one.
+    /// Customize the navigation steps for your app's tab bar or flow.
+    func testFullAppAccessibilityRegression() throws {
+        // Screen 1: Launch / Home
+        try performAudit()
+
+        // Screen 2: Navigate to second tab (customize for your app)
+        // app.tabBars.buttons["Search"].tap()
+        // try performAudit()
+
+        // Screen 3: Navigate to third tab
+        // app.tabBars.buttons["Settings"].tap()
+        // try performAudit()
+    }
+
+    private func performAudit(
+        _ auditTypes: XCUIAccessibilityAuditType = .all
+    ) throws {
+        try requireAccessibilityAuditSupport()
+        if #available(iOS 17, macOS 14, tvOS 17, watchOS 10, visionOS 1, *) {
+            try app.performAccessibilityAudit(for: auditTypes)
+        }
+    }
+
+    private func performAudit(
+        _ auditTypes: XCUIAccessibilityAuditType = .all,
+        issueHandler: @escaping (XCUIAccessibilityAuditIssue) throws -> Bool
+    ) throws {
+        try requireAccessibilityAuditSupport()
+        if #available(iOS 17, macOS 14, tvOS 17, watchOS 10, visionOS 1, *) {
+            try app.performAccessibilityAudit(for: auditTypes, issueHandler)
+        }
+    }
+
+    private func requireAccessibilityAuditSupport() throws {
+        guard #available(iOS 17, macOS 14, tvOS 17, watchOS 10, visionOS 1, *) else {
+            throw XCTSkip(
+                "performAccessibilityAudit() requires iOS 17+, macOS 14+, tvOS 17+, watchOS 10+, or visionOS 1+."
+            )
+        }
+    }
+}

package/skills/ios/swift-accessibility/resources/qa-checklist.md

@@ -0,0 +1,258 @@
+# Accessibility QA Checklist
+
+Standalone checklist for manual accessibility testing. Hand this to QA testers — no skill or Claude knowledge required.
+
+Aligned with Apple's 9 App Store Accessibility Nutrition Labels and WCAG 2.2 Level AA.
+
+---
+
+## How to Use This Checklist
+
+1. Test on a **real device** — Simulator doesn't fully support VoiceOver, Voice Control, or Switch Control
+2. Test **every key user flow**: launch, onboarding, login, main feature, settings, purchase (if applicable)
+3. Mark each item: Pass / Fail / N/A
+4. A single Fail in a Nutrition Label category means that label **cannot be claimed** on the App Store
+
+---
+
+## Before You Start: Xcode Tools
+
+### Xcode Canvas Variants (during development)
+In the preview canvas, click the **Variants** button (grid icon) at the bottom:
+- **Dynamic Type Variants** — renders the view at all 12 text sizes
+- **Color Scheme Variants** — shows light and dark mode side by side
+- **Orientation Variants** — portrait and landscape
+
+### Xcode Canvas Device Settings (during development)
+Click the **Device Settings** button (slider icon) at the bottom of the canvas:
+- Set color scheme, Dynamic Type size, and orientation for a single preview
+- Combine settings to test specific scenarios (e.g., dark mode + large text)
+
+### Accessibility Inspector (Simulator or device)
+Xcode menu → Open Developer Tool → Accessibility Inspector
+- **Inspection tab** — point at any element to see its label, traits, value, and frame size
+- **Audit tab** — run automated checks on the current screen (missing labels, low contrast, small targets)
+- **Settings tab** — toggle Increase Contrast, Reduce Motion, Bold Text, Reduce Transparency on the Simulator without changing device settings
+
+### performAccessibilityAudit() (automated tests)
+Add to XCUITest target (iOS 17+). Catches missing labels, low contrast, small hit regions, clipped text, and Dynamic Type failures in CI. See `resources/audit-template.swift` for a drop-in template.
+
+---
+
+## 1. VoiceOver
+
+**Enable:** Settings → Accessibility → VoiceOver (or triple-click Side button if configured)
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 1.1 | Navigate all elements | Swipe right repeatedly through entire screen | Every interactive element is reachable |
+| 1.2 | Labels are meaningful | Tap each element, listen to announcement | Label describes the element concisely, not "button" or "image" |
+| 1.3 | No redundant type in label | Listen for "button button" or "image image" | VoiceOver adds type automatically — label should not include it |
+| 1.4 | State as traits | Toggle a switch, select a tab | VoiceOver says "selected" / "on" / "off" — not embedded in the label text |
+| 1.5 | Decorative images hidden | Swipe through screen | Decorative images are skipped |
+| 1.6 | Reading order is logical | Use "Read All" (two-finger swipe up) | Content reads in visual order, top-to-bottom, left-to-right |
+| 1.7 | Focus after navigation | Push a new screen | Focus moves to first element of new screen (usually title or back button) |
+| 1.8 | Focus after modal dismiss | Dismiss a sheet/alert | Focus returns to the element that triggered it |
+| 1.9 | Adjustable controls work | Swipe up/down on slider or stepper | Value changes and is announced |
+| 1.10 | Dynamic changes announced | Trigger a loading state or error | VoiceOver announces the change ("Loading complete", "Error: …") |
+| 1.11 | Complete a key flow | Do the main task start-to-finish with VoiceOver | Task completes without sighted assistance |
+
+---
+
+## 2. Voice Control
+
+**Enable:** Settings → Accessibility → Voice Control
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 2.1 | Show numbers | Say "Show numbers" | Every interactive element has a number overlay |
+| 2.2 | Tap by number | Say "Tap [number]" | Correct element activates |
+| 2.3 | Show names | Say "Show names" | Every element shows its visible text label |
+| 2.4 | Tap by name | Say "Tap [label]" | Element activates — label must match visible text exactly |
+| 2.5 | Text input | Say "Type [text]" in a text field | Text is entered correctly |
+| 2.6 | Scrolling | Say "Scroll down" / "Scroll up" | Content scrolls |
+| 2.7 | Icon-only elements | Say "Tap Share" (or the label) for icon-only buttons | Button activates — requires `.accessibilityInputLabels` |
+
+---
+
+## 3. Larger Text (Dynamic Type)
+
+**Enable:** Settings → Accessibility → Display & Text Size → Larger Text → drag slider to max
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 3.1 | Text scales | Set to Accessibility 5 (max) | All text is larger |
+| 3.2 | No clipping | Navigate all screens at max size | No text cut off without "..." affordance |
+| 3.3 | No overlapping | Check all screens at max size | No elements overlap |
+| 3.4 | Layout adapts | Check horizontal layouts | Rows/columns reflow to vertical when needed |
+| 3.5 | Fixed UI chrome | Long-press on tab bar icons or toolbar items | Large Content Viewer shows enlarged version |
+| 3.6 | Small text readable | Set to smallest size | Text is still readable |
+
+**Quick check with Xcode:** Use Canvas Dynamic Type Variants to see all 12 sizes at once.
+
+---
+
+## 4. Sufficient Contrast
+
+**Tool:** Accessibility Inspector → Inspection tab → Color contrast
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 4.1 | Normal text | Check body text against background | ≥ 4.5:1 contrast ratio |
+| 4.2 | Large text | Check headings (≥ 18pt or 14pt bold) | ≥ 3:1 contrast ratio |
+| 4.3 | Non-text elements | Check icons, borders, focus rings | ≥ 3:1 contrast ratio |
+| 4.4 | Both modes | Repeat all checks in Dark Mode | Passes in both light and dark |
+| 4.5 | Increased Contrast | Enable Increase Contrast in Accessibility Inspector Settings | Borders and separators become more visible |
+| 4.6 | Placeholder text | Check text field placeholders | ≥ 4.5:1 against background |
+
+---
+
+## 5. Dark Interface
+
+**Enable:** Settings → Display & Brightness → Dark
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 5.1 | All text readable | Navigate all screens | No white-on-white or invisible text |
+| 5.2 | Borders visible | Check cards, sections, separators | Borders and dividers are visible |
+| 5.3 | Images correct | Check photos, icons | No white halo; images aren't inverted incorrectly |
+| 5.4 | Status indicators | Check colored status elements | Still distinguishable in dark mode |
+
+---
+
+## 6. Differentiate Without Color
+
+**Enable:** Settings → Accessibility → Display & Text Size → Color Filters → Grayscale
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 6.1 | Status indicators | Check error/success/warning states | Distinguishable by shape, icon, or text — not color alone |
+| 6.2 | Charts and graphs | Check data visualizations | Data series distinguishable by pattern, shape, or label |
+| 6.3 | Links | Check link text | Underlined or otherwise distinguishable from body text |
+| 6.4 | Form validation | Trigger an error state | Error is indicated by icon or text, not just red color |
+
+---
+
+## 7. Reduced Motion
+
+**Enable:** Settings → Accessibility → Motion → Reduce Motion
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 7.1 | Navigation transitions | Push/pop screens | No sliding animation — dissolve or instant |
+| 7.2 | UI animations | Trigger state changes, loading | Animations removed or replaced with fade/opacity |
+| 7.3 | Auto-playing content | Check for auto-playing animations/video | Stopped or has manual play control |
+| 7.4 | Parallax effects | Scroll content | No parallax or motion effects |
+
+**Quick check:** Toggle Reduce Motion in Accessibility Inspector Settings tab while running in Simulator.
+
+---
+
+## 8. Captions
+
+**Applies to:** Apps with video or audio content
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 8.1 | Captions available | Play a video with dialogue | Captions can be enabled via player controls |
+| 8.2 | Auto-enable | Enable Closed Captions in Settings → Accessibility → Subtitles & Captioning | Captions appear automatically |
+| 8.3 | Captions accurate | Read captions while watching | Captions match spoken content |
+| 8.4 | Timing correct | Watch captions during video | Captions sync with audio |
+
+---
+
+## 9. Audio Descriptions
+
+**Applies to:** Apps with video content where visual information is important
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 9.1 | Audio Descriptions available | Play a video | Audio Description track can be selected |
+| 9.2 | Auto-enable | Enable Audio Descriptions in Settings → Accessibility → Audio Descriptions | Audio Descriptions play automatically |
+| 9.3 | Content described | Listen to Audio Descriptions | Important visual information is narrated |
+
+---
+
+## 10. Additional Checks
+
+### Switch Control
+
+**Enable:** Settings → Accessibility → Switch Control
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 10.1 | Scanning | Enable auto-scan | Every element is highlighted in sequence |
+| 10.2 | Activation | Select a highlighted element | Correct action triggers |
+| 10.3 | Custom actions | Navigate to elements with swipe actions | Actions appear in scanning menu |
+| 10.4 | No timeouts | Use the app slowly | Nothing times out or auto-advances |
+
+### Full Keyboard Access (iPad / Mac)
+
+**Enable:** Settings → Accessibility → Keyboards → Full Keyboard Access
+
+| # | Test | How to verify | Pass criteria |
+|---|---|---|---|
+| 10.5 | Tab navigation | Press Tab repeatedly | Focus moves through all interactive elements |
+| 10.6 | Reverse Tab | Press Shift+Tab | Focus moves backward |
+| 10.7 | Activation | Press Space or Return on focused element | Element activates |
+| 10.8 | Escape dismissal | Press Escape on modal | Modal dismisses |
+| 10.9 | No focus traps | Tab through entire app | Focus never gets stuck |
+
+---
+
+## Summary Template
+
+After testing, fill in:
+
+| Nutrition Label | Status | Blocking Issues |
+|---|---|---|
+| VoiceOver | Pass / Fail | |
+| Voice Control | Pass / Fail | |
+| Larger Text | Pass / Fail | |
+| Sufficient Contrast | Pass / Fail | |
+| Dark Interface | Pass / Fail | |
+| Differentiate Without Color | Pass / Fail | |
+| Reduced Motion | Pass / Fail | |
+| Captions | Pass / Fail / N/A | |
+| Audio Descriptions | Pass / Fail / N/A | |
+
+### App Store recommendation draft
+
+Use the completed summary above to prepare an App Store Accessibility Nutrition Label recommendation:
+
+- You could claim: every label marked Pass
+- You should not claim: every label marked Fail
+- Not applicable: every label marked N/A
+- Add short reasons for both supported and unsupported labels
+
+Example handoff:
+
+```md
+Accessibility Nutrition Label recommendation
+
+You could claim:
+- VoiceOver
+- Voice Control
+- Larger Text
+- Sufficient Contrast
+- Dark Interface
+- Differentiate Without Color
+- Reduced Motion
+
+Why you could claim them:
+- VoiceOver: all reviewed common tasks are reachable, labeled, and operable with VoiceOver
+- Voice Control: all reviewed interactive elements can be activated by visible name or input label
+- Larger Text: reviewed screens reflow correctly and remain readable at the largest supported sizes
+- Sufficient Contrast: reviewed text and interactive elements meet contrast requirements in light and dark mode
+- Dark Interface: reviewed screens support dark appearance without unreadable content or broken chrome
+- Differentiate Without Color: reviewed states and status indicators remain understandable without color alone
+- Reduced Motion: reviewed transitions and state changes respect Reduce Motion
+
+You should not claim:
+- Captions
+- Audio Descriptions
+
+Why you should not claim them:
+- Captions: the app has no primary video or long-form media experience in the reviewed scope
+- Audio Descriptions: the app has no video content that would justify this label in the reviewed scope
+```

package/skills/ios/swift-actor-persistence/SKILL.md

@@ -0,0 +1,143 @@
+---
+name: swift-actor-persistence
+description: Thread-safe data persistence in Swift using actors — in-memory cache with file-backed storage, eliminating data races by design.
+origin: ECC
+---
+
+# Swift Actors for Thread-Safe Persistence
+
+Patterns for building thread-safe data persistence layers using Swift actors. Combines in-memory caching with file-backed storage, leveraging the actor model to eliminate data races at compile time.
+
+## When to Activate
+
+- Building a data persistence layer in Swift 5.5+
+- Need thread-safe access to shared mutable state
+- Want to eliminate manual synchronization (locks, DispatchQueues)
+- Building offline-first apps with local storage
+
+## Core Pattern
+
+### Actor-Based Repository
+
+The actor model guarantees serialized access — no data races, enforced by the compiler.
+
+```swift
+public actor LocalRepository<T: Codable & Identifiable> where T.ID == String {
+    private var cache: [String: T] = [:]
+    private let fileURL: URL
+
+    public init(directory: URL = .documentsDirectory, filename: String = "data.json") {
+        self.fileURL = directory.appendingPathComponent(filename)
+        // Synchronous load during init (actor isolation not yet active)
+        self.cache = Self.loadSynchronously(from: fileURL)
+    }
+
+    // MARK: - Public API
+
+    public func save(_ item: T) throws {
+        cache[item.id] = item
+        try persistToFile()
+    }
+
+    public func delete(_ id: String) throws {
+        cache[id] = nil
+        try persistToFile()
+    }
+
+    public func find(by id: String) -> T? {
+        cache[id]
+    }
+
+    public func loadAll() -> [T] {
+        Array(cache.values)
+    }
+
+    // MARK: - Private
+
+    private func persistToFile() throws {
+        let data = try JSONEncoder().encode(Array(cache.values))
+        try data.write(to: fileURL, options: .atomic)
+    }
+
+    private static func loadSynchronously(from url: URL) -> [String: T] {
+        guard let data = try? Data(contentsOf: url),
+              let items = try? JSONDecoder().decode([T].self, from: data) else {
+            return [:]
+        }
+        return Dictionary(uniqueKeysWithValues: items.map { ($0.id, $0) })
+    }
+}
+```
+
+### Usage
+
+All calls are automatically async due to actor isolation:
+
+```swift
+let repository = LocalRepository<Question>()
+
+// Read — fast O(1) lookup from in-memory cache
+let question = await repository.find(by: "q-001")
+let allQuestions = await repository.loadAll()
+
+// Write — updates cache and persists to file atomically
+try await repository.save(newQuestion)
+try await repository.delete("q-001")
+```
+
+### Combining with @Observable ViewModel
+
+```swift
+@Observable
+final class QuestionListViewModel {
+    private(set) var questions: [Question] = []
+    private let repository: LocalRepository<Question>
+
+    init(repository: LocalRepository<Question> = LocalRepository()) {
+        self.repository = repository
+    }
+
+    func load() async {
+        questions = await repository.loadAll()
+    }
+
+    func add(_ question: Question) async throws {
+        try await repository.save(question)
+        questions = await repository.loadAll()
+    }
+}
+```
+
+## Key Design Decisions
+
+| Decision | Rationale |
+|----------|-----------|
+| Actor (not class + lock) | Compiler-enforced thread safety, no manual synchronization |
+| In-memory cache + file persistence | Fast reads from cache, durable writes to disk |
+| Synchronous init loading | Avoids async initialization complexity |
+| Dictionary keyed by ID | O(1) lookups by identifier |
+| Generic over `Codable & Identifiable` | Reusable across any model type |
+| Atomic file writes (`.atomic`) | Prevents partial writes on crash |
+
+## Best Practices
+
+- **Use `Sendable` types** for all data crossing actor boundaries
+- **Keep the actor's public API minimal** — only expose domain operations, not persistence details
+- **Use `.atomic` writes** to prevent data corruption if the app crashes mid-write
+- **Load synchronously in `init`** — async initializers add complexity with minimal benefit for local files
+- **Combine with `@Observable`** ViewModels for reactive UI updates
+
+## Anti-Patterns to Avoid
+
+- Using `DispatchQueue` or `NSLock` instead of actors for new Swift concurrency code
+- Exposing the internal cache dictionary to external callers
+- Making the file URL configurable without validation
+- Forgetting that all actor method calls are `await` — callers must handle async context
+- Using `nonisolated` to bypass actor isolation (defeats the purpose)
+
+## When to Use
+
+- Local data storage in iOS/macOS apps (user data, settings, cached content)
+- Offline-first architectures that sync to a server later
+- Any shared mutable state that multiple parts of the app access concurrently
+- Replacing legacy `DispatchQueue`-based thread safety with modern Swift concurrency

package/skills/ios/swift-concurrency/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Antoine van der Lee
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.