@graphty/graph-io 0.3.43 → 0.3.45

package/dist/chunks/{importer-Dz7tI8Sa.js → importer-EHQk1jbM.js}

@@ -1,9 +1,13 @@
 import { GraphFormatError, INVALID_INDEX } from "@graphty/graph-format";
-import { L as LOSS, r as resolveExportOptions, aE as sanitizeIds, a as checkCapabilities, p as pairFolding, b as plural, $ as agree, c as capabilities, a9 as idText, e as explicitWeights, av as formatNumber, aF as formatDecimal, aa as formatF32, aG as formatInteger, aH as canonicalId, P as PRECISION_CODE, o as DUPLICATE_ATTRIBUTE_CODE, S as SINK_OPTION_CODE, O as OPTION_IGNORED_CODE, R as ROLE_TAKEN_CODE, ay as RENAMED_CODE, I as ID_MERGED_CODE, n as DUPLICATE_NODE_CODE, ak as SYNTAX_CODE, ae as AMBIGUOUS_GRAPH_NAME_CODE, af as GRAPH_NOT_FOUND_CODE, l as MULTIPLE_GRAPHS_CODE, w as UNKNOWN_ENCODING_CODE, x as ENCODING_FALLBACK_CODE, y as INVALID_ENCODING_CODE, z as INVALID_UTF8_CODE, F as ELEMENT_ISSUE, G as INPUT_ISSUE, al as resolveImportOptions, a8 as ImportReportBuilder, an as reportUnusedOptions, az as LineReader, am as throwIfAborted, ap as graphChosen, ao as reportSinkOptions, aq as DirectionResolver, ar as IdCoercer, a0 as uniqueColumnName, a1 as declareResolved, aI as coerceIdText, aJ as isWeightField, aK as parseWeightText } from "./export-rKLeGQMo.js";
-import { i as isPajekLabel, q as quotePajekLabel } from "./escape-B62ZGM_a.js";
-import { i as inferTextDtype, W as WIDENING_UNSUPPORTED_CODE, a as isNumericText, T as TextCellWriter } from "./text-DHOJXnED.js";
+import { L as LOSS, c as capabilities, r as resolveExportOptions, G as sanitizeIds, p as pairFolding, a as checkCapabilities, e as explicitWeights, a1 as canonicalId, R as RENAMED_CODE, g as resolveImportOptions, i as reportUnusedOptions, P as LineReader, h as throwIfAborted, k as graphChosen, j as reportSinkOptions, l as DirectionResolver, I as IdCoercer, u as uniqueColumnName, d as declareResolved, a3 as coerceIdText, o as isWeightField, s as parseWeightText } from "./export-BvqAXCKh.js";
+import { g as isPajekLabel, j as quotePajekLabel } from "./escape-CgzxiYPg.js";
+import { p as plural, a as agree, _ as idText, ab as formatNumber, aO as formatDecimal, $ as formatF32, ad as formatInteger, P as PRECISION_CODE, l as DUPLICATE_ATTRIBUTE_CODE, S as SINK_OPTION_CODE, O as OPTION_IGNORED_CODE, R as ROLE_TAKEN_CODE, I as ID_MERGED_CODE, k as DUPLICATE_NODE_CODE, a8 as SYNTAX_CODE, a2 as AMBIGUOUS_GRAPH_NAME_CODE, a3 as GRAPH_NOT_FOUND_CODE, i as MULTIPLE_GRAPHS_CODE, s as UNKNOWN_ENCODING_CODE, t as ENCODING_FALLBACK_CODE, u as INVALID_ENCODING_CODE, v as INVALID_UTF8_CODE, y as ELEMENT_ISSUE, z as INPUT_ISSUE, Z as ImportReportBuilder } from "./format-BpQBx8MZ.js";
+import { i as inferTextDtype, W as WIDENING_UNSUPPORTED_CODE, a as isNumericText, T as TextCellWriter } from "./text-CzJNFOS9.js";
 import { j as joinText, e as encodeChunks } from "./writer-DxjgHwSe.js";
-import { i as importChosenGraph } from "./choose-DvpbdRuz.js";
+import { i as importChosenGraph } from "./choose--jM0yYCo.js";
+import { w as writeStyleBlock, c as styleBlockLosses, t as StyleNotes, p as plainCell, u as parseStyleBlock, s as styleFingerprint, v as blockStyles, r as resolveStyles, o as canonText, l as canonEnum, h as canonNumber, g as canonColor, x as colorOpacity, D as DVIPS_COLORS } from "./block-CPCHkX42.js";
+import { S as StyleApproximations } from "./approximations-DJMHdDvv.js";
+import { v as valueColumns } from "./styles-yed-Cz9rLBCP.js";
 const LABEL_COLUMN = "label";
 const POSITION_COLUMN = "position";
 const SHAPE_COLUMN = "shape";
@@ -13,7 +17,7 @@ const VALUE_COLUMN = "value";
 const VALUE_FIELD = "value";
 const PARTITION_COLUMN = "partition";
 const VECTOR_COLUMN = "vector";
-const SHAPES = /* @__PURE__ */ new Set([
+const SHAPES$1 = /* @__PURE__ */ new Set([
   "ellipse",
   "box",
   "diamond",
@@ -25,9 +29,10 @@ const SHAPES = /* @__PURE__ */ new Set([
   "woman"
 ]);
 function isShapeKeyword(token) {
-  return SHAPES.has(token.toLowerCase());
+  return SHAPES$1.has(token.toLowerCase());
 }
 const ORIGINAL_ID_KEY = "graphty_originalId";
+const PAJEK_STYLE_COMMENT = "% graphty.styles ";
 const SECTION_KINDS = /* @__PURE__ */ new Map([
   ["network", "network"],
   ["vertices", "vertices"],
@@ -321,6 +326,406 @@ function isParameterKey(text) {
   }
   return !/^[+-]?(\.\d|\d)/.test(text) && !/^[+-]?(?:nan|inf|infinity)$/i.test(text);
 }
+const PAJEK_STYLE_CAPABILITIES = Object.freeze({
+  node: Object.freeze([
+    "label",
+    "fill",
+    "fillOpacity",
+    "opacity",
+    "borderColor",
+    "borderWidth",
+    "shape",
+    "width",
+    "height",
+    "labelColor",
+    "labelSize"
+  ]),
+  edge: Object.freeze(["color", "opacity", "width", "lineStyle", "sourceArrow", "targetArrow"]),
+  block: "native"
+});
+const VERTEX_SIZE = 5;
+const NODE_KEYS = ["ic", "bc", "bw", "x_fact", "y_fact", "lc", "fos"];
+const EDGE_KEYS = ["c", "w", "p"];
+const DIRECTED_KEY = "directed";
+const READ = {
+  node: [
+    "label",
+    "shape",
+    "fill",
+    "fillOpacity",
+    "borderColor",
+    "borderWidth",
+    "width",
+    "height",
+    "labelColor",
+    "labelSize"
+  ],
+  edge: ["color", "opacity", "width", "lineStyle"]
+};
+function readColor(raw, property, opacity, put, at) {
+  if (raw === null) {
+    return;
+  }
+  const c = canonColor(raw, "dvips", at(property));
+  if (c === null) {
+    return;
+  }
+  put(property, c.color);
+  const alpha = colorOpacity(c, null, at(property), opacity !== null);
+  if (opacity !== null) {
+    put(opacity, alpha);
+  }
+}
+function readNumber(raw, property, put, at) {
+  if (raw !== null) {
+    put(property, canonNumber(raw, at(property)));
+  }
+}
+function readVertex(get, put, at) {
+  const label = get(LABEL_COLUMN);
+  if (label !== null && label !== "") {
+    put("label", canonText(label, at("label")));
+  }
+  const shape = get(SHAPE_COLUMN);
+  if (shape !== null) {
+    put("shape", canonEnum("shape", shape, "dvips", at("shape")));
+  }
+  readColor(get("ic"), "fill", "fillOpacity", put, at);
+  readColor(get("bc"), "borderColor", null, put, at);
+  const bw = get("bw");
+  if (bw !== null) {
+    const width = canonNumber(bw, at("borderWidth"));
+    put("borderWidth", width === null ? null : width / VERTEX_SIZE);
+  }
+  readNumber(get("x_fact"), "width", put, at);
+  readNumber(get("y_fact"), "height", put, at);
+  readColor(get("lc"), "labelColor", null, put, at);
+  readNumber(get("fos"), "labelSize", put, at);
+}
+function readLine(get, put, at) {
+  readColor(get("c"), "color", "opacity", put, at);
+  readNumber(get("w"), "width", put, at);
+  const p = get("p");
+  if (p !== null) {
+    put("lineStyle", canonEnum("lineStyle", p, "dvips", at("lineStyle")));
+  }
+}
+function cells(table, i) {
+  return (key) => table.has(key) ? plainCell(table.value(key, i)) : null;
+}
+function directedEdges(snapshot) {
+  const out = new Array(snapshot.edgeCount).fill(snapshot.directed);
+  const col = snapshot.directed ? snapshot.edges.byRole("directed") : null;
+  if (col !== null) {
+    for (let e = 0; e < snapshot.edgeCount; e++) {
+      out[e] = plainCell(col.value(e)) !== false;
+    }
+  }
+  return out;
+}
+function styleColumns(table, keys) {
+  return keys.filter((k) => table.has(k));
+}
+function pajekStyles(snapshot, context) {
+  const notes = new StyleNotes();
+  const read = (target) => {
+    const table = target === "node" ? snapshot.nodes : snapshot.edges;
+    const n = target === "node" ? snapshot.nodeCount : snapshot.edgeCount;
+    const out = valueColumns(n);
+    for (let i = 0; i < n; i++) {
+      context.budget.spend(target, 1);
+      const at = (property) => ({ notes, target, property, element: i, budget: context.budget });
+      (target === "node" ? readVertex : readLine)(
+        cells(table, i),
+        (property, value) => {
+          out.put(i, property, value);
+        },
+        at
+      );
+    }
+    return out.values;
+  };
+  const node = read("node");
+  const edge = read("edge");
+  const block = typeof context.kept === "string" ? context.kept : null;
+  if (block !== null) {
+    exactFromBlock(snapshot, block, { node, edge });
+  }
+  const rules = [];
+  const columns = /* @__PURE__ */ new Map();
+  const directed = directedEdges(snapshot);
+  if (directed.some(Boolean)) {
+    columns.set(
+      DIRECTED_KEY,
+      directed.map((d) => d ? true : null)
+    );
+    rules.push({
+      id: "edge.tool.arrow",
+      target: "edge",
+      role: "group",
+      origin: "tool",
+      where: { has: { style: DIRECTED_KEY } },
+      set: { targetArrow: "triangle" }
+    });
+  }
+  return {
+    canonical: true,
+    dialect: "dvips",
+    tool: "pajek",
+    units: "relative",
+    node: { values: node },
+    edge: { values: edge, rules, columns },
+    notes: notes.list(),
+    block,
+    readFrom: {
+      node: styleColumns(snapshot.nodes, [SHAPE_COLUMN, ...NODE_KEYS]),
+      edge: styleColumns(snapshot.edges, EDGE_KEYS)
+    }
+  };
+}
+const SHAPES = /* @__PURE__ */ new Map([
+  ["ellipse", "ellipse"],
+  ["rectangle", "box"],
+  ["diamond", "diamond"],
+  ["triangle", "triangle"],
+  ["none", "empty"],
+  ["other:cross", "cross"],
+  ["other:house", "house"],
+  ["other:man", "man"],
+  ["other:woman", "woman"]
+]);
+const NEAREST_SHAPES = /* @__PURE__ */ new Map([
+  ["round-rectangle", "box"],
+  ["parallelogram", "box"],
+  ["trapezoid", "box"],
+  ["vee", "triangle"]
+]);
+const DVIPS_NAMES = new Map(
+  [...DVIPS_COLORS].reverse().map(([name, hex]) => [hex, name])
+);
+function pajekColorText(color) {
+  return DVIPS_NAMES.get(color) ?? `RGB${color.slice(1).toUpperCase()}`;
+}
+function opaque(get, properties, approximate) {
+  for (const property of properties) {
+    const v = get(property);
+    if (v !== null && v !== 1) {
+      approximate(property, v);
+    }
+  }
+}
+function shapeKeyword(get, approximate) {
+  const shape = get("shape");
+  if (typeof shape !== "string") {
+    return "ellipse";
+  }
+  const keyword = SHAPES.get(shape);
+  if (keyword !== void 0) {
+    return keyword;
+  }
+  approximate("shape", shape);
+  return NEAREST_SHAPES.get(shape) ?? "ellipse";
+}
+function vertexParams(get, approximate) {
+  const out = /* @__PURE__ */ new Map();
+  opaque(get, ["fillOpacity", "opacity"], approximate);
+  const keyword = shapeKeyword(get, approximate);
+  if (keyword !== "ellipse") {
+    out.set(SHAPE_COLUMN, keyword);
+  }
+  const colors = [
+    ["fill", "ic"],
+    ["borderColor", "bc"],
+    ["labelColor", "lc"]
+  ];
+  const numbers = [
+    ["width", "x_fact"],
+    ["height", "y_fact"],
+    ["labelSize", "fos"]
+  ];
+  for (const [property, key] of colors) {
+    const v = get(property);
+    if (typeof v === "string" && !(property === "borderColor" && v === "#000000")) {
+      out.set(key, pajekColorText(v));
+    }
+  }
+  for (const [property, key] of numbers) {
+    const v = get(property);
+    if (typeof v === "number") {
+      out.set(key, v);
+    }
+  }
+  const bw = get("borderWidth");
+  if (typeof bw === "number") {
+    const written = Number((bw * VERTEX_SIZE).toPrecision(15));
+    if (written === 1) {
+      out.delete("bw");
+    } else {
+      out.set("bw", written);
+    }
+  }
+  return out;
+}
+function lineParams(get, directed, approximate) {
+  const out = /* @__PURE__ */ new Map();
+  opaque(get, ["opacity"], approximate);
+  const color = get("color");
+  if (typeof color === "string" && color !== "#000000") {
+    out.set("c", pajekColorText(color));
+  }
+  const width = get("width");
+  if (typeof width === "number") {
+    out.set("w", width);
+  }
+  const lineStyle = get("lineStyle");
+  if (typeof lineStyle === "string" && lineStyle !== "solid" && pajekDots(lineStyle, approximate)) {
+    out.set("p", "Dots");
+  }
+  const target = get("targetArrow");
+  if (target !== null && target !== (directed ? "triangle" : "none")) {
+    approximate("targetArrow", target);
+  }
+  const source = get("sourceArrow");
+  if (source !== null && source !== "none") {
+    approximate("sourceArrow", source);
+  }
+  return out;
+}
+function pajekDots(lineStyle, approximate) {
+  if (lineStyle === "dotted") {
+    return true;
+  }
+  approximate("lineStyle", lineStyle);
+  return lineStyle === "dashed" || lineStyle === "dash-dot" || lineStyle === "long-dash";
+}
+function getter(picture, target) {
+  const columns = /* @__PURE__ */ new Map();
+  for (const p of PAJEK_STYLE_CAPABILITIES[target]) {
+    columns.set(p, picture(target, p));
+  }
+  return (i) => (property) => columns.get(property)?.[i] ?? null;
+}
+function exactFromBlock(snapshot, text, read) {
+  const parsed = parseStyleBlock(text, styleFingerprint(snapshot));
+  const ex = parsed.ok ? blockStyles(parsed.block, snapshot, "pajek") : null;
+  if (ex === null) {
+    return;
+  }
+  const notes = new StyleNotes();
+  const directed = directedEdges(snapshot);
+  for (const target of ["node", "edge"]) {
+    const n = target === "node" ? snapshot.nodeCount : snapshot.edgeCount;
+    const get = getter((t, p) => resolveStyles(ex, t, p, snapshot), target);
+    const values = read[target];
+    for (let i = 0; i < n; i++) {
+      const want = get(i);
+      const back = writtenAndReadBack(target, want, directed[i], notes);
+      for (const property of READ[target]) {
+        const native = values[property]?.[i] ?? null;
+        const w = want(property);
+        if (w !== null && native !== w && native === (back.get(property) ?? null)) {
+          values[property] ??= new Array(n).fill(null);
+          values[property][i] = w;
+        }
+      }
+    }
+  }
+}
+function writtenAndReadBack(target, want, directed, notes) {
+  const ignore = () => void 0;
+  const params = target === "node" ? vertexParams(want, ignore) : lineParams(want, directed, ignore);
+  const back = /* @__PURE__ */ new Map();
+  const label = target === "node" ? want("label") : null;
+  if (typeof label === "string") {
+    params.set(LABEL_COLUMN, pajekLabelText(label));
+  }
+  (target === "node" ? readVertex : readLine)(
+    (key) => params.get(key) ?? null,
+    (property, value) => {
+      if (value !== null) {
+        back.set(property, value);
+      }
+    },
+    (property) => ({ notes, target, property })
+  );
+  return back;
+}
+function pajekStyledExport(snapshot, input) {
+  if (input === void 0) {
+    return null;
+  }
+  const approximated = new StyleApproximations();
+  const out = snapshot.withColumns();
+  const directed = directedEdges(snapshot);
+  for (const target of ["node", "edge"]) {
+    const table = target === "node" ? out.nodes : out.edges;
+    const approximate = (property, value) => {
+      approximated.add(target, property, value);
+    };
+    const get = getter((t, p) => input.picture(t, p), target);
+    const n = target === "node" ? snapshot.nodeCount : snapshot.edgeCount;
+    const params = (i) => target === "node" ? vertexParams(get(i), approximate) : lineParams(get(i), directed[i], approximate);
+    replaceParamColumns(
+      table,
+      target === "node" ? [SHAPE_COLUMN, ...NODE_KEYS] : EDGE_KEYS,
+      paramColumns(n, params)
+    );
+  }
+  out.nodes.set(
+    LABEL_COLUMN,
+    drawnLabels(input, snapshot.nodeCount, approximated),
+    { dtype: "string", role: "label" },
+    {
+      replaceRole: true
+    }
+  );
+  const notes = approximated.notes("Pajek");
+  const block = writeStyleBlock(input.rules, { inlineColumns: true, snapshot });
+  notes.push(...styleBlockLosses(block, input.rules.styles.rules.length, "size"));
+  return { snapshot: out, comment: PAJEK_STYLE_COMMENT + block, notes };
+}
+function drawnLabels(input, n, approximated) {
+  const drawn = input.picture("node", "label");
+  const out = new Array(n).fill("");
+  for (let i = 0; i < n; i++) {
+    const v = drawn[i] ?? null;
+    if (typeof v === "string") {
+      out[i] = pajekLabelText(v);
+      if (out[i] !== v) {
+        approximated.add("node", "label", v);
+      }
+    }
+  }
+  return out;
+}
+function pajekLabelText(label) {
+  return label.replaceAll(/\r\n|[\r\n]/g, " ").replaceAll('"', "'");
+}
+function replaceParamColumns(table, keys, columns) {
+  for (const key of keys) {
+    if (table.has(key)) {
+      table.remove(key);
+    }
+  }
+  for (const [key, col] of columns) {
+    const numeric = col.every((v) => v === null || typeof v === "number");
+    table.set(key, col, { dtype: numeric ? "f64" : "string" });
+  }
+}
+function paramColumns(n, params) {
+  const columns = /* @__PURE__ */ new Map();
+  for (let i = 0; i < n; i++) {
+    for (const [key, value] of params(i)) {
+      let col = columns.get(key);
+      if (col === void 0) {
+        col = new Array(n).fill(null);
+        columns.set(key, col);
+      }
+      col[i] = value;
+    }
+  }
+  return columns;
+}
 const PAJEK_LOSS = Object.freeze({
   /**
    * A label or text value holds a double quote or a line break, which Pajek cannot write; the save fails with
@@ -361,6 +766,8 @@ const PAJEK_LOSS = Object.freeze({
    * reads back with that role.
    */
   ROLE_ASSUMED: LOSS.ROLE_ASSUMED,
+  /** The label column, when a role-less column named `label` is read over it on import. */
+  COLUMN_DROPPED: LOSS.COLUMN_DROPPED,
   /**
    * With `sanitizeIds: "mangle"`: an original id that reads back as a different type, such as the text "7" as the
    * number 7.
@@ -544,16 +951,18 @@ function labelNotes(snapshot, nodePlan, notes) {
         plain.length - plain.nullCount
       )
     );
-  }
-  if (carried === 0) {
-    return;
-  }
-  let gained = 0;
-  for (let i = 0; i < snapshot.nodeCount; i++) {
-    if (!labels?.isSet(i)) {
-      gained++;
+    if (labels !== null && labels !== plain) {
+      notes.push(
+        note(
+          PAJEK_LOSS.COLUMN_DROPPED,
+          `node column "${labels.meta.name}" (the labels) reads back replaced by the parameter "${LABEL_COLUMN}"`,
+          labels.meta.name,
+          labels.length - labels.nullCount
+        )
+      );
     }
   }
+  const gained = carried === 0 ? 0 : unlabeled(snapshot.nodeCount, labels);
   if (gained > 0) {
     notes.push(
       note(
@@ -565,9 +974,18 @@ function labelNotes(snapshot, nodePlan, notes) {
     );
   }
 }
+function unlabeled(nodeCount, labels) {
+  let count = 0;
+  for (let i = 0; i < nodeCount; i++) {
+    if (!labels?.isSet(i)) {
+      count++;
+    }
+  }
+  return count;
+}
 function allShapeKeywords(column) {
   for (let r = 0; r < column.length; r++) {
-    if (column.isSet(r) && !SHAPES.has(column.value(r))) {
+    if (column.isSet(r) && !SHAPES$1.has(column.value(r))) {
       return false;
     }
   }
@@ -755,7 +1173,7 @@ function needsZ(column) {
   }
   return false;
 }
-function* writeParts(snapshot, options) {
+function* writeParts(snapshot, options, comment = null) {
   const ids = sanitizeIds(snapshot, CAPABILITIES.idCharset, options.mangle ? "mangle" : "error");
   const nodePlan = withoutReservedKey(plan(snapshot.nodes, "node", null), options.mangle);
   const edgePlan = plan(snapshot.edges, "edge", null);
@@ -772,6 +1190,10 @@ function* writeParts(snapshot, options) {
       });
     }
   }
+  if (comment !== null) {
+    yield `${comment}
+`;
+  }
   if (options.networkHeader) {
     yield options.name === null ? "*Network\n" : `*Network ${options.name}
 `;
@@ -868,7 +1290,7 @@ function* writeVertices(snapshot, ids, nodePlan, mangle) {
     }
     if (shape?.isSet(i)) {
       const keyword = cellText(shape, i);
-      if (SHAPES.has(keyword)) {
+      if (SHAPES$1.has(keyword)) {
         parts.push(keyword);
       } else {
         parts.push(`${SHAPE_COLUMN} ${quotePajekLabel(keyword)}`);
@@ -1007,96 +1429,20 @@ const pajekExporter = Object.freeze({
   format: "pajek",
   options: Object.freeze(["name", "networkHeader"]),
   capabilities: CAPABILITIES,
+  styles: Object.freeze({ capabilities: PAJEK_STYLE_CAPABILITIES }),
   /**
-   * Pre-flight: the generic capability gaps plus the Pajek-specific ones.
+   * Pre-flight: the generic capability gaps plus the Pajek-specific ones; with styles, also the values written as
+   * the nearest ones Pajek has.
    * @param snapshot - the snapshot
    * @param options - export options
    * @returns the loss notes, empty when the export is exact
    */
   check(snapshot, options) {
-    const resolved = resolveExportOptions(options);
-    const { mangle } = resolvePajekOptions(snapshot, options);
-    const notes = [];
-    const planned = plan(snapshot.nodes, "node", notes);
-    const nodePlan = withoutReservedKey(planned, mangle);
-    const edgePlan = plan(snapshot.edges, "edge", notes);
-    const ids = sanitizeIds(snapshot, CAPABILITIES.idCharset, mangle ? "mangle" : "error");
-    checkIdTexts(snapshot.nodeCount, ids, mangle, notes);
-    if (nodePlan.length !== planned.length) {
-      const reserved = planned.find((p) => p.slot === "param" && p.column.meta.name === ORIGINAL_ID_KEY);
-      if (reserved !== void 0) {
-        notes.push(
-          note(
-            PAJEK_LOSS.KEY_DROPPED,
-            `node column "${ORIGINAL_ID_KEY}" is the parameter the exporter writes the original ids under (sanitizeIds "mangle"); it is not written`,
-            ORIGINAL_ID_KEY,
-            reserved.column.length - reserved.column.nullCount
-          )
-        );
-      }
-    }
-    const owned = /* @__PURE__ */ new Set();
-    for (const { column, slot } of [...nodePlan, ...edgePlan]) {
-      if (slot === "shape" || slot === "relation" || slot === "param" && column.meta.domain === "node" && column.meta.name === SHAPE_COLUMN) {
-        owned.add(`${column.meta.domain}:${column.meta.name}`);
-      }
-    }
-    for (const table of [snapshot.nodes, snapshot.edges]) {
-      for (const column of table) {
-        if (column.meta.role === "spells") {
-          owned.add(`${column.meta.domain}:${column.meta.name}`);
-        }
-      }
-    }
-    for (const n of checkCapabilities(snapshot, CAPABILITIES, resolved, {
-      roles: SLOT_ROLES,
-      roleNames: ROLE_NAMES,
-      // the label slot is a vertex slot; an edge label is a parameter under its own name
-      edgeRoleNames: {}
-    })) {
-      if (n.column !== null && (n.code === LOSS.LIST || n.code === LOSS.DTYPE)) {
-        const domain = n.message.startsWith("node column") ? "node" : "edge";
-        if (owned.has(`${domain}:${n.column}`)) {
-          continue;
-        }
-      }
-      notes.push(n);
-    }
-    labelNotes(snapshot, nodePlan, notes);
-    for (const column of snapshot.edges) {
-      if (column.meta.role === "label") {
-        notes.push(
-          note(
-            LOSS.ROLE,
-            `edge column "${column.meta.name}" (label) is written as a plain parameter; Pajek labels vertices only and the role is lost`,
-            column.meta.name,
-            column.length - column.nullCount
-          )
-        );
-      }
-    }
-    checkCells(nodePlan, "node", notes);
-    checkCells(edgePlan, "edge", notes);
-    const folding = pairFolding(snapshot, { foldMutual: true });
-    if (folding.mutualCount > 0) {
-      notes.push(
-        note(
-          PAJEK_LOSS.MUTUAL_AS_UNDIRECTED,
-          `${folding.mutualCount} mutual pair${plural(folding.mutualCount)} ${agree(folding.mutualCount, "is", "are")} written as undirected edges; the mutual mark is lost`,
-          snapshot.edges.byRole("mutual")?.meta.name ?? null,
-          folding.mutualCount
-        )
-      );
-    }
-    if (Number.isNaN(firstModeOf(snapshot))) {
-      notes.push(
-        note(
-          PAJEK_LOSS.FIRST_MODE_DROPPED,
-          "meta.extra.pajek.firstMode is not a count within 0..nodeCount; the two-mode header is not written"
-        )
-      );
+    const styled = pajekStyledExport(snapshot, options?.styles);
+    if (styled === null) {
+      return checkPlain(snapshot, options);
     }
-    return notes;
+    return Object.freeze([...checkPlain(styled.snapshot, withOriginalIds(options)), ...styled.notes]);
   },
   /**
    * Write the snapshot as UTF-8 chunks.
@@ -1105,8 +1451,7 @@ const pajekExporter = Object.freeze({
    * @returns the chunks
    */
   export(snapshot, options) {
-    const resolved = resolvePajekOptions(snapshot, options);
-    return encodeChunks(writeParts(snapshot, resolved));
+    return encodeChunks(styledParts(snapshot, options));
   },
   /**
    * Write the snapshot as one string.
@@ -1115,10 +1460,106 @@ const pajekExporter = Object.freeze({
    * @returns the document
    */
   exportToString(snapshot, options) {
-    const resolved = resolvePajekOptions(snapshot, options);
-    return joinText(writeParts(snapshot, resolved));
+    return joinText(styledParts(snapshot, options));
   }
 });
+function styledParts(snapshot, options) {
+  const styled = pajekStyledExport(snapshot, options?.styles);
+  if (styled === null) {
+    return writeParts(snapshot, resolvePajekOptions(snapshot, options));
+  }
+  return writeParts(styled.snapshot, resolvePajekOptions(styled.snapshot, withOriginalIds(options)), styled.comment);
+}
+function withOriginalIds(options) {
+  return options?.sanitizeIds === void 0 ? { ...options, sanitizeIds: "mangle" } : options;
+}
+function ownedColumns(snapshot, planned) {
+  const owned = /* @__PURE__ */ new Set();
+  const key = (column) => `${column.meta.domain}:${column.meta.name}`;
+  for (const { column, slot } of planned) {
+    const shapeParam = slot === "param" && column.meta.domain === "node" && column.meta.name === SHAPE_COLUMN;
+    if (slot === "shape" || slot === "relation" || shapeParam) {
+      owned.add(key(column));
+    }
+  }
+  for (const column of [...snapshot.nodes, ...snapshot.edges]) {
+    if (column.meta.role === "spells") {
+      owned.add(key(column));
+    }
+  }
+  return owned;
+}
+function capabilityNotes(snapshot, resolved, owned) {
+  const notes = checkCapabilities(snapshot, CAPABILITIES, resolved, {
+    roles: SLOT_ROLES,
+    roleNames: ROLE_NAMES,
+    // the label slot is a vertex slot; an edge label is a parameter under its own name
+    edgeRoleNames: {}
+  });
+  return notes.filter((n) => {
+    if (n.column === null || n.code !== LOSS.LIST && n.code !== LOSS.DTYPE) {
+      return true;
+    }
+    const domain = n.message.startsWith("node column") ? "node" : "edge";
+    return !owned.has(`${domain}:${n.column}`);
+  });
+}
+function checkPlain(snapshot, options) {
+  const resolved = resolveExportOptions(options);
+  const { mangle } = resolvePajekOptions(snapshot, options);
+  const notes = [];
+  const planned = plan(snapshot.nodes, "node", notes);
+  const nodePlan = withoutReservedKey(planned, mangle);
+  const edgePlan = plan(snapshot.edges, "edge", notes);
+  const ids = sanitizeIds(snapshot, CAPABILITIES.idCharset, mangle ? "mangle" : "error");
+  checkIdTexts(snapshot.nodeCount, ids, mangle, notes);
+  const reserved = nodePlan.length === planned.length ? void 0 : planned.find((p) => p.slot === "param" && p.column.meta.name === ORIGINAL_ID_KEY);
+  if (reserved !== void 0) {
+    notes.push(
+      note(
+        PAJEK_LOSS.KEY_DROPPED,
+        `node column "${ORIGINAL_ID_KEY}" is the parameter the exporter writes the original ids under (sanitizeIds "mangle"); it is not written`,
+        ORIGINAL_ID_KEY,
+        reserved.column.length - reserved.column.nullCount
+      )
+    );
+  }
+  const owned = ownedColumns(snapshot, [...nodePlan, ...edgePlan]);
+  notes.push(...capabilityNotes(snapshot, resolved, owned));
+  labelNotes(snapshot, nodePlan, notes);
+  for (const column of [...snapshot.edges].filter((c) => c.meta.role === "label")) {
+    notes.push(
+      note(
+        LOSS.ROLE,
+        `edge column "${column.meta.name}" (label) is written as a plain parameter; Pajek labels vertices only and the role is lost`,
+        column.meta.name,
+        column.length - column.nullCount
+      )
+    );
+  }
+  checkCells(nodePlan, "node", notes);
+  checkCells(edgePlan, "edge", notes);
+  const folding = pairFolding(snapshot, { foldMutual: true });
+  if (folding.mutualCount > 0) {
+    notes.push(
+      note(
+        PAJEK_LOSS.MUTUAL_AS_UNDIRECTED,
+        `${folding.mutualCount} mutual pair${plural(folding.mutualCount)} ${agree(folding.mutualCount, "is", "are")} written as undirected edges; the mutual mark is lost`,
+        snapshot.edges.byRole("mutual")?.meta.name ?? null,
+        folding.mutualCount
+      )
+    );
+  }
+  if (Number.isNaN(firstModeOf(snapshot))) {
+    notes.push(
+      note(
+        PAJEK_LOSS.FIRST_MODE_DROPPED,
+        "meta.extra.pajek.firstMode is not a count within 0..nodeCount; the two-mode header is not written"
+      )
+    );
+  }
+  return notes;
+}
 const PAJEK_ISSUE = Object.freeze({
   ...INPUT_ISSUE,
   ...ELEMENT_ISSUE,
@@ -1230,7 +1671,11 @@ const PAJEK_ISSUE = Object.freeze({
   /** A negative vertex number in an adjacency list, read as its absolute value. */
   NEGATIVE_LIST_ENTRY: "W_PAJEK_NEGATIVE_LIST_ENTRY",
   /** An integer beyond 2^53 was stored as the nearest 64-bit float; pass `long: "string"` to keep every digit. */
-  PRECISION: PRECISION_CODE
+  PRECISION: PRECISION_CODE,
+  /** A number alone at the end of a row, after its parameters (Pajek writes a trailing `0`); it is ignored. */
+  TRAILING_VALUE: "W_PAJEK_TRAILING_VALUE",
+  /** A line whose value is `NaN`; the line is kept without a value. */
+  NAN_VALUE: "W_PAJEK_NAN_VALUE"
 });
 const USED_OPTIONS = /* @__PURE__ */ new Set([
   "ids",
@@ -1252,6 +1697,7 @@ const ABORT_CHECK_INTERVAL = 64;
 const FIRST_VERTEX_VALUES = /* @__PURE__ */ new Set([0, 1, "auto"]);
 const NUMERAL = /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i;
 const NON_FINITE_WORD = /^[+-]?(?:nan|inf|infinity)$/i;
+const NAN_WORD = /^[+-]?nan$/i;
 const LABEL_DECL = {
   name: LABEL_COLUMN,
   dtype: "string",
@@ -1290,7 +1736,9 @@ function positionDecl(sourceDims) {
     nullable: true,
     role: "position",
     origin: { format: "pajek", id: "coordinates" },
-    extra: { sourceDims, units: "file" }
+    // Pajek draws y downward (USAir97.net has Deadhorse, Alaska at y 0.10 and Miami at 0.53),
+    // centers depth on 0.5, and NetworkX writes "0.0 0.0" for a node with no position
+    extra: { sourceDims, units: "file", yAxis: "down", zOrigin: 0.5, zeroUnplaced: true }
   };
 }
 class LineError extends Error {
@@ -1356,6 +1804,7 @@ class PajekParser {
     this.nodeParams = /* @__PURE__ */ new Map();
     this.ended = false;
     this.edgeParams = /* @__PURE__ */ new Map();
+    this.styleBlockKept = false;
     this.sink = sink;
     this.report = report;
     this.options = options;
@@ -1363,6 +1812,21 @@ class PajekParser {
     this.resolver = new DirectionResolver(sink, report, options.onMixedDirection);
     this.coercer = new IdCoercer(options.ids);
   }
+  /**
+   * Keep the first `% graphty.styles <json>` comment for the style reader (a file graphty wrote carries its styles
+   * there; Pajek skips comment lines).
+   * @param text - a comment or blank line
+   */
+  comment(text) {
+    if (this.styleBlockKept) {
+      return;
+    }
+    const trimmed = text.trimStart();
+    if (trimmed.startsWith(PAJEK_STYLE_COMMENT)) {
+      this.styleBlockKept = true;
+      this.report.keepForStyles(trimmed.slice(PAJEK_STYLE_COMMENT.length));
+    }
+  }
   /**
    * Handle one line; every problem of the line is recorded as an issue and the line skipped.
    * @param text - the line without its terminator
@@ -1371,6 +1835,7 @@ class PajekParser {
    */
   line(text, line) {
     if (isCommentOrBlank(text)) {
+      this.comment(text);
       return false;
     }
     const afterObjectHeader = this.objectHeader;
@@ -1879,6 +2344,7 @@ class PajekParser {
       i++;
     }
     const extras = this.extras(tokens, i, "node", line);
+    shape = extras.shape ?? shape;
     const restored = this.restoredId(extras);
     this.createNodes();
     const repeated = this.seen[pos] !== 0;
@@ -2115,6 +2581,14 @@ class PajekParser {
     if (i < tokens.length && isNumericText(tokens[i])) {
       valueText = tokens[i];
       i++;
+    } else if (i < tokens.length && NAN_WORD.test(tokens[i])) {
+      this.report.warnOnce(
+        "validation-error",
+        PAJEK_ISSUE.NAN_VALUE,
+        `a line value ${JSON.stringify(tokens[i])} is not a number; the line is kept without a value`,
+        { line }
+      );
+      i++;
     }
     const extras = this.extras(tokens, i, "edge", line);
     const { weightFrom } = this.options;
@@ -2380,7 +2854,7 @@ class PajekParser {
    * @returns the parsed extras
    */
   extras(tokens, start, domain, line) {
-    const extras = { keys: [], values: [], spells: null };
+    const extras = { keys: [], values: [], spells: null, shape: null };
     const seen = /* @__PURE__ */ new Set();
     for (let i = start; i < tokens.length; ) {
       const token = tokens[i];
@@ -2389,13 +2863,14 @@ class PajekParser {
         i++;
         continue;
       }
+      if (domain === "node" && isShapeKeyword(token)) {
+        extras.shape = token.toLowerCase();
+        i++;
+        continue;
+      }
       if (i + 1 >= tokens.length) {
-        this.skip(domain);
-        throw new LineError(
-          "parse-error",
-          domain === "node" ? PAJEK_ISSUE.VERTEX_LINE : PAJEK_ISSUE.LINE,
-          `parameter "${token}" has no value`
-        );
+        this.loneLastToken(token, domain, line);
+        break;
       }
       if (seen.has(token)) {
         this.report.warning(
@@ -2412,6 +2887,30 @@ class PajekParser {
     }
     return extras;
   }
+  /**
+   * A token alone at the end of a row, with no value after it: a number is ignored (reported once);
+   * anything else is a parameter without its value, which skips the row.
+   * @param token - the token
+   * @param domain - what is skipped when the row is malformed
+   * @param line - the line number
+   */
+  loneLastToken(token, domain, line) {
+    if (isNumericText(token)) {
+      this.report.warnOnce(
+        "validation-error",
+        PAJEK_ISSUE.TRAILING_VALUE,
+        `the number ${JSON.stringify(token)} alone at the end of a row is not a parameter; it is ignored`,
+        { line }
+      );
+      return;
+    }
+    this.skip(domain);
+    throw new LineError(
+      "parse-error",
+      domain === "node" ? PAJEK_ISSUE.VERTEX_LINE : PAJEK_ISSUE.LINE,
+      `parameter "${token}" has no value`
+    );
+  }
   /**
    * The spells of a row's interval token; a malformed one skips the row.
    * @param token - the token, starting with "["
@@ -2516,6 +3015,7 @@ const pajekImporter = Object.freeze({
   options: Object.freeze(["firstVertex"]),
   extensions: Object.freeze([".net", ".paj"]),
   mimeTypes: Object.freeze(["text/x-pajek", "text/plain"]),
+  styles: pajekStyles,
   /**
    * Confidence that the input is a Pajek network: it starts with `*Vertices` (or `*Network`),
    * after any `%` comment lines.
@@ -2671,7 +3171,9 @@ class NetworkCounter {
 export {
   PAJEK_ISSUE as P,
   PAJEK_LOSS as a,
-  pajekImporter as b,
+  PAJEK_STYLE_CAPABILITIES as b,
+  PAJEK_STYLE_COMMENT as c,
+  pajekImporter as d,
   pajekExporter as p
 };
-//# sourceMappingURL=importer-Dz7tI8Sa.js.map
+//# sourceMappingURL=importer-EHQk1jbM.js.map