pycforge 0.15.2__py3-none-any.whl

pycforge/ide/theme_workspace_stylesheet.py

@@ -0,0 +1,155 @@
+"""Phase 15C editor-workspace additions to the PyCForge visual system."""
+
+from __future__ import annotations
+
+from string import Template
+
+from .visual_tokens import (
+    PYCFORGE_COLORS,
+    PyCForgeColors,
+    color_tokens,
+)
+
+
+_WORKSPACE_QSS = Template(
+    r"""
+QTabBar#SourceDocumentTabs {
+    background: qlineargradient(x1:0,y1:0,x2:1,y2:0,
+        stop:0 ${void},stop:0.55 ${canvas},stop:1 ${surface_raised});
+    border: 1px solid ${border};
+    border-bottom: 1px solid ${border_strong};
+    border-radius: 7px;
+    padding: 3px 4px 0 4px;
+}
+QTabBar#SourceDocumentTabs::tab {
+    color: ${text_soft};
+    background: ${surface};
+    border: 1px solid ${border};
+    border-bottom: 2px solid ${border};
+    border-top-left-radius: 6px;
+    border-top-right-radius: 6px;
+    padding: 7px 12px;
+    min-width: 110px;
+}
+QTabBar#SourceDocumentTabs::tab:hover {
+    color: #FFFFFF;
+    background: ${surface_hover};
+    border-bottom: 2px solid ${blue};
+}
+QTabBar#SourceDocumentTabs::tab:selected {
+    color: #FFFFFF;
+    background: qlineargradient(x1:0,y1:0,x2:1,y2:0,
+        stop:0 ${selection},stop:0.75 ${violet_dim},stop:1 ${warm_dim});
+    border-color: ${blue};
+    border-bottom: 2px solid ${violet_bright};
+}
+QTabBar#SourceDocumentTabs:focus {
+    border: 1px solid ${focus_ring};
+    border-bottom: 2px solid ${violet};
+}
+QWidget#SourceBreadcrumbBar {
+    background: qlineargradient(x1:0,y1:0,x2:1,y2:0,
+        stop:0 ${canvas},stop:0.72 ${surface},stop:1 ${violet_dim});
+    border: 1px solid ${border};
+    border-left: 2px solid ${blue};
+    border-radius: 6px;
+}
+QToolButton#BreadcrumbButton {
+    color: ${text_soft};
+    background: transparent;
+    border: 1px solid transparent;
+    border-radius: 5px;
+    padding: 3px 7px;
+}
+QToolButton#BreadcrumbButton:hover {
+    color: #FFFFFF;
+    background: ${surface_hover};
+    border-color: ${blue_dim};
+}
+QToolButton#BreadcrumbButton:focus {
+    color: #FFFFFF;
+    border: 1px solid ${focus_ring};
+    background: ${selection};
+}
+QLabel#BreadcrumbSeparator {
+    color: ${violet_bright};
+    padding: 0 1px;
+}
+QDialog#CommandPaletteDialog {
+    background: qlineargradient(x1:0,y1:0,x2:0,y2:1,
+        stop:0 ${surface_raised},stop:0.55 ${canvas},stop:1 ${void});
+    border: 1px solid ${blue};
+    border-radius: 10px;
+}
+QLineEdit#CommandPaletteQuery {
+    color: #FFFFFF;
+    background: ${void};
+    border: 1px solid ${blue};
+    border-bottom: 2px solid ${violet};
+    border-radius: 8px;
+    padding: 9px 11px;
+}
+QTreeWidget#CommandPaletteResults,
+QTreeWidget#BundleSearchTree,
+QTreeWidget#OutlineTree,
+QTreeWidget#SessionHistoryTree {
+    color: ${text_soft};
+    background: ${void};
+    border: 1px solid ${border_strong};
+    border-radius: 7px;
+}
+QTreeWidget#CommandPaletteResults::item,
+QTreeWidget#BundleSearchTree::item,
+QTreeWidget#OutlineTree::item,
+QTreeWidget#SessionHistoryTree::item {
+    border-bottom: 1px solid ${surface_raised};
+    padding: 6px 5px;
+}
+QTreeWidget#CommandPaletteResults::item:hover,
+QTreeWidget#BundleSearchTree::item:hover,
+QTreeWidget#OutlineTree::item:hover,
+QTreeWidget#SessionHistoryTree::item:hover {
+    color: #FFFFFF;
+    background: ${surface_hover};
+}
+QTreeWidget#CommandPaletteResults::item:selected,
+QTreeWidget#BundleSearchTree::item:selected,
+QTreeWidget#OutlineTree::item:selected,
+QTreeWidget#SessionHistoryTree::item:selected {
+    color: #FFFFFF;
+    background: qlineargradient(x1:0,y1:0,x2:1,y2:0,
+        stop:0 ${selection},stop:1 ${violet_dim});
+    border-left: 3px solid ${blue_bright};
+}
+QWidget#BundleSearchView,
+QWidget#OutlineView,
+QWidget#SessionHistoryView {
+    background: qlineargradient(x1:0,y1:0,x2:0,y2:1,
+        stop:0 ${surface_raised},stop:1 ${canvas});
+}
+QFrame#SourceSplitSurface {
+    background: ${void};
+    border: 1px solid ${border};
+    border-top: 2px solid ${blue_dim};
+    border-radius: 7px;
+}
+QLabel#GeneratedCWindowLabel {
+    color: ${warning_bright};
+    background: ${warning_dim};
+    border: 1px solid ${warm_dim};
+    border-radius: 7px;
+    padding: 3px 8px;
+}
+"""
+)
+
+
+def build_workspace_stylesheet(
+    colors: PyCForgeColors = PYCFORGE_COLORS,
+) -> str:
+    """Return deterministic styling for the Phase 15C workspace surfaces."""
+
+    return _WORKSPACE_QSS.substitute(dict(color_tokens(colors))).strip() + "\n"
+
+
+__all__ = ["build_workspace_stylesheet"]

pycforge/ide/visual_tokens.py

@@ -0,0 +1,142 @@
+"""Headless-safe semantic tokens for the PyCForge desktop visual system.
+
+The optional Qt workspace and its tests share these values without importing
+PyQt5.  Colors are named for their role rather than a particular widget so the
+visual language remains coherent across menus, editors, panels, and future
+presentation surfaces.
+"""
+
+from __future__ import annotations
+
+from dataclasses import asdict, dataclass
+from types import MappingProxyType
+from typing import Mapping
+
+
+@dataclass(frozen=True, slots=True)
+class PyCForgeColors:
+    """Professional graphite palette with restrained operational accents."""
+
+    void: str = "#070A10"
+    canvas: str = "#0B0F16"
+    surface: str = "#111823"
+    surface_raised: str = "#172130"
+    surface_active: str = "#1D2939"
+    surface_hover: str = "#243348"
+    border: str = "#29384A"
+    border_strong: str = "#3B526A"
+    text: str = "#F1F5FA"
+    text_soft: str = "#C8D2DE"
+    text_muted: str = "#9BAABC"
+    text_disabled: str = "#748497"
+    blue: str = "#4FB6FF"
+    blue_bright: str = "#7BCCFF"
+    blue_dim: str = "#1B425D"
+    cyan: str = "#4FB6FF"
+    cyan_bright: str = "#7BCCFF"
+    cyan_dim: str = "#1B425D"
+    violet: str = "#A58BFF"
+    violet_bright: str = "#C0AEFF"
+    violet_dim: str = "#443B70"
+    warm: str = "#FF9A52"
+    warm_bright: str = "#FFB878"
+    warm_dim: str = "#55321F"
+    success: str = "#5AD8A6"
+    success_bright: str = "#91EDC8"
+    success_dim: str = "#173C30"
+    warning: str = "#FFC56F"
+    warning_bright: str = "#FFDEA3"
+    warning_dim: str = "#49371B"
+    error: str = "#FF7085"
+    error_bright: str = "#FFABB8"
+    error_dim: str = "#49212A"
+    selection: str = "#244F70"
+    selection_active: str = "#2C638B"
+    focus_ring: str = "#7BCCFF"
+
+
+@dataclass(frozen=True, slots=True)
+class PyCForgeMetrics:
+    """Logical-pixel metrics; Qt applies the effective display scale."""
+
+    radius_small: int = 4
+    radius_control: int = 6
+    radius_panel: int = 8
+    radius_menu: int = 9
+    icon_menu: int = 18
+    icon_toolbar: int = 20
+    icon_navigator: int = 18
+    focus_width: int = 2
+    menu_outer_padding: int = 6
+    menu_item_vertical_padding: int = 7
+    menu_item_left_padding: int = 38
+    menu_item_right_padding: int = 36
+
+
+PYCFORGE_COLORS = PyCForgeColors()
+PYCFORGE_METRICS = PyCForgeMetrics()
+
+
+def color_tokens(
+    colors: PyCForgeColors = PYCFORGE_COLORS,
+) -> Mapping[str, str]:
+    """Return an immutable token mapping suitable for stylesheet expansion."""
+
+    return MappingProxyType(asdict(colors))
+
+
+def relative_luminance(color: str) -> float:
+    """Return WCAG relative luminance for an exact ``#RRGGBB`` color."""
+
+    red, green, blue = _rgb_channels(color)
+    linear = tuple(
+        channel / 12.92
+        if channel <= 0.04045
+        else ((channel + 0.055) / 1.055) ** 2.4
+        for channel in (red, green, blue)
+    )
+    return (
+        0.2126 * linear[0]
+        + 0.7152 * linear[1]
+        + 0.0722 * linear[2]
+    )
+
+
+def contrast_ratio(first: str, second: str) -> float:
+    """Return the WCAG contrast ratio between two exact RGB colors."""
+
+    lighter, darker = sorted(
+        (relative_luminance(first), relative_luminance(second)),
+        reverse=True,
+    )
+    return (lighter + 0.05) / (darker + 0.05)
+
+
+def _rgb_channels(color: str) -> tuple[float, float, float]:
+    if (
+        not isinstance(color, str)
+        or len(color) != 7
+        or not color.startswith("#")
+    ):
+        raise ValueError("color must use exact #RRGGBB notation")
+    try:
+        values = tuple(
+            int(color[index : index + 2], 16) / 255.0
+            for index in (1, 3, 5)
+        )
+    except ValueError as exc:
+        raise ValueError(
+            "color must use exact #RRGGBB notation"
+        ) from exc
+    return values  # type: ignore[return-value]
+
+
+__all__ = [
+    "PYCFORGE_COLORS",
+    "PYCFORGE_METRICS",
+    "PyCForgeColors",
+    "PyCForgeMetrics",
+    "color_tokens",
+    "contrast_ratio",
+    "relative_luminance",
+]

pycforge/ide/worker_protocol.py

@@ -0,0 +1,80 @@
+"""Public facade for the bounded isolated-converter worker protocol.
+
+Frames are canonical JSON transported through ``send_bytes`` and
+``recv_bytes`` only.  The cohesive private codec modules keep request,
+result/event, and low-level JSON validation responsibilities separate while
+this module preserves the original Phase 15A import surface.
+"""
+
+from __future__ import annotations
+
+from ._worker_event_codec import (
+    decode_event,
+    encode_failure,
+    encode_progress,
+    encode_terminal,
+    receive_event,
+    send_event,
+)
+from ._worker_protocol_types import (
+    FAILURE_CLASSIFICATIONS,
+    MAX_CONTROL_BYTES,
+    MAX_DIAGNOSTICS,
+    MAX_EVENT_BYTES,
+    MAX_FAILURE_MESSAGE_CHARS,
+    MAX_JSON_DEPTH,
+    MAX_REQUEST_BYTES,
+    MAX_SOURCE_BYTES,
+    MAX_SOURCE_DOCUMENTS,
+    PROTOCOL_SCHEMA,
+    ByteConnection,
+    WorkerControl,
+    WorkerEvent,
+    WorkerProtocolError,
+    WorkerRequest,
+)
+from ._worker_request_codec import (
+    decode_control,
+    decode_request,
+    encode_cancel,
+    encode_request,
+    receive_control,
+    receive_request,
+    send_cancel,
+    send_request,
+)
+from ._worker_request_data import bundle_fingerprint_for_request
+
+
+__all__ = [
+    "FAILURE_CLASSIFICATIONS",
+    "MAX_CONTROL_BYTES",
+    "MAX_DIAGNOSTICS",
+    "MAX_EVENT_BYTES",
+    "MAX_FAILURE_MESSAGE_CHARS",
+    "MAX_JSON_DEPTH",
+    "MAX_REQUEST_BYTES",
+    "MAX_SOURCE_BYTES",
+    "MAX_SOURCE_DOCUMENTS",
+    "PROTOCOL_SCHEMA",
+    "ByteConnection",
+    "WorkerControl",
+    "WorkerEvent",
+    "WorkerProtocolError",
+    "WorkerRequest",
+    "bundle_fingerprint_for_request",
+    "decode_control",
+    "decode_event",
+    "decode_request",
+    "encode_cancel",
+    "encode_failure",
+    "encode_progress",
+    "encode_request",
+    "encode_terminal",
+    "receive_control",
+    "receive_event",
+    "receive_request",
+    "send_cancel",
+    "send_event",
+    "send_request",
+]