py-data-engine 0.1.0__py3-none-any.whl

data_engine/ui/gui/widgets/__init__.py

@@ -0,0 +1,34 @@
+"""View-layer builders for the desktop UI."""
+
+from data_engine.ui.gui.widgets.config import build_config_value, make_label_selectable
+from data_engine.ui.gui.widgets.panels import (
+    build_action_bar,
+    build_center_panel,
+    build_docs_view,
+    build_nav_rail,
+    build_operator_view,
+    build_right_panel,
+    build_settings_view,
+    build_sidebar,
+)
+from data_engine.ui.gui.widgets.sidebar import build_flow_row_widget, build_group_row_widget
+from data_engine.ui.gui.widgets.logs import build_log_run_widget
+from data_engine.ui.gui.widgets.steps import format_operation_title, set_operation_cards
+
+__all__ = [
+    "build_action_bar",
+    "build_center_panel",
+    "build_config_value",
+    "build_docs_view",
+    "build_flow_row_widget",
+    "build_log_run_widget",
+    "build_group_row_widget",
+    "build_nav_rail",
+    "build_operator_view",
+    "build_right_panel",
+    "build_settings_view",
+    "build_sidebar",
+    "format_operation_title",
+    "make_label_selectable",
+    "set_operation_cards",
+]

data_engine/ui/gui/widgets/config.py

@@ -0,0 +1,41 @@
+"""Small config/detail widget helpers for the desktop GUI."""
+
+from __future__ import annotations
+
+from PySide6.QtCore import Qt
+from PySide6.QtWidgets import QFrame, QHBoxLayout, QLabel, QVBoxLayout
+
+
+def make_label_selectable(label: QLabel) -> QLabel:
+    """Enable text selection on one read-only label."""
+    label.setTextInteractionFlags(
+        Qt.TextInteractionFlag.TextSelectableByMouse | Qt.TextInteractionFlag.TextSelectableByKeyboard
+    )
+    return label
+
+
+def build_config_value(layout: QVBoxLayout, label: str) -> QLabel:
+    """Build one two-column config row and return the mutable value label."""
+    row_frame = QFrame()
+    row_frame.setObjectName("configRow")
+    row_layout = QHBoxLayout(row_frame)
+    row_layout.setContentsMargins(0, 6, 0, 6)
+    row_layout.setSpacing(10)
+
+    title = QLabel(label)
+    title.setObjectName("fieldLabel")
+    value = QLabel("-")
+    value.setWordWrap(True)
+    make_label_selectable(value)
+    value.setObjectName("fieldValue")
+    value.setAlignment(Qt.AlignmentFlag.AlignLeft | Qt.AlignmentFlag.AlignTop)
+    title.setMinimumWidth(92)
+    title.setMaximumWidth(92)
+    title.setAlignment(Qt.AlignmentFlag.AlignLeft | Qt.AlignmentFlag.AlignTop)
+    row_layout.addWidget(title, 0)
+    row_layout.addWidget(value, 1)
+    layout.addWidget(row_frame)
+    return value
+
+
+__all__ = ["build_config_value", "make_label_selectable"]

data_engine/ui/gui/widgets/logs.py

@@ -0,0 +1,62 @@
+"""Log-list row builders for the desktop UI."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from PySide6.QtCore import Qt
+from PySide6.QtGui import QPixmap
+from PySide6.QtWidgets import QFrame, QHBoxLayout, QLabel, QPushButton
+
+from data_engine.views import RunGroupDisplay
+
+if TYPE_CHECKING:
+    from data_engine.domain import FlowRunState
+    from data_engine.ui.gui.app import DataEngineWindow
+
+
+def build_log_run_widget(window: "DataEngineWindow", run_group: "FlowRunState") -> QFrame:
+    display = RunGroupDisplay.from_run(run_group)
+    frame = QFrame()
+    frame.setObjectName("logRunRow")
+    frame.setProperty("sourceLabel", display.source_label)
+    layout = QHBoxLayout(frame)
+    layout.setContentsMargins(8, 6, 8, 6)
+    layout.setSpacing(10)
+
+    title_row = QHBoxLayout()
+    title_row.setContentsMargins(0, 0, 0, 0)
+    title_row.setSpacing(8)
+    title = QLabel(display.primary_label)
+    title.setObjectName("logPrimary")
+    title_row.addWidget(title, 0, Qt.AlignmentFlag.AlignLeft | Qt.AlignmentFlag.AlignVCenter)
+    if display.duration_text is not None:
+        duration = QLabel(display.duration_text)
+        duration.setObjectName("logDuration")
+        title_row.addWidget(duration, 0, Qt.AlignmentFlag.AlignLeft | Qt.AlignmentFlag.AlignVCenter)
+    title_row.addStretch(1)
+    layout.addLayout(title_row, 1)
+
+    status_icon = QLabel()
+    status_icon.setObjectName("logStatusIcon")
+    status_icon.setPixmap(
+        window._render_svg_icon_pixmap(
+            window._LOG_ICON_NAMES[display.status_visual_state],
+            16,
+            fill_color=window._LOG_ICON_COLORS[display.status_visual_state],
+        )
+    )
+    status_icon.setToolTip(display.status_text)
+    layout.addWidget(status_icon, 0, Qt.AlignmentFlag.AlignVCenter)
+
+    view_button = QPushButton()
+    view_button.setObjectName("logIconButton")
+    view_button.setIcon(window._log_icon("view_log"))
+    view_button.setIconSize(QPixmap(16, 16).size())
+    view_button.setToolTip("View Log")
+    view_button.clicked.connect(lambda _checked=False, group=run_group: window._show_run_log_preview(group))
+    layout.addWidget(view_button, 0, Qt.AlignmentFlag.AlignVCenter)
+    return frame
+
+
+__all__ = ["build_log_run_widget"]

data_engine/ui/gui/widgets/panels.py

@@ -0,0 +1,507 @@
+"""Panel and top-level view builders for the desktop UI."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from PySide6.QtCore import Qt
+from PySide6.QtGui import QFont, QPixmap
+from PySide6.QtWidgets import (
+    QButtonGroup,
+    QComboBox,
+    QFrame,
+    QHBoxLayout,
+    QLabel,
+    QLineEdit,
+    QListWidget,
+    QPushButton,
+    QScrollArea,
+    QSplitter,
+    QTabWidget,
+    QToolButton,
+    QVBoxLayout,
+    QWidget,
+)
+
+if TYPE_CHECKING:
+    from data_engine.ui.gui.app import DataEngineWindow
+
+
+def build_operator_view(window: "DataEngineWindow") -> QWidget:
+    container = QWidget()
+    layout = QVBoxLayout(container)
+    layout.setContentsMargins(0, 0, 0, 0)
+    layout.setSpacing(10)
+
+    title = QLabel("Flow Control")
+    title.setObjectName("heroTitle")
+    layout.addWidget(title)
+    window.action_bar = build_action_bar(window)
+    layout.addWidget(window.action_bar)
+
+    splitter = QSplitter(Qt.Orientation.Horizontal)
+    splitter.setChildrenCollapsible(False)
+    sidebar = build_sidebar(window)
+    center = build_center_panel(window)
+    right = build_right_panel(window)
+    sidebar.setMinimumWidth(320)
+    right.setMinimumWidth(320)
+    splitter.addWidget(sidebar)
+    splitter.addWidget(center)
+    splitter.addWidget(right)
+    splitter.setStretchFactor(0, 2)
+    splitter.setStretchFactor(1, 4)
+    splitter.setStretchFactor(2, 4)
+    splitter.setSizes([320, 505, 505])
+    layout.addWidget(splitter, 1)
+    return container
+
+
+def build_nav_rail(window: "DataEngineWindow") -> QWidget:
+    panel = QFrame()
+    panel.setObjectName("navRail")
+    panel.setFixedWidth(56)
+    layout = QVBoxLayout(panel)
+    layout.setContentsMargins(6, 6, 6, 6)
+    layout.setSpacing(8)
+
+    window.view_button_group = QButtonGroup(window)
+    window.view_button_group.setExclusive(True)
+
+    window.home_button = _nav_button(window, "home", "Home")
+    window.docs_button = _nav_button(window, "docs", "Docs")
+    window.settings_button = _nav_button(window, "settings", "Settings")
+
+    for index, button in enumerate((window.home_button, window.docs_button, window.settings_button)):
+        window.view_button_group.addButton(button, index)
+        layout.addWidget(button, 0, Qt.AlignmentFlag.AlignTop)
+
+    window.view_button_group.idClicked.connect(window._switch_view)
+    window.home_button.setChecked(True)
+    layout.addStretch(1)
+    return panel
+
+
+def _nav_button(window: "DataEngineWindow", icon_name: str, tooltip: str) -> QToolButton:
+    button = QToolButton()
+    button.setObjectName("navButton")
+    button.setCheckable(True)
+    button.setAutoExclusive(True)
+    button.setProperty("viewIconName", icon_name)
+    button.setIcon(window._view_rail_icon(icon_name))
+    button.setIconSize(QPixmap(18, 18).size())
+    button.setFixedSize(40, 40)
+    button.setToolTip(tooltip)
+    return button
+
+
+def build_docs_view(window: "DataEngineWindow") -> QWidget:
+    container = QWidget()
+    container_layout = QVBoxLayout(container)
+    container_layout.setContentsMargins(0, 0, 0, 0)
+    container_layout.setSpacing(10)
+
+    title = QLabel("Documentation")
+    title.setObjectName("heroTitle")
+    container_layout.addWidget(title)
+
+    panel = QFrame()
+    panel.setObjectName("workspacePanel")
+    layout = QVBoxLayout(panel)
+    layout.setContentsMargins(18, 18, 18, 18)
+    layout.setSpacing(10)
+
+    header = QHBoxLayout()
+    header.setContentsMargins(0, 0, 0, 0)
+    header.setSpacing(8)
+    window.docs_status_label = QLabel("")
+    window.docs_status_label.setObjectName("sectionMeta")
+    header.addWidget(window.docs_status_label, 1)
+
+    window.docs_generate_button = QPushButton("Generate Documentation")
+    window.docs_generate_button.clicked.connect(window._start_docs_build)
+    header.addWidget(window.docs_generate_button)
+    layout.addLayout(header)
+
+    window.docs_browser = window._create_docs_browser()
+    window.docs_browser.setObjectName("docsBrowser")
+    window.docs_browser.setStyleSheet("background: #ffffff;")
+    layout.addWidget(window.docs_browser, 1)
+    container_layout.addWidget(panel, 1)
+    window._initialize_docs_view()
+    return container
+
+
+def build_settings_view(window: "DataEngineWindow") -> QWidget:
+    container = QWidget()
+    container_layout = QVBoxLayout(container)
+    container_layout.setContentsMargins(0, 0, 0, 0)
+    container_layout.setSpacing(10)
+
+    title = QLabel("Settings")
+    title.setObjectName("heroTitle")
+    container_layout.addWidget(title)
+
+    splitter = QSplitter(Qt.Orientation.Horizontal)
+    splitter.setChildrenCollapsible(False)
+    workspace_panel = _build_workspace_settings_panel(window)
+    bootstrap_panel = _build_bootstrap_settings_panel(window)
+    workspace_panel.setMinimumWidth(360)
+    bootstrap_panel.setMinimumWidth(360)
+    splitter.addWidget(workspace_panel)
+    splitter.addWidget(bootstrap_panel)
+    splitter.setStretchFactor(0, 1)
+    splitter.setStretchFactor(1, 1)
+    splitter.setSizes([520, 520])
+
+    container_layout.addWidget(splitter, 1)
+    window._refresh_workspace_root_controls()
+    return container
+
+
+def _build_workspace_settings_panel(window: "DataEngineWindow") -> QWidget:
+    workspace_panel = QFrame()
+    workspace_panel.setObjectName("workspacePanel")
+    workspace_layout = QVBoxLayout(workspace_panel)
+    workspace_layout.setContentsMargins(18, 18, 18, 18)
+    workspace_layout.setSpacing(12)
+
+    workspace_title = QLabel("Workspace Folder")
+    workspace_title.setObjectName("sectionTitle")
+    workspace_layout.addWidget(workspace_title)
+
+    workspace_intro = QLabel(
+        "Choose the folder on this workstation that contains your workspaces. "
+        "Selecting a folder updates the app immediately."
+    )
+    workspace_intro.setWordWrap(True)
+    workspace_intro.setObjectName("bodyText")
+    workspace_layout.addWidget(workspace_intro)
+
+    window.workspace_root_status_label = QLabel("")
+    window.workspace_root_status_label.setWordWrap(True)
+    window.workspace_root_status_label.setObjectName("sectionMeta")
+    workspace_layout.addWidget(window.workspace_root_status_label)
+
+    window.workspace_root_input = QLineEdit()
+    window.workspace_root_input.setObjectName("pathInput")
+    window.workspace_root_input.setReadOnly(True)
+    window.workspace_root_input.setPlaceholderText("Choose a workspace folder")
+    window.workspace_root_input.setText(window.workspace_session_state.root.input_text)
+    workspace_layout.addWidget(window.workspace_root_input)
+
+    workspace_actions = QHBoxLayout()
+    workspace_actions.setContentsMargins(0, 0, 0, 0)
+    workspace_actions.setSpacing(8)
+
+    window.browse_workspace_root_button = QPushButton("Browse…")
+    window.browse_workspace_root_button.clicked.connect(window._browse_workspace_collection_root_override)
+    workspace_actions.addWidget(window.browse_workspace_root_button)
+    workspace_actions.addStretch(1)
+    workspace_layout.addLayout(workspace_actions)
+
+    provision_title = QLabel("Provision Selected Workspace")
+    provision_title.setObjectName("sectionTitle")
+    workspace_layout.addWidget(provision_title)
+
+    provision_intro = QLabel(
+        "Create the selected workspace folder shape for this workstation without overwriting existing authored files."
+    )
+    provision_intro.setWordWrap(True)
+    provision_intro.setObjectName("bodyText")
+    workspace_layout.addWidget(provision_intro)
+
+    window.workspace_target_label = QLabel("")
+    window.workspace_target_label.setWordWrap(True)
+    window.workspace_target_label.setObjectName("sectionMeta")
+    workspace_layout.addWidget(window.workspace_target_label)
+
+    window.provision_workspace_button = QPushButton("Provision Workspace")
+    window.provision_workspace_button.clicked.connect(window._provision_selected_workspace)
+    workspace_layout.addWidget(window.provision_workspace_button, 0, Qt.AlignmentFlag.AlignLeft)
+
+    window.workspace_provision_status_label = QLabel("")
+    window.workspace_provision_status_label.setWordWrap(True)
+    window.workspace_provision_status_label.setObjectName("sectionMeta")
+    workspace_layout.addWidget(window.workspace_provision_status_label)
+
+    workspace_layout.addStretch(1)
+    return workspace_panel
+
+
+def _build_bootstrap_settings_panel(window: "DataEngineWindow") -> QWidget:
+    details_panel = QFrame()
+    details_panel.setObjectName("workspacePanel")
+    details_layout = QVBoxLayout(details_panel)
+    details_layout.setContentsMargins(18, 18, 18, 18)
+    details_layout.setSpacing(14)
+
+    details_title = QLabel("Workspace Visibility")
+    details_title.setObjectName("sectionTitle")
+    details_layout.addWidget(details_title)
+
+    intro = QLabel(
+        "Read-only environment and daemon details for the current workspace."
+    )
+    intro.setWordWrap(True)
+    intro.setObjectName("sectionMeta")
+    details_layout.addWidget(intro)
+
+    interpreter_title = QLabel("Python Interpreter")
+    interpreter_title.setObjectName("sectionTitle")
+    details_layout.addWidget(interpreter_title)
+
+    details_layout.addLayout(_build_settings_fact_row("Environment", "visibility_interpreter_mode_value", window))
+    details_layout.addLayout(_build_settings_fact_row("Executable", "visibility_interpreter_value", window, selectable=True))
+
+    daemon_title = QLabel("Emergency")
+    daemon_title.setObjectName("sectionTitle")
+    details_layout.addWidget(daemon_title)
+
+    daemon_intro = QLabel(
+        "Use only if the selected workspace daemon stops responding."
+    )
+    daemon_intro.setWordWrap(True)
+    daemon_intro.setObjectName("sectionMeta")
+    details_layout.addWidget(daemon_intro)
+
+    window.force_shutdown_daemon_button = QPushButton("Force Stop Daemon")
+    window.force_shutdown_daemon_button.clicked.connect(window._force_shutdown_daemon)
+    details_layout.addWidget(window.force_shutdown_daemon_button, 0, Qt.AlignmentFlag.AlignLeft)
+
+    window.force_shutdown_daemon_status_label = QLabel("")
+    window.force_shutdown_daemon_status_label.setWordWrap(True)
+    window.force_shutdown_daemon_status_label.setObjectName("sectionMeta")
+    details_layout.addWidget(window.force_shutdown_daemon_status_label)
+
+    details_layout.addStretch(1)
+    return details_panel
+
+
+def _build_settings_fact_row(
+    label_text: str,
+    value_attr: str,
+    window: "DataEngineWindow",
+    *,
+    selectable: bool = False,
+) -> QVBoxLayout:
+    row = QVBoxLayout()
+    row.setContentsMargins(0, 0, 0, 0)
+    row.setSpacing(2)
+
+    label = QLabel(label_text)
+    label.setObjectName("fieldLabel")
+    row.addWidget(label)
+
+    value = QLabel("")
+    value.setWordWrap(True)
+    value.setObjectName("fieldValue")
+    if selectable:
+        value.setTextInteractionFlags(Qt.TextInteractionFlag.TextSelectableByMouse)
+    setattr(window, value_attr, value)
+    row.addWidget(value)
+    return row
+
+
+def build_action_bar(window: "DataEngineWindow") -> QWidget:
+    frame = QFrame()
+    frame.setObjectName("actionBar")
+    row = QHBoxLayout(frame)
+    row.setContentsMargins(0, 0, 0, 0)
+    row.setSpacing(10)
+
+    window.engine_button = QPushButton("Start Engine")
+    window.engine_button.setObjectName("engineButton")
+    window.engine_button.setFixedHeight(36)
+    window.engine_button.clicked.connect(window._toggle_runtime)
+
+    window.refresh_button = QPushButton()
+    window.refresh_button.setObjectName("refreshButton")
+    window.refresh_button.setIcon(window._action_bar_icon("refresh"))
+    window.refresh_button.setIconSize(QPixmap(16, 16).size())
+    window.refresh_button.setFixedSize(36, 36)
+    window.refresh_button.setToolTip("Refresh Flows")
+    window.refresh_button.clicked.connect(window._refresh_flows_requested)
+
+    controls_group = QFrame()
+    controls_group.setObjectName("actionBarGroup")
+    controls_row = QHBoxLayout(controls_group)
+    controls_row.setContentsMargins(10, 8, 10, 8)
+    controls_row.setSpacing(6)
+    controls_row.addWidget(window.engine_button)
+    window.request_control_button = QPushButton("Request Control")
+    window.request_control_button.setObjectName("requestControlButton")
+    window.request_control_button.setFixedHeight(36)
+    window.request_control_button.setVisible(True)
+    window.request_control_button.clicked.connect(window._request_control)
+    controls_row.addWidget(window.request_control_button)
+    window.workspace_selector = QComboBox()
+    window.workspace_selector.setObjectName("workspaceSelector")
+    window.workspace_selector.setMinimumWidth(200)
+    window.workspace_selector.setFixedHeight(36)
+    window.workspace_selector.currentIndexChanged.connect(window._workspace_selection_changed)
+    controls_row.addWidget(window.workspace_selector)
+    row.addWidget(controls_group, 0)
+
+    window.lease_status_label = QLabel("")
+    window.lease_status_label.setObjectName("sectionMeta")
+    window.lease_status_label.setVisible(False)
+    row.addWidget(window.lease_status_label, 0, Qt.AlignmentFlag.AlignVCenter)
+
+    row.addStretch(1)
+    row.addWidget(window.refresh_button, 0, Qt.AlignmentFlag.AlignVCenter)
+
+    window.theme_toggle_button = QPushButton()
+    window.theme_toggle_button.setObjectName("themeToggleButton")
+    window.theme_toggle_button.setIcon(window._action_bar_icon("theme_toggle"))
+    window.theme_toggle_button.setIconSize(QPixmap(16, 16).size())
+    window.theme_toggle_button.setFixedSize(36, 36)
+    window.theme_toggle_button.setToolTip("Switch Theme")
+    window.theme_toggle_button.clicked.connect(window._toggle_theme)
+    row.addWidget(window.theme_toggle_button)
+    return frame
+
+
+def build_sidebar(window: "DataEngineWindow") -> QWidget:
+    panel = QFrame()
+    panel.setObjectName("sidebarPanel")
+    layout = QVBoxLayout(panel)
+    layout.setContentsMargins(18, 18, 18, 18)
+    layout.setSpacing(10)
+
+    title = QLabel("Configured Flows")
+    title.setObjectName("sectionTitle")
+    layout.addWidget(title)
+
+    window.sidebar_scroll = QScrollArea()
+    window.sidebar_scroll.setWidgetResizable(True)
+    window.sidebar_scroll.setFrameShape(QFrame.Shape.NoFrame)
+    window.sidebar_scroll.setHorizontalScrollBarPolicy(Qt.ScrollBarPolicy.ScrollBarAlwaysOff)
+    window.sidebar_scroll.setObjectName("sidebarScroll")
+    window.sidebar_scroll.verticalScrollBar().valueChanged.connect(window._update_sidebar_scroll_cues)
+    window.sidebar_scroll.verticalScrollBar().rangeChanged.connect(window._update_sidebar_scroll_cues)
+    window.sidebar_content = QWidget()
+    window.sidebar_content.setObjectName("sidebarContent")
+    window.sidebar_layout = QVBoxLayout(window.sidebar_content)
+    window.sidebar_layout.setContentsMargins(0, 0, 0, 0)
+    window.sidebar_layout.setSpacing(2)
+    window.sidebar_layout.addStretch(1)
+    window.sidebar_scroll.setWidget(window.sidebar_content)
+    window.sidebar_top_cue = QFrame()
+    window.sidebar_top_cue.setObjectName("sidebarCueTop")
+    window.sidebar_bottom_cue = QFrame()
+    window.sidebar_bottom_cue.setObjectName("sidebarCueBottom")
+    window.sidebar_top_cue.hide()
+    window.sidebar_bottom_cue.hide()
+    layout.addWidget(window.sidebar_top_cue)
+    layout.addWidget(window.sidebar_scroll, 1)
+    layout.addWidget(window.sidebar_bottom_cue)
+    return panel
+
+
+def build_center_panel(window: "DataEngineWindow") -> QWidget:
+    panel = QFrame()
+    panel.setObjectName("workspacePanel")
+    layout = QVBoxLayout(panel)
+    layout.setContentsMargins(18, 18, 18, 18)
+    layout.setSpacing(10)
+
+    header = QFrame()
+    header.setObjectName("heroHeader")
+    header_row = QHBoxLayout(header)
+    header_row.setContentsMargins(0, 0, 0, 0)
+    header_row.setSpacing(12)
+
+    title_column = QVBoxLayout()
+    title_column.setContentsMargins(0, 0, 0, 0)
+    title_column.setSpacing(2)
+    window.operations_title_label = QLabel("Steps")
+    window.operations_title_label.setObjectName("sectionTitle")
+    title_column.addWidget(window.operations_title_label, 0, Qt.AlignmentFlag.AlignTop | Qt.AlignmentFlag.AlignLeft)
+
+    window.flow_error_label = QLabel("")
+    window.flow_error_label.setWordWrap(True)
+    window.flow_error_label.setObjectName("errorText")
+    title_column.addWidget(window.flow_error_label, 0, Qt.AlignmentFlag.AlignTop | Qt.AlignmentFlag.AlignLeft)
+    header_row.addLayout(title_column, 1)
+
+    title_row = QHBoxLayout()
+    title_row.setContentsMargins(0, 0, 0, 0)
+    title_row.setSpacing(6)
+    window.flow_run_button = QPushButton("Run Once")
+    window.flow_run_button.setObjectName("flowRunButton")
+    window.flow_run_button.clicked.connect(window._run_selected_flow)
+    title_row.addWidget(window.flow_run_button, 0, Qt.AlignmentFlag.AlignTop)
+    window.flow_config_button = QPushButton("View Config")
+    window.flow_config_button.clicked.connect(window._show_config_preview)
+    title_row.addWidget(window.flow_config_button, 0, Qt.AlignmentFlag.AlignTop)
+    header_row.addLayout(title_row, 0)
+
+    window.operation_scroll = QScrollArea()
+    window.operation_scroll.setWidgetResizable(True)
+    window.operation_scroll.setFrameShape(QFrame.Shape.NoFrame)
+    window.operation_scroll.setHorizontalScrollBarPolicy(Qt.ScrollBarPolicy.ScrollBarAlwaysOff)
+    window.operation_scroll.setObjectName("operationScroll")
+    window.operation_container = QFrame()
+    window.operation_container.setObjectName("operationList")
+    window.operation_layout = QVBoxLayout(window.operation_container)
+    window.operation_layout.setContentsMargins(0, 0, 0, 0)
+    window.operation_layout.setSpacing(6)
+    window.operation_layout.addStretch(1)
+    window.operation_scroll.setWidget(window.operation_container)
+    window.operation_scroll.verticalScrollBar().valueChanged.connect(window._update_operation_scroll_cues)
+    window.operation_scroll.verticalScrollBar().rangeChanged.connect(window._update_operation_scroll_cues)
+
+    window.operation_top_cue = QFrame()
+    window.operation_top_cue.setObjectName("operationCueTop")
+    window.operation_bottom_cue = QFrame()
+    window.operation_bottom_cue.setObjectName("operationCueBottom")
+    window.operation_top_cue.hide()
+    window.operation_bottom_cue.hide()
+
+    layout.addWidget(header)
+    layout.addWidget(window.operation_top_cue)
+    layout.addWidget(window.operation_scroll, 1)
+    layout.addWidget(window.operation_bottom_cue)
+    return panel
+
+
+def build_right_panel(window: "DataEngineWindow") -> QWidget:
+    panel = QFrame()
+    panel.setObjectName("workspacePanel")
+    layout = QVBoxLayout(panel)
+    layout.setContentsMargins(18, 18, 18, 18)
+    layout.setSpacing(10)
+
+    title = QLabel("Logs")
+    title.setObjectName("sectionTitle")
+    header = QHBoxLayout()
+    header.setContentsMargins(0, 0, 0, 0)
+    header.setSpacing(8)
+    header.addWidget(title)
+    header.addStretch(1)
+
+    window.clear_flow_log_button = QPushButton("Clear Flow Log")
+    window.clear_flow_log_button.clicked.connect(window._clear_logs)
+    header.addWidget(window.clear_flow_log_button)
+    layout.addLayout(header)
+
+    window.log_view = QListWidget()
+    window.log_view.setObjectName("logList")
+    mono = QFont("Menlo")
+    mono.setStyleHint(QFont.StyleHint.Monospace)
+    window.log_view.setFont(mono)
+    layout.addWidget(window.log_view, 1)
+    return panel
+
+
+__all__ = [
+    "build_action_bar",
+    "build_center_panel",
+    "build_docs_view",
+    "build_nav_rail",
+    "build_operator_view",
+    "build_right_panel",
+    "build_settings_view",
+    "build_sidebar",
+]