@knowvah/dot-engine 0.1.0

package/dist/common/poly-sizing.d.ts

@@ -0,0 +1,189 @@
+/**
+ * Label-driven node sizing — a faithful port of the sizing portion of
+ * poly_init. Computes the node bounding box from the label dimensions
+ * and node attributes, then converts to lw/rw/ht via gv_nodesize.
+ *
+ * poly_desc size_gen hooks (star_size, cylinder_size) ARE ported — see
+ * starSize/cylinderSize and the shapes.c:2073-2085 dispatch in polySize.
+ * The star_vertices aspect-correction feedback into node width (shapes.c:2217,
+ * only observable when an explicit width/height forces a non-star aspect) is
+ * NOT yet replicated — polygonBB sizes the star via a regular decagon.
+ *
+ * Not ported (no TS counterpart yet, no suite coverage):
+ * - usershape/image sizing (gvusershape_size) — needs an image loader.
+ *
+ * @see lib/common/shapes.c:poly_init
+ * @see lib/common/utils.c:gv_nodesize
+ */
+import type { Point } from '../model/geom.js';
+/** Whitespace in points around labels / between peripheries. @see lib/common/const.h:GAP */
+export declare const GAP = 4;
+/**
+ * Inputs for polySize, mirroring what poly_init reads from the node.
+ * All lengths are in points unless suffixed `In` (inches).
+ */
+export interface PolySizeParams {
+    /** Label size in points. @see ND_label(n)->dimen */
+    labelDimen: Point;
+    /** Effective polygon sides after attr resolution (0 means attr-driven). */
+    sides: number;
+    /** Periphery count after the peripheries attr override. */
+    peripheries: number;
+    /** Orientation in degrees (shape base + orientation attr). */
+    orientation: number;
+    /** Distortion factor. */
+    distortion: number;
+    /** Skew factor. */
+    skew: number;
+    /** Shape regular flag OR'd with the regular attr. */
+    regular: boolean;
+    /** True for shape=plain. @see lib/common/shapes.c:IS_PLAIN */
+    isPlain: boolean;
+    /** width attr in inches (default 0.75, min 0.01). */
+    widthIn: number;
+    /** height attr in inches (default 0.5, min 0.02). */
+    heightIn: number;
+    /** INCH2PS(max(width attr, height attr)), 0 when unset. @see shapes.c:userSize */
+    userSizePts: number;
+    /** Raw margin attr (inches, "x" or "x,y"), undefined when unset. */
+    margin: string | undefined;
+    /** fixedsize attr (default "false"). */
+    fixedsize: string;
+    /** labelloc attr, undefined when unset. */
+    labelloc: string | undefined;
+    /** Graph quantum attr in inches (0 disables quantization). */
+    quantumIn: number;
+    /** True when rankdir flips coordinates. @see GD_flip */
+    flip: boolean;
+    /** penwidth attr (default 1, min 0). @see lib/common/const.h:DEFAULT_NODEPENWIDTH */
+    penwidth?: number;
+    /**
+     * polygon->option.shape — the size_gen discriminant. STAR and CYLINDER have a
+     * poly_desc (star_gen/cylinder_gen) whose size_gen inflates the label box;
+     * every other value (0, or an SBOL shape) takes the generic ellipse fit.
+     * @see lib/common/shapes.c:2075 (`else if (polygon->vertices) bb = size_gen(bb)`)
+     */
+    optionShape?: number;
+    /**
+     * nojustify attr. When true, the label's justification borders shrink to the
+     * label's own width instead of the node width, so a `\l`/`\r` line aligns to
+     * the centered label block rather than the node edge.
+     * @see lib/common/shapes.c:2132-2145
+     */
+    nojustify?: boolean;
+}
+/** Node geometry in points: left/right half-widths and height. */
+export interface NodeSize {
+    lw: number;
+    rw: number;
+    ht: number;
+}
+/** polySize result: node size plus unflipped outline extents (points). */
+export interface PolySizeResult extends NodeSize {
+    /** Outline width in points (bb + penwidth growth). @see ND_outline_width */
+    outlineW: number;
+    /** Outline height in points. @see ND_outline_height */
+    outlineH: number;
+    /**
+     * Pre-periphery-growth bb (points) — the box C scales the BASE
+     * (innermost) vertex ring to before stepping rings outward. Needed
+     * by ring generation for multi-periphery general polygons.
+     * @see lib/common/shapes.c:poly_init (bb before the outp loop)
+     */
+    baseW: number;
+    baseH: number;
+    /**
+     * Justification borders — the space available for the label within the node
+     * box. `emit_label` reads this (not `dimen`) for `labelloc` top/bottom and
+     * left/right justification; without it a `labelloc=b` label centers.
+     * @see lib/common/shapes.c:poly_init (2132-2152)
+     */
+    space: Point;
+    /** Resolved vertical alignment ('t'/'c'/'b') from labelloc. */
+    valign: string;
+}
+/**
+ * Initial width/height in points from the width/height attrs,
+ * the regular flag, and the plain special case.
+ * @see lib/common/shapes.c:poly_init (width/height setup)
+ */
+export declare function initialSizePts(p: PolySizeParams): {
+    width: number;
+    height: number;
+};
+/**
+ * Add minimal whitespace around the label: the margin attr in inches,
+ * or PAD (16x8 points) when unset. Plain shapes get no padding.
+ * @see lib/common/shapes.c:poly_init (margin/PAD block)
+ */
+export declare function padLabelDimen(labelDimen: Point, margin: string | undefined, isPlain: boolean): Point;
+/**
+ * Expand bb so the smallest ellipse (or inscribing polygon) centered on
+ * the origin contains the label box. Boxes are exempt (exact fit).
+ * @see lib/common/shapes.c:poly_init (ellipse/polygon expansion)
+ */
+/**
+ * star_gen size_gen: inflate the label box to the node size a 5-pointed star
+ * needs so the label fits inside its inner pentagon. Much larger than the
+ * generic ellipse fit — omitting it leaves the node box too small, so the
+ * star's outer points render outside the node bbox and the graph viewport.
+ * @see lib/common/shapes.c:4039 star_size (alpha = PI/10)
+ */
+export declare function starSize(bb: Point): Point;
+/**
+ * cylinder_gen size_gen: scale height by 1.375 (x unchanged), leaving room for
+ * the top/bottom ellipse arcs. @see lib/common/shapes.c:4153 cylinder_size
+ */
+export declare function cylinderSize(bb: Point): Point;
+export declare function expandForShape(bb: Point, sides: number, heightPts: number, valign: string): Point;
+/** Effective polygon geometry for the unit vertex loop. */
+export interface PolyGeom {
+    sides: number;
+    orientation: number;
+    distortion: number;
+    skew: number;
+}
+/**
+ * Unit-polygon vertex loop: distort, skew, orient, then scale by bb.
+ * Returns the scaled vertices and the bounding half-extents.
+ * @see lib/common/shapes.c:poly_init (polygon vertex loop)
+ */
+export declare function polygonVertices(bb: Point, g: PolyGeom, isBox: boolean): {
+    verts: Point[];
+    xmax: number;
+    ymax: number;
+};
+/**
+ * Per-vertex bisector GAP offsets for a polygon ring — the (cosx, sinx)
+ * pairs C uses to place each successive periphery.
+ * @see lib/common/shapes.c:poly_init (peripheries bisector loop)
+ */
+export declare function polygonRingOffsets(verts: Point[], sides: number): Point[];
+/**
+ * The outline ring: each vertex offset along its angle bisector by
+ * half the penwidth (the stroked boundary poly_inside clips against).
+ * @see lib/common/shapes.c:poly_init (outline ring at outp)
+ */
+export declare function polygonOutlineRing(verts: Point[], sides: number, penwidth: number): Point[];
+/**
+ * Grow a polygon bb to cover the outermost periphery ring, and the
+ * outline bb to cover the half-penwidth ring beyond it.
+ * @see lib/common/shapes.c:poly_init (peripheries bisector loop)
+ */
+export declare function polygonPeripheryBB(verts: Point[], sides: number, p: {
+    peripheries: number;
+    penwidth: number;
+    hasOutline: boolean;
+}, bb: Point): {
+    bb: Point;
+    outline: Point;
+};
+/** Convert final node width/height (points) to lw/rw/ht. @see lib/common/utils.c:gv_nodesize */
+export declare function gvNodesize(widthPts: number, heightPts: number, flip: boolean): NodeSize;
+/**
+ * Compute node dimensions from label size and attrs — the sizing
+ * portion of poly_init followed by gv_nodesize.
+ * @see lib/common/shapes.c:poly_init
+ */
+export declare function polySize(p: PolySizeParams): PolySizeResult;
+//# sourceMappingURL=poly-sizing.d.ts.map

package/dist/common/poly-sizing.d.ts.map

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

package/dist/common/poly-vertices.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Vertex computation helpers for polygon shape initialisation.
+ *
+ * @see lib/common/shapes.c:poly_init
+ */
+import type { PolygonT } from './types.js';
+import type { Point } from '../model/geom.js';
+/** Compute vertices for an ellipse/circle (sides <= 2). */
+export declare function ellipseVertices(w: number, h: number): Point[];
+/**
+ * Cylinder control polygon: 19 Bézier control points (origin-centred), ported
+ * verbatim from C's cylinder_vertices. Drawn as a bezier outline, not a polygon.
+ * @see lib/common/shapes.c:4159 cylinder_vertices
+ */
+export declare function cylinderVertices(w: number, h: number): Point[];
+/**
+ * Compute vertices for a simple box (sides == 4, no distortion/skew).
+ * Order matches C poly_init: top-right → top-left → bottom-left → bottom-right.
+ * @see lib/common/shapes.c:poly_init
+ */
+export declare function boxVertices(w: number, h: number, orientation?: number): Point[];
+/**
+ * Compute vertices for a regular polygon with arbitrary sides.
+ *
+ * Starting angle matches C poly_init: first vertex at 3π/n - π/2
+ * (top-right for n=4, top for n=3).
+ * @see lib/common/shapes.c:poly_init (polygon vertex loop)
+ */
+export declare function generalPolyVertices(poly: PolygonT, w: number, h: number): Point[];
+/**
+ * Star (5-pointed) base vertices: 10 points alternating an outer radius `r` and
+ * inner radius `r0`, shifted down by `offset`. The box is first scaled to the
+ * star aspect ratio (the `a < aspect` branch grows only the unused y extent).
+ * @see lib/common/shapes.c:star_vertices (alpha = PI/10)
+ */
+export declare function starVertices(w: number, h: number): Point[];
+/** Choose vertex layout strategy based on polygon descriptor and size. */
+export declare function computeVertices(poly: PolygonT, w: number, h: number, base?: {
+    w: number;
+    h: number;
+}): Point[];
+//# sourceMappingURL=poly-vertices.d.ts.map

package/dist/common/poly-vertices.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poly-vertices.d.ts","sourceRoot":"","sources":["../../src/common/poly-vertices.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAI9C,2DAA2D;AAC3D,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAK7D;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAc9D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,WAAW,SAAI,GAAG,KAAK,EAAE,CAqB1E;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAgBjF;AAiFD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAkB1D;AAiBD,0EAA0E;AAC1E,wBAAgB,eAAe,CAC7B,IAAI,EAAE,QAAQ,EACd,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,IAAI,CAAC,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAC9B,KAAK,EAAE,CAeT"}

package/dist/common/postproc.d.ts

@@ -0,0 +1,49 @@
+/**
+ * TypeScript port of lib/common/postproc.c — gv_postprocess (coordinate
+ * rotation + translation pass run after spline routing).
+ *
+ * addXLabels logic lives in xlabels-place.ts to keep this file under the
+ * 500-line limit. It is called from gvPostprocess at the C point
+ * (postproc.c:616 — after graph-label placement, before the bb adjustment).
+ *
+ * @see lib/common/postproc.c:gv_postprocess
+ * @see lib/common/postproc.c:map_point
+ * @see lib/common/postproc.c:translate_bb
+ * @see lib/common/postproc.c:translate_drawing
+ * @see lib/common/postproc.c:addXLabels
+ */
+import type { Graph } from '../model/graph.js';
+/**
+ * Rotate the bounding box of a graph (and its clusters, recursively).
+ * @see lib/common/postproc.c:translate_bb
+ */
+export declare function translateBb(g: Graph, rankdir: number): void;
+/**
+ * Set the position of the root graph label.
+ * Called after translate_drawing so the bb is already in output space;
+ * no flip/rotation compensation is needed here.
+ *
+ * @see lib/common/postproc.c:place_root_label
+ */
+export declare function placeRootLabel(g: Graph, dimen: {
+    x: number;
+    y: number;
+}): void;
+/**
+ * Port of gv_postprocess. `allowTranslation` mirrors the C parameter:
+ * `dotneato_postprocess` (dot, sfdp, circo, twopi) and `neato_layout` pass 1;
+ * `fdp_layout` passes 0 (layout.c:1076) because fdp's finalCC has already
+ * placed the drawing at the origin.
+ *
+ * Order matches C: addXLabels → expand bb for root label → compute Offset →
+ * translateDrawing → place_root_label.
+ *
+ * addXLabels is called at postproc.c:616 — after place_graph_label (cluster
+ * labels handled elsewhere), before bb adjustment.
+ * Root graph label is placed at postproc.c:675-676, after translateDrawing.
+ *
+ * @see lib/common/postproc.c:gv_postprocess
+ * @see lib/common/postproc.c:dotneato_postprocess
+ */
+export declare function gvPostprocess(g: Graph, allowTranslation?: boolean): void;
+//# sourceMappingURL=postproc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"postproc.d.ts","sourceRoot":"","sources":["../../src/common/postproc.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAuJ/C;;;GAGG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQ3D;AAyMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAO9E;AAOD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,UAAO,GAAG,IAAI,CAiBrE"}

package/dist/common/ps-fontalias.d.ts

@@ -0,0 +1,36 @@
+/**
+ * One PostScript-font alias entry (the fields the SVG renderer uses in the
+ * default NATIVEFONTS mode). `xfig_code` and the SVGFONTS-only svg_font_weight/
+ * svg_font_style fields are intentionally omitted — unused for SVG output.
+ * @see lib/common/textspan.h _PostscriptAlias
+ */
+export interface PostscriptAlias {
+    family: string;
+    weight: string | null;
+    stretch: string | null;
+    style: string | null;
+    svgFontFamily: string;
+}
+/**
+ * Resolve a PostScript font name to its alias, or null when unknown.
+ * Case-insensitive exact match (mirrors C's strcasecmp bsearch).
+ * @see lib/common/textspan.c:66 translate_postscript_fontname
+ */
+export declare function translatePostscriptFontname(name: string): PostscriptAlias | null;
+/**
+ * Build the SVG font attribute string for a span's font name when it resolves
+ * to a PostScript alias: ` font-family="family[,svgFontFamily]"` plus the
+ * alias's weight/stretch/style. Returns null when there is no alias (the caller
+ * emits the name verbatim). `weight`/`style` report whether the alias set them,
+ * so the HTML-flag block can avoid duplicating bold/italic.
+ *
+ * Family strings contain no XML-special characters, so (like C's raw `%s`) no
+ * escaping is applied here.
+ * @see plugin/core/gvrender_core_svg.c:462-495 svg_textspan (NATIVEFONTS)
+ */
+export declare function fontFamilyAttrs(fontName: string | null): {
+    attrs: string;
+    weight: boolean;
+    style: boolean;
+} | null;
+//# sourceMappingURL=ps-fontalias.d.ts.map

package/dist/common/ps-fontalias.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ps-fontalias.d.ts","sourceRoot":"","sources":["../../src/common/ps-fontalias.ts"],"names":[],"mappings":"AAiBA;;;;;GAKG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAmDD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAEhF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,GACtB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAS3D"}

package/dist/common/random.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Seed the generator: X = (seed << 16) | 0x330E (low 32 bits of seed).
+ * @see POSIX srand48(3)
+ */
+export declare function srand48(seed: number): void;
+/** Next double in [0, 1). @see POSIX drand48(3) */
+export declare function drand48(): number;
+//# sourceMappingURL=random.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/common/random.ts"],"names":[],"mappings":"AAuBA;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAG1C;AAED,mDAAmD;AACnD,wBAAgB,OAAO,IAAI,MAAM,CAGhC"}

package/dist/common/record-port.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Record-shape edge ports: resolve a `field:compass` port string to a point on
+ * the named field's bounding box (falling back to a compass on the whole
+ * record bbox when the name is not a field id).
+ *
+ * @see lib/common/shapes.c:map_rec_port (line 3716)
+ * @see lib/common/shapes.c:record_port (line 3732)
+ */
+import type { Node } from '../model/node.js';
+import type { Box, Port } from '../model/geom.js';
+import type { FieldT } from './types.js';
+/**
+ * Recurse the field tree for a field whose id equals str (depth-first).
+ * @see lib/common/shapes.c:map_rec_port
+ */
+export declare function mapRecPort(f: FieldT, str: string): FieldT | null;
+/**
+ * portfn for record shapes. Empty portname → Center (makePort, byte-stable).
+ * A matching field → compass on the field bbox; otherwise the portname is
+ * treated as a compass on the whole record bbox.
+ * @see lib/common/shapes.c:record_port
+ */
+export declare function recordPort(n: Node, portname: string, compass: string): Port;
+/**
+ * pboxfn for record shapes: "generate box path from port to border". Emit ONE
+ * box — the full-node-height vertical strip of the TOP-LEVEL field whose axis
+ * range brackets the port point `prt.p.x` — into `rv[0]`, set `kptr[0]=1`, and
+ * return `side`. Returns 0 when the port is undefined. Without this, a record
+ * head/tail port with no explicit side (interior cell, side==0) falls back to
+ * the node's maximal bbox and the spline cuts straight across instead of
+ * hugging the port column. @see lib/common/shapes.c:record_path (line 3793)
+ */
+export declare function recordPath(n: Node, prt: Port, side: number, rv: Box[], kptr: number[]): number;
+//# sourceMappingURL=record-port.d.ts.map

package/dist/common/record-port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-port.d.ts","sourceRoot":"","sources":["../../src/common/record-port.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAOzC;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAShE;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAa3E;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,CAuB9F"}

package/dist/common/record.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Record-shape support: label parsing, sizing, field placement, and
+ * rendering for shape=record / shape=Mrecord nodes.
+ *
+ * @see lib/common/shapes.c:parse_reclbl
+ * @see lib/common/shapes.c:size_reclbl
+ * @see lib/common/shapes.c:resize_reclbl
+ * @see lib/common/shapes.c:pos_reclbl
+ * @see lib/common/shapes.c:record_init
+ * @see lib/common/shapes.c:record_gencode
+ */
+import type { Node } from '../model/node.js';
+import type { Graph } from '../model/graph.js';
+import type { Point } from '../model/geom.js';
+import type { RenderJob } from '../gvc/job.js';
+import type { FieldT, TextlabelT } from './types.js';
+import type { TextMeasurer } from './textmeasure.js';
+/** Walks the record label text (C's global `reclblp`). */
+interface RecScan {
+    s: string;
+    i: number;
+    lbl: TextlabelT;
+    measurer: TextMeasurer;
+    /** Owning node — field labels resolve \N etc. against it (C make_label(n, ...)). */
+    obj?: Node;
+}
+/** Per-parse_reclbl-call state (C locals). */
+interface RecState {
+    rv: FieldT;
+    fi: number;
+    mode: number;
+    tbuf: string[];
+    hstIdx: number;
+    pbuf: string[];
+    hspIdx: number;
+    tmpport: string | null;
+    ishardspace: boolean;
+    fp: FieldT | null;
+}
+/** True when s[j] starts an escaped record delimiter. */
+export declare function recIsEscapedDelim(s: string, j: number): boolean;
+/** Count top-level fields to bound the fld array. @see parse_reclbl (maxf loop) */
+export declare function recCountFields(p: RecScan): number;
+/** Append a text char, collapsing soft spaces. @see parse_reclbl (INTEXT) */
+export declare function recPushText(st: RecState, c: string, html: boolean): void;
+/** Append a port-name char, collapsing soft spaces. @see parse_reclbl (INPORT) */
+export declare function recPushPort(st: RecState, c: string): void;
+export declare function recTextChar(p: RecScan, st: RecState, c: string): number;
+/**
+ * Parse a record label into a field tree.
+ * Returns null on malformed labels.
+ * @see lib/common/shapes.c:parse_reclbl
+ */
+export declare function parseReclbl(p: RecScan, LR: number, flag: boolean): FieldT | null;
+/** @see lib/common/shapes.c:size_reclbl */
+export declare function sizeReclbl(n: Node, g: Graph, f: FieldT): Point;
+/** @see lib/common/shapes.c:resize_reclbl */
+export declare function resizeReclbl(f: FieldT, sz: Point, nojustify: boolean): void;
+/** Side mask for child i. @see lib/common/shapes.c:pos_reclbl */
+export declare function recSideMask(f: FieldT, i: number, last: number): number;
+/** @see lib/common/shapes.c:pos_reclbl */
+export declare function posReclbl(f: FieldT, ul: Point, sides: number): void;
+/** Parse the record label, falling back to "\\N" on bad syntax. */
+export declare function recParseOrFallback(lbl: TextlabelT, measurer: TextMeasurer, flip: number, obj?: Node): FieldT;
+/**
+ * Parse, size, and place the record label; set node dimensions.
+ * The node's label (ND_label) must be built before calling.
+ * The +1 on height mirrors C's rounding kluge.
+ * @see lib/common/shapes.c:record_init
+ */
+export declare function recordInit(n: Node, g: Graph, measurer: TextMeasurer): void;
+/**
+ * Build ND_label for a record node — common_init_node's make_label call with
+ * is_record=true, which stores the raw text for record_init to parse.
+ * The caller must have bound `n.info.shape` first.
+ * @see lib/common/utils.c:441 (make_label with shapeOf(n) == SH_RECORD)
+ * @see lib/common/labels.c:139 (is_record branch: rv->text = gv_strdup(str))
+ */
+export declare function recordMakeLabel(n: Node, g: Graph, measurer: TextMeasurer): void;
+/**
+ * Build the node's record label and field tree; the caller must have bound
+ * `n.info.shape` first. Equivalent to common_init_node's label construction
+ * followed by record_init.
+ *
+ * NOTE: C creates ND_xlabel BETWEEN these two steps (utils.c:443-447, before
+ * the initfn dispatch on :453). commonInitNode therefore does not call this
+ * wrapper — it calls recordMakeLabel / initNodeXLabel / recordInit in C's
+ * order. This wrapper remains for the render-time re-init path (poly_init),
+ * where C never creates xlabels.
+ * @see lib/common/utils.c:common_init_node
+ */
+export declare function recordNodeInit(n: Node, g: Graph, measurer: TextMeasurer): void;
+/** Field separators and labels. @see lib/common/shapes.c:gen_fields */
+export declare function genFields(job: RenderJob, n: Node, f: FieldT): void;
+/** Divider polyline before child field. @see lib/common/shapes.c:gen_fields */
+export declare function genFieldSeparator(job: RenderJob, coord: Point, f: FieldT, child: FieldT): void;
+/**
+ * Shape codefn for record nodes: outer box then fields.
+ * Box corner order matches gvrender_box: LL, (LL.x,UR.y), UR, (UR.x,LL.y).
+ * @see lib/common/shapes.c:record_gencode
+ * @see lib/gvc/gvrender.c:gvrender_box
+ */
+export declare function recordGencode(rawJob: unknown, rawNode: unknown): void;
+export {};
+//# sourceMappingURL=record.d.ts.map

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

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