AppState.swift

1import AppKit2import Combine3import Foundation45enum AppTab {6  case explore7  case local8  case favorites9  case history10  case settings11}1213/// Browse mode for the Explore tab. Each maps to a Wallhaven `sorting`14/// value; the free-text search box applies on top of the chosen mode.15enum FeedMode: String, CaseIterable, Identifiable {16  case latest17  case toplist18  case random1920  var id: String { rawValue }2122  var sorting: WallhavenSorting {23    switch self {24    case .latest: return .dateAdded25    case .toplist: return .toplist26    case .random: return .random27    }28  }2930  var displayName: String {31    switch self {32    case .latest: return "Latest"33    case .toplist: return "Toplist"34    case .random: return "Random"35    }36  }3738  var systemImage: String {39    switch self {40    case .latest: return "clock"41    case .toplist: return "diamond"42    case .random: return "arrow.triangle.2.circlepath"43    }44  }45}4647@MainActor48class AppState: ObservableObject {49  // Navigation50  @Published var activeTab: AppTab = .explore5152  // Data Sources53  @Published var wallpapers: [Wallpaper] = []54  @Published var favoritesManager = FavoritesManager.shared55  @Published var historyManager = HistoryManager.shared5657  // Search & Filter58  @Published var feedMode: FeedMode = .latest59  @Published var searchText: String = ""60  @Published var selectedResolution: String = ""61  @Published var selectedRatio: String = ""62  @Published var isLoading: Bool = false63  @Published var errorMessage: String?6465  // Pagination66  @Published var canLoadMore = true67  private var currentPage = 168  private var isFetchingMore = false6970  // Settings71  @Published var saveToFolderEnabled: Bool {72    didSet { UserDefaults.standard.set(saveToFolderEnabled, forKey: "saveToFolderEnabled") }73  }74  @Published var saveFolderPath: String {75    didSet { UserDefaults.standard.set(saveFolderPath, forKey: "saveFolderPath") }76  }77  @Published var sourceFolderPaths: [String] {78    didSet { UserDefaults.standard.set(sourceFolderPaths, forKey: "sourceFolderPaths") }79  }80  @Published var launchAtLogin: Bool {81    didSet { autostartManager.isEnabled = launchAtLogin }82  }8384  // Filters85  @Published var categories: (general: Bool, anime: Bool, people: Bool) = (true, true, true)86  @Published var purity: (sfw: Bool, sketchy: Bool) = (true, false)8788  let availableResolutions = ["Any", "1920x1080", "2560x1440", "3840x2160", "5120x2880"]89  let availableRatios = ["Any", "16x9", "16x10", "21x9", "32x9", "4x3"]9091  private let api: WallhavenSearching92  private let wallpaperManager: WallpaperManaging93  private let autostartManager: AutostartManaging94  private let chooseFolder: @MainActor (URL, @escaping (URL?) -> Void) -> Void95  private let chooseSourceFolders: @MainActor ([URL], @escaping ([URL]) -> Void) -> Void96  private let terminateApplication: @MainActor () -> Void97  private let removeTempFile: @MainActor (URL) throws -> Void98  private var cancellables = Set<AnyCancellable>()99  // Monotonic token incremented on every reset; only the search started with100  // the latest token may commit results. This keeps a slow older request from101  // overwriting the wallpapers/canLoadMore/errorMessage after a newer search102  // (or pagination) has begun.103  private var searchGeneration: UInt64 = 0104105  init(106    api: WallhavenSearching? = nil,107    wallpaperManager: WallpaperManaging? = nil,108    autostartManager: AutostartManaging? = nil,109    chooseFolder: (@MainActor (URL, @escaping (URL?) -> Void) -> Void)? = nil,110    chooseSourceFolders: (@MainActor ([URL], @escaping ([URL]) -> Void) -> Void)? = nil,111    terminateApplication: (@MainActor () -> Void)? = nil,112    removeTempFile: @escaping @MainActor (URL) throws -> Void = {113      try FileManager.default.removeItem(at: $0)114    },115    picturesDirectoryProvider: @escaping () -> URL? = {116      FileManager.default.urls(for: .picturesDirectory, in: .userDomainMask).first117    },118    observeChanges: Bool = true119  ) {120    let api = api ?? WallhavenAPI()121    let wallpaperManager = wallpaperManager ?? WallpaperManager.shared122    let autostartManager = autostartManager ?? AutostartManager.shared123    self.api = api124    self.wallpaperManager = wallpaperManager125    self.autostartManager = autostartManager126    self.chooseFolder = chooseFolder ?? AppState.presentFolderPicker127    self.chooseSourceFolders = chooseSourceFolders ?? AppState.chooseDefaultSourceFolders128    self.terminateApplication = terminateApplication ?? { NSApp.terminate(nil) }129    self.removeTempFile = removeTempFile130    self.launchAtLogin = autostartManager.isEnabled131    // Load settings132    self.saveToFolderEnabled = UserDefaults.standard.bool(forKey: "saveToFolderEnabled")133    if let path = UserDefaults.standard.string(forKey: "saveFolderPath") {134      self.saveFolderPath = path135    } else {136      let pictures = picturesDirectoryProvider() ?? FileManager.default.temporaryDirectory137      self.saveFolderPath = pictures.appendingPathComponent("Haven").path138    }139    // Migrate the legacy single-folder setting into the new source list140    // exactly once, so existing users keep seeing their gallery. Idempotent141    // because we only seed when the new key is absent.142    if let storedSources = UserDefaults.standard.array(forKey: "sourceFolderPaths")143      as? [String]144    {145      self.sourceFolderPaths = storedSources146    } else if let legacyPath = UserDefaults.standard.string(forKey: "saveFolderPath") {147      let seeded = [legacyPath]148      self.sourceFolderPaths = seeded149      UserDefaults.standard.set(seeded, forKey: "sourceFolderPaths")150    } else {151      self.sourceFolderPaths = []152    }153154    guard observeChanges else { return }155156    // Debounce search157    $searchText158      .debounce(for: .seconds(0.5), scheduler: DispatchQueue.main)159      .sink { [weak self] _ in self?.scheduleSearch() }160      .store(in: &cancellables)161162    // Observe filters163    $categories164      .map { _ in () }165      .debounce(for: .seconds(0.5), scheduler: DispatchQueue.main)166      .sink { [weak self] _ in Task { await self?.fetchWallpapers() } }167      .store(in: &cancellables)168169    $purity170      .map { _ in () }171      .debounce(for: .seconds(0.5), scheduler: DispatchQueue.main)172      .sink { [weak self] _ in Task { await self?.fetchWallpapers() } }173      .store(in: &cancellables)174175    // Resolution and ratio pickers fire one value per menu interaction.176    // Debouncing them keeps a single user gesture producing a single177    // network request, matching the categories/purity/searchText flow.178    $selectedResolution179      .dropFirst()180      .debounce(for: .seconds(0.5), scheduler: DispatchQueue.main)181      .sink { [weak self] _ in Task { await self?.fetchWallpapers() } }182      .store(in: &cancellables)183184    $selectedRatio185      .dropFirst()186      .debounce(for: .seconds(0.5), scheduler: DispatchQueue.main)187      .sink { [weak self] _ in Task { await self?.fetchWallpapers() } }188      .store(in: &cancellables)189190    $feedMode191      .dropFirst()192      .sink { [weak self] _ in193        Task { [weak self] in await self?.fetchWallpapers(reset: true) }194      }195      .store(in: &cancellables)196197    updateLocalWallpapersMonitoring()198199    $saveToFolderEnabled200      .dropFirst()201      .sink { [weak self] _ in202        self?.updateLocalWallpapersMonitoring()203      }204      .store(in: &cancellables)205206    $saveFolderPath207      .dropFirst()208      .sink { [weak self] _ in209        self?.updateLocalWallpapersMonitoring()210      }211      .store(in: &cancellables)212213    $sourceFolderPaths214      .dropFirst()215      .sink { [weak self] _ in216        self?.updateLocalWallpapersMonitoring()217      }218      .store(in: &cancellables)219  }220221  private func updateLocalWallpapersMonitoring() {222    if saveToFolderEnabled {223      LocalWallpapersManager.shared.startMonitoring(folderPath: saveFolderPath)224    } else {225      LocalWallpapersManager.shared.stopMonitoring()226    }227  }228229  func scheduleSearch() { Task { [weak self] in await self?.fetchWallpapers() } }230231  func fetchWallpapers(reset: Bool = true, refreshing: Bool = false) async {232    if reset {233      isFetchingMore = false234      searchGeneration &+= 1235    }236    let requestGeneration = searchGeneration237    let pageToRequest: Int238    if reset {239      if !refreshing {240        isLoading = true241        wallpapers = []242      }243      errorMessage = nil244      currentPage = 1245      canLoadMore = true246      pageToRequest = 1247    } else {248      guard !isFetchingMore && canLoadMore else { return }249      isFetchingMore = true250      pageToRequest = currentPage251    }252253    do {254      let resolutions =255        selectedResolution == "Any" || selectedResolution.isEmpty ? [] : [selectedResolution]256      let ratios = selectedRatio == "Any" || selectedRatio.isEmpty ? [] : [selectedRatio]257258      // Construct bitstrings259      let catStr =260        "\(categories.general ? "1" : "0")\(categories.anime ? "1" : "0")\(categories.people ? "1" : "0")"261      // NSFW is intentionally unsupported; the third purity bit is always 0.262      let purityStr = "\(purity.sfw ? "1" : "0")\(purity.sketchy ? "1" : "0")0"263264      let (newWallpapers, meta) = try await api.searchWallpapers(265        query: searchText,266        categories: catStr,267        purity: purityStr,268        sorting: feedMode.sorting,269        resolutions: resolutions,270        ratios: ratios,271        limit: 24,272        page: pageToRequest273      )274275      if requestGeneration != searchGeneration { return }276      if reset {277        self.wallpapers = newWallpapers278      } else {279        self.wallpapers.append(contentsOf: newWallpapers)280      }281282      if let meta = meta {283        let nextPage = meta.current_page + 1284        self.canLoadMore = meta.current_page < meta.last_page285        // A page that's been superseded by a newer reset would leave the next286        // page index pointing into the stale query; only advance when this287        // response is still the current generation.288        if requestGeneration == searchGeneration {289          self.currentPage = nextPage290        }291      } else if !newWallpapers.isEmpty {292        self.canLoadMore = true293        if requestGeneration == searchGeneration {294          self.currentPage += 1295        }296      } else {297        self.canLoadMore = false298      }299300    } catch {301      if reset && requestGeneration == searchGeneration {302        self.errorMessage = error.localizedDescription303      }304    }305306    if reset {307      if requestGeneration == searchGeneration {308        isLoading = false309      }310    } else if requestGeneration == searchGeneration {311      isFetchingMore = false312    }313  }314315  func loadMore() async {316    await fetchWallpapers(reset: false)317  }318319  func setWallpaper(_ wallpaper: Wallpaper, on screen: NSScreen? = nil) async {320    guard let remoteURL = URL(string: wallpaper.path) else {321      self.errorMessage = "Failed to set wallpaper: invalid image URL"322      return323    }324    do {325      // Cached rather than a throwaway temp download: NSWorkspace re-reads326      // this file from disk on Space switches/wake, and repeated clicks on327      // the same wallpaper should reuse it instead of re-downloading.328      let localURL = try await wallpaperManager.cachedLocalFile(for: remoteURL)329330      // AppState is @MainActor isolated; the prior MainActor.run hop was331      // redundant because the call site already runs on the main actor.332      try wallpaperManager.setDesktopImage(from: localURL, screen: screen)333334      // Add to history335      historyManager.addToHistory(wallpaper)336337      if saveToFolderEnabled {338        let destFolder = URL(fileURLWithPath: saveFolderPath)339        try wallpaperManager.saveToFolder(from: localURL, to: destFolder)340      }341342    } catch {343      self.errorMessage = "Failed to set wallpaper: \(error.localizedDescription)"344    }345  }346347  func setLocalWallpaper(_ wallpaper: LocalWallpaper, on screen: NSScreen? = nil) async {348    do {349      // AppState is @MainActor isolated; the prior MainActor.run hop was350      // redundant because the call site already runs on the main actor.351      try wallpaperManager.setDesktopImage(from: wallpaper.url, screen: screen)352353      let historyWallpaper = Wallpaper(354        id: wallpaper.id,355        url: wallpaper.url.path,356        path: wallpaper.url.path,357        resolution: wallpaper.resolution,358        purity: "local",359        file_size: Int(wallpaper.fileSize),360        thumbs: Wallpaper.Thumbs(361          large: wallpaper.url.path,362          original: wallpaper.url.path,363          small: wallpaper.url.path364        )365      )366      historyManager.addToHistory(historyWallpaper)367368    } catch {369      self.errorMessage = "Failed to set wallpaper: \(error.localizedDescription)"370    }371  }372373  func downloadWallpaper(_ wallpaper: Wallpaper) async {374    guard let remoteURL = URL(string: wallpaper.path) else {375      self.errorMessage = "Failed to download: invalid image URL"376      return377    }378    do {379      let localURL = try await wallpaperManager.download(from: remoteURL)380      defer { try? removeTempFile(localURL) }381382      // Always save to folder if download requested, or ensure save folder is used383      let destFolder = URL(fileURLWithPath: saveFolderPath)384      try wallpaperManager.saveToFolder(from: localURL, to: destFolder)385386    } catch {387      self.errorMessage = "Failed to download: \(error.localizedDescription)"388    }389  }390391  func selectSaveFolder() {392    // Hold the transient popover open; without this the picker steals focus393    // and the popover closes before a folder can be chosen.394    MenuController.shared?.beginModalPresentation()395    NSApp.activate(ignoringOtherApps: true)396397    chooseFolder(URL(fileURLWithPath: saveFolderPath)) { url in398      if let url { self.saveFolderPath = url.path }399      MenuController.shared?.endModalPresentation()400    }401  }402403  static func makeFolderPanel(at directory: URL) -> NSOpenPanel {404    let panel = NSOpenPanel()405    panel.canChooseFiles = false406    panel.canChooseDirectories = true407    panel.canCreateDirectories = true408    panel.allowsMultipleSelection = false409    panel.directoryURL = directory410    panel.prompt = "Choose"411    return panel412  }413414  static func presentFolderPicker(415    at directory: URL, completion: @escaping (URL?) -> Void416  ) {417    presentFolderPicker(panel: makeFolderPanel(at: directory), completion: completion)418  }419420  static func presentFolderPicker(421    panel: NSOpenPanel, completion: @escaping (URL?) -> Void422  ) {423    panel.begin { response in completion(response == .OK ? panel.url : nil) }424  }425426  /// Show the multi-select source folder picker and append the chosen427  /// directories to `sourceFolderPaths`. Cancelling the picker is a no-op.428  func addSourceFolders() {429    MenuController.shared?.beginModalPresentation()430    NSApp.activate(ignoringOtherApps: true)431432    chooseSourceFolders([]) { urls in433      let merged = (self.sourceFolderPaths + urls.map(\.path))434        .reduce(into: [String]()) { acc, path in435          if !acc.contains(path) { acc.append(path) }436        }437      self.sourceFolderPaths = merged438      MenuController.shared?.endModalPresentation()439    }440  }441442  /// Remove a previously added source folder. Idempotent: removing an443  /// unknown path is a no-op.444  func removeSourceFolder(_ path: String) {445    sourceFolderPaths.removeAll { $0 == path }446  }447448  static func makeSourceFoldersPanel() -> NSOpenPanel {449    let panel = NSOpenPanel()450    panel.canChooseFiles = false451    panel.canChooseDirectories = true452    panel.canCreateDirectories = true453    panel.allowsMultipleSelection = true454    panel.prompt = "Add"455    return panel456  }457458  static func presentSourceFoldersPicker(459    panel: NSOpenPanel, completion: @escaping ([URL]) -> Void460  ) {461    panel.begin { response in462      completion(response == .OK ? panel.urls : [])463    }464  }465466  static func presentSourceFoldersPicker(467    _ directory: URL, completion: @escaping ([URL]) -> Void468  ) {469    let panel = makeSourceFoldersPanel()470    panel.directoryURL = directory471    presentSourceFoldersPicker(panel: panel, completion: completion)472  }473474  static let chooseDefaultSourceFolders: @MainActor ([URL], @escaping ([URL]) -> Void) -> Void =475    { directories, completion in476      let start = directories.last ?? FileManager.default.homeDirectoryForCurrentUser477      presentSourceFoldersPicker(start, completion: completion)478    }479480  func quit() {481    terminateApplication()482  }483}