Struct NotificationQueue 

pub struct NotificationQueue { /* private fields */ }

Notification queue manager.

Manages multiple toast notifications with priority ordering, deduplication, and automatic expiry. Use push to add notifications and tick to process expiry in your event loop.

Implementations

impl NotificationQueue

pub fn new(config: QueueConfig) -> Self

Create a new notification queue with the given configuration.

pub fn with_defaults() -> Self

Create a new queue with default configuration.

pub fn push(&mut self, toast: Toast, priority: NotificationPriority) -> bool

Push a notification to the queue.

Returns true if the notification was accepted, false if it was rejected due to deduplication or queue overflow.

pub fn notify(&mut self, toast: Toast) -> bool

Push a notification with normal priority.

pub fn urgent(&mut self, toast: Toast) -> bool

Push an urgent notification.

pub fn dismiss(&mut self, id: ToastId)

Dismiss a specific notification by ID.

pub fn dismiss_all(&mut self)

Dismiss all notifications.

pub fn tick(&mut self, _delta: Duration) -> Vec<QueueAction>

Process a time tick, handling expiry and promotion.

Call this regularly in your event loop (e.g., every frame or every 16ms). Returns a list of actions to perform.

pub fn visible(&self) -> &[Toast]

Get currently visible toasts.

pub fn visible_mut(&mut self) -> &mut [Toast]

Get mutable access to visible toasts.

pub fn pending_count(&self) -> usize

Get the number of notifications waiting in the queue.

pub fn visible_count(&self) -> usize

Get the number of visible toasts.

pub fn total_count(&self) -> usize

Get the total count (visible + pending).

pub fn is_empty(&self) -> bool

Check if the queue is empty (no visible or pending notifications).

pub fn stats(&self) -> &QueueStats

Get queue statistics.

pub fn config(&self) -> &QueueConfig

Get the configuration.

pub fn calculate_positions( &self, terminal_width: u16, terminal_height: u16, margin: u16, ) -> Vec<(ToastId, u16, u16)>

Calculate stacking positions for all visible toasts.

Returns a list of (ToastId, x, y) positions.

Trait Implementations

impl Debug for NotificationQueue

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for NotificationQueue

fn default() -> Self

Returns the “default value” for a type.