@knowvah/dot-engine 0.1.0

package/dist/common/style-resolve.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Pure style-resolution functions: parse style strings and resolve
+ * pen/fill properties from node attributes.  Data-in / data-out only —
+ * no rendering, no ObjState mutation (AD2).
+ *
+ * Exports: parseStyleFlags, resolvePenType, resolvePenWidth,
+ * resolveNodeFill, resolveNodeFillEx, resolvePenColor,
+ * resolveClusterFill, resolveClusterFillEx, findStopColor.
+ * Types: PolyStyleFlags, NodeAttrs, ClusterAttrs, ClusterFill, ResolvedFill.
+ *
+ * @see lib/common/types.h:graphviz_polygon_style_t
+ * @see lib/common/shapes.c:checkStyle
+ * @see lib/common/shapes.c:stylenode
+ * @see lib/common/shapes.c:penColor
+ * @see lib/common/shapes.c:findFill
+ * @see lib/common/emit.c:isFilled
+ * @see lib/common/emit.c:4010 parse_style
+ * @see lib/gvc/gvrender.c:481 gvrender_set_style
+ * @see lib/common/const.h (DEFAULT_COLOR="black", DEFAULT_FILL="lightgrey")
+ */
+import { PenType } from '../gvc/context.js';
+/** @see lib/common/types.h:graphviz_polygon_style_t */
+export interface PolyStyleFlags {
+    filled: boolean;
+    dashed: boolean;
+    dotted: boolean;
+    bold: boolean;
+    invis: boolean;
+    diagonals: boolean;
+    rounded: boolean;
+    radial: boolean;
+    striped: boolean;
+    wedged: boolean;
+    underline: boolean;
+    /**
+     * Pen width from a `setlinewidth(N)` style token, or null when absent.
+     * @see lib/gvc/gvrender.c:501 gvrender_set_style (atof of paren argument)
+     */
+    setLineWidth: number | null;
+}
+/**
+ * Minimal node attribute bag consumed by resolveNodeFill / resolveNodeFillEx.
+ * Mirrors the subset of node attrs read by findFill / isFilled in C.
+ */
+export interface NodeAttrs {
+    style?: string | undefined;
+    fillcolor?: string | undefined;
+    color?: string | undefined;
+    /** @see lib/common/emit.c gradientangle attr */
+    gradientangle?: string | undefined;
+}
+/**
+ * Minimal cluster attribute bag consumed by resolveClusterFill /
+ * resolveClusterFillEx.
+ * Mirrors the attrs read in emit_clusters (lib/common/emit.c:3805-3853).
+ */
+export interface ClusterAttrs {
+    style?: string | undefined;
+    color?: string | undefined;
+    pencolor?: string | undefined;
+    fillcolor?: string | undefined;
+    bgcolor?: string | undefined;
+    penwidth?: string | undefined;
+    /** @see lib/common/emit.c gradientangle attr */
+    gradientangle?: string | undefined;
+}
+/**
+ * Resolved fill and pen colors for a cluster boundary polygon.
+ * @see lib/common/emit.c:emit_clusters:3805-3853
+ */
+export interface ClusterFill {
+    /** Whether the cluster interior should be painted. */
+    filled: boolean;
+    /** Fill color to use when filled=true. */
+    fillColor: string;
+    /** Pen (stroke) color. */
+    penColor: string;
+}
+/**
+ * Discriminated fill result (AD4, AD6).
+ * 'none' = not filled; 'solid' = single color;
+ * 'linear'/'radial' = gradient from findStopColor.
+ * @see lib/common/emit.c:4335 findStopColor
+ */
+export type ResolvedFill = {
+    kind: 'none';
+} | {
+    kind: 'solid';
+    color: string;
+} | {
+    kind: 'linear' | 'radial';
+    fillColor: string;
+    stopColor: string;
+    frac: number;
+    angle: number;
+};
+/**
+ * The raw style tokens C's parse_style produces (comma-separated, trimmed,
+ * non-empty), truncated to empty past FUNLIMIT. These are what xdot's
+ * `xdot_style` re-emits as `S` ops (it skips filled/bold/setlinewidth). The
+ * port resolves style into a PenType for SVG; xdot needs the original tokens.
+ * @see lib/common/emit.c:4010 parse_style · gvrender_core_dot.c:161 xdot_style
+ */
+export declare function styleTokens(style: string | undefined): string[];
+/**
+ * Parse a graphviz style attribute string into a flag set.
+ *
+ * Splits on commas and trims. A `setlinewidth(N)` token captures its pen-width
+ * argument; other tokens containing '(' are ignored. When the non-empty token
+ * count reaches FUNLIMIT (64), C's parse_style returns early before building
+ * the style list — the observable effect is an empty style list (no flags
+ * applied), which we reproduce by returning zeroFlags().
+ *
+ * @see lib/common/emit.c:4010 parse_style (FUNLIMIT truncation)
+ * @see lib/gvc/gvrender.c:481 gvrender_set_style (setlinewidth → penwidth)
+ */
+export declare function parseStyleFlags(style: string | undefined): PolyStyleFlags;
+/**
+ * Resolve PenType from parsed style flags.
+ * Dashed is checked before dotted (lib/gvc/gvrender.c:493-495).
+ * @see lib/gvc/gvrender.c:493
+ */
+/**
+ * True when a style string contains the "invisible" pen alias.
+ *
+ * `gvrender_set_style` maps BOTH "invis" and "invisible" to PEN_NONE
+ * (`streq(line,"invis") || streq(line,"invisible")`), suppressing the object's
+ * draw. The exact "invis" token additionally drives emit_node/emit_edge's early
+ * return and the point shape's `{invis,filled}` whitelist (checkStyle uses exact
+ * "invis"), so it is tracked separately as `flags.invis`. This helper reports the
+ * "invisible"-only alias, which suppresses drawing for shapes that pass their raw
+ * style through gvrender_set_style (poly/record/edge) but NOT for the point shape.
+ * Tokenization mirrors parseStyleFlags (comma split, FUNLIMIT truncation).
+ * @see lib/gvc/gvrender.c:497 gvrender_set_style
+ * @see lib/common/shapes.c:point_gencode (point_style whitelist)
+ */
+export declare function styleHasInvisibleAlias(style: string | undefined): boolean;
+export declare function resolvePenType(flags: PolyStyleFlags): PenType;
+/**
+ * Resolve pen width from flags and the raw penwidth attribute string.
+ * Precedence: explicit `penwidth` attr → `setlinewidth(N)` style →
+ * `bold` flag (2.0) → default (1.0). The explicit attr wins because stylenode
+ * applies N_penwidth after gvrender_set_style. (When both `bold` and
+ * `setlinewidth` appear in one style string, C is order-dependent; that rare
+ * combination is not modelled here — setlinewidth wins.)
+ * @see lib/common/shapes.c:539 stylenode
+ * @see lib/gvc/gvrender.c:500 gvrender_set_style (bold/setlinewidth)
+ * @see lib/gvc/gvcjob.h:41 PENWIDTH_BOLD = 2.0
+ */
+export declare function resolvePenWidth(flags: PolyStyleFlags, penwidthAttr: string | undefined): number;
+/**
+ * Resolve fill state and fill color for a node.
+ * Precedence: fillcolor → color → DEFAULT_FILL ("lightgrey").
+ * Gradient specs return the first solid color (AD3).
+ * @see lib/common/shapes.c:401 findFillDflt
+ * @see lib/common/emit.c:705 isFilled
+ * @see lib/common/const.h:69 DEFAULT_FILL = "lightgrey"
+ */
+export declare function resolveNodeFill(attrs: NodeAttrs): {
+    filled: boolean;
+    color: string;
+};
+/**
+ * Resolve pen (stroke) color. Returns first solid color from colorList,
+ * or DEFAULT_COLOR ("black") when attr is absent.
+ * @see lib/common/shapes.c:389 penColor
+ * @see lib/common/const.h:48 DEFAULT_COLOR = "black"
+ */
+export declare function resolvePenColor(colorAttr: string | undefined): string;
+/**
+ * Resolve cluster fill: filled flag, fill color, and pen color.
+ * Ports emit_clusters (lib/common/emit.c:3805-3853). GUI state branches
+ * are not ported (browser-only; states managed externally).
+ * @see lib/common/emit.c:emit_clusters:3805-3853
+ */
+export declare function resolveClusterFill(attrs: ClusterAttrs): ClusterFill;
+/** @see lib/common/emit.c:4335 findStopColor */
+export declare function findStopColor(colorlist: string): {
+    fillColor: string;
+    stopColor: string;
+    frac: number;
+} | null;
+/**
+ * Discriminated fill for a node (AD4, AD6). New Ex variant — original
+ * resolveNodeFill shape unchanged for G3 compatibility.
+ * @see lib/common/emit.c:4335 findStopColor
+ * @see lib/common/shapes.c:findFill
+ */
+export declare function resolveNodeFillEx(attrs: NodeAttrs): ResolvedFill;
+/**
+ * Discriminated fill for a cluster (AD4, AD6). New Ex variant — original
+ * resolveClusterFill shape unchanged for G4 compatibility.
+ * @see lib/common/emit.c:emit_clusters:3805-3853
+ * @see lib/common/emit.c:4335 findStopColor
+ */
+export declare function resolveClusterFillEx(attrs: ClusterAttrs): ResolvedFill;
+//# sourceMappingURL=style-resolve.d.ts.map

package/dist/common/style-resolve.d.ts.map

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

package/dist/common/subst.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Graph-object escape substitution: \G \N \E \T \H \L resolved against
+ * a node, edge, or graph. Used by plain-label creation (escBackslash
+ * false — \\ left for the formatting pass) and by anchor/map data
+ * (escBackslash true — \\ collapses to \).
+ *
+ * @see lib/common/labels.c:strdup_and_subst_obj0
+ * @see lib/common/labels.c:strdup_and_subst_obj
+ */
+import { Node } from '../model/node.js';
+import { Edge } from '../model/edge.js';
+import { Graph } from '../model/graph.js';
+export type GraphObj = Node | Edge | Graph;
+/**
+ * Resolve graph-object escapes in str. Other escape sequences
+ * (\n, \l, \r, …) pass through unmodified; \\ collapses to \ only
+ * when escBackslash is set, mirroring C exactly.
+ * @see lib/common/labels.c:strdup_and_subst_obj0 (assembly loop)
+ */
+export declare function substObj(str: string, obj: GraphObj, escBackslash: boolean): string;
+/** The escBackslash=true form used for anchor/map data. @see strdup_and_subst_obj */
+export declare function substObjAnchor(str: string, obj: GraphObj): string;
+/**
+ * Tooltip newline mapping: \n and \l become newline, \r carriage
+ * return, and the backslash is dropped from any other escape. C runs
+ * this BEFORE object substitution (preprocessTooltip), which is why
+ * \N in a tooltip renders as a literal "N".
+ * @see lib/common/emit.c:interpretCRNL
+ */
+export declare function interpretCRNL(str: string): string;
+//# sourceMappingURL=subst.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subst.d.ts","sourceRoot":"","sources":["../../src/common/subst.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG1C,MAAM,MAAM,QAAQ,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;AA2D3C;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,CAalF;AAED,qFAAqF;AACrF,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,GAAG,MAAM,CAEjE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAgBjD"}

package/dist/common/taper.d.ts

@@ -0,0 +1,23 @@
+import type { Point, Bezier } from '../model/geom.js';
+/** Half-width function along the curve. @see taper.c:radfunc_t */
+export type RadFunc = (curlen: number, totallen: number, initwid: number) => number;
+/** Taper from initwid/2 at the start to 0 at the end. @see taper.c:forfunc */
+export declare const forfunc: RadFunc;
+/** Taper from 0 to initwid/2. @see taper.c:revfunc */
+export declare const revfunc: RadFunc;
+/** Constant half-width. @see taper.c:nonefunc */
+export declare const nonefunc: RadFunc;
+/** Widen to the midpoint then taper. @see taper.c:bothfunc */
+export declare const bothfunc: RadFunc;
+/**
+ * Select the taper radius function from the edge's `dir`. Undirected graphs
+ * default to `none`, directed to `forward`. @see taper.c:taperfun
+ */
+export declare function taperfun(dir: string | undefined, directed: boolean): RadFunc;
+/**
+ * Given a Bézier `bez`, return a polygon representing the spline as a tapered
+ * edge of starting width `initwid`; `radfunc` sets the half-width along the
+ * curve. @see taper.c:taper
+ */
+export declare function taper(bez: Bezier, radfunc: RadFunc, initwid: number): Point[];
+//# sourceMappingURL=taper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"taper.d.ts","sourceRoot":"","sources":["../../src/common/taper.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAStD,kEAAkE;AAClE,MAAM,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;AAEpF,8EAA8E;AAC9E,eAAO,MAAM,OAAO,EAAE,OAAgE,CAAC;AACvF,sDAAsD;AACtD,eAAO,MAAM,OAAO,EAAE,OAA4D,CAAC;AACnF,iDAAiD;AACjD,eAAO,MAAM,QAAQ,EAAE,OAA4C,CAAC;AACpE,8DAA8D;AAC9D,eAAO,MAAM,QAAQ,EAAE,OAGtB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAM5E;AAoKD;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,CAK7E"}

package/dist/common/textmeasure-factory.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Text-measurer selection.
+ *
+ * Resolution order (when no explicit override is set):
+ *   1. explicit override via setTextMeasurer (tests, host-faithful Node opt-in)
+ *   2. GV_TEXT_MEASURER=estimate|lut — test/CI hook to force a specific measurer
+ *   3. browser (document present) — CanvasTextMeasurer over the page canvas
+ *      (host-faithful: the same font the browser renders the SVG with)
+ *   4. Node default               — EstimateTextMeasurer (deterministic; matches
+ *      graphviz's own headless estimate_textspan_size)
+ *
+ * Host-faithful Node measurement (node-canvas) is intentionally NOT auto-loaded:
+ * the library has ZERO runtime deps and ships a single browser+Node bundle, so
+ * `canvas` must never be imported from src. Node consumers opt in explicitly:
+ *   `setTextMeasurer(new CanvasTextMeasurer(createCanvas(0,0).getContext('2d')))`
+ *
+ * @see lib/common/textspan.c:estimate_textspan_size
+ * @see plans/fix-xcoord-position/DESIGN.md
+ */
+import { type TextMeasurer } from './textmeasure.js';
+/**
+ * Install a process-wide text measurer, overriding auto-resolution. Pass
+ * `undefined` to clear and restore auto-resolution. Takes effect on the next
+ * render (renderSvg resolves the measurer per call). Use for deterministic
+ * tests or to wire a host-faithful Node measurer (e.g. node-canvas) — see the
+ * resolution note above.
+ */
+export declare function setTextMeasurer(m: TextMeasurer | undefined): void;
+/** The current explicit override, or undefined when auto-resolving. */
+export declare function getTextMeasurer(): TextMeasurer | undefined;
+/** Resolve the text measurer for this render (see resolution order above). */
+export declare function createMeasurer(): TextMeasurer;
+//# sourceMappingURL=textmeasure-factory.d.ts.map

package/dist/common/textmeasure-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textmeasure-factory.d.ts","sourceRoot":"","sources":["../../src/common/textmeasure-factory.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EACsD,KAAK,YAAY,EAC7E,MAAM,kBAAkB,CAAC;AAI1B;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,YAAY,GAAG,SAAS,GAAG,IAAI,CAEjE;AAED,uEAAuE;AACvE,wBAAgB,eAAe,IAAI,YAAY,GAAG,SAAS,CAE1D;AA2BD,8EAA8E;AAC9E,wBAAgB,cAAc,IAAI,YAAY,CAgB7C"}

package/dist/common/textmeasure-lookup.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Font-family lookup helpers for the text measurement LUT.
+ * @see lib/common/textspan_lut.c:get_metrics_for_font_family
+ */
+import { type FontFamilyData } from "./textmeasure-lut-data.js";
+/** Times is always present; used as the fallback family. */
+export declare const TIMES_FALLBACK: FontFamilyData;
+/**
+ * Normalize a font name for permissive matching.
+ * Lowercases and strips all non-ASCII-letter characters.
+ * "Times New Roman" → "timesnewroman", "Times-Roman" → "timesroman".
+ * @see lib/common/textspan_lut.c:font_name_equal_permissive
+ */
+export declare function normalizeFontName(name: string): string;
+/** @see lib/common/textspan_lut.c:get_metrics_for_font_family */
+export declare function getFamilyMetrics(fontName: string): FontFamilyData;
+//# sourceMappingURL=textmeasure-lookup.d.ts.map

package/dist/common/textmeasure-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textmeasure-lookup.d.ts","sourceRoot":"","sources":["../../src/common/textmeasure-lookup.ts"],"names":[],"mappings":"AACA;;;GAGG;AAEH,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,2BAA2B,CAAC;AAEnC,4DAA4D;AAC5D,eAAO,MAAM,cAAc,EAAE,cAAqC,CAAC;AAEnE;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUtD;AAKD,iEAAiE;AACjE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAajE"}

package/dist/common/textmeasure-lut-data-a.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Raw width tables for Times, Arial/Helvetica, Courier, and Nunito.
+ * Ported from lib/common/textspan_lut.c (all_font_metrics[0..3]).
+ *
+ * Widths are in (unitsPerEm × 1) pt.  A value of -1 means unknown.
+ * @see lib/common/textspan_lut.c:all_font_metrics
+ */
+import type { FontFamilyData } from "./textmeasure-lut-data.js";
+export declare const TIMES_FAMILY: FontFamilyData;
+export declare const ARIAL_FAMILY: FontFamilyData;
+export declare const COURIER_FAMILY: FontFamilyData;
+export declare const NUNITO_FAMILY: FontFamilyData;
+//# sourceMappingURL=textmeasure-lut-data-a.d.ts.map

package/dist/common/textmeasure-lut-data-a.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textmeasure-lut-data-a.d.ts","sourceRoot":"","sources":["../../src/common/textmeasure-lut-data-a.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAiDhE,eAAO,MAAM,YAAY,EAAE,cAO1B,CAAC;AA4BF,eAAO,MAAM,YAAY,EAAE,cAQ1B,CAAC;AAkBF,eAAO,MAAM,cAAc,EAAE,cAO5B,CAAC;AAmDF,eAAO,MAAM,aAAa,EAAE,cAI3B,CAAC"}

package/dist/common/textmeasure-lut-data-b.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Raw width tables for DejaVu Sans, Consolas, and Trebuchet MS.
+ * Ported from lib/common/textspan_lut.c (all_font_metrics[4..6]).
+ *
+ * Widths are in (unitsPerEm × 1) pt.  A value of -1 means unknown.
+ * @see lib/common/textspan_lut.c:all_font_metrics
+ */
+import type { FontFamilyData } from "./textmeasure-lut-data.js";
+export declare const DEJAVU_FAMILY: FontFamilyData;
+export declare const CONSOLAS_FAMILY: FontFamilyData;
+export declare const TREBUCHET_FAMILY: FontFamilyData;
+//# sourceMappingURL=textmeasure-lut-data-b.d.ts.map

package/dist/common/textmeasure-lut-data-b.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textmeasure-lut-data-b.d.ts","sourceRoot":"","sources":["../../src/common/textmeasure-lut-data-b.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAwChE,eAAO,MAAM,aAAa,EAAE,cAI3B,CAAC;AA8BF,eAAO,MAAM,eAAe,EAAE,cAI7B,CAAC;AAgDF,eAAO,MAAM,gBAAgB,EAAE,cAI9B,CAAC"}

package/dist/common/textmeasure-lut-data-c.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Raw width tables for Verdana, Open Sans, Georgia, and Calibri.
+ * Ported from lib/common/textspan_lut.c (all_font_metrics[7..10]).
+ *
+ * Widths are in (unitsPerEm × 1) pt.  A value of -1 means unknown.
+ * @see lib/common/textspan_lut.c:all_font_metrics
+ */
+import type { FontFamilyData } from "./textmeasure-lut-data.js";
+export declare const VERDANA_FAMILY: FontFamilyData;
+export declare const OPENSANS_FAMILY: FontFamilyData;
+export declare const GEORGIA_FAMILY: FontFamilyData;
+export declare const CALIBRI_FAMILY: FontFamilyData;
+//# sourceMappingURL=textmeasure-lut-data-c.d.ts.map

package/dist/common/textmeasure-lut-data-c.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textmeasure-lut-data-c.d.ts","sourceRoot":"","sources":["../../src/common/textmeasure-lut-data-c.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAkDhE,eAAO,MAAM,cAAc,EAAE,cAI5B,CAAC;AAiDF,eAAO,MAAM,eAAe,EAAE,cAI7B,CAAC;AAgDF,eAAO,MAAM,cAAc,EAAE,cAI5B,CAAC;AAgDF,eAAO,MAAM,cAAc,EAAE,cAI5B,CAAC"}

package/dist/common/textmeasure-lut-data.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Aggregated font-family metrics LUT.
+ * Individual per-family data lives in textmeasure-lut-data-{a,b,c}.ts.
+ *
+ * @see lib/common/textspan_lut.c:all_font_metrics
+ */
+/** Per-family glyph width data, ported from FontFamilyMetrics in textspan_lut.c. */
+export interface FontFamilyData {
+    /** Normalized (letters-only, lowercase) font names for this family. */
+    readonly names: readonly string[];
+    /** TrueType units per em (denominator for width scaling). */
+    readonly unitsPerEm: number;
+    /** Per-character widths in (unitsPerEm × 1) pt; -1 = unknown. */
+    readonly regular: readonly number[];
+    readonly bold: readonly number[];
+    readonly italic: readonly number[];
+    readonly boldItalic: readonly number[];
+}
+export { TIMES_FAMILY, ARIAL_FAMILY, COURIER_FAMILY, NUNITO_FAMILY, } from "./textmeasure-lut-data-a.js";
+export { DEJAVU_FAMILY, CONSOLAS_FAMILY, TREBUCHET_FAMILY, } from "./textmeasure-lut-data-b.js";
+export { VERDANA_FAMILY, OPENSANS_FAMILY, GEORGIA_FAMILY, CALIBRI_FAMILY, } from "./textmeasure-lut-data-c.js";
+/**
+ * All font family metrics in the same order as the C source.
+ * @see lib/common/textspan_lut.c:all_font_metrics
+ */
+export declare const ALL_FONT_METRICS: readonly FontFamilyData[];
+//# sourceMappingURL=textmeasure-lut-data.d.ts.map

package/dist/common/textmeasure-lut-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"textmeasure-lut-data.d.ts","sourceRoot":"","sources":["../../src/common/textmeasure-lut-data.ts"],"names":[],"mappings":"AACA;;;;;GAKG;AAEH,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAED,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,aAAa,GACd,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,aAAa,EACb,eAAe,EACf,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,cAAc,EACd,eAAe,EACf,cAAc,EACd,cAAc,GACf,MAAM,6BAA6B,CAAC;AAsBrC;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAYrD,CAAC"}

package/dist/common/textmeasure.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Text measurement utilities: LUT-based and Canvas-based.
+ * Ported from lib/common/textspan_lut.c and lib/common/textspan.c.
+ *
+ * @see lib/common/textspan_lut.c
+ * @see lib/common/textspan.c:estimate_textspan_size
+ */
+/** Number of hard-coded font families in the LUT. */
+export declare const LUT_FAMILY_COUNT = 11;
+/** Estimated size of a text string in points. */
+export interface TextSize {
+    w: number;
+    h: number;
+    /**
+     * Baseline→centerline offset in points (C textspan_t.yoffset_centerline). The
+     * vertical metric is part of the measurement model: native graphviz's estimate
+     * uses 0.1·fontsize, while the font-plugin (pango) path is ≈0.05·fontsize. When
+     * omitted, callers default to the 0.05·fontsize (pango-calibrated) value.
+     * @see lib/common/textspan.c:estimate_textspan_size
+     */
+    yoffsetCenterline?: number;
+    /**
+     * Baseline→top (ascent) in points (C textspan_t.yoffset_layout). Native
+     * estimate uses `fontsize`; the freetype/pango path uses the font ascent
+     * (~0.89·fontsize). When omitted, callers fall back to the freetype ascent.
+     * @see lib/common/textspan.c:estimate_textspan_size
+     */
+    yoffsetLayout?: number;
+}
+/**
+ * Font variant flags (bold / italic) for text measurement.
+ * Mirrors textfont_t.flags in the C source.
+ * @see lib/common/textspan_lut.c:estimate_textspan_size (AD2)
+ */
+export interface TextVariantFlags {
+    readonly bold?: boolean;
+    readonly italic?: boolean;
+}
+/** Abstraction over text measurement strategies. */
+export interface TextMeasurer {
+    measure(text: string, fontname: string, fontsize: number, flags?: TextVariantFlags): TextSize;
+}
+/**
+ * Estimates the width of text at 1 pt for the given font/variant.
+ * Multiply by fontsize to get width at N pt.
+ * @see lib/common/textspan_lut.c:estimate_text_width_1pt
+ */
+export declare function estimate_text_width_1pt(fontName: string, text: string, bold: boolean, italic: boolean): number;
+/**
+ * FreeType line-spacing ratio measured from graphviz 15.0.0 reference SVGs.
+ * 14pt Times-Roman label height = 16.5pt → ratio = 16.5/14.
+ * C's LINESPACING=1.20 is a fallback estimate; actual FreeType gives ~1.17857.
+ * Kept for callers that want the 14pt-calibrated linear approximation;
+ * the measurer itself uses the exact hinted model (freetypeLineHeight).
+ * @see lib/common/textspan.c:estimate_textspan_size
+ */
+export declare const FREETYPE_LINE_SPACING: number;
+/**
+ * Per-character FreeType-hinted text width in points: each glyph advance is
+ * rounded to the 96 dpi pixel grid before summing.
+ * @see lib/common/textspan_lut.c:estimate_textspan_size
+ */
+export declare function freetypeHintedWidth(fontName: string, text: string, fontsize: number, bold?: boolean, italic?: boolean): number;
+/**
+ * Times-Roman ascender ratio (TrueType hhea ascender 1825/2048em).
+ * Hinted to the 96 dpi grid: 14pt → 17px → 12.75pt, matching the baseline
+ * positions in graphviz reference SVGs.
+ */
+export declare const FREETYPE_ASCENT_RATIO: number;
+/** Times-Roman descender ratio (hhea descender 443/2048em). */
+export declare const FREETYPE_DESCENT_RATIO: number;
+/**
+ * FreeType-hinted font ascent in points (baseline distance from line
+ * top). FreeType rounds the ascender UP to the pixel grid
+ * (FT_PIX_CEIL); at 14pt ceil and round coincide (16.63 → 17px).
+ * Font-aware: Helvetica's ascender differs from Times' (default when
+ * `fontname` is omitted or is not a known Helvetica-metric face).
+ */
+export declare function freetypeAscent(fontsize: number, fontname?: string): number;
+/**
+ * FreeType-hinted line height in points: ceil-hinted ascender plus
+ * ceil-hinted descender magnitude (FT_PIX_CEIL / FT_PIX_FLOOR on the
+ * negative descender). Verified against graphviz 15.0.0 two-line
+ * baseline deltas for fontsizes 6-48 (e.g. Times 14pt → 17+5 px = 16.5pt;
+ * Helvetica 36pt → 33+16 px = 36.75pt). Font-aware: defaults to Times when
+ * `fontname` is omitted or is not a known Helvetica-metric face.
+ */
+export declare function freetypeLineHeight(fontsize: number, fontname?: string): number;
+/**
+ * LUT-based TextMeasurer. Width from LUT quantised to FreeType's 96 dpi
+ * pixel grid; height matches FreeType Times-Roman.
+ * @see lib/common/textspan.c:estimate_textspan_size
+ */
+export declare class LutTextMeasurer implements TextMeasurer {
+    measure(text: string, fontname: string, fontsize: number, flags?: TextVariantFlags): TextSize;
+}
+/**
+ * Canvas-based TextMeasurer via CanvasRenderingContext2D.
+ * Height is fontsize (matches C behavior).
+ * @see lib/common/textspan.c:estimate_textspan_size
+ */
+export declare class CanvasTextMeasurer implements TextMeasurer {
+    private readonly ctx;
+    constructor(ctx: CanvasRenderingContext2D);
+    measure(text: string, fontname: string, fontsize: number, flags?: TextVariantFlags): TextSize;
+}
+/** graphviz estimate_textspan_size line spacing. @see lib/common/const.h:70 */
+export declare const LINESPACING = 1.2;
+/**
+ * Raw textspan_lut.c estimate: un-hinted per-char widths summed once, no kerning,
+ * height = fontsize * LINESPACING. Reproduces graphviz's HEADLESS measurement
+ * (no textlayout plugin → estimate_textspan_size) exactly, making it the
+ * deterministic, font-stack-independent reference for layout-rules validation.
+ * Unlike LutTextMeasurer this does NOT apply per-char FreeType px hinting.
+ * @see lib/common/textspan.c:estimate_textspan_size
+ */
+export declare class EstimateTextMeasurer implements TextMeasurer {
+    measure(text: string, fontname: string, fontsize: number, flags?: TextVariantFlags): TextSize;
+}
+//# sourceMappingURL=textmeasure.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"textmeasure.d.ts","sourceRoot":"","sources":["../../src/common/textmeasure.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAKH,qDAAqD;AACrD,eAAO,MAAM,gBAAgB,KAAK,CAAC;AAEnC,iDAAiD;AACjD,MAAM,WAAW,QAAQ;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,gBAAgB,GACvB,QAAQ,CAAC;CACb;AA8CD;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,OAAO,GACd,MAAM,CASR;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,QAAY,CAAC;AAW/C;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,IAAI,UAAQ,EACZ,MAAM,UAAQ,GACb,MAAM,CAWR;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAAc,CAAC;AAEjD,+DAA+D;AAC/D,eAAO,MAAM,sBAAsB,QAAa,CAAC;AAgDjD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAG1E;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9E;AAED;;;;GAIG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAClD,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,gBAAgB,GACvB,QAAQ;CAMZ;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,YAAY;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,wBAAwB;IAE1D,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,gBAAgB,GACvB,QAAQ;CAWZ;AAED,+EAA+E;AAC/E,eAAO,MAAM,WAAW,MAAO,CAAC;AAEhC;;;;;;;GAOG;AACH,qBAAa,oBAAqB,YAAW,YAAY;IACvD,OAAO,CACL,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,gBAAgB,GACvB,QAAQ;CAWZ"}