@graphty/graph-io 0.3.43 → 0.3.44

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

@@ -0,0 +1,187 @@
+/**
+ * Canonical enumeration values: each dialect's spellings matched against an alias table without regard to case,
+ * spaces or underscores. An unknown value of an open enumeration (shapes, border and line styles, arrows) is kept as
+ * `other:<raw>` and noted; an unknown value of a closed one (weights, positions) gives no value and is noted.
+ */
+import { STYLE_ISSUE } from "../codes.js";
+import { noteAt, scalarText } from "./site.js";
+const SHAPES = {
+    ellipse: [
+        "ellipse",
+        "oval",
+        "circle",
+        "disc",
+        "disk",
+        "point",
+        "doublecircle",
+        "mcircle",
+        "dot",
+        "sphere",
+        "circular",
+    ],
+    rectangle: [
+        "rectangle",
+        "rect",
+        "box",
+        "square",
+        "plaintext",
+        "plain",
+        "record",
+        "msquare",
+        "box3d",
+        "rectangle3d",
+        "component",
+        "tab",
+        "folder",
+        "note",
+        "underline",
+    ],
+    "round-rectangle": [
+        "round-rectangle",
+        "roundrectangle",
+        "roundrect",
+        "rounded",
+        "roundedrectangle",
+        "round-rect",
+        "mrecord",
+        "cut-rectangle",
+        "round-tag",
+        "bottom-round-rectangle",
+    ],
+    triangle: ["triangle", "invtriangle", "round-triangle", "tag"],
+    diamond: ["diamond", "rhombus", "mdiamond", "round-diamond"],
+    pentagon: ["pentagon", "round-pentagon"],
+    hexagon: ["hexagon", "hexagon2", "round-hexagon", "concave-hexagon", "septagon", "heptagon", "round-heptagon"],
+    octagon: ["octagon", "doubleoctagon", "tripleoctagon", "round-octagon", "octagon2"],
+    parallelogram: ["parallelogram", "parallelogram2", "rhomboid", "fat-arrow", "fatarrow"],
+    trapezoid: ["trapezoid", "trapezoid2", "invtrapezoid", "trapezium", "round-trapezoid"],
+    star: ["star", "star5", "star6", "star8", "polygon"],
+    vee: ["vee", "v"],
+    none: ["none", "empty", "invis"],
+};
+const BORDER_STYLES = {
+    solid: ["solid", "line"],
+    dashed: ["dashed", "dash", "equal-dash"],
+    dotted: ["dotted", "dot", "dots"],
+    "dash-dot": ["dash-dot", "dashdot", "dashed-dotted"],
+    double: ["double", "parallel-lines"],
+};
+const LINE_STYLES = {
+    solid: ["solid", "line", "continuous", "separate-arrow"],
+    dashed: ["dashed", "dash", "dashed-line", "equal-dash"],
+    dotted: ["dotted", "dot", "dots", "dotted-line"],
+    "dash-dot": ["dash-dot", "dashdot", "dashed-dotted", "dash-dot-dot"],
+    "long-dash": ["long-dash", "longdash"],
+    double: ["double", "parallel", "parallel-lines"],
+    zigzag: ["zigzag"],
+    sinewave: ["sinewave", "sine-wave"],
+};
+const ARROWS = {
+    none: ["none", "no-arrow", "noarrow", "0"],
+    triangle: [
+        "triangle",
+        "normal",
+        "delta",
+        "standard",
+        "arrow",
+        "triangle-backcurve",
+        "white-delta-inverted",
+        "simple",
+        "short",
+        "plain",
+        "convex",
+        "a",
+    ],
+    "triangle-open": ["triangle-open", "onormal", "empty", "white-delta", "transparent-circle-inverted", "open-delta"],
+    vee: ["vee", "open", "chevron", "concave", "triangle-cross", "b"],
+    tee: ["tee", "t", "t-shape", "half-bottom", "half-top", "bar"],
+    diamond: ["diamond", "white-diamond-inverted"],
+    "diamond-open": ["diamond-open", "odiamond", "white-diamond", "ediamond", "open-diamond"],
+    circle: ["circle", "dot", "transparent-circle", "white-circle-inverted"],
+    "circle-open": ["circle-open", "odot", "white-circle", "open-circle"],
+    square: ["square", "box", "skewed-dash"],
+    // An X-shaped "cross" (yEd, yFiles) is not a crow's foot: it stays other:cross.
+    crow: ["crow", "crows-foot", "crows-foot-many"],
+    half: ["half", "half-top-arrow", "half-open", "lnormal", "rnormal", "halfopen"],
+    inverted: ["inverted", "inv", "inverted-triangle", "inv-triangle"],
+};
+const WEIGHTS = {
+    normal: ["normal", "regular", "plain", "lighter", "100", "200", "300", "400", "500"],
+    bold: ["bold", "bolder", "600", "700", "800", "900"],
+};
+const POSITIONS = {
+    center: ["center", "centre", "middle", "c"],
+    top: ["top", "north", "t"],
+    bottom: ["bottom", "south", "b"],
+    left: ["left", "west", "l"],
+    right: ["right", "east", "r"],
+    "top-left": ["top-left", "north-west", "northwest"],
+    "top-right": ["top-right", "north-east", "northeast"],
+    "bottom-left": ["bottom-left", "south-west", "southwest"],
+    "bottom-right": ["bottom-right", "south-east", "southeast"],
+};
+/** vis-network draws these spellings differently from the common reading. */
+const VIS = {
+    shape: {
+        "round-rectangle": ["box"],
+        ellipse: ["dot"],
+        triangle: ["triangledown"],
+        none: ["text"],
+    },
+    arrow: { inverted: ["inv-triangle"], square: ["box"] },
+};
+/** Per-dialect overrides; a dialect not listed reads the common table alone. */
+const OVERRIDES = new Map([["vis", VIS]]);
+const OPEN = new Set(["shape", "borderStyle", "lineStyle", "arrow"]);
+/**
+ * Builds an alias lookup.
+ * @param aliases - canonical value to spellings
+ * @returns spelling to canonical value
+ */
+function lookup(aliases) {
+    const map = new Map();
+    for (const [value, spellings] of Object.entries(aliases)) {
+        for (const spelling of spellings) {
+            map.set(spelling, value);
+        }
+    }
+    return map;
+}
+const COMMON = new Map([
+    ["shape", lookup(SHAPES)],
+    ["borderStyle", lookup(BORDER_STYLES)],
+    ["lineStyle", lookup(LINE_STYLES)],
+    ["arrow", lookup(ARROWS)],
+    ["weight", lookup(WEIGHTS)],
+    ["position", lookup(POSITIONS)],
+]);
+const DIALECT = new Map(Array.from(OVERRIDES, ([dialect, kinds]) => [
+    dialect,
+    new Map(Object.entries(kinds).map(([kind, aliases]) => [kind, lookup(aliases)])),
+]));
+/**
+ * A canonical enumeration value: the dialect's spelling matched without regard to case, with spaces and underscores
+ * read as hyphens (Cytoscape's `ROUND_RECTANGLE` is `round-rectangle`). An unknown value is `other:<raw>` for an
+ * open enumeration and null for a closed one, noted as `W_STYLE_UNKNOWN_VALUE` either way.
+ * @param kind - the enumeration
+ * @param raw - the file's value
+ * @param dialect - the file's dialect
+ * @param site - where it was read
+ * @returns the canonical value, or null
+ * @category Styles
+ */
+export function canonEnum(kind, raw, dialect, site) {
+    const text = scalarText(raw, site);
+    if (text === null) {
+        return null;
+    }
+    const trimmed = text.trim();
+    const key = trimmed.toLowerCase().replaceAll(/[\s_]+/g, "-");
+    const value = DIALECT.get(dialect)?.get(kind)?.get(key) ?? COMMON.get(kind)?.get(key);
+    if (value !== undefined) {
+        return value;
+    }
+    noteAt(site, STYLE_ISSUE.UNKNOWN_VALUE, trimmed);
+    return OPEN.has(kind) ? `other:${trimmed}` : null;
+}
+//# sourceMappingURL=enums.js.map

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

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

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

@@ -0,0 +1,48 @@
+/**
+ * Graphviz's own color resolution, measured against `dot` 2.43 with `-Txdot`:
+ *
+ * - Leading blanks are skipped and trailing ones are not (`"red  "` is unknown); names match without regard to case
+ *   and keep their inner spaces (`Light Grey` is unknown).
+ * - `#rrggbb` and `#rrggbbaa` only, with anything after the digits ignored; there is no 3-digit form.
+ * - Three numbers starting with a digit or a point (`.5 .5 .5`, `0.5,0.5,0.5`) are hue, saturation and value, each
+ *   clamped to 0..1 and truncated to a byte; a fourth number and anything after it are ignored. A leading sign makes
+ *   the value a name, so `-0.5 0.5 0.5` is unknown.
+ * - `/scheme/name` names a scheme for one value and `//name` means the object's scheme; scheme names ignore case. A
+ *   scheme other than `x11` is searched INSTEAD of X11: `colorscheme=blues9` makes `red` unknown, and an unknown
+ *   scheme knows no names at all.
+ * - `transparent`, `none` and `invis` are `#fffffe` with alpha 0, whatever the scheme.
+ * - An unknown color is drawn BLACK.
+ * - A color list (`red:blue`, `red;0.3:blue`): an outline or a font color draws the text before the first `:` as one
+ *   color, so `red:blue` is red and `red;0.3:blue` is black (`red;0.3` is not a color). A fill draws a gradient and
+ *   an edge draws one line per color; both start with the first entry's color, its `;fraction` dropped. A value
+ *   with a `;` and no `:` is not a list: it is one unknown color, drawn black.
+ */
+/**
+ * How Graphviz draws a color value, which decides how a color list is read.
+ * @category Styles
+ */
+export type GraphvizColorUse = "line" | "fill" | "edge";
+/**
+ * A resolved Graphviz color, with how it was read.
+ * @category Styles
+ */
+export interface GraphvizColor {
+    /** `#rrggbb`. */
+    readonly hex: string;
+    /** 0..1. */
+    readonly alpha: number;
+    /** The value did not resolve, so Graphviz draws black. */
+    readonly unknown: boolean;
+    /** The value is a list read as its first color: a gradient for a fill, parallel lines for an edge. */
+    readonly list: "gradient" | "lines" | null;
+}
+/**
+ * Resolves a Graphviz color value the way Graphviz draws it for a use; an unknown color is black.
+ * @param raw - the value, at most 256 characters
+ * @param scheme - the object's `colorscheme`, or null
+ * @param use - an outline or font color (`line`), a fill, or an edge's line color
+ * @returns the color and how it was read
+ * @category Styles
+ */
+export declare function graphvizColor(raw: string, scheme: string | null, use: GraphvizColorUse): GraphvizColor;
+//# sourceMappingURL=graphviz.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graphviz.d.ts","sourceRoot":"","sources":["../../../../src/styles/canon/graphviz.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC1B,iBAAiB;IACjB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,YAAY;IACZ,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,sGAAsG;IACtG,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,IAAI,CAAC;CAC9C;AAwHD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,gBAAgB,GAAG,aAAa,CAmBtG"}

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

@@ -0,0 +1,160 @@
+/**
+ * Graphviz's own color resolution, measured against `dot` 2.43 with `-Txdot`:
+ *
+ * - Leading blanks are skipped and trailing ones are not (`"red  "` is unknown); names match without regard to case
+ *   and keep their inner spaces (`Light Grey` is unknown).
+ * - `#rrggbb` and `#rrggbbaa` only, with anything after the digits ignored; there is no 3-digit form.
+ * - Three numbers starting with a digit or a point (`.5 .5 .5`, `0.5,0.5,0.5`) are hue, saturation and value, each
+ *   clamped to 0..1 and truncated to a byte; a fourth number and anything after it are ignored. A leading sign makes
+ *   the value a name, so `-0.5 0.5 0.5` is unknown.
+ * - `/scheme/name` names a scheme for one value and `//name` means the object's scheme; scheme names ignore case. A
+ *   scheme other than `x11` is searched INSTEAD of X11: `colorscheme=blues9` makes `red` unknown, and an unknown
+ *   scheme knows no names at all.
+ * - `transparent`, `none` and `invis` are `#fffffe` with alpha 0, whatever the scheme.
+ * - An unknown color is drawn BLACK.
+ * - A color list (`red:blue`, `red;0.3:blue`): an outline or a font color draws the text before the first `:` as one
+ *   color, so `red:blue` is red and `red;0.3:blue` is black (`red;0.3` is not a color). A fill draws a gradient and
+ *   an edge draws one line per color; both start with the first entry's color, its `;fraction` dropped. A value
+ *   with a `;` and no `:` is not a list: it is one unknown color, drawn black.
+ */
+import { BREWER_SCHEMES, CSS_COLORS, X11_COLORS } from "./color-tables.js";
+const TRANSPARENT = new Set(["transparent", "none", "invis"]);
+const HSV_PART = /^(?:\d+(?:\.\d*)?|\.\d+)(?:[eE][+-]?\d+)?$/;
+/**
+ * A byte as two hex digits.
+ * @param v - 0..255
+ * @returns two lowercase hex digits
+ */
+function hex2(v) {
+    return v.toString(16).padStart(2, "0");
+}
+/**
+ * Graphviz's HSV to RGB, channels truncated to bytes.
+ * @param h - hue 0..1
+ * @param s - saturation 0..1
+ * @param v - value 0..1
+ * @returns `#rrggbb`
+ */
+function hsvHex(h, s, v) {
+    const i = Math.floor(h * 6);
+    const f = h * 6 - i;
+    const p = v * (1 - s);
+    const q = v * (1 - f * s);
+    const t = v * (1 - (1 - f) * s);
+    const rgb = [
+        [v, t, p],
+        [q, v, p],
+        [p, v, t],
+        [p, q, v],
+        [t, p, v],
+        [v, p, q],
+    ][i % 6];
+    return `#${rgb.map((c) => hex2(Math.trunc(c * 255))).join("")}`;
+}
+/**
+ * Resolves one Graphviz color (no list), or null when Graphviz does not know it.
+ * @param text - the color, leading blanks already skipped
+ * @param scheme - the object's color scheme, lowercase, `x11` when unset
+ * @returns hex and alpha, or null
+ */
+function resolveOne(text, scheme) {
+    if (text.startsWith("#")) {
+        const m = /^#([0-9a-fA-F]{2})([0-9a-fA-F]{2})([0-9a-fA-F]{2})([0-9a-fA-F]{1,2})?/.exec(text);
+        if (m === null) {
+            return null;
+        }
+        return {
+            hex: `#${m[1]}${m[2]}${m[3]}`.toLowerCase(),
+            alpha: m[4] === undefined ? 1 : Number.parseInt(m[4], 16) / 255,
+        };
+    }
+    const hsv = /^[.\d]/.test(text) ? hsvColor(text) : null;
+    if (hsv !== null) {
+        return { hex: hsv, alpha: 1 };
+    }
+    const named = schemedName(text.toLowerCase(), scheme);
+    if (named === null) {
+        return null;
+    }
+    if (TRANSPARENT.has(named.name)) {
+        return { hex: "#fffffe", alpha: 0 };
+    }
+    const hex = schemeColor(named.name, named.scheme);
+    return hex === undefined ? null : { hex, alpha: 1 };
+}
+/**
+ * An HSV color: three numbers 0..1 separated by blanks or commas, clamped.
+ * @param text - the color
+ * @returns `#rrggbb`, or null when it is not one
+ */
+function hsvColor(text) {
+    const parts = text.split(/[ ,]+/);
+    if (parts.length < 3 || !parts.slice(0, 3).every((p) => HSV_PART.test(p))) {
+        return null;
+    }
+    const [h, s, v] = parts.slice(0, 3).map((p) => Math.min(1, Math.max(0, Number(p))));
+    return hsvHex(h, s, v);
+}
+/**
+ * A color name and the scheme it is looked up in: `/scheme/name` names its own scheme, `//name` the object's.
+ * @param name - the name, lowercase
+ * @param scheme - the object's color scheme
+ * @returns the name and scheme, or null for a malformed `/scheme/name`
+ */
+function schemedName(name, scheme) {
+    if (!name.startsWith("/")) {
+        return { name, scheme };
+    }
+    const slash = name.indexOf("/", 1);
+    if (slash < 0) {
+        return null;
+    }
+    const prefix = name.slice(1, slash);
+    return { name: name.slice(slash + 1), scheme: prefix === "" ? scheme : prefix };
+}
+/**
+ * A color in a scheme: X11's or SVG's names, or a Brewer scheme's colors by their 1-based index.
+ * @param name - the name or index
+ * @param scheme - the scheme
+ * @returns `#rrggbb`, or undefined when the scheme has no such color
+ */
+function schemeColor(name, scheme) {
+    if (scheme === "x11") {
+        return X11_COLORS.get(name);
+    }
+    if (scheme === "svg") {
+        return CSS_COLORS.get(name);
+    }
+    const colors = BREWER_SCHEMES.get(scheme);
+    const index = /^\d{1,3}$/.test(name) ? Number(name) : 0;
+    return colors !== undefined && index >= 1 ? colors[index - 1] : undefined;
+}
+/**
+ * Resolves a Graphviz color value the way Graphviz draws it for a use; an unknown color is black.
+ * @param raw - the value, at most 256 characters
+ * @param scheme - the object's `colorscheme`, or null
+ * @param use - an outline or font color (`line`), a fill, or an edge's line color
+ * @returns the color and how it was read
+ * @category Styles
+ */
+export function graphvizColor(raw, scheme, use) {
+    let text = raw.replace(/^[ \t\r\n]+/, "");
+    let list = null;
+    const colon = text.indexOf(":");
+    if (colon >= 0) {
+        text = text.slice(0, colon);
+        if (use !== "line") {
+            const semi = text.indexOf(";");
+            if (semi >= 0) {
+                text = text.slice(0, semi);
+            }
+            list = use === "fill" ? "gradient" : "lines";
+        }
+    }
+    const sc = scheme === null || scheme.trim() === "" ? "x11" : scheme.toLowerCase();
+    const resolved = text === "" ? null : resolveOne(text, sc);
+    return resolved === null
+        ? { hex: "#000000", alpha: 1, unknown: true, list }
+        : { hex: resolved.hex, alpha: resolved.alpha, unknown: false, list };
+}
+//# sourceMappingURL=graphviz.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * Canonical style values: every reader turns a file's raw value into one spelling per property before anything
+ * compares values. Colors are `#rrggbb` with the alpha moved to an opacity, numbers have 6 significant digits,
+ * enumerations come from the neutral vocabulary, and text is what the tool draws.
+ */
+export * from "./bends.js";
+export * from "./color.js";
+export * from "./enums.js";
+export { type GraphvizColor, graphvizColor, type GraphvizColorUse } from "./graphviz.js";
+export * from "./number.js";
+export { type CanonSite, MAX_STYLE_VALUE_LENGTH } from "./site.js";
+export * from "./text.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/styles/canon/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACzF,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAE,KAAK,SAAS,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnE,cAAc,WAAW,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Canonical style values: every reader turns a file's raw value into one spelling per property before anything
+ * compares values. Colors are `#rrggbb` with the alpha moved to an opacity, numbers have 6 significant digits,
+ * enumerations come from the neutral vocabulary, and text is what the tool draws.
+ */
+export * from "./bends.js";
+export * from "./color.js";
+export * from "./enums.js";
+export { graphvizColor } from "./graphviz.js";
+export * from "./number.js";
+export { MAX_STYLE_VALUE_LENGTH } from "./site.js";
+export * from "./text.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/styles/canon/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAsB,aAAa,EAAyB,MAAM,eAAe,CAAC;AACzF,cAAc,aAAa,CAAC;AAC5B,OAAO,EAAkB,sBAAsB,EAAE,MAAM,WAAW,CAAC;AACnE,cAAc,WAAW,CAAC"}

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

@@ -0,0 +1,59 @@
+/**
+ * Canonical numbers, lengths, opacities and booleans: 6 significant digits, never negative, never NaN or Infinity.
+ */
+import type { StyleDialect } from "../types.js";
+import { type CanonSite } 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 declare const MAX_STYLE_NUMBER = 1000000;
+/**
+ * Points per inch: DOT gives node sizes in inches, and a canonical length is in points (pixels at 72 dpi).
+ * @category Styles
+ */
+export declare const DOT_POINTS_PER_INCH = 72;
+/**
+ * A number at 6 significant digits, with `-0` as `0`.
+ * @param value - a finite number
+ * @returns the canonical number
+ * @category Styles
+ */
+export declare function num6(value: number): number;
+/**
+ * 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 declare function canonNumber(raw: unknown, site: CanonSite, factor?: number): number | null;
+/**
+ * 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 declare function canonOpacity(raw: unknown, dialect: StyleDialect, site: CanonSite): number | null;
+/**
+ * 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 declare function canonBoolean(raw: unknown, site: CanonSite): boolean | null;
+/**
+ * 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 declare function styleLengthUnit(dialect: StyleDialect): "px" | "relative";
+//# sourceMappingURL=number.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"number.d.ts","sourceRoot":"","sources":["../../../../src/styles/canon/number.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,KAAK,SAAS,EAA+B,MAAM,WAAW,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,UAAM,CAAC;AAEpC;;;GAGG;AACH,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAKtC;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE1C;AA+BD;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,SAAI,GAAG,MAAM,GAAG,IAAI,CAWpF;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAWhG;AAcD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,IAAI,CAe1E;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,GAAG,UAAU,CAExE"}