Implement Apple Music-style mini player (#246)

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Sertac Ozercan <sozercan@gmail.com>

Author: 3 people

Scripts/build-app.sh

@@ -359,6 +359,21 @@ find "$APP_BUNDLE" -name '._*' -delete 2>/dev/null || true
 
 # ── Code signing ──────────────────────────────────────────────────────────────
 
+if [[ "$SIGNING_MODE" == "unsigned" || "$SIGNING_MODE" == "none" ]]; then
+  echo "🔓 Skipping code signing."
+  echo ""
+  echo "✅ Build complete!"
+  echo "📍 App location: $APP_BUNDLE"
+  echo "   Version: ${MARKETING_VERSION} (${BUILD_NUMBER})"
+  echo "   Commit:  ${GIT_COMMIT}"
+  echo "   Arches:  ${ARCH_LIST[*]}"
+  echo "   Signing: unsigned"
+  echo ""
+  echo "To run: open $APP_BUNDLE"
+  echo "To install: cp -r $APP_BUNDLE /Applications/"
+  exit 0
+fi
+
 echo "🔏 Signing app..."
 if [[ "$SIGNING_MODE" == "adhoc" ]]; then
   CODESIGN_ARGS=(--force --sign -)

Sources/Kaset/AppDelegate.swift

@@ -87,14 +87,20 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
     func applicationDidBecomeActive(_: Notification) {
         // When app becomes active (e.g., dock icon clicked), ensure main window is visible.
         // This handles the case where video window is visible but main window is hidden.
+        if self.isSwitchedToMiniPlayer {
+            if #available(macOS 26.0, *) {
+                MiniPlayerWindowController.shared.orderFrontIfVisible()
+            }
+            return
+        }
         self.showMainWindowIfNeeded()
     }
 
     private func setupWindowDelegate() {
         DiagnosticsLogger.app.info("AppDelegate: setupWindowDelegate starting")
         for window in NSApplication.shared.windows where window.canBecomeMain {
-            // Skip if this is the video window (has specific identifier)
-            if window.identifier?.rawValue == AccessibilityID.VideoWindow.container {
+            // Skip auxiliary player windows; only the regular app window should be hidden-on-close.
+            if self.isAuxiliaryPlayerWindow(window) {
                 continue
             }
             window.delegate = self
@@ -182,11 +188,23 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
 
     /// Handle reopen (clicking dock icon) when all windows are closed.
     func applicationShouldHandleReopen(_: NSApplication, hasVisibleWindows _: Bool) -> Bool {
+        if self.isSwitchedToMiniPlayer {
+            if #available(macOS 26.0, *) {
+                MiniPlayerWindowController.shared.orderFrontIfVisible()
+            }
+            return false
+        }
+
         // Show main window when dock icon is clicked
         self.showMainWindowIfNeeded()
         return true
     }
 
+    private var isSwitchedToMiniPlayer: Bool {
+        guard let playerService else { return false }
+        return playerService.isMiniPlayerVisible && playerService.miniPlayerMode == .switchFromMainWindow
+    }
+
     /// Shows the main window if it's not visible.
     private func showMainWindowIfNeeded() {
         DiagnosticsLogger.app.info("AppDelegate: showMainWindowIfNeeded")
@@ -207,9 +225,9 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
             return
         }
 
-        // Last resort: find any main-capable window that's not the video window
+        // Last resort: find any main-capable window that's not an auxiliary player window.
         for window in NSApplication.shared.windows where window.canBecomeMain {
-            if window.identifier?.rawValue == AccessibilityID.VideoWindow.container {
+            if self.isAuxiliaryPlayerWindow(window) {
                 continue
             }
             self.mainWindow = window
@@ -219,6 +237,10 @@ final class AppDelegate: NSObject, NSApplicationDelegate {
             return
         }
     }
+
+    private func isAuxiliaryPlayerWindow(_ window: NSWindow) -> Bool {
+        AccessibilityID.isAuxiliaryPlayerWindowIdentifier(window.identifier?.rawValue)
+    }
 }
 
 // MARK: NSWindowDelegate

Sources/Kaset/KasetApp.swift

@@ -25,6 +25,7 @@ extension EnvironmentValues {
 struct KasetApp: App {
     /// App delegate for lifecycle management (background playback).
     @NSApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
+    @Environment(\.openWindow) private var openWindow
 
     @State private var authService = AuthService()
     @State private var webKitManager = WebKitManager.shared
@@ -171,6 +172,29 @@ struct KasetApp: App {
                             self.equalizerService.retryStartIfEnabled()
                         }
                     }
+                    .onChange(of: self.playerService.isMiniPlayerVisible) { _, isVisible in
+                        if isVisible {
+                            MiniPlayerWindowController.shared.show(
+                                playerService: self.playerService,
+                                client: self.sharedClient,
+                                syncedLyricsService: self.syncedLyricsService
+                            )
+                            if self.playerService.miniPlayerMode == .switchFromMainWindow {
+                                self.hideMainWindow()
+                            }
+                        } else {
+                            MiniPlayerWindowController.shared.close()
+                            if self.playerService.consumeMiniPlayerMainWindowRestoreRequest() {
+                                self.showMainWindow()
+                            }
+                        }
+                    }
+                    .onChange(of: self.playerService.miniPlayerPanel) { _, _ in
+                        MiniPlayerWindowController.shared.syncWindowState()
+                    }
+                    .onChange(of: self.settings.keepMiniPlayerOnTop) { _, _ in
+                        MiniPlayerWindowController.shared.syncWindowState()
+                    }
             }
         }
 
@@ -314,6 +338,19 @@ struct KasetApp: App {
 
             // Window menu - show main window
             CommandGroup(after: .windowArrangement) {
+                Button("Switch to Mini Player") {
+                    if self.playerService.isMiniPlayerVisible,
+                       self.playerService.miniPlayerMode == .switchFromMainWindow
+                    {
+                        _ = self.playerService.closeMiniPlayer()
+                    } else {
+                        self.playerService.openMiniPlayer(mode: .switchFromMainWindow)
+                    }
+                }
+                .keyboardShortcut("m", modifiers: [.command, .shift])
+
+                Divider()
+
                 Button("Kaset") {
                     self.showMainWindow()
                 }
@@ -332,20 +369,61 @@ struct KasetApp: App {
 
     /// Shows the main window.
     private func showMainWindow() {
+        guard !self.focusExistingMainWindow() else { return }
+
+        self.openWindow(id: "main")
+        NSApplication.shared.activate(ignoringOtherApps: true)
+
+        Task { @MainActor in
+            try? await Task.sleep(for: .milliseconds(100))
+            _ = self.focusExistingMainWindow()
+        }
+    }
+
+    @discardableResult
+    private func focusExistingMainWindow() -> Bool {
         // Find and show the main window
         for window in NSApplication.shared.windows where window.frameAutosaveName == "KasetMainWindow" {
             window.makeKeyAndOrderFront(nil)
             NSApplication.shared.activate(ignoringOtherApps: true)
-            return
+            return true
+        }
+
+        for window in NSApplication.shared.windows where window.title == "Kaset" && !Self.isAuxiliaryPlayerWindow(window) {
+            window.makeKeyAndOrderFront(nil)
+            NSApplication.shared.activate(ignoringOtherApps: true)
+            return true
         }
 
-        // Fallback: find any main-capable window that's not the video window
+        // Fallback: find any main-capable window that's not an auxiliary player window.
         for window in NSApplication.shared.windows where window.canBecomeMain {
-            if window.identifier?.rawValue == AccessibilityID.VideoWindow.container {
+            if Self.isAuxiliaryPlayerWindow(window) {
                 continue
             }
             window.makeKeyAndOrderFront(nil)
             NSApplication.shared.activate(ignoringOtherApps: true)
+            return true
+        }
+
+        return false
+    }
+
+    private static func isAuxiliaryPlayerWindow(_ window: NSWindow) -> Bool {
+        AccessibilityID.isAuxiliaryPlayerWindowIdentifier(window.identifier?.rawValue)
+    }
+
+    /// Hides the main window while keeping playback and auxiliary windows alive.
+    private func hideMainWindow() {
+        for window in NSApplication.shared.windows where window.frameAutosaveName == "KasetMainWindow" {
+            window.orderOut(nil)
+            return
+        }
+
+        for window in NSApplication.shared.windows where window.canBecomeMain {
+            if Self.isAuxiliaryPlayerWindow(window) {
+                continue
+            }
+            window.orderOut(nil)
             return
         }
     }