vibetunnel/mac/VibeTunnel/Presentation/Views/WelcomeView.swift

import SwiftUI

/// Welcome onboarding view for first-time users.
///
/// Presents a multi-page onboarding experience that introduces VibeTunnel's features,
/// guides through CLI installation, requests AppleScript permissions, and explains
/// dashboard security best practices. The view tracks completion state to ensure
/// it's only shown once.
///
/// ## Topics
///
/// ### Overview
/// The welcome flow consists of eight pages:
/// - ``WelcomePageView`` - Introduction and app overview
/// - ``VTCommandPageView`` - CLI tool installation
/// - ``RequestPermissionsPageView`` - System permissions setup
/// - ``SelectTerminalPageView`` - Terminal selection and testing
/// - ``ProjectFolderPageView`` - Project folder configuration
/// - ``ProtectDashboardPageView`` - Dashboard security configuration
/// - ``ControlAgentArmyPageView`` - Managing multiple AI agent sessions
/// - ``AccessDashboardPageView`` - Remote access instructions
struct WelcomeView: View {
    @State private var currentPage = 0
    @Environment(\.dismiss)
    private var dismiss
    @AppStorage(AppConstants.UserDefaultsKeys.welcomeVersion)
    private var welcomeVersion = 0
    @State private var cliInstaller = CLIInstaller()
    @Environment(SystemPermissionManager.self)
    private var permissionManager

    private let pageWidth: CGFloat = 640
    private let contentHeight: CGFloat = 468 // Total height minus navigation area

    var body: some View {
        VStack(spacing: 0) {
            // Fixed header with animated app icon
            GlowingAppIcon(
                size: 156,
                enableFloating: true,
                enableInteraction: false,
                glowIntensity: 0.3
            )
            .padding(.top, 40)
            .padding(.bottom, 20) // Add padding below icon
            .frame(height: 240)

            // Scrollable content area
            GeometryReader { _ in
                HStack(spacing: 0) {
                    // Page 1: Welcome content (without icon)
                    WelcomeContentView()
                        .frame(width: pageWidth)

                    // Page 2: VT Command
                    VTCommandPageView(cliInstaller: cliInstaller)
                        .frame(width: pageWidth)

                    // Page 3: Request Permissions
                    RequestPermissionsPageView()
                        .frame(width: pageWidth)

                    // Page 4: Select Terminal
                    SelectTerminalPageView()
                        .frame(width: pageWidth)

                    // Page 5: Project Folder
                    ProjectFolderPageView(currentPage: $currentPage)
                        .frame(width: pageWidth)

                    // Page 6: Protect Your Dashboard
                    ProtectDashboardPageView()
                        .frame(width: pageWidth)

                    // Page 7: Control Your Agent Army
                    ControlAgentArmyPageView()
                        .frame(width: pageWidth)

                    // Page 8: Accessing Dashboard
                    AccessDashboardPageView()
                        .frame(width: pageWidth)
                }
                .offset(x: CGFloat(-currentPage) * pageWidth)
                .animation(
                    .interactiveSpring(response: 0.5, dampingFraction: 0.86, blendDuration: 0.25),
                    value: currentPage
                )
            }
            .frame(height: 260) // Total height (560) - header (240) - navigation (60)
            .clipped()

            // Navigation bar with dots and buttons in same row
            HStack(spacing: 20) {
                // Back button - only visible when not on first page
                // Back button with consistent space reservation
                ZStack(alignment: .leading) {
                    // Invisible placeholder that's always there
                    Button(action: {}, label: {
                        Label("Back", systemImage: "chevron.left")
                            .labelStyle(.iconOnly)
                    })
                    .buttonStyle(.plain)
                    .opacity(0)
                    .disabled(true)

                    // Actual back button when needed
                    if currentPage > 0 {
                        Button(action: handleBackAction) {
                            Label("Back", systemImage: "chevron.left")
                                .labelStyle(.iconOnly)
                        }
                        .buttonStyle(.plain)
                        .foregroundColor(.secondary)
                        .opacity(0.7)
                        .pointingHandCursor()
                        .help("Go back to previous page")
                        .transition(.opacity.combined(with: .scale(scale: 0.8)))
                    }
                }
                .frame(minWidth: 80, alignment: .leading) // Same width as Next button, left-aligned

                Spacer()

                // Page indicators centered
                HStack(spacing: 8) {
                    ForEach(0..<8) { index in
                        Button {
                            withAnimation {
                                currentPage = index
                            }
                        } label: {
                            Circle()
                                .fill(index == currentPage ? Color.accentColor : Color.gray.opacity(0.3))
                                .frame(width: 8, height: 8)
                        }
                        .buttonStyle(.plain)
                        .pointingHandCursor()
                    }
                }

                Spacer()

                Button(action: handleNextAction) {
                    Text(buttonTitle)
                        .frame(minWidth: 80)
                }
                .keyboardShortcut(.return)
                .buttonStyle(.borderedProminent)
            }
            .padding(.horizontal, 20)
            .frame(height: 60)
        }
        .frame(width: 640, height: 560)
        .background(Color(NSColor.windowBackgroundColor))
        .onAppear {
            // Always start at the first page when the view appears
            currentPage = 0
        }
    }

    private var buttonTitle: String {
        currentPage == 7 ? "Finish" : "Next"
    }

    private func handleBackAction() {
        withAnimation {
            currentPage -= 1
        }
    }

    private func handleNextAction() {
        if currentPage < 7 {
            withAnimation {
                currentPage += 1
            }
        } else {
            // Finish action - save welcome version and close window
            welcomeVersion = AppConstants.currentWelcomeVersion

            // Close the window using the SwiftUI dismiss environment
            dismiss()

            // Open settings after a delay to ensure the window is fully closed
            Task { @MainActor in
                try? await Task.sleep(for: .milliseconds(200))
                SettingsOpener.openSettings()
            }
        }
    }
}

// MARK: - Preview

#Preview("Welcome View") {
    WelcomeView()
        .environment(SystemPermissionManager.shared)
}