@graphty/graph-io 0.3.48 → 0.3.49

package/dist/src/formats/dot/label-places.js

@@ -0,0 +1,179 @@
+/**
+ * Where Graphviz puts an edge's labels: a stored `lp` (the label's center), and the head and tail labels at
+ * `head_lp` / `tail_lp` -- kept only with the edge's stored `pos` (`neato -n2` routes an edge without one again, and
+ * places its labels again) -- or where Graphviz's `place_portlabel` (lib/common/splines.c) puts them, when the edge's
+ * `labelangle` or `labeldistance` is not its default: `10 * labeldistance` points from the end of the line, turned
+ * `labelangle` degrees (default -25) from the line. With both at their defaults Graphviz places end labels as external
+ * labels, which graphty leaves to its own place beside the end. Read as offsets from where graphty puts each label:
+ * the edge label from the middle of its route, an end label from where the line meets its node.
+ */
+import { flattenCubic } from "../../styles/canon/bends.js";
+import { num6 } from "../../styles/canon/number.js";
+/** Graphviz's `PORT_LABEL_DISTANCE`, in points. */
+const PORT_LABEL_DISTANCE = 10;
+/** Graphviz's `PORT_LABEL_ANGLE`, in degrees. */
+const PORT_LABEL_ANGLE = -25;
+/** Graphviz's default node size, in inches. */
+const DEFAULT_SIZE = { w: 0.75, h: 0.5 };
+/**
+ * Reads an edge's stored label places and its head and tail label places as offsets.
+ * @param snapshot - the graph
+ * @param cx - the graph's label place context
+ * @param e - the edge
+ * @param get - the edge's attributes
+ * @param put - receives the values
+ */
+export function readLabelPlaces(snapshot, cx, e, get, put) {
+    const s = snapshot.edgeSource(e);
+    const t = snapshot.edgeTarget(e);
+    const [source, target] = [cx.center(s), cx.center(t)];
+    if (source === null || target === null || s === t) {
+        return;
+    }
+    const route = edgeRoute(source, target, get("pos"));
+    const lp = route.start === null ? null : point(get("lp"));
+    if (lp !== null && get("label") !== null) {
+        const mid = routeMiddle(route.points);
+        put("labelOffsetX", num6(lp[0] - mid[0]));
+        put("labelOffsetY", num6(mid[1] - lp[1]));
+    }
+    readEndLabel(cx, route, { node: t, at: target, other: source }, "head", get, put);
+    readEndLabel(cx, route, { node: s, at: source, other: target }, "tail", get, put);
+}
+/**
+ * Reads one end's label place as an offset from where its line meets its node.
+ * @param cx - the graph's label place context
+ * @param route - the edge's route
+ * @param end - the end's node and the two centers
+ * @param which - which end
+ * @param get - the edge's attributes
+ * @param put - receives the values
+ */
+function readEndLabel(cx, route, end, which, get, put) {
+    if (get(`${which}label`) === null) {
+        return;
+    }
+    const head = which === "head";
+    const tip = (head ? route.end : route.start) ?? boundary(cx, end.node, end.at, end.other);
+    // the nearest route point back from the end that is not the end itself (a spline with no arrow ends at it);
+    // the route's last point is the node's center, past the end
+    const back = head ? route.points.slice(0, -1).reverse() : route.points.slice(1);
+    const toward = back.find((p) => Math.hypot(p[0] - tip[0], p[1] - tip[1]) > 1e-6) ?? end.other;
+    const stored = route.start === null ? null : point(get(`${which}_lp`));
+    const at = stored ?? portLabel(get, tip, toward);
+    if (at !== null) {
+        const prefix = head ? "target" : "source";
+        put(`${prefix}LabelOffset`, 0);
+        put(`${prefix}LabelOffsetX`, num6(at[0] - tip[0]));
+        put(`${prefix}LabelOffsetY`, num6(tip[1] - at[1]));
+    }
+}
+/**
+ * Where Graphviz's `place_portlabel` puts an end label's center: only when the edge's `labelangle` or
+ * `labeldistance` is not its default.
+ * @param get - the edge's attributes
+ * @param tip - the end of the line
+ * @param toward - a point back along the line from the end
+ * @returns the center, or null when Graphviz places the label as an external label
+ */
+function portLabel(get, tip, toward) {
+    const turn = finite(get("labelangle"), PORT_LABEL_ANGLE, -180);
+    const distance = finite(get("labeldistance"), 1, 0);
+    if (turn === PORT_LABEL_ANGLE && distance === 1) {
+        return null;
+    }
+    const angle = Math.atan2(toward[1] - tip[1], toward[0] - tip[0]) + (turn * Math.PI) / 180;
+    const dist = PORT_LABEL_DISTANCE * distance;
+    return [tip[0] + dist * Math.cos(angle), tip[1] + dist * Math.sin(angle)];
+}
+/**
+ * A number attribute as Graphviz's `late_double` reads it: the default when unset or not a number, at least `low`.
+ * @param raw - the value
+ * @param fallback - the default
+ * @param low - the least value
+ * @returns the number
+ */
+function finite(raw, fallback, low) {
+    const v = raw === null || raw.trim() === "" ? Number.NaN : Number(raw);
+    return Number.isFinite(v) ? Math.max(low, v) : fallback;
+}
+/**
+ * An "x,y" point (a trailing `!` allowed).
+ * @param raw - the text
+ * @returns the point, or null
+ */
+function point(raw) {
+    const parts = (raw ?? "").replace(/!$/, "").split(",").map(Number);
+    return parts.length >= 2 && Number.isFinite(parts[0]) && Number.isFinite(parts[1]) ? [parts[0], parts[1]] : null;
+}
+/**
+ * The route an edge is drawn along: its stored spline's points (flattened) between the two centers, and the ends of
+ * its line where `pos` gives arrow points (`s,` / `e,`) or its spline's own ends.
+ * @param source - the source's center
+ * @param target - the target's center
+ * @param pos - the edge's `pos`
+ * @returns the route
+ */
+function edgeRoute(source, target, pos) {
+    const tokens = (pos ?? "").split(";")[0].trim().split(/\s+/).filter(Boolean);
+    const marked = (flag) => {
+        const token = tokens.find((x) => x.startsWith(`${flag},`));
+        return token === undefined ? null : point(token.slice(2));
+    };
+    const controls = tokens.filter((x) => !/^[es],/.test(x)).map((x) => point(x));
+    const flat = controls.every((p) => p !== null) && controls.length >= 4 ? flattenCubic(controls) : null;
+    if (flat === null) {
+        return { points: [source, target], start: null, end: null };
+    }
+    return {
+        points: [source, ...flat, target],
+        start: marked("s") ?? flat[0],
+        end: marked("e") ?? flat.at(-1) ?? null,
+    };
+}
+/**
+ * The point halfway along a route.
+ * @param points - the route
+ * @returns the point
+ */
+function routeMiddle(points) {
+    // ponytail: halfway by length; graphty puts a bent edge's label at its middle segment, close to it
+    const lengths = points.slice(1).map((p, i) => Math.hypot(p[0] - points[i][0], p[1] - points[i][1]));
+    let left = lengths.reduce((a, b) => a + b, 0) / 2;
+    for (let i = 0; i < lengths.length; i++) {
+        if (left <= lengths[i] && lengths[i] > 0) {
+            const f = left / lengths[i];
+            return [
+                points[i][0] + f * (points[i + 1][0] - points[i][0]),
+                points[i][1] + f * (points[i + 1][1] - points[i][1]),
+            ];
+        }
+        left -= lengths[i];
+    }
+    return points[0];
+}
+/**
+ * Where the straight line from a node's center toward a point leaves the node, the node taken as the ellipse of its
+ * `width` and `height`.
+ * @param cx - the label place context
+ * @param n - the node
+ * @param center - its center
+ * @param toward - the point
+ * @returns the point on its outline
+ */
+function boundary(cx, n, center, toward) {
+    // ponytail: every shape taken as its ellipse; exact for the circles and ellipses the end labels sit on
+    const inch = (name, fallback) => {
+        const v = Number(cx.node(n, name) ?? Number.NaN);
+        return (Number.isFinite(v) && v >= 0 ? v : fallback) * 72;
+    };
+    const [rx, ry] = [inch("width", DEFAULT_SIZE.w) / 2, inch("height", DEFAULT_SIZE.h) / 2];
+    const [dx, dy] = [toward[0] - center[0], toward[1] - center[1]];
+    const len = Math.hypot(dx, dy);
+    if (len === 0 || rx === 0 || ry === 0) {
+        return center;
+    }
+    const r = 1 / Math.hypot(dx / len / rx, dy / len / ry);
+    return [center[0] + (dx / len) * r, center[1] + (dy / len) * r];
+}
+//# sourceMappingURL=label-places.js.map

package/dist/src/formats/dot/label-places.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-places.js","sourceRoot":"","sources":["../../../../src/formats/dot/label-places.ts"],"names":[],"mappings":"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"}

package/dist/src/formats/dot/record.d.ts

@@ -0,0 +1,50 @@
+/**
+ * @file Graphviz record shapes (`record`, `Mrecord`): the field tree a record label describes and where Graphviz lays
+ * each field, its dividers and its text lines out inside the node (lib/common/shapes.c `parse_reclbl`,
+ * `size_reclbl`, `resize_reclbl`, `pos_reclbl`, `gen_fields`). Text widths are estimated from DejaVu Sans's advance
+ * widths, which the specimen sheets pin; another font is measured as if it were DejaVu Sans.
+ */
+/** Where a record's dividers and text lines go, in points from the node's center, y up. */
+interface RecordLayout {
+    /** The node's width and height in points. */
+    readonly width: number;
+    readonly height: number;
+    /** Each divider, from one point to the other. */
+    readonly dividers: readonly (readonly [number, number, number, number])[];
+    /** Each text line, centered on its point. */
+    readonly texts: readonly {
+        readonly x: number;
+        readonly y: number;
+        readonly text: string;
+    }[];
+    /** Each named field's box center and half size, by port name. */
+    readonly ports: ReadonlyMap<string, {
+        readonly x: number;
+        readonly y: number;
+        readonly hw: number;
+        readonly hh: number;
+    }>;
+}
+/**
+ * A text's width in points at a font size, from DejaVu Sans's advances (any other character: 0.6 em).
+ * @param text - the text
+ * @param size - the font size
+ * @returns the width
+ */
+export declare function textWidth(text: string, size: number): number;
+/**
+ * Lays a record out in a node as Graphviz does: the fields at their natural sizes, the node at least that big unless
+ * it is `fixedsize`, every field then grown to share the node, its dividers between neighbors and its lines centered,
+ * or set in from its side by 8 points when justified left or right.
+ * @param label - the record label, before its escapes are applied
+ * @param lr - whether the top level lays its fields left to right (true unless `rankdir` is LR or RL)
+ * @param width - the node's width in points
+ * @param height - its height in points
+ * @param fixed - whether the node keeps its size (`fixedsize`)
+ * @param fontSize - the font size in points
+ * @param text - applies the label escapes to one line
+ * @returns the layout
+ */
+export declare function layoutRecord(label: string, lr: boolean, width: number, height: number, fixed: boolean, fontSize: number, text: (line: string) => string): RecordLayout;
+export {};
+//# sourceMappingURL=record.d.ts.map

package/dist/src/formats/dot/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../../../src/formats/dot/record.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAoBH,2FAA2F;AAC3F,UAAU,YAAY;IAClB,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;IAC1E,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC7F,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,WAAW,CACvB,MAAM,EACN;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CACvF,CAAC;CACL;AAmBD;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAO5D;AAmMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CACxB,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,OAAO,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAC/B,YAAY,CAgDd"}

package/dist/src/formats/dot/record.js

@@ -0,0 +1,275 @@
+/**
+ * @file Graphviz record shapes (`record`, `Mrecord`): the field tree a record label describes and where Graphviz lays
+ * each field, its dividers and its text lines out inside the node (lib/common/shapes.c `parse_reclbl`,
+ * `size_reclbl`, `resize_reclbl`, `pos_reclbl`, `gen_fields`). Text widths are estimated from DejaVu Sans's advance
+ * widths, which the specimen sheets pin; another font is measured as if it were DejaVu Sans.
+ */
+/** Graphviz's padding of a field's text: 4 GAP across (8 a side), 2 GAP down (4 above and below). */
+const PAD = { x: 16, y: 8 };
+/** Graphviz's line height as a multiple of the font size. */
+const LINE_SPACING = 1.2;
+/** DejaVu Sans advance widths of the printable ASCII characters, in 1/2048 em, from space (32) to tilde (126). */
+// prettier-ignore
+const DEJAVU_SANS = [
+    651, 821, 942, 1716, 1303, 1946, 1597, 563, 799, 799, 1024, 1716, 651, 739, 651, 690,
+    1303, 1303, 1303, 1303, 1303, 1303, 1303, 1303, 1303, 1303, 690, 690, 1716, 1716, 1716, 1087,
+    2048, 1401, 1405, 1430, 1577, 1294, 1178, 1587, 1540, 604, 604, 1343, 1141, 1767, 1532, 1612,
+    1235, 1612, 1423, 1300, 1251, 1499, 1401, 2025, 1403, 1251, 1403, 799, 690, 799, 1716, 1024,
+    1024, 1255, 1300, 1126, 1300, 1260, 721, 1300, 1298, 569, 569, 1186, 569, 1995, 1298, 1253,
+    1300, 1300, 842, 1067, 803, 1298, 1212, 1675, 1212, 1212, 1075, 1303, 690, 1303, 1716,
+];
+/**
+ * A text's width in points at a font size, from DejaVu Sans's advances (any other character: 0.6 em).
+ * @param text - the text
+ * @param size - the font size
+ * @returns the width
+ */
+export function textWidth(text, size) {
+    let units = 0;
+    for (const ch of text) {
+        const code = ch.codePointAt(0) ?? 0;
+        units += code >= 32 && code <= 126 ? DEJAVU_SANS[code - 32] : 1229;
+    }
+    return (units / 2048) * size;
+}
+/**
+ * Splits a field's text into lines at `\n`, `\l` and `\r`, each line justified by the escape that ends it; a last
+ * line with no escape is centered. Other escapes are kept for the caller.
+ * @param text - the field's text, record escapes already removed
+ * @returns the lines
+ */
+function splitLines(text) {
+    const lines = [];
+    let line = "";
+    let i = 0;
+    while (i < text.length) {
+        const c = text[i];
+        const next = text[i + 1];
+        if (c === "\\" && (next === "n" || next === "l" || next === "r")) {
+            lines.push({ text: line, justify: next === "n" ? "c" : next });
+            line = "";
+            i += 2;
+        }
+        else if (c === "\\" && next !== undefined) {
+            line += c + next;
+            i += 2;
+        }
+        else {
+            line += c;
+            i++;
+        }
+    }
+    if (line !== "" || lines.length === 0) {
+        lines.push({ text: line, justify: "c" });
+    }
+    return lines;
+}
+/**
+ * Parses a record label into its field tree, as `parse_reclbl` does: `|` parts fields, `{ }` opens a sub-record laid
+ * the other way, `<name>` names a field's port, and `\{ \} \| \< \>` and `\ ` stand for themselves.
+ * @param label - the label
+ * @param lr - whether the top level lays its fields left to right
+ * @returns the root field
+ */
+function parseRecord(label, lr) {
+    return parseFields(label, { i: 0 }, lr, true);
+}
+/**
+ * A parent field holding its children.
+ * @param children - the children
+ * @param across - whether they lay left to right
+ * @returns the field
+ */
+function parentField(children, across) {
+    return { lines: null, port: null, children, lr: across, w: 0, h: 0, x: 0, y: 0 };
+}
+/**
+ * Parses the fields of one (sub-)record from the cursor up to its closing `}` (or the label's end).
+ * @param label - the label
+ * @param cursor - where reading is, moved past what is read
+ * @param across - whether these fields lay left to right
+ * @param top - whether this is the top level, where a stray `}` is skipped
+ * @returns the field holding them
+ */
+function parseFields(label, cursor, across, top) {
+    const children = [];
+    const pending = { text: "", port: null, sub: null };
+    while (cursor.i < label.length) {
+        const c = label[cursor.i];
+        if (c === "{") {
+            cursor.i++;
+            pending.sub = parseFields(label, cursor, !across, false);
+        }
+        else if (c === "}") {
+            cursor.i++;
+            if (!top) {
+                flushField(children, pending, across);
+                return parentField(children, across);
+            }
+        }
+        else if (c === "|") {
+            cursor.i++;
+            flushField(children, pending, across);
+        }
+        else {
+            readFieldText(label, cursor, pending);
+        }
+    }
+    flushField(children, pending, across);
+    return parentField(children, across);
+}
+/**
+ * Reads one escape, port name or character of a field's text at the cursor.
+ * @param label - the label
+ * @param cursor - where reading is, moved past what is read
+ * @param pending - the field being read
+ */
+function readFieldText(label, cursor, pending) {
+    const c = label[cursor.i];
+    const next = label.at(cursor.i + 1);
+    if (c === "\\" && next !== undefined) {
+        pending.text += "{}|<> ".includes(next) ? next : c + next;
+        cursor.i += 2;
+    }
+    else if (c === "<") {
+        const close = label.indexOf(">", cursor.i + 1);
+        const end = close < 0 ? label.length : close;
+        pending.port = label.slice(cursor.i + 1, end).trim();
+        cursor.i = close < 0 ? label.length : close + 1;
+    }
+    else {
+        pending.text += c;
+        cursor.i++;
+    }
+}
+/**
+ * Ends the field being read: adds it (its sub-record, or a leaf of its text) to the children and starts the next.
+ * @param children - the children so far
+ * @param pending - the field being read, cleared
+ * @param across - whether the children lay left to right
+ */
+function flushField(children, pending, across) {
+    const { sub, port } = pending;
+    children.push(sub ?? { lines: splitLines(pending.text.trim()), port, children: [], lr: !across, w: 0, h: 0, x: 0, y: 0 });
+    if (sub !== null && port !== null) {
+        sub.port = port;
+    }
+    pending.text = "";
+    pending.port = null;
+    pending.sub = null;
+}
+/**
+ * Each field's natural size (`size_reclbl`): a leaf's text padded, a parent's children side by side along its way.
+ * @param f - the field
+ * @param size - the font size
+ */
+function sizeField(f, size) {
+    if (f.lines !== null) {
+        const w = Math.max(...f.lines.map((l) => textWidth(l.text, size)));
+        const h = f.lines.length * size * LINE_SPACING;
+        [f.w, f.h] = w > 0 || h > 0 ? [w + PAD.x, h + PAD.y] : [0, 0];
+        return;
+    }
+    f.w = 0;
+    f.h = 0;
+    for (const c of f.children) {
+        sizeField(c, size);
+        f.w = f.lr ? f.w + c.w : Math.max(f.w, c.w);
+        f.h = f.lr ? Math.max(f.h, c.h) : f.h + c.h;
+    }
+}
+/**
+ * Grows or shrinks each field to its share of a new size (`resize_reclbl`): the difference is shared evenly along
+ * the field's way, in whole points.
+ * @param f - the field
+ * @param w - its new width
+ * @param h - its new height
+ */
+function resizeField(f, w, h) {
+    const inc = (f.lr ? w - f.w : h - f.h) / Math.max(1, f.children.length);
+    f.w = w;
+    f.h = h;
+    f.children.forEach((c, k) => {
+        const amt = Math.trunc((k + 1) * inc) - Math.trunc(k * inc);
+        resizeField(c, f.lr ? c.w + amt : w, f.lr ? h : c.h + amt);
+    });
+}
+/**
+ * Places each field from its upper left corner (`pos_reclbl`), y up.
+ * @param f - the field
+ * @param x - its left side
+ * @param y - its top
+ */
+function placeField(f, x, y) {
+    f.x = x;
+    f.y = y;
+    let at = f.lr ? x : y;
+    for (const c of f.children) {
+        placeField(c, f.lr ? at : x, f.lr ? y : at);
+        at += f.lr ? c.w : -c.h;
+    }
+}
+/**
+ * Lays a record out in a node as Graphviz does: the fields at their natural sizes, the node at least that big unless
+ * it is `fixedsize`, every field then grown to share the node, its dividers between neighbors and its lines centered,
+ * or set in from its side by 8 points when justified left or right.
+ * @param label - the record label, before its escapes are applied
+ * @param lr - whether the top level lays its fields left to right (true unless `rankdir` is LR or RL)
+ * @param width - the node's width in points
+ * @param height - its height in points
+ * @param fixed - whether the node keeps its size (`fixedsize`)
+ * @param fontSize - the font size in points
+ * @param text - applies the label escapes to one line
+ * @returns the layout
+ */
+export function layoutRecord(label, lr, width, height, fixed, fontSize, text) {
+    const root = parseRecord(label, lr);
+    const leaves = (f) => {
+        if (f.lines !== null) {
+            f.lines = f.lines.map((l) => ({ ...l, text: text(l.text) }));
+        }
+        f.children.forEach(leaves);
+    };
+    leaves(root);
+    sizeField(root, fontSize);
+    const w = fixed ? width : Math.max(width, root.w);
+    const h = fixed ? height : Math.max(height, root.h);
+    resizeField(root, w, h);
+    placeField(root, -w / 2, h / 2);
+    const dividers = [];
+    const texts = [];
+    const ports = new Map();
+    const lineHeight = fontSize * LINE_SPACING;
+    const visit = (f) => {
+        if (f.port !== null && f.port !== "") {
+            ports.set(f.port, { x: f.x + f.w / 2, y: f.y - f.h / 2, hw: f.w / 2, hh: f.h / 2 });
+        }
+        f.children.forEach((c, k) => {
+            if (k > 0) {
+                dividers.push(f.lr ? [c.x, c.y, c.x, c.y - c.h] : [c.x, c.y, c.x + c.w, c.y]);
+            }
+            visit(c);
+        });
+        if (f.lines === null) {
+            return;
+        }
+        const n = f.lines.length;
+        f.lines.forEach((l, k) => {
+            if (l.text === "") {
+                return;
+            }
+            const half = textWidth(l.text, fontSize) / 2;
+            let x = f.x + f.w / 2;
+            if (l.justify === "l") {
+                x = f.x + PAD.x / 2 + half;
+            }
+            else if (l.justify === "r") {
+                x = f.x + f.w - PAD.x / 2 - half;
+            }
+            texts.push({ x, y: f.y - f.h / 2 + ((n - 1) / 2 - k) * lineHeight, text: l.text });
+        });
+    };
+    visit(root);
+    return { width: w, height: h, dividers, texts, ports };
+}
+//# sourceMappingURL=record.js.map

package/dist/src/formats/dot/record.js.map

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

package/dist/src/formats/dot/styles.d.ts

@@ -13,7 +13,7 @@
  *   `none` and `invis` are transparent, and a color list is read as Graphviz draws it for that use.
  * - Outlines: `plain`, `plaintext` and `none` draw none. `setlinewidth(n)` is a pen width, `bold` a width of 2.
  * - Sizes: exact with `fixedsize`, an empty label or a `point`; otherwise minimums Graphviz grows to fit the label,
- *   carried and noted as `W_STYLE_SIZE_MINIMUM`.
+ *   carried as `labelFit: "inside"` with the label's padding (`margin`, else 8 by 4 points).
  * - Arrows per `dir`, `arrowhead` and `arrowtail`, with the graph's kind deciding the default: a target arrow on
  *   directed edges, as one tool-default rule.
  * - A cluster's container node holds the cluster's attributes: its fill (`bgcolor`, or the fill when `filled`) and
@@ -26,8 +26,10 @@
  * per-element values its rules read are quoted `"graphty.style.<target>.<key>"` attributes.
  */
 import type { GraphSnapshot } from "@graphty/graph-format";
+import { type BendPoint } from "../../styles/canon/bends.js";
+import { type CanonSite } from "../../styles/canon/site.js";
 import { type ExporterStyleInput } from "../../styles/io/writer.js";
-import type { ImporterStyles, StyleReadContext, StyleWriteCapabilities } from "../../styles/types.js";
+import type { ImporterStyles, StyleReadContext, StyleValue, StyleWriteCapabilities } from "../../styles/types.js";
 import type { LossNote } from "../../types.js";
 /**
  * The graph attribute holding the `graphty.styles` block of a DOT file graphty wrote.
@@ -47,6 +49,64 @@ export declare const DOT_STYLE_CAPABILITIES: StyleWriteCapabilities;
  * @returns true for an HTML string
  */
 export declare function isHtmlString(text: string): boolean;
+/** The outlines Graphviz draws round a node of these shapes when `peripheries` is not set. */
+export declare const SHAPE_PERIPHERIES: ReadonlyMap<string, number>;
+/** How far apart Graphviz draws a node's outlines, center to center (`GAP`, lib/common/shapes.c). */
+export declare const PERIPHERY_GAP = 4;
+/**
+ * A Graphviz shape drawn as pieces of its own (`graphvizGlyph`) at a node's size, as the neutral values that draw it:
+ * a polygon of its outline drawn where it says, its further pieces (`shapeParts`) and lines (`shapeLines`), each as
+ * fractions of the node's half width and half height. An `underline` is filled with no line round it, its line alone
+ * drawn in the pen's width.
+ * @param shape - the shape name, lowercase
+ * @param width - the node's width in points, or null for Graphviz's default
+ * @param height - its height, or null
+ * @param put - receives the values
+ * @param pen - the node's pen width, for an outline drawn as a line alone and a ring
+ * @param color - the node's pen color, for a ring
+ */
+export declare function putGlyph(shape: string, width: number | null, height: number | null, put: (property: string, value: StyleValue | null) => void, pen: () => number, color: () => string | null): void;
+/**
+ * The corners of a Graphviz shape graphty draws as a polygon (`house`, `cylinder`, `note` ...), as a `shapePoints`
+ * value, or undefined for a shape graphty draws by name.
+ * @param shape - the shape name, lowercase
+ * @returns the corners, or undefined
+ */
+export declare function graphvizOutline(shape: string): string | undefined;
+/**
+ * Whether Graphviz draws a shape with no outline (`plain`, `plaintext`, `none`).
+ * @param shape - the shape name, lowercase
+ * @returns true for a shape with no outline
+ */
+export declare function graphvizHasNoOutline(shape: string): boolean;
+/**
+ * The bends of a route Graphviz laid: B-splines of `3n + 1` control points each (y up), flattened into bends between
+ * the two nodes' centers. Null for a route on the line between the centers, which is the straight edge it looks like,
+ * or for control points that are not a spline. Also reads the `Line` of a GML file Graphviz's gv2gml wrote.
+ * @param source - the source node's center
+ * @param target - the target node's center
+ * @param splines - the control points of each spline, joined end to end
+ * @param tips - the arrow tips `pos` stores (`s,x,y` and `e,x,y`): the line runs on to each, along its arrow
+ * @param tips.start - the tail arrow's tip, or null
+ * @param tips.end - the head arrow's tip, or null
+ * @returns the `bends` value, or null
+ */
+export declare function graphvizRouteBends(source: BendPoint, target: BendPoint, splines: readonly (readonly BendPoint[])[], tips?: {
+    readonly start: BendPoint | null;
+    readonly end: BendPoint | null;
+}): string | null;
+/**
+ * The neutral arrow value Graphviz draws for an arrow name (`onormal`, `lbox`, `invempty`), with an open shape the
+ * neutral vocabulary has no name for (`obox`, `oinv`) as the value graphty draws it as, and the side an `l` or `r`
+ * keeps. Read so by the DOT reader and by the GML reader for gv2gml's `targetArrow` / `sourceArrow`.
+ * @param raw - the arrow name
+ * @param site - where it was read
+ * @returns the value and its side (null for the whole shape)
+ */
+export declare function graphvizArrowValue(raw: string, site: CanonSite): {
+    readonly value: string | null;
+    readonly side: "left" | "right" | null;
+};
 /**
  * The styles of a DOT file, read the way Graphviz draws it, with Graphviz's defaults beneath: an unfilled black
  * ellipse 54 x 36 labeled with its name, black edges with a target arrow in a directed graph. A file graphty wrote

package/dist/src/formats/dot/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../src/formats/dot/styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAmB3D,OAAO,EAAE,KAAK,kBAAkB,EAAsB,MAAM,2BAA2B,CAAC;AAIxF,OAAO,KAAK,EACR,cAAc,EAGd,gBAAgB,EAIhB,sBAAsB,EACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI/C;;;GAGG;AACH,OAAO,EAAE,gBAAgB,IAAI,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAEzF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,sBAqCnC,CAAC;AAiGH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAiBlD;AA+mBD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,gBAAgB,GAAG,cAAc,CAiH5F;AAwgBD,2CAA2C;AAC3C,UAAU,eAAe;IACrB,mHAAmH;IACnH,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;CACvC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC3B,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,kBAAkB,GAAG,SAAS,EACrC,gBAAgB,CAAC,EAAE,OAAO,GAC3B,eAAe,GAAG,IAAI,CAQxB;AAwMD;;GAEG;AACH,eAAO,MAAM,wBAAwB,0BAA0B,CAAC"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../src/formats/dot/styles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D,OAAO,EAAE,KAAK,SAAS,EAA8C,MAAM,6BAA6B,CAAC;AAIzG,OAAO,EAAE,KAAK,SAAS,EAAkC,MAAM,4BAA4B,CAAC;AAc5F,OAAO,EAAE,KAAK,kBAAkB,EAAsB,MAAM,2BAA2B,CAAC;AAGxF,OAAO,KAAK,EACR,cAAc,EAGd,gBAAgB,EAGhB,UAAU,EACV,sBAAsB,EACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAgB/C;;;GAGG;AACH,OAAO,EAAE,gBAAgB,IAAI,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAEzF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,sBAiDnC,CAAC;AA4GH;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAiBlD;AAq5BD,8FAA8F;AAC9F,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAIxD,CAAC;AAEH,qGAAqG;AACrG,eAAO,MAAM,aAAa,IAAI,CAAC;AAuL/B;;;;;;;;;;;GAWG;AACH,wBAAgB,QAAQ,CACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,MAAM,EAAE,MAAM,GAAG,IAAI,EACrB,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,EACzD,GAAG,EAAE,MAAM,MAAM,EACjB,KAAK,EAAE,MAAM,MAAM,GAAG,IAAI,GAC3B,IAAI,CAoBN;AAmCD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEjE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE3D;AAqWD;;;;;;;;;;;GAWG;AACH,wBAAgB,kBAAkB,CAC9B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,SAAS,EACjB,OAAO,EAAE,SAAS,CAAC,SAAS,SAAS,EAAE,CAAC,EAAE,EAC1C,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI,CAAA;CAAE,GAC5E,MAAM,GAAG,IAAI,CAyBf;AAmFD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAC9B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,SAAS,GAChB;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAA;CAAE,CAO3E;AAoMD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,gBAAgB,GAAG,cAAc,CAgH5F;AA8nBD,2CAA2C;AAC3C,UAAU,eAAe;IACrB,mHAAmH;IACnH,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;CACvC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC3B,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,kBAAkB,GAAG,SAAS,EACrC,gBAAgB,CAAC,EAAE,OAAO,GAC3B,eAAe,GAAG,IAAI,CAQxB;AAmRD;;GAEG;AACH,eAAO,MAAM,wBAAwB,0BAA0B,CAAC"}