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

Segment Creation Strategy

Editable path styles support two modes:

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

Implementation Requirements

Concrete subclasses must implement:

• createSegmentsThroughWaypoints: How to create segments 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
  ({Offset start, List<PathSegment> segments}) createSegmentsThroughWaypoints(
    List<Offset> waypoints,
    ConnectionPathParameters params,
  ) {
    // Generate smooth step segments through waypoints with rounded corners
    return _generateSmoothSegments(waypoints, params.cornerRadius);
  }
}