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

data_engine/ui/gui/helpers/theming.py

@@ -0,0 +1,87 @@
+"""Theme and icon helper functions for the desktop GUI."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from PySide6.QtGui import QColor, QIcon, QPixmap
+from PySide6.QtWidgets import QApplication
+
+from data_engine.ui.gui.rendering import render_svg_icon_pixmap as render_svg_icon_pixmap_helper
+from data_engine.ui.gui.theme import stylesheet
+
+if TYPE_CHECKING:
+    from data_engine.ui.gui.app import DataEngineWindow
+
+
+def group_icon(window: "DataEngineWindow", group_name: str) -> QIcon:
+    del group_name
+    return QIcon(window._render_svg_icon_pixmap("group", 18))
+
+
+def group_icon_color(window: "DataEngineWindow") -> QColor:
+    return QColor(window.theme_service.palette(window.theme_name).text)
+
+
+def render_svg_icon_pixmap(
+    window: "DataEngineWindow",
+    icon_name: str,
+    size: int,
+    *,
+    fill_color: str | None = None,
+) -> QPixmap:
+    return render_svg_icon_pixmap_helper(
+        icon_name=icon_name,
+        size=size,
+        device_pixel_ratio=window.devicePixelRatioF(),
+        fill_color=fill_color,
+        default_fill_color=window._group_icon_color(),
+    )
+
+
+def view_rail_icon(window: "DataEngineWindow", view_name: str) -> QIcon:
+    icon_name = window._VIEW_RAIL_ICON_NAMES[view_name]
+    return QIcon(window._render_svg_icon_pixmap(icon_name, 18))
+
+
+def action_bar_icon(window: "DataEngineWindow", action_name: str) -> QIcon:
+    icon_name = window._ACTION_ICON_NAMES[action_name]
+    return QIcon(window._render_svg_icon_pixmap(icon_name, 16))
+
+
+def log_icon(window: "DataEngineWindow", icon_name: str, size: int = 16) -> QIcon:
+    resolved_name = window._LOG_ICON_NAMES[icon_name]
+    fill_color = window._LOG_ICON_COLORS.get(icon_name)
+    return QIcon(window._render_svg_icon_pixmap(resolved_name, size, fill_color=fill_color))
+
+
+def render_group_icon_pixmap(window: "DataEngineWindow", group_name: str, size: int) -> QPixmap:
+    del group_name
+    return window._render_svg_icon_pixmap("group", size)
+
+
+def toggle_theme(window: "DataEngineWindow") -> None:
+    window.theme_name = window.theme_service.toggle_name(window.theme_name)
+    window._apply_theme()
+
+
+def sync_theme_to_system(window: "DataEngineWindow", *args) -> None:
+    del args
+    window.theme_name = window.theme_service.system_name()
+    window._apply_theme()
+
+
+def apply_theme(window: "DataEngineWindow") -> None:
+    app = QApplication.instance()
+    if app is not None:
+        app.setStyleSheet(stylesheet(window.theme_name))
+    window.theme_toggle_button.setIcon(window._action_bar_icon("theme_toggle"))
+    window.refresh_button.setIcon(window._action_bar_icon("refresh"))
+    for button in (window.home_button, window.docs_button, window.settings_button):
+        icon_name = button.property("viewIconName")
+        if isinstance(icon_name, str):
+            button.setIcon(window._view_rail_icon(icon_name))
+    if window.flow_cards:
+        window._populate_flow_tree()
+        window._refresh_action_buttons()
+        window._refresh_log_view()

data_engine/ui/gui/icons/dark_light.svg

@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg width="800px" height="800px" viewBox="0 0 24 24" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+    <!-- Uploaded to: SVG Repo, www.svgrepo.com, Generator: SVG Repo Mixer Tools -->
+    <title>ic_fluent_dark_theme_24_filled</title>
+    <desc>Created with Sketch.</desc>
+    <g id="🔍-Product-Icons" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
+        <g id="ic_fluent_dark_theme_24_filled" fill="#212121" fill-rule="nonzero">
+            <path d="M12,22 C17.5228475,22 22,17.5228475 22,12 C22,6.4771525 17.5228475,2 12,2 C6.4771525,2 2,6.4771525 2,12 C2,17.5228475 6.4771525,22 12,22 Z M12,20 L12,4 C16.418278,4 20,7.581722 20,12 C20,16.418278 16.418278,20 12,20 Z" id="🎨-Color">
+
+        </g>
+    </g>
+</svg>

data_engine/ui/gui/icons/documentation.svg

@@ -0,0 +1 @@
+<svg id="Layer_1" height="512" viewBox="0 0 24 24" width="512" xmlns="http://www.w3.org/2000/svg" data-name="Layer 1"><path d="m17 14a1 1 0 0 1 -1 1h-8a1 1 0 0 1 0-2h8a1 1 0 0 1 1 1zm-4 3h-5a1 1 0 0 0 0 2h5a1 1 0 0 0 0-2zm9-6.515v8.515a5.006 5.006 0 0 1 -5 5h-10a5.006 5.006 0 0 1 -5-5v-14a5.006 5.006 0 0 1 5-5h4.515a6.958 6.958 0 0 1 4.95 2.05l3.484 3.486a6.951 6.951 0 0 1 2.051 4.949zm-6.949-7.021a5.01 5.01 0 0 0 -1.051-.78v4.316a1 1 0 0 0 1 1h4.316a4.983 4.983 0 0 0 -.781-1.05zm4.949 7.021c0-.165-.032-.323-.047-.485h-4.953a3 3 0 0 1 -3-3v-4.953c-.162-.015-.321-.047-.485-.047h-4.515a3 3 0 0 0 -3 3v14a3 3 0 0 0 3 3h10a3 3 0 0 0 3-3z"/></svg>

data_engine/ui/gui/icons/failed.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+  <path d="M23.64 18.1 14.24 2.28C13.77 1.48 12.94 1 12 1s-1.77.48-2.23 1.28L.36 18.1h0c-.47.82-.47 1.79 0 2.6S1.67 22 2.6 22h18.81c.94 0 1.78-.49 2.24-1.3s.46-1.78-.01-2.6ZM13 18h-2v-2h2v2Zm0-4h-2V8h2v6Z"/>
+</svg>

data_engine/ui/gui/icons/group.svg

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" id="Layer_1" data-name="Layer 1" viewBox="0 0 24 24">
+  <path d="M1.001,10.983c.062,.011,.122,.017,.182,.017,.474,0,.895-.337,.982-.82,.162-.881,.443-1.729,.833-2.532,.457,.219,.962,.352,1.502,.352,1.93,0,3.5-1.57,3.5-3.5,0-.54-.133-1.046-.353-1.503,.803-.389,1.652-.671,2.533-.833,.543-.1,.902-.621,.803-1.164-.1-.542-.61-.903-1.164-.803-1.258,.231-2.459,.668-3.58,1.284-.515-.298-1.104-.481-1.74-.481-1.93,0-3.5,1.57-3.5,3.5,0,.636,.183,1.225,.481,1.74-.615,1.121-1.052,2.321-1.283,3.58-.1,.543,.26,1.064,.803,1.164ZM4.5,3c.827,0,1.5,.673,1.5,1.5s-.673,1.5-1.5,1.5-1.5-.673-1.5-1.5,.673-1.5,1.5-1.5Zm9.328-.852c.915,.159,1.793,.447,2.625,.85-.219,.457-.352,.962-.352,1.501,0,1.93,1.57,3.5,3.5,3.5,.539,0,1.045-.133,1.502-.352,.389,.803,.672,1.65,.833,2.533,.089,.482,.509,.819,.982,.819,.06,0,.121-.005,.182-.017,.543-.1,.902-.621,.803-1.164-.232-1.26-.668-2.461-1.283-3.58,.298-.514,.481-1.103,.481-1.739,0-1.93-1.57-3.5-3.5-3.5-.636,0-1.226,.184-1.74,.482-1.154-.633-2.391-1.078-3.689-1.304-.551-.093-1.062,.27-1.157,.814-.095,.544,.27,1.062,.813,1.157Zm7.273,2.352c0,.827-.673,1.5-1.5,1.5s-1.5-.673-1.5-1.5,.673-1.5,1.5-1.5,1.5,.673,1.5,1.5ZM10.181,21.835c-.882-.162-1.73-.443-2.533-.833,.219-.457,.353-.963,.353-1.503,0-1.93-1.57-3.5-3.5-3.5-.54,0-1.045,.133-1.502,.352-.39-.803-.671-1.651-.833-2.532-.099-.543-.611-.904-1.164-.803-.543,.1-.902,.621-.803,1.164,.231,1.259,.668,2.459,1.283,3.58-.298,.515-.481,1.104-.481,1.74,0,1.93,1.57,3.5,3.5,3.5,.636,0,1.225-.183,1.74-.481,1.121,.615,2.322,1.053,3.58,1.284,.062,.011,.122,.017,.182,.017,.474,0,.894-.337,.982-.819,.1-.543-.26-1.064-.803-1.164Zm-7.181-2.335c0-.827,.673-1.5,1.5-1.5s1.5,.673,1.5,1.5-.673,1.5-1.5,1.5-1.5-.673-1.5-1.5Zm20.101-6.483c-.543-.101-1.063,.26-1.164,.803-.162,.882-.444,1.73-.833,2.533-.457-.219-.962-.352-1.502-.352-1.93,0-3.5,1.57-3.5,3.5,0,.539,.133,1.045,.352,1.501-.832,.403-1.711,.691-2.625,.85-.544,.095-.908,.613-.813,1.157,.085,.486,.507,.829,.984,.829,.057,0,.114-.005,.173-.015,1.298-.226,2.535-.671,3.689-1.304,.515,.298,1.104,.482,1.74,.482,1.93,0,3.5-1.57,3.5-3.5,0-.636-.183-1.224-.481-1.739,.615-1.12,1.051-2.32,1.283-3.58,.1-.543-.26-1.064-.803-1.164Zm-3.499,7.983c-.827,0-1.5-.673-1.5-1.5s.673-1.5,1.5-1.5,1.5,.673,1.5,1.5-.673,1.5-1.5,1.5Zm-7.602-3v.993c0,.583-.688,.893-1.125,.508l-2.01-1.773c-.487-.42-.487-1.155,0-1.575l2.01-1.773c.437-.385,1.125-.075,1.125,.508v1.112c2.206,0,4-1.794,4-4,0-.557-.112-1.095-.332-1.6-.222-.506,.01-1.096,.516-1.317,.508-.221,1.097,.011,1.316,.516,.332,.759,.5,1.566,.5,2.4,0,3.309-2.691,6-6,6Zm0-12v-.993c0-.583,.687-.893,1.125-.508l2.01,1.773c.487,.42,.487,1.155,0,1.575l-2.01,1.773c-.437,.385-1.125,.075-1.125-.508v-1.111c-2.206,0-4,1.794-4,4,0,.557,.112,1.095,.332,1.6,.222,.506-.01,1.096-.516,1.317-.13,.057-.267,.084-.399,.084-.386,0-.753-.224-.917-.6-.332-.759-.5-1.566-.5-2.4,0-3.309,2.691-6,6-6Z"/>
+</svg>

data_engine/ui/gui/icons/home.svg

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" id="Outline" viewBox="0 0 24 24" width="512" height="512"><path d="M23.121,9.069,15.536,1.483a5.008,5.008,0,0,0-7.072,0L.879,9.069A2.978,2.978,0,0,0,0,11.19v9.817a3,3,0,0,0,3,3H21a3,3,0,0,0,3-3V11.19A2.978,2.978,0,0,0,23.121,9.069ZM15,22.007H9V18.073a3,3,0,0,1,6,0Zm7-1a1,1,0,0,1-1,1H17V18.073a5,5,0,0,0-10,0v3.934H3a1,1,0,0,1-1-1V11.19a1.008,1.008,0,0,1,.293-.707L9.878,2.9a3.008,3.008,0,0,1,4.244,0l7.585,7.586A1.008,1.008,0,0,1,22,11.19Z"/></svg>

data_engine/ui/gui/icons/manual.svg

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" id="Bold" viewBox="0 0 24 24" width="512" height="512"><path d="M20.463,7.713l-9.1-6.677A5.317,5.317,0,0,0,2.9,5.323V18.677a5.311,5.311,0,0,0,8.46,4.287l9.105-6.677a5.315,5.315,0,0,0,0-8.574Zm-1.774,6.155-9.1,6.677A2.317,2.317,0,0,1,5.9,18.677V5.323a2.276,2.276,0,0,1,1.27-2.066A2.328,2.328,0,0,1,8.223,3a2.3,2.3,0,0,1,1.362.455l9.1,6.677a2.316,2.316,0,0,1,0,3.736Z"/></svg>

data_engine/ui/gui/icons/poll.svg

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" id="Layer_1" data-name="Layer 1" viewBox="0 0 24 24" width="512" height="512"><path d="M7,0h-3C1.79,0,0,1.79,0,4v3c0,2.21,1.79,4,4,4h3c2.21,0,4-1.79,4-4v-3C11,1.79,9.21,0,7,0Zm2,7c0,1.1-.9,2-2,2h-3c-1.1,0-2-.9-2-2v-3c0-1.1,.9-2,2-2h3c1.1,0,2,.9,2,2v3Zm11,6h-3c-2.21,0-4,1.79-4,4v3c0,2.21,1.79,4,4,4h3c2.21,0,4-1.79,4-4v-3c0-2.21-1.79-4-4-4Zm2,7c0,1.1-.9,2-2,2h-3c-1.1,0-2-.9-2-2v-3c0-1.1,.9-2,2-2h3c1.1,0,2,.9,2,2v3ZM13,5c0-1.06,.44-2.05,1.25-2.78l2.07-1.95c.4-.38,1.03-.36,1.41,.04,.38,.4,.36,1.04-.04,1.41l-2.08,1.95c-.11,.1-.2,.21-.28,.32h3.67c2.21,0,4,1.79,4,4v2c0,.55-.45,1-1,1s-1-.45-1-1v-2c0-1.1-.9-2-2-2h-3.67c.08,.11,.17,.21,.27,.31l2.09,1.96c.4,.38,.42,1.01,.04,1.41-.2,.21-.46,.31-.73,.31-.25,0-.49-.09-.69-.27l-2.08-1.95c-.79-.73-1.24-1.72-1.24-2.77Zm-2,14c0,1.06-.44,2.04-1.25,2.78l-2.07,1.95c-.19,.18-.44,.27-.69,.27-.27,0-.53-.11-.73-.31-.38-.4-.36-1.04,.04-1.41l2.08-1.95c.11-.1,.2-.21,.28-.32h-3.67c-2.21,0-4-1.79-4-4v-2c0-.55,.45-1,1-1s1,.45,1,1v2c0,1.1,.9,2,2,2h3.67c-.08-.11-.17-.21-.27-.31l-2.09-1.96c-.4-.38-.42-1.01-.04-1.41,.38-.4,1.01-.42,1.41-.04l2.08,1.95c.79,.73,1.24,1.72,1.24,2.77Z"/></svg>

data_engine/ui/gui/icons/schedule.svg

@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" id="Layer_1" data-name="Layer 1" viewBox="0 0 24 24">
+  <path d="M19.5,2h-1.5V.5c0-.276-.224-.5-.5-.5s-.5,.224-.5,.5v1.5H7V.5c0-.276-.224-.5-.5-.5s-.5,.224-.5,.5v1.5h-1.5C2.019,2,0,4.019,0,6.5v13c0,2.481,2.019,4.5,4.5,4.5h15c2.481,0,4.5-2.019,4.5-4.5V6.5c0-2.481-2.019-4.5-4.5-4.5ZM4.5,3h15c1.93,0,3.5,1.57,3.5,3.5v1.5H1v-1.5c0-1.93,1.57-3.5,3.5-3.5Zm15,20H4.5c-1.93,0-3.5-1.57-3.5-3.5V9H23v10.5c0,1.93-1.57,3.5-3.5,3.5Zm-2.5-11.5v2.5c0,.552-.448,1-1,1h-2.5c-.276,0-.5-.224-.5-.5s.224-.5,.5-.5h1.957c-.706-1.217-2.015-2-3.457-2-1.692,0-3.209,1.072-3.772,2.667-.093,.262-.375,.398-.639,.305-.26-.092-.396-.377-.305-.638,.705-1.994,2.601-3.333,4.716-3.333,1.6,0,3.072,.768,4,2.004v-1.504c0-.276,.224-.5,.5-.5s.5,.224,.5,.5Zm-.284,6.167c-.705,1.994-2.601,3.333-4.716,3.333-1.6,0-3.072-.768-4-2.004v1.504c0,.276-.224,.5-.5,.5s-.5-.224-.5-.5v-2.5c0-.552,.448-1,1-1h2.5c.276,0,.5,.224,.5,.5s-.224,.5-.5,.5h-1.957c.706,1.217,2.015,2,3.457,2,1.692,0,3.209-1.072,3.772-2.667,.093-.261,.377-.396,.639-.305,.26,.092,.396,.377,.305,.638Z"/>
+</svg>

data_engine/ui/gui/icons/settings.svg

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<svg xmlns="http://www.w3.org/2000/svg" id="Outline" viewBox="0 0 24 24" width="512" height="512"><path d="M12,8a4,4,0,1,0,4,4A4,4,0,0,0,12,8Zm0,6a2,2,0,1,1,2-2A2,2,0,0,1,12,14Z"/><path d="M21.294,13.9l-.444-.256a9.1,9.1,0,0,0,0-3.29l.444-.256a3,3,0,1,0-3-5.2l-.445.257A8.977,8.977,0,0,0,15,3.513V3A3,3,0,0,0,9,3v.513A8.977,8.977,0,0,0,6.152,5.159L5.705,4.9a3,3,0,0,0-3,5.2l.444.256a9.1,9.1,0,0,0,0,3.29l-.444.256a3,3,0,1,0,3,5.2l.445-.257A8.977,8.977,0,0,0,9,20.487V21a3,3,0,0,0,6,0v-.513a8.977,8.977,0,0,0,2.848-1.646l.447.258a3,3,0,0,0,3-5.2Zm-2.548-3.776a7.048,7.048,0,0,1,0,3.75,1,1,0,0,0,.464,1.133l1.084.626a1,1,0,0,1-1,1.733l-1.086-.628a1,1,0,0,0-1.215.165,6.984,6.984,0,0,1-3.243,1.875,1,1,0,0,0-.751.969V21a1,1,0,0,1-2,0V19.748a1,1,0,0,0-.751-.969A6.984,6.984,0,0,1,7.006,16.9a1,1,0,0,0-1.215-.165l-1.084.627a1,1,0,1,1-1-1.732l1.084-.626a1,1,0,0,0,.464-1.133,7.048,7.048,0,0,1,0-3.75A1,1,0,0,0,4.79,8.992L3.706,8.366a1,1,0,0,1,1-1.733l1.086.628A1,1,0,0,0,7.006,7.1a6.984,6.984,0,0,1,3.243-1.875A1,1,0,0,0,11,4.252V3a1,1,0,0,1,2,0V4.252a1,1,0,0,0,.751.969A6.984,6.984,0,0,1,16.994,7.1a1,1,0,0,0,1.215.165l1.084-.627a1,1,0,1,1,1,1.732l-1.084.626A1,1,0,0,0,18.746,10.125Z"/></svg>

data_engine/ui/gui/icons/started.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 513.806 513.806">
+  <path d="M66.074 228.731C81.577 123.379 179.549 50.542 284.901 66.045c35.944 5.289 69.662 20.626 97.27 44.244l-24.853 24.853c-8.33 8.332-8.328 21.84.005 30.17 3.999 3.998 9.423 6.245 15.078 6.246h97.835c11.782 0 21.333-9.551 21.333-21.333V52.39c-.003-11.782-9.556-21.331-21.338-21.329-5.655.001-11.079 2.248-15.078 6.246L427.418 65.04C321.658-29.235 159.497-19.925 65.222 85.835c-33.399 37.467-55.073 83.909-62.337 133.573-2.864 17.607 9.087 34.202 26.693 37.066 1.586.258 3.188.397 4.795.417 16.108-.174 29.629-12.185 31.701-28.16ZM479.429 256.891c-16.108.174-29.629 12.185-31.701 28.16C432.225 390.403 334.253 463.24 228.901 447.738c-35.944-5.289-69.662-20.626-97.27-44.244l24.853-24.853c8.33-8.332 8.328-21.84-.005-30.17-3.999-3.998-9.423-6.245-15.078-6.246H43.568c-11.782 0-21.333 9.551-21.333 21.333v97.835c.003 11.782 9.556 21.331 21.338 21.329 5.655-.001 11.079-2.248 15.078-6.246l27.733-27.733c105.735 94.285 267.884 85.004 362.17-20.732 33.417-37.475 55.101-83.933 62.363-133.615 2.876-17.605-9.064-34.208-26.668-37.084-1.592-.26-3.203-.401-4.818-.42Z"/>
+</svg>

data_engine/ui/gui/icons/success.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+  <path d="m12 1c-7.71 0-11 3.29-11 11s3.29 11 11 11 11-3.29 11-11-3.29-11-11-11zm5.305 8.539c-1.312 2.053-3.18 4.626-6.001 6.319-.324.195-.731.19-1.05-.013-1.52-.963-2.661-1.995-3.594-3.248-.33-.443-.238-1.069.205-1.399.442-.33 1.069-.237 1.398.205.674.905 1.488 1.679 2.536 2.405 2.16-1.46 3.644-3.507 4.819-5.346.299-.466.917-.602 1.381-.304.466.298.602.916.305 1.381z"/>
+</svg>

data_engine/ui/gui/icons/view-log.svg

@@ -0,0 +1,3 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">
+  <path d="m14 7v-6.54c.913.346 1.753.879 2.465 1.59l3.484 3.486c.712.711 1.245 1.551 1.591 2.464h-6.54c-.552 0-1-.449-1-1zm-1.771 7.985c0-.394-.342-.726-.75-.733-.402.007-.725.333-.724.736 0 .095.008 1.886.008 2.024 0 .403.322.729.724.736.408-.007.75-.338.75-.733l-.008-2.015zm9.747-4.985h-6.976c-1.654 0-3-1.346-3-3v-6.976c-.161-.011-.322-.024-.485-.024h-4.515c-2.757 0-5 2.243-5 5v14c0 2.757 2.243 5 5 5h10c2.757 0 5-2.243 5-5v-8.515c0-.163-.013-.324-.024-.485zm-13.254 8.368c0 .346-.28.627-.626.627l-1.468.003c-.347 0-.629-.28-.629-.627l-.005-4.744c0-.347.281-.628.628-.628s.627.28.627.626c.001 1.249.003 2.869.004 4.118.71-.001.592-.003.837-.004.348-.002.631.28.631.628zm4.765-1.353c0 1.094-.902 1.985-2.012 1.985-1.086 0-1.967-.881-1.967-1.967l-.008-2.066c0-1.086.881-1.967 1.967-1.967 1.109 0 2.012.891 2.012 1.985v.015l.008 2zm5 0c0 1.094-.902 1.985-2.012 1.985-1.086 0-1.967-.881-1.967-1.967l-.008-2.066c0-1.086.881-1.967 1.967-1.967.772 0 1.445.432 1.782 1.064.223.417-.08.921-.553.921-.228 0-.441-.122-.548-.324-.125-.237-.38-.404-.669-.409-.402.007-.725.333-.724.736 0 .095.008 1.886.008 2.024 0 .403.322.729.724.736.32-.005.593-.212.698-.491-.036 0-.063 0-.085 0-.349.004-.633-.278-.633-.627 0-.346.28-.626.625-.627l.766-.002c.346-.001.627.278.628.624v.374s.001.015.001.015z"/>
+</svg>

data_engine/ui/gui/icons.py

@@ -0,0 +1,50 @@
+"""UI icon registry and loading helpers."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from importlib import resources
+
+
+@dataclass(frozen=True)
+class SvgIconAsset:
+    """Describe one SVG icon source."""
+
+    file_name: str | None = None
+    svg_text: str | None = None
+
+    def read_text(self) -> str:
+        """Return raw SVG text for this asset."""
+        if self.svg_text is not None:
+            return self.svg_text
+        if self.file_name is None:
+            raise ValueError("SVG icon asset has no source configured.")
+        return resources.files("data_engine.ui.gui").joinpath("icons", self.file_name).read_text(encoding="utf-8")
+
+
+ICON_ASSETS: dict[str, SvgIconAsset] = {
+    "dark_light": SvgIconAsset(file_name="dark_light.svg"),
+    "documentation": SvgIconAsset(file_name="documentation.svg"),
+    "failed": SvgIconAsset(file_name="failed.svg"),
+    "group": SvgIconAsset(file_name="group.svg"),
+    "home": SvgIconAsset(file_name="home.svg"),
+    "manual": SvgIconAsset(file_name="manual.svg"),
+    "poll": SvgIconAsset(file_name="poll.svg"),
+    "schedule": SvgIconAsset(file_name="schedule.svg"),
+    "settings": SvgIconAsset(file_name="settings.svg"),
+    "started": SvgIconAsset(file_name="started.svg"),
+    "success": SvgIconAsset(file_name="success.svg"),
+    "view-log": SvgIconAsset(file_name="view-log.svg"),
+}
+
+
+def load_svg_icon_text(icon_name: str) -> str:
+    """Return SVG text for one registered icon."""
+    try:
+        asset = ICON_ASSETS[icon_name]
+    except KeyError as exc:
+        raise KeyError(f"Unknown UI icon: {icon_name}") from exc
+    return asset.read_text()
+
+
+__all__ = ["ICON_ASSETS", "SvgIconAsset", "load_svg_icon_text"]

data_engine/ui/gui/launcher.py

@@ -0,0 +1,48 @@
+"""Launcher entrypoints for the Data Engine PySide6 UI."""
+
+from __future__ import annotations
+
+import os
+
+from PySide6.QtWidgets import QApplication
+
+from data_engine.platform.identity import APP_DISPLAY_NAME
+from data_engine.ui.gui.bootstrap import build_gui_services
+from data_engine.ui.gui.app import DataEngineWindow
+from data_engine.ui.gui.theme import DEFAULT_THEME, resolve_theme_name, stylesheet
+
+
+def _configure_qt_webengine_environment() -> None:
+    """Set stable Chromium flags before the UI spins up embedded docs."""
+    existing = os.environ.get("QTWEBENGINE_CHROMIUM_FLAGS", "").strip()
+    flags = [flag for flag in existing.split() if flag]
+    if "--disable-skia-graphite" not in flags:
+        flags.append("--disable-skia-graphite")
+    os.environ["QTWEBENGINE_CHROMIUM_FLAGS"] = " ".join(flags)
+
+
+def launch(theme_name: str = DEFAULT_THEME) -> None:
+    """Create and run the PySide6 application."""
+    _configure_qt_webengine_environment()
+    services = build_gui_services()
+    app = QApplication.instance() or QApplication([])
+    app.setApplicationName(APP_DISPLAY_NAME)
+    app.setStyle("Fusion")
+    resolved_theme = services.theme_service.resolve_name(theme_name)
+    app.setStyleSheet(stylesheet(resolved_theme))
+    window = DataEngineWindow(theme_name=resolved_theme, services=services)
+    window.show()
+    if QApplication.instance() is app:
+        app.exec()
+
+
+def main() -> None:
+    """Console entrypoint for the desktop UI."""
+    launch()
+
+
+if __name__ == "__main__":
+    main()
+
+
+__all__ = ["launch", "main"]

data_engine/ui/gui/presenters/__init__.py

@@ -0,0 +1,72 @@
+"""Presenter helpers for the desktop UI."""
+
+from data_engine.ui.gui.presenters.logs import add_log_run_item, format_raw_log_message, refresh_log_view
+from data_engine.ui.gui.presenters.docs import (
+    create_docs_browser,
+    docs_build_dir,
+    finish_docs_build,
+    initialize_docs_view,
+    load_docs_page,
+    run_docs_build_worker,
+    start_docs_build,
+)
+from data_engine.ui.gui.presenters.runtime_projection import (
+    apply_daemon_snapshot,
+    finish_daemon_startup,
+)
+from data_engine.ui.gui.presenters.sidebar import refresh_sidebar_selection, refresh_sidebar_state_views, repolish_widget_tree, set_hovered
+from data_engine.ui.gui.presenters.steps import (
+    apply_runtime_event,
+    duration_text,
+    format_seconds,
+    normalize_completed_operation_rows,
+    refresh_live_operation_durations,
+    render_operation_durations,
+    reset_operation_state,
+)
+from data_engine.ui.gui.presenters.workspace_binding import rebind_workspace_context
+from data_engine.ui.gui.presenters.workspace_settings import (
+    browse_workspace_collection_root_override,
+    force_shutdown_daemon,
+    provision_selected_workspace,
+    refresh_workspace_provisioning_controls,
+    refresh_workspace_visibility_panel,
+    refresh_workspace_root_controls,
+    reset_workspace_collection_root_override,
+    save_workspace_collection_root_override,
+)
+
+__all__ = [
+    "add_log_run_item",
+    "apply_runtime_event",
+    "apply_daemon_snapshot",
+    "browse_workspace_collection_root_override",
+    "create_docs_browser",
+    "docs_build_dir",
+    "duration_text",
+    "finish_daemon_startup",
+    "finish_docs_build",
+    "format_raw_log_message",
+    "format_seconds",
+    "force_shutdown_daemon",
+    "initialize_docs_view",
+    "load_docs_page",
+    "normalize_completed_operation_rows",
+    "rebind_workspace_context",
+    "provision_selected_workspace",
+    "refresh_log_view",
+    "refresh_workspace_provisioning_controls",
+    "refresh_workspace_visibility_panel",
+    "refresh_live_operation_durations",
+    "refresh_workspace_root_controls",
+    "refresh_sidebar_selection",
+    "refresh_sidebar_state_views",
+    "reset_workspace_collection_root_override",
+    "render_operation_durations",
+    "repolish_widget_tree",
+    "reset_operation_state",
+    "run_docs_build_worker",
+    "save_workspace_collection_root_override",
+    "set_hovered",
+    "start_docs_build",
+]

data_engine/ui/gui/presenters/docs.py

@@ -0,0 +1,140 @@
+"""Documentation browser/build helpers for the desktop UI."""
+
+from __future__ import annotations
+
+import os
+from pathlib import Path
+import subprocess
+import sys
+from typing import TYPE_CHECKING
+
+from PySide6.QtCore import QUrl
+from PySide6.QtWidgets import QFrame, QTextBrowser
+from PySide6.QtWebEngineWidgets import QWebEngineView
+
+from data_engine.ui.gui.helpers import start_worker_thread
+
+if TYPE_CHECKING:
+    from data_engine.ui.gui.app import DataEngineWindow
+
+
+def _explicit_missing_error_detail(subject: str) -> str:
+    return f"{subject} did not provide any additional error details."
+
+
+def create_docs_browser(window: "DataEngineWindow"):
+    if os.environ.get("QT_QPA_PLATFORM") != "offscreen":
+        window.docs_uses_webengine = True
+        browser = QWebEngineView()
+        browser.setStyleSheet("background: #ffffff;")
+        return browser
+    window.docs_uses_webengine = False
+    browser = QTextBrowser()
+    browser.setOpenExternalLinks(True)
+    browser.setFrameShape(QFrame.Shape.NoFrame)
+    return browser
+
+
+def docs_build_dir(window: "DataEngineWindow") -> Path:
+    return window.workspace_paths.documentation_dir / "_build" / "html"
+
+
+def initialize_docs_view(window: "DataEngineWindow") -> None:
+    docs_root = docs_build_dir(window)
+    window.docs_root_dir = docs_root if docs_root.is_dir() else None
+    if window.docs_root_dir is None:
+        window.docs_status_label.setText("Built documentation is not available yet.")
+        window.docs_generate_button.setVisible(True)
+        window.docs_generate_button.setEnabled(not window.docs_build_running)
+        if window.docs_build_running:
+            window.docs_browser.setHtml("<h2>Building documentation</h2><p>Generating the in-app docs site...</p>")
+        else:
+            window.docs_browser.setHtml(
+                "<h2>Documentation unavailable</h2><p>Generate the Sphinx site to populate the in-app docs view.</p>"
+            )
+        return
+
+    window.docs_generate_button.setVisible(False)
+    window.docs_generate_button.setEnabled(True)
+    load_docs_page(window, window._DOCS_HOME_PAGE)
+
+
+def start_docs_build(window: "DataEngineWindow") -> None:
+    if window.docs_build_running:
+        return
+    window.docs_build_running = True
+    initialize_docs_view(window)
+    start_worker_thread(window, target=window._run_docs_build_worker)
+
+
+def run_docs_build_worker(window: "DataEngineWindow") -> None:
+    build_dir = docs_build_dir(window)
+    try:
+        build_dir.parent.mkdir(parents=True, exist_ok=True)
+        completed = subprocess.run(
+            [
+                sys.executable,
+                "-m",
+                "sphinx",
+                "-b",
+                "html",
+                str(window.workspace_paths.sphinx_source_dir),
+                str(build_dir),
+            ],
+            capture_output=True,
+            text=True,
+            check=True,
+        )
+        message = completed.stdout.strip() or "Documentation build completed."
+        window.signals.docs_build_finished.emit(True, message)
+    except Exception as exc:
+        detail = str(exc)
+        if isinstance(exc, subprocess.CalledProcessError):
+            detail = (exc.stderr or exc.stdout or str(exc)).strip()
+        window.signals.docs_build_finished.emit(
+            False,
+            detail or _explicit_missing_error_detail("Documentation build"),
+        )
+
+
+def finish_docs_build(window: "DataEngineWindow", succeeded: bool, message: str) -> None:
+    window.docs_build_running = False
+    if succeeded:
+        initialize_docs_view(window)
+        window.docs_status_label.setText("index.html")
+        return
+    initialize_docs_view(window)
+    if not message:
+        message = _explicit_missing_error_detail("Documentation build")
+    window.docs_status_label.setText(message)
+    window._show_message_box_later(
+        title=window.windowTitle(),
+        text=f"Documentation build failed.\n\n{message}",
+        tone="error",
+    )
+
+
+def load_docs_page(window: "DataEngineWindow", file_name: str) -> None:
+    if window.docs_root_dir is None:
+        return
+    target = window.docs_root_dir / file_name
+    if not target.exists():
+        window.docs_status_label.setText(f"Missing page: {file_name}")
+        window.docs_browser.setHtml(f"<h2>Missing documentation page</h2><p>{file_name}</p>")
+        return
+    window.docs_status_label.setText(target.name)
+    if window.docs_uses_webengine:
+        window.docs_browser.setUrl(QUrl.fromLocalFile(str(target)))
+    else:
+        window.docs_browser.setSource(QUrl.fromLocalFile(str(target)))
+
+
+__all__ = [
+    "create_docs_browser",
+    "docs_build_dir",
+    "finish_docs_build",
+    "initialize_docs_view",
+    "load_docs_page",
+    "run_docs_build_worker",
+    "start_docs_build",
+]

data_engine/ui/gui/presenters/logs.py

@@ -0,0 +1,58 @@
+"""Log-list presentation helpers for the desktop UI."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from PySide6.QtWidgets import QListWidgetItem
+
+from data_engine.views import format_raw_log_message as shared_format_raw_log_message
+from data_engine.ui.gui.widgets.logs import build_log_run_widget
+
+if TYPE_CHECKING:
+    from data_engine.domain import FlowLogEntry, FlowRunState
+    from data_engine.ui.gui.app import DataEngineWindow
+
+
+def refresh_log_view(window: "DataEngineWindow", *, force_scroll_to_bottom: bool = False) -> None:
+    scrollbar = window.log_view.verticalScrollBar()
+    previous_value = scrollbar.value()
+    previous_maximum = scrollbar.maximum()
+    should_follow_tail = force_scroll_to_bottom or previous_value >= max(previous_maximum - 1, 0)
+
+    window.log_view.setUpdatesEnabled(False)
+    window.log_view.clear()
+    card = window.flow_cards.get(window.selected_flow_name or "")
+    run_groups = window.log_service.runs_for_flow(window.runtime_binding.log_store, card.name) if card is not None else ()
+    presentation = window.detail_application.build_selected_flow_presentation(
+        card=card,
+        tracker=window.operation_tracker,
+        flow_states=window.flow_states,
+        run_groups=tuple(run_groups),
+        selected_run_key=None,
+        max_visible_runs=window._MAX_VISIBLE_LOG_RUNS,
+    )
+    for run_group in presentation.visible_run_groups:
+        add_log_run_item(window, run_group)
+    window.log_view.setUpdatesEnabled(True)
+
+    scrollbar = window.log_view.verticalScrollBar()
+    if should_follow_tail:
+        scrollbar.setValue(scrollbar.maximum())
+    else:
+        scrollbar.setValue(min(previous_value, scrollbar.maximum()))
+
+
+def add_log_run_item(window: "DataEngineWindow", run_group: "FlowRunState") -> None:
+    item = QListWidgetItem(run_group.display_label)
+    widget = build_log_run_widget(window, run_group)
+    item.setSizeHint(widget.sizeHint())
+    window.log_view.addItem(item)
+    window.log_view.setItemWidget(item, widget)
+
+
+def format_raw_log_message(entry: "FlowLogEntry") -> str:
+    return shared_format_raw_log_message(entry)
+
+
+__all__ = ["add_log_run_item", "format_raw_log_message", "refresh_log_view"]

data_engine/ui/gui/presenters/runtime_projection.py

@@ -0,0 +1,29 @@
+"""Daemon/runtime projection helpers for the desktop UI."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from data_engine.domain import RuntimeSessionState
+
+if TYPE_CHECKING:
+    from data_engine.ui.gui.app import DataEngineWindow
+
+
+def finish_daemon_startup(window: "DataEngineWindow", success: bool, error_text: str) -> None:
+    window._daemon_startup_in_progress = False
+    if not success and not error_text:
+        error_text = "Daemon startup did not provide any additional error details."
+    if not success and error_text and window.isVisible():
+        window._append_log_line(f"Daemon startup failed: {error_text}")
+    window._sync_from_daemon()
+
+
+def apply_daemon_snapshot(window: "DataEngineWindow", snapshot) -> None:
+    window.runtime_session = RuntimeSessionState.from_daemon_snapshot(snapshot, window.flow_cards.values())
+
+
+__all__ = [
+    "apply_daemon_snapshot",
+    "finish_daemon_startup",
+]

data_engine/ui/gui/presenters/sidebar.py

@@ -0,0 +1,88 @@
+"""Sidebar presentation helpers for the desktop UI."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from PySide6.QtWidgets import QLabel, QFrame, QWidget
+
+from data_engine.views.flow_display import FlowRowDisplay, GroupRowDisplay
+from data_engine.views.presentation import flow_group_name
+
+if TYPE_CHECKING:
+    from data_engine.ui.gui.app import DataEngineWindow
+
+
+def refresh_sidebar_selection(window: "DataEngineWindow") -> None:
+    for flow_name, widget in window.sidebar_flow_widgets.items():
+        selected = flow_name == window.selected_flow_name
+        flow_index = widget.property("flowIndex")
+        for label in widget.findChildren(QLabel, "sidebarFlowNumber"):
+            if isinstance(flow_index, int):
+                label.setText(f"{flow_index:02d}")
+        if widget.property("selected") == selected:
+            continue
+        widget.setProperty("selected", selected)
+        repolish_widget_tree(widget)
+
+
+def refresh_sidebar_state_views(window: "DataEngineWindow", changed_flow_names: set[str]) -> bool:
+    """Refresh sidebar labels/colors in place for state-only changes.
+
+    Return True when the caller should fall back to a full sidebar rebuild.
+    """
+    if not changed_flow_names or not window.sidebar_flow_widgets:
+        return True
+
+    affected_groups: set[str] = set()
+    for flow_name in changed_flow_names:
+        card = window.flow_cards.get(flow_name)
+        widget = window.sidebar_flow_widgets.get(flow_name)
+        if card is None or widget is None:
+            return True
+        affected_groups.add(flow_group_name(card))
+        state = window.flow_states.get(card.name, card.state)
+        flow_display = FlowRowDisplay.from_card(card, state, primary="name")
+        widget.setToolTip(flow_display.tooltip)
+        for label in widget.findChildren(QLabel, "sidebarFlowMeta"):
+            label.setText(flow_display.secondary)
+            label.setProperty("stateColor", flow_display.state_color)
+            repolish_widget_tree(label)
+        for label in widget.findChildren(QLabel, "sidebarStateDot"):
+            label.setProperty("stateColor", flow_display.state_color)
+            repolish_widget_tree(label)
+
+    for group_name in affected_groups:
+        group_widget = window.sidebar_group_widgets.get(group_name)
+        if group_widget is None:
+            return True
+        entries = [card for card in window.flow_cards.values() if flow_group_name(card) == group_name]
+        group_display = GroupRowDisplay.from_group(group_name, entries, window.flow_states)
+        for label in group_widget.findChildren(QLabel, "sidebarGroupMeta"):
+            label.setText(group_display.secondary)
+
+    return False
+
+
+def set_hovered(widget: QFrame, hovered: bool) -> None:
+    """Update one sidebar row hover property and repolish it."""
+    if widget.property("hovered") == hovered:
+        return
+    widget.setProperty("hovered", hovered)
+    repolish_widget_tree(widget)
+
+
+def repolish_widget_tree(widget: QWidget) -> None:
+    """Reapply stylesheet state to one widget and its child widgets."""
+    style = widget.style()
+    style.unpolish(widget)
+    style.polish(widget)
+    for child in widget.findChildren(QWidget):
+        child_style = child.style()
+        child_style.unpolish(child)
+        child_style.polish(child)
+        child.update()
+    widget.update()
+
+
+__all__ = ["refresh_sidebar_selection", "refresh_sidebar_state_views", "repolish_widget_tree", "set_hovered"]