@knowvah/dot-engine 0.1.0

package/dist/render/svg-graph.d.ts

@@ -0,0 +1,97 @@
+/**
+ * SVG document prologue and graph group open/close helpers.
+ * Split from svg-helpers.ts to keep that module under the size cap.
+ *
+ * NOTE: no ${...} template literals here — Lizard bug #2 (see
+ * svg-helpers.ts file header).
+ *
+ * @see plugin/core/gvrender_core_svg.c:svg_begin_graph
+ * @see plugin/core/gvrender_core_svg.c:svg_begin_page
+ */
+import type { Graph } from '../model/graph.js';
+import type { Box } from '../model/geom.js';
+import type { RenderJob } from '../gvc/job.js';
+/**
+ * Emit SVG tag. Group translate absorbs bb.ll + pad + margin/Z offset
+ * (svgBeginPage). ViewBox starts at (round(margin.x), round(margin.y)) --
+ * (0,0) only in the common no-margin case.
+ */
+export declare function emitSvgTag(job: RenderJob): void;
+/**
+ * Emit the graph `<g>` open tag with y-flip transform.
+ *
+ * translate(PAD, contentH+PAD) maps graphviz origin (0,0) to the
+ * bottom-left corner of the padded viewport.  Combined with devscale.y=-1,
+ * a node at graphviz (x,y) appears at SVG (x+PAD, h-PAD-y).
+ *
+ * @see plugin/core/gvrender_core_svg.c:svg_begin_page
+ */
+export declare function emitGraphGroupOpen(graphId: string, classStr: string, tx: number, ty: number, job: RenderJob): void;
+/**
+ * Conditionally emit `<title>` for user-visible graph names.
+ * @see plugin/core/gvrender_core_svg.c:svg_begin_page
+ */
+export declare function emitGraphTitle(g: Graph, job: RenderJob): void;
+/**
+ * Resolve the graph bgcolor attribute to the color string to use for the
+ * background polygon, or the BGCOLOR_TRANSPARENT sentinel to suppress it.
+ *
+ * Precedence mirrors emit_background (lib/common/emit.c:1476-1530):
+ *   - absent/empty → "white" (default white paper)
+ *   - "transparent" → BGCOLOR_TRANSPARENT sentinel (SVG is truecolor)
+ *   - gradient "c1:c2" → first solid color (AD3)
+ *   - else → the literal color string
+ *
+ * @see lib/common/emit.c:emit_background:1476
+ */
+export declare function resolveGraphBgcolor(bgcolorAttr: string | undefined): string;
+/**
+ * Emit background polygon covering the full padded content area.
+ *
+ * Omits the polygon entirely when resolvedColor is the transparent sentinel.
+ * Coordinates are in the group's local frame (y-flipped via devscale.y=-1):
+ *   x: [bb.ll.x - PAD, bb.ur.x + PAD]
+ *   y (flipped): [-(bb.ur.y + PAD), -(bb.ll.y - PAD)]
+ *
+ * @see plugin/core/gvrender_core_svg.c:svg_begin_page
+ * @see lib/common/emit.c:emit_background:1476
+ */
+export declare function emitGraphBackground(bb: Box, resolvedColor: string, job: RenderJob): void;
+/**
+ * Emit SVG prologue, padded `<svg>` tag, graph `<g>` with y-flip transform,
+ * and background polygon (color resolved from bgcolor attr).
+ *
+ * Y-axis: Graphviz y-up vs SVG y-down.  devscale.y=-1 negates all y coords
+ * before renderer callbacks; the graph `<g>` translate(PAD, contentH+PAD)
+ * places the Graphviz origin at the bottom-left of the padded viewport.
+ *
+ * @see plugin/core/gvrender_core_svg.c:svg_begin_graph
+ * @see plugin/core/gvrender_core_svg.c:svg_begin_page
+ * @see lib/common/emit.c:emit_background:1476
+ */
+export declare function svgBeginGraph(g: Graph, job: RenderJob): void;
+/**
+ * Per-page content: the graph group, title, and background — re-emitted per
+ * layer. The group id carries the layer prefix (e.g. `pvt_graph0`).
+ * @see plugin/core/gvrender_core_svg.c:svg_begin_page
+ */
+export declare function svgBeginPage(g: Graph, job: RenderJob): void;
+/**
+ * Emit the page background polygon. Split out of svg_begin_page so the
+ * device-layer page loop can wrap the background (and the graph label) in the
+ * graph's `<a>` anchor, matching C where emit_background is separate from
+ * gvrender_begin_page.
+ * @see lib/common/emit.c:emit_page (emit_background after begin_page)
+ */
+export declare function svgPageBackground(g: Graph, job: RenderJob): void;
+/** Close the graph `<g>` group. @see svg_end_page */
+export declare function svgEndPage(job: RenderJob): void;
+/** `<g id="<layer>" class="layer">` — only emitted when numLayers > 1. */
+export declare function svgBeginLayer(name: string, job: RenderJob): void;
+export declare function svgEndLayer(job: RenderJob): void;
+/**
+ * Close the graph `<g>` group and the `<svg>` element.
+ * @see plugin/core/gvrender_core_svg.c:svg_end_graph
+ */
+export declare function svgEndGraph(job: RenderJob): void;
+//# sourceMappingURL=svg-graph.d.ts.map

package/dist/render/svg-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-graph.d.ts","sourceRoot":"","sources":["../../src/render/svg-graph.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,GAAG,EAAS,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AA+C/C;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAsC/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,SAAS,GACb,IAAI,CAiBN;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAI7D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAU3E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAiBxF;AA2GD;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAqB5D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CA+B3D;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAEhE;AAED,qDAAqD;AACrD,wBAAgB,UAAU,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAE/C;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAEhE;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAEhD;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAEhD"}

package/dist/render/svg-helpers.d.ts

@@ -0,0 +1,122 @@
+/**
+ * SVG renderer helper functions.
+ *
+ * All shape-emission logic lives here as top-level export functions so
+ * Lizard's TypeScript parser tracks function boundaries correctly.
+ * Lizard only resets its function-tracking on the export keyword;
+ * bare function declarations are silently absorbed into the preceding
+ * exported function's body count.
+ *
+ * Lizard parser bugs (affect this file):
+ * 1. Regex literal containing a double-quote char (e.g. /"/g) unbalances
+ *    its string-quote tracker.  Use new RegExp('"', 'g') instead.
+ * 2. Template literals containing ${...} interpolations confuse the parser
+ *    and cause following non-exported functions to be absorbed into the
+ *    preceding exported function's line-count.  Avoid ${...} template
+ *    literals in exported functions; use string concatenation or
+ *    job.write/printDouble sequences instead.
+ *
+ * @see plugin/core/gvrender_core_svg.c
+ */
+import type { Node } from '../model/node.js';
+import type { Edge } from '../model/edge.js';
+import type { Point } from '../model/geom.js';
+import type { TextSpan } from '../common/emit-types.js';
+import type { RenderJob, ObjState } from '../gvc/job.js';
+import { PenType } from '../gvc/context.js';
+/**
+ * Padding (in graph units / points) added on all four sides of the bounding
+ * box, matching the C plugin descriptor `default_pad = 4.0`.
+ * @see plugin/core/gvrender_core_svg.c  (gvrender_features_t.default_pad)
+ */
+export declare const SVG_PAD = 4;
+/**
+ * Default graph-level margin (in points) when `margin=` is unset, matching
+ * the SVG plugin's `device_features_svg.default_margin` ({0,0}) — the
+ * `GVRENDER_PLUGIN` branch of `init_job_margin`'s fallback switch.
+ * @see plugin/core/gvrender_core_svg.c (device_features_svg.default_margin)
+ * @see lib/common/emit.c:3309-3331 init_job_margin
+ */
+export declare const SVG_MARGIN = 0;
+import { escapeXml, escapeXmlText, escapeXmlTitle } from './xml-escape.js';
+export { escapeXml, escapeXmlText, escapeXmlTitle };
+export declare function paintStr(obj: ObjState, useFill: boolean): string;
+export declare function emitDash(job: RenderJob, pen: PenType): void;
+export declare function emitPenWidth(job: RenderJob, pw: number): void;
+/**
+ * Emit fill/stroke style attributes in C's exact order: fill, fill-opacity,
+ * stroke, stroke-width, stroke-dasharray, stroke-opacity.
+ * @see plugin/core/gvrender_core_svg.c:165-213 svg_grstyle
+ */
+export declare function emitStyle(job: RenderJob, filled: boolean, gradFillUrl?: string): void;
+export declare function emitPoints(job: RenderJob, pts: Point[]): void;
+export declare function emitBezierPath(job: RenderJob, pts: Point[]): void;
+export declare function textAnchor(just: 'l' | 'n' | 'r'): string;
+export { emitSvgTag, emitGraphGroupOpen, emitGraphTitle, emitGraphBackground, svgBeginGraph, svgEndGraph, svgBeginPage, svgPageBackground, svgEndPage, svgBeginLayer, svgEndLayer, } from './svg-graph.js';
+export declare function svgBeginNode(n: Node, job: RenderJob): void;
+export declare function svgEndNode(job: RenderJob): void;
+/**
+ * Begin an edge group + `<title>`. The title is `tail[:tport]<sep>head[:hport]`
+ * built raw, then escaped — mirroring C's `\E` substitution (`labels.c`) fed
+ * through `gvputs_xml`. The port string is the resolved port name
+ * (`ED_*_port(e).name`): a compass replaces a record field when both are given
+ * (`A:f0:n` → `A:n`), and the dash escapes to `&#45;`.
+ * @see lib/common/labels.c:strdup_and_subst_obj (case 'E')
+ * @see plugin/core/gvrender_core_svg.c:svg_begin_edge
+ */
+export declare function svgBeginEdge(e: Edge, job: RenderJob): void;
+export declare function svgEndEdge(job: RenderJob): void;
+export declare function emitAnchorAttrs(href: string, tooltip: string, target: string, job: RenderJob): void;
+export declare function svgBeginAnchor(href: string, tooltip: string, target: string, id: string, job: RenderJob): void;
+export declare function svgEndAnchor(job: RenderJob): void;
+export declare function svgTextspan(pos: Point, span: TextSpan, job: RenderJob): void;
+/**
+ * Emit `<defs>` gradient block for a filled shape; returns the gradient id
+ * to use as fill="url(#id)", or undefined for solid/none fills (AD2, AD3).
+ * pts must be in y-up (Graphviz) coordinate space.
+ * @see plugin/core/gvrender_core_svg.c:647-694 (gradient dispatch)
+ */
+export declare function emitGradientDefs(job: RenderJob, ptsYup: Point[], filled: boolean): string | undefined;
+export declare function svgEllipse(center: Point, rx: number, ry: number, filled: boolean, job: RenderJob): void;
+export declare function svgPolygon(pts: Point[], filled: boolean, job: RenderJob): void;
+export declare function svgBezier(pts: Point[], filled: boolean, job: RenderJob): void;
+export declare function svgPolyline(pts: Point[], job: RenderJob): void;
+export declare function svgComment(text: string, job: RenderJob): void;
+/**
+ * Emit Bezier edge path with style from job.obj (AD1: no ad-hoc attr reads).
+ * Attribute order: fill="none" stroke="X" [stroke-width] [stroke-dasharray] d="..."
+ * @see plugin/core/gvrender_core_svg.c:svg_bzptarray
+ * @see lib/common/emit.c:emit_edge_graphics:2368 (late_string color)
+ */
+export declare function svgEdgePath(e: Edge, job: RenderJob): void;
+/**
+ * If edge `e` should render with rounded ortho corners, return its corner
+ * radius; else null. Mirrors emit.c:2554-2581: graph `splines==ortho`, then
+ * `radius>0` (explicit, overrides style) or `style=rounded` → default radius
+ * `max(12, penwidth*8)`.
+ * @see lib/common/emit.c (is_ortho / want_rounded / radius)
+ */
+export declare function orthoRoundedRadius(e: Edge, job: RenderJob): number | null;
+/**
+ * Emit an ortho edge whose corners are rounded (`splines=ortho` and `radius>0`
+ * or `style=rounded`): straight `<polyline>` segments between truncated corners
+ * plus an arc `<polyline>` per corner. Per-bezier fallback to the bezier `<path>`
+ * when a bezier has no orthogonal corner. @see lib/common/emit.c:2583-2666
+ */
+export declare function svgEdgePathOrthoRounded(e: Edge, radius: number, job: RenderJob): void;
+/**
+ * Emit one arrowhead polygon with pen color from job.obj and Adobe first-point
+ * repetition.  Exported so Lizard resets its line counter here (parser note above).
+ * @see plugin/core/gvrender_core_svg.c:svg_polygon (arrowhead case)
+ */
+export declare function emitArrowPolygon(rawPts: Point[], penColor: string, job: RenderJob, pw: number): void;
+/**
+ * Emit arrowhead polygon(s) for a routed edge (tail first, then head).
+ * Arrow fill and stroke use the edge pen color from job.obj (AD1).
+ * @see plugin/core/gvrender_core_svg.c:svg_polygon (arrowhead case)
+ * @see lib/common/arrows.c:arrow_type_normal
+ */
+export declare function svgArrowPolygons(e: Edge, job: RenderJob): void;
+export { emitParallelEdgePaths } from './svg-parallel-edge.js';
+export type { ParallelEdgeResult } from './svg-parallel-edge.js';
+//# sourceMappingURL=svg-helpers.d.ts.map

package/dist/render/svg-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-helpers.d.ts","sourceRoot":"","sources":["../../src/render/svg-helpers.ts"],"names":[],"mappings":"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"}

package/dist/render/svg-id.d.ts

@@ -0,0 +1,28 @@
+import type { Node } from '../model/node.js';
+import type { Edge } from '../model/edge.js';
+import type { Graph } from '../model/graph.js';
+import type { RenderJob } from '../gvc/job.js';
+/**
+ * `class="<kind>"`, with the DOT `class` attribute appended (` <class>`,
+ * xml-escaped) when present — mirroring svg_print_id_class.
+ * @see plugin/core/gvrender_core_svg.c:svg_print_id_class
+ */
+export declare function svgClass(kind: string, classAttr: string | undefined): string;
+/** SVG id for a node: own DOT `id` attr, else `node<seq>` (with gid prefix). */
+export declare function svgNodeId(n: Node, job: RenderJob): string;
+/** SVG id for an edge: own DOT `id` attr, else `edge<graphSeq>` (gid prefix). */
+export declare function svgEdgeId(e: Edge, job: RenderJob): string;
+/** SVG id for a cluster: own DOT `id` attr, else `clust<AGSEQ seq>` (gid prefix).
+ * @see lib/common/emit.c:getObjId */
+export declare function svgClusterId(sg: Graph, job: RenderJob): string;
+/** SVG id for the root graph group: DOT `id` attr, else `graph0` (no prefix). */
+export declare function svgGraphId(g: Graph, job: RenderJob): string;
+/** `class="node[ <class>]"`, reading the inherited DOT `class` attribute. */
+export declare function svgNodeClass(n: Node): string;
+/** `class="edge[ <class>]"`. */
+export declare function svgEdgeClass(e: Edge): string;
+/** `class="cluster[ <class>]"`, reading the inherited cluster `class` attr. */
+export declare function svgClusterClass(sg: Graph): string;
+/** `class="graph[ <class>]"`. */
+export declare function svgGraphClass(g: Graph): string;
+//# sourceMappingURL=svg-id.d.ts.map

package/dist/render/svg-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-id.d.ts","sourceRoot":"","sources":["../../src/render/svg-id.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAK/C;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAI5E;AAQD,gFAAgF;AAChF,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,GAAG,MAAM,CAEzD;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,GAAG,MAAM,CAEzD;AAED;qCACqC;AACrC,wBAAgB,YAAY,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,GAAG,MAAM,CAE9D;AAED,iFAAiF;AACjF,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,SAAS,GAAG,MAAM,CAE3D;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAE5C;AAED,gCAAgC;AAChC,wBAAgB,YAAY,CAAC,CAAC,EAAE,IAAI,GAAG,MAAM,CAE5C;AAED,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,EAAE,EAAE,KAAK,GAAG,MAAM,CAEjD;AAED,iCAAiC;AACjC,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAE9C"}

package/dist/render/svg-multicolor.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Multicolor region fills: stripedBox and wedgedEllipse.
+ *
+ * Ports the REGION-fill functions from lib/common/emit.c and the
+ * arc-to-Bézier machinery from lib/common/ellipse.c.  These are called
+ * from poly-gencode (S1) for style=striped polygon nodes and style=wedged
+ * ellipse nodes when fillcolor is a multi-segment color list.
+ *
+ * @see lib/common/emit.c:595  stripedBox
+ * @see lib/common/emit.c:549  wedgedEllipse
+ * @see lib/common/ellipse.c:274 ellipticWedge
+ */
+import type { Point } from '../model/geom.js';
+import type { RenderJob } from '../gvc/job.js';
+import type { RendererPlugin } from '../gvc/context.js';
+/**
+ * Thin-line pen width used for multicolor band/wedge outlines.
+ * @see lib/common/emit.c:538 #define THIN_LINE 0.5
+ */
+export declare const THIN_LINE = 0.5;
+/** Ellipse geometry parameters. */
+interface EllipseParams {
+    cx: number;
+    cy: number;
+    xsemi: number;
+    ysemi: number;
+}
+/**
+ * Return cubic Bézier path points approximating an elliptic wedge sector.
+ * Coordinates are in graphviz y-UP space — caller negates y for SVG.
+ *
+ * @see lib/common/ellipse.c:195 genEllipticPath
+ * @see lib/common/ellipse.c:274 ellipticWedge
+ */
+export declare function ellipticWedge(e: EllipseParams, angle0: number, angle1: number): Point[];
+/**
+ * Fill an ellipse with multiple pie-wedge sectors, one per color segment.
+ *
+ * `pf` is a 2-point bounding-box array in SVG y-DOWN device coordinates.
+ * Thin pen (THIN_LINE) for each wedge; caller draws boundary unfilled after.
+ *
+ * Returns 0 → ok; 1 or 2 → parse error.
+ *
+ * @see lib/common/emit.c:549 wedgedEllipse
+ */
+export declare function wedgedEllipse(job: RenderJob, pf: Point[], clrs: string, renderer: RendererPlugin): number;
+/**
+ * Fill a rectangular box with vertical color stripes.
+ *
+ * `pts` is a 4-point array in SVG y-DOWN device coordinates.
+ * `rotate` swaps corner order (true = vertical stripes, C default).
+ * Thin pen; caller draws boundary polygon unfilled after.
+ *
+ * Returns 0 → ok; 1 or 2 → parse error.
+ *
+ * @see lib/common/emit.c:595 stripedBox
+ */
+export declare function stripedBox(job: RenderJob, pts: Point[], clrs: string, rotate: boolean, renderer: RendererPlugin): number;
+export {};
+//# sourceMappingURL=svg-multicolor.d.ts.map

package/dist/render/svg-multicolor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-multicolor.d.ts","sourceRoot":"","sources":["../../src/render/svg-multicolor.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAQxD;;;GAGG;AACH,eAAO,MAAM,SAAS,MAAM,CAAC;AAiG7B,mCAAmC;AACnC,UAAU,aAAa;IAAG,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;CAAE;AAuCjF;;;;;;GAMG;AACH,wBAAgB,aAAa,CAC3B,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAC/C,KAAK,EAAE,CAgBT;AA8BD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAClE,MAAM,CAuBR;AAmBD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAC1C,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,cAAc,GACxC,MAAM,CAuBR"}

package/dist/render/svg-parallel-edge.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Parallel multi-color Bézier edge emission (M1).
+ *
+ * Ports the `else if (numc)` branch of emit_edge_graphics from
+ * lib/common/emit.c:2442-2528.  Each color in a "c1:c2:…" color-list
+ * produces one Bézier path offset SEP=2.0 graph-units perpendicular to
+ * the routed spline.  Arrow colors follow C's headcolor/tailcolor rule:
+ * headcolor = first color (cnum 0), tailcolor = second color (cnum 1, else
+ * same as headcolor).
+ *
+ * AD1: per-curve pen flows through job.obj (caller sets penColor before
+ *      each curve; we mutate obj.penColor here so the T4 path emitters see
+ *      the right color).
+ * AD4: caller passes the raw color-list string; numc is computed here.
+ *
+ * @see lib/common/emit.c:2442 (else if numc branch)
+ * @see lib/common/emit.c:2364 (#define SEP 2.0)
+ * @see lib/common/emit.c:2481-2496 (headcolor/tailcolor assignment)
+ */
+import type { Edge } from '../model/edge.js';
+import type { RenderJob } from '../gvc/job.js';
+/** Return value carrying the head/tail arrow colors for the caller. */
+export interface ParallelEdgeResult {
+    headColor: string;
+    tailColor: string;
+}
+export declare function emitParallelEdgePaths(e: Edge, job: RenderJob, colorList: string): ParallelEdgeResult;
+//# sourceMappingURL=svg-parallel-edge.d.ts.map

package/dist/render/svg-parallel-edge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-parallel-edge.d.ts","sourceRoot":"","sources":["../../src/render/svg-parallel-edge.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAY/C,uEAAuE;AACvE,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAkED,wBAAgB,qBAAqB,CACnC,CAAC,EAAE,IAAI,EACP,GAAG,EAAE,SAAS,EACd,SAAS,EAAE,MAAM,GAChB,kBAAkB,CAapB"}

package/dist/render/svg-tapered-edge.d.ts

@@ -0,0 +1,18 @@
+import type { Edge } from '../model/edge.js';
+import type { RenderJob } from '../gvc/job.js';
+/**
+ * True if `style="tapered"` is among the edge's style tokens, mirroring
+ * emit_edge_graphics' scan of the parse_style list. Tokens are comma-separated
+ * (parse_style), so a bare `tapered` matches. @see lib/common/emit.c:2371
+ */
+export declare function edgeIsTapered(e: Edge): boolean;
+/**
+ * Emit a tapered edge: the taper polygon followed by the arrowheads. C sets
+ * pencolor "transparent" and fillcolor = edge color for the polygon, then
+ * restores pencolor = color before the arrows. The port carries pen/fill on
+ * job.obj, so we swap them around the polygon and restore for
+ * svgArrowPolygons (which paints in obj.penColor).
+ * @see lib/common/emit.c:2422
+ */
+export declare function svgTaperedEdge(e: Edge, job: RenderJob): void;
+//# sourceMappingURL=svg-tapered-edge.d.ts.map

package/dist/render/svg-tapered-edge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg-tapered-edge.d.ts","sourceRoot":"","sources":["../../src/render/svg-tapered-edge.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAM/C;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,GAAG,OAAO,CAI9C;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI,CAqB5D"}

package/dist/render/svg.d.ts

@@ -0,0 +1,104 @@
+/**
+ * SVG renderer plugin.
+ *
+ * Faithful TypeScript port of plugin/core/gvrender_core_svg.c.
+ * Implements RendererPlugin to produce SVG 1.1 output.
+ *
+ * Y-coordinate investigation: The C svg_bzptarray and all shape emitters
+ * negate Y with -A[i].y because they receive raw PostScript (Y-up)
+ * coordinates and must convert to SVG (Y-down). In this TypeScript port
+ * the Y-flip is applied upstream via transformPoint with devscale.y = -1
+ * (src/gvc/device.ts). Coordinates received in all renderer callbacks are
+ * therefore already in SVG Y-down space; no additional negation is needed.
+ *
+ * @see plugin/core/gvrender_core_svg.c
+ */
+import type { Graph } from '../model/graph.js';
+import type { Node } from '../model/node.js';
+import type { Edge } from '../model/edge.js';
+import type { Point, Box } from '../model/geom.js';
+import type { TextSpan } from '../common/emit-types.js';
+import type { RendererPlugin, LabelType } from '../gvc/context.js';
+import type { RenderJob } from '../gvc/job.js';
+/**
+ * Faithful-to-outcome `edge_in_box`: true when the edge has something to draw.
+ * C's gvrender defers the `<g>` until a draw op, so an edge whose content falls
+ * entirely outside the clip emits no group (emit.c:edge_in_box tests each piece
+ * vs job->clip via boxf_overlap/overlap_label).
+ *
+ * The only piece that can legitimately fall OUTSIDE the clip on this corpus is a
+ * degenerate labeled-flat label: it is spline-less, so map_edge leaves it at its
+ * internal (un-normalized) x-frame position while the clip is the final frame.
+ * The `overlapLabel` test on the main label reproduces C's draw-iff-overlap for
+ * exactly that case — on-canvas (2368) → drawn; off-canvas (2368_1, negative
+ * un-normalized x) → suppressed. A present spline always lies within the clip
+ * (GD_bb contains it), and head/tail/xlabels are positioned at on-canvas
+ * endpoints, so those keep their existing unconditional triggers — adding an
+ * overlap test there only risks suppressing legitimately-drawn content (it
+ * regressed neato/circo edges whose spl.bb is computed differently). The `set`
+ * guard on the main label is kept: the port retains an unplaced (`pos=0,0`,
+ * `set=false`) label on merged back-edges where C has none.
+ * @see lib/common/emit.c:edge_in_box, lib/common/utils.c:overlap_label
+ */
+export declare function edgeHasDrawableContent(e: Edge, clip: Box): boolean;
+export declare class SvgRenderer implements RendererPlugin {
+    readonly type = "svg";
+    /** @see plugin/core/gvplugin_core.c registration table */
+    readonly quality = 0;
+    /** Whether the current edge's <g> group was opened (deferred-emit state). */
+    private edgeGroupOpen;
+    beginGraph(g: Graph, job: RenderJob): void;
+    endGraph(_g: Graph, job: RenderJob): void;
+    beginPage(g: Graph, job: RenderJob): void;
+    pageBackground(g: Graph, job: RenderJob): void;
+    endPage(_g: Graph, job: RenderJob): void;
+    beginLayer(name: string, job: RenderJob): void;
+    endLayer(job: RenderJob): void;
+    beginNode(n: Node, job: RenderJob): void;
+    endNode(_n: Node, job: RenderJob): void;
+    beginEdge(e: Edge, job: RenderJob): void;
+    /**
+     * Close the edge group.  Edge graphics (path + arrowhead) are emitted here
+     * because the full spline is available on e.info.spl only after layout has
+     * run routeDotEdges.
+     *
+     * For multi-color edges (color="c1:c2:…"), emits parallel offset Béziers
+     * (one per color, SEP=2.0 apart) then arrows in headcolor/tailcolor.
+     * Single-color edges use the T4 path unchanged.
+     *
+     * @see plugin/core/gvrender_core_svg.c:svg_end_edge
+     * @see lib/common/emit.c:2442-2528 (else if numc parallel-bezier branch)
+     */
+    endEdge(e: Edge, job: RenderJob): void;
+    beginAnchor(href: string, tooltip: string, target: string, id: string, job: RenderJob): void;
+    endAnchor(job: RenderJob): void;
+    textspan(pos: Point, span: TextSpan, job: RenderJob): void;
+    ellipse(center: Point, rx: number, ry: number, filled: boolean, job: RenderJob): void;
+    polygon(pts: Point[], filled: boolean, job: RenderJob): void;
+    bezier(pts: Point[], filled: boolean, job: RenderJob): void;
+    polyline(pts: Point[], job: RenderJob): void;
+    attachmentPolyline(pts: Point[], pencolor: string, job: RenderJob): void;
+    /**
+     * Emit an <image> element. C formats numbers with %g here (not the
+     * svg_printdouble used elsewhere); toPrecision(6) reproduces %g.
+     * Deviation: C writes us->name raw (gvputs); the port XML-escapes the
+     * src so metacharacter paths cannot produce invalid SVG.
+     *
+     * AD-1 (image-api, additive): when job.inlineImages is set AND the
+     * registered image resolver (`setImageResolver`) resolves `src`, emit a
+     * self-contained `data:` URI instead of the raw src passthrough. This is
+     * not a C behavior — native Graphviz never inlines image bytes. Default
+     * off (job.inlineImages unset/false, or no resolver registered, or the
+     * resolver misses) reproduces the byte-identical pre-AD-1 output below.
+     * @see plugin/core/gvloadimage_core.c:core_loadimage_svg
+     * @see src/gvc/image-resolver.ts
+     */
+    usershape(src: string, b: Box, job: RenderJob): void;
+    comment(text: string, job: RenderJob): void;
+    beginLabel(_type: LabelType, _job: RenderJob): void;
+    endLabel(_job: RenderJob): void;
+    beginCluster(sg: Graph, job: RenderJob): void;
+    endCluster(_sg: Graph, job: RenderJob): void;
+}
+export declare function createSvgRenderer(): RendererPlugin;
+//# sourceMappingURL=svg.d.ts.map

package/dist/render/svg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"svg.d.ts","sourceRoot":"","sources":["../../src/render/svg.ts"],"names":[],"mappings":"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"}

package/dist/render/xdot-public.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Public API for structured xdot draw-op access.
+ *
+ * Lays out a Graph, renders it to the xdot format, parses the xdot
+ * attribute strings back into typed XdotOp values, and returns a flat
+ * op stream the caller can feed to any drawing backend (canvas, WebGL,
+ * PDF, native UI) without touching SVG.
+ *
+ * This wrapper is a thin, faithful exposure of whatever the xdot renderer
+ * emits — it adds no draw ops of its own.
+ *
+ * KNOWN LIMITATION (xdot renderer, not this wrapper): the underlying xdot
+ * renderer (`createXdotRenderer` in `render/dot.ts`) is currently
+ * integration-incomplete relative to native `dot -Txdot`:
+ *   - edges emit no `_draw_` ops (no spline/arrowhead draw ops surface here);
+ *   - custom node pen/fill colors are not applied to the emitted ops;
+ *   - node draw-op coordinates can be mismatched between nodes.
+ * Node shape ops (ellipse/polygon), text/label ops, and font ops are
+ * emitted and surface correctly. The geometry itself is fully computed
+ * (the SVG renderer draws the same graph correctly); only the xdot
+ * emission path is incomplete. A faithful fix is tracked as a follow-on
+ * mission (see plans/expose-library-api/decision-journal.md, 2026-06-21).
+ *
+ * @see lib/xdot/xdot.h
+ * @see plugin/core/gvrender_core_dot.c (FORMAT_XDOT)
+ */
+import type { XdotOp } from '../xdot/types.js';
+import { Graph } from '../model/graph.js';
+import type { EngineName } from '../gvc/context.js';
+/**
+ * `Xdot` — the parsed result of one xdot attribute stream: `ops` (the
+ * decoded draw-op array) plus `flags` (parse status bits).
+ *
+ * `XdotOp` — a single decoded xdot drawing operation, discriminated by its
+ * `kind` field (e.g. `filled_ellipse`, `filled_polygon`, `filled_bezier`,
+ * `polyline`, `text`, `fill_color`, `pen_color`, `grad_fill_color`,
+ * `grad_pen_color`, `font`, `style`, `image`, `fontchar`). Each variant
+ * carries one payload property named for its shape (`ellipse`, `polygon`,
+ * `bezier`, `polyline`, `text`, `color`, `gradColor`, `font`, `style`,
+ * `image`, `fontchar`) — narrow on `kind` in a switch to access it safely.
+ *
+ * `XdotColor` — a resolved xdot fill/pen color: `{ type: 'none', clr }` for
+ * a solid color, or a linear/radial gradient (`{ type: 'linear', ling }` /
+ * `{ type: 'radial', ring }`).
+ *
+ * @see lib/xdot/xdot.h:xdot
+ * @see lib/xdot/xdot.h:xdot_op (`_xdot_op`)
+ * @see lib/xdot/xdot.h:xdot_color
+ */
+export type { Xdot, XdotOp, XdotColor } from '../xdot/index.js';
+/** Options for {@link getDrawOps}. */
+export interface DrawOpsOptions {
+    /** Layout engine to use. Defaults to `'dot'`. */
+    engine?: EngineName;
+}
+/** Default layout engine used by {@link getDrawOps}. */
+export declare const DEFAULT_DRAW_ENGINE: EngineName;
+/**
+ * Lay out `g`, render to xdot, parse every draw-attribute stream, and
+ * return all ops as a flat `XdotOp[]` in paint order (graph → node → edge).
+ *
+ * Consumers discriminate on the `kind` field of the `XdotOp` union —
+ * no string parsing required.
+ *
+ * @param g    - A Graph from `parse()` or the builder API.
+ * @param opts - Optional: `{ engine }` overrides the default `'dot'`.
+ * @returns Flat typed draw-op array covering the full graph.
+ * @throws ParseError  if the xdot DOT output cannot be re-parsed.
+ * @throws RenderError if layout or rendering fails.
+ *
+ * @example
+ * ```ts
+ * import { parse } from '@knowvah/dot-engine';
+ * import { getDrawOps } from 'graphviz-ts/render';
+ *
+ * const g = parse('digraph { a -> b; }');
+ * for (const op of getDrawOps(g)) {
+ *   switch (op.kind) {
+ *     case 'filled_ellipse':
+ *     case 'unfilled_ellipse':
+ *       drawEllipse(op.ellipse);
+ *       break;
+ *     case 'text':
+ *       drawText(op.text);
+ *       break;
+ *     // ...handle the remaining XdotOp kinds
+ *   }
+ * }
+ * ```
+ *
+ * @see lib/xdot/xdot.h
+ * @see lib/gvc/gvc.h:gvRender
+ */
+export declare function getDrawOps(g: Graph, opts?: DrawOpsOptions): XdotOp[];
+//# sourceMappingURL=xdot-public.d.ts.map

package/dist/render/xdot-public.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xdot-public.d.ts","sourceRoot":"","sources":["../../src/render/xdot-public.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAK1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAIpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEhE,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,wDAAwD;AACxD,eAAO,MAAM,mBAAmB,EAAE,UAAkB,CAAC;AAwDrD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,cAAc,GAAG,MAAM,EAAE,CAGpE"}

package/dist/render/xml-escape.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Base XML escape (gv_xml_escape with flags {0}): ids, titles, hrefs.
+ * @see lib/util/xml.c gv_xml_escape / xml_core / xml_isentity
+ */
+export declare function escapeXml(s: string): string;
+/**
+ * Title/id/class XML escape (gv_xml_escape with flags {dash, nbsp} — C's
+ * gvputs_xml): base escaping plus '-'→- and 2nd+ consecutive
+ * spaces→ , WITHOUT the raw flag (entity-aware '&', no \n/\r
+ * escapes). Used for <title> content and id/class attribute values.
+ * @see lib/gvc/gvdevice.c:gvputs_xml, lib/util/xml.c:xml_core
+ */
+export declare function escapeXmlTitle(s: string): string;
+/**
+ * Text/tooltip XML escape (gv_xml_escape with flags {raw, dash, nbsp}):
+ * additionally escapes '-'→&#45;, newline/CR→&#10;/&#13;, and 2nd+ consecutive
+ * spaces→&#160;. Used for textspans and tooltips.
+ * @see plugin/core/gvrender_core_svg.c:546 (svg_textspan flags)
+ */
+export declare function escapeXmlText(s: string): string;
+//# sourceMappingURL=xml-escape.d.ts.map

package/dist/render/xml-escape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml-escape.d.ts","sourceRoot":"","sources":["../../src/render/xml-escape.ts"],"names":[],"mappings":"AAeA;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAO3C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAKhD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAO/C"}