Skip to content

docs: add detailed explanation of three edge rendering forms and operation points#2384

Draft
Copilot wants to merge 2 commits intomasterfrom
copilot/renderer-edge-types
Draft

docs: add detailed explanation of three edge rendering forms and operation points#2384
Copilot wants to merge 2 commits intomasterfrom
copilot/renderer-edge-types

Conversation

Copy link

Copilot AI commented Mar 3, 2026

The basic edge tutorial lacked any explanation of how the three built-in edge types differ in rendering and what interactive handles each provides.

Changes

Added two new sections to tutorial/basic/edge.zh.md and tutorial/basic/edge.en.md:

Three Edge Rendering Forms

Covers the SVG primitive used, path computation strategy, and click-area expansion approach for each type:

Edge type SVG element Path computation
line <line> Direct start→end, no calculation
polyline <polyline> A* + Manhattan distance, orthogonal routing around nodes
bezier <path> (M…C…) Auto-computed cubic Bézier control points (sNext / ePre)

Operation Point Differences

Explains the interactive handles available when an edge is selected:

Handle type line polyline bezier
Start/end adjust points
Per-segment drag (H/V)
Bézier control points (sNext / ePre)

Key behavioral notes documented:

  • line: path is immutable; only endpoints can be reconnected
  • polyline: horizontal segments drag vertically (ns-resize), vertical segments drag horizontally (ew-resize); adjustEdgeMiddle restricts dragging to middle segments only
  • bezier: selecting the edge reveals two independent control-point handles with guide lines via BezierAdjustOverlay; dragging either changes the curve shape on that side independently

🔒 GitHub Advanced Security automatically protects Copilot coding agent pull requests. You can protect all pull requests by enabling Advanced Security for your repositories. Learn more about Advanced Security.

@changeset-bot
Copy link

changeset-bot bot commented Mar 3, 2026

⚠️ No Changeset found

Latest commit: ec19b15

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

…on (zh/en)

Co-authored-by: CraneReturn <127602190+CraneReturn@users.noreply.github.com>
Copilot AI changed the title [WIP] Add detailed explanation of edge rendering types docs: add detailed explanation of three edge rendering forms and operation points Mar 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants