@knowvah/dot-engine 0.1.0

package/dist/common/htmltable-parse.d.ts

@@ -0,0 +1,37 @@
+/**
+ * HTML-like label parser.
+ * Ported from lib/common/htmllex.c + lib/common/htmlparse.y
+ *
+ * @see lib/common/htmllex.c:startElement
+ * @see lib/common/htmlparse.y
+ */
+import type { HtmlLabel, HtmlTable, HtmlText, Token } from './htmltable-types.js';
+interface FontState {
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    overline?: boolean;
+    strikethrough?: boolean;
+    subscript?: boolean;
+    superscript?: boolean;
+    fontColor?: string;
+    fontFace?: string;
+    fontSize?: number;
+}
+interface ParseState {
+    tokens: Token[];
+    pos: number;
+}
+/** @see lib/common/htmlparse.y:fonttext / text rules */
+export declare const parseText: (s: ParseState, fontStack: FontState[]) => HtmlText;
+/** @see lib/common/htmlparse.y:table rule / lib/common/htmllex.c:mkTbl */
+export declare const parseTable: (s: ParseState, fontStack: FontState[]) => HtmlTable;
+/**
+ * Parse an HTML-like label string.
+ * Input is the content between the outer `<` `>` delimiters (already stripped).
+ *
+ * @see lib/common/htmlparse.y:parseHTML
+ */
+export declare const parseHtmlLabel: (src: string) => HtmlLabel;
+export {};
+//# sourceMappingURL=htmltable-parse.d.ts.map

package/dist/common/htmltable-parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmltable-parse.d.ts","sourceRoot":"","sources":["../../src/common/htmltable-parse.ts"],"names":[],"mappings":"AACA;;;;;;GAMG;AAEH,OAAO,KAAK,EAMV,SAAS,EAET,SAAS,EACT,QAAQ,EAGR,KAAK,EAEN,MAAM,sBAAsB,CAAC;AAiD9B,UAAU,SAAS;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA+BD,UAAU,UAAU;IAClB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAkFD,wDAAwD;AACxD,eAAO,MAAM,SAAS,GAAI,GAAG,UAAU,EAAE,WAAW,SAAS,EAAE,KAAG,QAejE,CAAC;AAqNF,0EAA0E;AAC1E,eAAO,MAAM,UAAU,GAAI,GAAG,UAAU,EAAE,WAAW,SAAS,EAAE,KAAG,SAwBlE,CAAC;AAsDF;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,KAAK,MAAM,KAAG,SAyB5C,CAAC"}

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

@@ -0,0 +1,15 @@
+/**
+ * html_port resolution — walk a placed HTML table tree for a named port,
+ * returning the matching element's node-relative box + boundary sides.
+ * @see lib/common/htmltable.c:html_port / portToTbl / portToCell
+ */
+import type { Box } from '../model/geom.js';
+import type { PlacedHtml } from './htmltable-pos.js';
+/** A resolved HTML port: the element's node-relative box + its boundary sides. */
+export interface HtmlPortHit {
+    box: Box;
+    sides: number;
+}
+/** Find `id` on a placed table or any of its cells. @see portToTbl */
+export declare function portToTbl(tbl: PlacedHtml, id: string): HtmlPortHit | null;
+//# sourceMappingURL=htmltable-port.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"htmltable-port.d.ts","sourceRoot":"","sources":["../../src/common/htmltable-port.ts"],"names":[],"mappings":"AACA;;;;GAIG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,oBAAoB,CAAC;AAGjE,kFAAkF;AAClF,MAAM,WAAW,WAAW;IAAG,GAAG,EAAE,GAAG,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;CAAE;AAYzD,sEAAsE;AACtE,wBAAgB,SAAS,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAOzE"}

package/dist/common/htmltable-pos-runs.d.ts

@@ -0,0 +1,88 @@
+/**
+ * HTML label text-run layout: splits cell text into lines at <BR/>, tests
+ * the C "simple" fast path, and places each run's items at baselines,
+ * mirroring size_html_txt / emit_htextspans geometry.
+ *
+ * Extracted from htmltable-pos.ts to keep each module within the repo
+ * length budget; the placement geometry (cells, tables) stays there and
+ * imports these helpers. Logic is unchanged from the original — only two
+ * private helpers (measureItem, runSimpleKey) were factored out to keep
+ * buildLineRuns / runsAreSimple within the length/CCN budget.
+ *
+ * @see lib/common/htmltable.c:size_html_txt
+ * @see lib/common/htmltable.c:emit_htextspans
+ */
+import type { Box } from '../model/geom.js';
+import type { TextMeasurer } from './textmeasure.js';
+import type { HtmlAlign, HtmlText, HtmlTextItem } from './htmltable-types.js';
+/** One emitted run of text. Coordinates relative to the label center. */
+export interface PlacedLine {
+    text: string;
+    x: number;
+    baseline: number;
+    width: number;
+    fontSize: number;
+    fontName: string | null;
+    fontColor: string | null;
+    /**
+     * Renderer-applied above-baseline correction; C emit_htextspans uses
+     * the item value for simple blocks (cancelled by the lfsize math, so
+     * the port leaves it 0) and the constant 1 for non-simple blocks.
+     * @see lib/common/htmltable.c:emit_htextspans (lines 177-180)
+     */
+    yoffsetCenterline?: number;
+    /** Resolved HTML font flags (HTML_BF | HTML_IF | HTML_UL | …). @see lib/common/textspan.h */
+    fontFlags: number;
+}
+/** Font info inherited from the enclosing label. */
+export interface HtmlFontInfo {
+    fontname: string;
+    fontsize: number;
+    fontcolor: string;
+}
+interface LineRun {
+    items: HtmlTextItem[];
+    width: number;
+    /** Max raw font size over items (C mxfsize). */
+    fontSize: number;
+    /** Max metric line height over items (C mxysize). */
+    height: number;
+    /** Max yoffset_centerline over items (C maxoffset = 0.05 × fs). */
+    maxOffset: number;
+    /** Max yoffset_layout (ascent) over items; 0 → fall back to freetype ascent. */
+    maxLayout: number;
+    /**
+     * Justification from the <BR ALIGN=…/> that TERMINATES this line; undefined
+     * = C's UNSET_ALIGN (center). @see htmlparse.y:appendFLineList (span.just)
+     */
+    just?: HtmlAlign;
+}
+/**
+ * Compute the HTML font flags bitmask from an HtmlTextItem.
+ * Mirrors the per-span flag accumulation in htmltable.c:emit_htextspans.
+ * @see lib/common/textspan.h:HTML_BF, HTML_IF, HTML_UL, HTML_SUP, HTML_SUB, HTML_S, HTML_OL
+ */
+export declare function itemFontFlags(item: HtmlTextItem): number;
+/**
+ * Split text content into lines at <BR/> items, mirroring C's parser exactly
+ * (htmlparse.y appendFLineList/mkText):
+ * - a BR CLOSES the current line and carries its ALIGN as the line's just;
+ * - a BR with no accumulated items yields a line with one empty-string item
+ *   in the current font (consecutive BRs = a real blank line with height);
+ * - at end of text a line is added ONLY if items remain — a trailing BR does
+ *   NOT create a phantom empty line (this over-sized e.g. html2's node c).
+ * @see lib/common/htmlparse.y:appendFLineList / mkText
+ */
+export declare function buildLineRuns(texts: HtmlText[], finfo: HtmlFontInfo, measurer: TextMeasurer): LineRun[];
+/**
+ * C's "simple" test over built runs: one item per line, no font flags,
+ * uniform resolved face/size across lines.
+ * @see lib/common/htmltable.c:size_html_txt (lines 946-986)
+ */
+export declare function runsAreSimple(runs: LineRun[], finfo: HtmlFontInfo): boolean;
+/** Place one run's items left-to-right at a fixed baseline. */
+export declare function placeRunItems(run: LineRun, startX: number, baseline: number, finfo: HtmlFontInfo, measurer: TextMeasurer): PlacedLine[];
+/** Place text runs centered in `box`. @see emit_htextspans */
+export declare function placeTextRuns(runs: LineRun[], box: Box, finfo: HtmlFontInfo, measurer: TextMeasurer): PlacedLine[];
+export {};
+//# sourceMappingURL=htmltable-pos-runs.d.ts.map

package/dist/common/htmltable-pos-runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmltable-pos-runs.d.ts","sourceRoot":"","sources":["../../src/common/htmltable-pos-runs.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAI9E,yEAAyE;AACzE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,MAAM,CAAC;IACV,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,6FAA6F;IAC7F,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,UAAU,OAAO;IACf,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,SAAS,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAUxD;AAqDD;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,QAAQ,EAAE,EACjB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,YAAY,GACrB,OAAO,EAAE,CAwBX;AAkBD;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAa3E;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAC3B,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,YAAY,GACrB,UAAU,EAAE,CAgBd;AAED,8DAA8D;AAC9D,wBAAgB,aAAa,CAC3B,IAAI,EAAE,OAAO,EAAE,EACf,GAAG,EAAE,GAAG,EACR,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,YAAY,GACrB,UAAU,EAAE,CAKd"}

package/dist/common/htmltable-pos.d.ts

@@ -0,0 +1,192 @@
+/**
+ * HTML label positioning: converts a sized HtmlLabel into a placed
+ * structure with cell boxes and text baselines relative to the label
+ * center, mirroring pos_html_tbl / pos_html_cell / emit_htextspans
+ * geometry.
+ *
+ * Decoration metadata (bgcolor, color, sides, href, title, target, id,
+ * style, vruled, hruled, col, row, colspan, rowspan) is carried directly
+ * on PlacedCell/PlacedHtml — matching C's htmlcell_t/htmltbl_t layout.
+ *
+ * @see lib/common/htmltable.c:pos_html_tbl
+ * @see lib/common/htmltable.c:pos_html_cell
+ * @see lib/common/htmltable.c:emit_htextspans
+ */
+import type { Box } from '../model/geom.js';
+import type { TextlabelT } from './types.js';
+import type { TextMeasurer } from './textmeasure.js';
+import type { HtmlCell, HtmlLabel, HtmlTable, ImageSizer } from './htmltable-types.js';
+import type { PlacedLine, HtmlFontInfo } from './htmltable-pos-runs.js';
+import { itemFontFlags, buildLineRuns, runsAreSimple, placeRunItems, placeTextRuns } from './htmltable-pos-runs.js';
+export type { PlacedLine, HtmlFontInfo };
+export { itemFontFlags, buildLineRuns, runsAreSimple, placeRunItems, placeTextRuns };
+/**
+ * A placed IMG element inside a cell.
+ * Carries the sized box (relative to label center) and scale attribute.
+ *
+ * Geometry: emit_html_img centers the image in the cell box, applying scale.
+ * @see lib/common/htmltable.c:emit_html_img (line 597)
+ */
+export interface PlacedImage {
+    src: string;
+    /** Scale attribute from <IMG SCALE="..."/>. */
+    scale?: string;
+    /** Intrinsic image width (from the ImageSizer), pre-scale. */
+    iw: number;
+    /** Intrinsic image height (from the ImageSizer), pre-scale. */
+    ih: number;
+    /** Target box for the image (alignment-adjusted cell content area). */
+    box: Box;
+}
+/**
+ * A positioned cell: border box plus its text runs and optional image.
+ * Carries decoration metadata from htmlcell_t so the emitter can apply
+ * bgcolor fill, per-side borders, anchors, and rules without a separate
+ * decorated type.
+ *
+ * @see lib/common/htmltable.h:htmlcell_t
+ */
+export interface PlacedCell {
+    box: Box;
+    border: number;
+    lines: PlacedLine[];
+    /** Placed image, present when the cell contains an <IMG> element. */
+    image?: PlacedImage;
+    /**
+     * Placed nested table, present when the cell's child is a <TABLE>.
+     * @see lib/common/htmltable.h:htmlcell_t.child (HTML_TBL)
+     */
+    nested?: PlacedHtml;
+    /** PORT name on this cell, for html_port edge resolution. */
+    port?: string;
+    /** Boundary mask (C `sides & mask`): which node sides this cell touches. */
+    sidesMask?: number;
+    /** BGCOLOR attribute (solid color or "color1:color2" gradient spec). */
+    bgcolor?: string;
+    /** Pen (border) color override. */
+    color?: string;
+    /** SIDES bitmask (BORDER_LEFT|TOP|RIGHT|BOTTOM). */
+    sides?: number;
+    /** HREF for this cell's anchor. */
+    href?: string;
+    /** TOOLTIP for this cell's anchor. */
+    title?: string;
+    /** TARGET for this cell's anchor. */
+    target?: string;
+    /** ID attribute. */
+    id?: string;
+    /** Style string (dashed, dotted, rounded, …). */
+    style?: string;
+    /** Gradient angle (deg) for a gradient bgcolor. @see htmltable.h:htmlcell_t */
+    gradientangle?: number;
+    /** Column index (0-based). @see lib/common/htmltable.h:htmlcell_t.col */
+    col: number;
+    /** Row index (0-based). @see lib/common/htmltable.h:htmlcell_t.row */
+    row: number;
+    /** Column span (≥1). */
+    colspan: number;
+    /** Row span (≥1). */
+    rowspan: number;
+    /**
+     * True when this cell has a vertical rule to its right.
+     * Set by table vrule (COLUMNS="*") or explicit <VR/> in the row.
+     * @see lib/common/htmltable.h:htmlcell_t.vruled
+     */
+    vruled?: boolean;
+    /**
+     * True when this cell has a horizontal rule below it.
+     * Set by table hrule (ROWS="*") propagated via row_t.ruled.
+     * @see lib/common/htmltable.h:htmlcell_t.hruled
+     */
+    hruled?: boolean;
+}
+/**
+ * A fully positioned HTML label (table).
+ * Carries table-level decoration metadata from htmltbl_t.
+ *
+ * @see lib/common/htmltable.h:htmltbl_t
+ */
+export interface PlacedHtml {
+    box: Box;
+    border: number;
+    cells: PlacedCell[];
+    /** PORT name on this table, for html_port edge resolution. */
+    port?: string;
+    /** Boundary mask placed with (ALL top-level; parent cell mask if nested). */
+    boundarySides?: number;
+    /** BGCOLOR attribute for the table background. */
+    bgcolor?: string;
+    /** Pen color for the table border. */
+    color?: string;
+    /** SIDES bitmask. */
+    sides?: number;
+    /** Table HREF anchor. */
+    href?: string;
+    /** Table TOOLTIP. */
+    title?: string;
+    /** Table TARGET. */
+    target?: string;
+    /** Table ID. */
+    id?: string;
+    /** Table style string. */
+    style?: string;
+    /** Gradient angle (deg) for a gradient bgcolor. @see htmltable.h:htmltbl_t */
+    gradientangle?: number;
+    /**
+     * Total number of columns (used for vruled boundary check).
+     * @see lib/common/htmltable.h:htmltbl_t.column_count
+     */
+    columnCount: number;
+    /**
+     * Total number of rows (used for hruled boundary check).
+     * @see lib/common/htmltable.h:htmltbl_t.row_count
+     */
+    rowCount: number;
+    /**
+     * Cell spacing (cellspacing attribute or default).
+     * @see lib/common/htmltable.h:htmldata_t.space
+     */
+    spacing: number;
+}
+/**
+ * Shrink `box` to (w,h) per the cell's HALIGN/VALIGN, mirroring C's text branch
+ * of pos_html_cell: LEFT flushes the box right edge in (`ur.x -= delx`), RIGHT
+ * flushes the left edge in, default splits (center); VALIGN BOTTOM/TOP flush,
+ * default centers on BOTH axes. Parallels the existing `alignImageBox`, but
+ * text default-centers vertically where an image does not.
+ * (`parseAlign` never yields HALIGN_TEXT, so the cell box always shrinks here —
+ * exactly what C does for every non-TEXT cell.)
+ * @see lib/common/htmltable.c:pos_html_cell (text branch, :1487-1526)
+ */
+export declare function alignContentBox(box: Box, cell: HtmlCell, w: number, h: number): Box;
+/** All four boundary sides — the top-level table's placement mask. */
+export declare const HTML_ALL_SIDES: number;
+/** Cell placement context: geometry + grid position, used by placeCell. */
+export interface CellPlaceCtx {
+    cell: HtmlCell;
+    tbl: HtmlTable;
+    box: Box;
+    finfo: HtmlFontInfo;
+    measurer: TextMeasurer;
+    col: number;
+    row: number;
+    colspan: number;
+    rowspan: number;
+    /** Boundary mask for this cell (C `sides & mask`). */
+    sidesMask: number;
+}
+/** Position one cell's text inside its box, copying decoration metadata. @see pos_html_cell */
+export declare function placeCell(ctx: CellPlaceCtx): PlacedCell;
+/**
+ * Position the table and all cells within `pos`. The top-level caller omits
+ * `pos` (the table is centered on its own dimen); a nested table is positioned
+ * into its parent cell's inset content box. @see pos_html_tbl
+ */
+export declare function posHtmlTable(tbl: HtmlTable, finfo: HtmlFontInfo, measurer: TextMeasurer, pos?: Box, sides?: number): PlacedHtml;
+/** Position a sized HtmlLabel relative to its center. */
+export declare function posHtmlLabel(label: HtmlLabel, finfo: HtmlFontInfo, measurer: TextMeasurer): PlacedHtml;
+export declare function makeHtmlLabel(content: string, finfo: HtmlFontInfo & {
+    imageSizer?: ImageSizer;
+    pencolor?: string;
+}, measurer: TextMeasurer): TextlabelT;
+//# sourceMappingURL=htmltable-pos.d.ts.map

package/dist/common/htmltable-pos.d.ts.map

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

package/dist/common/htmltable-types.d.ts

@@ -0,0 +1,237 @@
+/**
+ * AST types for the HTML-like label parser.
+ *
+ * @see lib/common/htmltable.h
+ */
+import type { GvError } from '../errors.js';
+/**
+ * Thrown when an unrecognized HTML tag is encountered during parsing.
+ *
+ * Implements the structured {@link GvError} contract additively: the `(tag)`
+ * constructor and the existing message are unchanged. HTML labels carry no
+ * parser position here, so `location`/`expected` are omitted.
+ *
+ * @see lib/common/htmllex.c:lexerror
+ */
+export declare class HtmlParseError extends Error implements GvError {
+    readonly type = "semantic";
+    readonly code = "HTML_PARSE_ERROR";
+    readonly friendlyMessage: string;
+    readonly tag: string;
+    constructor(tag: string);
+}
+/** @see lib/common/htmltable.h HALIGN_* flags */
+export type HtmlAlign = 'left' | 'center' | 'right';
+/** @see lib/common/htmltable.h VALIGN_* flags */
+export type HtmlVAlign = 'top' | 'middle' | 'bottom';
+/** @see lib/common/htmltable.h:htmltbl_t (HR separator) */
+export interface HtmlHR {
+    kind: 'hr';
+}
+/**
+ * Border-side bitmask constants matching C htmltable.h BORDER_* defines.
+ * @see lib/common/htmltable.h:BORDER_LEFT etc.
+ */
+export declare const BORDER_LEFT: number;
+export declare const BORDER_TOP: number;
+export declare const BORDER_RIGHT: number;
+export declare const BORDER_BOTTOM: number;
+export declare const BORDER_MASK: number;
+/** @see lib/common/htmltable.h:htmlimg_t */
+export interface HtmlImage {
+    kind: 'image';
+    src: string;
+    scale?: string;
+    /** AD3: computed image width in points (from htmlimg_t.box.UR.x). */
+    width?: number;
+    /** AD3: computed image height in points (from htmlimg_t.box.UR.y). */
+    height?: number;
+}
+/**
+ * Callback for resolving image dimensions in HTML labels.
+ *
+ * Returns the intrinsic {w, h} in points for `src`, or null when the image
+ * cannot be resolved.  Absent or null → zero-size cell + warning, matching
+ * C's missing-image behavior (htmltable.c:size_html_img, gvusershape.c).
+ *
+ * AD3 (locked): absent ImageSizer must be indistinguishable from
+ * C-with-missing-file.
+ *
+ * @see lib/common/htmltable.c:size_html_img (line 1080)
+ * @see lib/gvc/gvusershape.c:gvusershape_size
+ */
+export type ImageSizer = (src: string) => {
+    w: number;
+    h: number;
+} | null;
+/**
+ * A single run of styled text within a line.
+ * @see lib/common/htmltable.h:textspan_t / htextspan_t
+ */
+export interface HtmlTextItem {
+    text?: string;
+    br?: true;
+    brAlign?: HtmlAlign;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    overline?: boolean;
+    strikethrough?: boolean;
+    subscript?: boolean;
+    superscript?: boolean;
+    fontColor?: string;
+    fontFace?: string;
+    fontSize?: number;
+}
+/** @see lib/common/htmltable.h:htmltxt_t */
+export interface HtmlText {
+    kind: 'text';
+    items: HtmlTextItem[];
+}
+/** Content that can appear inside a table cell */
+export type HtmlCellContent = HtmlText | HtmlTable | HtmlImage | HtmlHR;
+/** @see lib/common/htmltable.h:htmlcell_t */
+export interface HtmlCell {
+    kind: 'cell';
+    content: HtmlCellContent[];
+    /**
+     * Vertical rule right of this cell: set by <VR> between cells
+     * (htmlparse.y:329) or table COLUMNS="*" (htmlparse.y setCell).
+     * @see lib/common/htmltable.h:htmlcell_t.vruled
+     */
+    vruled?: boolean;
+    port?: string;
+    align?: HtmlAlign;
+    valign?: HtmlVAlign;
+    balign?: HtmlAlign;
+    bgcolor?: string;
+    color?: string;
+    border?: number;
+    cellpadding?: number;
+    cellspacing?: number;
+    /**
+     * Bitmask of exposed border sides (BORDER_LEFT|TOP|RIGHT|BOTTOM).
+     * @see lib/common/htmltable.h:htmldata_t.sides
+     * @see lib/common/htmllex.c:sidesfn
+     */
+    sides?: number;
+    /**
+     * Gradient angle in degrees [0, 360].
+     * @see lib/common/htmltable.h:htmldata_t.gradientangle
+     * @see lib/common/htmllex.c:gradientanglefn
+     */
+    gradientangle?: number;
+    style?: string;
+    width?: number;
+    height?: number;
+    fixedsize?: boolean;
+    colspan?: number;
+    rowspan?: number;
+    href?: string;
+    title?: string;
+    target?: string;
+    id?: string;
+    dimen?: {
+        w: number;
+        h: number;
+    };
+}
+/** @see lib/common/htmltable.h:row_t */
+export interface HtmlRow {
+    cells: HtmlCell[];
+    /**
+     * Horizontal rule below this row: set by <HR> between rows
+     * (htmlparse.y:321) or table ROWS="*" (htmlparse.y addRow).
+     * @see lib/common/htmltable.h:row_t.ruled
+     */
+    ruled?: boolean;
+}
+/** @see lib/common/htmltable.h:htmltbl_t */
+export interface HtmlTable {
+    kind: 'table';
+    rows: HtmlRow[];
+    border?: number;
+    cellborder?: number;
+    cellspacing?: number;
+    cellpadding?: number;
+    bgcolor?: string;
+    color?: string;
+    style?: string;
+    align?: HtmlAlign;
+    valign?: HtmlVAlign;
+    fixedsize?: boolean;
+    width?: number;
+    height?: number;
+    href?: string;
+    title?: string;
+    target?: string;
+    id?: string;
+    /**
+     * Port name for this table (AD6: store only, attachment deferred).
+     * @see lib/common/htmltable.h:htmldata_t.port
+     */
+    port?: string;
+    /**
+     * Bitmask of exposed border sides (BORDER_LEFT|TOP|RIGHT|BOTTOM).
+     * @see lib/common/htmltable.h:htmldata_t.sides
+     * @see lib/common/htmllex.c:sidesfn
+     */
+    sides?: number;
+    /**
+     * Gradient angle in degrees [0, 360].
+     * @see lib/common/htmltable.h:htmldata_t.gradientangle
+     * @see lib/common/htmllex.c:gradientanglefn
+     */
+    gradientangle?: number;
+    /**
+     * Draw vertical rules between all columns (COLUMNS="*").
+     * @see lib/common/htmltable.h:htmltbl_t.vrule
+     * @see lib/common/htmllex.c:columnsfn
+     */
+    vrule?: boolean;
+    /**
+     * Draw horizontal rules between all rows (ROWS="*").
+     * @see lib/common/htmltable.h:htmltbl_t.hrule
+     * @see lib/common/htmllex.c:rowsfn
+     */
+    hrule?: boolean;
+    dimen?: {
+        w: number;
+        h: number;
+    };
+}
+/** @see lib/common/htmltable.h:htmllabel_t */
+export type HtmlLabel = {
+    kind: 'table';
+    table: HtmlTable;
+    dimen?: {
+        w: number;
+        h: number;
+    };
+} | {
+    kind: 'text';
+    texts: HtmlText[];
+    dimen?: {
+        w: number;
+        h: number;
+    };
+};
+/** @see lib/common/htmllex.c:startElement */
+export interface OpenToken {
+    type: 'open';
+    tag: string;
+    attrs: Record<string, string>;
+}
+/** @see lib/common/htmllex.c:endElement */
+export interface CloseToken {
+    type: 'close';
+    tag: string;
+}
+/** @see lib/common/htmllex.c:characterData */
+export interface TextToken {
+    type: 'text';
+    value: string;
+}
+/** Discriminated union of all lexer token kinds. */
+export type Token = OpenToken | CloseToken | TextToken;
+//# sourceMappingURL=htmltable-types.d.ts.map

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

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

package/dist/common/htmltable.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Public API: HTML-like label parsing and layout sizing.
+ * Sizing algorithm ported from lib/common/htmltable.c.
+ *
+ * @see lib/common/htmltable.c:size_html_tbl
+ * @see lib/common/htmltable.c:set_cell_widths
+ * @see lib/common/htmltable.c:set_cell_heights
+ */
+export { HtmlParseError } from './htmltable-types.js';
+export type { HtmlAlign, HtmlVAlign, HtmlHR, HtmlImage, HtmlTextItem, HtmlText, HtmlCellContent, HtmlCell, HtmlRow, HtmlTable, HtmlLabel, ImageSizer, } from './htmltable-types.js';
+export { parseHtmlLabel } from './htmltable-parse.js';
+export type { TextMeasurer } from './textmeasure.js';
+import type { HtmlCell, HtmlLabel, HtmlTable, HtmlText } from './htmltable-types.js';
+import type { ImageSizer } from './htmltable-types.js';
+import type { TextMeasurer } from './textmeasure.js';
+/**
+ * Sizing environment: label-level font defaults + image resolution.
+ * Ports htmlenv_t.finfo — C threads lp->fontname/fontsize through
+ * make_html_label's env into size_html_txt.
+ * @see lib/common/htmltable.c:make_html_label (env.finfo)
+ */
+export interface HtmlSizeEnv {
+    fontsize: number;
+    fontname: string;
+    imageSizer?: ImageSizer;
+}
+/**
+ * C's "simple" test: one item per line, no font flags, uniform
+ * resolved face and size across all lines.
+ * @see lib/common/htmltable.c:size_html_txt (lines 946-986)
+ */
+export declare const htmlTextIsSimple: (texts: HtmlText[], env: HtmlSizeEnv) => boolean;
+export declare const cellPad: (cell: HtmlCell, tbl: HtmlTable) => number;
+/**
+ * A cell with no BORDER of its own defaults, in order: the table's CELLBORDER
+ * (if >= 0), else the table's own BORDER value (when BORDER was set — including
+ * BORDER="0"), else DEFAULT_BORDER. The middle case is why a cell in a
+ * `<TABLE BORDER="0">` with no CELLBORDER draws no border, not a 1px one.
+ * @see lib/common/htmltable.c:1115 size_html_tbl (cp->data.border default)
+ */
+export declare const cellBorder: (cell: HtmlCell, tbl: HtmlTable) => number;
+/** Full table layout: per-cell sizes plus column/row dimensions. */
+export interface HtmlTableLayout {
+    entries: {
+        cell: HtmlCell;
+        row: number;
+        col: number;
+        colspan: number;
+        rowspan: number;
+        w: number;
+        h: number;
+    }[];
+    widths: number[];
+    heights: number[];
+    spacing: number;
+    border: number;
+}
+/**
+ * Lay out a table: per-cell sizes and column/row dimension arrays.
+ * Shared by the size pass and the position pass.
+ * @see lib/common/htmltable.c:size_html_tbl
+ */
+export declare const layoutHtmlTable: (tbl: HtmlTable, measurer: TextMeasurer, env?: HtmlSizeEnv) => HtmlTableLayout;
+/**
+ * Compute and write `dimen` onto all cells and the label.
+ *
+ * The optional `imageSizer` resolves `<IMG SRC="..."/>` dimensions.
+ * When absent or when the sizer returns null, images get zero size and a
+ * warning is emitted, matching C's missing-image behavior exactly.
+ *
+ * @see lib/common/htmltable.c:make_html_label
+ */
+export declare const sizeHtmlLabel: (label: HtmlLabel, measurer: TextMeasurer, env?: HtmlSizeEnv) => void;
+//# sourceMappingURL=htmltable.d.ts.map