haybale-graph-editor 0.0.2__tar.gz

haybale_graph_editor-0.0.2/.gitignore

@@ -0,0 +1,205 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#pdm.lock
+#   pdm stores project-wide configurations in .pdm.toml, but it is recommended to not include it
+#   in version control.
+#   https://pdm.fming.dev/latest/usage/project/#working-with-version-control
+.pdm.toml
+.pdm-python
+.pdm-build/
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+**/.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the enitre vscode folder
+.vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+.DS_Store
+saves/*.*
+
+# Dev-mode graphs (local testing only, not part of the repo)
+graphs/*.json
+# MkDocs build output
+site/
+
+# Local git worktrees (claude-code workflow)
+.worktrees/

haybale_graph_editor-0.0.2/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: haybale-graph-editor
+Version: 0.0.2
+Summary: Graph editor library for Haywire — host-agnostic visual graph editing
+License: MIT
+Requires-Python: >=3.10
+Requires-Dist: haywire-core~=0.0.2
+Requires-Dist: haywire-studio~=0.0.2

haybale_graph_editor-0.0.2/README.md

@@ -0,0 +1,9 @@
+# haybale-graph-editor
+
+Visual graph editor library for Haywire. Provides:
+
+- `GraphContainer` (Protocol) — what a graph-source library must implement
+- `GraphAppState` (AppState) — shared registry of open graph containers, keyed by `binding_id`
+- `GraphEditor` (BaseEditor) — the canvas-hosting editor surface
+
+Source libraries (e.g. `haybale-haystack`) register containers; this library renders them.

haybale_graph_editor-0.0.2/haybale_graph_editor/__init__.py

@@ -0,0 +1,59 @@
+"""haybale-graph-editor: graph editor library for Haywire.
+
+Provides the GraphContainer protocol, GraphAppState registry, and
+GraphEditor surface. Decoupled from any specific graph source — source
+libraries register their containers, this library renders them.
+"""
+
+from importlib.metadata import version as _pkg_version
+from pathlib import Path
+
+from haywire.core.library.base import BaseLibrary
+from haywire.core.library.decorator import library
+from haywire.core.state import LibraryStateRegistry
+from haywire.ui.editor.registry import EditorTypeRegistry
+
+# Public API re-exports
+from haybale_graph_editor.protocols import GraphContainer
+from haybale_graph_editor.state.graph_app_state import GraphAppState
+from haywire.ui.panel.registry import PanelRegistry
+
+__all__ = ["GraphContainer", "GraphAppState", "Library"]
+
+
+@library(
+    label="Graph Editor",
+    id="graph_editor",
+    version=_pkg_version("haybale-graph-editor"),
+    description="Visual graph editor library — host-agnostic",
+    url="",
+    help_url="",
+    author="",
+    author_url="",
+    dependencies=[],
+    tags=["graph-editor"],
+    file_watcher=True,
+)
+class Library(BaseLibrary):
+    """Graph Editor library."""
+
+    def register_components(self):
+        base_path = Path(__file__).parent
+
+        self.add_folder_to_registry(
+            folder_path=str(base_path / "state"),
+            registry_cls=LibraryStateRegistry,
+        )
+
+        self.add_folder_to_registry(
+            folder_path=str(base_path / "panels"),
+            registry_cls=PanelRegistry,
+        )
+
+        self.add_folder_to_registry(
+            folder_path=str(base_path / "editors"),
+            registry_cls=EditorTypeRegistry,
+        )
+
+    def validate(self) -> bool:
+        return True

haybale_graph_editor-0.0.2/haybale_graph_editor/editors/graph_canvas/__init__.py

@@ -0,0 +1,16 @@
+from .connection_info_popup import EdgeInfoPopup
+from .graph_canvas_manager import GraphCanvasManager
+from .node_menu_builder import NodeMenuBuilder
+from .ui_edge import EdgeVisualState
+from .ui_edge import UIEdge
+from .ui_node import UINode
+
+__all__ = [
+    "EdgeInfoPopup",
+    "EdgeVisualState",
+    "GraphCanvasManager",
+    "GraphEventMetadata",
+    "NodeMenuBuilder",
+    "UIEdge",
+    "UINode",
+]

haybale_graph_editor-0.0.2/haybale_graph_editor/editors/graph_canvas/connection_info_popup.py

@@ -0,0 +1,134 @@
+"""
+ConnectionInfoPopup - Detailed connection information display component
+
+This component provides a dedicated popup for inspecting edge/connection details including:
+- Connection path (nodes and ports)
+- Validation status
+- Error details with full error rendering
+- Warning messages
+- Adapter chain visualization and testing
+- Execution statistics
+"""
+
+from nicegui import ui
+from typing import Optional
+
+from haywire.core.edge.edge import Edge
+from haywire.core.errors.haywire_exception import HaywireException
+from haywire.core.edge.edge_wrapper import EdgeWrapperState
+
+from haywire.ui import elements as hui
+from haywire.ui.errors.error_info import error_render_detail
+
+from haywire.ui.components.popup import Popup
+
+
+class EdgeInfoPopup:
+    """Dedicated popup for displaying detailed connection/edge information."""
+
+    def __init__(self):
+        self._info_popup: Optional[Popup] = None
+
+    def show(self, x: float, y: float, edge_id: str, edge: Edge, state: EdgeWrapperState):
+        """Show detailed connection information in a dedicated popup."""
+        # Close any existing popup first
+        self.close()
+
+        # Create a larger popup for detailed information
+        popup = Popup.create_context_menu(
+            "Connection Details", x + 10, y + 10, width="400px", clamp_to_viewport=False
+        )
+
+        with popup:
+            with ui.column().classes("w-full gap-2 p-2"):
+                # Header with connection status
+                with ui.row().classes("w-full"):
+                    ui.label(f"{edge.edge_type}").classes("text-xs hw-text-muted ml-2 mt-2")
+                    is_valid = state.is_valid()
+                    status_icon = "✓" if is_valid else "✗"
+                    status_color = "hw-text-success" if is_valid else "hw-text-danger"
+                    status_text = "Valid" if is_valid else "Invalid"
+                    ui.label(f"{status_icon} {status_text}").classes(f"text-sm font-bold {status_color}")
+
+                ui.separator().classes("my-2")
+
+                # Error Section (if present, expandable, default open)
+                error = state.get_error()
+                if error and isinstance(error, HaywireException):
+                    with hui.expansion_section("Error Details"):
+                        with (
+                            ui.card()
+                            .classes("w-full p-3")
+                            .style("background: var(--hw-danger-bg); border: 1px solid var(--hw-danger);")
+                        ):
+                            ui.label(f"Category: {error.category}").classes("text-xs hw-text-danger ml-2")
+                            # Render the error detail with button to show full details
+                            error_render_detail(error)
+
+                # Warning Section (if present, expandable, default open)
+                if state.has_warning():
+                    with hui.expansion_section("Warning"):
+                        with (
+                            ui.card()
+                            .classes("w-full p-3")
+                            .style("background: var(--hw-bg-surface); border: 1px solid var(--hw-border);")
+                        ):
+                            with ui.column():
+                                for warning in state.warnings:
+                                    ui.label(f"⚠ {warning}").classes("text-xs hw-text-warning ml-2")
+
+                # Adapter Chain Section (if available, expandable, default closed)
+                if edge.chain_adapter_keys:
+                    with hui.expansion_section("Adapter Chain", default_open=False):
+                        with (
+                            ui.card()
+                            .classes("w-full p-3")
+                            .style("background: var(--hw-bg-surface); border: 1px solid var(--hw-border);")
+                        ):
+                            # Display each adapter in the chain
+                            for i, adapter_key in enumerate(edge.chain_adapter_keys, 1):
+                                ui.label(f"{i}. {adapter_key}").classes("text-xs hw-text-accent ml-2")
+
+                if state.execution_count > 0:
+                    # Execution Statistics Section (expandable, default closed)
+                    with hui.expansion_section("Execution Statistics", default_open=False):
+                        exec_count = state.execution_count
+                        ui.label(f"Execution Count: {exec_count}").classes("text-xs hw-text-muted ml-2")
+
+                        avg_time = state.average_execution_time_us
+                        if avg_time > 0:
+                            ui.label(f"Average Time: {avg_time:.1f} μs").classes(
+                                "text-xs hw-text-muted ml-2"
+                            )
+                        else:
+                            ui.label("Average Time: Not measured").classes("text-xs hw-text-dim ml-2")
+
+                        ui.label(f"Tested value: {state.example_test_value}").classes(
+                            "text-xs hw-text-muted ml-2"
+                        )
+                        ui.label(f"Tested result: {state.example_test_result}").classes(
+                            "text-xs hw-text-muted ml-2"
+                        )
+
+                # Connection Path Section (Expandable, default closed)
+                with hui.expansion_section("Connection Path", default_open=False):
+                    ui.label("Connection Path").classes("font-semibold text-sm")
+                    ui.label(f"{edge.source_node_id} [{edge.outlet_port_id}]").classes("text-xs opacity-70")
+                    ui.label("↓").classes("text-xs opacity-50 ml-2")
+                    ui.label(f"{edge.sink_node_id} [{edge.inlet_port_id}]").classes("text-xs opacity-70")
+
+                # Close button
+                ui.separator().classes("my-2")
+                btn_close = ui.button("Close", on_click=lambda: self.close())
+                btn_close.props("flat")
+                btn_close.classes("w-full text-sm py-2")
+
+        popup.open()
+        self._info_popup = popup
+
+    def close(self):
+        """Close the connection info popup."""
+        if self._info_popup:
+            self._info_popup.close()
+            self._info_popup.delete()
+            self._info_popup = None

haybale_graph_editor-0.0.2/haybale_graph_editor/editors/graph_canvas/event_handlers.py

@@ -0,0 +1,46 @@
+"""
+Event handler registration system for the enhanced graph canvas event system.
+
+This module provides:
+- Decorator for registering event handlers
+- Type-safe handler registration
+- Automatic handler discovery
+- build_event_handler_map: scan multiple handler sources into a dispatch map
+"""
+
+from typing import Callable, Dict, List, Type
+from haywire.ui.components.graph.event_definitions import BaseGraphEvent
+
+
+def handles_event(*event_classes: Type[BaseGraphEvent]):
+    """Decorator to register methods as handlers for specific event classes"""
+
+    def decorator(func: Callable):
+        setattr(func, "_handles_event_classes", event_classes)
+        return func
+
+    return decorator
+
+
+def build_event_handler_map(sources: List[object]) -> Dict[str, Callable]:
+    """
+    Build an event-type → handler mapping by scanning a list of handler sources.
+
+    For each source object, scans all methods for the ``_handles_event_classes``
+    attribute set by the ``@handles_event`` decorator.  When two sources register
+    the same event type the later source wins.
+
+    Args:
+        sources: Objects whose methods should be scanned for ``@handles_event``.
+
+    Returns:
+        Dict mapping event_type strings to bound handler methods.
+    """
+    handlers: Dict[str, Callable] = {}
+    for source in sources:
+        for method_name in dir(source):
+            method = getattr(source, method_name)
+            if hasattr(method, "_handles_event_classes"):
+                for event_class in method._handles_event_classes:
+                    handlers[event_class.event_type] = method
+    return handlers