anywidget-graph 0.2.7__tar.gz → 0.2.9__tar.gz

anywidget_graph-0.2.9/CHANGELOG.md

@@ -0,0 +1,112 @@
+# Changelog
+
+## 0.2.9
+
+### New Features
+
+- **Filter panel**: Schema sidebar transformed into a filter panel with per-type checkboxes, counts, color pickers and "all / none" toggle links for both node and edge types
+- **Type-based node coloring**: Nodes automatically colored by their type (first label), matching the filter panel swatches
+- **Color pickers**: Click any type's color swatch in the filter panel to change it; graph updates in real-time
+- **Level-of-detail labels**: Labels auto-hide on small or zoomed-out nodes; thresholds scale with graph size
+- **Circle-packing cluster layout**: Deterministic circle packing with radius proportional to `sqrt(nodeCount)` and mini-force within each cluster for organic internal structure
+- **Edge interaction**: Edges are now clickable with type shown in the properties panel
+
+### Bug Fixes
+
+- Fixed widget height growing on scroll; wrapper now locked to fixed height
+- Fixed search filtering: now shows matching nodes plus first-degree neighbors and connecting edges, hides everything else
+- Fixed parallel edge crash by using Graphology multi-graph mode
+- Fixed graph disappearing when side panels open by refreshing renderer on resize
+- Fixed dark mode label color: adapts to current theme
+
+### Improvements
+
+- Zoom controls reordered: fit, zoom-in, zoom-out at top; layout and mode at bottom
+- Edge type shown in properties panel on click
+- Internal attributes (`nodeType`, `edgeType`) hidden from properties panel
+
+## 0.2.8
+
+### New Features
+
+- **Language-aware query dispatch**: GrafeoBackend routes queries to language-specific methods (`execute_cypher`, `execute_gremlin`, etc.) with fallback to generic `execute()`
+- **Results drawer**: Bottom drawer with tabbed nodes/edges tables, pagination and query timing
+- **Grafeo native dict support**: Detection and conversion of Grafeo's internal `_id`/`_labels`/`_source`/`_target`/`_type` dict format so native query results render correctly
+
+### Improvements
+
+- Added playground link at grafeo.ai to README
+
+## 0.2.7
+
+### Bug Fixes
+
+- Fixed lasso/box selection behavior
+
+### Improvements
+
+- Quality-of-life improvements to search and toolbar
+
+## 0.2.6
+
+### New Features
+
+- **Browser-side backends**: Added Grafeo server (HTTP), Grafeo WASM (browser-embedded) and Neo4j browser-side driver support
+- **Settings panel**: Full connection UI with backend selector, connection mode, language picker and connect/disconnect
+- **CosmosDB backend**: Added Azure CosmosDB Gremlin backend
+- **Demo mode**: WASM-based demo with pre-populated dataset
+- **Schema browser**: Sidebar with node labels and relationship types; click to query
+- **Properties panel**: Right sidebar showing selected node/edge details
+- **Zoom and pan controls**: Zoom in/out/fit buttons, box select mode, click select mode
+
+### Improvements
+
+- Updated docs, tests and dependencies
+- HTML export template fix
+- Zoom controls added to graph container
+
+## 0.2.5
+
+### New Features
+
+- **Major UI overhaul**: Modular component architecture with toolbar, schema panel, settings, properties and results drawer
+- **Multiple backends**: Grafeo, Neo4j, LadybugDB, ArangoDB and CosmosDB support
+- **Test suite**: Comprehensive test coverage with 55+ tests
+- **Node interaction**: Click, drag, pin, double-click expand, delete and multi-select
+- **Force layout**: ForceAtlas2 with dynamic parameters scaling by graph size
+- **Keyboard shortcuts**: F to fit, Escape to deselect, Delete to remove selected
+
+### Improvements
+
+- Consistent code formatting with ruff
+
+## 0.2.4
+
+### Bug Fixes
+
+- Fixed ESM bundling issue in UI init
+
+## 0.2.3
+
+### Bug Fixes
+
+- Fixed rendering issue in graph container
+- Updated dependencies
+
+## 0.2.2
+
+### Improvements
+
+- Added Apache 2.0 license
+- ESM bundle aggregation for widget JS
+
+## 0.2.1
+
+### Improvements
+
+- Updated README with usage examples
+- Code formatting pass
+
+## 0.1.0
+
+- Initial release of anywidget-graph

{anywidget_graph-0.2.7 → anywidget_graph-0.2.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: anywidget-graph
-Version: 0.2.7
+Version: 0.2.9
 Summary: Interactive graph visualization for Python notebooks using anywidget
 Project-URL: Homepage, https://grafeo.dev/
 Project-URL: Repository, https://github.com/GrafeoDB/anywidget-graph
@@ -29,7 +29,7 @@ Requires-Dist: marimo>=0.20; extra == 'dev'
 Requires-Dist: prek>=0.3; extra == 'dev'
 Requires-Dist: pytest>=9.0.2; extra == 'dev'
 Requires-Dist: ruff>=0.15; extra == 'dev'
-Requires-Dist: ty>=0.0.20; extra == 'dev'
+Requires-Dist: ty>=0.0; extra == 'dev'
 Provides-Extra: embed
 Provides-Extra: grafeo
 Requires-Dist: grafeo>=0.5; extra == 'grafeo'
@@ -326,6 +326,7 @@ graph.save_html("graph.html")           # Write HTML to file
 - [anywidget](https://anywidget.dev/), custom Jupyter widgets made easy
 - [Grafeo](https://github.com/GrafeoDB/grafeo), embeddable graph database
 - [grafeo-web](https://github.com/GrafeoDB/grafeo-web), Grafeo in the browser
+- [Playground](https://grafeo.ai), interactive browser playground for Grafeo
 
 ## License
 

{anywidget_graph-0.2.7 → anywidget_graph-0.2.9}/README.md

@@ -285,6 +285,7 @@ graph.save_html("graph.html")           # Write HTML to file
 - [anywidget](https://anywidget.dev/), custom Jupyter widgets made easy
 - [Grafeo](https://github.com/GrafeoDB/grafeo), embeddable graph database
 - [grafeo-web](https://github.com/GrafeoDB/grafeo-web), Grafeo in the browser
+- [Playground](https://grafeo.ai), interactive browser playground for Grafeo
 
 ## License
 

anywidget_graph-0.2.9/examples/test_large_graph.py

@@ -0,0 +1,91 @@
+"""Marimo demo: large graph to test filtering, search, and LOD."""
+
+import marimo
+
+__generated_with = "0.19.5"
+app = marimo.App(width="medium")
+
+
+@app.cell
+def _():
+    import marimo as mo
+
+    return (mo,)
+
+
+@app.cell
+def _():
+    from anywidget_graph import Graph
+
+    return (Graph,)
+
+
+@app.cell
+def _(Graph):
+    import random
+
+    random.seed(42)
+
+    node_types = {
+        "Person": 40,
+        "Company": 15,
+        "Product": 25,
+        "City": 10,
+        "Skill": 20,
+    }
+
+    edge_types = ["WORKS_AT", "LIVES_IN", "KNOWS", "MANAGES", "USES", "SELLS", "HAS_SKILL"]
+
+    nodes = []
+    node_ids = []
+    for label, count in node_types.items():
+        for i in range(count):
+            nid = f"{label.lower()}_{i}"
+            node_ids.append(nid)
+            nodes.append(
+                {
+                    "id": nid,
+                    "labels": [label],
+                    "name": f"{label} {i}",
+                }
+            )
+
+    edges = []
+    for _ in range(250):
+        src = random.choice(node_ids)
+        tgt = random.choice(node_ids)
+        if src != tgt:
+            edges.append(
+                {
+                    "source": src,
+                    "target": tgt,
+                    "label": random.choice(edge_types),
+                    "type": random.choice(edge_types),
+                }
+            )
+
+    graph = Graph.from_dict(
+        {"nodes": nodes, "edges": edges},
+        width=1000,
+        height=700,
+    )
+
+    graph  # noqa: B018
+    return (graph,)
+
+
+@app.cell
+def _(graph, mo):
+    mo.md(f"""
+**Selected node:** {graph.selected_node}
+
+Try:
+- Open the Filter panel (sidebar button) to toggle node/edge types
+- Use the search bar to filter (e.g. type "Person" or "Company")
+- Zoom in/out to see label LOD
+""")
+    return ()
+
+
+if __name__ == "__main__":
+    app.run()

{anywidget_graph-0.2.7 → anywidget_graph-0.2.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "anywidget-graph"
-version = "0.2.7"
+version = "0.2.9"
 description = "Interactive graph visualization for Python notebooks using anywidget"
 readme = "README.md"
 license = "Apache-2.0"
@@ -30,7 +30,7 @@ dev = [
     "prek>=0.3",
     "pytest>=9.0.2",
     "ruff>=0.15",
-    "ty>=0.0.20",
+    "ty>=0.0",
     "marimo>=0.20",
 ]
 networkx = ["networkx>=3.0"]

{anywidget_graph-0.2.7 → anywidget_graph-0.2.9}/src/anywidget_graph/__init__.py

@@ -3,4 +3,4 @@
 from anywidget_graph.widget import Graph
 
 __all__ = ["Graph"]
-__version__ = "0.2.7"
+__version__ = "0.2.8"

{anywidget_graph-0.2.7 → anywidget_graph-0.2.9}/src/anywidget_graph/backends/grafeo.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any
+from typing import TYPE_CHECKING, Any, ClassVar
 
 from anywidget_graph.converters import (
     get_node_id,
@@ -19,6 +19,14 @@ if TYPE_CHECKING:
 class GrafeoBackend:
     """Backend for Grafeo database connections."""
 
+    _LANGUAGE_METHODS: ClassVar[dict[str, str]] = {
+        "cypher": "execute_cypher",
+        "gremlin": "execute_gremlin",
+        "graphql": "execute_graphql",
+        "sparql": "execute_sparql",
+        "sql": "execute_sql",
+    }
+
     def __init__(self, db: Any) -> None:
         """Initialize with a GrafeoDB instance."""
         self._db = db
@@ -30,7 +38,11 @@ class GrafeoBackend:
 
     def execute(self, query: str, *, language: str = "cypher") -> tuple[list[dict], list[dict]]:
         """Execute a query in the specified language and return (nodes, edges)."""
-        result = self._db.execute(query)
+        method_name = self._LANGUAGE_METHODS.get(language)
+        if method_name and hasattr(self._db, method_name):
+            result = getattr(self._db, method_name)(query)
+        else:
+            result = self._db.execute(query)
         return self._process_result(result)
 
     def fetch_schema(self) -> tuple[list[dict], list[dict]]:
@@ -61,7 +73,14 @@ class GrafeoBackend:
         for record in records:
             items = self._extract_items(record)
             for _key, value in items:
-                if is_node(value):
+                if self._is_grafeo_node(value):
+                    node_dict = self._grafeo_node_to_dict(value)
+                    node_id = node_dict["id"]
+                    if node_id not in nodes:
+                        nodes[node_id] = node_dict
+                elif self._is_grafeo_relationship(value):
+                    edges.append(self._grafeo_relationship_to_dict(value))
+                elif is_node(value):
                     node_id = get_node_id(value)
                     if node_id not in nodes:
                         nodes[node_id] = node_to_dict(value)
@@ -70,6 +89,45 @@ class GrafeoBackend:
 
         return list(nodes.values()), edges
 
+    @staticmethod
+    def _is_grafeo_node(obj: Any) -> bool:
+        """Check if a value is a Grafeo node dict (has ``_id`` and ``_labels``)."""
+        return isinstance(obj, dict) and "_id" in obj and "_labels" in obj
+
+    @staticmethod
+    def _is_grafeo_relationship(obj: Any) -> bool:
+        """Check if a value is a Grafeo relationship dict (has ``_source``, ``_target``, ``_type``)."""
+        return isinstance(obj, dict) and "_source" in obj and "_target" in obj and "_type" in obj
+
+    @staticmethod
+    def _grafeo_node_to_dict(node: dict) -> dict:
+        """Convert a Grafeo node dict to the widget node format."""
+        node_id = str(node["_id"])
+        labels = node.get("_labels", [])
+        result: dict = {"id": node_id}
+        if labels:
+            result["label"] = labels[0]
+            result["labels"] = list(labels)
+        for key, value in node.items():
+            if not key.startswith("_"):
+                result[key] = value
+        if "label" not in result and "name" in result:
+            result["label"] = result["name"]
+        return result
+
+    @staticmethod
+    def _grafeo_relationship_to_dict(rel: dict) -> dict:
+        """Convert a Grafeo relationship dict to the widget edge format."""
+        result: dict = {
+            "source": str(rel["_source"]),
+            "target": str(rel["_target"]),
+            "label": str(rel["_type"]),
+        }
+        for key, value in rel.items():
+            if not key.startswith("_"):
+                result[key] = value
+        return result
+
     def _extract_items(self, record: Any) -> list[tuple[str, Any]]:
         """Extract key-value items from a record."""
         if hasattr(record, "items"):

{anywidget_graph-0.2.7 → anywidget_graph-0.2.9}/src/anywidget_graph/ui/__init__.py

@@ -140,6 +140,7 @@ def get_esm() -> str:
     schema_js = _read_file(_UI_DIR / "schema.js")
     settings_js = _read_file(_UI_DIR / "settings.js")
     properties_js = _read_file(_UI_DIR / "properties.js")
+    results_js = _read_file(_UI_DIR / "results.js")
     toolbar_js = _read_file(_UI_DIR / "toolbar.js")
     index_js = _read_file(_UI_DIR / "index.js")
 
@@ -173,6 +174,9 @@ import neo4j from "https://cdn.jsdelivr.net/npm/neo4j-driver@5.28.0/lib/browser/
 // === Properties Panel ===
 {_strip_imports_exports(properties_js)}
 
+// === Results Drawer ===
+{_strip_imports_exports(results_js)}
+
 // === Toolbar ===
 {_resolve_namespaces(toolbar_js)}
 

{anywidget_graph-0.2.7 → anywidget_graph-0.2.9}/src/anywidget_graph/ui/icons.js

@@ -16,4 +16,6 @@ export const ICONS = {
   zoomOut: `<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/><line x1="8" y1="11" x2="14" y2="11"/></svg>`,
   zoomFit: `<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M15 3h6v6M9 21H3v-6M21 3l-7 7M3 21l7-7"/></svg>`,
   search: `<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><circle cx="11" cy="11" r="8"/><line x1="21" y1="21" x2="16.65" y2="16.65"/></svg>`,
+  chevronUp: `<svg width="12" height="12" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M18 15l-6-6-6 6"/></svg>`,
+  table: `<svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="3" y="3" width="18" height="18" rx="2"/><path d="M3 9h18M3 15h18M9 3v18"/></svg>`,
 };