GraphSpatialIndex<T> class

Simplified, type-safe spatial index for graph elements.

This is the primary API for spatial operations in the node flow system. It provides:

• Type-safe operations (accepts domain objects directly)
• Automatic batching (no manual flush needed)
• Simple core operations: add, update, remove, query

Core Operations

// Adding/updating elements
index.update(node);
index.updateAnnotation(annotation);
index.updateConnection(connection, segmentBounds);

// Removing elements
index.remove(node);
index.removeAnnotation(annotationId);
index.removeConnection(connectionId);

// Querying
final result = index.hitTest(point);
final nodes = index.nodesAt(point);
final nodes = index.nodesIn(bounds);

Batch Operations

For multiple operations, use batch to defer index updates:

index.batch(() {
  for (final node in nodes) {
    index.update(node);
  }
});