anywidget-graph 0.2.8__tar.gz → 0.2.10__tar.gz

anywidget_graph-0.2.10/CHANGELOG.md

@@ -0,0 +1,127 @@
+# Changelog
+
+## 0.2.10
+
+### New Features
+
+- **Spring layout (d3-force)**: New default layout using d3-force with charge, link-distance and collision forces; produces clean hub-spoke rings for hierarchical data like Neo4j browser
+- **Degree-based node sizing**: When no explicit `size_field` is set, nodes are sized by their connection count; hub nodes appear larger and push neighbors into natural rings
+- **Filter-aware layouts**: Switching layout or clicking refresh now re-runs the layout using only visible nodes, respecting type filters and search state
+
+### Improvements
+
+- Spring layout is the new default (renamed to "Default" in the dropdown)
+- Force layout uses `linLogMode` for better community separation
+- Cluster layout filters out hidden node types before packing
+- Filter panel refresh button triggers a layout refresh
+
+## 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.8 → anywidget_graph-0.2.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: anywidget-graph
-Version: 0.2.8
+Version: 0.2.10
 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'

anywidget_graph-0.2.10/examples/test_hierarchy.py

@@ -0,0 +1,99 @@
+"""Marimo demo: hierarchical repo-like graph to test force layout with hub-spoke data."""
+
+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):
+    # Simulate a repository structure:
+    # 1 Repository -> 4 Directories -> Files -> TypeDefinitions
+    nodes = [
+        {"id": "repo", "labels": ["Repository"], "name": "my-app"},
+    ]
+    edges = []
+
+    dirs = ["src", "lib", "tests", "config"]
+    file_id = 0
+    type_id = 0
+
+    for d in dirs:
+        did = f"dir_{d}"
+        nodes.append({"id": did, "labels": ["Directory"], "name": d})
+        edges.append({"source": "repo", "target": did, "label": "CONTAINS", "type": "CONTAINS"})
+
+        # Each directory has 3-8 files
+        import random
+
+        random.seed(hash(d))
+        n_files = random.randint(3, 8)
+        for i in range(n_files):
+            fid = f"file_{file_id}"
+            fname = f"{d}/file_{i}.py"
+            nodes.append({"id": fid, "labels": ["File"], "name": fname})
+            edges.append({"source": did, "target": fid, "label": "CONTAINS", "type": "CONTAINS"})
+            file_id += 1
+
+            # Each file has 1-5 type definitions
+            n_types = random.randint(1, 5)
+            for _j in range(n_types):
+                tid = f"type_{type_id}"
+                tname = f"Class_{type_id}"
+                nodes.append({"id": tid, "labels": ["TypeDefinition"], "name": tname})
+                edges.append({"source": fid, "target": tid, "label": "DEFINES", "type": "DEFINES"})
+                type_id += 1
+
+                # Some types depend on other types (cross-file references)
+                if type_id > 3 and random.random() < 0.3:
+                    dep = f"type_{random.randint(0, type_id - 2)}"
+                    edges.append({"source": tid, "target": dep, "label": "DEPENDS_ON", "type": "DEPENDS_ON"})
+
+        # Some cross-directory imports
+        if d != "src":
+            edges.append(
+                {
+                    "source": did,
+                    "target": "dir_src",
+                    "label": "IMPORTS_FROM",
+                    "type": "IMPORTS_FROM",
+                }
+            )
+
+    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}
+
+Hierarchical repo graph: Repository -> Directories -> Files -> TypeDefinitions
+""")
+    return ()
+
+
+if __name__ == "__main__":
+    app.run()

anywidget_graph-0.2.10/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.8 → anywidget_graph-0.2.10}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "anywidget-graph"
-version = "0.2.8"
+version = "0.2.10"
 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.8 → anywidget_graph-0.2.10}/src/anywidget_graph/ui/__init__.py

@@ -151,6 +151,7 @@ import Sigma from "https://esm.sh/sigma@3.0.0";
 import circular from "https://esm.sh/graphology-layout@0.6.1/circular.js";
 import random from "https://esm.sh/graphology-layout@0.6.1/random.js";
 import forceAtlas2 from "https://esm.sh/graphology-layout-forceatlas2@0.10.1";
+import * as d3Force from "https://esm.sh/d3-force@3.0.0";
 import neo4j from "https://cdn.jsdelivr.net/npm/neo4j-driver@5.28.0/lib/browser/neo4j-web.esm.min.js";
 
 // === Icons ===