@knowvah/dot-engine 0.1.0

package/dist/gvc/job.d.ts

@@ -0,0 +1,234 @@
+/**
+ * RenderJob — full implementation, replacing the T25 scaffold.
+ *
+ * Ports GVJ_s and obj_state_s from lib/gvc/gvcjob.h.
+ *
+ * @see lib/gvc/gvcjob.h:GVJ_s
+ * @see lib/gvc/gvcjob.h:obj_state_s
+ * @see lib/gvc/gvdevice.c:gvprintdouble
+ */
+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 { GVColor } from '../common/color.js';
+import type { TextMeasurer } from '../common/textmeasure.js';
+import type { RendererPlugin } from './context.js';
+import { PenType, FillType } from './context.js';
+/** @see lib/gvc/gvcjob.h:obj_type */
+export declare const enum ObjType {
+    RootGraph = 0,
+    Cluster = 1,
+    Node = 2,
+    Edge = 3
+}
+/** @see lib/gvc/gvcjob.h:emit_state_t */
+export declare const enum EmitState {
+    GDraw = 0,
+    CDraw = 1,
+    TDraw = 2,
+    HDraw = 3,
+    GLabel = 4,
+    CLabel = 5,
+    TLabel = 6,
+    HLabel = 7,
+    NDraw = 8,
+    EDraw = 9,
+    NLabel = 10,
+    ELabel = 11
+}
+/** @see lib/gvc/gvcjob.h:map_shape_t */
+export declare const enum MapShape {
+    Rectangle = 0,
+    Circle = 1,
+    Polygon = 2
+}
+export declare const EMIT_SORTED: number;
+export declare const EMIT_COLORS: number;
+export declare const EMIT_CLUSTERS_LAST: number;
+export declare const EMIT_PREORDER: number;
+export declare const EMIT_EDGE_SORTED: number;
+export declare const GVDEVICE_DOES_PAGES: number;
+export declare const GVDEVICE_DOES_LAYERS: number;
+export declare const GVDEVICE_EVENTS: number;
+export declare const GVDEVICE_DOES_TRUECOLOR: number;
+export declare const GVDEVICE_BINARY_FORMAT: number;
+export declare const GVDEVICE_COMPRESSED_FORMAT: number;
+export declare const GVDEVICE_NO_WRITER: number;
+export declare const GVRENDER_Y_GOES_DOWN: number;
+export declare const GVRENDER_DOES_TRANSFORM: number;
+export declare const GVRENDER_DOES_LABELS: number;
+export declare const GVRENDER_DOES_MAPS: number;
+export declare const GVRENDER_DOES_MAP_RECTANGLE: number;
+export declare const GVRENDER_DOES_MAP_CIRCLE: number;
+export declare const GVRENDER_DOES_MAP_POLYGON: number;
+export declare const GVRENDER_DOES_MAP_ELLIPSE: number;
+export declare const GVRENDER_DOES_MAP_BSPLINE: number;
+export declare const GVRENDER_DOES_TOOLTIPS: number;
+export declare const GVRENDER_DOES_TARGETS: number;
+export declare const GVRENDER_DOES_Z: number;
+export declare const GVRENDER_NO_WHITE_BG: number;
+export declare const LAYOUT_NOT_REQUIRED: number;
+export declare const OUTPUT_NOT_REQUIRED: number;
+/** TypeScript equivalent of obj_state_t. @see lib/gvc/gvcjob.h:obj_state_s */
+export interface ObjState {
+    parent: ObjState | null;
+    type: ObjType;
+    graphObj: Graph | Node | Edge | null;
+    emitState: EmitState;
+    penColor: GVColor;
+    fillColor: GVColor;
+    stopColor: GVColor;
+    gradientAngle: number;
+    gradientFrac: number;
+    pen: PenType;
+    fill: FillType;
+    penWidth: number;
+    rawStyle: string[];
+    label: string | null;
+    xlabel: string | null;
+    tailLabel: string | null;
+    headLabel: string | null;
+    url: string | null;
+    id: string | null;
+    labelUrl: string | null;
+    tailUrl: string | null;
+    headUrl: string | null;
+    tooltip: string | null;
+    labelTooltip: string | null;
+    tailTooltip: string | null;
+    headTooltip: string | null;
+    target: string | null;
+    labelTarget: string | null;
+    tailTarget: string | null;
+    headTarget: string | null;
+    explicitTooltip: boolean;
+    explicitTailTooltip: boolean;
+    explicitHeadTooltip: boolean;
+    explicitLabelTooltip: boolean;
+    explicitTailTarget: boolean;
+    explicitHeadTarget: boolean;
+    explicitEdgeTarget: boolean;
+    explicitTailUrl: boolean;
+    explicitHeadUrl: boolean;
+    labelEdgeAligned: boolean;
+    urlMapShape: MapShape;
+    urlMapPts: Point[];
+    urlBsplineMapPts: Point[][];
+    tailEndMapPts: Point[];
+    headEndMapPts: Point[];
+}
+/**
+ * Allocate a fresh default ObjState matching C's push_obj_state (no parent).
+ * pen=SOLID, fill=NONE, penWidth=1.0; penColor black, fillColor white so
+ * emitStyle emits "fill=none stroke=black" for unstyled objects (byte-stable).
+ * Batch-2 callers overwrite type/graphObj/emitState per object.
+ *
+ * NOTE: fresh object per call; do NOT pool prematurely — profile first.
+ * @see lib/common/emit.c:push_obj_state
+ */
+export declare function createObjState(type?: ObjType): ObjState;
+/**
+ * Format to 2 decimal places, rounding exact ties half-to-even as C's
+ * snprintf("%.2f") does under FE_TONEAREST; Number.toFixed rounds them
+ * half-away-from-zero instead. Delegates to the general-purpose
+ * {@link printfFixed} (exact-decimal BigInt rounding), which subsumes the
+ * `%.Nf` case for arbitrary `decimals`, not just 2.
+ *
+ * @see lib/gvc/gvdevice.c:gvprintdouble
+ */
+export declare function toFixed2HalfEven(n: number): string;
+/**
+ * Render job context.
+ *
+ * Ports GVJ_s from lib/gvc/gvcjob.h, adapted for the TypeScript
+ * string-accumulator output model (no FILE* / output_data).
+ *
+ * @see lib/gvc/gvcjob.h:GVJ_s
+ */
+export declare class RenderJob {
+    readonly output: string[];
+    readonly measurer: TextMeasurer;
+    readonly format: string;
+    bb: Box;
+    pad: Point;
+    /** Graph-level `margin=` (init_job_margin); page-pagination margin, distinct
+     * from node/cluster label margin. @see lib/common/emit.c:3309-3331 */
+    margin: Point;
+    zoom: number;
+    dpi: Point;
+    rotation: number;
+    scale: Point;
+    translation: Point;
+    devscale: Point;
+    flags: number;
+    numLayers: number;
+    layerNum: number;
+    /** Layer names indexed 1..numLayers (set when rendering a layered graph). */
+    layerIDs: (string | null)[];
+    nodeId: number;
+    edgeId: number;
+    /** Monotonic counter for linear gradient ids per render.
+     * @see AD1; plugin/core/gvrender_core_svg.c:572 (static gradId) */
+    linearGradId: number;
+    /** Monotonic counter for radial gradient ids per render.
+     * @see AD1; plugin/core/gvrender_core_svg.c:608 (static rgradId) */
+    radialGradId: number;
+    /** Whether the graph being rendered is directed (edge titles use -> vs --). */
+    directed: boolean;
+    /** Root graph's `id` attribute (GD_drawing(root)->id), '' if unset. Used as
+     * the `<gid>_` prefix for non-root object ids. @see lib/common/emit.c:getObjId */
+    drawingId: string;
+    /**
+     * Resolve an object's SVG id like C's getObjId (steps after layerPagePrefix):
+     * a non-empty DOT `id` attr wins verbatim; otherwise non-root objects are
+     * prefixed with `<drawingId>_` when the root graph has an id.
+     * @see lib/common/emit.c:getObjId:209
+     */
+    objId(idAttr: string | undefined, defaultId: string, isRoot?: boolean): string;
+    /** Active renderer plugin; set by render() before walkNodes. */
+    renderer?: RendererPlugin;
+    /**
+     * When set, overrides the label emit-state that {@link gvrenderTextspan} and
+     * withLabelEmitState would otherwise derive from the object type. Used to route
+     * an edge's HEAD/TAIL label into EMIT_HLABEL/EMIT_TLABEL (→ `_hldraw_`/
+     * `_tldraw_`) rather than the default EMIT_ELABEL. Null outside that window.
+     * @see lib/common/emit.c:emit_edge (head/tail label emit_state)
+     */
+    labelEmitOverride: EmitState | null;
+    private readonly objStack;
+    constructor(format: string, measurer: TextMeasurer);
+    /** Layer id prefix for layers after the first (C layerPagePrefix).
+     * @see lib/common/emit.c:197 */
+    idLayerPrefix(): string;
+    /** Layer id suffix appended to node/edge group ids (svg_begin_node idx).
+     * @see plugin/core/gvrender_core_svg.c svg_begin_node/edge */
+    idLayerSuffix(): string;
+    /** Top of the object-state stack, or null if empty. */
+    get obj(): ObjState | null;
+    /** Push an object state onto the stack. */
+    pushObj(state: ObjState): void;
+    /**
+     * Pop the top object state from the stack.
+     * @throws Error if the stack is empty.
+     */
+    popObj(): void;
+    /** Append a string to the output buffer. */
+    write(s: string): void;
+    /**
+     * Format a number and write it.
+     * Replicates gvprintdouble from lib/gvc/gvdevice.c exactly:
+     *   - Values in (-0.005, 0.005) emit "0" (suppresses -0).
+     *   - Otherwise: format to 2 dp, strip trailing zeros / decimal point.
+     *
+     * @see lib/gvc/gvdevice.c:gvprintdouble
+     */
+    printDouble(n: number): void;
+    /**
+     * Write a point as two space-separated numbers.
+     *
+     * @see lib/gvc/gvdevice.c:gvprintpointf
+     */
+    printPoint(p: Point): void;
+}
+//# sourceMappingURL=job.d.ts.map

package/dist/gvc/job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../../src/gvc/job.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAOjD,qCAAqC;AACrC,0BAAkB,OAAO;IACvB,SAAS,IAAI;IACb,OAAO,IAAO;IACd,IAAI,IAAU;IACd,IAAI,IAAU;CACf;AAED,yCAAyC;AACzC,0BAAkB,SAAS;IACzB,KAAK,IAAK;IACV,KAAK,IAAK;IACV,KAAK,IAAK;IACV,KAAK,IAAK;IACV,MAAM,IAAI;IACV,MAAM,IAAI;IACV,MAAM,IAAI;IACV,MAAM,IAAI;IACV,KAAK,IAAK;IACV,KAAK,IAAK;IACV,MAAM,KAAK;IACX,MAAM,KAAK;CACZ;AAED,wCAAwC;AACxC,0BAAkB,QAAQ;IACxB,SAAS,IAAI;IACb,MAAM,IAAO;IACb,OAAO,IAAM;CACd;AAMD,eAAO,MAAM,WAAW,QAAqB,CAAC;AAC9C,eAAO,MAAM,WAAW,QAAqB,CAAC;AAC9C,eAAO,MAAM,kBAAkB,QAAc,CAAC;AAC9C,eAAO,MAAM,aAAa,QAAmB,CAAC;AAC9C,eAAO,MAAM,gBAAgB,QAAgB,CAAC;AAC9C,eAAO,MAAM,mBAAmB,QAAa,CAAC;AAC9C,eAAO,MAAM,oBAAoB,QAAY,CAAC;AAC9C,eAAO,MAAM,eAAe,QAAiB,CAAC;AAC9C,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAC9C,eAAO,MAAM,sBAAsB,QAAU,CAAC;AAC9C,eAAO,MAAM,0BAA0B,QAAU,CAAC;AAClD,eAAO,MAAM,kBAAkB,QAAe,CAAC;AAC/C,eAAO,MAAM,oBAAoB,QAAa,CAAC;AAC/C,eAAO,MAAM,uBAAuB,QAAU,CAAC;AAC/C,eAAO,MAAM,oBAAoB,QAAa,CAAC;AAC/C,eAAO,MAAM,kBAAkB,QAAe,CAAC;AAC/C,eAAO,MAAM,2BAA2B,QAAU,CAAC;AACnD,eAAO,MAAM,wBAAwB,QAAa,CAAC;AACnD,eAAO,MAAM,yBAAyB,QAAY,CAAC;AACnD,eAAO,MAAM,yBAAyB,QAAY,CAAC;AACnD,eAAO,MAAM,yBAAyB,QAAY,CAAC;AACnD,eAAO,MAAM,sBAAsB,QAAe,CAAC;AACnD,eAAO,MAAM,qBAAqB,QAAgB,CAAC;AACnD,eAAO,MAAM,eAAe,QAAsB,CAAC;AACnD,eAAO,MAAM,oBAAoB,QAAiB,CAAC;AACnD,eAAO,MAAM,mBAAmB,QAAkB,CAAC;AACnD,eAAO,MAAM,mBAAmB,QAAkB,CAAC;AAMnD,8EAA8E;AAC9E,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,QAAQ,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IACrC,SAAS,EAAE,SAAS,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,EAAE,OAAO,CAAC;IACb,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,mBAAmB,EAAE,OAAO,CAAC;IAC7B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,eAAe,EAAE,OAAO,CAAC;IACzB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,QAAQ,CAAC;IACtB,SAAS,EAAE,KAAK,EAAE,CAAC;IACnB,gBAAgB,EAAE,KAAK,EAAE,EAAE,CAAC;IAC5B,aAAa,EAAE,KAAK,EAAE,CAAC;IACvB,aAAa,EAAE,KAAK,EAAE,CAAC;CACxB;AA0DD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,GAAE,OAAsB,GAAG,QAAQ,CAOrE;AAMD;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAElD;AA6BD;;;;;;;GAOG;AACH,qBAAa,SAAS;IACpB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM;IAC/B,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,EAAE,EAAE,GAAG,CAA8C;IACrD,GAAG,EAAE,KAAK,CAAkB;IAC5B;0EACsE;IACtE,MAAM,EAAE,KAAK,CAAkB;IAC/B,IAAI,EAAE,MAAM,CAAO;IACnB,GAAG,EAAE,KAAK,CAAoB;IAC9B,QAAQ,EAAE,MAAM,CAAK;IACrB,KAAK,EAAE,KAAK,CAAkB;IAC9B,WAAW,EAAE,KAAK,CAAkB;IACpC,QAAQ,EAAE,KAAK,CAAkB;IACjC,KAAK,EAAE,MAAM,CAAK;IAClB,SAAS,EAAE,MAAM,CAAK;IACtB,QAAQ,EAAE,MAAM,CAAK;IACrB,6EAA6E;IAC7E,QAAQ,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,CAAM;IACjC,MAAM,EAAE,MAAM,CAAK;IACnB,MAAM,EAAE,MAAM,CAAK;IACnB;uEACmE;IACnE,YAAY,EAAE,MAAM,CAAK;IACzB;wEACoE;IACpE,YAAY,EAAE,MAAM,CAAK;IACzB,+EAA+E;IAC/E,QAAQ,EAAE,OAAO,CAAQ;IACzB;sFACkF;IAClF,SAAS,EAAE,MAAM,CAAM;IAEvB;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,MAAM;IAM5E,gEAAgE;IAChE,QAAQ,CAAC,EAAE,cAAc,CAAC;IAE1B;;;;;;OAMG;IACH,iBAAiB,EAAE,SAAS,GAAG,IAAI,CAAQ;IAE3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;gBAE/B,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY;IAKlD;oCACgC;IAChC,aAAa,IAAI,MAAM;IAIvB;kEAC8D;IAC9D,aAAa,IAAI,MAAM;IAIvB,uDAAuD;IACvD,IAAI,GAAG,IAAI,QAAQ,GAAG,IAAI,CAGzB;IAED,2CAA2C;IAC3C,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI9B;;;OAGG;IACH,MAAM,IAAI,IAAI;IAOd,4CAA4C;IAC5C,KAAK,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAItB;;;;;;;OAOG;IACH,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAS5B;;;;OAIG;IACH,UAAU,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI;CAK3B"}

package/dist/gvc/textlayout.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Text layout selection and measurement.
+ *
+ * Ports gvtextlayout_select and gvtextlayout from lib/gvc/gvtextlayout.c,
+ * simplified for the TypeScript model where the text-layout engine is always
+ * the context's registered TextMeasurer (no dynamic plugin loading).
+ *
+ * @see lib/gvc/gvtextlayout.c:gvtextlayout_select
+ * @see lib/gvc/gvtextlayout.c:gvtextlayout
+ */
+import type { GvcContext } from './context.js';
+import type { TextMeasurer } from '../common/textmeasure.js';
+import type { TextSpan } from '../common/emit-types.js';
+/**
+ * Return the text measurer registered on ctx.
+ *
+ * Replaces gvtextlayout_select / plugin load with direct access to the
+ * context's measurer, per AD-2 (static registration, no libltdl).
+ *
+ * @see lib/gvc/gvtextlayout.c:gvtextlayout_select
+ */
+export declare function selectTextLayout(ctx: GvcContext): TextMeasurer;
+/**
+ * Measure a text span and write the result into span.size.
+ *
+ * Mirrors gvtextlayout: calls the engine's textlayout method to populate
+ * the size field on the span.  Falls back to 'Times-Roman' / 14pt when
+ * fontName or fontSize are unspecified.
+ *
+ * @see lib/gvc/gvtextlayout.c:gvtextlayout
+ */
+export declare function measure(span: TextSpan, ctx: GvcContext): void;
+//# sourceMappingURL=textlayout.d.ts.map

package/dist/gvc/textlayout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textlayout.d.ts","sourceRoot":"","sources":["../../src/gvc/textlayout.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,YAAY,CAE9D;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,GAAG,IAAI,CAK7D"}

package/dist/gvc/textspan-emit.d.ts

@@ -0,0 +1,41 @@
+import type { Point } from '../model/geom.js';
+import type { TextSpan } from '../common/emit-types.js';
+import type { RendererPlugin } from './context.js';
+import type { RenderJob } from './job.js';
+import { EmitState, ObjType } from './job.js';
+/**
+ * The label emit-state for the current object type — the `EMIT_*LABEL` value C
+ * passes to `emit_label(job, EMIT_xLABEL, lp)` at each call site (a node label
+ * is EMIT_NLABEL, a graph label EMIT_GLABEL, etc.). Every span reaching
+ * gvrenderTextspan IS a label, so its emit-state is always the label variant of
+ * the enclosing object. Centralizing it here (rather than threading the value
+ * through each caller as C does) is an SVG-safe adaptation: the SVG renderer
+ * ignores emit_state, while the xdot renderer routes each op into the object's
+ * label xbuf by exactly this value. @see lib/common/labels.c:emit_label
+ */
+export declare function labelEmitState(type: ObjType): EmitState;
+/**
+ * Run `fn` with the object's label emit-state active (restored afterward) —
+ * the emit_label window that routes EVERY draw op of a label (HTML-table
+ * borders/fills AND text spans) into the object's LABEL xbuf, not its DRAW
+ * xbuf. Needed for HTML labels, whose box/fill polygons reach the renderer via
+ * gvrender_polygon (not gvrenderTextspan). SVG-safe: SVG ignores emit_state.
+ * @see lib/common/labels.c:224/274 emit_label (emit_state save/set/restore)
+ */
+export declare function withLabelEmitState(job: RenderJob, fn: () => void): void;
+/**
+ * Whether a label span should be emitted: non-empty string, and (unless no
+ * obj) a visible pen.
+ * @see lib/gvc/gvrender.c:419 gvrender_textspan
+ *   if (span->str && span->str[0] && (!job->obj || job->obj->pen != PEN_NONE))
+ */
+export declare function spanIsVisible(span: TextSpan, job: RenderJob): boolean;
+/**
+ * Emit one text span through the renderer, applying C's visibility guard.
+ * All label emitters (node/record labels, edge/graph labels, cluster labels,
+ * HTML-table text runs) route through here, exactly as C routes every
+ * emission through gvrender_textspan.
+ * @see lib/gvc/gvrender.c:414 gvrender_textspan
+ */
+export declare function gvrenderTextspan(renderer: RendererPlugin, pos: Point, span: TextSpan, job: RenderJob): void;
+//# sourceMappingURL=textspan-emit.d.ts.map

package/dist/gvc/textspan-emit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textspan-emit.d.ts","sourceRoot":"","sources":["../../src/gvc/textspan-emit.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAE9C;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,CAOvD;AAQD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI,CAMvE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAGrE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,EACxB,GAAG,EAAE,KAAK,EACV,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,SAAS,GACb,IAAI,CAkBN"}

package/dist/gvc/usershape.d.ts

@@ -0,0 +1,25 @@
+/**
+ * User-shape (image) size resolution for HTML <IMG> labels.
+ *
+ * C resolves image dimensions through a process-global dictionary
+ * (gvusershape.c ImageDict) populated from the filesystem — browser-
+ * hostile. Per AD3, the port exposes a caller-injected ImageSizer in
+ * the same global-registry position: callers register a sizer before
+ * rendering; absent or unresolvable sources reproduce C's
+ * missing-image behavior (warning + zero size).
+ *
+ * @see lib/gvc/gvusershape.c (ImageDict, gvusershape_find/size)
+ */
+import type { ImageSizer } from '../common/htmltable-types.js';
+export type { ImageSizer } from '../common/htmltable-types.js';
+/**
+ * Register (or clear, with null) the global image sizer consulted by
+ * HTML <IMG> sizing. Mirrors gvusershape's process-global dictionary.
+ */
+export declare function setImageSizer(sizer: ImageSizer | null): void;
+/** Resolve an image source via the registered sizer; null if unresolved. */
+export declare function findImageSize(src: string): {
+    w: number;
+    h: number;
+} | null;
+//# sourceMappingURL=usershape.d.ts.map

package/dist/gvc/usershape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usershape.d.ts","sourceRoot":"","sources":["../../src/gvc/usershape.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAE/D,YAAY,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAI/D;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAE5D;AAED,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAE1E"}

package/dist/gvc/viewport.d.ts

@@ -0,0 +1,71 @@
+import type { Box, Point } from '../model/geom.js';
+import type { Graph } from '../model/graph.js';
+/** Parsed `size=` drawing size in points, plus the *filled* flag. */
+export interface DrawingSize {
+    x: number;
+    y: number;
+    filled: boolean;
+}
+/**
+ * Port of getdoubles2ptf(g, "size", …) for the `size=` attribute: parse
+ * `"x,y"` (or a lone `"x"` meaning square), convert inches→points, and treat a
+ * trailing `!` as the *filled* flag. Returns null when `size` is absent or
+ * non-positive (Z stays 1 — D5).
+ * @see lib/common/input.c:476 getdoubles2ptf
+ */
+export declare function parseDrawingSize(raw: string | undefined): DrawingSize | null;
+/**
+ * Port of the `pad=` graph-attribute parse: init_gvc reads it via
+ * `sscanf(p, "%lf,%lf", &xf, &yf)` (2 values matched → both axes
+ * independently; 1 value → y = x; 0 matched — attr absent or unparsable —
+ * leaves `graph_sets_pad` false) and init_job_pad falls back to the SVG
+ * plugin's `default_pad` (this port's only renderer) when unset, which is
+ * numerically identical to `DEFAULT_GRAPH_PAD` (4pt) — so the two C fallback
+ * branches collapse to the same constant here (`SVG_PAD`).
+ *
+ * Unlike `size=`, pad values are NOT rounded (`xf * POINTS_PER_INCH`
+ * directly — no `POINTS()` macro) and are not required to be positive.
+ *
+ * @see lib/common/emit.c:3241-3251 init_gvc (pad attr read)
+ * @see lib/common/emit.c:3290-3304 init_job_pad (fallback)
+ */
+export declare function parseGraphPad(raw: string | undefined): Point;
+/**
+ * Port of the `margin=` graph-attribute parse: init_gvc reads it via the same
+ * `sscanf(p, "%lf,%lf", &xf, &yf)` shape as `pad=` (2 values matched → both
+ * axes independently; 1 value → y = x; 0 matched leaves `graph_sets_margin`
+ * false) and init_job_margin falls back to the SVG plugin's
+ * `device_features_svg.default_margin` ({0,0}) when unset — the
+ * `GVRENDER_PLUGIN` branch of init_job_margin's fallback switch (the
+ * PCL/MIF/etc. print-margin and generic embed-margin branches never apply to
+ * this port's only renderer).
+ *
+ * This is a distinct attribute/mechanism from the already-ported per-node and
+ * per-cluster `margin=` (shape internal label margin) — do not conflate.
+ * Unlike `size=`, margin values are NOT rounded (`xf * POINTS_PER_INCH`
+ * directly) and are not required to be positive, matching `pad=`.
+ *
+ * @see lib/common/emit.c:3229-3239 init_gvc (margin attr read)
+ * @see lib/common/emit.c:3309-3331 init_job_margin (fallback)
+ */
+export declare function parseGraphMargin(raw: string | undefined): Point;
+/**
+ * Port of the landscape detection in `input.c`: `rotate=90`, or
+ * `orientation` starting with `l`/`L`, or a truthy `landscape`. Each branch is
+ * mutually exclusive in the same precedence as C (rotate wins over orientation
+ * wins over landscape). Returns false when no rotation attribute is present.
+ * This flag is **emit-only** — it drives `job.rotation`, never layout (ADR-1).
+ * @see lib/common/input.c:699-704
+ */
+export declare function parseLandscape(g: Graph): boolean;
+/**
+ * Port of init_job_viewport's zoom factor Z (emit.c:3375-3384). When the user
+ * gave a `size=`, fit the drawing (size `sz` = bb plus pad, in points) into it.
+ * Z stays 1.0 otherwise, leaving every non-`size` byte unchanged (D5). SVG
+ * carries Z via the group transform, not the coordinates (D4). `pad` is the
+ * resolved `job.pad` (parseGraphPad), matching C's `job->bb = bb ± job->pad`
+ * before `sz = job->bb.UR - job->bb.LL` (emit.c:3363-3368).
+ * @see lib/common/emit.c:3356 init_job_viewport
+ */
+export declare function initJobViewportZoom(bb: Box, size: DrawingSize | null, pad: Point): number;
+//# sourceMappingURL=viewport.d.ts.map

package/dist/gvc/viewport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewport.d.ts","sourceRoot":"","sources":["../../src/gvc/viewport.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG/C,qEAAqE;AACrE,MAAM,WAAW,WAAW;IAC1B,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,MAAM,EAAE,OAAO,CAAC;CACjB;AAkBD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,IAAI,CAc5E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAa5D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,CAa/D;AAeD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAUhD;AAYD;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,MAAM,CASzF"}

package/dist/index.d.ts

@@ -0,0 +1,54 @@
+import type { RenderResult } from './errors.js';
+import type { EngineName } from './gvc/context.js';
+/**
+ * Render a DOT-language string to SVG using the specified layout engine.
+ *
+ * Always throws a value implementing {@link GvError}: parse failures throw
+ * `ParseError`; layout/render failures surface as `RenderError`
+ * (`RENDER_ERROR`).
+ *
+ * @remarks
+ * Security: when `dotSource` is untrusted, treat the returned SVG as
+ * attacker-controlled markup. Attribute values are XML-escaped (no element or
+ * attribute breakout), but URL schemes and resource origins in `href`/`URL`/
+ * `image`/`stylesheet` are passed through unfiltered, matching native Graphviz.
+ * Embedding pages should apply a Content-Security-Policy (or sanitize the
+ * markup) — see the "Security" section of the README.
+ *
+ * @param dotSource - DOT-language graph source
+ * @param engine    - layout engine name ({@link EngineName}): a built-in
+ *                    ('dot', 'neato', 'fdp', 'sfdp', 'circo', 'twopi',
+ *                    'osage', 'patchwork') or any custom-registered name
+ * @returns SVG string
+ * @throws ParseError if dotSource is not valid DOT
+ * @throws RenderError if layout or rendering fails
+ */
+export declare function renderSvg(dotSource: string, engine: EngineName): string;
+/**
+ * Result-style render: returns `{ svg }` on success or `{ errors: [one] }` on
+ * the first failure (svg XOR errors). Errors are plain JSON-serializable
+ * {@link GvError} data objects.
+ *
+ * @remarks
+ * Security: same untrusted-input caveat as {@link renderSvg} — the returned
+ * `svg` is attacker-controlled markup for untrusted `dotSource`; apply a CSP or
+ * sanitize before embedding. See the README "Security" section.
+ */
+export declare function tryRenderSvg(dotSource: string, engine: EngineName): RenderResult;
+export { parse } from './parser/index.js';
+export { ParseError } from './parser/index.js';
+export { RenderError } from './errors.js';
+export type { GvError, GvErrorType, GvErrorCode, GvExpectation, RenderResult, } from './errors.js';
+export { setImageSizer } from './gvc/usershape.js';
+export type { ImageSizer } from './common/htmltable-types.js';
+export { setImageResolver } from './gvc/image-resolver.js';
+export type { ImageResolver } from './gvc/image-resolver.js';
+export { setTextMeasurer, getTextMeasurer } from './common/textmeasure-factory.js';
+export { CanvasTextMeasurer, EstimateTextMeasurer, LutTextMeasurer, } from './common/textmeasure.js';
+export type { TextMeasurer, TextSize, TextVariantFlags } from './common/textmeasure.js';
+export { GvcContext } from './gvc/context.js';
+export type { BuiltinEngine, EngineName } from './gvc/context.js';
+export { render as renderWithContext } from './gvc/device.js';
+export * from './api/index.js';
+export * from './render/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAW,YAAY,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA8CnD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,CAmBvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,YAAY,CAMhF;AAED,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EACV,OAAO,EACP,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,YAAY,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAM7D,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACnF,OAAO,EACL,kBAAkB,EAAE,oBAAoB,EAAE,eAAe,GAC1D,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,YAAY,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACxF,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMlE,OAAO,EAAE,MAAM,IAAI,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAU9D,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}