ADD: open handler callback for custom logic

Author: georgetchelidze

Sources/WelcomeWindow/Views/RecentsListView.swift

@@ -20,17 +20,20 @@ public struct RecentsListView: View {
 
     @FocusState.Binding private var focusedField: FocusTarget?
     private let dismissWindow: () -> Void
+    private let openHandler: WelcomeOpenHandler
 
     public init(
         recentProjects: Binding<[URL]>,
         selection: Binding<Set<URL>>,
         focusedField: FocusState<FocusTarget?>.Binding,
-        dismissWindow: @escaping () -> Void
+        dismissWindow: @escaping () -> Void,
+        openHandler: @escaping WelcomeOpenHandler
     ) {
         self._recentProjects = recentProjects
         self._selection = selection
         self._focusedField = focusedField
         self.dismissWindow = dismissWindow
+        self.openHandler = openHandler
     }
 
     private var isFocused: Bool {
@@ -70,11 +73,7 @@ public struct RecentsListView: View {
                 }
             }
         } primaryAction: { items in
-            for url in items {
-                NSDocumentController.shared.openDocument(at: url) {
-                    dismissWindow()
-                }
-            }
+            openHandler(Array(items), dismissWindow)
         }
         .onCopyCommand {
             selection.map { NSItemProvider(object: $0.path(percentEncoded: false) as NSString) }
@@ -84,11 +83,7 @@ public struct RecentsListView: View {
         }
         .background {
             Button("") {
-                selection.forEach { url in
-                    NSDocumentController.shared.openDocument(at: url) {
-                        dismissWindow()
-                    }
-                }
+                openHandler(Array(selection), dismissWindow)
             }
             .keyboardShortcut(.defaultAction)
             .hidden()

Sources/WelcomeWindow/Views/WelcomeWindow.swift

@@ -15,6 +15,7 @@ public struct WelcomeWindow<RecentsView: View, SubtitleView: View>: Scene {
     private let customRecentsList: ((_ dismissWindow: @escaping () -> Void) -> RecentsView)?
     private let onDrop: ((_ url: URL, _ dismiss: @escaping () -> Void) -> Void)?
     private let subtitleView: (() -> SubtitleView)?
+    private let openHandler: WelcomeOpenHandler?
 
     let iconImage: Image?
     let title: String?
@@ -33,14 +34,16 @@ public struct WelcomeWindow<RecentsView: View, SubtitleView: View>: Scene {
         @ActionsBuilder actions: @escaping (_ dismissWindow: @escaping () -> Void) -> WelcomeActions,
         customRecentsList: ((_ dismissWindow: @escaping () -> Void) -> RecentsView)? = nil,
         subtitleView: (() -> SubtitleView)? = nil,
-        onDrop: ((_ url: URL, _ dismiss: @escaping () -> Void) -> Void)? = nil
+        onDrop: ((_ url: URL, _ dismiss: @escaping () -> Void) -> Void)? = nil,
+        openHandler: WelcomeOpenHandler? = nil
     ) {
         self.iconImage = iconImage
         self.title = title
         self.buildActions = actions
         self.customRecentsList = customRecentsList
         self.subtitleView = subtitleView
         self.onDrop = onDrop
+        self.openHandler = openHandler
     }
 
     public var body: some Scene {
@@ -52,7 +55,8 @@ public struct WelcomeWindow<RecentsView: View, SubtitleView: View>: Scene {
                 subtitleView: subtitleView,
                 buildActions: buildActions,
                 onDrop: onDrop,
-                customRecentsList: customRecentsList
+                customRecentsList: customRecentsList,
+                openHandler: openHandler
             )
             .frame(width: 740, height: isMacOS26 ? 460 - 28 : 460)
             .task {
@@ -71,6 +75,8 @@ public struct WelcomeWindow<RecentsView: View, SubtitleView: View>: Scene {
     }
 }
 
+public typealias WelcomeOpenHandler = @MainActor (_ urls: [URL], _ dismiss: @escaping () -> Void) -> Void
+
 // ──────────────────────────────────────────────────────────────
 // 1)  NEITHER a custom recents list NOR a subtitle view
 // ──────────────────────────────────────────────────────────────
@@ -81,15 +87,17 @@ extension WelcomeWindow where RecentsView == EmptyView, SubtitleView == EmptyVie
         iconImage: Image? = nil,
         title: String?    = nil,
         @ActionsBuilder actions: @escaping (_ dismissWindow: @escaping () -> Void) -> WelcomeActions,
-        onDrop: ((_ url: URL, _ dismissWindow: @escaping () -> Void) -> Void)? = nil
+        onDrop: ((_ url: URL, _ dismissWindow: @escaping () -> Void) -> Void)? = nil,
+        openHandler: WelcomeOpenHandler? = nil
     ) {
         self.init(
             iconImage: iconImage,
             title: title,
             actions: actions,
             customRecentsList: nil,
             subtitleView: nil,
-            onDrop: onDrop
+            onDrop: onDrop,
+            openHandler: openHandler
         )
     }
 }
@@ -105,15 +113,17 @@ extension WelcomeWindow where RecentsView == EmptyView {
         title: String?    = nil,
         subtitleView: @escaping () -> SubtitleView,
         @ActionsBuilder actions: @escaping (_ dismissWindow: @escaping () -> Void) -> WelcomeActions,
-        onDrop: ((_ url: URL, _ dismissWindow: @escaping () -> Void) -> Void)? = nil
+        onDrop: ((_ url: URL, _ dismissWindow: @escaping () -> Void) -> Void)? = nil,
+        openHandler: WelcomeOpenHandler? = nil
     ) {
         self.init(
             iconImage: iconImage,
             title: title,
             actions: actions,
             customRecentsList: nil,
             subtitleView: subtitleView,
-            onDrop: onDrop
+            onDrop: onDrop,
+            openHandler: openHandler
         )
     }
 }
@@ -129,15 +139,17 @@ extension WelcomeWindow where SubtitleView == EmptyView {
         title: String?    = nil,
         @ActionsBuilder actions: @escaping (_ dismissWindow: @escaping () -> Void) -> WelcomeActions,
         customRecentsList: ((_ dismissWindow: @escaping () -> Void) -> RecentsView)? = nil,
-        onDrop: ((_ url: URL, _ dismissWindow: @escaping () -> Void) -> Void)? = nil
+        onDrop: ((_ url: URL, _ dismissWindow: @escaping () -> Void) -> Void)? = nil,
+        openHandler: WelcomeOpenHandler? = nil
     ) {
         self.init(
             iconImage: iconImage,
             title: title,
             actions: actions,
             customRecentsList: customRecentsList,
             subtitleView: nil,
-            onDrop: onDrop
+            onDrop: onDrop,
+            openHandler: openHandler
         )
     }
 }

Sources/WelcomeWindow/Views/WelcomeWindowView.swift

@@ -25,6 +25,7 @@ public struct WelcomeWindowView<RecentsView: View, SubtitleView: View>: View {
     private let onDrop: ((_ url: URL, _ dismiss: @escaping () -> Void) -> Void)?
     private let customRecentsList: ((_ dismissWindow: @escaping () -> Void) -> RecentsView)?
     private let subtitleView: (() -> SubtitleView)?
+    private let openHandler: WelcomeOpenHandler?
 
     let iconImage: Image?
     let title: String?
@@ -35,19 +36,34 @@ public struct WelcomeWindowView<RecentsView: View, SubtitleView: View>: View {
         subtitleView: (() -> SubtitleView)? = nil,
         buildActions: @escaping (_ dismissWindow: @escaping () -> Void) -> WelcomeActions,
         onDrop: ((_ url: URL, _ dismiss: @escaping () -> Void) -> Void)? = nil,
-        customRecentsList: ((_ dismissWindow: @escaping () -> Void) -> RecentsView)? = nil
+        customRecentsList: ((_ dismissWindow: @escaping () -> Void) -> RecentsView)? = nil,
+        openHandler: WelcomeOpenHandler? = nil
     ) {
         self.iconImage = iconImage
         self.title = title
         self.subtitleView = subtitleView
         self.buildActions = buildActions
         self.onDrop = onDrop
         self.customRecentsList = customRecentsList
+        self.openHandler = openHandler  
+    }
+    
+    private func defaultOpenHandler(urls: [URL], dismiss: @escaping () -> Void) {
+        var dismissed = false
+        for url in urls {
+            NSDocumentController.shared.openDocument(at: url) {
+                if !dismissed {
+                    dismissed = true
+                    dismiss()
+                }
+            }
+        }
     }
 
     public var body: some View {
         let dismiss = dismissWindow.callAsFunction
         let actions = buildActions(dismiss)
+        let effectiveOpen = openHandler ?? defaultOpenHandler
 
         return HStack(spacing: 0) {
             WelcomeView(
@@ -67,7 +83,8 @@ public struct WelcomeWindowView<RecentsView: View, SubtitleView: View>: View {
                         recentProjects: $recentProjects,
                         selection: $selection,
                         focusedField: $focusedField,
-                        dismissWindow: dismiss
+                        dismissWindow: dismiss,
+                        openHandler: effectiveOpen
                     )
                 }
             }