@knowvah/dot-engine 1.2.7 → 1.4.0

package/dist/api/geometry.d.ts

@@ -85,7 +85,28 @@ export interface NodeGeometry {
  * in order. An edge with no routed spline produces an empty `points` array.
  * `label` is present only when the edge carries a centre label.
  *
- * @see lib/common/types.h:ED_spl, ED_label
+ * `tailLabel`/`headLabel` are the `taillabel`/`headlabel` port labels. They
+ * are present only once the layout has actually *placed* them (C `lp->set`),
+ * which is the same gate `render()` applies before emitting the `<text>`:
+ * a declared port label that place_portlabel skipped (no spline, IGNORED edge
+ * type) still holds calloc-zero coordinates, so it is reported as absent
+ * rather than as a label at the origin.
+ *
+ * `sp`/`ep` are the arrow attachment points. When an end carries an arrow the
+ * spline is shortened to leave room for it, and the arrow spans from the
+ * terminal control point out to this point — so a consumer drawing its own
+ * arrowheads reads the tip here instead of extrapolating one. Each is present
+ * only when that end actually has an arrow (C `sflag`/`eflag`); with no arrow
+ * the field holds the calloc-zero point, which is not geometry.
+ *
+ * These are the *attachment* points on the node boundary, verbatim from the
+ * bezier — with `arrowhead=none` the spline simply ends there. Graphviz's own
+ * renderer insets the arrow polygon it draws by a penwidth-dependent amount
+ * (measured: ~1.5pt at `penwidth=1`, ~6.2pt at `penwidth=5`), so `ep` is the
+ * point to draw an arrow *to*, not a copy of the rendered polygon's tip.
+ *
+ * @see lib/common/types.h:ED_spl, ED_label, ED_tail_label, ED_head_label
+ * @see lib/common/types.h:bezier (sflag/eflag, sp/ep)
  */
 export interface EdgeGeometry {
     tail: string;
@@ -95,11 +116,43 @@ export interface EdgeGeometry {
         x: number;
         y: number;
     }[];
+    /**
+     * Arrow attachment point at the tail end, if that end carries an arrow.
+     * @see lib/common/types.h:bezier.sp
+     */
+    sp?: {
+        x: number;
+        y: number;
+    };
+    /**
+     * Arrow attachment point at the head end, if that end carries an arrow.
+     * @see lib/common/types.h:bezier.ep
+     */
+    ep?: {
+        x: number;
+        y: number;
+    };
     /** Centre edge label position, if present. @see lib/common/types.h:ED_label */
     label?: {
         x: number;
         y: number;
     };
+    /**
+     * `taillabel` position, if placed.
+     * @see lib/common/types.h:ED_tail_label
+     */
+    tailLabel?: {
+        x: number;
+        y: number;
+    };
+    /**
+     * `headlabel` position, if placed.
+     * @see lib/common/types.h:ED_head_label
+     */
+    headLabel?: {
+        x: number;
+        y: number;
+    };
 }
 /**
  * Per-cluster geometry extracted after layout, in points.

package/dist/api/geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/api/geometry.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAS/C,+CAA+C;AAC/C,MAAM,MAAM,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnC,+EAA+E;IAC/E,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAClC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAsHD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,cAAc,CAuB1E"}
+{"version":3,"file":"geometry.d.ts","sourceRoot":"","sources":["../../src/api/geometry.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAU/C,+CAA+C;AAC/C,MAAM,MAAM,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;AAElC;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG;IAAE,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAAC;AAEhD;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,MAAM,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACnC;;;OAGG;IACH,EAAE,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B;;;OAGG;IACH,EAAE,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9B,+EAA+E;IAC/E,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC;;;OAGG;IACH,SAAS,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,cAAc,CAAC;IACvB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAqKD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,cAAc,CAuB1E"}

package/dist/api.js

@@ -686,6 +686,20 @@ function collectEdgePoints(edge, flipY) {
   }
   return pts;
 }
+function placedLabelPos(lbl, flipY) {
+  if (lbl === void 0 || !lbl.set) return void 0;
+  return { x: lbl.pos.x, y: flipY(lbl.pos.y) };
+}
+function arrowAttachPoints(edge, flipY) {
+  const spl = edge.info.spl;
+  if (spl === void 0 || spl.size === 0) return {};
+  const out = {};
+  const first = spl.list[0];
+  if (first.sflag !== 0) out.sp = { x: first.sp.x, y: flipY(first.sp.y) };
+  const last = spl.list[spl.size - 1];
+  if (last.eflag !== 0) out.ep = { x: last.ep.x, y: flipY(last.ep.y) };
+  return out;
+}
 function snapshotEdge(edge, flipY) {
   const geom = {
     tail: edge.tail.name,
@@ -696,6 +710,13 @@ function snapshotEdge(edge, flipY) {
   if (lbl !== void 0) {
     geom.label = { x: lbl.pos.x, y: flipY(lbl.pos.y) };
   }
+  const tailLabel = placedLabelPos(edge.info.tail_label, flipY);
+  if (tailLabel !== void 0) geom.tailLabel = tailLabel;
+  const headLabel = placedLabelPos(edge.info.head_label, flipY);
+  if (headLabel !== void 0) geom.headLabel = headLabel;
+  const { sp, ep } = arrowAttachPoints(edge, flipY);
+  if (sp !== void 0) geom.sp = sp;
+  if (ep !== void 0) geom.ep = ep;
   return geom;
 }
 function snapshotCluster(sg, yAxis, flipY) {