pycforge-sdk 0.6.3__py3-none-any.whl

pycforge_sdk/gui/visual/theme_stylesheet.py

@@ -0,0 +1,597 @@
+"""Build the PyCForge Qt stylesheet from semantic visual tokens."""
+
+from __future__ import annotations
+from string import Template
+from .icons import pycforge_icon_path
+from .theme_steel_stylesheet import build_steel_stylesheet
+from .theme_workspace_stylesheet import build_workspace_stylesheet
+from .visual_tokens import PYCFORGE_COLORS, PyCForgeColors, color_tokens
+
+
+_PYCFORGE_QSS_TEMPLATE = Template(
+    r"""
+QMainWindow, QDialog {
+    background: ${canvas};
+    color: ${text};
+}
+QWidget {
+    color: ${text};
+    selection-background-color: ${selection};
+    selection-color: ${text};
+}
+QWidget#workspaceShell, QWidget[role="workspace-shell"] { background: transparent; }
+QFrame#DocumentNavigator {
+    background: ${surface};
+    border: 1px solid ${border};
+    border-right: 1px solid ${border_strong};
+    border-radius: 8px;
+}
+QFrame#editorPanel, QFrame#detailsPanel, QFrame[role="panel"] {
+    background: ${surface};
+    border: 1px solid ${border};
+    border-radius: 8px;
+}
+QLabel {
+    background: transparent;
+    color: ${text_soft};
+}
+QLabel#PanelEyebrow {
+    color: ${blue_bright};
+    font-weight: 700;
+    padding: 3px 0 5px 0;
+    border-bottom: 1px solid ${blue_dim};
+}
+QLabel#MutedLabel { color: ${text_muted}; padding: 2px 3px; }
+QLabel#PathLabel { color: ${text_muted}; font-style: italic; padding: 2px 4px; }
+QLabel#ActiveModuleLabel {
+    color: ${violet_bright};
+    font-weight: 600;
+    padding: 2px 6px;
+    border-left: 2px solid ${violet_dim};
+}
+QLabel[role="panel-title"] {
+    color: ${text};
+    font-weight: 600;
+    padding: 4px 2px 5px 2px;
+    border-bottom: 1px solid ${blue_dim};
+}
+QFrame#SourceEditorSurface, QFrame#GeneratedCPanel {
+    background: ${void};
+    border: 1px solid ${border};
+    border-radius: 7px;
+}
+QFrame#GeneratedCPanel { border-top: 2px solid ${warm_dim}; }
+QPlainTextEdit#PythonSourceEditor, QPlainTextEdit#PythonSourceEditorSecondary, QPlainTextEdit#GeneratedCEditor {
+    border: 0;
+    border-radius: 0;
+    padding: 0;
+    placeholder-text-color: ${text_muted};
+}
+QPlainTextEdit#GeneratedCEditor { background: ${void}; color: ${text_soft}; }
+QLabel[status="neutral"], QLabel[role="status-chip"] {
+    color: ${text_soft};
+    background: ${surface_active};
+    border: 1px solid ${border_strong};
+    border-radius: 9px;
+    padding: 2px 8px;
+}
+QLabel[status="success"] {
+    color: ${success_bright};
+    background: ${success_dim};
+    border: 1px solid ${success};
+    border-radius: 9px;
+    padding: 2px 8px;
+}
+QLabel[status="warning"] {
+    color: ${warning_bright};
+    background: ${warning_dim};
+    border: 1px solid ${warning};
+    border-radius: 9px;
+    padding: 2px 8px;
+}
+QLabel[status="error"] {
+    color: ${error_bright};
+    background: ${error_dim};
+    border: 1px solid ${error};
+    border-radius: 9px;
+    padding: 2px 8px;
+}
+QFrame#ToastBanner { border-radius: 7px; padding: 1px; }
+QFrame#ToastBanner QLabel {
+    color: ${text}; background: transparent; font-weight: 500;
+}
+QFrame#ToastBanner QToolButton {
+    min-width: 22px;
+    min-height: 22px;
+    padding: 2px;
+    color: ${text_soft};
+    background: transparent;
+    border: 1px solid transparent;
+}
+QFrame#ToastBanner QToolButton:hover,
+QFrame#ToastBanner QToolButton:focus {
+    color: ${text};
+    background: ${surface_hover};
+    border-color: ${focus_ring};
+}
+QFrame#ToastBanner[tone="info"] {
+    color: ${text_soft};
+    background: ${blue_dim};
+    border: 1px solid ${blue};
+    border-left: 3px solid ${blue};
+}
+QFrame#ToastBanner[tone="success"] {
+    color: ${success_bright};
+    background: ${success_dim};
+    border: 1px solid ${success};
+    border-left: 3px solid ${success};
+}
+QFrame#ToastBanner[tone="warning"] {
+    color: ${warning_bright};
+    background: ${warning_dim};
+    border: 1px solid ${warning};
+    border-left: 3px solid ${warning};
+}
+QFrame#ToastBanner[tone="error"] {
+    color: ${error_bright};
+    background: ${error_dim};
+    border: 1px solid ${error};
+    border-left: 3px solid ${error};
+}
+QFrame#ToastBanner[tone="info"] QLabel { color: ${text_soft}; }
+QFrame#ToastBanner[tone="success"] QLabel { color: ${success_bright}; }
+QFrame#ToastBanner[tone="warning"] QLabel { color: ${warning_bright}; }
+QFrame#ToastBanner[tone="error"] QLabel { color: ${error_bright}; }
+QFrame#ToastBanner[tone="info"] QToolButton { color: ${text_soft}; }
+QFrame#ToastBanner[tone="success"] QToolButton { color: ${success_bright}; }
+QFrame#ToastBanner[tone="warning"] QToolButton { color: ${warning_bright}; }
+QFrame#ToastBanner[tone="error"] QToolButton { color: ${error_bright}; }
+QFrame#ToastBanner[tone="info"] QToolButton:hover, QFrame#ToastBanner[tone="info"] QToolButton:focus,
+QFrame#ToastBanner[tone="info"] QToolButton:pressed { background: ${blue_dim}; border-color: ${blue}; }
+QFrame#ToastBanner[tone="success"] QToolButton:hover, QFrame#ToastBanner[tone="success"] QToolButton:focus,
+QFrame#ToastBanner[tone="success"] QToolButton:pressed { background: ${success_dim}; border-color: ${success}; }
+QFrame#ToastBanner[tone="warning"] QToolButton:hover, QFrame#ToastBanner[tone="warning"] QToolButton:focus,
+QFrame#ToastBanner[tone="warning"] QToolButton:pressed { background: ${warning_dim}; border-color: ${warning}; }
+QFrame#ToastBanner[tone="error"] QToolButton:hover, QFrame#ToastBanner[tone="error"] QToolButton:focus,
+QFrame#ToastBanner[tone="error"] QToolButton:pressed { background: ${error_dim}; border-color: ${error}; }
+QMenuBar {
+    color: ${text_soft};
+    background: ${surface_raised};
+    border: 0;
+    border-bottom: 1px solid ${border_strong};
+    padding: 3px 6px;
+    spacing: 3px;
+}
+QMenuBar::item {
+    background: transparent;
+    border: 1px solid transparent;
+    border-radius: 5px;
+    padding: 6px 10px;
+}
+QMenuBar::item:selected, QMenuBar::item:pressed {
+    color: ${text};
+    background: ${surface_active};
+    border-color: ${border_strong};
+    border-bottom: 2px solid ${warm};
+}
+QMenuBar::item:disabled { color: ${text_disabled}; }
+QMenu, QMenu#PyCForgeMenu, QComboBox QAbstractItemView {
+    color: ${text};
+    background: ${surface};
+    border: 1px solid ${border_strong};
+    border-radius: 9px;
+    padding: 6px;
+    selection-background-color: ${selection};
+    selection-color: ${text};
+}
+QMenu::item, QMenu#PyCForgeMenu::item {
+    min-height: 18px;
+    padding: 7px 36px 7px 38px;
+    margin: 1px 3px;
+    border: 1px solid transparent;
+    border-radius: 5px;
+}
+QMenu::item:selected, QMenu#PyCForgeMenu::item:selected {
+    color: ${text};
+    background: ${selection};
+    border: 1px solid ${border_strong};
+    border-left: 3px solid ${blue_bright};
+}
+QMenu::item:pressed, QMenu#PyCForgeMenu::item:pressed {
+    color: ${text};
+    background: ${selection_active};
+    border-left: 3px solid ${blue_bright};
+    border-bottom: 2px solid ${warm};
+}
+QMenu::item:disabled, QMenu#PyCForgeMenu::item:disabled {
+    color: ${text_disabled}; background: transparent;
+    border-color: transparent;
+}
+QMenu#PyCForgeMenu[pycforgeTone="primary"]::item:selected {
+    background: ${selection_active};
+    color: ${text}; border-left: 3px solid ${warm_bright};
+}
+QMenu#PyCForgeMenu[pycforgeTone="danger"]::item:selected { color: ${error_bright}; background: ${error_dim}; border-left: 3px solid ${error}; }
+QMenu::separator { height: 1px; margin: 6px 12px; background: ${border}; }
+QMenu::icon { left: 12px; width: 18px; height: 18px; }
+QMenu::indicator {
+    width: 15px;
+    height: 15px;
+    left: 12px;
+    border: 1px solid ${border_strong};
+    border-radius: 4px;
+    background: ${canvas};
+}
+QMenu::indicator:checked {
+    image: url("${check_icon}");
+    background: ${blue_dim};
+    border: 1px solid ${blue_bright};
+}
+QMenu::right-arrow {
+    image: url("${chevron_icon}");
+    width: 14px;
+    height: 14px;
+    right: 10px;
+}
+QMenu::scroller {
+    height: 18px;
+    background: ${surface_active};
+    border: 1px solid ${border};
+}
+QToolBar {
+    color: ${text};
+    background: ${surface_raised};
+    border: 0;
+    border-bottom: 1px solid ${border_strong};
+    spacing: 5px;
+    padding: 7px 9px;
+}
+QToolBar::separator { width: 1px; margin: 4px 7px; background: ${border}; }
+QPushButton, QToolButton {
+    color: ${text_soft};
+    background: ${surface_raised};
+    border: 1px solid ${border_strong};
+    border-radius: 6px;
+    padding: 6px 10px;
+    min-height: 18px;
+}
+QPushButton:hover, QToolButton:hover {
+    color: ${text};
+    background: ${surface_hover};
+    border-color: ${blue};
+    border-bottom: 2px solid ${blue};
+}
+QPushButton:focus, QToolButton:focus {
+    color: ${text};
+    border: 1px solid ${focus_ring};
+    border-bottom: 2px solid ${violet};
+}
+QPushButton:pressed, QToolButton:pressed,
+QPushButton:checked, QToolButton:checked {
+    color: ${text};
+    background: ${blue_dim};
+    border-color: ${blue};
+    border-bottom: 2px solid ${warm};
+}
+QPushButton:disabled, QToolButton:disabled {
+    color: ${text_disabled};
+    background: ${surface};
+    border-color: ${border};
+}
+QPushButton[role="primary"], QToolButton[role="primary"] {
+    color: ${text};
+    background: ${selection_active};
+    border-color: ${blue_bright};
+    font-weight: 600;
+}
+QPushButton[role="danger"], QToolButton[role="danger"] {
+    color: ${error_bright}; background: ${error_dim}; border-color: ${error};
+}
+QToolButton#IconButton {
+    min-width: 28px;
+    max-width: 28px;
+    min-height: 28px;
+    max-height: 28px;
+    padding: 2px;
+    border-radius: 6px;
+}
+QPlainTextEdit, QTextEdit, QLineEdit, QSpinBox, QComboBox {
+    color: ${text};
+    background: ${canvas};
+    border: 1px solid ${border};
+    border-radius: 6px;
+    padding: 5px 7px;
+}
+QPlainTextEdit:focus, QTextEdit:focus, QLineEdit:focus,
+QSpinBox:focus, QComboBox:focus {
+    background: ${surface};
+    border: 1px solid ${blue};
+    border-bottom: 2px solid ${violet};
+}
+QPlainTextEdit:read-only, QTextEdit:read-only {
+    color: ${text_soft};
+    background: ${void};
+    border-color: ${border};
+}
+QLineEdit[state="error"], QPlainTextEdit[state="error"] {
+    border: 1px solid ${error};
+    border-bottom: 2px solid ${error};
+    background: ${error_dim};
+}
+QLineEdit[state="warning"], QPlainTextEdit[state="warning"] {
+    border: 1px solid ${warning};
+    border-bottom: 2px solid ${warning};
+    background: ${warning_dim};
+}
+QLineEdit[state="success"], QPlainTextEdit[state="success"] {
+    border: 1px solid ${success};
+    border-bottom: 2px solid ${success};
+    background: ${success_dim};
+}
+QLineEdit:disabled, QPlainTextEdit:disabled, QTextEdit:disabled,
+QComboBox:disabled, QSpinBox:disabled {
+    color: ${text_disabled};
+    background: ${surface};
+    border-color: ${border};
+}
+QLineEdit#NavigatorFilter {
+    background: ${void}; border-bottom: 2px solid ${blue_dim};
+}
+QWidget#findReplaceBar, QFrame#findReplaceBar,
+QWidget[role="find-bar"], QFrame[role="find-bar"] {
+    color: ${text};
+    background: ${surface};
+    border: 1px solid ${border_strong};
+    border-bottom: 2px solid ${warm_dim};
+    border-radius: 7px;
+}
+QListWidget#DocumentList {
+    color: ${text_soft};
+    background: ${void};
+    border: 1px solid ${border};
+    border-radius: 6px;
+    outline: 0;
+    padding: 3px;
+}
+QListWidget#DocumentList:focus {
+    border: 1px solid ${blue}; border-bottom: 2px solid ${violet};
+}
+QListWidget#DocumentList::item {
+    border: 1px solid transparent;
+    border-bottom: 1px solid ${surface_raised};
+    border-radius: 5px;
+    padding: 8px 7px;
+    margin: 1px 0;
+}
+QListWidget#DocumentList::item:hover {
+    color: ${text};
+    background: ${surface_hover};
+    border-color: ${border_strong};
+}
+QListWidget#DocumentList::item:selected {
+    color: ${text};
+    background: ${selection};
+    border: 1px solid ${blue};
+    border-left: 3px solid ${blue_bright};
+}
+QListWidget#DocumentList::item:disabled {
+    color: ${text_disabled}; background: ${surface};
+}
+QTabWidget::pane {
+    background: ${surface};
+    border: 1px solid ${border};
+    border-top: 1px solid ${border_strong};
+    border-radius: 6px;
+    top: -1px;
+}
+QTabBar::tab {
+    color: ${text_muted};
+    background: ${canvas};
+    border: 1px solid ${border};
+    border-bottom: 1px solid ${border_strong};
+    padding: 8px 13px;
+    min-width: 72px;
+}
+QTabBar::tab:hover {
+    color: ${text};
+    background: ${surface_active};
+    border-bottom: 2px solid ${blue};
+}
+QTabBar::tab:selected {
+    color: ${text};
+    background: ${surface_hover};
+    border-color: ${border_strong};
+    border-bottom: 2px solid ${violet};
+}
+QTabBar::tab:disabled { color: ${text_disabled}; background: ${canvas}; }
+QSplitter::handle { background: ${surface_raised}; border: 0; }
+QSplitter::handle:horizontal {
+    width: 5px;
+    border-left: 1px solid ${border};
+    border-right: 1px solid ${blue_dim};
+}
+QSplitter::handle:vertical {
+    height: 5px;
+    border-top: 1px solid ${border};
+    border-bottom: 1px solid ${blue_dim};
+}
+QSplitter::handle:hover { background: ${border_strong}; }
+QTreeView, QListView, QTableView {
+    color: ${text_soft};
+    background: ${canvas};
+    alternate-background-color: ${surface};
+    border: 1px solid ${border};
+    gridline-color: ${border};
+    outline: 0;
+}
+QTreeView::branch:has-children:closed, QTreeWidget::branch:has-children:closed { image: url("${chevron_icon}"); }
+QTreeView::branch:has-children:open, QTreeWidget::branch:has-children:open { image: url("${tree_open_icon}"); }
+QTreeView::branch:!has-children, QTreeWidget::branch:!has-children { image: none; }
+QTreeView:focus, QListView:focus, QTableView:focus {
+    border: 1px solid ${blue}; border-bottom: 2px solid ${violet};
+}
+QWidget#DiagnosticsView, QWidget#MappingsView, QWidget#InspectorTree {
+    background: ${canvas};
+    border: 0;
+}
+QWidget#DiagnosticsView QLineEdit,
+QWidget#MappingsView QLineEdit,
+QWidget#InspectorTree QLineEdit {
+    background: ${void};
+    border-color: ${border_strong};
+    border-bottom: 2px solid ${blue_dim};
+}
+QWidget#DiagnosticsView QLineEdit:focus,
+QWidget#MappingsView QLineEdit:focus,
+QWidget#InspectorTree QLineEdit:focus {
+    border-color: ${blue};
+    border-bottom: 2px solid ${violet};
+}
+QTreeWidget#DiagnosticsTree, QTreeWidget#MappingsTree,
+QWidget#InspectorTree QTreeWidget {
+    background: ${void};
+    border: 1px solid ${border};
+    border-radius: 6px;
+}
+QTreeWidget#DiagnosticsTree:focus,
+QTreeWidget#MappingsTree:focus,
+QWidget#InspectorTree QTreeWidget:focus {
+    border: 1px solid ${blue};
+    border-bottom: 2px solid ${violet};
+}
+QTextBrowser#DiagnosticDetails {
+    color: ${text_soft};
+    background: ${surface};
+    border: 1px solid ${border_strong};
+    border-left: 2px solid ${violet};
+    border-radius: 6px;
+    padding: 7px;
+}
+QTreeView::item, QListView::item, QTableView::item { padding: 4px; }
+QTreeView::item:hover, QListView::item:hover, QTableView::item:hover {
+    color: ${text}; background: ${surface_hover};
+}
+QTreeView::item:selected, QListView::item:selected, QTableView::item:selected {
+    color: ${text};
+    background: ${selection};
+    border-left: 2px solid ${blue_bright};
+}
+QTreeView::item:selected:focus,
+QListView::item:selected:focus,
+QTableView::item:selected:focus {
+    border: 1px solid ${focus_ring};
+    border-left: 3px solid ${violet};
+}
+QHeaderView::section {
+    color: ${text_soft};
+    background: ${surface_raised};
+    border: 0;
+    border-right: 1px solid ${border};
+    border-bottom: 1px solid ${border_strong};
+    padding: 6px 8px;
+}
+QScrollBar:vertical { background: ${canvas}; width: 14px; margin: 1px; }
+QScrollBar:horizontal { background: ${canvas}; height: 14px; margin: 1px; }
+QScrollBar::handle:vertical, QScrollBar::handle:horizontal {
+    background: ${border_strong};
+    border: 1px solid ${text_disabled};
+    border-radius: 2px;
+}
+QScrollBar::handle:vertical { min-height: 28px; }
+QScrollBar::handle:horizontal { min-width: 28px; }
+QAbstractScrollArea::corner { background: ${canvas}; border: 0; }
+QScrollBar::handle:vertical:hover, QScrollBar::handle:horizontal:hover {
+    background: ${selection_active}; border-color: ${blue};
+}
+QScrollBar::add-line, QScrollBar::sub-line,
+QScrollBar::add-page, QScrollBar::sub-page {
+    background: none;
+    border: none;
+    width: 0;
+    height: 0;
+}
+QStatusBar {
+    color: ${text_soft};
+    background: ${canvas};
+    border-top: 1px solid ${border_strong};
+}
+QStatusBar::item { border: 0; }
+QProgressBar {
+    color: ${text};
+    background: ${void};
+    border: 1px solid ${border};
+    border-radius: 6px;
+    text-align: center;
+    min-height: 16px;
+}
+QProgressBar::chunk {
+    background: ${blue};
+    border-radius: 5px;
+}
+QCheckBox, QRadioButton { color: ${text_soft}; spacing: 7px; }
+QCheckBox::indicator, QRadioButton::indicator { width: 15px; height: 15px; background: ${canvas}; border: 1px solid ${border_strong}; }
+QCheckBox::indicator:checked { image: url("${check_icon}"); background: ${selection}; border: 2px solid ${blue}; }
+QCheckBox::indicator:checked:disabled { image: url("${check_icon}"); background: ${surface_active}; border: 1px solid ${border_strong}; }
+QRadioButton::indicator { border-radius: 8px; }
+QRadioButton::indicator:checked {
+    background: ${blue};
+    border: 4px solid ${surface_active};
+}
+QCheckBox::indicator:focus, QRadioButton::indicator:focus {
+    border-color: ${focus_ring};
+}
+QToolTip {
+    color: ${text};
+    background: ${surface_active};
+    border: 1px solid ${blue};
+    font-size: 10pt;
+    padding: 3px 6px;
+}
+QDockWidget {
+    color: ${text}; titlebar-close-icon: none; titlebar-normal-icon: none;
+}
+QDockWidget::title {
+    color: ${text_soft};
+    background: ${surface_raised};
+    border-bottom: 1px solid ${border_strong};
+    padding: 6px;
+}
+QMainWindow[visualMode="high-contrast"],
+QDialog[visualMode="high-contrast"] { background: ${void}; }
+QWidget[visualMode="high-contrast"] QMenu,
+QWidget[visualMode="high-contrast"] QToolButton,
+QWidget[visualMode="high-contrast"] QPushButton,
+QWidget[visualMode="high-contrast"] QLineEdit,
+QWidget[visualMode="high-contrast"] QPlainTextEdit,
+QWidget[visualMode="high-contrast"] QTreeView,
+QWidget[visualMode="high-contrast"] QListView {
+    border-color: ${text_muted};
+}
+QWidget[visualMode="high-contrast"] QMenu::item:selected,
+QWidget[visualMode="high-contrast"] QTreeView::item:selected,
+QWidget[visualMode="high-contrast"] QListView::item:selected {
+    color: ${text};
+    background: ${selection_active};
+    border: 2px solid ${focus_ring};
+}
+"""
+)
+
+
+def build_pycforge_stylesheet(
+    colors: PyCForgeColors = PYCFORGE_COLORS,
+) -> str:
+    """Return the complete deterministic stylesheet for *colors*."""
+
+    values = dict(color_tokens(colors))
+    values.update({
+        "check_icon": pycforge_icon_path("check").as_posix(),
+        "chevron_icon": pycforge_icon_path("chevron-right").as_posix(),
+        "tree_open_icon": pycforge_icon_path("next-match").as_posix(),
+    })
+    foundation = _PYCFORGE_QSS_TEMPLATE.substitute(values).strip()
+    workspace = build_workspace_stylesheet(colors).strip()
+    steel = build_steel_stylesheet(colors).strip()
+    return foundation + "\n" + workspace + "\n" + steel + "\n"
+
+__all__ = ["build_pycforge_stylesheet"]