@shaykec/app-agent 1.0.4 → 1.0.6

package/templates/ios/DashTemplate/DashTemplateTests/DataRepositoryTests.swift

@@ -0,0 +1,27 @@
+import XCTest
+@testable import DashTemplate
+
+/// Tests that MockDataProvider conforms to DataRepository and that
+/// DataSourceResolver returns the correct implementation.
+final class DataRepositoryTests: XCTestCase {
+
+    // MARK: - DataRepository Protocol Conformance
+
+    func testMockDataProviderConformsToDataRepository() {
+        let repo: any DataRepository = MockDataProvider.shared
+        XCTAssertNotNil(repo, "MockDataProvider should conform to DataRepository")
+    }
+
+    func testDataSourceResolverReturnsMock() {
+        let repo = DataSourceResolver.repository
+        XCTAssertNotNil(repo, "DataSourceResolver should return a non-nil repository")
+        XCTAssertTrue(repo is MockDataProvider, "When active is .mock, should return MockDataProvider")
+    }
+
+    func testRepositoryLoadData() {
+        let repo: any DataRepository = MockDataProvider.shared
+        repo.loadData()
+        XCTAssertFalse(repo.widgets.isEmpty, "loadData() should populate widgets")
+        XCTAssertFalse(repo.metrics.isEmpty, "loadData() should populate metrics")
+    }
+}

package/templates/ios/DashTemplate/TESTING_MANIFEST.md

@@ -21,6 +21,9 @@ This document catalogs all accessibility identifiers added to the DashTemplate f
 ### Widget Cards (indexed)
 - `dashboard_widget_{index}_card` - Widget card (e.g., `dashboard_widget_0_card`, `dashboard_widget_1_card`)
 
+### Empty State
+- `dashboard_empty_state` — Empty state view when no widgets exist
+
 ## MetricDetailView Identifiers
 
 ### Chart
@@ -37,6 +40,9 @@ This document catalogs all accessibility identifiers added to the DashTemplate f
 ### Dismiss Buttons (indexed)
 - `alert_{index}_dismiss_button` - Dismiss alert button (e.g., `alert_0_dismiss_button`)
 
+### Empty State
+- `alerts_empty_state` — Empty state view when no alerts exist
+
 ## ReportsView Identifiers
 
 ### Export Button

package/templates/ios/DashTemplate/tests/01_launch_dashboard.yaml

@@ -2,15 +2,28 @@ appId: ${APP_BUNDLE_ID}
 ---
 - clearState
 - launchApp
-- assertVisible:
-    id: "tab_bar_dashboard"
+- extendedWaitUntil:
+    visible:
+      id: "dashboard_time_range_picker"
+    timeout: 5000
 - assertVisible:
     id: "dashboard_time_range_picker"
 - assertVisible:
     id: "dashboard_refresh_button"
+- assertVisible:
+    text: "Dashboard"
 - assertVisible:
     id: "dashboard_widget_0_card"
+    optional: true
 - assertVisible:
     id: "dashboard_widget_1_card"
+    optional: true
+- assertVisible:
+    id: "dashboard_empty_state"
+    optional: true
+- assertVisible:
+    id: "tab_bar_dashboard"
+- assertVisible:
+    id: "tab_bar_alerts"
 - assertVisible:
-    id: "dashboard_widget_2_card"
+    id: "tab_bar_settings"

package/templates/ios/DashTemplate/tests/02_tab_navigation.yaml

@@ -2,30 +2,52 @@ appId: ${APP_BUNDLE_ID}
 ---
 - clearState
 - launchApp
+- extendedWaitUntil:
+    visible:
+      id: "dashboard_time_range_picker"
+    timeout: 5000
 - assertVisible:
-    text: "Dashboard"
+    id: "dashboard_time_range_picker"
 - assertVisible:
-    text: "Total Revenue"
-    optional: true
+    text: "Dashboard"
 - tapOn:
     text: "Alerts"
-- waitForAnimationToEnd
+- extendedWaitUntil:
+    visible:
+      id: "alert_0_card"
+    timeout: 3000
+    optional: true
 - assertVisible:
-    text: "Alerts"
+    id: "alert_0_card"
+    optional: true
+- assertVisible:
+    id: "alerts_empty_state"
+    optional: true
 - assertVisible:
-    text: "High Bounce Rate Detected"
+    text: "Alerts"
 - tapOn:
     text: "Settings"
-- waitForAnimationToEnd
+- extendedWaitUntil:
+    visible:
+      text: "Settings"
+    timeout: 3000
 - assertVisible:
     text: "Settings"
-- assertVisible:
+- tapOn:
     text: "Dashboard"
+- extendedWaitUntil:
+    visible:
+      id: "dashboard_time_range_picker"
+    timeout: 3000
+- assertVisible:
+    id: "dashboard_time_range_picker"
 - assertVisible:
-    text: "Data"
-- tapOn:
     text: "Dashboard"
-- waitForAnimationToEnd
+- tapOn:
+    text: "Alerts"
+- extendedWaitUntil:
+    visible:
+      text: "Alerts"
+    timeout: 3000
 - assertVisible:
-    text: "Total Revenue"
-    optional: true
+    text: "Alerts"

package/templates/ios/FamilyTemplate/FamilyTemplate/App/AppConfig.swift

@@ -78,6 +78,15 @@ struct AppConfig {
             ("Share Moments", "Capture and share family memories", "photo.fill")
         ]
     }
+    
+    // CUSTOMIZE:DATASOURCE - Data source configuration
+    struct DataSource {
+        enum SourceType {
+            case localStorage   // Core Data — real local database (DEFAULT)
+            case mock           // In-memory seed data — for development/testing only
+        }
+        static let active: SourceType = .mock
+    }
 }
 
 // MARK: - App State

package/templates/ios/FamilyTemplate/FamilyTemplate/App/FamilyTemplateApp.swift

@@ -4,7 +4,9 @@ import SwiftUI
 @main
 struct FamilyTemplateApp: App {
     @StateObject private var appState = AppState()
-    @StateObject private var dataProvider = MockDataProvider.shared
+    @StateObject private var dataProvider: MockDataProvider = {
+        DataSourceResolver.repository as! MockDataProvider
+    }()
     
     var body: some Scene {
         WindowGroup {
@@ -35,5 +37,5 @@ struct ContentView: View {
 #Preview {
     ContentView()
         .environmentObject(AppState())
-        .environmentObject(MockDataProvider.shared)
+        .environmentObject(DataSourceResolver.repository as! MockDataProvider)
 }

package/templates/ios/FamilyTemplate/FamilyTemplate/Core/EmptyStateView.swift

@@ -0,0 +1,130 @@
+import SwiftUI
+
+// MARK: - Empty State View
+/// Reusable empty state view with illustration, title, subtitle, and optional CTA button.
+/// Used when a list or screen has no content to display.
+struct EmptyStateView: View {
+    let config: EmptyStateConfig
+
+    var body: some View {
+        VStack(spacing: AppConfig.Theme.Spacing.lg) {
+            // Icon/Illustration
+            if let iconName = config.iconName {
+                Image(systemName: iconName)
+                    .font(.system(size: 64))
+                    .foregroundStyle(config.iconColor ?? AppConfig.Theme.primaryColor)
+                    .accessibilityIdentifier("empty_state_icon")
+            }
+
+            // Title
+            Text(config.title)
+                .font(AppConfig.Theme.Typography.title2)
+                .multilineTextAlignment(.center)
+                .accessibilityIdentifier("empty_state_title")
+
+            // Subtitle
+            if let subtitle = config.subtitle {
+                Text(subtitle)
+                    .font(AppConfig.Theme.Typography.body)
+                    .foregroundStyle(.secondary)
+                    .multilineTextAlignment(.center)
+                    .accessibilityIdentifier("empty_state_subtitle")
+            }
+
+            // CTA Button
+            if let buttonTitle = config.buttonTitle,
+               let buttonAction = config.buttonAction {
+                Button {
+                    buttonAction()
+                } label: {
+                    Text(buttonTitle)
+                        .font(AppConfig.Theme.Typography.headline)
+                        .frame(maxWidth: .infinity)
+                        .padding(.vertical, AppConfig.Theme.Spacing.sm)
+                }
+                .buttonStyle(.borderedProminent)
+                .accessibilityIdentifier("empty_state_button")
+            }
+        }
+        .padding(AppConfig.Theme.Spacing.lg)
+        .frame(maxWidth: .infinity, maxHeight: .infinity)
+    }
+}
+
+// MARK: - Empty State Config
+struct EmptyStateConfig {
+    let title: String
+    let subtitle: String?
+    let iconName: String?
+    let iconColor: Color?
+    let buttonTitle: String?
+    let buttonAction: (() -> Void)?
+
+    init(
+        title: String,
+        subtitle: String? = nil,
+        iconName: String? = nil,
+        iconColor: Color? = nil,
+        buttonTitle: String? = nil,
+        buttonAction: (() -> Void)? = nil
+    ) {
+        self.title = title
+        self.subtitle = subtitle
+        self.iconName = iconName
+        self.iconColor = iconColor
+        self.buttonTitle = buttonTitle
+        self.buttonAction = buttonAction
+    }
+}
+
+// MARK: - Preset Empty States
+extension EmptyStateConfig {
+    /// No results found (search, filter)
+    static func noResults(searchQuery: String? = nil) -> EmptyStateConfig {
+        EmptyStateConfig(
+            title: Strings.EmptyStates.noResultsTitle,
+            subtitle: searchQuery.map { Strings.EmptyStates.noResultsSubtitle($0) },
+            iconName: "magnifyingglass",
+            iconColor: .secondary
+        )
+    }
+
+    /// No items in list
+    static func noItems(
+        message: String? = nil,
+        onAdd: (() -> Void)? = nil
+    ) -> EmptyStateConfig {
+        EmptyStateConfig(
+            title: Strings.EmptyStates.noItemsTitle,
+            subtitle: message ?? Strings.EmptyStates.noItemsSubtitle,
+            iconName: "tray",
+            iconColor: .secondary,
+            buttonTitle: onAdd != nil ? Strings.EmptyStates.addItemButton : nil,
+            buttonAction: onAdd
+        )
+    }
+
+    /// No favorites/bookmarks
+    static func noFavorites(onBrowse: (() -> Void)? = nil) -> EmptyStateConfig {
+        EmptyStateConfig(
+            title: Strings.EmptyStates.noFavoritesTitle,
+            subtitle: Strings.EmptyStates.noFavoritesSubtitle,
+            iconName: "heart",
+            iconColor: .pink,
+            buttonTitle: onBrowse != nil ? Strings.EmptyStates.browseButton : nil,
+            buttonAction: onBrowse
+        )
+    }
+
+    /// No internet connection
+    static func noConnection(onRetry: @escaping () -> Void) -> EmptyStateConfig {
+        EmptyStateConfig(
+            title: Strings.EmptyStates.noConnectionTitle,
+            subtitle: Strings.EmptyStates.noConnectionSubtitle,
+            iconName: "wifi.slash",
+            iconColor: .orange,
+            buttonTitle: Strings.EmptyStates.retryButton,
+            buttonAction: onRetry
+        )
+    }
+}

package/templates/ios/FamilyTemplate/FamilyTemplate/Core/Strings.swift

@@ -0,0 +1,27 @@
+import Foundation
+
+enum Strings {
+    // MARK: - Empty States
+    enum EmptyStates {
+        // No Results
+        static let noResultsTitle = "No Results Found"
+        static func noResultsSubtitle(_ query: String) -> String {
+            "We couldn't find anything matching \"\(query)\""
+        }
+
+        // No Items (home/main list)
+        static let noItemsTitle = "Nothing Here Yet"
+        static let noItemsSubtitle = "Get started by adding your first item"
+        static let addItemButton = "Add Item"
+
+        // No Favorites
+        static let noFavoritesTitle = "No Favorites Yet"
+        static let noFavoritesSubtitle = "Items you favorite will appear here"
+        static let browseButton = "Browse"
+
+        // No Connection
+        static let noConnectionTitle = "No Internet Connection"
+        static let noConnectionSubtitle = "Please check your connection and try again"
+        static let retryButton = "Retry"
+    }
+}

package/templates/ios/FamilyTemplate/FamilyTemplate/Data/DataRepository.swift

@@ -0,0 +1,63 @@
+import Foundation
+
+/// Protocol abstracting the data layer. Both MockDataProvider and LocalStorageProvider
+/// conform to this, allowing the app to swap data sources via AppConfig.DataSource.active.
+protocol DataRepository: AnyObject {
+    // MARK: - Observable State
+    
+    var members: [FamilyMember] { get }
+    var chores: [Chore] { get }
+    var rewards: [Reward] { get }
+    var calendarEvents: [CalendarEvent] { get }
+    var milestones: [Milestone] { get }
+    var photos: [Photo] { get }
+    var locationUpdates: [LocationUpdate] { get }
+    
+    // MARK: - CRUD Operations - Members
+    
+    func createMember(_ member: FamilyMember)
+    func updateMember(_ member: FamilyMember)
+    func deleteMember(_ member: FamilyMember)
+    func member(by id: String) -> FamilyMember?
+    
+    // MARK: - CRUD Operations - Chores
+    
+    func createChore(_ chore: Chore)
+    func updateChore(_ chore: Chore)
+    func deleteChore(_ chore: Chore)
+    func completeChore(_ chore: Chore, by memberId: String)
+    func chores(for memberId: String) -> [Chore]
+    func pendingChores() -> [Chore]
+    
+    // MARK: - CRUD Operations - Rewards
+    
+    func createReward(_ reward: Reward)
+    func updateReward(_ reward: Reward)
+    func deleteReward(_ reward: Reward)
+    func redeemReward(_ reward: Reward, by memberId: String) -> Bool
+    func availableRewards() -> [Reward]
+    
+    // MARK: - CRUD Operations - Calendar Events
+    
+    func createEvent(_ event: CalendarEvent)
+    func updateEvent(_ event: CalendarEvent)
+    func deleteEvent(_ event: CalendarEvent)
+    func events(for date: Date) -> [CalendarEvent]
+    
+    // MARK: - CRUD Operations - Milestones
+    
+    func createMilestone(_ milestone: Milestone)
+    func updateMilestone(_ milestone: Milestone)
+    func deleteMilestone(_ milestone: Milestone)
+    func milestones(for memberId: String) -> [Milestone]
+    
+    // MARK: - CRUD Operations - Photos
+    
+    func createPhoto(_ photo: Photo)
+    func updatePhoto(_ photo: Photo)
+    func deletePhoto(_ photo: Photo)
+    
+    // MARK: - Reset
+    
+    func reset()
+}

package/templates/ios/FamilyTemplate/FamilyTemplate/Data/DataSourceResolver.swift

@@ -0,0 +1,14 @@
+import Foundation
+
+/// Resolves the active DataRepository implementation based on AppConfig.DataSource.active.
+enum DataSourceResolver {
+    /// Returns the active DataRepository based on the current configuration.
+    static var repository: any DataRepository {
+        switch AppConfig.DataSource.active {
+        case .localStorage:
+            return LocalStorageProvider.shared
+        case .mock:
+            return MockDataProvider.shared
+        }
+    }
+}

package/templates/ios/FamilyTemplate/FamilyTemplate/Data/LocalStorage/CalendarEventEntity.swift

@@ -0,0 +1,59 @@
+import CoreData
+import Foundation
+
+/// Core Data managed object for CalendarEvent persistence.
+@objc(CalendarEventEntity)
+final class CalendarEventEntity: NSManagedObject {
+    @NSManaged var id: String
+    @NSManaged var title: String
+    @NSManaged var date: Date
+    @NSManaged var membersJSON: String
+    @NSManaged var type: String
+    @NSManaged var eventDescription: String?
+    @NSManaged var location: String?
+    @NSManaged var createdAt: Date
+
+    // MARK: - Conversion
+
+    func toCalendarEvent() -> CalendarEvent {
+        CalendarEvent(
+            id: id,
+            title: title,
+            date: date,
+            members: decodeJSONArray(membersJSON),
+            type: CalendarEventType(rawValue: type) ?? .family,
+            description: eventDescription,
+            location: location,
+            createdAt: createdAt
+        )
+    }
+
+    func update(from event: CalendarEvent) {
+        id = event.id
+        title = event.title
+        date = event.date
+        membersJSON = encodeJSONArray(event.members)
+        type = event.type.rawValue
+        eventDescription = event.description
+        location = event.location
+        createdAt = event.createdAt
+    }
+
+    // MARK: - JSON helpers
+
+    private func decodeJSONArray(_ json: String) -> [String] {
+        guard let data = json.data(using: .utf8),
+              let array = try? JSONDecoder().decode([String].self, from: data) else {
+            return []
+        }
+        return array
+    }
+
+    private func encodeJSONArray(_ array: [String]) -> String {
+        guard let data = try? JSONEncoder().encode(array),
+              let json = String(data: data, encoding: .utf8) else {
+            return "[]"
+        }
+        return json
+    }
+}

package/templates/ios/FamilyTemplate/FamilyTemplate/Data/LocalStorage/ChoreEntity.swift

@@ -0,0 +1,53 @@
+import CoreData
+import Foundation
+
+/// Core Data managed object for Chore persistence.
+@objc(ChoreEntity)
+final class ChoreEntity: NSManagedObject {
+    @NSManaged var id: String
+    @NSManaged var title: String
+    @NSManaged var choreDescription: String?
+    @NSManaged var assignedTo: String?
+    @NSManaged var points: Int32
+    @NSManaged var frequency: String
+    @NSManaged var isCompleted: Bool
+    @NSManaged var dueDate: Date?
+    @NSManaged var completedAt: Date?
+    @NSManaged var completedBy: String?
+    @NSManaged var createdAt: Date
+    @NSManaged var requiresApproval: Bool
+
+    // MARK: - Conversion
+
+    func toChore() -> Chore {
+        Chore(
+            id: id,
+            title: title,
+            description: choreDescription,
+            assignedTo: assignedTo,
+            points: Int(points),
+            frequency: ChoreFrequency(rawValue: frequency) ?? .daily,
+            isCompleted: isCompleted,
+            dueDate: dueDate,
+            completedAt: completedAt,
+            completedBy: completedBy,
+            createdAt: createdAt,
+            requiresApproval: requiresApproval
+        )
+    }
+
+    func update(from chore: Chore) {
+        id = chore.id
+        title = chore.title
+        choreDescription = chore.description
+        assignedTo = chore.assignedTo
+        points = Int32(chore.points)
+        frequency = chore.frequency.rawValue
+        isCompleted = chore.isCompleted
+        dueDate = chore.dueDate
+        completedAt = chore.completedAt
+        completedBy = chore.completedBy
+        createdAt = chore.createdAt
+        requiresApproval = chore.requiresApproval
+    }
+}