moai-lang-swift

Core Capabilities

• Swift 6.0: Typed throws, complete concurrency, data-race safety by default
• SwiftUI 6: @Observable macro, NavigationStack, modern declarative UI
• Combine: Reactive programming with publishers and subscribers
• Swift Concurrency: async/await, actors, TaskGroup, isolation
• XCTest: Unit testing, UI testing, async test support
• Swift Package Manager: Dependency management

Version Requirements

• Swift: 6.0+
• Xcode: 16.0+
• iOS: 17.0+ (recommended), minimum 15.0
• macOS: 14.0+ (recommended)

Project Setup

Package.swift Configuration: Begin with swift-tools-version comment set to 6.0. Import PackageDescription. Define let package with Package initializer. Set name, platforms array with .iOS and .macOS minimum versions, products array with library definitions, dependencies array with package URLs and version requirements, and targets array with target and testTarget entries including dependencies.

Essential Patterns

Basic @Observable ViewModel: Import Observation framework. Apply @Observable and @MainActor attributes to final class. Declare private(set) var properties for state. Create async functions that set isLoading true, use defer to set false, and assign fetched data with try? await and nil coalescing.

Basic SwiftUI View: Define struct conforming to View. Declare @State private var for viewModel. In body computed property, use NavigationStack containing List iterating over viewModel items. Add .task modifier calling await on viewModel.load and .refreshable modifier for pull-to-refresh.

Basic Actor for Thread Safety: Define actor type with private dictionary for cache. Create get function returning optional Data for key lookup. Create set function taking key and data parameters for cache storage.

Swift 6 Features

[modules/swift6-features.md](modules/swift6-features.md)

• Typed throws for precise error handling
• Complete concurrency checking
• Data-race safety by default
• Sendable conformance requirements

SwiftUI Patterns

[modules/swiftui-patterns.md](modules/swiftui-patterns.md)

• @Observable macro and state management
• NavigationStack and navigation patterns
• View lifecycle and .task modifier
• Environment and dependency injection

Swift Concurrency

[modules/concurrency.md](modules/concurrency.md)

• async/await fundamentals
• Actor isolation and @MainActor
• TaskGroup for parallel execution
• Custom executors and structured concurrency

Combine Framework

[modules/combine-reactive.md](modules/combine-reactive.md)

• Publishers and Subscribers
• Operators and transformations
• async/await bridge patterns
• Integration with SwiftUI

Core Swift

• /apple/swift - Swift language and standard library
• /apple/swift-evolution - Swift evolution proposals
• /apple/swift-package-manager - SwiftPM documentation
• /apple/swift-async-algorithms - Async sequence algorithms

Popular Libraries

• /Alamofire/Alamofire - HTTP networking
• /onevcat/Kingfisher - Image downloading and caching
• /realm/realm-swift - Mobile database
• /pointfreeco/swift-composable-architecture - TCA architecture
• /Quick/Quick - BDD testing framework
• /Quick/Nimble - Matcher framework

Async Test with MainActor: Apply @MainActor attribute to test class extending XCTestCase. Define test function with async throws. Create mock API and set mock data. Initialize system under test with mock. Call await on async method. Use XCTAssertEqual for count verification and XCTAssertFalse for boolean state checks.

• moai-lang-kotlin - Android counterpart for cross-platform projects
• moai-lang-flutter - Flutter/Dart for cross-platform mobile
• moai-domain-backend - API integration and backend communication
• moai-foundation-quality - iOS security best practices
• moai-workflow-testing - Xcode debugging and profiling

• [reference.md](reference.md) - Architecture patterns, network layer, SwiftData
• [examples.md](examples.md) - Production-ready code examples