From 6d1513601dee27efc79e592a21a230851df8b270 Mon Sep 17 00:00:00 2001
From: Ariver <shanghai3168@gmail.com>
Date: Sat, 23 May 2026 21:54:18 +0800
Subject: [PATCH] Prepare TagLauncher 7.6.0 release

---
 Apptag/PreferencesView.swift |  154 +++++++++++++++++++++++++++++++++++++++++----------
 1 files changed, 123 insertions(+), 31 deletions(-)

diff --git a/Apptag/PreferencesView.swift b/Apptag/PreferencesView.swift
index d01e500..54ce54a 100644
--- a/Apptag/PreferencesView.swift
+++ b/Apptag/PreferencesView.swift
@@ -32,6 +32,7 @@
     @State private var categoryScheme = TagDatabase.CategorySchemeState()
     @State private var isApplyingSystemScheme = false
     @State private var showApplySystemSchemeConfirmation = false
+    @State private var isDataFilePanelPresented = false
     @State private var hotkeyStatusToast: String? = nil
     @State private var hotkeyStatusToastToken: UUID? = nil
 
@@ -54,48 +55,81 @@
     }
 
     private func exportTags() {
-        let panel = NSSavePanel()
-        panel.title = tr("settings.export")
-        TagDatabase.flushPendingCategorySchemeBackupBatch()
-        refreshDataState()
-        panel.nameFieldStringValue = TagDatabase.exportFileName(for: categoryScheme)
-        panel.allowedContentTypes = [.json]
-        beginFilePanel(panel) { response in
-            guard response == .OK, let url = panel.url else { return }
-            do {
-                try TagDatabase.exportTo(url)
-            } catch {
-                fputs("[TagLauncher] Export failed: \(error)\n", stderr)
-                showDataAlert(title: tr("settings.exportFailed"), message: error.localizedDescription)
+        guard prepareDataFilePanelPresentation() else { return }
+        DispatchQueue.main.async {
+            TagDatabase.flushPendingCategorySchemeBackupBatch()
+            let currentScheme = TagDatabase.loadWithEnsuredCategoryScheme().categoryScheme
+            categoryScheme = currentScheme
+
+            let panel = NSSavePanel()
+            panel.title = tr("settings.export")
+            panel.nameFieldStringValue = TagDatabase.exportFileName(for: currentScheme)
+            panel.allowedContentTypes = [.json]
+
+            beginFilePanel(panel) { response in
+                finishDataFilePanelPresentation()
+                guard response == .OK, let url = panel.url else { return }
+                do {
+                    try TagDatabase.exportTo(url)
+                } catch {
+                    fputs("[TagLauncher] Export failed: \(error)\n", stderr)
+                    showDataAlert(title: tr("settings.exportFailed"), message: error.localizedDescription)
+                }
             }
         }
     }
 
     private func importTags() {
-        let panel = NSOpenPanel()
-        panel.title = tr("settings.import")
-        panel.allowedContentTypes = [.json]
-        panel.allowsMultipleSelection = false
-        beginFilePanel(panel) { response in
-            guard response == .OK, let url = panel.url else { return }
-            do {
-                TagDatabase.flushPendingCategorySchemeBackupBatch()
-                _ = try TagDatabase.importFrom(url)
-                scanApps()
-                refreshDataState()
-                notifyDataChanged()
-            } catch {
-                fputs("[TagLauncher] Import failed: \(error)\n", stderr)
-                showDataAlert(title: tr("settings.importFailed"), message: error.localizedDescription)
+        guard prepareDataFilePanelPresentation() else { return }
+        DispatchQueue.main.async {
+            let panel = NSOpenPanel()
+            panel.title = tr("settings.import")
+            panel.allowedContentTypes = [.json]
+            panel.allowsMultipleSelection = false
+
+            beginFilePanel(panel) { response in
+                finishDataFilePanelPresentation()
+                guard response == .OK, let url = panel.url else { return }
+                do {
+                    TagDatabase.flushPendingCategorySchemeBackupBatch()
+                    _ = try TagDatabase.importFrom(url)
+                    scanApps()
+                    refreshDataState()
+                    notifyDataChanged()
+                } catch {
+                    fputs("[TagLauncher] Import failed: \(error)\n", stderr)
+                    showDataAlert(title: tr("settings.importFailed"), message: error.localizedDescription)
+                }
             }
         }
+    }
+
+    private func prepareDataFilePanelPresentation() -> Bool {
+        guard !isDataFilePanelPresented else { return false }
+        isDataFilePanelPresented = true
+        NotificationCenter.default.post(
+            name: .tagLauncherModalInteractionChanged,
+            object: nil,
+            userInfo: ["active": true]
+        )
+        NSApp.activate(ignoringOtherApps: true)
+        preferencesWindow?.makeKeyAndOrderFront(nil)
+        return true
+    }
+
+    private func finishDataFilePanelPresentation() {
+        isDataFilePanelPresented = false
+        NotificationCenter.default.post(
+            name: .tagLauncherModalInteractionChanged,
+            object: nil,
+            userInfo: ["active": false]
+        )
     }
 
     private func beginFilePanel(
         _ panel: NSSavePanel,
         completion: @escaping (NSApplication.ModalResponse) -> Void
     ) {
-        NSApp.activate(ignoringOtherApps: true)
         if let window = preferencesWindow {
             panel.beginSheetModal(for: window, completionHandler: completion)
         } else {
@@ -106,9 +140,25 @@
     }
 
     private var preferencesWindow: NSWindow? {
-        NSApp.windows.first {
+        if let taggedWindow = NSApp.windows.first(where: {
             $0.identifier?.rawValue == "TagLauncherPreferencesWindow" && $0.isVisible
-        } ?? NSApp.keyWindow ?? NSApp.mainWindow
+        }) {
+            return taggedWindow
+        }
+
+        return [NSApp.keyWindow, NSApp.mainWindow]
+            .compactMap { $0 }
+            .first(where: isPreferencesWindowFallback(_:))
+    }
+
+    private func isPreferencesWindowFallback(_ window: NSWindow) -> Bool {
+        guard window.isVisible,
+              !(window is NSPanel),
+              !(window is OverlayPanel)
+        else { return false }
+
+        let preferencesTitle = tr("menu.preferences").replacingOccurrences(of: "…", with: "")
+        return window.title == preferencesTitle
     }
 
     private func showDataAlert(title: String, message: String) {
@@ -320,6 +370,21 @@
     }
     private var buildVersion: String {
         Bundle.main.infoDictionary?["CFBundleVersion"] as? String ?? "?"
+    }
+    private var helpPDFLanguageCode: String {
+        switch L10n.currentCode {
+        case "zh-Hans": return "zh"
+        case "zh-Hant": return "zh-Hant"
+        case "en", "ar", "ar-Najdi", "cs", "da", "de", "es", "fr", "id",
+             "it", "ja", "ko", "ms", "nb", "nl", "nn", "no", "pl", "pt-BR",
+             "ro", "ru", "sr-Cyrl", "sv", "th", "tr", "uk", "vi":
+            return L10n.currentCode
+        default:
+            return "en"
+        }
+    }
+    private var helpPDFURL: URL {
+        URL(string: "https://github.com/shanghai3168/taglauncher/releases/download/v7.6.0/Taglauncher-help-\(helpPDFLanguageCode).pdf")!
     }
     private var languageColumns: [GridItem] {
         [
@@ -683,8 +748,10 @@
                             HStack(spacing: 12) {
                                 Button(tr("settings.export")) { exportTags() }
                                     .buttonStyle(.bordered)
+                                    .disabled(isDataFilePanelPresented)
                                 Button(tr("settings.import")) { importTags() }
                                     .buttonStyle(.bordered)
+                                    .disabled(isDataFilePanelPresented)
                             }
                             Text(tr("settings.backupDesc"))
                                 .font(.caption)
@@ -764,6 +831,31 @@
                         Divider()
                             .padding(.vertical, 4)
 
+                        HStack(spacing: 8) {
+                            Button {
+                                NSWorkspace.shared.open(helpPDFURL)
+                            } label: {
+                                Label(tr("help.openPDF"), systemImage: "questionmark.circle")
+                            }
+                            .buttonStyle(.borderedProminent)
+                            .controlSize(.regular)
+
+                            Button {
+                                NSPasteboard.general.clearContents()
+                                NSPasteboard.general.setString(helpPDFURL.absoluteString, forType: .string)
+                            } label: {
+                                Image(systemName: "link")
+                            }
+                            .buttonStyle(.bordered)
+                            .controlSize(.regular)
+                            .help(tr("help.copyLink"))
+                        }
+
+                        Text(tr("help.currentLanguage"))
+                            .font(.caption)
+                            .foregroundStyle(.secondary)
+                            .padding(.bottom, 2)
+
                         Text("万物之中,希望最美")
                             .font(.caption)
                             .foregroundStyle(.secondary)

--
Gitblit v1.9.3