Files
Modus/utils/popup.py
T
2025-05-11 12:17:00 +05:45

279 lines
8.9 KiB
Python

from typing import ClassVar
import gi
from fabric.hyprland.service import HyprlandEvent
from fabric.hyprland.widgets import get_hyprland_connection
from fabric.widgets.box import Box
from fabric.widgets.wayland import WaylandWindow
from fabric.widgets.widget import Widget
from gi.repository import Gdk, GLib, GObject, GtkLayerShell
from loguru import logger
gi.require_versions(
{"Gtk": "3.0", "Gdk": "3.0", "GtkLayerShell": "0.1", "GObject": "2.0"}
)
class PopoverManager:
"""Singleton manager to handle shared resources for popovers."""
_instance = None
@classmethod
def get_instance(cls):
if cls._instance is None:
cls._instance = cls()
return cls._instance
def __init__(self):
# Shared overlay window for all popovers
self.overlay = WaylandWindow(
name="popover-overlay",
style_classes="popover-overlay",
title="fabric-shell-popover-overlay",
anchor="left top right bottom",
margin="-50px 0px 0px 0px",
exclusivity="auto",
layer="overlay",
type="top-level",
visible=False,
all_visible=False,
style="background-color: rgba(0,0,0,0.0);",
)
# Add empty box so GTK doesn't complain
self.overlay.add(Box())
# Keep track of active popovers
self.active_popover = None
self.available_windows = []
# Close popover when clicking overlay
self.overlay.connect("button-press-event", self._on_overlay_clicked)
self._hyprland_connection = get_hyprland_connection()
self._hyprland_connection.connect(
"event::focusedmonv2", self._on_monitor_change
)
def _on_monitor_change(self, _, event: HyprlandEvent):
if self.active_popover:
self.active_popover.hide_popover()
return True
def _on_overlay_clicked(self, widget, event):
if self.active_popover:
self.active_popover.hide_popover()
return True
def get_popover_window(self):
"""Get an available popover window or create a new one."""
if self.available_windows:
return self.available_windows.pop()
window = WaylandWindow(
type="popup",
layer="overlay",
name="popover-window",
anchor="left top",
visible=False,
all_visible=False,
)
GtkLayerShell.set_keyboard_interactivity(window, True)
window.set_keep_above(True)
return window
def return_popover_window(self, window):
"""Return a popover window to the pool."""
# Remove any children
for child in window.get_children():
window.remove(child)
window.hide()
# Only keep a reasonable number of windows in the pool
if len(self.available_windows) < 5:
self.available_windows.append(window)
else:
# Let the window be garbage collected
window.destroy()
def activate_popover(self, popover):
"""Set the active popover and show overlay."""
if self.active_popover and self.active_popover != popover:
self.active_popover.hide_popover()
self.active_popover = popover
self.overlay.show()
@GObject.Signal(
flags=GObject.SignalFlags.RUN_LAST, return_type=GObject.TYPE_NONE, arg_types=()
)
def popover_opened(widget: Widget): ...
@GObject.Signal(
flags=GObject.SignalFlags.RUN_LAST, return_type=GObject.TYPE_NONE, arg_types=()
)
def popover_closed(widget: Widget): ...
@GObject.type_register
class Popover(Widget):
"""Memory-efficient popover implementation."""
__gsignals__: ClassVar = {
"popover-opened": (GObject.SignalFlags.RUN_LAST, GObject.TYPE_NONE, ()),
"popover-closed": (GObject.SignalFlags.RUN_LAST, GObject.TYPE_NONE, ()),
}
def __init__(
self,
point_to,
content_factory=None,
content=None,
):
super().__init__()
"""
Initialize a popover.
Args:
content_factory: Function that returns content widget when called
point_to: Widget to position the popover next to
"""
self._content_factory = content_factory
self._point_to = point_to
self._content_window = None
self._content = content
self._visible = False
self._destroy_timeout = None
# Use weak reference to avoid circular reference issues
self._manager = PopoverManager.get_instance()
def set_content_factory(self, content_factory):
"""Set the content factory for the popover."""
self._content_factory = content_factory
def set_content(self, content):
"""Set the content for the popover."""
self._content = content
def _on_key_press(self, widget, event):
if event.keyval == Gdk.KEY_Escape and self._manager.active_popover:
self._manager.active_popover.hide_popover()
def open(self):
if self._destroy_timeout is not None:
GLib.source_remove(self._destroy_timeout)
self._destroy_timeout = None
if not self._content_window:
try:
self._create_popover()
except Exception as e:
logger.error(f"Could not create popover! Error: {e}")
else:
self._manager.activate_popover(self)
self._content_window.show()
self._content_window.steal_input()
self._visible = True
self.emit("popover-opened")
def _calculate_margins(self):
widget_allocation = self._point_to.get_allocation()
popover_size = self._content_window.get_size()
display = Gdk.Display.get_default()
screen = display.get_default()
monitor_at_window = screen.get_monitor_at_window(self._point_to.get_window())
monitor_geometry = monitor_at_window.get_geometry()
x = (
widget_allocation.x
+ (widget_allocation.width / 2)
- (popover_size.width / 2)
)
# Position below the button instead of above
y = widget_allocation.y + widget_allocation.height + 5 # 5px gap below button
# Ensure popover stays within monitor bounds
if x <= 0:
x = widget_allocation.x
elif x + popover_size.width >= monitor_geometry.width:
x = widget_allocation.x - popover_size.width + widget_allocation.width
# If popover would go below monitor, position it above the button
if y + popover_size.height > monitor_geometry.y + monitor_geometry.height:
y = widget_allocation.y - popover_size.height - 5 # 5px gap above button
return [y, 0, 0, x]
def set_position(self, position: tuple[int, int, int, int] | None = None):
if position is None:
self._content_window.set_margin(self._calculate_margins())
return False
self._content_window.set_margin(position)
return False
def _on_content_ready(self, widget, event):
self.set_position()
def _create_popover(self):
if self._content is None and self._content_factory is not None:
self._content = self._content_factory()
# Get a window from the pool
self._content_window = self._manager.get_popover_window()
# This is a hack to fix wrong positioning for widgets that are not rendered
# immediately (e.g., Gtk.Calendar())
self._content.connect("draw", self._on_content_ready)
# Add content to window
self._content_window.add(
Box(style_classes="popover-content", children=self._content)
)
self._content_window.connect("focus-out-event", self._on_popover_focus_out)
self._content_window.connect("key-press-event", self._on_key_press)
self._manager.activate_popover(self)
self._content_window.show()
self._content_window.steal_input()
self._visible = True
def _on_popover_focus_out(self, widget, event):
# This helps with keyboard focus issues
GLib.timeout_add(100, self.hide_popover)
return False
def hide_popover(self):
if not self._visible or not self._content_window:
return False
self._content_window.hide()
self._manager.overlay.hide()
self._visible = False
if not self._destroy_timeout:
self._destroy_timeout = GLib.timeout_add(1000 * 5, self._destroy_popover)
self.emit("popover-closed")
return False
def _destroy_popover(self):
"""Return resources to the pool and clear references."""
self._destroy_timeout = None
self._visible = False
if self._content_window:
# Return window to the pool
self._manager.return_popover_window(self._content_window)
self._content_window = None
# Allow content to be garbage collected if no longer needed
self._content = None
return False