feat: add top overlay to display restore action result

Add a visual feedback overlay that appears at the top of the screen when
users trigger the restore purchases action. The overlay shows success or
failure status with appropriate icons and localized messages, then
auto-dismisses after 3 seconds or on tap.

Changes:
- Add StoreRestoreResult enum for tracking restore status
- Add RestoreOverlayView component with animated appearance
- Update StoreViewModel with restoreResult state and showResult parameter
- Integrate overlay into DeveloperSupportStoreView
- Add localized strings for success/failure messages (en/uk)

Author: claude

Sources/DeveloperSupportStore/Models/StoreRestoreResult.swift

@@ -0,0 +1,16 @@
+//
+//  StoreRestoreResult.swift
+//
+//  Created on 09.01.2026.
+//  Copyright © 2026 IGR Soft. All rights reserved.
+//
+
+import Foundation
+
+/// Represents the result of a restore purchases action.
+public enum StoreRestoreResult: Sendable, Equatable {
+    /// The restore completed successfully.
+    case success
+    /// The restore failed with an error.
+    case failure
+}

Sources/DeveloperSupportStore/Resources/Localizable.xcstrings

@@ -107,6 +107,40 @@
         }
       }
     },
+    "store.restore.failure" : {
+      "extractionState" : "manual",
+      "localizations" : {
+        "en" : {
+          "stringUnit" : {
+            "state" : "translated",
+            "value" : "Unable to restore purchases"
+          }
+        },
+        "uk" : {
+          "stringUnit" : {
+            "state" : "translated",
+            "value" : "Не вдалося відновити покупки"
+          }
+        }
+      }
+    },
+    "store.restore.success" : {
+      "extractionState" : "manual",
+      "localizations" : {
+        "en" : {
+          "stringUnit" : {
+            "state" : "translated",
+            "value" : "Purchases restored successfully"
+          }
+        },
+        "uk" : {
+          "stringUnit" : {
+            "state" : "translated",
+            "value" : "Покупки успішно відновлено"
+          }
+        }
+      }
+    },
     "store.title.oneTime" : {
       "extractionState" : "manual",
       "localizations" : {

Sources/DeveloperSupportStore/Views/DeveloperSupportStoreView.swift

@@ -110,6 +110,17 @@ public struct DeveloperSupportStoreView: View {
                 .ignoresSafeArea()
             }
         }
+        .overlay {
+            if let restoreResult = viewModel.restoreResult {
+                RestoreOverlayView(
+                    result: restoreResult,
+                    colors: colors,
+                    typography: typography,
+                    layout: layout,
+                    onDismiss: viewModel.dismissRestoreResult
+                )
+            }
+        }
     }
 
     // MARK: - Header
@@ -338,7 +349,7 @@ public struct DeveloperSupportStoreView: View {
     @ViewBuilder
     private var restoreButton: some View {
         Button {
-            Task { await viewModel.syncStore() }
+            Task { await viewModel.syncStore(showResult: true) }
         } label: {
             Image(systemName: "arrow.counterclockwise")
                 .font(.system(size: 20, weight: .medium))

Sources/DeveloperSupportStore/Views/RestoreOverlayView.swift

@@ -0,0 +1,172 @@
+//
+//  RestoreOverlayView.swift
+//
+//  Created on 09.01.2026.
+//  Copyright © 2026 IGR Soft. All rights reserved.
+//
+
+import SwiftUI
+
+/// A top overlay view that displays the result of a restore purchases action.
+///
+/// Shows a banner at the top of the screen with success or failure status,
+/// automatically dismissing after a configurable duration.
+struct RestoreOverlayView: View {
+    /// The result to display.
+    let result: StoreRestoreResult
+
+    /// Color configuration.
+    let colors: StoreColors
+
+    /// Typography configuration.
+    let typography: StoreTypography
+
+    /// Layout configuration.
+    let layout: StoreLayoutConstants
+
+    /// Action to dismiss the overlay.
+    let onDismiss: () -> Void
+
+    /// Duration before auto-dismissing (in seconds).
+    private let autoDismissDelay: TimeInterval = 3.0
+
+    @State private var isVisible: Bool = false
+
+    var body: some View {
+        VStack {
+            bannerContent
+                .padding(.horizontal, layout.paddingDefault)
+                .padding(.vertical, layout.paddingSmall)
+                .background(
+                    RoundedRectangle(cornerRadius: layout.radiusDefault)
+                        .fill(backgroundColor)
+                        .shadow(color: .black.opacity(0.2), radius: 8, y: 4)
+                )
+                .padding(.horizontal, layout.paddingBig)
+                .padding(.top, layout.paddingDefault)
+                .offset(y: isVisible ? 0 : -100)
+                .opacity(isVisible ? 1 : 0)
+
+            Spacer()
+        }
+        .onAppear {
+            withAnimation(.spring(response: 0.4, dampingFraction: 0.8)) {
+                isVisible = true
+            }
+            scheduleAutoDismiss()
+        }
+        .onTapGesture {
+            dismissWithAnimation()
+        }
+    }
+
+    // MARK: - Banner Content
+
+    @ViewBuilder
+    private var bannerContent: some View {
+        HStack(spacing: layout.spacingDefault) {
+            Image(systemName: iconName)
+                .font(.system(size: 20, weight: .semibold))
+                .foregroundStyle(iconColor)
+
+            Text(messageKey, bundle: .module)
+                .font(typography.bodyMedium)
+                .foregroundStyle(colors.primaryText)
+
+            Spacer()
+
+            Button {
+                dismissWithAnimation()
+            } label: {
+                Image(systemName: "xmark")
+                    .font(.system(size: 12, weight: .semibold))
+                    .foregroundStyle(colors.primaryText.opacity(0.6))
+                    .frame(width: 24, height: 24)
+                    .contentShape(Rectangle())
+            }
+            .buttonStyle(.plain)
+        }
+    }
+
+    // MARK: - Styling
+
+    private var backgroundColor: Color {
+        switch result {
+        case .success:
+            return colors.selectedView.opacity(0.9)
+        case .failure:
+            return Color.red.opacity(0.9)
+        }
+    }
+
+    private var iconName: String {
+        switch result {
+        case .success:
+            return "checkmark.circle.fill"
+        case .failure:
+            return "exclamationmark.triangle.fill"
+        }
+    }
+
+    private var iconColor: Color {
+        colors.primaryText
+    }
+
+    private var messageKey: LocalizedStringKey {
+        switch result {
+        case .success:
+            return "store.restore.success"
+        case .failure:
+            return "store.restore.failure"
+        }
+    }
+
+    // MARK: - Actions
+
+    private func scheduleAutoDismiss() {
+        Task {
+            try? await Task.sleep(for: .seconds(autoDismissDelay))
+            dismissWithAnimation()
+        }
+    }
+
+    private func dismissWithAnimation() {
+        withAnimation(.easeOut(duration: 0.25)) {
+            isVisible = false
+        }
+        Task {
+            try? await Task.sleep(for: .milliseconds(250))
+            onDismiss()
+        }
+    }
+}
+
+// MARK: - Preview
+
+#Preview("Restore Success") {
+    ZStack {
+        Color.black.ignoresSafeArea()
+
+        RestoreOverlayView(
+            result: .success,
+            colors: .default,
+            typography: .default,
+            layout: .default,
+            onDismiss: {}
+        )
+    }
+}
+
+#Preview("Restore Failure") {
+    ZStack {
+        Color.black.ignoresSafeArea()
+
+        RestoreOverlayView(
+            result: .failure,
+            colors: .default,
+            typography: .default,
+            layout: .default,
+            onDismiss: {}
+        )
+    }
+}

Sources/DeveloperSupportStore/Views/StoreViewModel.swift

@@ -40,6 +40,9 @@ public final class StoreViewModel {
     /// Whether an overlay (loading indicator) should be displayed.
     public var isLoading: Bool = false
 
+    /// The result of the last restore action, shown as an overlay.
+    public var restoreResult: StoreRestoreResult?
+
     // MARK: - Product Collections
 
     /// Subscription products from StoreHelper.
@@ -100,7 +103,9 @@ public final class StoreViewModel {
     ///
     /// After StoreHelper fetches products from the App Store,
     /// this updates the stored properties to trigger UI refresh.
-    public func syncStore() async {
+    ///
+    /// - Parameter showResult: Whether to show the restore result overlay. Defaults to `false`.
+    public func syncStore(showResult: Bool = false) async {
         logger.notice("syncStore() called")
         isLoading = true
         defer { isLoading = false }
@@ -119,11 +124,23 @@ public final class StoreViewModel {
             logger.notice("After assignment:")
             logger.notice("  subscriptionProducts: \(subscriptionProducts.count)")
             logger.notice("  nonConsumableProducts: \(nonConsumableProducts.count)")
+
+            if showResult {
+                restoreResult = .success
+            }
         } catch {
             logger.error("Sync error: \(error.localizedDescription)")
+            if showResult {
+                restoreResult = .failure
+            }
         }
     }
 
+    /// Dismisses the restore result overlay.
+    public func dismissRestoreResult() {
+        restoreResult = nil
+    }
+
     /// Gets product info for a product.
     ///
     /// - Parameter product: The product.