@graphty/graph-io 0.3.43 → 0.3.45

package/dist/chunks/{importer-C98dpSH4.js → importer-B-9Rc1zO.js}

@@ -1,9 +1,13 @@
 import { GraphFormatError, INVALID_INDEX } from "@graphty/graph-format";
 import { c as childrenCsr } from "./children-CA4coBi0.js";
-import { s as stringify, f as aspectBlock, d as directionNotes, p as planNodeIds, b as planEdgeIds, O as ORIGINAL_ID_ATTRIBUTE, h as nextNodeId, i as noteList, g as declaredType, z as zAsOption } from "./importer-D794XUTe.js";
-import { c as capabilities, L as LOSS, r as resolveExportOptions, p as pairFolding, a as checkCapabilities, e as explicitWeights, b as plural, ad as TOO_LARGE_CODE, S as SINK_OPTION_CODE, O as OPTION_IGNORED_CODE, D as DIRECTION_FORCED_CODE, d as DIRECTION_REFUSED_CODE, R as ROLE_TAKEN_CODE, C as COLUMN_RENAMED_CODE, N as NO_GRAPH_CODE, ae as AMBIGUOUS_GRAPH_NAME_CODE, af as GRAPH_NOT_FOUND_CODE, l as MULTIPLE_GRAPHS_CODE, I as ID_MERGED_CODE, P as PRECISION_CODE, J as ID_TEXT_TYPE_CODE, a2 as JSON_NONSTANDARD_NUMBER_CODE, ag as SINGLE_OBJECT_ASPECT_CODE, W as MULTI_ASPECT_FRAGMENT_CODE, g as UNKNOWN_ELEMENT_CODE, m as DUPLICATE_EDGE_ID_CODE, n as DUPLICATE_NODE_CODE, s as MISSING_ENDPOINT_CODE, t as MISSING_ID_CODE, ah as STYLES_NOT_IMPORTED_CODE, ai as PARENT_CYCLE_CODE, q as UNKNOWN_PARENT_CODE, o as DUPLICATE_ATTRIBUTE_CODE, i as DANGLING_REFERENCE_CODE, U as UNKNOWN_ATTR_TYPE_CODE, aj as WIDENED_CODE, a3 as BAD_VALUE_CODE, j as COUNT_MISMATCH_CODE, Y as ASPECT_ORDER_CODE, V as BAD_ASPECT_BLOCK_CODE, _ as STATUS_WARNING_CODE, Z as STATUS_FAILED_CODE, w as UNKNOWN_ENCODING_CODE, x as ENCODING_FALLBACK_CODE, y as INVALID_ENCODING_CODE, z as INVALID_UTF8_CODE, ak as SYNTAX_CODE, E as EMPTY_INPUT_CODE, F as ELEMENT_ISSUE, G as INPUT_ISSUE, al as resolveImportOptions, a8 as ImportReportBuilder, a4 as textChunks, am as throwIfAborted, an as reportUnusedOptions, ao as reportSinkOptions, a7 as chooseGraph, ap as graphChosen, aq as DirectionResolver, ar as IdCoercer, $ as agree, a1 as declareResolved, a0 as uniqueColumnName, as as weightFromValue } from "./export-rKLeGQMo.js";
-import { i as isRecord, P as POSITION_COLUMN, h as headText, s as scanAspects, r as reportTooDeep, a as reportSharedBlock, C as CxStructure, J as JsonScanError, E as ExactInteger, c as cxId, p as plainJson, f as flipY, z as zDecl, b as positionDecl, d as declareFresh, e as inexactLiteral, k as keptPrecision } from "./json-elements-DKSqpNW1.js";
+import { d as directionNotes, p as planNodeIds, e as planEdgeIds, O as ORIGINAL_ID_ATTRIBUTE, s as stringify, g as aspectBlock, i as noteList, f as declaredType, j as nextNodeId, z as zAsOption } from "./importer-BVVR740x.js";
+import { c as capabilities, L as LOSS, r as resolveExportOptions, p as pairFolding, a as checkCapabilities, e as explicitWeights, g as resolveImportOptions, t as textChunks, h as throwIfAborted, i as reportUnusedOptions, j as reportSinkOptions, f as chooseGraph, k as graphChosen, l as DirectionResolver, I as IdCoercer, d as declareResolved, u as uniqueColumnName, w as weightFromValue } from "./export-BvqAXCKh.js";
+import { i as isRecord, P as POSITION_COLUMN, h as headText, s as scanAspects, r as reportTooDeep, a as reportSharedBlock, C as CxStructure, J as JsonScanError, E as ExactInteger, c as cxId, p as plainJson, z as zDecl, b as positionDecl, d as declareFresh, e as inexactLiteral, k as keptPrecision } from "./json-elements-DJZRZ6jd.js";
+import { p as plural, a1 as TOO_LARGE_CODE, S as SINK_OPTION_CODE, O as OPTION_IGNORED_CODE, D as DIRECTION_FORCED_CODE, b as DIRECTION_REFUSED_CODE, R as ROLE_TAKEN_CODE, C as COLUMN_RENAMED_CODE, N as NO_GRAPH_CODE, a2 as AMBIGUOUS_GRAPH_NAME_CODE, a3 as GRAPH_NOT_FOUND_CODE, i as MULTIPLE_GRAPHS_CODE, I as ID_MERGED_CODE, P as PRECISION_CODE, A as ID_TEXT_TYPE_CODE, W as JSON_NONSTANDARD_NUMBER_CODE, a4 as SINGLE_OBJECT_ASPECT_CODE, L as MULTI_ASPECT_FRAGMENT_CODE, d as UNKNOWN_ELEMENT_CODE, j as DUPLICATE_EDGE_ID_CODE, k as DUPLICATE_NODE_CODE, n as MISSING_ENDPOINT_CODE, o as MISSING_ID_CODE, a5 as STYLES_NOT_IMPORTED_CODE, a6 as PARENT_CYCLE_CODE, m as UNKNOWN_PARENT_CODE, l as DUPLICATE_ATTRIBUTE_CODE, f as DANGLING_REFERENCE_CODE, U as UNKNOWN_ATTR_TYPE_CODE, a7 as WIDENED_CODE, Y as BAD_VALUE_CODE, g as COUNT_MISMATCH_CODE, Q as ASPECT_ORDER_CODE, K as BAD_ASPECT_BLOCK_CODE, V as STATUS_WARNING_CODE, T as STATUS_FAILED_CODE, s as UNKNOWN_ENCODING_CODE, t as ENCODING_FALLBACK_CODE, u as INVALID_ENCODING_CODE, v as INVALID_UTF8_CODE, a8 as SYNTAX_CODE, E as EMPTY_INPUT_CODE, y as ELEMENT_ISSUE, z as INPUT_ISSUE, Z as ImportReportBuilder, a as agree } from "./format-BpQBx8MZ.js";
 import { j as joinText, e as encodeChunks } from "./writer-DxjgHwSe.js";
+import { c as cytoscapeStyledExport, q as CX_STYLE_CAPABILITIES, s as snapshotBlock, d as blockAspect, r as cytoscapeCxAspect, t as readCxStyles, u as blockOfAspect } from "./styles-zNTmz5R7.js";
+import { S as STYLE_BLOCK_NAME } from "./block-CPCHkX42.js";
+import { f as flipY } from "./convert-BcQ8_jMo.js";
 const CX_FORMAT$1 = "cx";
 const CX_LOSS = Object.freeze({
   /**
@@ -140,7 +144,8 @@ const NEVER_WRITTEN = /* @__PURE__ */ new Set([
   "metaData",
   "status",
   "groups",
-  "subnetwork"
+  "subnetwork",
+  STYLE_BLOCK_NAME
 ]);
 const WEIGHT_ATTRIBUTE = "weight";
 const NUMERIC_DTYPES = /* @__PURE__ */ new Set(["f32", "f64", "i32", "u32", "u8"]);
@@ -308,7 +313,11 @@ function plan(snapshot, common) {
   );
   nonfinite += weight.nonfinite;
   graphColumnNotes(snapshot, note);
-  const graphAttrs = attributePlans(snapshot.graph, isBypass, (c) => c.meta.name);
+  const graphAttrs = attributePlans(
+    snapshot.graph,
+    (c) => isBypass(c) || c.meta.name === STYLE_BLOCK_NAME,
+    (c) => c.meta.name
+  );
   if (children.column !== null && children.column.meta.role === "parents" && !several) {
     note(
       LOSS.COLUMN_NAME_CHANGED,
@@ -514,7 +523,7 @@ function writtenEdges(snapshot, folding) {
   }
   return out;
 }
-function aspects(snapshot, p, ids) {
+function aspects(snapshot, p, ids, styled) {
   const { src, dst } = snapshot.edgeList();
   const edges = writtenEdges(snapshot, p.folding);
   const nodeRange = () => Array.from({ length: snapshot.nodeCount }, (_, i2) => i2);
@@ -627,8 +636,15 @@ function aspects(snapshot, p, ids) {
     { name: "cyTableColumn", elements: () => tableColumns(p, ids) },
     { name: "cartesianLayout", elements: () => layoutElements(p, ids, nodeRange()) },
     { name: "cyGroups", elements: () => groupElements(snapshot, p, ids, edges) },
-    { name: "cyVisualProperties", elements: () => visualProperties(p, ids, nodeRange(), edges, kept) }
+    {
+      name: "cyVisualProperties",
+      elements: () => styled === null ? visualProperties(p, ids, nodeRange(), edges, kept) : styledVisualProperties(styled, ids, p.edgeIds, edges)
+    }
   ];
+  const block = snapshotBlock(snapshot);
+  if (block !== null) {
+    out.push({ name: STYLE_BLOCK_NAME, elements: () => blockAspect(block) });
+  }
   out.push(...provenanceAspects(snapshot, p, ids, edges));
   for (const [name, value] of Object.entries(kept)) {
     if (!NEVER_WRITTEN.has(name) && Array.isArray(value)) {
@@ -795,6 +811,22 @@ function* visualProperties(p, ids, rows, edges, kept) {
     }
   }
 }
+function* styledVisualProperties(styled, ids, edgeIds, edges) {
+  yield* cytoscapeCxAspect(styled.style);
+  const text = (m) => Object.fromEntries([...m].map(([k, v]) => [k, String(v)]));
+  for (let row = 0; row < styled.bypasses.node.length; row++) {
+    const m = styled.bypasses.node[row];
+    if (m !== null && m.size > 0) {
+      yield { properties_of: "nodes", applies_to: ids.idAt(row), properties: text(m) };
+    }
+  }
+  for (const e of edges) {
+    const m = styled.bypasses.edge[e];
+    if (m !== null && m.size > 0) {
+      yield { properties_of: "edges", applies_to: edgeIds[e], properties: text(m) };
+    }
+  }
+}
 function ownView(kept) {
   const sub = kept.subnetwork;
   for (const r of Array.isArray(kept.cyNetworkRelations) ? kept.cyNetworkRelations : []) {
@@ -887,7 +919,7 @@ function provenanceAspects(snapshot, p, ids, edges) {
   }
   return out;
 }
-function* write(snapshot, p) {
+function* write(snapshot, p, styled = null) {
   if (p.fatal !== null) {
     throw p.fatal;
   }
@@ -895,18 +927,18 @@ function* write(snapshot, p) {
   if (ids === null) {
     throw new GraphFormatError("E_INVALID_ID", "node ids cannot be written as CX integers", { reason: "charset" });
   }
-  const all = aspects(snapshot, p, ids);
-  const written = [];
+  const all = aspects(snapshot, p, ids, styled);
+  const written2 = [];
   for (const aspect2 of all) {
     let count = 0;
     for (const _ of aspect2.elements()) {
       count++;
     }
     if (count > 0 || aspect2.name === "nodes") {
-      written.push({ aspect: aspect2, count });
+      written2.push({ aspect: aspect2, count });
     }
   }
-  const metaData = written.map(({ aspect: aspect2, count }) => ({
+  const metaData = written2.map(({ aspect: aspect2, count }) => ({
     name: aspect2.name,
     version: "1.0",
     ...aspect2.idCounter === void 0 ? {} : { idCounter: aspect2.idCounter },
@@ -916,7 +948,7 @@ function* write(snapshot, p) {
   yield '[{"numberVerification":[{"longNumber":281474976710655}]},\n';
   yield `{"metaData":${stringify(metaData)}},
 `;
-  for (const { aspect: aspect2 } of written) {
+  for (const { aspect: aspect2 } of written2) {
     yield* aspectBlock(aspect2.name, mapIterable(aspect2.elements(), stringify));
   }
   yield '{"status":[{"error":"","success":true}]}]\n';
@@ -930,6 +962,7 @@ const cxExporter = Object.freeze({
   format: CX_FORMAT$1,
   options: Object.freeze([]),
   capabilities: CX_CAPABILITIES,
+  styles: Object.freeze({ capabilities: CX_STYLE_CAPABILITIES }),
   /**
    * Pre-flight: what export() would lose, without writing anything.
    * @param snapshot - the snapshot
@@ -937,7 +970,11 @@ const cxExporter = 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, "desktop");
+    return Object.freeze([
+      ...plan(styled?.snapshot ?? snapshot, resolveExportOptions(options)).notes,
+      ...styled?.notes ?? []
+    ]);
   },
   /**
    * Write the document as UTF-8 chunks.
@@ -946,7 +983,7 @@ const cxExporter = 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.
@@ -955,9 +992,14 @@ const cxExporter = Object.freeze({
    * @returns the document
    */
   exportToString(snapshot, options) {
-    return joinText(write(snapshot, plan(snapshot, resolveExportOptions(options))));
+    return joinText(written(snapshot, options));
   }
 });
+function written(snapshot, options) {
+  const styled = cytoscapeStyledExport(snapshot, options?.styles, "desktop");
+  const target = styled?.snapshot ?? snapshot;
+  return write(target, plan(target, resolveExportOptions(options)), styled?.styled ?? null);
+}
 const CX_FORMAT = "cx";
 const CX_BYPASS_NAMESPACE = "cx.bypass";
 const CX_ISSUE = Object.freeze({
@@ -1623,6 +1665,12 @@ function refId(raw) {
     return null;
   }
 }
+function entryView(entry) {
+  return entry.view === void 0 || entry.view === null ? null : refId(entry.view);
+}
+function cellText(raw) {
+  return typeof raw === "string" ? raw : JSON.stringify(raw);
+}
 function memberSet(raw, onBad) {
   if (raw === "all") {
     return null;
@@ -1811,9 +1859,6 @@ function layoutViews(doc) {
 function memberCount(members, total) {
   return members === null ? total : members.size;
 }
-function visualText(raw) {
-  return typeof raw === "string" ? raw : JSON.stringify(raw);
-}
 class CxReader {
   /**
    * Create the reader.
@@ -1886,6 +1931,7 @@ class CxReader {
     this.writeAttributes("edge", edgeColumns);
     this.readNetworkAttributes();
     this.readVisualProperties();
+    this.readStyleBlock();
     this.readProvenance();
     for (const [kind, count] of this.dangling) {
       report.warning(
@@ -3153,66 +3199,72 @@ class CxReader {
    * applied.
    */
   readVisualProperties() {
+    const entries = aspect(this.doc, "cyVisualProperties");
     const tableStyles = TABLE_STYLE_ASPECTS.reduce((n, name) => n + (this.doc.kept.get(name)?.length ?? 0), 0);
     const views = new Set(this.plan.views.slice(0, 1));
-    const visual = {
+    const ofThisView = (view) => view === null || views.size === 0 || views.has(view);
+    this.keepVisualPropertiesForStyles(entries, ofThisView);
+    const read = {
       columns: { node: /* @__PURE__ */ new Map(), edge: /* @__PURE__ */ new Map() },
       network: /* @__PURE__ */ new Map(),
       defaults: 0,
       mappings: 0,
       dependencies: 0
     };
-    for (const { value } of aspect(this.doc, "cyVisualProperties")) {
-      if (isRecord(value)) {
-        this.collectVisualEntry(value, views, visual);
+    for (const { value } of entries) {
+      if (isRecord(value) && ofThisView(entryView(value))) {
+        this.collectVisualProperties(value, read);
       }
     }
-    this.writeBypassColumns(visual.columns);
-    this.writeBypassNetwork(visual.network);
-    this.reportStyleRules(visual, tableStyles);
+    this.writeBypassColumns(read);
+    this.warnStylesNotImported(read, tableStyles);
   }
   /**
-   * File one cyVisualProperties element of this graph's view into the collection: per-element and
-   * network values by property, defaults, mappings and dependencies counted.
-   * @param value - the element
-   * @param views - the views read (empty: every view)
-   * @param visual - the collection to add to
+   * Hand the style reader the entries of this graph's view (and those naming no view).
+   * @param entries - every cyVisualProperties entry
+   * @param ofThisView - whether a view is this graph's
    */
-  collectVisualEntry(value, views, visual) {
-    const view = value.view === void 0 || value.view === null ? null : refId(value.view);
-    if (view !== null && views.size > 0 && !views.has(view)) {
-      return;
-    }
+  keepVisualPropertiesForStyles(entries, ofThisView) {
+    const others = /* @__PURE__ */ new Set();
+    const kept = entries.map((h) => h.value).filter((v) => {
+      const view = isRecord(v) ? entryView(v) : null;
+      if (!ofThisView(view)) {
+        others.add(view);
+        return false;
+      }
+      return true;
+    });
+    const source = others.size > 0 ? { entries: kept, otherViews: others.size } : { entries: kept };
+    this.report.keepForStyles(source);
+  }
+  /**
+   * Collect one cyVisualProperties entry of this graph's view.
+   * @param value - the entry
+   * @param read - what is collected so far
+   */
+  collectVisualProperties(value, read) {
     const properties = isRecord(value.properties) ? value.properties : {};
-    visual.mappings += isRecord(value.mappings) ? Object.keys(value.mappings).length : 0;
-    visual.dependencies += isRecord(value.dependencies) ? Object.keys(value.dependencies).length : 0;
-    switch (value.properties_of) {
-      case "nodes":
-        this.collectElementProperties("node", value.applies_to, properties, visual.columns);
-        break;
-      case "edges":
-        this.collectElementProperties("edge", value.applies_to, properties, visual.columns);
-        break;
-      case "network":
-        for (const [property, raw] of Object.entries(properties)) {
-          visual.network.set(property, visualText(raw));
-        }
-        break;
-      default:
-        visual.defaults += Object.keys(properties).length;
-        break;
+    read.mappings += isRecord(value.mappings) ? Object.keys(value.mappings).length : 0;
+    read.dependencies += isRecord(value.dependencies) ? Object.keys(value.dependencies).length : 0;
+    if (value.properties_of === "nodes" || value.properties_of === "edges") {
+      this.collectElementProperties(value, properties, read);
+    } else if (value.properties_of === "network") {
+      for (const [property, raw] of Object.entries(properties)) {
+        read.network.set(property, cellText(raw));
+      }
+    } else {
+      read.defaults += Object.keys(properties).length;
     }
   }
   /**
-   * File the visual values of one node or edge under its row; an element not in this graph is
-   * skipped, and reported dangling when it is in no graph of the file.
-   * @param domain - node or edge
-   * @param appliesTo - the element's applies_to
-   * @param properties - its visual properties
-   * @param columns - the per-property cells to add to
+   * Collect the per-element values of a nodes or edges entry.
+   * @param value - the entry
+   * @param properties - its properties
+   * @param read - what is collected so far
    */
-  collectElementProperties(domain, appliesTo, properties, columns) {
-    const target = refId(appliesTo);
+  collectElementProperties(value, properties, read) {
+    const domain = value.properties_of === "nodes" ? "node" : "edge";
+    const target = refId(value.applies_to);
     const rows = domain === "node" ? this.nodeRows : this.edgeRows;
     const row = target === null ? void 0 : rows.get(target);
     if (row === void 0) {
@@ -3222,18 +3274,18 @@ class CxReader {
       return;
     }
     for (const [property, raw] of Object.entries(properties)) {
-      const list = columns[domain].get(property) ?? [];
-      list.push([row, visualText(raw)]);
-      columns[domain].set(property, list);
+      const list = read.columns[domain].get(property) ?? [];
+      list.push([row, cellText(raw)]);
+      read.columns[domain].set(property, list);
     }
   }
   /**
-   * Write the collected per-element visual values as string columns in the cx.bypass namespace.
-   * @param columns - the per-property cells of each domain
+   * Write the per-element and network values as string columns in the cx.bypass namespace.
+   * @param read - what was collected
    */
-  writeBypassColumns(columns) {
+  writeBypassColumns(read) {
     for (const domain of ["node", "edge"]) {
-      for (const [property, cells] of columns[domain]) {
+      for (const [property, cells] of read.columns[domain]) {
         const handle = declareFresh(
           this.sink,
           domain,
@@ -3254,13 +3306,7 @@ class CxReader {
         }
       }
     }
-  }
-  /**
-   * Write the network visual values as graph values in the cx.bypass namespace.
-   * @param network - the value of each property
-   */
-  writeBypassNetwork(network) {
-    for (const [property, text] of network) {
+    for (const [property, text] of read.network) {
       try {
         this.sink.setGraphValue(property, text, {
           dtype: "string",
@@ -3272,12 +3318,12 @@ class CxReader {
     }
   }
   /**
-   * Warn that the style rules (defaults, mappings, dependencies, table styles) are kept, not applied.
-   * @param visual - the counted rules
-   * @param tableStyles - the number of table style elements
+   * The warning that the file's style rules are kept and not applied, when it has any.
+   * @param read - what was collected
+   * @param tableStyles - how many table style elements the file holds
    */
-  reportStyleRules(visual, tableStyles) {
-    const { defaults, mappings, dependencies } = visual;
+  warnStylesNotImported(read, tableStyles) {
+    const { defaults, mappings, dependencies } = read;
     if (defaults + mappings + dependencies + tableStyles === 0) {
       return;
     }
@@ -3294,6 +3340,16 @@ class CxReader {
       { element: "cyVisualProperties" }
     );
   }
+  /** The `graphty.styles` aspect of a file graphty wrote, as the graph attribute of that name. */
+  readStyleBlock() {
+    const block = blockOfAspect(this.doc.kept.get(STYLE_BLOCK_NAME));
+    if (block !== null) {
+      this.sink.setGraphValue(STYLE_BLOCK_NAME, block, {
+        dtype: "string",
+        origin: { format: CX_FORMAT, id: null }
+      });
+    }
+  }
   /**
    * Read the provenance aspects: citations and supports as extension tables cx:citations and
    * cx:supports, the node / edge links to them as list columns, functionTerms as a json column,
@@ -3481,7 +3537,9 @@ class CxReader {
       }
       return found;
     };
-    const extra = Object.fromEntries(this.doc.kept);
+    const extra = Object.fromEntries(
+      [...this.doc.kept].filter(([name2]) => name2 !== STYLE_BLOCK_NAME)
+    );
     const groups = aspect(this.doc, "cyGroups").map((h) => plainJson(h.value));
     const own = {};
     if (groups.length > 0) {
@@ -3540,6 +3598,7 @@ const cxImporter = Object.freeze({
   options: Object.freeze(["zAs"]),
   extensions: Object.freeze([".cx"]),
   mimeTypes: Object.freeze(["application/json"]),
+  styles: readCxStyles,
   /**
    * Confidence that the head is CX version 1: 0.95 when a top-level array starts with an object
    * whose first key is numberVerification or metaData (Cytoscape's file filter), 0.7 for another
@@ -3628,4 +3687,4 @@ export {
   cxExporter as c,
   cxImporter as d
 };
-//# sourceMappingURL=importer-C98dpSH4.js.map
+//# sourceMappingURL=importer-B-9Rc1zO.js.map