EditablePathConnectionStyle class abstract

Abstract base class for connection styles that support interactive editing of connection paths through control points.

This class extends ConnectionStyle to add support for user-defined waypoints (control points) that allow customization of the connection path. Concrete implementations define how paths are created through these waypoints.

Control Points

Control points are intermediate waypoints through which the connection path should pass. They are stored in the Connection.controlPoints list and allow users to:

• Add extra bends to the connection
• Move existing bends to customize the path
• Remove waypoints to simplify the path

Path Creation Strategy

Editable path styles support two modes:

1. Algorithmic mode (no control points): Uses the default path algorithm
2. Manual mode (with control points): Creates path through user-defined waypoints

Implementation Requirements

Concrete subclasses must implement:

• createPathThroughWaypoints: How to create a path through control points
• Optionally override requiresControlPoints if the style only works in manual mode

Example

class EditableSmoothStepConnectionStyle extends EditablePathConnectionStyle {
  @override
  String get id => 'editable-smoothstep';

  @override
  String get displayName => 'Editable Smooth Step';

  @override
  Path createPathThroughWaypoints(
    List<Offset> waypoints,
    ConnectionPathParameters params,
  ) {
    // Generate smooth step path through waypoints with rounded corners
    return _generateSmoothPath(waypoints, params.cornerRadius);
  }
}