@graphty/graph-io 0.3.42 → 0.3.44

package/dist/src/styles/canon/number.js

@@ -0,0 +1,142 @@
+/**
+ * Canonical numbers, lengths, opacities and booleans: 6 significant digits, never negative, never NaN or Infinity.
+ */
+import { STYLE_ISSUE } from "../codes.js";
+import { noteAt, scalarText, spendAt } from "./site.js";
+/**
+ * The largest length or factor a file may give; a larger one is noted as `W_STYLE_BAD_VALUE` and gives no value.
+ * @category Styles
+ */
+export const MAX_STYLE_NUMBER = 1e6;
+/**
+ * Points per inch: DOT gives node sizes in inches, and a canonical length is in points (pixels at 72 dpi).
+ * @category Styles
+ */
+export const DOT_POINTS_PER_INCH = 72;
+/** One way to read a decimal number, so a long run of digits fails or passes in one pass. */
+const DECIMAL = /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?$/;
+/**
+ * A number at 6 significant digits, with `-0` as `0`.
+ * @param value - a finite number
+ * @returns the canonical number
+ * @category Styles
+ */
+export function num6(value) {
+    return Number(value.toPrecision(6)) + 0;
+}
+/**
+ * A finite number from a number or a decimal string, or null with a note.
+ * @param raw - the file's value
+ * @param site - where it was read
+ * @returns the number, or null
+ */
+function finite(raw, site) {
+    if (typeof raw === "boolean") {
+        noteAt(site, STYLE_ISSUE.BAD_VALUE, raw);
+        return null;
+    }
+    const text = scalarText(raw, site);
+    if (text === null) {
+        return null;
+    }
+    const trimmed = text.trim();
+    let value = Number.NaN;
+    if (typeof raw === "number") {
+        value = raw;
+    }
+    else if (DECIMAL.test(trimmed)) {
+        value = Number(trimmed);
+    }
+    if (!Number.isFinite(value)) {
+        noteAt(site, STYLE_ISSUE.BAD_VALUE, text);
+        return null;
+    }
+    return value;
+}
+/**
+ * A length or factor: a finite number at least 0 and at most `MAX_STYLE_NUMBER` after multiplying by `factor`, at 6
+ * significant digits. Anything else is null with a `W_STYLE_BAD_VALUE` note.
+ * @param raw - the file's value: a number or a decimal string
+ * @param site - where it was read
+ * @param factor - multiplies the value first (`DOT_POINTS_PER_INCH` for DOT sizes); defaults to 1
+ * @returns the canonical number, or null
+ * @category Styles
+ */
+export function canonNumber(raw, site, factor = 1) {
+    const value = finite(raw, site);
+    if (value === null) {
+        return null;
+    }
+    const scaled = value * factor;
+    if (!(scaled >= 0 && scaled <= MAX_STYLE_NUMBER)) {
+        noteAt(site, STYLE_ISSUE.BAD_VALUE, typeof raw === "string" ? raw : String(raw));
+        return null;
+    }
+    return num6(scaled);
+}
+/**
+ * An opacity from 0 to 1. Cytoscape desktop states opacities from 0 to 255 and is divided by 255; every other
+ * dialect states 0 to 1. A value outside the dialect's range is null with a `W_STYLE_BAD_VALUE` note.
+ * @param raw - the file's value
+ * @param dialect - the file's dialect
+ * @param site - where it was read
+ * @returns the canonical opacity, or null
+ * @category Styles
+ */
+export function canonOpacity(raw, dialect, site) {
+    const value = finite(raw, site);
+    if (value === null) {
+        return null;
+    }
+    const top = dialect === "cytoscape" ? 255 : 1;
+    if (!(value >= 0 && value <= top)) {
+        noteAt(site, STYLE_ISSUE.BAD_VALUE, typeof raw === "string" ? raw : String(raw));
+        return null;
+    }
+    return num6(value / top);
+}
+/** Boolean spellings, lowercase. */
+const BOOLEANS = new Map([
+    ["true", true],
+    ["yes", true],
+    ["on", true],
+    ["1", true],
+    ["false", false],
+    ["no", false],
+    ["off", false],
+    ["0", false],
+]);
+/**
+ * A boolean from `true`/`false`, `yes`/`no`, `on`/`off` or `1`/`0` in any case; anything else is null with a note.
+ * @param raw - the file's value
+ * @param site - where it was read
+ * @returns the boolean, or null
+ * @category Styles
+ */
+export function canonBoolean(raw, site) {
+    if (typeof raw === "boolean") {
+        spendAt(site, 1);
+        return raw;
+    }
+    const text = scalarText(raw, site);
+    if (text === null) {
+        return null;
+    }
+    const value = BOOLEANS.get(text.trim().toLowerCase());
+    if (value === undefined) {
+        noteAt(site, STYLE_ISSUE.BAD_VALUE, text);
+        return null;
+    }
+    return value;
+}
+/**
+ * The unit of a dialect's lengths: GEXF and Pajek give size factors relative to their tool's normal size, every
+ * other dialect gives pixels (after DOT's inches are converted).
+ * @param dialect - the file's dialect
+ * @returns `"relative"` or `"px"`
+ * @category Styles
+ */
+export function styleLengthUnit(dialect) {
+    return dialect === "gexf" || dialect === "dvips" ? "relative" : "px";
+}
+//# sourceMappingURL=number.js.map

package/dist/src/styles/canon/number.js.map

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

package/dist/src/styles/canon/site.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Where a raw value came from, so a canonicalizer can note a problem against the right target, property and element
+ * and spend the work it costs from the extraction's one budget.
+ */
+import type { StyleNotes } from "../notes.js";
+import type { StyleNoteCode, StyleTarget, StyleWorkBudget } from "../types.js";
+/**
+ * A number, color, enumeration or mapper expression longer than this many characters is not parsed: it is noted as
+ * `W_STYLE_VALUE_TOO_LONG` and gives no value. Text is copied whatever its length.
+ * @category Styles
+ */
+export declare const MAX_STYLE_VALUE_LENGTH = 256;
+/**
+ * Where a raw value is read: the notes it reports to, the target and property it is for, the element it belongs to
+ * and the budget its work is spent from.
+ * @category Styles
+ */
+export interface CanonSite {
+    /** Where problems are noted. */
+    readonly notes: StyleNotes;
+    /** Nodes, edges or the graph. */
+    readonly target: StyleTarget | "graph";
+    /** The neutral property the value is for. */
+    readonly property: string;
+    /** The element the value belongs to, by index; absent for a rule's value. */
+    readonly element?: number;
+    /** The work budget; each value spends one operation plus one per character it reads. */
+    readonly budget?: StyleWorkBudget;
+}
+/**
+ * Notes a problem with a value at its site.
+ * @param site - where the value was read
+ * @param code - the condition
+ * @param sample - the offending value
+ */
+export declare function noteAt(site: CanonSite, code: StyleNoteCode, sample: unknown): void;
+/**
+ * Spends operations from the site's budget; graph values count as node work.
+ * @param site - where the value was read
+ * @param operations - the work
+ */
+export declare function spendAt(site: CanonSite, operations: number): void;
+/**
+ * The text of a raw scalar, untrimmed, after the length limit: null for an absent value (no note), and null with a
+ * note for a value that is empty, too long, not finite or not a scalar. Spends at most 257 operations.
+ * @param raw - the file's value
+ * @param site - where it was read
+ * @returns the value's text, or null
+ */
+export declare function scalarText(raw: unknown, site: CanonSite): string | null;
+//# sourceMappingURL=site.d.ts.map

package/dist/src/styles/canon/site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../../../../src/styles/canon/site.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE/E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACtB,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC;IACvC,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,wFAAwF;IACxF,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAElF;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAEjE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CA0BvE"}

package/dist/src/styles/canon/site.js

@@ -0,0 +1,63 @@
+/**
+ * Where a raw value came from, so a canonicalizer can note a problem against the right target, property and element
+ * and spend the work it costs from the extraction's one budget.
+ */
+import { STYLE_ISSUE } from "../codes.js";
+/**
+ * A number, color, enumeration or mapper expression longer than this many characters is not parsed: it is noted as
+ * `W_STYLE_VALUE_TOO_LONG` and gives no value. Text is copied whatever its length.
+ * @category Styles
+ */
+export const MAX_STYLE_VALUE_LENGTH = 256;
+/**
+ * Notes a problem with a value at its site.
+ * @param site - where the value was read
+ * @param code - the condition
+ * @param sample - the offending value
+ */
+export function noteAt(site, code, sample) {
+    site.notes.add(code, site.target, site.property, { sample, element: site.element });
+}
+/**
+ * Spends operations from the site's budget; graph values count as node work.
+ * @param site - where the value was read
+ * @param operations - the work
+ */
+export function spendAt(site, operations) {
+    site.budget?.spend(site.target === "graph" ? "node" : site.target, operations);
+}
+/**
+ * The text of a raw scalar, untrimmed, after the length limit: null for an absent value (no note), and null with a
+ * note for a value that is empty, too long, not finite or not a scalar. Spends at most 257 operations.
+ * @param raw - the file's value
+ * @param site - where it was read
+ * @returns the value's text, or null
+ */
+export function scalarText(raw, site) {
+    spendAt(site, 1);
+    if (raw === null || raw === undefined) {
+        return null;
+    }
+    if (typeof raw === "number") {
+        if (Number.isFinite(raw)) {
+            return String(raw);
+        }
+        noteAt(site, STYLE_ISSUE.BAD_VALUE, String(raw));
+        return null;
+    }
+    if (typeof raw !== "string") {
+        noteAt(site, STYLE_ISSUE.BAD_VALUE, typeof raw);
+        return null;
+    }
+    if (raw.length > MAX_STYLE_VALUE_LENGTH) {
+        noteAt(site, STYLE_ISSUE.VALUE_TOO_LONG, `${raw.length} characters`);
+        return null;
+    }
+    spendAt(site, raw.length);
+    if (raw.trim() === "") {
+        noteAt(site, STYLE_ISSUE.BAD_VALUE, raw);
+        return null;
+    }
+    return raw;
+}
+//# sourceMappingURL=site.js.map

package/dist/src/styles/canon/site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.js","sourceRoot":"","sources":["../../../../src/styles/canon/site.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAoB1C;;;;;GAKG;AACH,MAAM,UAAU,MAAM,CAAC,IAAe,EAAE,IAAmB,EAAE,MAAe;IACxE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;AACxF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,IAAe,EAAE,UAAkB;IACvD,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AACnF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,GAAY,EAAE,IAAe;IACpD,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IACjB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACpC,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC1B,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACjD,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,EAAE,OAAO,GAAG,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,IAAI,GAAG,CAAC,MAAM,GAAG,sBAAsB,EAAE,CAAC;QACtC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,cAAc,EAAE,GAAG,GAAG,CAAC,MAAM,aAAa,CAAC,CAAC;QACrE,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC"}

package/dist/src/styles/canon/text.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Canonical text: the text a tool draws. Text is copied whatever its length and never matched with a pattern that
+ * can backtrack; every pass here is linear in the text's length and spends one operation per character.
+ */
+import { type CanonSite } from "./site.js";
+/**
+ * A text value: a string as it is, a finite number or a boolean as its text. Anything else is null with a
+ * `W_STYLE_BAD_VALUE` note; an absent value is null without one.
+ * @param raw - the file's value
+ * @param site - where it was read
+ * @returns the text, or null
+ * @category Styles
+ */
+export declare function canonText(raw: unknown, site: CanonSite): string | null;
+/**
+ * The names Graphviz substitutes for `\N`, `\G`, `\E`, `\T` and `\H` in a label; an absent name leaves its escape
+ * as written.
+ * @category Styles
+ */
+export interface DotEscapeNames {
+    /** The node's name, for `\N`. */
+    readonly node?: string;
+    /** The graph's name, for `\G`. */
+    readonly graph?: string;
+    /** The edge's name (`a->b` or `a--b`), for `\E`. */
+    readonly edge?: string;
+    /** The edge's tail node, for `\T`. */
+    readonly tail?: string;
+    /** The edge's head node, for `\H`. */
+    readonly head?: string;
+}
+/**
+ * The text a DOT label draws, in Graphviz's two passes: first `\N`, `\G`, `\E`, `\T` and `\H` are replaced by the
+ * names and every other backslash pair is kept; then `\n`, `\l` and `\r` end a line (a final one adds no empty line)
+ * and any other escaped character stands for itself. So a node name holding `\n` breaks the line.
+ * @param text - the label as the file gives it
+ * @param names - the names to substitute
+ * @param site - where it was read, for the budget
+ * @returns the label's text
+ * @category Styles
+ */
+export declare function dotLabelText(text: string, names: DotEscapeNames, site?: CanonSite): string;
+/**
+ * The text an HTML-like label shows: tags dropped, `<br/>` as a line break, entities decoded, outer blanks trimmed.
+ * Notes `W_STYLE_HTML_LABEL` at the site, since the markup is lost.
+ * @param html - the label, with or without its outer `<` and `>`
+ * @param site - where it was read
+ * @returns the label's text
+ * @category Styles
+ */
+export declare function htmlLabelText(html: string, site: CanonSite): string;
+/**
+ * The text a Graphviz record label shows: its fields (`<f0> left|<f1> mid|{a|b}`) without their port names, trimmed,
+ * empty ones left out, joined with " | ". Notes `W_STYLE_RECORD_LABEL` at the site, since the boxes are lost.
+ * @param label - the record label
+ * @param site - where it was read
+ * @returns the fields' text
+ * @category Styles
+ */
+export declare function recordLabelText(label: string, site: CanonSite): string;
+//# sourceMappingURL=text.d.ts.map

package/dist/src/styles/canon/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../../../src/styles/canon/text.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,KAAK,SAAS,EAAmB,MAAM,WAAW,CAAC;AAE5D;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CActE;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC3B,iCAAiC;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,kCAAkC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,oDAAoD;IACpD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAc1F;AAoDD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CA2BnE;AAgBD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAmCtE"}

package/dist/src/styles/canon/text.js

@@ -0,0 +1,199 @@
+/**
+ * Canonical text: the text a tool draws. Text is copied whatever its length and never matched with a pattern that
+ * can backtrack; every pass here is linear in the text's length and spends one operation per character.
+ */
+import { STYLE_ISSUE } from "../codes.js";
+import { noteAt, spendAt } from "./site.js";
+/**
+ * A text value: a string as it is, a finite number or a boolean as its text. Anything else is null with a
+ * `W_STYLE_BAD_VALUE` note; an absent value is null without one.
+ * @param raw - the file's value
+ * @param site - where it was read
+ * @returns the text, or null
+ * @category Styles
+ */
+export function canonText(raw, site) {
+    spendAt(site, 1);
+    if (raw === null || raw === undefined) {
+        return null;
+    }
+    if (typeof raw === "string") {
+        spendAt(site, raw.length);
+        return raw;
+    }
+    if ((typeof raw === "number" && Number.isFinite(raw)) || typeof raw === "boolean") {
+        return String(raw);
+    }
+    noteAt(site, STYLE_ISSUE.BAD_VALUE, typeof raw === "number" ? String(raw) : typeof raw);
+    return null;
+}
+/**
+ * The text a DOT label draws, in Graphviz's two passes: first `\N`, `\G`, `\E`, `\T` and `\H` are replaced by the
+ * names and every other backslash pair is kept; then `\n`, `\l` and `\r` end a line (a final one adds no empty line)
+ * and any other escaped character stands for itself. So a node name holding `\n` breaks the line.
+ * @param text - the label as the file gives it
+ * @param names - the names to substitute
+ * @param site - where it was read, for the budget
+ * @returns the label's text
+ * @category Styles
+ */
+export function dotLabelText(text, names, site) {
+    if (site !== undefined) {
+        spendAt(site, text.length);
+    }
+    const subs = {
+        N: names.node,
+        G: names.graph,
+        E: names.edge,
+        T: names.tail,
+        H: names.head,
+    };
+    const first = replaceEscapes(text, (e) => (Object.hasOwn(subs, e) ? subs[e] : undefined) ?? `\\${e}`);
+    const out = replaceEscapes(first, (e) => (e === "n" || e === "l" || e === "r" ? "\n" : e));
+    return out.endsWith("\n") ? out.slice(0, -1) : out;
+}
+/**
+ * A text with every backslash escape (a backslash and the character after it) replaced; a backslash at the end stays.
+ * @param text - the text
+ * @param replace - the replacement of an escape, given the escaped character
+ * @returns the text
+ */
+function replaceEscapes(text, replace) {
+    let out = "";
+    let i = 0;
+    while (i < text.length) {
+        const c = text[i];
+        if (c === "\\" && i + 1 < text.length) {
+            out += replace(text[i + 1]);
+            i += 2;
+        }
+        else {
+            out += c;
+            i++;
+        }
+    }
+    return out;
+}
+/** HTML entity names an HTML-like label may use. */
+const ENTITIES = new Map([
+    ["amp", "&"],
+    ["lt", "<"],
+    ["gt", ">"],
+    ["quot", '"'],
+    ["apos", "'"],
+    ["nbsp", " "],
+]);
+/**
+ * Decodes one entity body (`amp`, `#38`, `#x26`).
+ * @param body - the text between `&` and `;`
+ * @returns the character, or undefined when it is not an entity
+ */
+function entity(body) {
+    if (body.startsWith("#")) {
+        const hex = body[1] === "x" || body[1] === "X";
+        const digits = body.slice(hex ? 2 : 1);
+        if (digits === "" || digits.length > 7 || !(hex ? /^[0-9a-f]+$/i : /^\d+$/).test(digits)) {
+            return undefined;
+        }
+        const cp = Number.parseInt(digits, hex ? 16 : 10);
+        return cp > 0 && cp <= 0x10ffff ? String.fromCodePoint(cp) : undefined;
+    }
+    return ENTITIES.get(body.toLowerCase());
+}
+/**
+ * The text an HTML-like label shows: tags dropped, `<br/>` as a line break, entities decoded, outer blanks trimmed.
+ * Notes `W_STYLE_HTML_LABEL` at the site, since the markup is lost.
+ * @param html - the label, with or without its outer `<` and `>`
+ * @param site - where it was read
+ * @returns the label's text
+ * @category Styles
+ */
+export function htmlLabelText(html, site) {
+    spendAt(site, html.length);
+    noteAt(site, STYLE_ISSUE.HTML_LABEL, html);
+    const body = html.startsWith("<") && html.endsWith(">") ? html.slice(1, -1) : html;
+    let out = "";
+    let i = 0;
+    while (i < body.length) {
+        const c = body[i];
+        if (c === "<") {
+            const close = body.indexOf(">", i + 1);
+            if (close < 0) {
+                break;
+            }
+            if (/^<br\b/i.test(body.slice(i, i + 4))) {
+                out += "\n";
+            }
+            i = close + 1;
+        }
+        else if (c === "&") {
+            const [text, next] = entityAt(body, i);
+            out += text;
+            i = next;
+        }
+        else {
+            out += c;
+            i++;
+        }
+    }
+    return out.trim();
+}
+/**
+ * The entity starting at an `&`, decoded; an `&` that starts none is itself. An entity is at most 9 characters, so
+ * the search for its ";" stays short and the pass stays linear.
+ * @param body - the text
+ * @param i - the offset of the `&`
+ * @returns the text it stands for and the offset after it
+ */
+function entityAt(body, i) {
+    const near = body.slice(i + 1, i + 10).indexOf(";");
+    const semi = near < 0 ? -1 : i + 1 + near;
+    const decoded = semi > i ? entity(body.slice(i + 1, semi)) : undefined;
+    return decoded === undefined ? ["&", i + 1] : [decoded, semi + 1];
+}
+/**
+ * The text a Graphviz record label shows: its fields (`<f0> left|<f1> mid|{a|b}`) without their port names, trimmed,
+ * empty ones left out, joined with " | ". Notes `W_STYLE_RECORD_LABEL` at the site, since the boxes are lost.
+ * @param label - the record label
+ * @param site - where it was read
+ * @returns the fields' text
+ * @category Styles
+ */
+export function recordLabelText(label, site) {
+    spendAt(site, label.length);
+    noteAt(site, STYLE_ISSUE.RECORD_LABEL, label);
+    const fields = [];
+    let field = "";
+    const flush = () => {
+        const t = field.trim();
+        if (t !== "") {
+            fields.push(t);
+        }
+        field = "";
+    };
+    let i = 0;
+    while (i < label.length) {
+        const c = label[i];
+        if (c === "\\" && i + 1 < label.length && "|{}<> ".includes(label[i + 1])) {
+            field += label[i + 1];
+            i += 2;
+            continue;
+        }
+        if (c === "<") {
+            // a port name runs to its ">"
+            const close = label.indexOf(">", i + 1);
+            i = close < 0 ? label.length : close + 1;
+            continue;
+        }
+        if (c === "|" || c === "{" || c === "}") {
+            flush();
+        }
+        else {
+            field += c;
+        }
+        i++;
+    }
+    flush();
+    return fields.join(" | ");
+}
+//# sourceMappingURL=text.js.map

package/dist/src/styles/canon/text.js.map

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

package/dist/src/styles/codes.d.ts

@@ -0,0 +1,95 @@
+/**
+ * The codes of every style condition graph-io reports: the notes attached to a file's styles (`W_STYLE_*`), the
+ * import and export report codes about styles as a whole (`W_STYLES_*`), and the one error (`E_STYLES_MISMATCH`).
+ */
+/**
+ * Every style code by name. A key is the code without its `E_` / `W_` and `STYLE_` / `STYLES_` prefixes. Every style
+ * condition is a warning except `MISMATCH`; none counts toward an import's `errorLimit`.
+ * @category Styles
+ */
+export declare const STYLE_ISSUE: Readonly<{
+    /** A value longer than 256 characters was not parsed. */
+    VALUE_TOO_LONG: "W_STYLE_VALUE_TOO_LONG";
+    /** A value does not parse in the file's dialect (an unknown color name, a non-number, a negative length). */
+    BAD_VALUE: "W_STYLE_BAD_VALUE";
+    /** An enumeration value the vocabulary has no name for; kept as `other:<value>`. */
+    UNKNOWN_VALUE: "W_STYLE_UNKNOWN_VALUE";
+    /** A color's alpha was dropped because the property has no opacity to carry it. */
+    ALPHA_DROPPED: "W_STYLE_ALPHA_DROPPED";
+    /** A list of colors where one color is expected; the tool draws it its own way and the first is not taken. */
+    COLOR_LIST: "W_STYLE_COLOR_LIST";
+    /** A gradient fill; its first color is kept. */
+    GRADIENT: "W_STYLE_GRADIENT";
+    /** A node the tool draws unfilled although the file gives it a fill color. */
+    UNFILLED: "W_STYLE_UNFILLED";
+    /** A node fill the file marks as transparent or absent. */
+    NO_FILL: "W_STYLE_NO_FILL";
+    /** An edge stroke the file marks as absent. */
+    NO_STROKE: "W_STYLE_NO_STROKE";
+    /** The tool grows a node to fit its label, so the stated size is a minimum. */
+    SIZE_MINIMUM: "W_STYLE_SIZE_MINIMUM";
+    /** An HTML-like label: its text is kept and its markup dropped. */
+    HTML_LABEL: "W_STYLE_HTML_LABEL";
+    /** A record label: its fields are joined with " | ". */
+    RECORD_LABEL: "W_STYLE_RECORD_LABEL";
+    /** An element carries more than one label; the first is kept. */
+    EXTRA_LABELS: "W_STYLE_EXTRA_LABELS";
+    /** A color that inherits from the edge's ends in a way the vocabulary cannot express. */
+    INHERIT_COLOR: "W_STYLE_INHERIT_COLOR";
+    /** A style property the vocabulary has no counterpart for was not carried. */
+    NOT_CARRIED: "W_STYLE_NOT_CARRIED";
+    /** A declared mapping that cannot be read. */
+    BAD_MAPPING: "W_STYLE_BAD_MAPPING";
+    /** A declared mapping reads a column the file does not have. */
+    MAPPING_COLUMN_MISSING: "W_STYLE_MAPPING_COLUMN_MISSING";
+    /** References between style records that are circular or too deep; the rest are read. */
+    REFERENCE_CYCLE: "W_STYLE_REFERENCE_CYCLE";
+    /** A style reference that names nothing in the file. */
+    UNRESOLVED: "W_STYLE_UNRESOLVED";
+    /** Style structures nested deeper than graph-io reads. */
+    NESTING: "W_STYLE_NESTING";
+    /** A style section that cannot be read at all. */
+    UNREADABLE: "W_STYLE_UNREADABLE";
+    /** A Cytoscape session without its visual styles; the tool's fallbacks apply. */
+    NO_VIZMAP: "W_STYLE_NO_VIZMAP";
+    /** The view names a visual style the file does not hold. */
+    VIEW_STYLE_MISSING: "W_STYLE_VIEW_STYLE_MISSING";
+    /** The file holds more visual styles than the one its view uses; the others are not read. */
+    OTHER_STYLES: "W_STYLE_OTHER_STYLES";
+    /** The file holds more views than one; only the first view's styles are read. */
+    OTHER_VIEWS: "W_STYLE_OTHER_VIEWS";
+    /** A selector the tool treats as invalid, which matches every element there. */
+    SELECTOR: "W_STYLE_SELECTOR";
+    /** A selector a short predicate cannot express; its members are marked on the elements instead. */
+    SELECTOR_AS_COLUMN: "W_STYLE_SELECTOR_AS_COLUMN";
+    /** A selector state that changes while the tool runs (selected, hovered), evaluated as at load. */
+    STATE_ASSUMED: "W_STYLE_STATE_ASSUMED";
+    /** A continuous mapping matches the file's values only within the tool's rounding. */
+    RAMP_ROUNDED: "W_STYLE_RAMP_ROUNDED";
+    /** Rules were folded into a copy to keep the number of rules per kind bounded. */
+    LAYER_CAP: "W_STYLE_LAYER_CAP";
+    /** The counted work budget ran out; the values not yet explained are copied per element. */
+    BUDGET: "W_STYLE_BUDGET";
+    /** A `graphty.styles` block was ignored, with a reason code; the file is read like any other. */
+    BLOCK_IGNORED: "W_STYLE_BLOCK_IGNORED";
+    /** The format has no place for this property; it is not written. */
+    NOT_WRITTEN: "W_STYLE_NOT_WRITTEN";
+    /** Written as the nearest value the format allows. */
+    APPROXIMATED: "W_STYLE_APPROXIMATED";
+    /** Per-element values were written but not the rules; importing the file infers them again. */
+    RULES_NOT_KEPT: "W_STYLE_RULES_NOT_KEPT";
+    /** A style was written as its per-element values and lost its editable form, with a reason code. */
+    LAYER_FLATTENED: "W_STYLE_LAYER_FLATTENED";
+    /** The file holds styles that were not imported; import them with the `styles` option. */
+    NOT_IMPORTED: "W_STYLES_NOT_IMPORTED";
+    /** The graph has styles that were not exported; export them with the `styles` option. */
+    NOT_EXPORTED: "W_STYLES_NOT_EXPORTED";
+    /** The styles were read from or built for a different graph; nothing is written. */
+    MISMATCH: "E_STYLES_MISMATCH";
+}>;
+/**
+ * Any style code.
+ * @category Styles
+ */
+export type StyleIssueCode = (typeof STYLE_ISSUE)[keyof typeof STYLE_ISSUE];
+//# sourceMappingURL=codes.d.ts.map

package/dist/src/styles/codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codes.d.ts","sourceRoot":"","sources":["../../../src/styles/codes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;GAIG;AACH,eAAO,MAAM,WAAW;IAEpB,yDAAyD;;IAEzD,6GAA6G;;IAE7G,oFAAoF;;IAEpF,mFAAmF;;IAEnF,8GAA8G;;IAE9G,gDAAgD;;IAEhD,8EAA8E;;IAE9E,2DAA2D;;IAE3D,+CAA+C;;IAE/C,+EAA+E;;IAE/E,mEAAmE;;IAEnE,wDAAwD;;IAExD,iEAAiE;;IAEjE,yFAAyF;;IAEzF,8EAA8E;;IAG9E,8CAA8C;;IAE9C,gEAAgE;;IAEhE,yFAAyF;;IAEzF,wDAAwD;;IAExD,0DAA0D;;IAE1D,kDAAkD;;IAElD,iFAAiF;;IAEjF,4DAA4D;;IAE5D,6FAA6F;;IAE7F,iFAAiF;;IAEjF,gFAAgF;;IAEhF,mGAAmG;;IAEnG,mGAAmG;;IAGnG,sFAAsF;;IAEtF,kFAAkF;;IAElF,4FAA4F;;IAG5F,iGAAiG;;IAGjG,oEAAoE;;IAEpE,sDAAsD;;IAEtD,+FAA+F;;IAE/F,oGAAoG;;IAGpG,0FAA0F;;IAE1F,yFAAyF;;IAEzF,oFAAoF;;EAEtF,CAAC;AAEH;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC"}