@graphty/graph-io 0.3.42 → 0.3.44

package/dist/src/formats/cx/styles.js

@@ -0,0 +1,225 @@
+/**
+ * The styles of CX version 1 and CX2 files. Both hold one Cytoscape visual style (defaults, mappings and
+ * dependencies) and per-element bypasses. The readers resolve every element the way Cytoscape draws it (bypass over
+ * mapping over default) and translate the style into neutral rules, with Cytoscape desktop's default style beneath
+ * (Cytoscape starts every imported CX or CX2 style as a copy of it). The writers do the reverse: neutral rules
+ * become Cytoscape defaults and mappings, everything else per-element bypasses, so Cytoscape draws what graphty
+ * draws; the `graphty.styles` block is an aspect of its own and the style values its rules read are attributes.
+ */
+import { STYLE_ISSUE } from "../../styles/codes.js";
+import { cytoscapeWritableProperties, emitCytoscapeStyle, } from "../../styles/cytoscape/emit.js";
+import { cytoscapeStyleFromCx } from "../../styles/cytoscape/mappings.js";
+import { cytoscapeBackground, resolveCytoscape, } from "../../styles/cytoscape/resolve.js";
+import { cytoscapeRules } from "../../styles/cytoscape/translate.js";
+import { STYLE_BLOCK_NAME } from "../../styles/io/block.js";
+import { StyleNotes } from "../../styles/notes.js";
+import { plainCell } from "../../styles/plan/resolve.js";
+import { exactFromBlock, nonEmpty } from "../xgmml/styles.js";
+/**
+ * The block text of a `graphty.styles` aspect (`[{ "block": "<json>" }]`, the aspect a CX or CX2 file graphty wrote
+ * keeps its block in), or null when it holds none.
+ * @param elements - the aspect's elements
+ * @returns the text
+ */
+export function blockOfAspect(elements) {
+    const first = elements?.[0];
+    if (first === null || typeof first !== "object" || !Object.hasOwn(first, "block")) {
+        return null;
+    }
+    const text = first.block;
+    return typeof text === "string" ? text : null;
+}
+/**
+ * The `graphty.styles` aspect's elements for a block.
+ * @param block - the block's text
+ * @returns the elements
+ */
+export function blockAspect(block) {
+    return [{ block }];
+}
+/**
+ * The `graphty.styles` block a snapshot carries as a graph attribute (an import of a file graphty wrote, or the one
+ * graph-io adds for a styled export), or null.
+ * @param snapshot - the graph
+ * @returns the block's text
+ */
+export function snapshotBlock(snapshot) {
+    const column = snapshot.graph.get(STYLE_BLOCK_NAME);
+    const value = column?.isSet(0) ? column.value(0) : null;
+    return typeof value === "string" ? value : null;
+}
+/**
+ * Each element's bypasses: the columns of an importer's bypass namespace, keyed by the visual property's own name.
+ * @param table - the node or edge table
+ * @param n - the element count
+ * @param namespace - the bypass namespace
+ * @returns per element, its bypasses, and the bypass columns' names
+ */
+function bypassesOf(table, n, namespace) {
+    const columns = [...table].filter((c) => c.meta.origin?.namespace === namespace);
+    const maps = new Array(n).fill(null);
+    for (let i = 0; i < n; i++) {
+        let m = null;
+        for (const c of columns) {
+            const v = plainCell(c.isSet(i) ? c.value(i) : null);
+            if (v !== null) {
+                m ?? (m = new Map());
+                const id = c.meta.origin?.id;
+                m.set(typeof id === "string" && id.length > 0 ? id : c.meta.name, v);
+            }
+        }
+        maps[i] = m;
+    }
+    return { maps, names: columns.map((c) => c.meta.name) };
+}
+/**
+ * The styles of a graph from its Cytoscape style and its bypass columns.
+ * @param snapshot - the graph
+ * @param context - the budget and cancel signal
+ * @param style - the file's style
+ * @param namespace - the importer's bypass namespace
+ * @param notes - where problems are noted
+ * @param dialect - the Cytoscape dialect the file is written in
+ * @returns the styles
+ */
+export function readDeclaredStyles(snapshot, context, style, namespace, notes, dialect = "desktop") {
+    const out = { node: { values: {} }, edge: { values: {} } };
+    const readFrom = { node: [], edge: [] };
+    for (const target of ["node", "edge"]) {
+        context.signal?.throwIfAborted();
+        const table = target === "node" ? snapshot.nodes : snapshot.edges;
+        const n = target === "node" ? snapshot.nodeCount : snapshot.edgeCount;
+        for (const m of style[target].mappings.values()) {
+            if (!table.has(m.column)) {
+                notes.add(STYLE_ISSUE.MAPPING_COLUMN_MISSING, target, m.column, { sample: m.kind });
+            }
+        }
+        const { maps, names } = bypassesOf(table, n, namespace);
+        readFrom[target] = names;
+        const elements = {
+            count: n,
+            value: (column, i) => (table.has(column) ? plainCell(table.value(column, i)) : null),
+            bypasses: maps,
+        };
+        const values = resolveCytoscape(target, style, elements, { notes, budget: context.budget });
+        // a file graphty wrote: a value its style writes as the nearest Cytoscape value is the block's
+        exactFromBlock(snapshot, target, values, dialect);
+        const { rules, columns } = cytoscapeRules(target, style, elements, { notes, budget: context.budget });
+        out[target] = { values: nonEmpty(values), rules, columns };
+    }
+    const background = cytoscapeBackground(style, notes);
+    return {
+        canonical: true,
+        dialect: "cytoscape",
+        tool: "cytoscape",
+        units: "px",
+        node: out.node,
+        edge: out.edge,
+        graph: background === null ? {} : { background },
+        notes: notes.list(),
+        readFrom,
+    };
+}
+/**
+ * The styles of an imported CX version 1 network: the first view's `cyVisualProperties` (other views noted and
+ * skipped), its bypasses, and Cytoscape desktop's default style beneath.
+ * @param snapshot - the network
+ * @param context - what the import kept, the budget and the cancel signal
+ * @returns the styles
+ */
+export function readCxStyles(snapshot, context) {
+    const notes = new StyleNotes();
+    const kept = context.kept;
+    const style = cytoscapeStyleFromCx(kept?.entries ?? [], notes);
+    const otherViews = kept?.otherViews ?? 0;
+    if (otherViews > 0) {
+        notes.add(STYLE_ISSUE.OTHER_VIEWS, null, "cyVisualProperties", {
+            sample: `${otherViews} more`,
+            count: otherViews,
+        });
+    }
+    return readDeclaredStyles(snapshot, context, style, "cx.bypass", notes);
+}
+/**
+ * The neutral properties a Cytoscape dialect writes, and the graph's background, as writer capabilities.
+ * @param dialect - the dialect
+ * @returns the capabilities
+ */
+export function cytoscapeWriteCapabilities(dialect) {
+    return Object.freeze({
+        node: Object.freeze(cytoscapeWritableProperties("node", dialect)),
+        edge: Object.freeze(cytoscapeWritableProperties("edge", dialect)),
+        graph: Object.freeze(["background"]),
+        // graph-io adds the block as a graph attribute (the writer moves it into an aspect of its own) and the style
+        // values the rules read as element attributes
+        block: "attributes",
+    });
+}
+/** What the CX version 1 writer holds of a graph's styles. */
+export const CX_STYLE_CAPABILITIES = cytoscapeWriteCapabilities("desktop");
+/**
+ * The dtype a column of written style values gets: numbers, booleans or text (a mixed column as text).
+ * @param col - the values
+ * @returns the dtype
+ */
+function valuesDtype(col) {
+    const kinds = new Set(col.filter((v) => v !== null).map((v) => typeof v));
+    if (kinds.size === 1 && kinds.has("number")) {
+        return "f64";
+    }
+    return kinds.size === 1 && kinds.has("boolean") ? "bool" : "string";
+}
+/**
+ * A style note as a loss note.
+ * @param n - the note
+ * @returns the loss note
+ */
+export function lossOf(n) {
+    return Object.freeze({
+        code: n.code,
+        message: n.message,
+        column: null,
+        count: n.params.count,
+        style: n.params.target === null || n.params.property === null || n.params.target === "graph"
+            ? undefined
+            : Object.freeze({ target: n.params.target, property: n.params.property }),
+    });
+}
+/**
+ * Works out a CX or CX2 export with styles: the Cytoscape style of the rules, the bypasses that make Cytoscape draw
+ * exactly what they give, and the snapshot with the columns its mappings read added.
+ * @param snapshot - the graph handed to the exporter
+ * @param input - the styles, or undefined when none are written
+ * @param dialect - `"desktop"` for CX version 1, `"cx2"` for CX2
+ * @returns the styled export, or null without styles
+ */
+export function cytoscapeStyledExport(snapshot, input, dialect) {
+    if (input === undefined) {
+        return null;
+    }
+    const notes = new StyleNotes();
+    const styled = emitCytoscapeStyle(input.rules, snapshot, { dialect, notes });
+    return { snapshot: withMappedColumns(snapshot, styled), styled, notes: notes.list().map(lossOf) };
+}
+/**
+ * The snapshot with the columns the emitted mappings read and it lacks added.
+ * @param snapshot - the graph handed to the exporter
+ * @param styled - the emitted style
+ * @returns the snapshot itself when it lacks none
+ */
+function withMappedColumns(snapshot, styled) {
+    const missing = ["node", "edge"].flatMap((target) => [...styled.columns[target]]
+        .filter(([name]) => !(target === "node" ? snapshot.nodes : snapshot.edges).has(name))
+        .map(([name, values]) => ({ target, name, values })));
+    if (missing.length === 0) {
+        return snapshot;
+    }
+    const out = snapshot.withColumns();
+    for (const { target, name, values } of missing) {
+        const dtype = valuesDtype(values);
+        const col = dtype === "string" ? values.map((v) => (v === null ? null : String(v))) : values;
+        (target === "node" ? out.nodes : out.edges).set(name, col, { dtype });
+    }
+    return out;
+}
+//# sourceMappingURL=styles.js.map

package/dist/src/formats/cx/styles.js.map

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

package/dist/src/formats/cx2/exporter.d.ts

@@ -6,6 +6,11 @@
  * `z` from the `z` column), `edges`, the `cx2.bypass` columns as `nodeBypasses` / `edgeBypasses`,
  * the opaque aspects a CX2 import kept (which returns its own style rules) and `status`.
  *
+ * Given styles (`exportGraph(..., { styles })`), `visualProperties` and `visualEditorProperties` are the
+ * Cytoscape style of the rules (defaults and mappings), the bypasses are every element whose value the style
+ * cannot give, and the style values the rules read are attributes; the `graphty.styles` block, which graph-io
+ * hands over as a graph attribute, is written as an aspect of its own (a kept one is written back the same way).
+ *
  * What CX2 cannot hold is announced by check() before anything is written: every edge is
  * directed (W_CX2_UNDIRECTED_AS_DIRECTED, W_MUTUAL_EXPANDED), node ids are integers (E_ID_CHARSET
  * unless `sanitizeIds: "mangle"`, which keeps the original in the `graphty:originalId` attribute

package/dist/src/formats/cx2/exporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../../../../src/formats/cx2/exporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAqBH,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAiB,MAAM,gBAAgB,CAAC;AAGtH;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,QAAQ;IACjB;;;OAGG;;IAEH,qFAAqF;;IAErF,8FAA8F;;IAE9F,uEAAuE;;IAEvE;;;OAGG;;IAEH,yDAAyD;;IAEzD,yDAAyD;;IAEzD,8GAA8G;;IAE9G;;;OAGG;;IAEH;;;OAGG;;IAEH,6FAA6F;;IAE7F,2DAA2D;;EAE7D,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAiB7B,CAAC;AA0qBH;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,gBAAgB,CAkCtD,CAAC"}
+{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../../../../src/formats/cx2/exporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAwBH,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAiB,MAAM,gBAAgB,CAAC;AAKtH;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAEnD;;;;GAIG;AACH,eAAO,MAAM,QAAQ;IACjB;;;OAGG;;IAEH,qFAAqF;;IAErF,8FAA8F;;IAE9F,uEAAuE;;IAEvE;;;OAGG;;IAEH,yDAAyD;;IAEzD,yDAAyD;;IAEzD,8GAA8G;;IAE9G;;;OAGG;;IAEH;;;OAGG;;IAEH,6FAA6F;;IAE7F,2DAA2D;;EAE7D,CAAC;AAEH;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAiB7B,CAAC;AAyyBH;;;GAGG;AACH,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,gBAAgB,CAuCtD,CAAC"}

package/dist/src/formats/cx2/exporter.js

@@ -6,6 +6,11 @@
  * `z` from the `z` column), `edges`, the `cx2.bypass` columns as `nodeBypasses` / `edgeBypasses`,
  * the opaque aspects a CX2 import kept (which returns its own style rules) and `status`.
  *
+ * Given styles (`exportGraph(..., { styles })`), `visualProperties` and `visualEditorProperties` are the
+ * Cytoscape style of the rules (defaults and mappings), the bypasses are every element whose value the style
+ * cannot give, and the style values the rules read are attributes; the `graphty.styles` block, which graph-io
+ * hands over as a graph attribute, is written as an aspect of its own (a kept one is written back the same way).
+ *
  * What CX2 cannot hold is announced by check() before anything is written: every edge is
  * directed (W_CX2_UNDIRECTED_AS_DIRECTED, W_MUTUAL_EXPANDED), node ids are integers (E_ID_CHARSET
  * unless `sanitizeIds: "mangle"`, which keeps the original in the `graphty:originalId` attribute
@@ -21,7 +26,11 @@ import { resolveExportOptions } from "../../common/options.js";
 import { plural } from "../../common/plural.js";
 import { explicitWeights } from "../../common/weights.js";
 import { encodeChunks, joinText } from "../../common/writer.js";
+import { cytoscapeCx2Aspects } from "../../styles/cytoscape/emit.js";
+import { STYLE_BLOCK_NAME } from "../../styles/io/block.js";
+import { blockAspect, cytoscapeStyledExport, snapshotBlock } from "../cx/styles.js";
 import { BYPASS_NAMESPACE, CX2_FORMAT, cx2Type, ORIGINAL_ID_ATTRIBUTE } from "./importer.js";
+import { CX2_STYLE_CAPABILITIES } from "./styles.js";
 /**
  * The loss notes the CX2 exporter's check() returns, by name. A key is the
  * code without its severity and format prefixes.
@@ -119,8 +128,11 @@ const SKIPPED_ROLES = new Set([
     "shape",
     "thickness",
 ]);
+/** The style aspects; written from the styles when styles are given, else the kept ones. */
+const STYLE_ASPECTS = new Set(["visualProperties", "visualEditorProperties"]);
 /** The aspects the exporter writes itself; an opaque aspect of the same name is not written again. */
 const CORE_ASPECTS = new Set([
+    STYLE_BLOCK_NAME,
     "nodes",
     "edges",
     "attributeDeclarations",
@@ -322,7 +334,9 @@ function plan(snapshot, common) {
     const label = snapshot.nodes.byRole("label");
     const nodeAttrs = planAttributes(snapshot.nodes, (c) => (c.meta.role !== null && SKIPPED_ROLES.has(c.meta.role)) || isBypass(c) || isZ(c), (c) => (c === label && !snapshot.nodes.has("name") ? "name" : c.meta.name), ids !== null && ids.changed > 0 ? new Set([ORIGINAL_ID_ATTRIBUTE]) : new Set());
     const edgeAttrs = planEdgeAttributes(snapshot, weights, note);
-    const graphAttrs = planAttributes(snapshot.graph, () => false, (c) => c.meta.name).map((p) => ({ ...p, key: p.name }));
+    const graphAttrs = planAttributes(snapshot.graph, 
+    // the graphty.styles block is an aspect of its own
+    (c) => c.meta.name === STYLE_BLOCK_NAME, (c) => c.meta.name).map((p) => ({ ...p, key: p.name }));
     const position = snapshot.nodes.byRole("position");
     nonFiniteNote(snapshot, [...nodeAttrs, ...edgeAttrs, ...graphAttrs], weights, position, note);
     const edgeIds = planEdgeIds(snapshot, note, ids);
@@ -437,35 +451,13 @@ function attributesOf(plans, row) {
     return out;
 }
 /**
- * Write the document as text parts.
+ * The networkAttributes element and its declarations: the graph attributes, then the snapshot's name and
+ * description where no attribute of that name is written.
  * @param snapshot - the snapshot
  * @param p - the plan
- * @yields the document's text
- * @returns nothing
+ * @returns the element and the declarations
  */
-function* write(snapshot, p) {
-    if (p.fatal !== null) {
-        throw p.fatal;
-    }
-    const { ids } = p;
-    if (ids === null) {
-        throw new GraphFormatError("E_INVALID_ID", "node ids cannot be written as CX2 integers", { reason: "charset" });
-    }
-    const { src, dst } = snapshot.edgeList();
-    const edges = [];
-    for (let e = 0; e < snapshot.edgeCount; e++) {
-        if (!p.folding.folded(e)) {
-            edges.push(e);
-        }
-    }
-    const nodeDecls = declarations(p.nodeAttrs, true);
-    if (p.originalIds) {
-        nodeDecls[ORIGINAL_ID_ATTRIBUTE] = { d: "string" };
-    }
-    const edgeDecls = declarations(p.edgeAttrs, true);
-    if (p.weights.weighted) {
-        edgeDecls[WEIGHT_ATTRIBUTE] = { d: "double" };
-    }
+function networkOf(snapshot, p) {
     const networkDecls = declarations(p.graphAttrs, false);
     const network = {};
     for (const a of p.graphAttrs) {
@@ -484,77 +476,136 @@ function* write(snapshot, p) {
             networkDecls[key] = { d: "string" };
         }
     }
-    const kept = isRecord(meta.extra.cx2) ? meta.extra.cx2 : {};
+    return { network, networkDecls };
+}
+/**
+ * The attributeDeclarations element: the kept declarations of other tables, then the network's, the nodes' and the
+ * edges' where there are any.
+ * @param p - the plan
+ * @param kept - what an import kept in meta.extra.cx2
+ * @param networkDecls - the network's declarations
+ * @returns the element
+ */
+function declarationsElementOf(p, kept, networkDecls) {
+    const nodeDecls = declarations(p.nodeAttrs, true);
+    if (p.originalIds) {
+        nodeDecls[ORIGINAL_ID_ATTRIBUTE] = { d: "string" };
+    }
+    const edgeDecls = declarations(p.edgeAttrs, true);
+    if (p.weights.weighted) {
+        edgeDecls[WEIGHT_ATTRIBUTE] = { d: "double" };
+    }
     const otherDecls = isRecord(kept.declarations) ? kept.declarations : {};
-    const opaque = meta.sourceFormat === CX2_FORMAT && isRecord(kept.opaque) ? kept.opaque : {};
-    const declarationsElement = { ...otherDecls };
+    const element = { ...otherDecls };
     for (const [key, table] of [
         ["networkAttributes", networkDecls],
         ["nodes", nodeDecls],
         ["edges", edgeDecls],
     ]) {
         if (Object.keys(table).length > 0) {
-            declarationsElement[key] = table;
+            element[key] = table;
         }
     }
-    const nodeBypassRows = bypassRows(p.nodeBypasses, snapshot.nodeCount);
-    const edgeBypassRows = bypassRows(p.edgeBypasses, snapshot.edgeCount).filter((e) => !p.folding.folded(e));
-    const opaqueAspects = Object.entries(opaque).filter((entry) => !CORE_ASPECTS.has(entry[0]) && Array.isArray(entry[1]));
-    const counts = [];
-    const hasDeclarations = Object.keys(declarationsElement).length > 0;
-    if (hasDeclarations) {
-        counts.push(["attributeDeclarations", 1]);
+    return element;
+}
+/**
+ * One edge element.
+ * @param p - the plan
+ * @param ids - the written node ids
+ * @param src - the source of each edge
+ * @param dst - the target of each edge
+ * @param e - the edge
+ * @returns the element
+ */
+function edgeElement(p, ids, src, dst, e) {
+    const element = {
+        id: p.edgeIds[e],
+        s: ids.idAt(src[e]),
+        t: ids.idAt(dst[e]),
+    };
+    let v = attributesOf(p.edgeAttrs, e);
+    if (p.weights.isExplicit(e)) {
+        const w = p.weights.value(e);
+        v ?? (v = {});
+        v[WEIGHT_ATTRIBUTE] = Number.isFinite(w) ? w : null;
     }
-    if (Object.keys(network).length > 0) {
-        counts.push(["networkAttributes", 1]);
+    if (v !== null) {
+        element.v = v;
     }
-    counts.push(["nodes", snapshot.nodeCount], ["edges", edges.length]);
-    if (nodeBypassRows.length > 0) {
-        counts.push(["nodeBypasses", nodeBypassRows.length]);
+    return element;
+}
+/**
+ * The optional aspects of a document that are written: those with elements.
+ * @param aspects - each aspect's name and element count
+ * @returns the metaData counts
+ */
+function presentAspects(aspects) {
+    return aspects.filter(([, n]) => n > 0).map(([name, n]) => [name, n]);
+}
+/**
+ * Write the document as text parts.
+ * @param snapshot - the snapshot
+ * @param p - the plan
+ * @param styled - the styles as a Cytoscape style, or null without styles
+ * @yields the document's text
+ * @returns nothing
+ */
+function* write(snapshot, p, styled = null) {
+    if (p.fatal !== null) {
+        throw p.fatal;
     }
-    if (edgeBypassRows.length > 0) {
-        counts.push(["edgeBypasses", edgeBypassRows.length]);
+    const { ids } = p;
+    if (ids === null) {
+        throw new GraphFormatError("E_INVALID_ID", "node ids cannot be written as CX2 integers", { reason: "charset" });
     }
-    for (const [name, elements] of opaqueAspects) {
-        counts.push([name, elements.length]);
+    const edges = [];
+    for (let e = 0; e < snapshot.edgeCount; e++) {
+        if (!p.folding.folded(e)) {
+            edges.push(e);
+        }
     }
+    const { network, networkDecls } = networkOf(snapshot, p);
+    const { meta } = snapshot;
+    const kept = isRecord(meta.extra.cx2) ? meta.extra.cx2 : {};
+    const opaque = meta.sourceFormat === CX2_FORMAT && isRecord(kept.opaque) ? kept.opaque : {};
+    const declarationsElement = declarationsElementOf(p, kept, networkDecls);
+    const { bypassOf, nodeBypassRows, edgeBypassRows, opaqueAspects } = styleParts(snapshot, p, styled, opaque);
+    const hasDeclarations = Object.keys(declarationsElement).length > 0;
+    const hasNetwork = Object.keys(network).length > 0;
+    const counts = [
+        ...presentAspects([
+            ["attributeDeclarations", hasDeclarations ? 1 : 0],
+            ["networkAttributes", hasNetwork ? 1 : 0],
+        ]),
+        ["nodes", snapshot.nodeCount],
+        ["edges", edges.length],
+        ...presentAspects([
+            ["nodeBypasses", nodeBypassRows.length],
+            ["edgeBypasses", edgeBypassRows.length],
+        ]),
+        ...opaqueAspects.map(([name, elements]) => [name, elements.length]),
+    ];
     yield '[{"CXVersion":"2.0","hasFragments":false},\n';
     yield `{"metaData":${stringify(counts.map(([name, elementCount]) => ({ name, elementCount })))}},\n`;
     if (hasDeclarations) {
         yield `{"attributeDeclarations":[${stringify(declarationsElement)}]},\n`;
     }
-    if (Object.keys(network).length > 0) {
+    if (hasNetwork) {
         yield `{"networkAttributes":[${stringify(network)}]},\n`;
     }
     yield* block("nodes", snapshot.nodeCount, (i) => stringify(nodeElement(p, ids, i)));
-    yield* block("edges", edges.length, (k) => {
-        const e = edges[k];
-        const element = {
-            id: p.edgeIds[e],
-            s: ids.idAt(src[e]),
-            t: ids.idAt(dst[e]),
-        };
-        let v = attributesOf(p.edgeAttrs, e);
-        if (p.weights.isExplicit(e)) {
-            const w = p.weights.value(e);
-            v ?? (v = {});
-            v[WEIGHT_ATTRIBUTE] = Number.isFinite(w) ? w : null;
-        }
-        if (v !== null) {
-            element.v = v;
-        }
-        return stringify(element);
-    });
+    const { src, dst } = snapshot.edgeList();
+    yield* block("edges", edges.length, (k) => stringify(edgeElement(p, ids, src, dst, edges[k])));
     if (nodeBypassRows.length > 0) {
         yield* block("nodeBypasses", nodeBypassRows.length, (k) => {
             const i = nodeBypassRows[k];
-            return stringify({ id: ids.idAt(i), v: bypassValues(p.nodeBypasses, i) });
+            return stringify({ id: ids.idAt(i), v: bypassOf("node", i) });
         });
     }
     if (edgeBypassRows.length > 0) {
         yield* block("edgeBypasses", edgeBypassRows.length, (k) => {
             const e = edgeBypassRows[k];
-            return stringify({ id: p.edgeIds[e], v: bypassValues(p.edgeBypasses, e) });
+            return stringify({ id: p.edgeIds[e], v: bypassOf("edge", e) });
         });
     }
     for (const [name, elements] of opaqueAspects) {
@@ -562,6 +613,49 @@ function* write(snapshot, p) {
     }
     yield '{"status":[{"error":"","success":true}]}]\n';
 }
+/**
+ * The bypasses and the extra aspects of a document. With styles, the bypasses and the style aspects are the
+ * styles' own (the bypass columns and style aspects of an import are what the styles were read from); without, the
+ * bypass columns and the kept aspects are written back.
+ * @param snapshot - the snapshot
+ * @param p - the plan
+ * @param styled - the styles as a Cytoscape style, or null without styles
+ * @param opaque - the opaque aspects a CX2 import kept
+ * @returns the parts
+ */
+function styleParts(snapshot, p, styled, opaque) {
+    const bypassOf = (target, row) => {
+        if (styled === null) {
+            return bypassValues(target === "node" ? p.nodeBypasses : p.edgeBypasses, row);
+        }
+        const m = styled.bypasses[target][row];
+        return m === null || m.size === 0 ? null : Object.fromEntries(m);
+    };
+    const rowsWith = (target, n) => {
+        if (styled === null) {
+            return bypassRows(target === "node" ? p.nodeBypasses : p.edgeBypasses, n);
+        }
+        const out = [];
+        for (let i = 0; i < n; i++) {
+            if (bypassOf(target, i) !== null) {
+                out.push(i);
+            }
+        }
+        return out;
+    };
+    const nodeBypassRows = rowsWith("node", snapshot.nodeCount);
+    const edgeBypassRows = rowsWith("edge", snapshot.edgeCount).filter((e) => !p.folding.folded(e));
+    const opaqueAspects = Object.entries(opaque).filter((entry) => !CORE_ASPECTS.has(entry[0]) && !(styled !== null && STYLE_ASPECTS.has(entry[0])) && Array.isArray(entry[1]));
+    if (styled !== null) {
+        const aspects = cytoscapeCx2Aspects(styled.style);
+        opaqueAspects.push(["visualProperties", aspects.visualProperties], ["visualEditorProperties", aspects.visualEditorProperties]);
+    }
+    const styleBlock = snapshotBlock(snapshot);
+    if (styleBlock !== null) {
+        opaqueAspects.push([STYLE_BLOCK_NAME, blockAspect(styleBlock)]);
+    }
+    return { bypassOf, nodeBypassRows, edgeBypassRows, opaqueAspects };
+}
 /**
  * The text of one aspect block, element by element.
  * @param aspect - the aspect name
@@ -654,6 +748,7 @@ export const cx2Exporter = Object.freeze({
     format: CX2_FORMAT,
     options: Object.freeze([]),
     capabilities: CX2_CAPABILITIES,
+    styles: Object.freeze({ capabilities: CX2_STYLE_CAPABILITIES }),
     /**
      * Pre-flight: what export() would lose, without writing anything.
      * @param snapshot - the snapshot
@@ -661,7 +756,11 @@ export const cx2Exporter = Object.freeze({
      * @returns the notes, empty when the export is exact
      */
     check(snapshot, options) {
-        return Object.freeze([...plan(snapshot, resolveExportOptions(options)).notes]);
+        const styled = cytoscapeStyledExport(snapshot, options?.styles, "cx2");
+        return Object.freeze([
+            ...plan(styled?.snapshot ?? snapshot, resolveExportOptions(options)).notes,
+            ...(styled?.notes ?? []),
+        ]);
     },
     /**
      * Write the document as UTF-8 chunks.
@@ -670,7 +769,7 @@ export const cx2Exporter = Object.freeze({
      * @returns the chunks
      */
     export(snapshot, options) {
-        return encodeChunks(write(snapshot, plan(snapshot, resolveExportOptions(options))));
+        return encodeChunks(written(snapshot, options));
     },
     /**
      * Write the document as one string.
@@ -679,7 +778,18 @@ export const cx2Exporter = Object.freeze({
      * @returns the document
      */
     exportToString(snapshot, options) {
-        return joinText(write(snapshot, plan(snapshot, resolveExportOptions(options))));
+        return joinText(written(snapshot, options));
     },
 });
+/**
+ * The document's text, with the styles when they are given.
+ * @param snapshot - the snapshot
+ * @param options - the options
+ * @returns the text parts
+ */
+function written(snapshot, options) {
+    const styled = cytoscapeStyledExport(snapshot, options?.styles, "cx2");
+    const target = styled?.snapshot ?? snapshot;
+    return write(target, plan(target, resolveExportOptions(options)), styled?.styled ?? null);
+}
 //# sourceMappingURL=exporter.js.map