@knowvah/dot-engine 1.4.0 → 1.6.0

package/dist/api/geometry.d.ts

@@ -92,6 +92,12 @@ export interface NodeGeometry {
  * type) still holds calloc-zero coordinates, so it is reported as absent
  * rather than as a label at the origin.
  *
+ * `xlabel` is the `xlabel` external label, positioned by the force-placement
+ * search rather than by spline midpoint arithmetic, so it is not derivable
+ * from `label` or `points`. It carries the same `lp->set` gate: a declared
+ * xlabel the search could not fit is reported as absent, exactly as
+ * `render()` declines to draw it.
+ *
  * `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
@@ -105,7 +111,8 @@ export interface NodeGeometry {
  * (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:ED_spl, ED_label, ED_tail_label, ED_head_label,
+ *   ED_xlabel
  * @see lib/common/types.h:bezier (sflag/eflag, sp/ep)
  */
 export interface EdgeGeometry {
@@ -153,6 +160,14 @@ export interface EdgeGeometry {
         x: number;
         y: number;
     };
+    /**
+     * `xlabel` (external label) position, if placed.
+     * @see lib/common/types.h:ED_xlabel
+     */
+    xlabel?: {
+        x: number;
+        y: number;
+    };
 }
 /**
  * Per-cluster geometry extracted after layout, in points.
@@ -167,7 +182,15 @@ export interface EdgeGeometry {
  * `class="cluster"` polygon, so a consumer quantizing to SVG precision gets
  * byte-conformant geometry.
  *
+ * `label` is the cluster title's placed position and measured size, present
+ * only when the cluster declares a label. Unlike the edge port labels, it is
+ * *not* gated on the label's `set` flag: C draws a cluster label on existence
+ * alone (emit.c:3920 has no `->set` test, unlike emit_edge_label:2891), so an
+ * unplaced one still renders at whatever pos it holds. Gating here would hide
+ * geometry `render()` acts on.
+ *
  * @see lib/common/types.h:GD_bb (of a cluster subgraph)
+ * @see lib/common/types.h:GD_label (textlabel_t.pos / .dimen)
  */
 export interface ClusterGeometry {
     /** Cluster subgraph name (e.g. `cluster6`); encodes nesting. */
@@ -176,6 +199,18 @@ export interface ClusterGeometry {
     y: number;
     width: number;
     height: number;
+    /**
+     * Cluster label placement, if the cluster has one. `x`/`y` are the **centre**
+     * of the label space (matching `EdgeGeometry.label`, not the box corner
+     * `x`/`y` above); `width`/`height` are its measured size.
+     * @see lib/common/postproc.c:place_graph_label
+     */
+    label?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
 }
 /**
  * Plain, JSON-serializable snapshot of the graph's computed geometry.

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;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"}
+{"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;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;IACrC;;;OAGG;IACH,MAAM,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACnC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;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;IACf;;;;;OAKG;IACH,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE;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;AAsLD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,cAAc,CAuB1E"}

package/dist/api.js

@@ -714,6 +714,8 @@ function snapshotEdge(edge, flipY) {
   if (tailLabel !== void 0) geom.tailLabel = tailLabel;
   const headLabel = placedLabelPos(edge.info.head_label, flipY);
   if (headLabel !== void 0) geom.headLabel = headLabel;
+  const xlabel = placedLabelPos(edge.info.xlabel, flipY);
+  if (xlabel !== void 0) geom.xlabel = xlabel;
   const { sp, ep } = arrowAttachPoints(edge, flipY);
   if (sp !== void 0) geom.sp = sp;
   if (ep !== void 0) geom.ep = ep;
@@ -721,7 +723,7 @@ function snapshotEdge(edge, flipY) {
 }
 function snapshotCluster(sg, yAxis, flipY) {
   const bb = sg.info.bb;
-  return {
+  const geom = {
     name: sg.name,
     x: bb.ll.x,
     // 'up' keeps the lower-left y; 'down' flips the upper-right y to the
@@ -730,6 +732,16 @@ function snapshotCluster(sg, yAxis, flipY) {
     width: bb.ur.x - bb.ll.x,
     height: bb.ur.y - bb.ll.y
   };
+  const lab = sg.info.label;
+  if (lab !== void 0) {
+    geom.label = {
+      x: lab.pos.x,
+      y: flipY(lab.pos.y),
+      width: lab.dimen.x,
+      height: lab.dimen.y
+    };
+  }
+  return geom;
 }
 function collectClusters(sg, yAxis, flipY, out) {
   for (const c of sg.info.clust ?? []) {