@graphty/graph-io 0.3.43 → 0.3.44

package/dist/src/styles/cytoscape/resolve.d.ts

@@ -0,0 +1,137 @@
+/**
+ * Cytoscape's own resolution of a visual style, per element: a bypass over a mapping over a default, per visual
+ * property, with the dependencies applied (`nodeSizeLocked` makes `NODE_SIZE` drive width and height,
+ * `arrowColorMatchesEdge` makes the edge's paint drive the line and both arrows). Every pass is linear in the number
+ * of elements plus the size of the style, and spends from the extraction's one budget.
+ */
+import type { CanonSite } from "../canon/site.js";
+import { StyleNotes } from "../notes.js";
+import type { ContinuousPoint, Scalar, StyleColor, StyleColumn, StyleTarget, StyleTool, StyleValue, StyleWorkBudget } from "../types.js";
+import { type CytoscapeValueParser } from "./lexicon.js";
+import { type CytoscapeMapping, type CytoscapeStyle, type CytoscapeTargetStyle } from "./mappings.js";
+/**
+ * One element's bypasses: visual property name to raw value; null or undefined when it has none.
+ * @category Styles
+ */
+export type CytoscapeBypass = ReadonlyMap<string, unknown> | null | undefined;
+/**
+ * The elements of one target a style is resolved over.
+ * @category Styles
+ */
+export interface CytoscapeElements {
+    /** How many elements there are. */
+    readonly count: number;
+    /**
+     * An element's value of an attribute column (a list attribute as an array), or null.
+     * @param column - the column's name
+     * @param i - the element index
+     * @returns the value
+     */
+    value(column: string, i: number): unknown;
+    /** Each element's bypasses, by element index. */
+    readonly bypasses?: readonly CytoscapeBypass[];
+}
+/**
+ * Options of `resolveCytoscape()`.
+ * @category Styles
+ */
+export interface CytoscapeResolveOptions {
+    /** Where problems are noted. */
+    readonly notes?: StyleNotes;
+    /** The counted work budget. */
+    readonly budget?: StyleWorkBudget;
+    /**
+     * Whose defaults fill what the style leaves unset: `"cytoscape"` (the desktop's default visual style, for CX,
+     * CX2 and XGMML), `"cytoscape-fallbacks"` (the renderer's fallbacks, for sessions) or null for none, so an
+     * element the style says nothing about is null. Defaults to null.
+     */
+    readonly defaults?: StyleTool | null;
+}
+/** A visual property and the parser that reads it for one neutral property. */
+type VpChoice = readonly [vp: string, parse: CytoscapeValueParser];
+/**
+ * Which visual properties a style or its bypasses mention.
+ * @param style - the target's style
+ * @param bypasses - the elements' bypasses
+ * @returns the names used anywhere, and those used by a bypass
+ */
+export declare function vpUsage(style: CytoscapeTargetStyle, bypasses: readonly CytoscapeBypass[]): {
+    used: Set<string>;
+    bypassed: Set<string>;
+};
+/**
+ * Which visual property sets each neutral property: the first of its lexicon list the style or any bypass
+ * mentions, with the dependencies applied.
+ * @param target - nodes or edges
+ * @param style - the target's style
+ * @param used - the visual properties used anywhere
+ * @returns property to its visual property and parser
+ */
+export declare function chooseVps(target: StyleTarget, style: CytoscapeTargetStyle, used: ReadonlySet<string>): Map<string, VpChoice>;
+/**
+ * A mapping with its values read for one property.
+ * @category Styles
+ */
+export type ParsedMapping = {
+    readonly kind: "passthrough";
+    readonly column: string;
+} | {
+    readonly kind: "discrete";
+    readonly column: string;
+    readonly table: readonly (readonly [Scalar, StyleValue])[];
+} | {
+    readonly kind: "continuous";
+    readonly column: string;
+    readonly points: readonly ContinuousPoint[];
+};
+/**
+ * Reads a mapping's raw values with a property's parser: table entries and points whose values do not parse are
+ * dropped (and noted), points are sorted, and of two points at the same value the later one wins.
+ * @param m - the mapping
+ * @param parse - the property's parser
+ * @param site - where problems are noted
+ * @returns the mapping with canonical values
+ */
+export declare function parseMapping(m: CytoscapeMapping, parse: CytoscapeValueParser, site: CanonSite): ParsedMapping;
+/**
+ * Every element's value per neutral property under a Cytoscape style, the way Cytoscape draws it: per visual
+ * property a bypass, else the mapping's value, else the default; `nodeSizeLocked` and `arrowColorMatchesEdge`
+ * applied. `EDGE_CURVED` only rounds an edge's bends, so an edge without bends is `curved: false`. Visual properties
+ * no neutral property carries are noted as `W_STYLE_NOT_CARRIED`.
+ * @param target - nodes or edges
+ * @param style - the style
+ * @param elements - the elements, their attribute values and their bypasses
+ * @param options - notes, the budget and whose defaults fill what the style leaves unset
+ * @returns per property, each element's value (null where nothing gives one)
+ * @category Styles
+ */
+export declare function resolveCytoscape(target: StyleTarget, style: CytoscapeStyle, elements: CytoscapeElements, options?: CytoscapeResolveOptions): Partial<Record<string, StyleColumn>>;
+/** An edge's bend handles. */
+export declare const EDGE_BEND_VP = "EDGE_BEND";
+/**
+ * Whether an `EDGE_BEND` value holds any handle: Cytoscape writes an edge without bends as an empty string.
+ * @param raw - the value
+ * @returns true when the edge bends
+ */
+export declare const bendParser: CytoscapeValueParser;
+/**
+ * The style's network background color (`NETWORK_BACKGROUND_PAINT`, CX2's `NETWORK_BACKGROUND_COLOR`).
+ * @param style - the style
+ * @param notes - where a bad value is noted
+ * @returns the color, or null
+ * @category Styles
+ */
+export declare function cytoscapeBackground(style: CytoscapeStyle, notes?: StyleNotes): StyleColor | null;
+/**
+ * Every element's values when each element carries its own resolved visual properties and no style (XGMML files
+ * and Cytoscape 2.x sessions). Width and height are read from `NODE_SIZE` when no element states them; keys with no
+ * visual property name (`?<key>` from `normalizeVisualProperties()`) are noted as `W_STYLE_NOT_CARRIED`.
+ * @param target - nodes or edges
+ * @param maps - each element's visual properties
+ * @param options - notes, the budget and whose defaults fill what is unset
+ * @returns per property, each element's value
+ * @category Styles
+ */
+export declare function resolveCytoscapeBypasses(target: StyleTarget, maps: readonly CytoscapeBypass[], options?: CytoscapeResolveOptions): Partial<Record<string, StyleColumn>>;
+export {};
+//# sourceMappingURL=resolve.d.ts.map

package/dist/src/styles/cytoscape/resolve.d.ts.map

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

package/dist/src/styles/cytoscape/resolve.js

@@ -0,0 +1,381 @@
+/**
+ * Cytoscape's own resolution of a visual style, per element: a bypass over a mapping over a default, per visual
+ * property, with the dependencies applied (`nodeSizeLocked` makes `NODE_SIZE` drive width and height,
+ * `arrowColorMatchesEdge` makes the edge's paint drive the line and both arrows). Every pass is linear in the number
+ * of elements plus the size of the style, and spends from the extraction's one budget.
+ */
+import { STYLE_ISSUE } from "../codes.js";
+import { toolDefaults } from "../defaults.js";
+import { StyleNotes } from "../notes.js";
+import { discreteLookup, evalContinuous, numberOf } from "../plan/resolve.js";
+import { isStyleValue } from "../vocabulary.js";
+import { colorParser, CYTOSCAPE_LEXICON, isUncarriedVp, NODE_SIZE_VP, sizeParser, } from "./lexicon.js";
+import { emptyCytoscapeStyle, } from "./mappings.js";
+/** Locked node sizes with no `NODE_SIZE` anywhere draw at Cytoscape's lexicon default. */
+const NODE_SIZE_FALLBACK = 50;
+/**
+ * Which visual properties a style or its bypasses mention.
+ * @param style - the target's style
+ * @param bypasses - the elements' bypasses
+ * @returns the names used anywhere, and those used by a bypass
+ */
+export function vpUsage(style, bypasses) {
+    const bypassed = new Set();
+    for (const b of bypasses) {
+        if (b) {
+            for (const k of b.keys()) {
+                bypassed.add(k);
+            }
+        }
+    }
+    for (const [from, to] of style.bypassAliases) {
+        if (bypassed.has(from)) {
+            bypassed.add(to);
+        }
+    }
+    const used = new Set([...style.defaults.keys(), ...style.mappings.keys(), ...bypassed]);
+    return { used, bypassed };
+}
+/**
+ * Which visual property sets each neutral property: the first of its lexicon list the style or any bypass
+ * mentions, with the dependencies applied.
+ * @param target - nodes or edges
+ * @param style - the target's style
+ * @param used - the visual properties used anywhere
+ * @returns property to its visual property and parser
+ */
+export function chooseVps(target, style, used) {
+    const chosen = new Map();
+    for (const [prop, list] of CYTOSCAPE_LEXICON[target]) {
+        const hit = list.find(([vp]) => used.has(vp));
+        if (hit !== undefined) {
+            chosen.set(prop, hit);
+        }
+    }
+    if (target === "node" && style.dependencies.get("nodeSizeLocked") === true) {
+        chosen.delete("width");
+        chosen.delete("height");
+    }
+    if (target === "edge" && style.dependencies.get("arrowColorMatchesEdge") === true) {
+        if (used.has("EDGE_UNSELECTED_PAINT")) {
+            chosen.set("color", ["EDGE_UNSELECTED_PAINT", colorParser]);
+        }
+        chosen.delete("sourceArrowColor");
+        chosen.delete("targetArrowColor");
+    }
+    return chosen;
+}
+/**
+ * Reads a mapping's raw values with a property's parser: table entries and points whose values do not parse are
+ * dropped (and noted), points are sorted, and of two points at the same value the later one wins.
+ * @param m - the mapping
+ * @param parse - the property's parser
+ * @param site - where problems are noted
+ * @returns the mapping with canonical values
+ */
+export function parseMapping(m, parse, site) {
+    switch (m.kind) {
+        case "passthrough":
+            return { kind: "passthrough", column: m.column };
+        case "discrete": {
+            const table = [];
+            for (const [k, raw] of m.table) {
+                const v = parse(raw, site);
+                if (v !== null) {
+                    table.push([k, v]);
+                }
+            }
+            return { kind: "discrete", column: m.column, table };
+        }
+        default:
+            return { kind: "continuous", column: m.column, points: parsePoints(m.points, parse, site) };
+    }
+}
+/**
+ * A continuous mapping's points with canonical values: points whose values do not parse are dropped (and noted),
+ * points are sorted, and of two points at the same value the later one wins.
+ * @param raw - the points
+ * @param parse - the property's parser
+ * @param site - where problems are noted
+ * @returns the points
+ */
+function parsePoints(raw, parse, site) {
+    const parsed = [];
+    for (const p of raw) {
+        const below = parse(p.below, site);
+        const value = parse(p.value, site);
+        const above = parse(p.above, site);
+        if (below !== null && value !== null && above !== null) {
+            parsed.push({ at: p.at, below, value, above });
+        }
+    }
+    parsed.sort((a, b) => a.at - b.at);
+    const points = [];
+    for (const p of parsed) {
+        if (points.at(-1)?.at === p.at) {
+            points[points.length - 1] = p;
+        }
+        else {
+            points.push(p);
+        }
+    }
+    return points;
+}
+/**
+ * One mapping evaluated for one element's attribute value.
+ * @param m - the parsed mapping
+ * @param value - the element's value
+ * @param parse - the property's parser, for a passthrough
+ * @param site - where problems are noted
+ * @returns the value, or null when the mapping gives none
+ */
+function evalMapping(m, value, parse, site) {
+    if (value === null || value === undefined) {
+        return null;
+    }
+    switch (m.kind) {
+        case "passthrough":
+            return Array.isArray(value) ? null : parse(value, site);
+        case "discrete": {
+            const j = discreteLookup(m.table)(value);
+            return j < 0 ? null : m.table[j][1];
+        }
+        default:
+            return evalContinuous(m.points, numberOf(value));
+    }
+}
+/**
+ * Builds the per-element reader of one target's style.
+ * @param target - nodes or edges
+ * @param style - the target's style
+ * @param elements - the elements
+ * @param notes - where problems are noted
+ * @param budget - the work budget
+ * @returns the reader
+ */
+function resolver(target, style, elements, notes, budget) {
+    const bypasses = elements.bypasses ?? [];
+    const parsed = new Map();
+    const ruleSite = (property) => ({ notes, target, property, budget });
+    const bypass = (i, vp) => {
+        const b = bypasses[i];
+        if (!b) {
+            return undefined;
+        }
+        const v = b.get(vp);
+        if (v !== undefined && v !== null) {
+            return v;
+        }
+        for (const [from, to] of style.bypassAliases) {
+            if (to === vp && !b.has(to)) {
+                return b.get(from);
+            }
+        }
+        return undefined;
+    };
+    // a mapping parsed once per visual property and neutral property
+    const mappingOf = (vp, parse, property) => {
+        const raw = style.mappings.get(vp);
+        if (raw === undefined) {
+            return undefined;
+        }
+        const key = `${vp}\u0000${property}`;
+        let m = parsed.get(key);
+        if (m === undefined) {
+            const entries = raw.kind === "discrete" ? raw.table.length : 0;
+            budget?.spend(target, 1 + entries + (raw.kind === "continuous" ? raw.points.length : 0));
+            m = parseMapping(raw, parse, ruleSite(property));
+            parsed.set(key, m);
+        }
+        return m;
+    };
+    const one = (vp, parse, property, i) => {
+        const site = { notes, target, property, element: i, budget };
+        const b = bypass(i, vp);
+        const fromBypass = b === undefined || b === null ? null : parse(b, site);
+        if (fromBypass !== null) {
+            return fromBypass;
+        }
+        const m = mappingOf(vp, parse, property);
+        const mapped = m === undefined ? null : evalMapping(m, elements.value(m.column, i), parse, site);
+        if (mapped !== null) {
+            return mapped;
+        }
+        return style.defaults.has(vp) ? parse(style.defaults.get(vp), ruleSite(property)) : null;
+    };
+    return { bypass, one };
+}
+/**
+ * Every element's value per neutral property under a Cytoscape style, the way Cytoscape draws it: per visual
+ * property a bypass, else the mapping's value, else the default; `nodeSizeLocked` and `arrowColorMatchesEdge`
+ * applied. `EDGE_CURVED` only rounds an edge's bends, so an edge without bends is `curved: false`. Visual properties
+ * no neutral property carries are noted as `W_STYLE_NOT_CARRIED`.
+ * @param target - nodes or edges
+ * @param style - the style
+ * @param elements - the elements, their attribute values and their bypasses
+ * @param options - notes, the budget and whose defaults fill what the style leaves unset
+ * @returns per property, each element's value (null where nothing gives one)
+ * @category Styles
+ */
+export function resolveCytoscape(target, style, elements, options = {}) {
+    const notes = options.notes ?? new StyleNotes();
+    const s = style[target];
+    const n = elements.count;
+    const { used, bypassed } = vpUsage(s, elements.bypasses ?? []);
+    const chosen = chooseVps(target, s, used);
+    const { one } = resolver(target, s, elements, notes, options.budget);
+    const out = {};
+    const column = (vp, parse, property) => {
+        options.budget?.spend(target, n);
+        const values = new Array(n);
+        for (let i = 0; i < n; i++) {
+            values[i] = one(vp, parse, property, i);
+        }
+        return values;
+    };
+    for (const [prop, [vp, parse]] of chosen) {
+        out[prop] = column(vp, parse, prop);
+    }
+    if (target === "node" && s.dependencies.get("nodeSizeLocked") === true) {
+        const size = column(NODE_SIZE_VP, sizeParser, "width").map((v) => v ?? NODE_SIZE_FALLBACK);
+        out.width = size;
+        out.height = size.slice();
+    }
+    if (target === "edge" && s.dependencies.get("arrowColorMatchesEdge") === true && out.color !== undefined) {
+        out.sourceArrowColor = out.color.slice();
+        out.targetArrowColor = out.color.slice();
+    }
+    noteUncarried(target, s, used, bypassed, notes);
+    fillToolDefaults(target, out, n, options.defaults ?? null);
+    if (target === "edge") {
+        straightenBendless(out, one);
+    }
+    return out;
+}
+/**
+ * Marks straight every curved edge without bends: `EDGE_CURVED` only rounds the bends an edge has.
+ * @param out - the values per property, changed in place
+ * @param one - reads one visual property of one element
+ */
+function straightenBendless(out, one) {
+    const { curved } = out;
+    if (curved !== undefined) {
+        out.curved = curved.map((c, i) => (c === true ? one(EDGE_BEND_VP, bendParser, "curved", i) === true : c));
+    }
+}
+/** An edge's bend handles. */
+export const EDGE_BEND_VP = "EDGE_BEND";
+/**
+ * Whether an `EDGE_BEND` value holds any handle: Cytoscape writes an edge without bends as an empty string.
+ * @param raw - the value
+ * @returns true when the edge bends
+ */
+export const bendParser = (raw) => {
+    if (typeof raw === "string") {
+        const text = raw.trim();
+        return text !== "" && text !== '""';
+    }
+    return Array.isArray(raw) ? raw.length > 0 : raw !== null && raw !== undefined && typeof raw === "object";
+};
+/** Default values that mean "nothing drawn": a VP left at one of these is not worth a note. */
+const INERT_DEFAULT = /NullCustomGraphics|^255$|^0(?:\.0+)?$|^$|^C,C,c,0\.00,0\.00$|^false$/;
+/**
+ * Notes every visual property the style uses that no neutral property carries.
+ * @param target - nodes or edges
+ * @param s - the target's style
+ * @param used - the visual properties used anywhere
+ * @param bypassed - those used by a bypass
+ * @param notes - where to note
+ */
+function noteUncarried(target, s, used, bypassed, notes) {
+    for (const vp of used) {
+        if (!isUncarriedVp(vp)) {
+            continue;
+        }
+        const d = s.defaults.get(vp);
+        const text = typeof d === "string" || typeof d === "number" || typeof d === "boolean" ? String(d) : "";
+        if (INERT_DEFAULT.test(text.slice(0, 64)) && !s.mappings.has(vp) && !bypassed.has(vp)) {
+            continue;
+        }
+        notes.add(STYLE_ISSUE.NOT_CARRIED, target, vp, { sample: text });
+    }
+}
+/**
+ * Fills what nothing gave with a tool's defaults.
+ * @param target - nodes or edges
+ * @param out - the values per property
+ * @param n - the element count
+ * @param tool - the tool, or null for none
+ */
+function fillToolDefaults(target, out, n, tool) {
+    const d = tool === null ? null : toolDefaults(tool);
+    if (d === null) {
+        return;
+    }
+    for (const [prop, entry] of Object.entries(d[target])) {
+        if (entry === undefined || !isStyleValue(target, prop, entry.value)) {
+            continue;
+        }
+        const value = entry.value;
+        const values = out[prop] === undefined ? new Array(n).fill(null) : out[prop].slice();
+        for (let i = 0; i < n; i++) {
+            values[i] ?? (values[i] = value);
+        }
+        out[prop] = values;
+    }
+}
+/**
+ * The style's network background color (`NETWORK_BACKGROUND_PAINT`, CX2's `NETWORK_BACKGROUND_COLOR`).
+ * @param style - the style
+ * @param notes - where a bad value is noted
+ * @returns the color, or null
+ * @category Styles
+ */
+export function cytoscapeBackground(style, notes) {
+    const d = style.network.defaults;
+    const raw = d.get("NETWORK_BACKGROUND_PAINT") ?? d.get("NETWORK_BACKGROUND_COLOR");
+    if (raw === undefined) {
+        return null;
+    }
+    const v = colorParser(raw, { notes: notes ?? new StyleNotes(), target: "graph", property: "background" });
+    return typeof v === "string" ? v : null;
+}
+/**
+ * Every element's values when each element carries its own resolved visual properties and no style (XGMML files
+ * and Cytoscape 2.x sessions). Width and height are read from `NODE_SIZE` when no element states them; keys with no
+ * visual property name (`?<key>` from `normalizeVisualProperties()`) are noted as `W_STYLE_NOT_CARRIED`.
+ * @param target - nodes or edges
+ * @param maps - each element's visual properties
+ * @param options - notes, the budget and whose defaults fill what is unset
+ * @returns per property, each element's value
+ * @category Styles
+ */
+export function resolveCytoscapeBypasses(target, maps, options = {}) {
+    const notes = options.notes ?? new StyleNotes();
+    const style = emptyCytoscapeStyle();
+    const elements = { count: maps.length, value: () => null, bypasses: maps };
+    const out = resolveCytoscape(target, style, elements, { notes, budget: options.budget });
+    if (target === "node" && out.width === undefined) {
+        const size = maps.map((m) => {
+            const raw = m?.get(NODE_SIZE_VP);
+            return raw === undefined ? null : sizeParser(raw, { notes, target, property: "width" });
+        });
+        if (size.some((v) => v !== null)) {
+            out.width = size;
+            out.height = size.slice();
+        }
+    }
+    for (const m of maps) {
+        if (!m) {
+            continue;
+        }
+        for (const [k, v] of m) {
+            if (k.startsWith("?")) {
+                notes.add(STYLE_ISSUE.NOT_CARRIED, target, k.slice(1), { sample: v });
+            }
+        }
+    }
+    fillToolDefaults(target, out, maps.length, options.defaults ?? null);
+    return out;
+}
+//# sourceMappingURL=resolve.js.map

package/dist/src/styles/cytoscape/resolve.js.map

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

package/dist/src/styles/cytoscape/translate.d.ts

@@ -0,0 +1,50 @@
+/**
+ * A Cytoscape visual style as neutral rules: the defaults as one rule, then one rule per mapped column and kind.
+ * Cytoscape's precedence (a mapping over a default) becomes rule order. Bypasses are not rules: they are the
+ * per-element exceptions the planner lays on top of these.
+ */
+import { StyleNotes } from "../notes.js";
+import type { ColumnRef, StyleColumn, StyleRule, StyleTarget, StyleWorkBudget } from "../types.js";
+import type { CytoscapeStyle } from "./mappings.js";
+import { type CytoscapeElements } from "./resolve.js";
+/**
+ * Options of `cytoscapeRules()`.
+ * @category Styles
+ */
+export interface CytoscapeTranslateOptions {
+    /** Where problems are noted. */
+    readonly notes?: StyleNotes;
+    /** The counted work budget. */
+    readonly budget?: StyleWorkBudget;
+    /**
+     * The column a mapping over a file column reads; defaults to `{ data: column }`. A writer's own tagged columns
+     * map back to style columns here.
+     */
+    readonly columnRef?: (column: string) => ColumnRef;
+}
+/**
+ * Neutral rules of a Cytoscape style, and the style columns they read.
+ * @category Styles
+ */
+export interface CytoscapeRules {
+    /** The rules, bottom to top. */
+    readonly rules: StyleRule[];
+    /**
+     * Style columns by key: a passthrough whose file values Cytoscape reads differently from their plain reading
+     * (a 0..255 transparency, `ROUND_RECTANGLE`) reads its values from `cytoscape.<property>` instead.
+     */
+    readonly columns: Map<string, StyleColumn>;
+}
+/**
+ * Translates one target's Cytoscape style into neutral rules: one `defaults` rule over every element, then one
+ * `mapping` rule per mapped column and mapping kind (`node.discrete.Type`), with `nodeSizeLocked` and
+ * `arrowColorMatchesEdge` applied. Discrete keys keep their attribute type.
+ * @param target - nodes or edges
+ * @param style - the style
+ * @param elements - the elements (their bypasses decide which visual property a property is read from)
+ * @param options - notes, the budget and how a file column is referenced
+ * @returns the rules and the style columns they read
+ * @category Styles
+ */
+export declare function cytoscapeRules(target: StyleTarget, style: CytoscapeStyle, elements: CytoscapeElements, options?: CytoscapeTranslateOptions): CytoscapeRules;
+//# sourceMappingURL=translate.d.ts.map

package/dist/src/styles/cytoscape/translate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translate.d.ts","sourceRoot":"","sources":["../../../../src/styles/cytoscape/translate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAAE,SAAS,EAAW,WAAW,EAAE,SAAS,EAAE,WAAW,EAAc,eAAe,EAAE,MAAM,aAAa,CAAC;AAExH,OAAO,KAAK,EAAoB,cAAc,EAAE,MAAM,eAAe,CAAC;AACtE,OAAO,EAGH,KAAK,iBAAiB,EAKzB,MAAM,cAAc,CAAC;AAEtB;;;GAGG;AACH,MAAM,WAAW,yBAAyB;IACtC,gCAAgC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,+BAA+B;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC;CACtD;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC3B,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,EAAE,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CAC9C;AAQD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAC1B,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,cAAc,EACrB,QAAQ,EAAE,iBAAiB,EAC3B,OAAO,GAAE,yBAA8B,GACxC,cAAc,CAqDhB"}