Add closable notifications with dismiss-aware callbacks

[corradedied]

Suggested by FlamesW and based on reply from mstudio45

---

Summary

Notifications currently have no way to be dismissed early or to run code when they close. This adds an optional "X" close button and a Callback that can tell you why a notification was dismissed, so notifications can be used for things like confirmations, undo prompts, or anything needing a response tied to how the user (or the clock) closed it.

New Notify options

Library:Notify({
    Title = "mspaint",
    Description = "Hello world!",
    Time = 4,
    Closable = true, -- shows the close ("X") button
    Callback = function(Notification, Reason)
        -- Reason: "time" | "manual" | "code"
    end,
})

• Closable — shows an "X" in the top-right corner using the existing lucide icon implementation (Library:GetIcon("x")), not a unicode glyph.
• Callback — runs every time the notification is dismissed, regardless of how it was dismissed. Receives (Notification, Reason).
• If a notification is Persist = true and has a Callback, Closable is force-enabled even if not set — otherwise there'd be no way to ever dismiss it and trigger that callback.

How it works internally

All dismissal paths (timeout, close-button click, or a script calling Notification:Destroy() directly) now route through the same Data:Destroy(Reason), tagged with why it happened:

• Timer/timeout completing → Destroy("time")
• Close button clicked → Destroy("manual")
• Called directly with no argument → Destroy("code")

Destroy always fires Callback (if set) and passes Reason along as the callback's second argument so calling code can branch on it if it cares. This keeps the firing logic and the actual cleanup (timer disposal, position updates, tween-out) in one place instead of duplicated across each dismissal path.

Visuals

Example (as in the GIFs above)

GroupBox1:AddButton("sendNotif", function()
	Library:Notify({
		Title = "notification",
		Description = "this is a notification",
		Time = 2,
        Closable = true, -- adds the close ("X") button
		Callback = function(notif, reason)
			warn("fired close callback. \nTitle: " .. notif.Title .. "\nDescription: " .. notif.Description .. "\nReason: " .. reason) -- i know i could just use string.format
		end
	})
end)

[corradedied]

resolved sync conflicts

[mstudio45]

• CallbackOnAutoDismiss should not even exist and Callback should fire no mather what on Destroy if it exists.
• The reasons should be "code" and "manual" or "time", "manual" and "code" but I am still not sure (I don't really like "programmatic" but I don't know what would be better).

[corradedied]

• CallbackOnAutoDismiss should not even exist and Callback should fire no mather what on Destroy if it exists.
• The reasons should be "code" and "manual" or "time", "manual" and "code" but I am still not sure (I don't really like "programmatic" but I don't know what would be better).

I've just pushed a fix regarding both.

• Removed CallbackOnAutoDismiss entirely. Callback now fires unconditionally on every Destroy(), no matter how it was triggered.
• Renamed the reasons to "time", "manual", "code" (removed "programmatic").

The PR message has been updated. Let me know if you'd rather want "code" dropped in favor of just two reasons ("code"/"manual") instead of three.

[corradedied]

Reason: "time" | "manual" | "code"

[corradedied]

resolved conflicts and synced changes