ms-components 0.3.4__tar.gz → 0.3.5__tar.gz

{ms_components-0.3.4/src/ms_components.egg-info → ms_components-0.3.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ms_components
-Version: 0.3.4
+Version: 0.3.5
 Summary: PySide6 UI components for MolSuite: smart table, project browser, job monitor, PyMOL dock, steppers.
 Author: Mario S. Valdés-Tresanco, Mario E. Valdés-Tresanco
 License-Expression: MIT

{ms_components-0.3.4 → ms_components-0.3.5}/docs/index.md

@@ -21,7 +21,7 @@ pip install ms_components
 | `ms_components.ms_table` | Declarative, paginated table over SQLModel |
 | `ms_components.ms_monitor` | Job monitor for an `ms_flow` workspace: cancel, resume, move |
 | `ms_components.ms_executors` | Hosts and executors: Settings pages and the panel that starts them |
-| `ms_components.ms_projects` | Project browser and project menu |
+| [`ms_components.ms_projects`](project_form_events.md) | Project browser, project menu, and form lifecycle events |
 | `ms_components.ms_settings` | Typed editor for application settings |
 | `ms_components.ms_pymol` | PyMOL dock and control bar |
 | `ms_components.ms_stepper` | Step-by-step wizard widget |

{ms_components-0.3.4 → ms_components-0.3.5}/docs/ms_tutorial.md

@@ -90,6 +90,14 @@ window.tutorials.start(overview)
   without resetting application data. Multiple queued copies of an old event do
   not complete a later step, even if both steps use the same signal.
 
+For asynchronous operations that may finish while the user has gone Back, supply
+`TutorialEvent(signal, accept=..., is_complete=lambda: cached_result_is_ready)`.
+The controller checks `is_complete` when entering an unfinished step and advances
+if it returns true. The application records successful completion before emitting
+its signal; the callback reads that state, without blocking or querying a database.
+`accept` validates incoming signal arguments; `is_complete` independently checks
+the operation and result that the step requires.
+
 `TutorialEvent.signal` also accepts a zero-argument resolver for signals belonging
 to dialogs or controls that are recreated. It is resolved when entering the step.
 
@@ -118,6 +126,18 @@ the application automatically. Hidden targets temporarily hide the overlay; an
 initial hidden target without an existing overlay fails with a diagnostic. Missing
 or deleted targets and callback failures stop the tour and emit `failed`.
 
+Call the public `controller.refresh()` after an application UI change when the
+spotlight should update immediately. Normal tracking continues automatically.
+Accepting a host `QDialog` preserves the tutorial so its target can move back to
+the parent window; closing or rejecting the host still cancels the tutorial.
+
+`TutorialController(dim_background=False)` preserves the application's background
+colors and draws only the target outline. Input gating remains the same.
+`instruction_provider=lambda step: current_instruction` supplies dynamic plain-text
+instructions. They are measured again only when their text changes, without
+resetting the reader's scroll position on every tracking tick. These options do not
+depend on any application or project package.
+
 Lifecycle signals:
 
 | Signal | Arguments |

ms_components-0.3.5/docs/project_form_events.md

@@ -0,0 +1,17 @@
+# Project form events
+
+`ProjectsMenuWidget` and `ProjectBrowserPanel` emit
+`project_form_opened(ProjectFormDialog)` before entering a create/edit form's modal
+loop. The form's `mode` is `"create"` or `"edit"`. Hosts can bind controls and
+observe the normal `accepted`, `rejected`, and `finished` Qt signals without
+searching the browser's widget tree or replacing its actions.
+
+`ProjectFormDialog` is exported from `ms_components.ms_projects`. Its public
+controls include `name_input`, `path_input`, `path_row`, `browse_button`, and
+`save_button`. `name_committed(str)` emits the trimmed name when editing finishes.
+`path_selected(str)` emits only when Browse confirms a folder, including selecting
+the current folder again. Cancelling the chooser emits no selection event.
+
+`project_created(project_id)` means that project creation succeeded. It remains
+separate from opening the form or accepting its fields, which may still be followed
+by a backend error. None of these APIs depend on `ms_tutorial` or a host application.

ms_components-0.3.5/src/ms_components/ms_projects/__init__.py

@@ -0,0 +1,4 @@
+from .browser import ProjectBrowserPanel, ProjectBrowserWindow, ProjectFormDialog
+from .widget import ProjectsMenuWidget
+
+__all__ = ["ProjectBrowserPanel", "ProjectBrowserWindow", "ProjectFormDialog", "ProjectsMenuWidget"]

{ms_components-0.3.4 → ms_components-0.3.5}/src/ms_components/ms_projects/browser.py

@@ -988,6 +988,9 @@ class StatsDialog(QDialog):
 
 
 class ProjectFormDialog(QDialog):
+    name_committed = Signal(str)
+    path_selected = Signal(str)
+
     def __init__(self, *, apps: list, mode: str,
                  initial_data: dict | None = None,
                  allow_app_selection: bool = True, parent=None):
@@ -1005,6 +1008,7 @@ class ProjectFormDialog(QDialog):
         layout = QVBoxLayout(self)
         form = QFormLayout()
         self.name_input        = QLineEdit(self.initial_data.get("name", ""))
+        self.name_input.editingFinished.connect(lambda: self.name_committed.emit(self.name_input.text().strip()))
         self.path_input        = QLineEdit(str(self.initial_data.get("path", "")))
         self.path_input.setReadOnly(True)
         self.description_input = QTextEdit(self.initial_data.get("description", ""))
@@ -1022,11 +1026,11 @@ class ProjectFormDialog(QDialog):
             idx = self.app_combo.findData(cid)
             if idx >= 0: self.app_combo.setCurrentIndex(idx)
         self.app_combo.setEnabled(self.allow_app_selection and not is_edit)
-        path_row = QWidget()
+        path_row = self.path_row = QWidget()
         pl = QHBoxLayout(path_row)
         pl.setContentsMargins(0,0,0,0)
         pl.addWidget(self.path_input)
-        browse_btn = QPushButton("Browse...")
+        browse_btn = self.browse_button = QPushButton("Browse...")
         browse_btn.clicked.connect(self._on_browse)
         browse_btn.setEnabled(not is_edit)
         pl.addWidget(browse_btn)
@@ -1037,6 +1041,7 @@ class ProjectFormDialog(QDialog):
         form.addRow("Description:", self.description_input)
         layout.addLayout(form)
         btns = QDialogButtonBox(QDialogButtonBox.Save | QDialogButtonBox.Cancel)
+        self.save_button = btns.button(QDialogButtonBox.Save)
         btns.accepted.connect(self.accept)
         btns.rejected.connect(self.reject)
         layout.addWidget(btns)
@@ -1045,7 +1050,9 @@ class ProjectFormDialog(QDialog):
         folder = QFileDialog.getExistingDirectory(
             self, "Select folder",
             self.path_input.text().strip() or str(Path.home()))
-        if folder: self.path_input.setText(folder)
+        if folder:
+            self.path_input.setText(folder)
+            self.path_selected.emit(folder)
 
     def accept(self):
         if not self.name_input.text().strip():
@@ -1091,6 +1098,7 @@ class StatTile(QFrame):
 class ProjectBrowserPanel(QWidget):
     project_requested = Signal(str)
     project_created   = Signal(str)
+    project_form_opened = Signal(object)
     projects_changed  = Signal()
 
     def __init__(self, *, app_id: str | None = None, header_title: str,
@@ -1288,6 +1296,7 @@ class ProjectBrowserPanel(QWidget):
                           "description": raw.description, "tags": raw.tags,
                           "app_id": raw.app_id},
             allow_app_selection=self._dialog_allows_app_selection(), parent=self)
+        self.project_form_opened.emit(dlg)
         if dlg.exec() != QDialog.Accepted:
             return
         data = dlg.get_data()
@@ -1355,6 +1364,7 @@ class ProjectBrowserPanel(QWidget):
             initial_data={"path": str(Path.home()/"molsuite_projects"),
                           "app_id": self._active_tool_app_id or apps[0].app_id},
             allow_app_selection=self._dialog_allows_app_selection(), parent=self)
+        self.project_form_opened.emit(dlg)
         if dlg.exec() != QDialog.Accepted:
             return
         fd = dlg.get_data()

{ms_components-0.3.4 → ms_components-0.3.5}/src/ms_components/ms_projects/widget.py

@@ -38,6 +38,7 @@ def _project_color(index: int) -> str:
 class ProjectsMenuWidget(QFrame):
     project_requested = Signal(str)
     project_created = Signal(str)
+    project_form_opened = Signal(object)
     # The host app's open project was confirmed for deletion: the host closes it, then deletes it.
     active_project_delete_requested = Signal(str)
 
@@ -173,6 +174,7 @@ class ProjectsMenuWidget(QFrame):
             allow_app_selection=self.allow_app_selection,
             parent=self,
         )
+        self.project_form_opened.emit(dialog)
         if dialog.exec() != ProjectFormDialog.Accepted:
             return
         data = dialog.get_data()
@@ -224,6 +226,7 @@ class ProjectsMenuWidget(QFrame):
             allow_app_selection=False,
             parent=self,
         )
+        self.project_form_opened.emit(dialog)
         if dialog.exec() != ProjectFormDialog.Accepted:
             return
         data = dialog.get_data()

{ms_components-0.3.4 → ms_components-0.3.5}/src/ms_components/ms_table/__init__.py

@@ -40,9 +40,11 @@ from .table_config import (
     DEFAULT_PAGE_SIZES,
 )
 from .table_model import SmartTableModel
+from .table_interaction import TableInteraction
 
 __all__ = [
     "SmartTableView",
+    "TableInteraction",
     "SessionProvider",
     "TableConfig",
     "ToolbarAction",

{ms_components-0.3.4 → ms_components-0.3.5}/src/ms_components/ms_table/smart_table_view.py

@@ -65,7 +65,8 @@ from .pagination_control import PaginationControl
 from .query_builder import QueryBuilder
 from .session_provider import SessionProvider
 from .table_config import ColumnDef, ColumnKind, FilterOperator, FilterSpec, SortSpec, TableConfig, TableLoadMode, ToolbarAction
-from .table_model import RAW_OBJECT_ROLE, SmartTableModel
+from .table_model import COLUMN_DEF_ROLE, RAW_OBJECT_ROLE, SmartTableModel
+from .table_interaction import TableInteraction
 
 _TOOLBAR_ICONS = Path(__file__).parent / "icons"
 
@@ -93,7 +94,10 @@ class SmartTableView(QWidget):
     Smart table with pagination, filtering, sorting and column configuration.
 
     Signals:
+        cell_pressed(object, str, Qt.KeyboardModifiers):
+            (raw_obj, field, modifiers) before a left press changes the selection.
         row_clicked(object):          SQLModel object for the clicked row.
+        row_reselected(object):       An already selected row was clicked again.
         row_double_clicked(object):   SQLModel object for the double-clicked row.
         selection_changed(list):      List of selected objects.
         edit_committed(object, str, object):
@@ -101,7 +105,9 @@ class SmartTableView(QWidget):
         data_refreshed(int):          Total item count after each load.
     """
 
+    cell_pressed        = Signal(object, str, Qt.KeyboardModifiers)
     row_clicked         = Signal(object)
+    row_reselected      = Signal(object)
     row_double_clicked  = Signal(object)
     selection_changed   = Signal(list)
     edit_committed      = Signal(object, str, object)
@@ -321,6 +327,9 @@ class SmartTableView(QWidget):
         # ── Table View ───────────────────────
         self._table = QTableView()
         self._table.setModel(self._model)
+        self._input = TableInteraction(self._table)
+        self._input.pressed.connect(self._on_cell_pressed)
+        self._input.reselected.connect(lambda _view, index, _mods: self.row_reselected.emit(index.data(RAW_OBJECT_ROLE)))
         self._table.setObjectName("SmartTable")
 
         sel_mode = (QAbstractItemView.ExtendedSelection
@@ -746,6 +755,11 @@ class SmartTableView(QWidget):
         self._refresh_persistent_widgets()
         self._schedule_infinite_autofill()
 
+    def _on_cell_pressed(self, _view, index, modifiers):
+        raw, column = index.data(RAW_OBJECT_ROLE), index.data(COLUMN_DEF_ROLE)
+        if raw is not None and column is not None:
+            self.cell_pressed.emit(raw, column.field, modifiers)
+
     def _on_row_clicked(self, index):
         raw = self._model.data(index, RAW_OBJECT_ROLE)
         if raw is not None:

ms_components-0.3.5/src/ms_components/ms_table/table_interaction.py

@@ -0,0 +1,42 @@
+"""Table input signals, independent of any viewer or data model."""
+
+from PySide6.QtCore import QEvent, QObject, Qt, Signal
+from PySide6.QtWidgets import QAbstractItemView, QApplication, QWidget
+
+
+class TableInteraction(QObject):
+    """Observe one Qt table or the tables under a window, including tables added later.
+
+    ``pressed(view, index, modifiers)`` precedes native selection changes;
+    ``reselected`` reports a click on an already selected cell.
+    """
+
+    pressed = Signal(object, object, Qt.KeyboardModifiers)
+    reselected = Signal(object, object, Qt.KeyboardModifiers)
+
+    def __init__(self, parent: QWidget):
+        super().__init__(parent)
+        self._pressed = None
+        if isinstance(parent, QAbstractItemView):
+            parent.viewport().installEventFilter(self)
+        else:
+            QApplication.instance().installEventFilter(self)
+
+    def eventFilter(self, watched, event):
+        if (event.type() == QEvent.Type.MouseButtonPress
+                and event.button() == Qt.MouseButton.LeftButton
+                and isinstance(watched, QWidget)):
+            view = watched.parentWidget()
+            if (isinstance(view, QAbstractItemView) and watched is view.viewport()
+                    and (view is self.parent() or self.parent().isAncestorOf(view))):
+                index = view.indexAt(event.position().toPoint())
+                if index.isValid():
+                    self._pressed = (view, index, event.modifiers(), view.selectionModel().isSelected(index))
+                    self.pressed.emit(view, index, event.modifiers())
+        elif event.type() == QEvent.Type.MouseButtonRelease and self._pressed is not None:
+            view, index, modifiers, was_selected = self._pressed
+            self._pressed = None
+            if (event.button() == Qt.MouseButton.LeftButton and watched is view.viewport()
+                    and was_selected and view.indexAt(event.position().toPoint()) == index):
+                self.reselected.emit(view, index, modifiers)
+        return super().eventFilter(watched, event)

{ms_components-0.3.4 → ms_components-0.3.5}/src/ms_components/ms_tutorial/bindings.py

@@ -19,3 +19,4 @@ class TutorialTarget:
 class TutorialEvent:
     signal: SignalInstance | Callable[[], SignalInstance]
     accept: Callable[..., bool] | None = None
+    is_complete: Callable[[], bool] | None = None

{ms_components-0.3.4 → ms_components-0.3.5}/src/ms_components/ms_tutorial/controller.py

@@ -1,11 +1,11 @@
 """Attach a tour to existing widgets/signals without changing their slots."""
 from __future__ import annotations
 
-from collections.abc import Mapping
+from collections.abc import Callable, Mapping
 import weakref
 
 from PySide6.QtCore import QEvent, QObject, Qt, QTimer, Signal, SignalInstance, Slot
-from PySide6.QtWidgets import QApplication, QWidget
+from PySide6.QtWidgets import QApplication, QDialog, QWidget
 from shiboken6 import isValid
 
 from .bindings import TutorialEvent, TutorialTarget
@@ -54,10 +54,14 @@ class TutorialController(QObject):
 
     def __init__(self, *, targets: Mapping[str, TutorialTarget],
                  events: Mapping[str, TutorialEvent] | None = None,
+                 instruction_provider: Callable[[TutorialStep], str] | None = None,
+                 dim_background: bool = True,
                  parent: QObject | None = None):
         super().__init__(parent)
         self.targets = dict(targets)
         self.events = dict(events or {})
+        self.instruction_provider = instruction_provider
+        self.dim_background = dim_background
         self._tutorial: Tutorial | None = None
         self._index = -1
         self._completed: set[str] = set()
@@ -67,7 +71,7 @@ class TutorialController(QObject):
         self._previous_focus = None
         self._tracker = QTimer(self)
         self._tracker.setInterval(80)
-        self._tracker.timeout.connect(self._refresh)
+        self._tracker.timeout.connect(self.refresh)
 
     @property
     def is_active(self) -> bool:
@@ -170,7 +174,7 @@ class TutorialController(QObject):
             # overlay (and comes back). Otherwise the tour would stay active, unseen, eating Escape.
             if isinstance(target, QWidget) and isValid(target) and not target.isVisible():
                 raise ValueError(f"Target '{step.target}' is hidden; provide a prepare callback")
-            self._refresh()
+            self.refresh()
             if not self.is_active:
                 return
             if step.advance_on is not None:
@@ -181,12 +185,18 @@ class TutorialController(QObject):
                     self._target.setFocus()
                 else:
                     self.overlay.focus_guide()
+            if step.advance_on is not None and step.id not in self._completed:
+                check = self.events[step.advance_on].is_complete
+                if check is not None and check():
+                    self._completed.add(step.id)
+                    self.next()
         except Exception as exc:
             if self.is_active:
                 self._fail(f"Cannot show tutorial step '{step.id}': {exc}")
 
     @Slot()
-    def _refresh(self):
+    def refresh(self):
+        """Resolve the current target and instructions after an application UI change."""
         step = self.current_step
         if step is None:
             return
@@ -207,13 +217,15 @@ class TutorialController(QObject):
                 if self.overlay is not None:
                     self.overlay.hide()
                     self.overlay.deleteLater()
-                self._overlay = TutorialOverlay(host)
+                self._overlay = TutorialOverlay(host, dim_background=self.dim_background)
                 self._overlay.next_requested.connect(self.next)
                 self._overlay.back_requested.connect(self.back)
                 self._overlay.exit_requested.connect(self.stop)
                 self.destroyed.connect(self._overlay.deleteLater)
             if self.overlay.step is not step:
                 self.overlay.set_step(self._tutorial.title, step, self._index, len(self._tutorial.steps))
+            if self.instruction_provider is not None:
+                self.overlay.set_text(self.instruction_provider(step))
             self.overlay.next_button.setEnabled(step.advance_on is None or step.id in self._completed)
             region = self.targets[step.target].rect
             self.overlay.reposition(target, interactive=step.advance_on is not None,
@@ -233,6 +245,14 @@ class TutorialController(QObject):
         self._completed.add(self.current_step.id)
         self.next()
 
+    @Slot(int)
+    def _on_dialog_finished(self, result: int):
+        if self.is_active:
+            if result == QDialog.DialogCode.Accepted:
+                self.refresh()
+            else:
+                self.stop()
+
     def eventFilter(self, watched: QObject, event: QEvent) -> bool:
         if not self.is_active or not isinstance(watched, QWidget) or self.overlay is None:
             return False
@@ -242,6 +262,10 @@ class TutorialController(QObject):
             self.stop()
             return True
         if event.type() == QEvent.Type.Close and watched is self.overlay.parentWidget():
+            if isinstance(watched, QDialog):
+                self.overlay.hide()
+                watched.finished.connect(self._on_dialog_finished, Qt.ConnectionType.SingleShotConnection)
+                return False
             self.stop()
             return False
         if not self.overlay.isVisible():

{ms_components-0.3.4 → ms_components-0.3.5}/src/ms_components/ms_tutorial/overlay.py

@@ -19,8 +19,9 @@ class TutorialOverlay(QWidget):
     back_requested = Signal()
     exit_requested = Signal()
 
-    def __init__(self, host: QWidget):
+    def __init__(self, host: QWidget, *, dim_background: bool = True):
         super().__init__(host)
+        self.dim_background = dim_background
         self.setAttribute(Qt.WidgetAttribute.WA_NoSystemBackground)
         self.hole = QRect()
         self.step: TutorialStep | None = None
@@ -74,6 +75,14 @@ class TutorialOverlay(QWidget):
         self.setAccessibleName(tutorial_title)
         self.setAccessibleDescription(f"{step.title}. {step.text}")
 
+    def set_text(self, text: str):
+        """Update instructions without resetting their layout or scroll position each tick."""
+        if self.body.toPlainText() != text:
+            self.body.setPlainText(text)
+            self._size_key = None
+            self._place_key = None
+            self.setAccessibleDescription(f"{self.step.title}. {text}")
+
     def reposition(self, target: QWidget, *, interactive: bool, rect: QRect | None = None):
         host = self.parentWidget()
         self.setGeometry(host.rect())
@@ -143,12 +152,13 @@ class TutorialOverlay(QWidget):
     def paintEvent(self, event):
         painter = QPainter(self)
         painter.setRenderHint(QPainter.RenderHint.Antialiasing)
-        shade = self.palette().color(QPalette.ColorRole.Shadow)
-        shade.setAlpha(170)
-        path = QPainterPath()
-        path.addRect(QRectF(self.rect()))
-        opening = QPainterPath()
-        opening.addRect(QRectF(self.hole))
-        painter.fillPath(path.subtracted(opening), shade)
+        if self.dim_background:
+            shade = self.palette().color(QPalette.ColorRole.Shadow)
+            shade.setAlpha(170)
+            path = QPainterPath()
+            path.addRect(QRectF(self.rect()))
+            opening = QPainterPath()
+            opening.addRect(QRectF(self.hole))
+            painter.fillPath(path.subtracted(opening), shade)
         painter.setPen(QPen(self.palette().color(QPalette.ColorRole.Highlight), 3))
         painter.drawRoundedRect(QRectF(self.hole.adjusted(-3, -3, 3, 3)), 6, 6)

{ms_components-0.3.4 → ms_components-0.3.5/src/ms_components.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ms_components
-Version: 0.3.4
+Version: 0.3.5
 Summary: PySide6 UI components for MolSuite: smart table, project browser, job monitor, PyMOL dock, steppers.
 Author: Mario S. Valdés-Tresanco, Mario E. Valdés-Tresanco
 License-Expression: MIT

{ms_components-0.3.4 → ms_components-0.3.5}/src/ms_components.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ docs/api_reference.md
 docs/examples.md
 docs/index.md
 docs/ms_tutorial.md
+docs/project_form_events.md
 docs/usage.md
 examples/tutorial_demo.py
 examples/tutorial_demo.toml
@@ -86,6 +87,7 @@ src/ms_components/ms_table/session_provider.py
 src/ms_components/ms_table/smart_table_view.py
 src/ms_components/ms_table/sort_panel.py
 src/ms_components/ms_table/table_config.py
+src/ms_components/ms_table/table_interaction.py
 src/ms_components/ms_table/table_model.py
 src/ms_components/ms_table/test_external_filters.py
 src/ms_components/ms_table/test_toolbar.py
@@ -121,6 +123,7 @@ tests/test_query_builder_keyset.py
 tests/test_shift_hscroll.py
 tests/test_split_button_style.py
 tests/test_step_dialog.py
+tests/test_table_interaction.py
 tests/test_table_toolbar.py
 tests/test_table_view_state.py
 tests/test_theme_contrast.py

{ms_components-0.3.4 → ms_components-0.3.5}/src/ms_components.egg-info/scm_file_list.json

@@ -9,6 +9,7 @@
     "docs/examples.md",
     "docs/index.md",
     "docs/ms_tutorial.md",
+    "docs/project_form_events.md",
     "docs/usage.md",
     "examples/tutorial_demo.py",
     "examples/tutorial_demo.toml",
@@ -83,6 +84,7 @@
     "src/ms_components/ms_table/smart_table_view.py",
     "src/ms_components/ms_table/sort_panel.py",
     "src/ms_components/ms_table/table_config.py",
+    "src/ms_components/ms_table/table_interaction.py",
     "src/ms_components/ms_table/table_model.py",
     "src/ms_components/ms_table/test_external_filters.py",
     "src/ms_components/ms_table/test_toolbar.py",
@@ -115,6 +117,7 @@
     "tests/test_shift_hscroll.py",
     "tests/test_split_button_style.py",
     "tests/test_step_dialog.py",
+    "tests/test_table_interaction.py",
     "tests/test_table_toolbar.py",
     "tests/test_table_view_state.py",
     "tests/test_theme_contrast.py",

ms_components-0.3.5/src/ms_components.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "0.3.5",
+  "distance": 0,
+  "node": "gcdd26ba15e13bca1b11b96c6099074cde8ce3c4f",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-10-27"
+}

{ms_components-0.3.4 → ms_components-0.3.5}/tests/test_ms_projects_widget.py

@@ -9,6 +9,51 @@ from PySide6.QtWidgets import QDialog, QMessageBox
 
 from ms_flow.core.apps import AppManifest
 from ms_components.ms_projects import ProjectsMenuWidget
+from ms_components.ms_projects import ProjectFormDialog
+
+
+def test_folder_selection_emits_only_when_confirmed_including_the_same_folder(monkeypatch, tmp_path):
+    QApplication.instance() or QApplication([])
+    backend = _FakeBackend()
+    form = ProjectFormDialog(apps=backend.list_apps(), mode="create",
+                             initial_data={"path": str(tmp_path)})
+    selected, names = [], []
+    form.path_selected.connect(selected.append)
+    form.name_committed.connect(names.append)
+    try:
+        form.name_input.setText("Practice")
+        form.name_input.editingFinished.emit()
+        assert names == ["Practice"]
+        monkeypatch.setattr("ms_components.ms_projects.browser.QFileDialog.getExistingDirectory", lambda *a: "")
+        form.browse_button.click()
+        assert selected == [] and form.path_input.text() == str(tmp_path)
+        monkeypatch.setattr("ms_components.ms_projects.browser.QFileDialog.getExistingDirectory",
+                            lambda *a: str(tmp_path))
+        form.browse_button.click()
+        assert selected == [str(tmp_path)]
+        assert form.path_row.isAncestorOf(form.browse_button)
+        assert form.save_button.text()
+    finally:
+        form.deleteLater()
+
+
+def test_project_form_is_announced_before_its_modal_loop_and_cancel_does_not_create(monkeypatch):
+    QApplication.instance() or QApplication([])
+    widget = ProjectsMenuWidget(app_id="amdockvs", backend=_FakeBackend())
+    opened, created = [], []
+    widget.project_form_opened.connect(opened.append)
+    widget.project_created.connect(created.append)
+
+    def cancel(form):
+        assert opened == [form] and form.mode == "create"
+        return QDialog.Rejected
+
+    monkeypatch.setattr(ProjectFormDialog, "exec", cancel)
+    try:
+        widget.on_create_project()
+        assert len(opened) == 1 and created == []
+    finally:
+        widget.deleteLater()
 
 
 class _FakeBackend:

ms_components-0.3.5/tests/test_table_interaction.py

@@ -0,0 +1,58 @@
+import pytest
+from PySide6.QtCore import QPoint, Qt
+from PySide6.QtTest import QTest
+from PySide6.QtWidgets import QApplication
+from sqlmodel import Field, SQLModel
+
+from ms_components.ms_table import ColumnDef, SmartTableView, TableConfig
+
+
+class _InteractionRow(SQLModel, table=True):
+    id: int = Field(primary_key=True)
+
+
+@pytest.fixture
+def table(monkeypatch):
+    app = QApplication.instance() or QApplication(["table-interaction-test"])
+    monkeypatch.setattr(SmartTableView, "refresh", lambda self: None)
+    widget = SmartTableView(
+        db=object(), config=TableConfig(
+            model_class=_InteractionRow, columns=[ColumnDef("id")], show_row_numbers=False))
+    widget._model.load_data([
+        {"id": number, "__raw__": _InteractionRow(id=number)} for number in (1, 2)
+    ], 2, 1)
+    widget.resize(320, 260)
+    widget.show()
+    app.processEvents()
+    yield widget
+    widget.close()
+
+
+@pytest.mark.parametrize("modifiers", [Qt.NoModifier, Qt.ShiftModifier, Qt.ControlModifier])
+def test_cell_pressed_reports_modifiers_before_selection_and_keeps_row_clicked(table, modifiers):
+    events = []
+    table.cell_pressed.connect(lambda obj, field, mods: events.append(
+        ("pressed", obj.id, field, mods, table.get_selected_objects())))
+    table.row_clicked.connect(lambda obj: events.append(("clicked", obj.id)))
+    position = table.view.visualRect(table._model.index(1, 0)).center()
+    QTest.mouseClick(table.view.viewport(), Qt.LeftButton, modifiers, position)
+    assert events == [("pressed", 2, "id", modifiers, []), ("clicked", 2)]
+
+
+def test_empty_space_emits_no_cell_press(table):
+    pressed = []
+    table.cell_pressed.connect(lambda *args: pressed.append(args))
+    QTest.mouseClick(table.view.viewport(), Qt.LeftButton, Qt.NoModifier,
+                     QPoint(10, table.view.viewport().height() - 2))
+    assert pressed == []
+
+
+def test_reselecting_a_row_has_its_own_signal_without_faking_a_selection_change(table):
+    selected, reselected = [], []
+    table.selection_changed.connect(lambda rows: selected.append([row.id for row in rows]))
+    table.row_reselected.connect(lambda row: reselected.append(row.id))
+    position = table.view.visualRect(table._model.index(1, 0)).center()
+    QTest.mouseClick(table.view.viewport(), Qt.LeftButton, Qt.NoModifier, position)
+    QTest.mouseClick(table.view.viewport(), Qt.LeftButton, Qt.NoModifier, position)
+    assert selected == [[2]]
+    assert reselected == [2]

{ms_components-0.3.4 → ms_components-0.3.5}/tests/test_tutorial.py

@@ -100,6 +100,82 @@ class Emitter(QObject):
     done = Signal(str, str)
 
 
+def test_completion_while_on_another_step_is_checked_on_return(ui):
+    app, window, button, other, controller = ui
+    emitter = Emitter()
+    completed = set()
+    controller.events["job.done"] = TutorialEvent(
+        emitter.done, accept=lambda job, status: job == "expected" and status == "completed",
+        is_complete=lambda: "expected" in completed,
+    )
+    controller.start(Tutorial("jobs", "Jobs", (
+        TutorialStep("first", "run", "Input", "Review input."),
+        TutorialStep("job", "run", "Run", "Wait.", "job.done"),
+        TutorialStep("last", "other", "Output", "Review output."),
+    )))
+    controller.next()
+    assert controller.index == 1 and not controller.overlay.next_button.isEnabled()
+    controller.back()
+    completed.add("expected")
+    emitter.done.emit("expected", "completed")
+    app.processEvents()
+    assert controller.index == 0
+    controller.next()
+    assert controller.index == 2
+    controller.back()
+    assert controller.index == 1 and controller.overlay.next_button.isEnabled()
+
+
+def test_dynamic_instructions_refresh_without_reflowing_unchanged_text(ui):
+    app, window, button, other, controller = ui
+    instructions = ["Wait for the operation."]
+    controller.instruction_provider = lambda step: instructions[0]
+    controller.start(tour())
+    assert controller.overlay.body.toPlainText() == instructions[0]
+    instructions[0] = "The operation is ready. " * 100
+    controller.refresh()
+    assert controller.overlay.body.toPlainText() == instructions[0]
+    assert instructions[0] in controller.overlay.accessibleDescription()
+    controller.overlay.body.verticalScrollBar().setValue(20)
+    controller.refresh()
+    assert controller.overlay.body.verticalScrollBar().value() == 20
+
+
+def test_outline_only_presentation_preserves_the_background(ui):
+    app, window, button, other, controller = ui
+    before = window.grab().toImage()
+    controller.dim_background = False
+    controller.start(tour(interactive=True))
+    overlay = controller.overlay
+    sample = next(QPoint(x, y) for x in range(10, window.width(), 20)
+                  for y in range(10, window.height(), 20)
+                  if not overlay.panel.geometry().contains(x, y)
+                  and not overlay.hole.adjusted(-5, -5, 5, 5).contains(x, y))
+    after = window.grab().toImage()
+    assert after.pixelColor(sample) == before.pixelColor(sample)
+    assert overlay.hole.size() == button.size()
+    assert QApplication.widgetAt(button.mapToGlobal(button.rect().center())) is button
+
+
+def test_accepting_a_dialog_keeps_the_tutorial_active_but_closing_cancels(ui):
+    app, window, button, other, controller = ui
+    dialog = QDialog(window)
+    action = QPushButton("Save", dialog)
+    dialog.show()
+    app.processEvents()
+    controller.targets["dialog"] = TutorialTarget(lambda: action if dialog.isVisible() else button)
+    controller.start(Tutorial("dialog", "Dialog", (
+        TutorialStep("save", "dialog", "Save", "Save the form."),
+    )))
+    dialog.accept()
+    app.processEvents()
+    assert controller.is_active and controller.overlay.parentWidget() is window
+    dialog.show()
+    controller.refresh()
+    dialog.close()
+    assert not controller.is_active
+
+
 def test_job_predicate_runs_in_ui_thread_and_ignores_stale_duplicate_events(ui):
     app, window, button, other, controller = ui
     emitter = Emitter()
@@ -184,13 +260,13 @@ def test_resize_and_long_text_keep_callout_visible_and_scrollable(ui):
     controller.start(definition)
     window.resize(480, 400)
     app.processEvents()
-    controller._refresh()
+    controller.refresh()
     overlay = controller.overlay
     assert overlay.rect().contains(overlay.panel.geometry())
     assert not overlay.panel.geometry().intersects(overlay.hole)
     assert overlay.body.verticalScrollBar().maximum() > 0
     overlay.body.verticalScrollBar().setValue(20)
-    controller._refresh()
+    controller.refresh()
     assert overlay.body.verticalScrollBar().value() == 20
     assert overlay.hole.contains(overlay.mapFromGlobal(button.mapToGlobal(QPoint(2, 2))))
 
@@ -217,7 +293,7 @@ def test_menu_target_region_follows_the_action_geometry(ui):
     previous = controller.overlay.hole
     file_menu.menuAction().setText("Projects and input files")
     app.processEvents()
-    controller._refresh()
+    controller.refresh()
     assert controller.overlay.hole == expected_region()
     assert controller.overlay.hole.left() > previous.left()
 
@@ -263,7 +339,7 @@ def test_deleted_target_and_prepare_errors_fail_with_cleanup(ui):
     controller.start(tour())
     button.deleteLater()
     QCoreApplication.sendPostedEvents(None, QEvent.Type.DeferredDelete)
-    controller._refresh()
+    controller.refresh()
     assert failures and "unavailable" in failures[-1]
     assert not controller.is_active and controller.overlay is None
 

ms_components-0.3.4/src/ms_components/ms_projects/__init__.py

@@ -1,4 +0,0 @@
-from .browser import ProjectBrowserPanel, ProjectBrowserWindow
-from .widget import ProjectsMenuWidget
-
-__all__ = ["ProjectBrowserPanel", "ProjectBrowserWindow", "ProjectsMenuWidget"]

ms_components-0.3.4/src/ms_components.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "0.3.4",
-  "distance": 0,
-  "node": "g005ee17c754e432cd527d9eaf5e3cc9ce26f6412",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-10-25"
-}