@knowvah/dot-engine 0.1.0

package/dist/common/types.d.ts

@@ -0,0 +1,316 @@
+/**
+ * Central re-export hub for all ported lib/common/types.h types, plus
+ * additional types from types.h not yet in src/model/.
+ *
+ * @see lib/common/types.h
+ */
+export type { GraphInfo } from '../model/graphInfo.js';
+export { makeGraphInfo } from '../model/graphInfo.js';
+export type { GVContext } from '../model/graphInfo.js';
+export type { NodeInfo, NodeAlgData } from '../model/nodeInfo.js';
+export { makeNodeInfo } from '../model/nodeInfo.js';
+export type { EdgeInfo } from '../model/edgeInfo.js';
+export { makeEdgeInfo, makePort } from '../model/edgeInfo.js';
+export type { Point, Box, Port, Spline } from '../model/geom.js';
+export type { LayoutParams, RatioKind } from '../model/layoutParams.js';
+export { FontnameKind } from '../model/layoutParams.js';
+export type { RankEntry, RankTable } from '../model/rankEntry.js';
+/**
+ * Callback bag controlling edge-spline routing behaviour.
+ *
+ * @see lib/common/types.h:splineInfo
+ */
+export interface SplineInfo {
+    /** Should head and tail be swapped? @see lib/common/types.h:splineInfo.swapEnds */
+    swapEnds: ((e: unknown) => boolean) | null;
+    /** Is n a node in the middle of an edge? @see lib/common/types.h:splineInfo.splineMerge */
+    splineMerge: ((n: unknown) => boolean) | null;
+    /** Test for swapped edges if false. @see lib/common/types.h:splineInfo.ignoreSwap */
+    ignoreSwap: boolean;
+    /** Orthogonal routing used. @see lib/common/types.h:splineInfo.isOrtho */
+    isOrtho: boolean;
+}
+import type { Box, Point } from '../model/geom.js';
+/**
+ * One endpoint of an edge path during spline routing.
+ *
+ * @see lib/common/types.h:pathend_t
+ */
+export interface PathendT {
+    /** The node box. @see lib/common/types.h:pathend_t.nb */
+    nb: Box;
+    /** Node port. @see lib/common/types.h:pathend_t.np */
+    np: Point;
+    /** @see lib/common/types.h:pathend_t.sidemask */
+    sidemask: number;
+    /** @see lib/common/types.h:pathend_t.boxn */
+    boxn: number;
+    /**
+     * Subdivision boxes; C declares boxf boxes[20].
+     * @see lib/common/types.h:pathend_t.boxes
+     */
+    boxes: Box[];
+}
+import type { Port } from '../model/geom.js';
+/**
+ * Internal specification for an edge spline.
+ *
+ * @see lib/common/types.h:path
+ */
+export interface Path {
+    /** @see lib/common/types.h:path.start */
+    start: Port;
+    /** @see lib/common/types.h:path.end */
+    end: Port;
+    /** Number of subdivisions. @see lib/common/types.h:path.nbox */
+    nbox: number;
+    /** Rectangular regions of subdivision. @see lib/common/types.h:path.boxes */
+    boxes: Box[];
+    /** Engine-specific data. @see lib/common/types.h:path.data */
+    data: unknown;
+}
+export type { Bezier } from '../model/geom.js';
+import type { Spline } from '../model/geom.js';
+/**
+ * Type alias matching the C `splines` typedef.
+ * Structurally identical to `Spline` from geom.ts.
+ *
+ * @see lib/common/types.h:splines
+ */
+export type Splines = Spline;
+/**
+ * Text label attached to a graph, node, or edge.
+ *
+ * The `u` union from C becomes a discriminated union here.
+ * `html: false` → `txt` variant; `html: true` → `htmlLabel` variant.
+ *
+ * @see lib/common/types.h:textlabel_t
+ */
+export interface TextlabelT {
+    /** @see lib/common/types.h:textlabel_t.text */
+    text: string;
+    /** @see lib/common/types.h:textlabel_t.fontname */
+    fontname: string;
+    /** @see lib/common/types.h:textlabel_t.fontcolor */
+    fontcolor: string;
+    /** @see lib/common/types.h:textlabel_t.charset */
+    charset: number;
+    /** @see lib/common/types.h:textlabel_t.fontsize */
+    fontsize: number;
+    /** Estimated diagonal size of the label. @see lib/common/types.h:textlabel_t.dimen */
+    dimen: Point;
+    /** Diagonal size of the space for the label. @see lib/common/types.h:textlabel_t.space */
+    space: Point;
+    /** Center of the space for the label. @see lib/common/types.h:textlabel_t.pos */
+    pos: Point;
+    /**
+     * Label content union — ported as a discriminated union.
+     * @see lib/common/types.h:textlabel_t.u
+     */
+    u: {
+        /** Non-HTML text spans. */
+        kind: 'txt';
+        /** @see lib/common/types.h:textlabel_t.u.txt.span */
+        span: unknown[];
+        /** @see lib/common/types.h:textlabel_t.u.txt.nspans */
+        nspans: number;
+    } | {
+        /** HTML label. */
+        kind: 'html';
+        /** @see lib/common/types.h:textlabel_t.u.html */
+        html: unknown;
+    };
+    /** Vertical alignment: 't' top, 'c' center, 'b' bottom. @see lib/common/types.h:textlabel_t.valign */
+    valign: number;
+    /** True if position is set. @see lib/common/types.h:textlabel_t.set */
+    set: boolean;
+    /** True if HTML label. @see lib/common/types.h:textlabel_t.html */
+    html: boolean;
+}
+/**
+ * Bitfield controlling polygon corner and fill rendering.
+ * The C bitfield is represented as a plain object of booleans plus
+ * a `shape` discriminant integer.
+ *
+ * @see lib/common/types.h:graphviz_polygon_style_t
+ */
+export interface GraphvizPolygonStyle {
+    /** @see lib/common/types.h:graphviz_polygon_style_t.filled */
+    filled: boolean;
+    /** @see lib/common/types.h:graphviz_polygon_style_t.radial */
+    radial: boolean;
+    /** @see lib/common/types.h:graphviz_polygon_style_t.rounded */
+    rounded: boolean;
+    /** @see lib/common/types.h:graphviz_polygon_style_t.diagonals */
+    diagonals: boolean;
+    /** @see lib/common/types.h:graphviz_polygon_style_t.auxlabels */
+    auxlabels: boolean;
+    /** @see lib/common/types.h:graphviz_polygon_style_t.invisible */
+    invisible: boolean;
+    /** @see lib/common/types.h:graphviz_polygon_style_t.striped */
+    striped: boolean;
+    /** @see lib/common/types.h:graphviz_polygon_style_t.dotted */
+    dotted: boolean;
+    /** @see lib/common/types.h:graphviz_polygon_style_t.dashed */
+    dashed: boolean;
+    /** @see lib/common/types.h:graphviz_polygon_style_t.wedged */
+    wedged: boolean;
+    /** @see lib/common/types.h:graphviz_polygon_style_t.underline */
+    underline: boolean;
+    /** @see lib/common/types.h:graphviz_polygon_style_t.fixedshape */
+    fixedshape: boolean;
+    /**
+     * Special shape discriminant (7-bit unsigned in C).
+     * Values come from the polygon shape enum constants in const.h.
+     * @see lib/common/types.h:graphviz_polygon_style_t.shape
+     */
+    shape: number;
+}
+/**
+ * Mutable shape information for a node polygon.
+ *
+ * @see lib/common/types.h:polygon_t
+ */
+export interface PolygonT {
+    /** True for symmetric shapes. @see lib/common/types.h:polygon_t.regular */
+    regular: boolean;
+    /** Number of periphery lines. @see lib/common/types.h:polygon_t.peripheries */
+    peripheries: number;
+    /** Number of sides (0 means user controls all). @see lib/common/types.h:polygon_t.sides */
+    sides: number;
+    /** Orientation in degrees. @see lib/common/types.h:polygon_t.orientation */
+    orientation: number;
+    /** Distortion factor (e.g. trapezium). @see lib/common/types.h:polygon_t.distortion */
+    distortion: number;
+    /** Skew factor (e.g. parallelogram). @see lib/common/types.h:polygon_t.skew */
+    skew: number;
+    /** Style flags. @see lib/common/types.h:polygon_t.option */
+    option: GraphvizPolygonStyle;
+    /**
+     * Resolved node penwidth (default 1). C bakes the half-penwidth outline
+     * periphery into `vertices` in poly_init; the TS `vertices` omit that ring,
+     * so poly_inside reapplies it and needs the value here.
+     * @see lib/common/shapes.c:poly_init (outline periphery)
+     */
+    penwidth?: number;
+    /**
+     * Precomputed vertex array, or null when computed at render time.
+     * @see lib/common/types.h:polygon_t.vertices
+     */
+    vertices: Point[] | null;
+}
+/**
+ * Read-only shape function table; ported from the C function-pointer struct.
+ * Node and edge arguments are typed `unknown` until those types are fully ported.
+ *
+ * @see lib/common/types.h:shape_functions
+ */
+export interface ShapeFunctions {
+    /** Initializes shape from node shape_info. @see lib/common/types.h:shape_functions.initfn */
+    initfn: ((n: unknown) => void) | null;
+    /** Frees shape from node shape_info. @see lib/common/types.h:shape_functions.freefn */
+    freefn: ((n: unknown) => void) | null;
+    /** Finds aiming point and slope of a port. @see lib/common/types.h:shape_functions.portfn */
+    portfn: ((n: unknown, portname: string, compass: string) => Port) | null;
+    /** Clips incident spline on shape. @see lib/common/types.h:shape_functions.insidefn */
+    insidefn: ((insideCtx: unknown, p: Point) => boolean) | null;
+    /** Finds box path to reach port. @see lib/common/types.h:shape_functions.pboxfn */
+    pboxfn: ((n: unknown, p: Port, side: number, rv: Box[], kptr: number[]) => number) | null;
+    /** Emits graphics code for node. @see lib/common/types.h:shape_functions.codefn */
+    codefn: ((job: unknown, n: unknown) => void) | null;
+}
+/**
+ * Discriminant for the type of shape a node uses.
+ *
+ * @see lib/common/types.h:shape_kind
+ */
+export declare enum ShapeKind {
+    /** @see lib/common/types.h:SH_UNSET */
+    SH_UNSET = 0,
+    /** @see lib/common/types.h:SH_POLY */
+    SH_POLY = 1,
+    /** @see lib/common/types.h:SH_RECORD */
+    SH_RECORD = 2,
+    /** @see lib/common/types.h:SH_POINT */
+    SH_POINT = 3,
+    /** @see lib/common/types.h:SH_EPSF */
+    SH_EPSF = 4
+}
+/**
+ * Read-only shape descriptor bound to a node.
+ *
+ * NOTE: The C struct does not carry a `kind` field — `shapeOf()` derives it
+ * from `fns->initfn` at runtime. In TypeScript we store it directly on the
+ * descriptor to avoid function-pointer comparisons.
+ *
+ * @see lib/common/types.h:shape_desc
+ * @see lib/common/shapes.c:shapeOf
+ */
+export interface ShapeDesc {
+    /** Shape name as read from graph file. @see lib/common/types.h:shape_desc.name */
+    name: string;
+    /** Shape function table. @see lib/common/types.h:shape_desc.fns */
+    fns: ShapeFunctions | null;
+    /** Base polygon info; null for non-polygon shapes. @see lib/common/types.h:shape_desc.polygon */
+    polygon: PolygonT | null;
+    /**
+     * Derived shape kind (stored here to avoid initfn comparison).
+     * @see lib/common/shapes.c:shapeOf
+     */
+    kind: ShapeKind;
+    /** True for user-defined shapes. @see lib/common/types.h:shape_desc.usershape */
+    usershape: boolean;
+}
+export type { RankEntry as RankT } from '../model/rankEntry.js';
+/**
+ * A field within a record-shape node.
+ *
+ * @see lib/common/types.h:field_t
+ */
+export interface FieldT {
+    /** Field dimensions. @see lib/common/types.h:field_t.size */
+    size: Point;
+    /** Placement in node coordinates. @see lib/common/types.h:field_t.b */
+    b: Box;
+    /** Number of sub-fields. @see lib/common/types.h:field_t.n_flds */
+    n_flds: number;
+    /** Label pointer; used when n_flds == 0. @see lib/common/types.h:field_t.lp */
+    lp: TextlabelT | null;
+    /** Sub-field array; used when n_flds > 0. @see lib/common/types.h:field_t.fld */
+    fld: FieldT[] | null;
+    /** User's identifier. @see lib/common/types.h:field_t.id */
+    id: string | null;
+    /**
+     * Non-zero if box list is horizontal (left to right).
+     * @see lib/common/types.h:field_t.LR
+     */
+    LR: number;
+    /** Sides of node exposed to this field. @see lib/common/types.h:field_t.sides */
+    sides: number;
+}
+/**
+ * Generic node list.
+ *
+ * @see lib/common/types.h:nlist_t
+ */
+export interface NlistT {
+    /** @see lib/common/types.h:nlist_t.list */
+    list: unknown[];
+    /** @see lib/common/types.h:nlist_t.size */
+    size: number;
+}
+/**
+ * Dynamic edge list (ported from the C `elist` struct).
+ *
+ * NOTE: NodeInfo already contains a typed EdgeList for known-edge contexts.
+ * ElistT covers the generic `elist` where the element type is not yet known.
+ *
+ * @see lib/common/types.h:elist
+ */
+export interface ElistT {
+    /** @see lib/common/types.h:elist.list */
+    list: unknown[];
+    /** @see lib/common/types.h:elist.size */
+    size: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/common/types.d.ts.map

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

package/dist/common/xlabels-place.d.ts

@@ -0,0 +1,125 @@
+/**
+ * addXLabels and its helpers — ported from lib/common/postproc.c:202-590.
+ *
+ * Split from postproc.ts to keep that file under 500 lines.
+ * Spline midpoint helpers live in spline-midpoint.ts.
+ *
+ * @see lib/common/postproc.c:addXLabels
+ */
+import type { Graph } from '../model/graph.js';
+import type { Point } from '../model/geom.js';
+import type { TextlabelT } from './types.js';
+import type { XLabelT, ObjectT } from '../label/xlabels.js';
+import { type SplLike } from './spline-midpoint.js';
+/**
+ * Calculate center from an xlabel's lower-left pos + size.
+ * @see lib/common/postproc.c:centerPt
+ */
+export declare function centerPt(xlp: XLabelT): Point;
+/** Shared mutable context threaded through the object/label fill pass. */
+export interface XLabelCtx {
+    objs: ObjectT[];
+    lbls: XLabelT[];
+    flip: boolean;
+    oi: number;
+    xi: number;
+    bb: {
+        ll: Point;
+        ur: Point;
+    };
+}
+/**
+ * Set up xlabel_t object and connect with related object.
+ * @see lib/common/postproc.c:addXLabel
+ */
+export declare function addXLabel(lp: TextlabelT, ctx: XLabelCtx, initObj: boolean, pos: Point): void;
+/**
+ * Set up obstacle object based on a set external label.
+ * @see lib/common/postproc.c:addLabelObj
+ */
+export declare function addLabelObj(lp: TextlabelT, objp: ObjectT, bb: {
+    ll: Point;
+    ur: Point;
+}, flip: boolean): {
+    ll: Point;
+    ur: Point;
+};
+/**
+ * Set up obstacle object based on a node.
+ * @see lib/common/postproc.c:addNodeObj
+ */
+export declare function addNodeObj(np: {
+    info: {
+        coord?: Point;
+        width?: number;
+        height?: number;
+    };
+}, objp: ObjectT, bb: {
+    ll: Point;
+    ur: Point;
+}, flip: boolean): {
+    ll: Point;
+    ur: Point;
+};
+interface CinfoT {
+    bb: {
+        ll: Point;
+        ur: Point;
+    };
+    objpIdx: number;
+}
+/** @see lib/common/postproc.c:countClusterLabels */
+export declare function countClusterLabels(g: Graph, isRoot: (h: Graph) => boolean): number;
+/** @see lib/common/postproc.c:addClusterObj */
+export declare function addClusterObj(g: Graph, objs: ObjectT[], info: CinfoT, isRoot: (h: Graph) => boolean, flip: boolean): CinfoT;
+type BezLike2 = {
+    list: Point[];
+    sflag: number;
+    eflag: number;
+    sp: Point;
+    ep: Point;
+};
+export type ELike = {
+    info: {
+        spl?: {
+            list: BezLike2[];
+        };
+        edge_type?: number;
+        to_orig?: ELike;
+        label?: TextlabelT;
+        tail_label?: TextlabelT;
+        head_label?: TextlabelT;
+        xlabel?: TextlabelT;
+    };
+};
+/**
+ * Follow to_orig until a spline is found.
+ * @see lib/common/splines.c:getsplinepoints
+ */
+export declare function getSplinePoints(e: ELike): SplLike | null;
+/** @see lib/common/postproc.c:edgeTailpoint */
+export declare function edgeTailpoint(e: ELike): Point;
+/** @see lib/common/postproc.c:edgeHeadpoint */
+export declare function edgeHeadpoint(e: ELike): Point;
+/** @see lib/common/splines.c:edgeMidpoint */
+export declare function edgeMidpoint(g: Graph, e: ELike): Point;
+/**
+ * Grow the graph bbox to include a placed xlabel/edge-label.
+ *
+ * Delegates to the shared `updateBB` (splines-label.ts) so the GD_flip
+ * axis swap lives in one place. C's addXLabel/addLabelObj callers all
+ * route label growth through the same `updateBB`/`addLabelBB`
+ * (lib/common/utils.c:569-595) — this used to be a second, divergent
+ * copy that never got the flip swap; see analysis/2613-canvas.md.
+ * @see lib/common/utils.c:addLabelBB
+ */
+export declare function updateBBForLabel(g: Graph, lp: TextlabelT): void;
+/**
+ * Position xlabels and any unpositioned edge labels using the placement
+ * algorithm to avoid overlap.
+ *
+ * @see lib/common/postproc.c:addXLabels
+ */
+export declare function addXLabels(gp: Graph): void;
+export {};
+//# sourceMappingURL=xlabels-place.d.ts.map

package/dist/common/xlabels-place.d.ts.map

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

package/dist/debug.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Discriminated union of structured records emitted by the debug subsystem.
+ * Add a new member here when a new diagnostic category is introduced.
+ */
+export type DebugRecord = {
+    kind: 'rank';
+    nodeId: string;
+    rank: number;
+} | {
+    kind: 'rank-alias-start';
+    nodeId: string;
+    rankValue: number;
+} | {
+    kind: 'rank-alias-end';
+    nodeId: string;
+    xCoord: number;
+    rankRestored: number;
+} | {
+    kind: 'spline';
+    edgeId: string;
+    points: readonly [number, number][];
+} | {
+    kind: 'coord-space';
+    phase: string;
+    nodeId: string;
+    x: number;
+    y: number;
+    unit: 'pt' | 'in';
+} | {
+    kind: 'prng';
+    seed: number;
+    value: number;
+    index: number;
+};
+/**
+ * Flags controlling diagnostic output. All fields are optional; omitting a
+ * flag is equivalent to false. Pass via GvcContext constructor options.
+ *
+ * All flags are no-ops when undefined — guarded by `if (debug?.flag)` so
+ * the JIT can eliminate dead branches. They do not affect algorithm output.
+ */
+export interface DebugOptions {
+    /** Log rank assignments and ND_rank dual-use transitions (AD-8). */
+    rankAssignment?: boolean;
+    /** Log spline control points per edge after pathplan routing. */
+    splineRouting?: boolean;
+    /** Log every PS2INCH / INCH2PS coordinate conversion. */
+    coordinateSpaces?: boolean;
+    /** Log MT19937 seed and generated values (SGD / neato overlap removal). */
+    prngState?: boolean;
+    /**
+     * Receive structured records as they are emitted.
+     * Called synchronously; do not mutate the record.
+     * If omitted, enabled flags write to console.debug.
+     */
+    emit?: (record: DebugRecord) => void;
+}
+//# sourceMappingURL=debug.d.ts.map

package/dist/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../src/debug.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChD;IAAE,IAAI,EAAE,kBAAkB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAClF;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAA;CAAE,GACvE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IACnD,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;CAAE,GAC3C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iEAAiE;IACjE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yDAAyD;IACzD,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;CACtC"}

package/dist/errors.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Public structured-error contract for graphviz-ts.
+ *
+ * Consumers branch on the stable `code` / `type` fields; the
+ * `code -> friendlyMessage` map is the single seam a future i18n library
+ * replaces. This module is a runtime leaf: the only project import is the
+ * type-only `Expectation`, which is erased at compile time.
+ *
+ * @see plans/structured-errors/decisions.md
+ */
+import type { Expectation } from './parser/dot.js';
+/** Stable public alias of peggy's expectation union (SYNTAX_* errors only). */
+export type GvExpectation = Expectation;
+/** Coarse classification of where an error originated. */
+export type GvErrorType = 'syntax' | 'semantic' | 'render';
+/** Closed union of stable error codes — each is an i18n key. */
+export type GvErrorCode = 'SYNTAX_ERROR' | 'SYNTAX_UNEXPECTED_EOF' | 'EDGE_OP_DIRECTED_IN_UNDIRECTED' | 'EDGE_OP_UNDIRECTED_IN_DIRECTED' | 'HTML_PARSE_ERROR' | 'RENDER_ERROR' | 'GENERIC_ERROR';
+/** Structured error contract shared by every error source. */
+export interface GvError {
+    type: GvErrorType;
+    /** Stable i18n key. */
+    code: GvErrorCode;
+    /** Concise technical text we own (may diverge from C). */
+    message: string;
+    /** Approachable, non-localized English (delivery). */
+    friendlyMessage: string;
+    /** Real error position; the highest-value field. */
+    location?: {
+        line: number;
+        column: number;
+        offset?: number;
+    };
+    /** Peggy's discriminated union, passed through unmapped; SYNTAX_* only. */
+    expected?: GvExpectation[];
+}
+/** Result of a result-style render: `svg` XOR `errors` for v1. */
+export interface RenderResult {
+    /** Present on success. */
+    svg?: string;
+    /** Present on failure; length <= 1 (first failure only) for v1. */
+    errors?: GvError[];
+}
+/**
+ * Central `code -> friendlyMessage` map. Non-localized, approachable English.
+ * This is the seam a future i18n library replaces.
+ */
+export declare const FRIENDLY_MESSAGES: Record<GvErrorCode, string>;
+/**
+ * Look up the approachable English message for a code. The single seam a
+ * future i18n library replaces.
+ */
+export declare function friendlyMessageFor(code: GvErrorCode): string;
+/**
+ * Error thrown for known layout/render-stage failures. Only `RENDER_ERROR`
+ * and `GENERIC_ERROR` are valid render-stage codes.
+ */
+export declare class RenderError extends Error implements GvError {
+    readonly type = "render";
+    readonly code: GvErrorCode;
+    readonly friendlyMessage: string;
+    constructor(message: string, code?: GvErrorCode);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,+EAA+E;AAC/E,MAAM,MAAM,aAAa,GAAG,WAAW,CAAC;AAExC,0DAA0D;AAC1D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE3D,gEAAgE;AAChE,MAAM,MAAM,WAAW,GACnB,cAAc,GACd,uBAAuB,GACvB,gCAAgC,GAChC,gCAAgC,GAChC,kBAAkB,GAClB,cAAc,GACd,eAAe,CAAC;AAEpB,8DAA8D;AAC9D,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,WAAW,CAAC;IAClB,uBAAuB;IACvB,IAAI,EAAE,WAAW,CAAC;IAClB,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7D,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,WAAW,EAAE,MAAM,CAWzD,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,CAE5D;AAED;;;GAGG;AACH,qBAAa,WAAY,SAAQ,KAAM,YAAW,OAAO;IACvD,QAAQ,CAAC,IAAI,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,WAA4B;CAMhE"}

package/dist/gvc/anchor.d.ts

@@ -0,0 +1,86 @@
+import type { Edge } from '../model/edge.js';
+import type { Graph } from '../model/graph.js';
+import type { Node } from '../model/node.js';
+import type { Point, Box, Spline } from '../model/geom.js';
+import type { TextlabelT } from '../common/types.js';
+import type { RendererPlugin } from './context.js';
+import { type ObjState, type RenderJob } from './job.js';
+/**
+ * Resolve an edge's anchor fields into job.obj, mirroring emit_begin_edge.
+ * The whole-edge anchor (svg endEdge) and the per-label sub-anchors
+ * (renderEdgeLabels) read these. map_* fields are not populated (SVG has no
+ * maps).
+ * @see lib/common/emit.c:emit_begin_edge (2706-2845)
+ */
+export declare function resolveEdgeAnchor(e: Edge, id: string, obj: ObjState): void;
+/**
+ * Resolve a graph or cluster's anchor fields into job.obj: url from href/URL,
+ * tooltip from tooltip else default to the object's label, target, id.
+ * @see lib/common/emit.c:initMapData (163-200)
+ */
+export declare function resolveObjAnchor(g: Graph, label: string | null, id: string, obj: ObjState): void;
+/**
+ * Open an anchor with explicit fields, coalescing nullable url/tooltip/target
+ * to ''. The id is passed through (callers build label-specific ids).
+ * @see lib/common/emit.c → gvrender_begin_anchor
+ */
+export declare function openAnchorWith(renderer: RendererPlugin, job: RenderJob, url: string | null, tooltip: string | null, target: string | null, id: string): void;
+/**
+ * Open the whole-object anchor when there is a url or an explicit tooltip,
+ * mirroring `if (obj->url || obj->explicit_tooltip)`. Returns true when the
+ * caller must close it with renderer.endAnchor after the object's own graphics.
+ * @see lib/common/emit.c:2877 (edge), 3653 (graph), 3803 (cluster)
+ */
+export declare function beginAnchorIf(renderer: RendererPlugin, job: RenderJob): boolean;
+/**
+ * Coordinate-transform context for the imagemap device. `bb` is the unpadded
+ * graph bounding box (GD_bb), `pad` the graph padding, `scale` the device
+ * scale (`zoom * dpi / 72`). The imagemap device is GVRENDER_Y_GOES_DOWN with
+ * no GVRENDER_DOES_TRANSFORM, so emit.c runs every map point through
+ * gvrender_ptf.
+ */
+export interface MapCtx {
+    bb: Box;
+    pad: Point;
+    scale: number;
+    marginOff: Point;
+    mapPolygon: boolean;
+}
+/**
+ * gvrender_ptf for the imagemap device (single page, no rotation): the clip box
+ * is the padded drawing, so translation.x = -(bb.ll.x - pad.x) and
+ * translation.y = -(bb.ur.y + pad.y); devscale.y is negated for Y_GOES_DOWN.
+ * setup_page also folds `canvasBox.LL / zoom` (the graph `margin=`) into the
+ * translation, which after the `* scale` becomes `margin * dpi/72` in device
+ * units (`marginOff`) — matching svgBeginPage's `+ margin / z` term.
+ * @see lib/gvc/gvrender.c:gvrender_ptf ; lib/common/emit.c:setup_page (1566-1581)
+ */
+export declare function mapTransform(p: Point, ctx: MapCtx): Point;
+/**
+ * Populate obj.urlMapShape / obj.urlMapPts for a node, mirroring the shape
+ * dispatch in emit_begin_node: a regular-rectangle / non-polygon node maps to
+ * its bounding-box rectangle (lw/rw, ht/2); every other polygon maps to a
+ * circle, sampled ellipse, or n-gon.
+ * @see lib/common/emit.c:emit_begin_node (1665-1778)
+ */
+export declare function computeNodeUrlMap(n: Node, obj: ObjState, ctx: MapCtx): void;
+/**
+ * Graph-level (root) hot spot: the padded drawing rectangle (pageBox), matching
+ * emit_page's map computation for GVRENDER_DOES_MAP_RECTANGLE devices.
+ * @see lib/common/emit.c:emit_page (3623-3642)
+ */
+export declare function computeGraphUrlMap(obj: ObjState, ctx: MapCtx): void;
+/** Cluster hot spot: GD_bb(sg) rectangle. @see emit.c:emit_clusters (emit_map_rect) */
+export declare function computeClusterUrlMap(bb: Box, obj: ObjState, ctx: MapCtx): void;
+/**
+ * Label hot spot: the P2RECT box around a placed label (pos ± dimen/2).
+ * @see lib/common/emit.c:map_label (666-689)
+ */
+export declare function computeLabelRectMap(lab: TextlabelT, obj: ObjState, ctx: MapCtx): void;
+/**
+ * Whole-edge spline hot spots: one (or more) MAP_POLYGON outlines around the
+ * edge's Bézier pieces, in device coordinates.
+ * @see lib/common/emit.c:emit_begin_edge (2851-2872) / emit_end_edge (2969-2985)
+ */
+export declare function computeEdgeSplineMaps(spl: Spline, w2: number, ctx: MapCtx): Point[][];
+//# sourceMappingURL=anchor.d.ts.map