setiastrosuitepro 1.6.4__py3-none-any.whl → 1.7.1.post2__py3-none-any.whl

setiastro/saspro/gui/main_window.py

@@ -129,7 +129,7 @@ from PyQt6.QtGui import (QPixmap, QColor, QIcon, QKeySequence, QShortcut,
 
 # ----- QtCore -----
 from PyQt6.QtCore import (Qt, pyqtSignal, QCoreApplication, QTimer, QSize, QSignalBlocker,  QModelIndex, QThread, QUrl, QSettings, QEvent, QByteArray, QObject,
-    QPropertyAnimation, QEasingCurve, QElapsedTimer
+    QPropertyAnimation, QEasingCurve, QElapsedTimer, QPoint
 )
 
 from PyQt6.QtNetwork import QNetworkAccessManager, QNetworkRequest, QNetworkReply
@@ -168,7 +168,7 @@ except Exception:
 
 
 
-
+_DEBUG_DND_DUP = False
 
 
 
@@ -193,9 +193,9 @@ from setiastro.saspro.resources import (
     nbtorgb_path, freqsep_path, contsub_path, halo_path, cosmic_path,
     satellite_path, imagecombine_path, wrench_path, eye_icon_path,multiscale_decomp_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,
+    colorwheel_path, font_path, csv_icon_path, spinner_path, wims_path, narrowbandnormalization_path,
+    wimi_path, linearfit_path, debayer_path, aberration_path, acv_icon_path,
+    functionbundles_path, viewbundles_path, selectivecolor_path, rgbalign_path, planetarystacker_path,
     background_path, script_icon_path
 )
 
@@ -285,6 +285,144 @@ from setiastro.saspro.gui.mixins import (
     ThemeMixin, GeometryMixin, ViewMixin, HeaderMixin, MaskMixin, UpdateMixin
 )
 
+import sys
+import time
+import threading
+import traceback
+from PyQt6.QtCore import QObject, QTimer
+
+class UiStallDetector(QObject):
+    """
+    Detects UI stalls by watching QTimer tick drift.
+    On stall, prints stack traces for all threads using print().
+    (No faulthandler / no fileno() required.)
+    """
+
+    def __init__(self, parent=None, interval_ms: int = 50, threshold_ms: int = 300):
+        super().__init__(parent)
+        self.interval_ms = int(interval_ms)
+        self.threshold_ms = int(threshold_ms)
+        self._last = time.perf_counter()
+        self._stall_seq = 0
+
+        # cooldown state (instance-level)
+        self._last_dump_t = 0.0
+
+        self._timer = QTimer(self)
+        self._timer.setInterval(self.interval_ms)
+        self._timer.timeout.connect(self._tick)
+
+    def start(self):
+        self._last = time.perf_counter()
+        self._timer.start()
+
+    def stop(self):
+        self._timer.stop()
+
+    def _dump_all_threads_print(self):
+        now = time.perf_counter()
+        if now - self._last_dump_t < 2.0:  # 2s cooldown
+            print("[UI STALL] dump skipped (cooldown)", flush=True)
+            return
+        self._last_dump_t = now
+
+        frames = sys._current_frames()
+        main_ident = threading.main_thread().ident
+
+        print("[UI STALL] ===== lightweight dump (all threads) =====", flush=True)
+
+        # Main thread: full stack
+        if main_ident in frames:
+            print("\n--- MainThread (full) ---", flush=True)
+            print("".join(traceback.format_stack(frames[main_ident])), flush=True)
+
+        # Other threads: only top-frame summary
+        for t in threading.enumerate():
+            if t.ident is None or t.ident == main_ident:
+                continue
+            f = frames.get(t.ident)
+            if not f:
+                continue
+            code = f.f_code
+            print(
+                f"--- Thread {t.ident} ({t.name}) top --- {code.co_filename}:{f.f_lineno} in {code.co_name}",
+                flush=True,
+            )
+
+        print("[UI STALL] ===== end lightweight dump =====", flush=True)
+
+    def _tick(self):
+        now = time.perf_counter()
+        elapsed_ms = (now - self._last) * 1000.0
+        self._last = now
+
+        late_ms = elapsed_ms - self.interval_ms
+        if late_ms >= self.threshold_ms:
+            print(f"[UI STALL] tick late by {late_ms:.0f} ms (elapsed={elapsed_ms:.0f} ms)", flush=True)
+            self._dump_all_threads_print()
+
+def _strip_filename_ext(title: str) -> str:
+    t = (title or "").strip()
+    if not t:
+        return t
+    base, ext = os.path.splitext(t)
+    # treat as extension only if it looks like one: .fit .fits .tif .tiff .xisf etc
+    if ext and 1 <= len(ext) <= 10 and all(ch.isalnum() for ch in ext[1:]):
+        return base
+    return t
+
+
+
+_DECOR_GLYPHS = "■●◆▲▪▫•◼◻◾◽🔗"
+
+def normalize_doc_title(s: str) -> str:
+    s = (s or "").strip()
+
+    # remove our textual prefix too
+    if s.startswith("[LINK] "):
+        s = s[len("[LINK] "):].strip()
+
+    # strip common UI decorations if you already have this helper
+    try:
+        s = _strip_ui_decorations(s)
+    except Exception:
+        pass
+
+    # remove any leading decorator glyphs repeatedly: "🔗 ", "■ ", etc.
+    while len(s) >= 2 and s[0] in _DECOR_GLYPHS and s[1] == " ":
+        s = s[2:].lstrip()
+
+    # also remove any stray decorator glyphs that got embedded (rare but happens)
+    s = re.sub(rf"[{re.escape(_DECOR_GLYPHS)}]", "", s).strip()
+
+    return s
+
+_VIEW_SUFFIX_RE = re.compile(r"\s+\[View\s+\d+\]\s*$")
+
+def _normalize_title_for_compare(t: str) -> str:
+    t = (t or "").strip()
+    if not t:
+        return ""
+
+    # strip UI decorations (🔗, ■, etc)
+    try:
+        t = _strip_ui_decorations(t)
+    except Exception:
+        pass
+
+    # strip trailing "[View N]" if present
+    t = _VIEW_SUFFIX_RE.sub("", t).strip()
+
+    # strip filename-like extension
+    try:
+        t = _strip_filename_ext(t)
+    except Exception:
+        # fallback: only strip if it looks like an ext
+        base, ext = os.path.splitext(t)
+        if ext and len(ext) <= 10:
+            t = base
+
+    return t.strip()
 
 class AstroSuiteProMainWindow(
     DockMixin, MenuMixin, ToolbarMixin, FileMixin,
@@ -299,7 +437,8 @@ class AstroSuiteProMainWindow(
         # Prevent white flash: start strictly transparent and force dark bg
         self.setWindowOpacity(0.0)
         self.setStyleSheet("QMainWindow { background-color: #0F0F19; }")
-
+        #self._stall = UiStallDetector(self, interval_ms=50, threshold_ms=250)
+        #self._stall.start()
         # --- Usage Stats ---
         self._session_start_time = time.time()
         self._stats_timer = QTimer(self)
@@ -465,7 +604,10 @@ class AstroSuiteProMainWindow(
         self.docman.documentAdded.connect(self._on_document_added)
         self.mdi.viewStateDropped.connect(self._on_mdi_viewstate_drop)
         self.mdi.linkViewDropped.connect(self._on_linkview_drop)
-
+        self._mdi_open_batch = 0
+        self._mdi_place_mode = "cascade"   # or "tile"
+        self._mdi_next_pos = None          # QPoint in MDI coords
+        self._mdi_cascade_step = 28
         self.doc_manager.set_mdi_area(self.mdi)
         # Coalesce undo/redo label refreshes
         self._undo_redo_refresh_pending = False
@@ -856,7 +998,18 @@ class AstroSuiteProMainWindow(
         dm = self.doc_manager
         doc = None
 
+        if _DEBUG_DND_DUP:
+            import json
+            print("\n[DNDDBG:DROP_ENTER] raw st dict:")
+            try:
+                # st is already a dict here
+                for k in sorted(st.keys()):
+                    print(f"  {k}: {st.get(k)!r}")
+            except Exception as e:
+                print("[DNDDBG:DROP_ENTER] failed printing st:", e)
 
+            # sanity: show which fields are present
+            print("[DNDDBG:DROP_ENTER] has source_view_title?", "source_view_title" in st)
 
         # Prefer *stable* identifiers over the proxy pointer
         uid     = st.get("doc_uid")
@@ -959,7 +1112,21 @@ class AstroSuiteProMainWindow(
             print("[VIEWSTATE_DROP] EXIT (no doc)")
             return
 
-
+        if _DEBUG_DND_DUP:
+            try:
+                dname = doc.display_name() if hasattr(doc, "display_name") else None
+            except Exception:
+                dname = None
+            try:
+                meta = getattr(doc, "metadata", {}) or {}
+            except Exception:
+                meta = {}
+            print("\n[DNDDBG:DOC_RESOLVED]")
+            print("  doc_obj:", doc, "type:", type(doc).__name__, "id:", id(doc))
+            print("  doc.uid:", getattr(doc, "uid", None))
+            print("  doc.display_name():", dname)
+            print("  meta.display_name:", meta.get("display_name"))
+            print("  meta.file_path:", meta.get("file_path"))
 
         # ----------------------------------------
         # 4) Peek at metadata to see if this is a
@@ -1050,34 +1217,35 @@ class AstroSuiteProMainWindow(
         #      copy the view transform.
         # ----------------------------------------
         if force_new:
-            # We're here only if:
-            #  - it's NOT a preview (normal full or promoted ROI), or
-            #  - ROI promotion didn't apply and we fell through.
             base_doc = doc
 
-            # 1) Duplicate the underlying document
-            try:
-                base_name = ""
+            # 1) Prefer the dragged view's title
+            base_name = (st.get("source_view_title") or "").strip()
+
+            # 2) Fallback to document display name
+            if not base_name:
                 try:
                     base_name = base_doc.display_name() or "Untitled"
                 except Exception:
                     base_name = "Untitled"
 
-                try:
-                    base_name = _strip_ui_decorations(base_name)
-                except Exception:
-                    # minimal fallback: remove known glyph prefixes and "Active View: "
-                    while len(base_name) >= 2 and base_name[1] == " " and base_name[0] in "â- â--â--†â-²â-ªâ-«â€¢â--¼â--»â--¾â--½":
-                        base_name = base_name[2:]
-                    if base_name.startswith("Active View: "):
-                        base_name = base_name[len("Active View: "):]
-
-                new_doc = self.docman.duplicate_document(
-                    base_doc, new_name=f"{base_name}_duplicate"
-                )
-            except Exception as e:
-                print("[Main] viewstate_drop: duplicate_document failed, falling back to original doc:", e)
-                new_doc = base_doc  # worst-case: still just reuse
+            # 3) Clean it (strip glyphs / "Active View" / etc.)
+            try:
+                base_name = _strip_ui_decorations(base_name)
+            except Exception:
+                if base_name.startswith("Active View: "):
+                    base_name = base_name[len("Active View: "):]
+
+            if _DEBUG_DND_DUP:
+                print("\n[DNDDBG:NAME_COMPUTE]")
+                print("  st.source_view_title:", (st.get("source_view_title") or "").strip())
+                print("  base_doc.display_name():", (base_doc.display_name() if hasattr(base_doc,"display_name") else None))
+                print("  base_name(after fallbacks/strip):", base_name)
+                print("  new_name passed:", f"{base_name}_duplicate")
+
+            new_doc = self.docman.duplicate_document(
+                base_doc, new_name=f"{base_name}_duplicate"
+            )
 
             # 2) Let doc_manager's documentAdded handler create the subwindow.
             #    We just wait for it to show up and then apply the view state.
@@ -1203,14 +1371,6 @@ class AstroSuiteProMainWindow(
             return False
 
     def _on_document_added(self, doc):
-        # Helpful debug:
-        try:
-            is_table = (getattr(doc, "metadata", {}).get("doc_type") == "table") or \
-                    (hasattr(doc, "rows") and hasattr(doc, "headers"))
-            self._log(f"[documentAdded] {type(doc).__name__}  table={is_table}  name={getattr(doc, 'display_name', lambda:'?')()}")
-        except Exception:
-            pass
-
         self._spawn_subwindow_for(doc)
 
     # --- UI scaffolding ---
@@ -2503,10 +2663,27 @@ class AstroSuiteProMainWindow(
         return f"{name}{dims}"
 
     def _update_explorer_item_for_doc(self, doc):
-        for i in range(self.explorer.count()):
-            it = self.explorer.item(i)
-            if it.data(Qt.ItemDataRole.UserRole) is doc:
-                it.setText(self._format_explorer_title(doc))
+        # Delegate to DockMixin implementation if present
+        try:
+            return super()._update_explorer_item_for_doc(doc)
+        except Exception:
+            pass
+
+        # Fallback: tree-safe implementation
+        if not hasattr(self, "explorer") or self.explorer is None:
+            return
+        try:
+            n = self.explorer.topLevelItemCount()
+        except Exception:
+            return
+
+        for i in range(n):
+            it = self.explorer.topLevelItem(i)
+            if it.data(0, Qt.ItemDataRole.UserRole) is doc:
+                try:
+                    self._refresh_explorer_row(it, doc)
+                except Exception:
+                    pass
                 return
     #-----------FUNCTIONS----------------
 
@@ -3015,17 +3192,17 @@ class AstroSuiteProMainWindow(
 
         self.convo_window.show()
 
-    
-
     def _apply_extract_luminance_preset_to_doc(self, doc, preset=None):
-
         from PyQt6.QtWidgets import QMessageBox
-        from setiastro.saspro.luminancerecombine import compute_luminance, _LUMA_REC709, _LUMA_REC601, _LUMA_REC2020
-        from setiastro.saspro.headless_utils import normalize_headless_main, unwrap_docproxy
+        from setiastro.saspro.luminancerecombine import (
+            compute_luminance,
+            resolve_luma_profile_weights,
+        )
+        from setiastro.saspro.headless_utils import unwrap_docproxy
+        import numpy as np
 
         doc = unwrap_docproxy(doc)
         p = dict(preset or {})
-        mode = (p.get("mode") or "rec709").lower()
 
         if doc is None or getattr(doc, "image", None) is None:
             QMessageBox.information(self, "Extract Luminance", "No target image.")
@@ -3033,52 +3210,43 @@ class AstroSuiteProMainWindow(
 
         img = np.asarray(doc.image)
 
-        # pick weights
-        if mode == "rec601":
-            w = _LUMA_REC601
-        elif mode == "rec2020":
-            w = _LUMA_REC2020
-        elif mode == "max":
-            w = None
-        else:
-            w = _LUMA_REC709
+        mode = str(p.get("mode", "rec709")).strip()
+        resolved_method, w, profile_name = resolve_luma_profile_weights(mode)
 
-        L = compute_luminance(img, method=mode, weights=w)
+        L = compute_luminance(img, method=resolved_method, weights=w)
 
         dm = getattr(self, "doc_manager", None)
         if dm is None:
-            # headless fallback: just overwrite active doc
             doc.apply_edit(L.astype(np.float32), step_name="Extract Luminance")
             return
 
-        # normal behavior: create a new mono document
+        meta = {
+            "step_name": "Extract Luminance",
+            "luma_method": resolved_method,
+        }
+        if w is not None:
+            meta["luma_weights"] = np.asarray(w, dtype=np.float32).tolist()
+        if profile_name:
+            meta["luma_profile"] = str(profile_name)
+
         try:
+            suffix = f"{profile_name}" if profile_name else resolved_method
             new_doc = dm.create_document_from_array(
                 L.astype(np.float32),
-                name=f"{doc.display_name()} -- Luminance ({mode})",
+                name=f"{doc.display_name()} -- Luminance ({suffix})",
                 is_mono=True,
-                metadata={"step_name":"Extract Luminance", "luma_method":mode}
+                metadata=meta,
             )
             dm.add_document(new_doc)
         except Exception:
-            # safe fallback
             doc.apply_edit(L.astype(np.float32), step_name="Extract Luminance")
 
-
     def _extract_luminance(self, doc=None, preset: dict | None = None):
-        from setiastro.saspro.luminancerecombine import _LUMA_REC709, _LUMA_REC601, _LUMA_REC2020
-        """
-        If doc is None, uses the active subwindow's document.
-        Otherwise, run on the provided doc (for drag-and-drop to a specific view).
-        Creates a new mono document (float32, [0..1]) and spawns a subwindow.
-
-        Preset schema:
-        {
-            "mode": "rec709" | "rec601" | "rec2020" | "max" | "snr" | "equal" | "median",
-            # aliases accepted: method, luma_method, nb_max -> "max", snr_unequal -> "snr"
-        }
-        """
-        # 1) resolve source document
+        from PyQt6.QtWidgets import QMessageBox
+        from PyQt6.QtGui import QIcon
+        from setiastro.saspro.luminancerecombine import compute_luminance, resolve_luma_profile_weights
+
+
         sw = None
         if doc is None:
             sw = self.mdi.activeSubWindow()
@@ -3097,70 +3265,19 @@ class AstroSuiteProMainWindow(
             QMessageBox.information(self, "Extract Luminance", "Luminance extraction requires an RGB image.")
             return
 
-        # 2) normalize to [0,1] float32
-        a = img.astype(np.float32, copy=False)
-        if a.size:
-            m = float(np.nanmax(a))
-            if np.isfinite(m) and m > 1.0:
-                a = a / m
-        a = np.clip(a, 0.0, 1.0)
-
-        # 3) choose luminance method
         p = dict(preset or {})
-        method = str(
+        mode = str(
             p.get("mode",
             p.get("method",
             p.get("luma_method",
                 getattr(self, "luma_method", "rec709"))))
-        ).strip().lower()
-
-        # aliases
-        alias = {
-            "rec.709": "rec709",
-            "rec-709": "rec709",
-            "rgb": "rec709",
-            "k": "rec709",
-            "rec.601": "rec601",
-            "rec-601": "rec601",
-            "rec.2020": "rec2020",
-            "rec-2020": "rec2020",
-            "nb_max": "max",
-            "narrowband": "max",
-            "snr_unequal": "snr",
-            "unequal_noise": "snr",
-        }
-        method = alias.get(method, method)
-
-        # 4) compute luminance per selected method
-        luma_weights = None
-        if method == "rec601":
-            luma_weights = _LUMA_REC601
-            y = np.tensordot(a, _LUMA_REC601, axes=([2],[0]))
-        elif method == "rec2020":
-            luma_weights = _LUMA_REC2020
-            y = np.tensordot(a, _LUMA_REC2020, axes=([2],[0]))
-        elif method == "max":
-            y = a.max(axis=2)
-        elif method == "median":
-            y = np.median(a, axis=2)
-        elif method == "equal":
-            luma_weights = np.array([1/3, 1/3, 1/3], dtype=np.float32)
-            y = a.mean(axis=2)
-        elif method == "snr":
-            from setiastro.saspro.luminancerecombine import _estimate_noise_sigma_per_channel
-            sigma = _estimate_noise_sigma_per_channel(a)
-            w = 1.0 / (sigma[:3]**2 + 1e-12)
-            w = w / w.sum()
-            luma_weights = w.astype(np.float32)
-            y = np.tensordot(a[..., :3], luma_weights, axes=([2],[0]))
-        else:  # "rec709" default
-            method = "rec709"
-            luma_weights = _LUMA_REC709
-            y = np.tensordot(a, _LUMA_REC709, axes=([2],[0]))
-
-        y = np.clip(y.astype(np.float32, copy=False), 0.0, 1.0)
-
-        # 5) metadata & title
+        ).strip()
+
+        resolved_method, w, profile_name = resolve_luma_profile_weights(mode)
+
+        y = compute_luminance(img, method=resolved_method, weights=w)
+
+        # ---- metadata & title ----
         base_meta = {}
         try:
             base_meta = dict(getattr(doc, "metadata", {}) or {})
@@ -3172,13 +3289,16 @@ class AstroSuiteProMainWindow(
             "source": "ExtractLuminance",
             "is_mono": True,
             "bit_depth": "32f",
-            "luma_method": method,
+            "luma_method": resolved_method,
         }
-        if luma_weights is not None:
-            meta["luma_weights"] = np.asarray(luma_weights, dtype=np.float32).tolist()
+        if w is not None:
+            meta["luma_weights"] = np.asarray(w, dtype=np.float32).tolist()
+        if profile_name:
+            meta["luma_profile"] = str(profile_name)
 
         base_title = sw.windowTitle() if sw else (getattr(doc, "title", getattr(doc, "name", "")) or "Untitled")
-        title = f"{base_title} -- Luminance"
+        suffix = f"{profile_name}" if profile_name else resolved_method
+        title = f"{base_title} -- Luminance ({suffix})"
 
         dm = getattr(self, "docman", None)
         if dm is None:
@@ -3206,19 +3326,19 @@ class AstroSuiteProMainWindow(
         except Exception:
             pass
 
-        # ðŸ" Remember for Replay (optional but consistent)
         try:
             remember = getattr(self, "remember_last_headless_command", None) or getattr(self, "_remember_last_headless_command", None)
             if callable(remember):
-                remember("extract_luminance", {"mode": method}, description="Extract Luminance")
+                remember("extract_luminance", {"mode": mode}, description="Extract Luminance")
         except Exception:
             pass
 
         if hasattr(self, "_log"):
-            self._log(f"Extract Luminance ({method}) -> new mono document created.")
+            self._log(f"Extract Luminance ({suffix}) -> new mono document created.")
 
         return new_doc
 
+
     def _subwindow_docs(self):
         docs = []
         for sw in self.mdi.subWindowList():
@@ -3788,6 +3908,19 @@ class AstroSuiteProMainWindow(
 
         dlg.show()
 
+    def _open_narrowband_normalization_tool(self):
+        # Correct module import
+        from setiastro.saspro.narrowband_normalization import NarrowbandNormalization
+
+        w = NarrowbandNormalization(doc_manager=self.docman, parent=self)
+        w.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose, True)
+        w.setWindowTitle("Narrowband Normalization")
+        try:
+            w.setWindowIcon(QIcon(narrowbandnormalization_path))
+        except Exception:
+            pass
+        w.show()
+
     def _open_ppp_tool(self):
         from setiastro.saspro.perfect_palette_picker import PerfectPalettePicker
         w = PerfectPalettePicker(doc_manager=self.docman)  # parent gives access to _spawn_subwindow_for
@@ -4139,6 +4272,14 @@ class AstroSuiteProMainWindow(
         dlg.setWindowIcon(QIcon(livestacking_path))
         dlg.show()
 
+    def _open_planetary_stacker(self):
+        # import locally to avoid startup cost / circular imports
+        from setiastro.saspro.serviewer import SERViewer
+        dlg = SERViewer(self)
+        dlg.setWindowFlag(Qt.WindowType.Window, True)
+        dlg.setWindowIcon(QIcon(planetarystacker_path))        
+        dlg.show()
+
     def _open_stacking_suite(self):
         # Reuse if we already have one
         dlg = getattr(self, "_stacking_suite", None)
@@ -4182,6 +4323,202 @@ class AstroSuiteProMainWindow(
             except Exception:
                 pass
 
+    def _convert_mono_to_rgb_active(self):
+        """
+        Convert active mono document to RGB by duplicating the channel.
+        Updates the active document in-place (undoable).
+        """
+        dm = getattr(self, "docman", None)
+        if dm is None:
+            return
+
+        try:
+            doc = dm.get_active_document()
+        except Exception:
+            doc = None
+        if doc is None:
+            return
+
+        img = getattr(doc, "image", None)
+        if img is None:
+            return
+
+        import numpy as np
+
+        x = np.asarray(img)
+
+        # Already RGB?
+        if x.ndim == 3 and x.shape[-1] == 3:
+            try:
+                name = getattr(doc, "display_name", lambda: None)() or getattr(doc, "name", "") or "Active"
+            except Exception:
+                name = "Active"
+            if hasattr(self, "_log"):
+                self._log(f"Mono → RGB: '{name}' is already RGB (shape={getattr(x,'shape',None)}).")
+            return
+
+        # Determine what we're converting FROM
+        src_desc = "unknown"
+        if x.ndim == 2:
+            mono = x
+            src_desc = "mono (H×W)"
+        elif x.ndim == 3 and x.shape[-1] == 1:
+            mono = x[..., 0]
+            src_desc = "mono (H×W×1)"
+        else:
+            # Unknown format (e.g., multi-channel >3)
+            try:
+                name = getattr(doc, "display_name", lambda: None)() or getattr(doc, "name", "") or "Active"
+            except Exception:
+                name = "Active"
+            if hasattr(self, "_log"):
+                self._log(f"Mono → RGB: '{name}' not convertible (shape={getattr(x,'shape',None)}).")
+            return
+
+        before_shape = getattr(x, "shape", None)
+        before_dtype = getattr(x, "dtype", None)
+
+        mono = mono.astype(np.float32, copy=False)
+        rgb = np.stack([mono, mono, mono], axis=-1)
+
+        # metadata: preserve existing, but force "not mono"
+        try:
+            md = dict(getattr(doc, "metadata", None) or {})
+        except Exception:
+            md = {}
+
+        md["is_mono"] = False
+        md["color_model"] = "RGB"
+        md["channels"] = 3
+        md["source"] = (md.get("source") or "Edit")
+
+        # If you track op params for history explorer
+        md["__op_params__"] = {
+            "op": "mono_to_rgb",
+            "mode": "triplicate",
+            "from": str(src_desc),
+            "from_shape": tuple(before_shape) if before_shape is not None else None,
+            "to_shape": tuple(rgb.shape),
+        }
+
+        # name for logging
+        try:
+            name = getattr(doc, "display_name", lambda: None)() or getattr(doc, "name", "") or "Active"
+        except Exception:
+            name = "Active"
+
+        try:
+            dm.update_active_document(
+                rgb,
+                metadata=md,
+                step_name="Mono → RGB",
+                doc=doc,  # explicit is safer
+            )
+
+            if hasattr(self, "_log"):
+                self._log(
+                    f"Mono → RGB: '{name}' converted {src_desc} "
+                    f"(shape={before_shape}, dtype={before_dtype}) → "
+                    f"RGB (shape={rgb.shape}, dtype={rgb.dtype})."
+                )
+
+        except Exception:
+            import traceback
+            try:
+                from PyQt6.QtWidgets import QMessageBox
+                QMessageBox.critical(self, "Mono → RGB", traceback.format_exc())
+            except Exception:
+                pass
+
+    def _swap_rb_active(self):
+        """
+        Swap R and B channels in the active RGB document (undoable).
+        Intended for debayer/channel-order mismatches.
+        """
+        dm = getattr(self, "docman", None)
+        if dm is None:
+            return
+
+        try:
+            doc = dm.get_active_document()
+        except Exception:
+            doc = None
+        if doc is None:
+            return
+
+        img = getattr(doc, "image", None)
+        if img is None:
+            return
+
+        import numpy as np
+        x = np.asarray(img)
+
+        # Must be RGB
+        if not (x.ndim == 3 and x.shape[-1] == 3):
+            try:
+                name = getattr(doc, "display_name", lambda: None)() or getattr(doc, "name", "") or "Active"
+            except Exception:
+                name = "Active"
+
+            if hasattr(self, "_log"):
+                self._log(f"Swap R/B: '{name}' is not RGB (shape={getattr(x,'shape',None)}).")
+            return
+
+        before_shape = x.shape
+        before_dtype = x.dtype
+
+        # swap channels without changing dtype
+        # (copy is safest so we don't mutate shared views)
+        out = x.copy()
+        out[..., 0], out[..., 2] = x[..., 2], x[..., 0]
+
+        # metadata: preserve existing, but annotate operation
+        try:
+            md = dict(getattr(doc, "metadata", None) or {})
+        except Exception:
+            md = {}
+
+        md["color_model"] = md.get("color_model", "RGB")
+        md["channels"] = 3
+        md["is_mono"] = False
+        md["source"] = (md.get("source") or "Edit")
+
+        # If you track op params for history explorer
+        md["__op_params__"] = {
+            "op": "swap_rb",
+            "from_shape": tuple(before_shape),
+            "to_shape": tuple(out.shape),
+            "dtype": str(before_dtype),
+        }
+
+        try:
+            name = getattr(doc, "display_name", lambda: None)() or getattr(doc, "name", "") or "Active"
+        except Exception:
+            name = "Active"
+
+        try:
+            dm.update_active_document(
+                out,
+                metadata=md,
+                step_name="Swap R ↔ B",
+                doc=doc,
+            )
+
+            if hasattr(self, "_log"):
+                self._log(
+                    f"Swap R/B: '{name}' swapped channels "
+                    f"(shape={before_shape}, dtype={before_dtype})."
+                )
+
+        except Exception:
+            import traceback
+            try:
+                from PyQt6.QtWidgets import QMessageBox
+                QMessageBox.critical(self, "Swap R/B", traceback.format_exc())
+            except Exception:
+                pass
+
+
     def _on_stackingsuite_relaunch(self, old_dir: str, new_dir: str):
         # Optional: respond to dialog's relaunch request
         try:
@@ -4282,9 +4619,16 @@ class AstroSuiteProMainWindow(
         # Create a callback to set the image back to the document
         def set_image_callback(image_data, step_name):
             """Apply the result image back to the active document."""
-            if active_doc and hasattr(active_doc, "set_image"):
+            if active_doc and hasattr(active_doc, "apply_edit"):
                 print(f"[AstroSpike] Setting image back to document, shape: {image_data.shape}")
-                # Pass metadata as empty dict and step_name separately
+                # Use apply_edit for proper undo/redo integration
+                meta = {
+                    "step_name": step_name,
+                    "astrospike": True
+                }
+                active_doc.apply_edit(image_data.astype(np.float32, copy=False), metadata=meta, step_name=step_name)
+            elif active_doc and hasattr(active_doc, "set_image"):
+                print(f"[AstroSpike] Setting image via set_image, shape: {image_data.shape}")
                 active_doc.set_image(image_data, metadata={}, step_name=step_name)
             elif active_doc and hasattr(active_doc, "image"):
                 print(f"[AstroSpike] Setting image directly, shape: {image_data.shape}")
@@ -4469,6 +4813,48 @@ class AstroSuiteProMainWindow(
         dlg.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose, True)
         dlg.show()
 
+    def _open_acv_exporter(self):
+        from setiastro.saspro.acv_exporter import AstroCatalogueViewerExporterDialog
+
+        dm = getattr(self, "doc_manager", None) or getattr(self, "docman", None)
+        if dm is None:
+            QMessageBox.information(self, "Astro Catalogue Viewer Exporter", "No document manager available.")
+            return
+
+        sw = self.mdi.activeSubWindow()
+        if not sw:
+            QMessageBox.information(self, "Astro Catalogue Viewer Exporter", "Open an image first.")
+            return
+
+        view = sw.widget()
+        active_doc = None
+
+        # Prefer ROI-aware resolution
+        try:
+            if hasattr(dm, "get_document_for_view"):
+                active_doc = dm.get_document_for_view(view)
+        except Exception:
+            active_doc = None
+
+        # Fallback
+        if active_doc is None:
+            try:
+                active_doc = getattr(view, "document", None)
+            except Exception:
+                active_doc = None
+
+        if active_doc is None or getattr(active_doc, "image", None) is None:
+            QMessageBox.information(self, "Astro Catalogue Viewer Exporter", "No active image.")
+            return
+
+        dlg = AstroCatalogueViewerExporterDialog(self, dm, active_doc)
+        try:
+            dlg.setWindowIcon(QIcon(acv_icon_path))
+        except Exception:
+            pass
+        dlg.show()
+
+
     def _open_linear_fit(self):
         from setiastro.saspro.linear_fit import LinearFitDialog
         dm = getattr(self, "doc_manager", None) or getattr(self, "docman", None)
@@ -4585,12 +4971,6 @@ class AstroSuiteProMainWindow(
         if max_len and len(hist) > max_len:
             del hist[:-max_len]
 
-        # Logging as before
-        try:
-            self._log(f"[Replay] Last action stored: {desc} (command_id={command_id})")
-        except Exception:
-            print(f"[Replay] Last action stored: {desc} (command_id={command_id})")
-
 
 
     def _remember_last_headless_command(self, command_id: str, preset: dict | None = None, description: str = ""):
@@ -4646,17 +5026,6 @@ class AstroSuiteProMainWindow(
         """
         payload = getattr(self, "_last_headless_command", None)
 
-        # DEBUG
-        try:
-            self._log(
-                f"[Replay] replay_last_action_on_subwindow: payload={bool(payload)}, "
-                f"target_sw={id(target_sw) if target_sw else None}"
-            )
-        except Exception:
-            print(
-                f"[Replay] replay_last_action_on_subwindow: payload={bool(payload)}, "
-                f"target_sw={id(target_sw) if target_sw else None}"
-            )
 
         if not payload:
             QMessageBox.information(
@@ -4688,17 +5057,6 @@ class AstroSuiteProMainWindow(
         """
         payload = getattr(self, "_last_headless_command", None) or {}
 
-        # DEBUG
-        try:
-            self._log(
-                f"[Replay] replay_last_action_on_base: payload={bool(payload)}, "
-                f"target_sw={id(target_sw) if target_sw else None}"
-            )
-        except Exception:
-            print(
-                f"[Replay] replay_last_action_on_base: payload={bool(payload)}, "
-                f"target_sw={id(target_sw) if target_sw else None}"
-            )
 
         if not payload:
             QMessageBox.information(
@@ -4724,17 +5082,6 @@ class AstroSuiteProMainWindow(
             QMessageBox.information(self, "Replay Last Action", "No base image to apply the action to.")
             return
 
-        # Small debug about which doc we're hitting
-        try:
-            view = target_sw.widget()
-            cur_doc = getattr(view, "document", None)
-            self._log(
-                f"[Replay] base_doc id={id(base_doc)}, "
-                f"view.document id={id(cur_doc)}, "
-                f"same={base_doc is cur_doc}"
-            )
-        except Exception:
-            pass
 
         # ---- Extract cid + preset from payload (support both old + new schemas) ----
         cid_raw = payload.get("command_id")
@@ -7645,12 +7992,33 @@ class AstroSuiteProMainWindow(
                 pass
 
     def _pretty_title(self, doc, *, linked: bool | None = None) -> str:
-        name = getattr(doc, "display_name", lambda: "Untitled")()
-        name = name.replace("[LINK] ", "").strip()
+        md = (getattr(doc, "metadata", {}) or {})
+
+        # ✅ 1) Prefer explicit display_name (what duplicate/rename intends)
+        name = (md.get("display_name") or "").strip()
+
+        # 2) Fallback to file_path (but only if display_name is missing)
+        if not name:
+            fp = (md.get("file_path") or "").strip()
+            if fp:
+                name = os.path.splitext(os.path.basename(fp))[0]
+
+        # 3) Fallback to doc.display_name()
+        if not name:
+            name = getattr(doc, "display_name", lambda: "Untitled")()
+            name = (name or "Untitled").replace("[LINK] ", "").strip()
+
+            # If it looks like a filename, drop extension
+            base, ext = os.path.splitext(name)
+            if ext and len(ext) <= 10:
+                name = base
+
+        # linked marker logic
         if linked is None:
-            linked = hasattr(doc, "_parent_doc")  # ROI proxy -> linked
+            linked = hasattr(doc, "_parent_doc")
         return f"[LINK] {name}" if linked else name
 
+
     def _build_subwindow_title_for_doc(self, doc) -> str:
         """
         Build a unique, human-friendly title for a QMdiSubWindow
@@ -7718,6 +8086,71 @@ class AstroSuiteProMainWindow(
                 return cand
             n += 1
 
+    
+    def _doc_window_title(self, doc) -> str:
+        md = getattr(doc, "metadata", {}) or {}
+
+        t = (md.get("display_name") or "").strip()
+        if not t:
+            try:
+                t = (doc.display_name() or "").strip()
+            except Exception:
+                t = ""
+
+        if not t:
+            fp = (md.get("file_path") or "").strip()
+            if fp:
+                t = os.path.splitext(os.path.basename(fp))[0]   # ✅ strip ext here too
+
+        t = t or "Untitled"
+
+        # strip glyphs etc
+        try:
+            t = _strip_ui_decorations(t)
+        except Exception:
+            pass
+
+        # ✅ ALWAYS strip filename-like extension at the very end
+        t = _strip_filename_ext(t)
+
+        return t
+
+    def _mdi_begin_open_batch(self, mode: str = "cascade"):
+        self._mdi_open_batch += 1
+        self._mdi_place_mode = mode or "cascade"
+        self._mdi_next_pos = None
+
+    def _mdi_end_open_batch(self):
+        self._mdi_open_batch = max(0, self._mdi_open_batch - 1)
+        if self._mdi_open_batch == 0:
+            self._mdi_next_pos = None
+
+    def _mdi_compute_initial_pos(self) -> QPoint:
+        area = (self.mdi.viewport().geometry() if self.mdi.viewport() else self.mdi.contentsRect())
+        # Put first window a bit inset so titlebars don’t clip
+        return QPoint(area.left() + 18, area.top() + 18)
+
+    def _mdi_place_subwindow(self, sw, target_w: int, target_h: int):
+        """Deterministic placement. Uses a stable cursor during batch opens."""
+        vp = self.mdi.viewport()
+        area = vp.geometry() if vp else self.mdi.contentsRect()
+
+        if self._mdi_next_pos is None:
+            self._mdi_next_pos = self._mdi_compute_initial_pos()
+
+        x = self._mdi_next_pos.x()
+        y = self._mdi_next_pos.y()
+
+        # keep inside viewport; reset when we hit edge
+        if (x + target_w > area.right() - 10) or (y + 40 > area.bottom() - 10):
+            x = area.left() + 18
+            y = area.top() + 18
+
+        sw.move(x, y)
+
+        # advance cursor
+        step = int(self._mdi_cascade_step)
+        self._mdi_next_pos = QPoint(x + step, y + step)
 
     def _spawn_subwindow_for(self, doc, *, force_new: bool = False):
         """
@@ -7821,10 +8254,7 @@ class AstroSuiteProMainWindow(
         if replay_sig is not None:
             try:
                 replay_sig.connect(self._on_view_replay_last_requested)
-                try:
-                    self._log(f"[Replay] Connected {sig_name_used} for view id={id(view)}")
-                except Exception:
-                    print(f"[Replay] Connected {sig_name_used} for view id={id(view)}")
+
             except Exception as e:
                 try:
                     self._log(f"[Replay] FAILED to connect {sig_name_used} for view id={id(view)}: {e}")
@@ -7832,7 +8262,8 @@ class AstroSuiteProMainWindow(
                     print(f"[Replay] FAILED to connect {sig_name_used} for view id={id(view)}: {e}")
 
         self._hook_preview_awareness(view)
-        base_title = self._pretty_title(doc, linked=False)
+
+        base_title  = self._doc_window_title(doc)      # ✅ use metadata display_name
         final_title = self._unique_window_title(base_title)
 
         # -- 6) Add subwindow and set chrome
@@ -7856,7 +8287,8 @@ class AstroSuiteProMainWindow(
         # We target ~60% of the viewport height, clamped to sane bounds.
         # -------------------------------------------------------------------------
         vp = self.mdi.viewport()
-        area = vp.rect() if vp else self.mdi.rect()
+        # Use viewport geometry in MDI coordinates (NOT viewport-local rect)
+        area = vp.geometry() if vp else self.mdi.contentsRect()
         
         # Determine aspect ratio
         img_w = img_h = None
@@ -7893,54 +8325,22 @@ class AstroSuiteProMainWindow(
         target_h = max(200, target_h)
 
         sw.resize(target_w, target_h)
-        sw.showNormal()  # CRITICAL: clears any "maximized" flag from previous active window
+        sw.showNormal()  # clears any "maximized" flag from previous active window
 
-        # -------------------------------------------------------------------------
-        # Smart Cascade: Position relative to the *currently active* window
-        # (before we make the new one active).
-        # -------------------------------------------------------------------------
-        new_x, new_y = 0, 0
-        
-        # Get dominant/active window *before* we activate the new one
-        active = self.mdi.activeSubWindow()
-        if active and active.isVisible() and not (active.windowState() & Qt.WindowState.WindowMinimized):
-            # Cascade from the active window
-            geo = active.geometry()
-            new_x = geo.x() + 30
-            new_y = geo.y() + 30
-        else:
-            # Fallback: try to find the "last added" visible window to cascade from
-            # (useful if active is None but windows exist)
-            try:
-                subs = [s for s in self.mdi.subWindowList() if s.isVisible() and s is not sw]
-                if subs:
-                    # simplistic "last created" might be at end of list
-                    last = subs[-1]
-                    geo = last.geometry()
-                    new_x = geo.x() + 30
-                    new_y = geo.y() + 30
+        # Deterministic placement (batch-aware)
+        try:
+            self._mdi_place_subwindow(sw, target_w, target_h)
+        except Exception:
+            # absolute fallback: top-left-ish
+            try:
+                sw.move(area.left() + 18, area.top() + 18)
             except Exception:
                 pass
 
-        # Bounds check: don't let it drift completely off-screen
-        # (allow valid title bar to be visible at least)
-        if (new_x + target_w > area.width() + 50) or (new_y + 50 > area.height()):
-            new_x = 0
-            new_y = 0
-        
-        # Clamp to 0 if negative for some reason
-        new_x = max(0, new_x)
-        new_y = max(0, new_y)
-
-        sw.move(new_x, new_y)
-
-        # ❌ removed the "fill MDI viewport" block - we *don't* want full-monitor first window
-
         # Show / activate
         sw.show()
         sw.raise_()
         self.mdi.setActiveSubWindow(sw)
-        # (no second setWindowTitle() here)
 
         # Optional minimize/restore interceptor
         if hasattr(self, "_minimize_interceptor"):
@@ -8025,6 +8425,11 @@ class AstroSuiteProMainWindow(
         except Exception:
             pass
 
+        try:
+            self._fix_mdi_titlebar_emboss("#dcdcdc" if self._theme_mode()=="dark" else "#f0f0f0")
+        except Exception:
+            pass
+
         # -- 11) If this is the first window and it's an image, mimic "Cascade Views"
         try:
             if first_window and not is_table:
@@ -8119,25 +8524,57 @@ class AstroSuiteProMainWindow(
             "autostretch_target": float(getattr(source_view, "autostretch_target", 0.25)),
         }
 
-        # 2) New name (strip UI decorations if any)
-        base_name = ""
+        # 2) New name (normalized: NO decorators like 🔗■●◆▲▪▫•◼◻◾◽)
         try:
-            base_name = base_doc.display_name() or "Untitled"
+            base_name = self._doc_window_title(base_doc)  # might include decorations
         except Exception:
             base_name = "Untitled"
 
+        # Normalize it so uniqueness checks don't miss decorated titles
         try:
-            base_name = _strip_ui_decorations(base_name)
+            base_name = normalize_doc_title(base_name)
+        except Exception:
+            base_name = (base_name or "Untitled").strip()
+
+        # Build a set of existing document names (normalized)
+        existing = set()
+        try:
+            dm = getattr(self, "doc_manager", None) or getattr(self, "docman", None)
+            docs = []
+
+            # Prefer an official accessor if you have one
+            if dm is not None:
+                if hasattr(dm, "documents"):
+                    docs = list(dm.documents())
+                elif hasattr(dm, "_docs"):
+                    docs = list(dm._docs)
+
+            for d in docs:
+                try:
+                    dn = ""
+                    md = getattr(d, "metadata", {}) or {}
+                    dn = (md.get("display_name") or "").strip() or (d.display_name() or "").strip()
+                    dn = normalize_doc_title(dn)
+                    if dn:
+                        existing.add(dn)
+                except Exception:
+                    pass
         except Exception:
-            # minimal fallback: remove our known prefix/glyphs
-            while len(base_name) >= 2 and base_name[1] == " " and base_name[0] in "â- â--â--†â-²â-ªâ-«â€¢â--¼â--»â--¾â--½":
-                base_name = base_name[2:]
-            if base_name.startswith("Active View: "):
-                base_name = base_name[len("Active View: "):]
+            pass
+
+        # Pick a unique duplicate name: base_duplicate, base_duplicate2, ...
+        candidate = f"{base_name}_duplicate"
+        if candidate in existing:
+            n = 2
+            while True:
+                cand = f"{base_name}_duplicate{n}"
+                if cand not in existing:
+                    candidate = cand
+                    break
+                n += 1
 
         # 3) Duplicate the *base* document (not the ROI proxy)
-        #    NOTE: your project uses `self.docman` elsewhere for duplication.
-        new_doc = self.docman.duplicate_document(base_doc, new_name=f"{base_name}_duplicate")
+        new_doc = self.docman.duplicate_document(base_doc, new_name=candidate)
         print(f"  Duplicated document ID {id(base_doc)} -> {id(new_doc)}")
 
         # 4) Ensure the duplicate starts mask-free (so we don't inherit mask UI state)
@@ -8287,26 +8724,21 @@ class AstroSuiteProMainWindow(
 
 
     def _activate_or_open_from_explorer(self, item):
-        doc = item.data(Qt.ItemDataRole.UserRole)
-        base = self._normalize_base_doc(doc)
-
-        # 1) Try to focus an existing view for this base
-        for sw in self.mdi.subWindowList():
-            w = sw.widget()
-            if getattr(w, "base_document", None) is base:
-                try:
-                    sw.show(); w.show()
-                    st = sw.windowState()
-                    if st & Qt.WindowState.WindowMinimized:
-                        sw.setWindowState(st & ~Qt.WindowState.WindowMinimized)
-                    self.mdi.setActiveSubWindow(sw)
-                    sw.raise_()
-                except Exception:
-                    pass
-                return
-
-        # 2) None exists -> open one
-        self._open_subwindow_for_added_doc(base)
+        doc = item.data(0, Qt.ItemDataRole.UserRole)
+        if doc is None:
+            return
+        # you already have logic for this; typically:
+        sw = self._find_subwindow_for_doc(doc)
+        if sw:
+            self.mdi.setActiveSubWindow(sw)
+            sw.show()
+            sw.raise_()
+            return
+        # else open it (if your app supports opening closed docs, otherwise no-op)
+        try:
+            self._open_subwindow_for_added_doc(doc)
+        except Exception:
+            pass
 
     def _set_linked_stretch_from_action(self, checked: bool):
         # persist as the default for *new* views
@@ -8432,7 +8864,10 @@ class AstroSuiteProMainWindow(
             self._refresh_mask_action_states()
         except Exception:
             pass
-
+        try:
+            self._fix_mdi_titlebar_emboss("#dcdcdc" if self._theme_mode()=="dark" else "#f0f0f0")
+        except Exception:
+            pass
 
     def _sync_docman_active(self, doc):
         dm = self.doc_manager
@@ -8686,6 +9121,13 @@ class AstroSuiteProMainWindow(
 
         super().keyPressEvent(event)
 
+    def _open_texture_clarity(self):
+        try:
+            from setiastro.saspro.texture_clarity import open_texture_clarity_dialog
+            open_texture_clarity_dialog(self)
+        except Exception as e:
+            print(f"Error opening Texture & Clarity: {e}")
+
     def _update_usage_stats(self):
         try:
             now = time.time()