Implemented Global Notification System

[austincondiff]

Description

This PR introduces a global notification system in CodeEdit that allows users to receive and manage notifications across all open workspaces. Notifications provide important alerts and updates while ensuring consistency across multiple instances of the application.

Key Features

• Temporary Notifications:

  • Displayed at the top-right corner of the active workspace.
  • Automatically hide after 5 seconds, unless hovered over.

• Sticky Notifications:

  • Persist in the UI until manually dismissed.
  • Useful for critical alerts or alerts where user action or attention is required.

• Notification Button & Popover:

  • Added to the toolbar in each workspace.
  • Displays a notification count for unread notifications.
  • Clicking the button opens a popove* containing all notifications.
  • When opening popover, all notifications are hidden. Sticky notifications that are not dismissed are restored over the UI after popover is closed.

Behavior:

• Notifications do not persist after the application is quit.
• All open workspaces stay in sync with the latest notifications.
• Interacting with a notification (e.g., dismissing it) updates all workspaces.
• Hovering over a temporary notification pauses and resets its hide timer.
• When CodeEdit is not in focus, notifications are redirected to the system Notification Center.

Screenshots

Screen.Recording.2025-02-14.at.4.09.29.PM.mp4

Screen.Recording.2025-02-14.at.5.36.32.PM.mov

The following screen recording showcases the first iteration. In the design channel on Discord, @thecoolwinter suggested moving in this direction. While it required a bit more effort, I agree that it ultimately results in a much cleaner and more polished look.

Screen.Recording.2025-02-12.at.12.42.55.PM.mov

Usage

With a symbol (works with both SF Symbols and CodeEditSymbols)

NotificationManager.shared.post(
    iconSymbol: "bell",
    title: "New Notification Created",
    description: "Successfully created new notification",
    actionButtonTitle: "Action",
    action: {
        print("Action taken")
    }
)

The icon defaults to the users accent color if one isn't specified however you can specify a color here...

NotificationManager.shared.post(
    iconSymbol: "bell",
    iconColor: .red,
    title: "New Notification Created",
    description: "Successfully created new notification",
    actionButtonTitle: "Action",
    action: {
        print("Action taken")
    }
)

With a custom image...

NotificationManager.shared.post(
    iconImage: Image("GitHubIcon"),
    title: "New Notification Created",
    description: "Successfully created new notification",
    actionButtonTitle: "Action",
    action: {
        print("Action taken")
    }
)

With an emoji...

NotificationManager.shared.post(
    iconText: "👋",
    title: "New Notification Created",
    description: "Successfully created new notification",
    actionButtonTitle: "Action",
    action: {
        print("Action taken")
    }
)

With text...

NotificationManager.shared.post(
    iconText: "A",
    iconTextColor: .white,
    iconColor: .red,
    title: "New Notification Created",
    description: "Successfully created new notification",
    actionButtonTitle: "Action",
    action: {
        print("Action taken")
    }
)

Future Considerations

Currently, NotificationManager is shared between workspaces. This is intentional because notifications should generally speaking be global and not workspace specific. We may at some point allow for workspace specific notifications in addition to global notifications.

Related Issues

• closes ✨ Global Notification System #1983

Checklist

• I read and understood the contributing guide as well as the code of conduct
• The issues this PR addresses are related to each other
• My changes generate no new warnings
• My code builds and runs on my machine
• My changes are all related to the related issue above
• I documented my code

Note

Add the following to FileInspectorView.swift to test

Section("Test Notifications") {
    Button("Add Test Notification") {
        NotificationManager.shared.post(
            iconSymbol: "bell.badge.fill",
            iconColor: .red,
            title: "Test Notification",
            description: "This is a test notification",
            actionButtonTitle: "Action",
            action: {
                print("Test notification action triggered")
            }
        )
    }
    Button("Add Sticky Notification") {
        NotificationManager.shared.post(
            iconSymbol: "pin.fill",
            iconColor: .orange,
            title: "Sticky Notification",
            description: "This notification will stay until dismissed",
            actionButtonTitle: "Acknowledge",
            action: {
                print("Sticky notification acknowledged")
            },
            isSticky: true
        )
    }
}