setiastrosuitepro 1.6.12__py3-none-any.whl → 1.7.3__py3-none-any.whl

setiastro/saspro/__main__.py

@@ -12,6 +12,27 @@ called via the `main()` function when invoked as an entry point.
 import sys
 import os
 
+_STARTUP_PROFILE = os.environ.get("SASPRO_STARTUP_PROFILE", "").strip().lower() in ("1","true","yes","on")
+
+
+def _is_wayland_session() -> bool:
+    # Best-effort detection that does NOT require a QApplication instance
+    xdg = (os.environ.get("XDG_SESSION_TYPE") or "").lower()
+    if xdg == "wayland":
+        return True
+    # QT can still run wayland even if XDG_SESSION_TYPE isn't set
+    if os.environ.get("WAYLAND_DISPLAY"):
+        return True
+    return False
+
+def _allow_window_opacity_effects() -> bool:
+    # User override: allow opacity effects even on Wayland if they want
+    if os.environ.get("SASPRO_ALLOW_OPACITY", "").strip().lower() in ("1","true","yes","on"):
+        return True
+    # Default: disable opacity effects on Wayland
+    return not _is_wayland_session()
+
+
 from pathlib import Path
 
 if sys.platform.startswith("win"):
@@ -24,7 +45,7 @@ if sys.platform.startswith("win"):
             pass
         os.environ["PATH"] = str(internal) + os.pathsep + os.environ.get("PATH", "")
         
-from PyQt6.QtCore import QCoreApplication
+
 
 # ---- Linux Qt stability guard (must run BEFORE any PyQt6 import) ----
 # Default behavior: DO NOT override Wayland.
@@ -41,6 +62,8 @@ if sys.platform.startswith("linux"):
         os.environ.setdefault("QT_OPENGL", "software")
         os.environ.setdefault("LIBGL_ALWAYS_SOFTWARE", "1")
 
+from PyQt6.QtCore import QCoreApplication
+
 # Global variables for splash screen and app
 _splash = None
 _app = None
@@ -48,6 +71,10 @@ _app = None
 # Flag to track if splash was initialized
 _splash_initialized = False
 
+# Flag to ensure heavy imports/bootstrap happens only once
+_imports_bootstrapped = False
+
+
 from setiastro.saspro.versioning import get_app_version
 _EARLY_VERSION = get_app_version("setiastrosuitepro")
 
@@ -414,6 +441,9 @@ def _init_splash():
             self.deleteLater()
 
         def start_fade_out(self):
+            if not _allow_window_opacity_effects():
+                self.finish()
+                return
             """Smoothly fade out the splash screen."""
             self._anim = QPropertyAnimation(self, b"windowOpacity")
             self._anim.setDuration(1000)
@@ -424,7 +454,9 @@ def _init_splash():
             self._anim.start()
     
         def start_fade_in(self):
-            """Smoothly fade in the splash screen."""
+            if not _allow_window_opacity_effects():
+                self.setWindowOpacity(1.0)
+                return
             self.setWindowOpacity(0.0)
             self._anim = QPropertyAnimation(self, b"windowOpacity")
             self._anim.setDuration(800)
@@ -462,11 +494,6 @@ def _init_splash():
     _splash_initialized = True
 
 
-# Initialize splash immediately before any heavy imports
-# This ensures the splash is visible while PyTorch, NumPy, etc. are loading
-_init_splash()
-
-
 # =============================================================================
 # Now proceed with all the heavy imports (splash is visible)
 # =============================================================================
@@ -478,271 +505,279 @@ def _update_splash(msg: str, progress: int):
         _splash.setMessage(msg)
         _splash.setProgress(progress)
 
-_update_splash(QCoreApplication.translate("Splash", "Loading PyTorch runtime..."), 5)
+def _bootstrap_imports():
+    """
+    Heavy imports + runtime bootstrap.
+    This must NOT run at module import time, only when main() is called.
+    """
+    global _imports_bootstrapped
+    if _imports_bootstrapped:
+        return
+    _imports_bootstrapped = True
+
+    # Make sure splash exists before we start doing heavy work
+    if not _splash_initialized:
+        _init_splash()
+
+    _update_splash(QCoreApplication.translate("Splash", "Loading PyTorch runtime..."), 5)
+
+    from setiastro.saspro.runtime_torch import (
+        add_runtime_to_sys_path,
+        _ban_shadow_torch_paths,
+        _purge_bad_torch_from_sysmodules,
+    )
+
+    add_runtime_to_sys_path(status_cb=lambda *_: None)
+    _ban_shadow_torch_paths(status_cb=lambda *_: None)
+    _purge_bad_torch_from_sysmodules(status_cb=lambda *_: None)
+
+    _update_splash(QCoreApplication.translate("Splash", "Loading standard libraries..."), 10)
+
+    # ----------------------------------------
+    # Standard library imports (consolidated)
+    # ----------------------------------------
+    import importlib
+    import json
+    import logging
+    import math
+    import multiprocessing
+    import os
+    import re
+    import sys
+    import threading
+    import time
+    import traceback
+    import warnings
+    import webbrowser
+
+    from collections import defaultdict
+    from datetime import datetime
+    from decimal import getcontext
+    from io import BytesIO
+    from itertools import combinations
+    from math import isnan
+    from pathlib import Path
+    from typing import Dict, List, Optional, Set, Tuple
+    from urllib.parse import quote, quote_plus
 
-from setiastro.saspro.runtime_torch import (
-    add_runtime_to_sys_path,
-    _ban_shadow_torch_paths,
-    _purge_bad_torch_from_sysmodules,
-)
+    _update_splash(QCoreApplication.translate("Splash", "Loading NumPy..."), 15)
 
-add_runtime_to_sys_path(status_cb=lambda *_: None)
-_ban_shadow_torch_paths(status_cb=lambda *_: None)
-_purge_bad_torch_from_sysmodules(status_cb=lambda *_: None)
+    # ----------------------------------------
+    # Third-party imports
+    # ----------------------------------------
+    import numpy as np
 
-_update_splash(QCoreApplication.translate("Splash", "Loading standard libraries..."), 10)
+    _update_splash(QCoreApplication.translate("Splash", "Loading image libraries..."), 20)
+    from tifffile import imwrite
+    from setiastro.saspro.xisf import XISF
 
-# ----------------------------------------
-# Standard library imports (consolidated)
-# ----------------------------------------
-import importlib
-import json
-import logging
-import math
-import multiprocessing
-import os
-import re
-import sys
-import threading
-import time
-import traceback
-import warnings
-import webbrowser
-
-from collections import defaultdict
-from datetime import datetime
-from decimal import getcontext
-from io import BytesIO
-from itertools import combinations
-from math import isnan
-from pathlib import Path
-from typing import Dict, List, Optional, Set, Tuple
-from urllib.parse import quote, quote_plus
-
-_update_splash(QCoreApplication.translate("Splash", "Loading NumPy..."), 15)
-
-# ----------------------------------------
-# Third-party imports
-# ----------------------------------------
-import numpy as np
-
-_update_splash(QCoreApplication.translate("Splash", "Loading image libraries..."), 20)
-from tifffile import imwrite
-from setiastro.saspro.xisf import XISF
-
-_update_splash(QCoreApplication.translate("Splash", "Configuring matplotlib..."), 25)
-from setiastro.saspro.config_bootstrap import ensure_mpl_config_dir
-_MPL_CFG_DIR = ensure_mpl_config_dir()
-
-# Apply metadata patches for frozen builds
-from setiastro.saspro.metadata_patcher import apply_metadata_patches
-apply_metadata_patches()
-# ----------------------------------------
-
-warnings.filterwarnings(
-    "ignore",
-    message=r"Call to deprecated function \(or staticmethod\) _destroy\.",
-    category=DeprecationWarning,
-)
-
-os.environ['LIGHTKURVE_STYLE'] = 'default'
-
-# ----------------------------------------
-# Matplotlib configuration
-# ----------------------------------------
-import matplotlib
-matplotlib.use("QtAgg") 
-
-# Configure stdout encoding
-if (sys.stdout is not None) and (hasattr(sys.stdout, "reconfigure")):
-    sys.stdout.reconfigure(encoding='utf-8')
-
-# --- Lazy imports for heavy dependencies (performance optimization) ---
-# photutils: loaded on first use
-_photutils_isophote = None
-def _get_photutils_isophote():
-    """Lazy loader for photutils.isophote module."""
+    _update_splash(QCoreApplication.translate("Splash", "Configuring matplotlib..."), 25)
+    from setiastro.saspro.config_bootstrap import ensure_mpl_config_dir
+    _MPL_CFG_DIR = ensure_mpl_config_dir()
+
+    # Apply metadata patches for frozen builds
+    from setiastro.saspro.metadata_patcher import apply_metadata_patches
+    apply_metadata_patches()
+
+    warnings.filterwarnings(
+        "ignore",
+        message=r"Call to deprecated function \(or staticmethod\) _destroy\.",
+        category=DeprecationWarning,
+    )
+
+    os.environ['LIGHTKURVE_STYLE'] = 'default'
+
+    # ----------------------------------------
+    # Matplotlib configuration
+    # ----------------------------------------
+    import matplotlib
+    matplotlib.use("QtAgg")
+
+    # Configure stdout encoding
+    if (sys.stdout is not None) and (hasattr(sys.stdout, "reconfigure")):
+        sys.stdout.reconfigure(encoding='utf-8')
+
+    # --- Lazy imports for heavy dependencies (performance optimization) ---
+    # photutils: loaded on first use
     global _photutils_isophote
-    if _photutils_isophote is None:
-        try:
-            from photutils import isophote as _isophote_module
-            _photutils_isophote = _isophote_module
-        except Exception:
-            _photutils_isophote = False  # Mark as failed
-    return _photutils_isophote if _photutils_isophote else None
-
-def get_Ellipse():
-    """Get photutils.isophote.Ellipse, loading lazily."""
-    mod = _get_photutils_isophote()
-    return mod.Ellipse if mod else None
-
-def get_EllipseGeometry():
-    """Get photutils.isophote.EllipseGeometry, loading lazily."""
-    mod = _get_photutils_isophote()
-    return mod.EllipseGeometry if mod else None
-
-def get_build_ellipse_model():
-    """Get photutils.isophote.build_ellipse_model, loading lazily."""
-    mod = _get_photutils_isophote()
-    return mod.build_ellipse_model if mod else None
-
-# lightkurve: loaded on first use
-_lightkurve_module = None
-def get_lightkurve():
-    """Lazy loader for lightkurve module."""
+    _photutils_isophote = None
+
+    def _get_photutils_isophote():
+        global _photutils_isophote
+        if _photutils_isophote is None:
+            try:
+                from photutils import isophote as _isophote_module
+                _photutils_isophote = _isophote_module
+            except Exception:
+                _photutils_isophote = False
+        return _photutils_isophote if _photutils_isophote else None
+
+    def get_Ellipse():
+        mod = _get_photutils_isophote()
+        return mod.Ellipse if mod else None
+
+    def get_EllipseGeometry():
+        mod = _get_photutils_isophote()
+        return mod.EllipseGeometry if mod else None
+
+    def get_build_ellipse_model():
+        mod = _get_photutils_isophote()
+        return mod.build_ellipse_model if mod else None
+
     global _lightkurve_module
-    if _lightkurve_module is None:
-        try:
-            import lightkurve as _lk
-            _lk.MPLSTYLE = None
-            _lightkurve_module = _lk
-        except Exception:
-            _lightkurve_module = False  # Mark as failed
-    return _lightkurve_module if _lightkurve_module else None
-# --- End lazy imports ---
-
-_update_splash(QCoreApplication.translate("Splash", "Loading UI utilities..."), 30)
-
-# Shared UI utilities (avoiding code duplication)
-from setiastro.saspro.widgets.common_utilities import (
-    AboutDialog,
-    ProjectSaveWorker as _ProjectSaveWorker,
-    DECOR_GLYPHS,
-    _strip_ui_decorations,
-    install_crash_handlers,
-)
-
-_update_splash(QCoreApplication.translate("Splash", "Loading reproject library..."), 35)
-
-# Reproject for WCS-based alignment
-try:
-    from reproject import reproject_interp
-except ImportError:
-    reproject_interp = None  # fallback if not installed
-
-_update_splash(QCoreApplication.translate("Splash", "Loading OpenCV..."), 40)
-
-# OpenCV for transform estimation & warping
-try:
-    import cv2
-    OPENCV_AVAILABLE = True
-except ImportError:
-    OPENCV_AVAILABLE = False
-
-
-_update_splash(QCoreApplication.translate("Splash", "Loading PyQt6 components..."), 45)
-
-#################################
-# PyQt6 Imports
-#################################
-from PyQt6 import sip
-
-# ----- QtWidgets -----
-from PyQt6.QtWidgets import (QDialog, QApplication, QMainWindow, QWidget, QHBoxLayout, QFileDialog, QMessageBox, QSizePolicy, QToolBar, QPushButton, QAbstractItemDelegate,
-    QLineEdit, QMenu, QListWidget, QListWidgetItem, QSplashScreen, QDockWidget, QListView, QCompleter, QMdiArea, QMdiSubWindow, QWidgetAction, QAbstractItemView,
-    QInputDialog, QVBoxLayout, QLabel, QCheckBox, QProgressBar, QProgressDialog, QGraphicsItem, QTabWidget, QTableWidget, QHeaderView, QTableWidgetItem, QToolButton, QPlainTextEdit
-)
-
-# ----- QtGui -----
-from PyQt6.QtGui import (QPixmap, QColor, QIcon, QKeySequence, QShortcut, QGuiApplication, QStandardItemModel, QStandardItem, QAction, QPalette, QBrush, QActionGroup, QDesktopServices, QFont, QTextCursor
-)
-
-# ----- QtCore -----
-from PyQt6.QtCore import (Qt, pyqtSignal, QCoreApplication, QTimer, QSize, QSignalBlocker, QModelIndex, QThread, QUrl, QSettings, QEvent, QByteArray, QObject,
-    QPropertyAnimation, QEasingCurve
-)
-
-from PyQt6.QtNetwork import QNetworkAccessManager, QNetworkRequest, QNetworkReply
-
-
-try:
-    from setiastro.saspro._generated.build_info import BUILD_TIMESTAMP
-except Exception:
-    # No generated build info → running from local source checkout
-    BUILD_TIMESTAMP = "dev"
-
-
-
-_update_splash(QCoreApplication.translate("Splash", "Loading resources..."), 50)
-
-# Icon paths are now centralized in setiastro.saspro.resources module
-from setiastro.saspro.resources import (
-    icon_path, windowslogo_path, green_path, neutral_path, whitebalance_path,
-    morpho_path, clahe_path, starnet_path, staradd_path, LExtract_path,
-    LInsert_path, slot0_path, slot1_path, slot2_path, slot3_path, slot4_path,
-    rgbcombo_path, rgbextract_path, copyslot_path, graxperticon_path,
-    cropicon_path, openfile_path, abeicon_path, undoicon_path, redoicon_path,
-    blastericon_path, hdr_path, invert_path, fliphorizontal_path,
-    flipvertical_path, rotateclockwise_path, rotatecounterclockwise_path,
-    rotate180_path, maskcreate_path, maskapply_path, maskremove_path,
-    slot5_path, slot6_path, slot7_path, slot8_path, slot9_path, pixelmath_path,
-    histogram_path, mosaic_path, rescale_path, staralign_path, mask_path,
-    platesolve_path, psf_path, supernova_path, starregistration_path,
-    stacking_path, pedestal_icon_path, starspike_path, aperture_path,
-    jwstpupil_path, signature_icon_path, livestacking_path, hrdiagram_path,
-    convoicon_path, spcc_icon_path, sasp_data_path, exoicon_path, peeker_icon,
-    dse_icon_path, astrobin_filters_csv_path, isophote_path, statstretch_path,
-    starstretch_path, curves_path, disk_path, uhs_path, blink_path, ppp_path,
-    nbtorgb_path, freqsep_path, contsub_path, halo_path, cosmic_path,
-    satellite_path, imagecombine_path, wrench_path, eye_icon_path,
-    disk_icon_path, nuke_path, hubble_path, collage_path, annotated_path,
-    colorwheel_path, font_path, csv_icon_path, spinner_path, wims_path,
-    wimi_path, linearfit_path, debayer_path, aberration_path,
-    functionbundles_path, viewbundles_path, selectivecolor_path, rgbalign_path,
-)
-
-
-_update_splash(QCoreApplication.translate("Splash", "Configuring Qt message handler..."), 55)
-
-from PyQt6.QtCore import qInstallMessageHandler, QtMsgType
-
-def _qt_msg_handler(mode, ctx, msg):
-    lvl = {
-        QtMsgType.QtDebugMsg:    logging.DEBUG,
-        QtMsgType.QtInfoMsg:     logging.INFO,
-        QtMsgType.QtWarningMsg:  logging.WARNING,
-        QtMsgType.QtCriticalMsg: logging.ERROR,
-        QtMsgType.QtFatalMsg:    logging.CRITICAL,
-    }.get(mode, logging.ERROR)
-    logging.log(lvl, "Qt: %s (%s:%s)", msg, getattr(ctx, "file", "?"), getattr(ctx, "line", -1))
-
-qInstallMessageHandler(_qt_msg_handler)
-
-_update_splash(QCoreApplication.translate("Splash", "Loading MDI widgets..."), 60)
-
-# MDI widgets imported from setiastro.saspro.mdi_widgets
-from setiastro.saspro.mdi_widgets import (
-    MdiArea, ViewLinkController, ConsoleListWidget, QtLogStream, _DocProxy,
-    ROLE_ACTION as _ROLE_ACTION,
-)
-
-# Helper functions imported from setiastro.saspro.main_helpers
-from setiastro.saspro.main_helpers import (
-    safe_join_dir_and_name as _safe_join_dir_and_name,
-    normalize_save_path_chosen_filter as _normalize_save_path_chosen_filter,
-    display_name as _display_name,
-    best_doc_name as _best_doc_name,
-    doc_looks_like_table as _doc_looks_like_table,
-    is_alive as _is_alive,
-    safe_widget as _safe_widget,
-)
-
-# AboutDialog, DECOR_GLYPHS, _strip_ui_decorations imported from setiastro.saspro.widgets.common_utilities
-
-# File utilities imported from setiastro.saspro.file_utils
-from setiastro.saspro.file_utils import (
-    _normalize_ext,
-    _sanitize_filename,
-    _exts_from_filter,
-    REPLACE_SPACES_WITH_UNDERSCORES as _REPLACE_SPACES_WITH_UNDERSCORES,
-    WIN_RESERVED_NAMES as _WIN_RESERVED,
-)
-
-_update_splash(QCoreApplication.translate("Splash", "Loading main window module..."), 65)
-
-from setiastro.saspro.gui.main_window import AstroSuiteProMainWindow
-
-_update_splash(QCoreApplication.translate("Splash", "Modules loaded, finalizing..."), 70)
+    _lightkurve_module = None
+
+    def get_lightkurve():
+        global _lightkurve_module
+        if _lightkurve_module is None:
+            try:
+                import lightkurve as _lk
+                _lk.MPLSTYLE = None
+                _lightkurve_module = _lk
+            except Exception:
+                _lightkurve_module = False
+        return _lightkurve_module if _lightkurve_module else None
+
+    _update_splash(QCoreApplication.translate("Splash", "Loading UI utilities..."), 30)
+
+    from setiastro.saspro.widgets.common_utilities import (
+        AboutDialog,
+        ProjectSaveWorker as _ProjectSaveWorker,
+        DECOR_GLYPHS,
+        _strip_ui_decorations,
+        install_crash_handlers,
+    )
+
+    _update_splash(QCoreApplication.translate("Splash", "Loading reproject library..."), 35)
+
+    try:
+        from reproject import reproject_interp
+    except ImportError:
+        reproject_interp = None
+
+    _update_splash(QCoreApplication.translate("Splash", "Loading OpenCV..."), 40)
+
+    try:
+        import cv2
+        OPENCV_AVAILABLE = True
+    except ImportError:
+        OPENCV_AVAILABLE = False
+
+    _update_splash(QCoreApplication.translate("Splash", "Loading PyQt6 components..."), 45)
+
+    from PyQt6 import sip
+
+    from PyQt6.QtWidgets import (QDialog, QApplication, QMainWindow, QWidget, QHBoxLayout, QFileDialog, QMessageBox, QSizePolicy, QToolBar, QPushButton, QAbstractItemDelegate,
+        QLineEdit, QMenu, QListWidget, QListWidgetItem, QSplashScreen, QDockWidget, QListView, QCompleter, QMdiArea, QMdiSubWindow, QWidgetAction, QAbstractItemView,
+        QInputDialog, QVBoxLayout, QLabel, QCheckBox, QProgressBar, QProgressDialog, QGraphicsItem, QTabWidget, QTableWidget, QHeaderView, QTableWidgetItem, QToolButton, QPlainTextEdit
+    )
+
+    from PyQt6.QtGui import (QPixmap, QColor, QIcon, QKeySequence, QShortcut, QGuiApplication, QStandardItemModel, QStandardItem, QAction, QPalette, QBrush, QActionGroup, QDesktopServices, QFont, QTextCursor
+    )
+
+    from PyQt6.QtCore import (Qt, pyqtSignal, QTimer, QSize, QSignalBlocker, QModelIndex, QThread, QUrl, QSettings, QEvent, QByteArray, QObject,
+        QPropertyAnimation, QEasingCurve
+    )
+
+
+    from PyQt6.QtNetwork import QNetworkAccessManager, QNetworkRequest, QNetworkReply
+
+    global BUILD_TIMESTAMP
+    try:
+        from setiastro.saspro._generated.build_info import BUILD_TIMESTAMP
+    except Exception:
+        BUILD_TIMESTAMP = "dev"
+
+    _update_splash(QCoreApplication.translate("Splash", "Loading resources..."), 50)
+
+    from setiastro.saspro.resources import (
+        icon_path, windowslogo_path, green_path, neutral_path, whitebalance_path,
+        morpho_path, clahe_path, starnet_path, staradd_path, LExtract_path,
+        LInsert_path, slot0_path, slot1_path, slot2_path, slot3_path, slot4_path,
+        rgbcombo_path, rgbextract_path, copyslot_path, graxperticon_path,
+        cropicon_path, openfile_path, abeicon_path, undoicon_path, redoicon_path,
+        blastericon_path, hdr_path, invert_path, fliphorizontal_path,
+        flipvertical_path, rotateclockwise_path, rotatecounterclockwise_path,
+        rotate180_path, maskcreate_path, maskapply_path, maskremove_path,
+        slot5_path, slot6_path, slot7_path, slot8_path, slot9_path, pixelmath_path,
+        histogram_path, mosaic_path, rescale_path, staralign_path, mask_path,
+        platesolve_path, psf_path, supernova_path, starregistration_path,
+        stacking_path, pedestal_icon_path, starspike_path, aperture_path,
+        jwstpupil_path, signature_icon_path, livestacking_path, hrdiagram_path,
+        convoicon_path, spcc_icon_path, sasp_data_path, exoicon_path, peeker_icon,
+        dse_icon_path, astrobin_filters_csv_path, isophote_path, statstretch_path,
+        starstretch_path, curves_path, disk_path, uhs_path, blink_path, ppp_path,
+        nbtorgb_path, freqsep_path, contsub_path, halo_path, cosmic_path,
+        satellite_path, imagecombine_path, wrench_path, eye_icon_path,
+        disk_icon_path, nuke_path, hubble_path, collage_path, annotated_path,
+        colorwheel_path, font_path, csv_icon_path, spinner_path, wims_path,
+        wimi_path, linearfit_path, debayer_path, aberration_path,
+        functionbundles_path, viewbundles_path, selectivecolor_path, rgbalign_path,
+    )
+
+    _update_splash(QCoreApplication.translate("Splash", "Configuring Qt message handler..."), 55)
+
+    from PyQt6.QtCore import qInstallMessageHandler, QtMsgType
+
+    def _qt_msg_handler(mode, ctx, msg):
+        lvl = {
+            QtMsgType.QtDebugMsg:    logging.DEBUG,
+            QtMsgType.QtInfoMsg:     logging.INFO,
+            QtMsgType.QtWarningMsg:  logging.WARNING,
+            QtMsgType.QtCriticalMsg: logging.ERROR,
+            QtMsgType.QtFatalMsg:    logging.CRITICAL,
+        }.get(mode, logging.ERROR)
+        logging.log(lvl, "Qt: %s (%s:%s)", msg, getattr(ctx, "file", "?"), getattr(ctx, "line", -1))
+
+    qInstallMessageHandler(_qt_msg_handler)
+
+    _update_splash(QCoreApplication.translate("Splash", "Loading MDI widgets..."), 60)
+
+    from setiastro.saspro.mdi_widgets import (
+        MdiArea, ViewLinkController, ConsoleListWidget, QtLogStream, _DocProxy,
+        ROLE_ACTION as _ROLE_ACTION,
+    )
+
+    from setiastro.saspro.main_helpers import (
+        safe_join_dir_and_name as _safe_join_dir_and_name,
+        normalize_save_path_chosen_filter as _normalize_save_path_chosen_filter,
+        display_name as _display_name,
+        best_doc_name as _best_doc_name,
+        doc_looks_like_table as _doc_looks_like_table,
+        is_alive as _is_alive,
+        safe_widget as _safe_widget,
+    )
+
+    from setiastro.saspro.file_utils import (
+        _normalize_ext,
+        _sanitize_filename,
+        _exts_from_filter,
+        REPLACE_SPACES_WITH_UNDERSCORES as _REPLACE_SPACES_WITH_UNDERSCORES,
+        WIN_RESERVED_NAMES as _WIN_RESERVED,
+    )
+
+    _update_splash(QCoreApplication.translate("Splash", "Loading main window module..."), 65)
+
+    from setiastro.saspro.gui.main_window import AstroSuiteProMainWindow
+
+    _update_splash(QCoreApplication.translate("Splash", "Modules loaded, finalizing..."), 70)
+
+    # Export things main() already relies on as globals (min disruption)
+    globals().update({
+        "logging": logging,
+        "multiprocessing": multiprocessing,
+        "warnings": warnings,
+        "QIcon": QIcon,
+        "QMessageBox": QMessageBox,
+        "QPropertyAnimation": QPropertyAnimation,
+        "QEasingCurve": QEasingCurve,
+        "windowslogo_path": windowslogo_path,
+        "icon_path": icon_path,
+        "install_crash_handlers": install_crash_handlers,
+        "AstroSuiteProMainWindow": AstroSuiteProMainWindow,
+        "BUILD_TIMESTAMP": BUILD_TIMESTAMP,
+    })
+
 
 
 def main():
@@ -759,7 +794,8 @@ def main():
     # Initialize splash if not already done
     if not _splash_initialized:
         _init_splash()
-    
+
+    _bootstrap_imports()
     # Update splash with build info now that we have VERSION and BUILD_TIMESTAMP
     if _splash:
         _splash.setBuildInfo(VERSION, BUILD_TIMESTAMP)
@@ -882,29 +918,34 @@ def main():
         # --- Smooth Transition: App Fade In + Splash Fade Out ---
         # MITIGATION: Prevent "White Flash" on startup
         # 1. Force a dark background immediately so if opacity lags, it's dark not white
-        win.setStyleSheet("QMainWindow { background-color: #0F0F19; }") 
-        # 2. Ensure native window handle exists so setWindowOpacity works immediately
+        win.setStyleSheet("QMainWindow { background-color: #0F0F19; }")
         win.winId()
-        # 3. Set opacity to 0
-        win.setWindowOpacity(0.0)
-        
+
+        if _allow_window_opacity_effects():
+            win.setWindowOpacity(0.0)
+
         win.show()
-        
-        # 1. Animate Main Window Fade In
-        anim_app = QPropertyAnimation(win, b"windowOpacity")
-        anim_app.setDuration(1200)
-        anim_app.setStartValue(0.0)
-        anim_app.setEndValue(1.0)
-        anim_app.setEasingCurve(QEasingCurve.Type.OutQuad)
-        
-        # Cleanup temp stylesheet upon completion to avoid interfering with ThemeMixin
-        def _on_fade_in_finished():
+
+        if _allow_window_opacity_effects():
+            anim_app = QPropertyAnimation(win, b"windowOpacity")
+            anim_app.setDuration(1200)
+            anim_app.setStartValue(0.0)
+            anim_app.setEndValue(1.0)
+            anim_app.setEasingCurve(QEasingCurve.Type.OutQuad)
+
+            def _on_fade_in_finished():
+                win.setStyleSheet("")
+                if hasattr(win, "on_fade_in_complete"):
+                    win.on_fade_in_complete()
+
+            anim_app.finished.connect(_on_fade_in_finished)
+            anim_app.start()
+        else:
+            # No opacity animation on Wayland: just show immediately and clear the temp stylesheet
             win.setStyleSheet("")
             if hasattr(win, "on_fade_in_complete"):
                 win.on_fade_in_complete()
-            
-        anim_app.finished.connect(_on_fade_in_finished)
-        anim_app.start()
+        
 
         # Start background Numba warmup after UI is visible
         try: