@cratis/event-models 0.118.2 → 0.120.0

package/dist/Geometry/linkGeometry.d.ts

@@ -30,12 +30,36 @@ export declare function rectAt(point: Point): Rect;
  * content rather than the full (specification-inclusive) footprint.
  */
 export declare function contentRectOf(rect: Rect, contentHeight: number): Rect;
-/** The point a link drag starts from: the right edge of a rectangle, vertically centered. */
+/** The side of a rectangle a connection dot sits on. */
+export declare enum LinkSide {
+    Top = "top",
+    Right = "right",
+    Bottom = "bottom",
+    Left = "left"
+}
+export declare const linkSides: LinkSide[];
+/** The connection dot of a rectangle on the given side: that edge's midpoint. */
+export declare function sideAnchor(rect: Rect, side: LinkSide): Point;
+/** The axis a curve leaving or arriving on the given side follows. */
+export declare function axisOfSide(side: LinkSide): CurveAxis;
+/** The point a link drag starts from by default: the right edge of a rectangle, vertically centered. */
 export declare function linkAnchor(rect: Rect): Point;
+/** The sides a link between two rectangles leaves the source from and arrives at on the target. */
+export interface FacingSides {
+    source: LinkSide;
+    target: LinkSide;
+}
+/**
+ * Chooses the facing sides from the relative position of the two rectangle centers: along the
+ * dominant axis the link leaves the source on the side facing the target and arrives on the opposite
+ * side of the target (a target below connects at its top dot, to the left at its right dot, ...).
+ * Ties on the axis prefer horizontal, and identical centers prefer right to left.
+ */
+export declare function facingSides(source: Rect, target: Rect): FacingSides;
 /**
- * Computes the spline endpoints between two rectangles: the curve leaves and arrives on the facing
- * edges along the dominant axis between the two centers, at each edge's midpoint, with the tangents
- * following that axis — the same curve style as the connections between the cards inside a slice.
+ * Computes the spline endpoints between two rectangles: the curve snaps from the source's connection
+ * dot to the target's dot on the facing sides (see facingSides), with the tangents following that
+ * axis — the same curve style as the connections between the cards inside a slice.
  */
 export declare function computeSplineEndpoints(source: Rect, target: Rect): SplineEndpoints;
 /** The midpoint between two points. */