@graphty/graph-io 0.3.8 → 0.3.10

package/dist/gml.js

@@ -1,6 +1,6 @@
-import { $ as SYNTAX_CODE, ax as joinText, ak as encodeChunks, ad as checkCapabilities, L as LOSS, az as pairFolding, ac as capabilities, aE as resolveExportOptions, a_ as DictHeuristic, aq as formatInteger, aG as sanitizeIds, aJ as countMixedEdges, al as explicitWeights, a$ as DICT_SAMPLE_ROWS, ap as formatGmlReal, X as ROLE_TAKEN_CODE$1, T as PRECISION_CODE$1, k as DUPLICATE_NODE_CODE$1, M as MISSING_ENDPOINT_CODE$1, y as MISSING_ID_CODE$1, A as MULTIPLE_GRAPHS_CODE, K as NO_GRAPH_CODE$1, aF as resolveImportOptions, I as ImportReportBuilder, aD as reportUnusedOptions, aB as readText, a as throwIfAborted, aC as reportSinkOptions, v as IdCoercer, l as DirectionResolver, aL as uniqueColumnName, aK as weightFromValue, aA as parseWeightText, ai as declareResolved, z as MIXED_DIRECTION_CODE, g as DIRECTION_FORCED_CODE, h as DIRECTION_REFUSED_CODE, Y as SINK_OPTION_CODE, P as OPTION_IGNORED_CODE, o as ID_MERGED_CODE, C as COLUMN_RENAMED_CODE, a5 as UNKNOWN_ENCODING_CODE, n as ENCODING_FALLBACK_CODE, s as INVALID_ENCODING_CODE, u as INVALID_UTF8_CODE } from "./chunks/writer-BdMak4_J.js";
+import { $ as SYNTAX_CODE, ax as joinText, ak as encodeChunks, ad as checkCapabilities, L as LOSS, az as pairFolding, ac as capabilities, aE as resolveExportOptions, a_ as DictHeuristic, aq as formatInteger, aG as sanitizeIds, aJ as countMixedEdges, al as explicitWeights, a$ as DICT_SAMPLE_ROWS, ap as formatGmlReal, X as ROLE_TAKEN_CODE$1, T as PRECISION_CODE$1, k as DUPLICATE_NODE_CODE$1, M as MISSING_ENDPOINT_CODE$1, y as MISSING_ID_CODE$1, A as MULTIPLE_GRAPHS_CODE, K as NO_GRAPH_CODE$1, aF as resolveImportOptions, I as ImportReportBuilder, aD as reportUnusedOptions, aB as readText, a as throwIfAborted, aC as reportSinkOptions, v as IdCoercer, l as DirectionResolver, aL as uniqueColumnName, aK as weightFromValue, aA as parseWeightText, ai as declareResolved, z as MIXED_DIRECTION_CODE, g as DIRECTION_FORCED_CODE, h as DIRECTION_REFUSED_CODE, Y as SINK_OPTION_CODE, P as OPTION_IGNORED_CODE, o as ID_MERGED_CODE, C as COLUMN_RENAMED_CODE, a5 as UNKNOWN_ENCODING_CODE, n as ENCODING_FALLBACK_CODE, s as INVALID_ENCODING_CODE, u as INVALID_UTF8_CODE } from "./chunks/writer-BtWpUaiH.js";
 import { GraphFormatError, INVALID_INDEX } from "@graphty/graph-format";
-import { j as decodeGmlString, k as quoteGmlString } from "./chunks/escape-BjmIaFFo.js";
+import { j as decodeGmlString, k as quoteGmlString } from "./chunks/escape-D1f9-cwf.js";
 const TOKEN_WORD = 0;
 const TOKEN_INT = 1;
 const TOKEN_REAL = 2;
@@ -395,7 +395,8 @@ const SKIPPED_ROLES = /* @__PURE__ */ new Set([
   "timestamp",
   "timestamps",
   "spells",
-  "open"
+  "open",
+  "spellsOpen"
 ]);
 const NODE_RESERVED = /* @__PURE__ */ new Set(["id"]);
 const EDGE_RESERVED = /* @__PURE__ */ new Set(["source", "target"]);
@@ -1349,6 +1350,7 @@ const MISSING_ID_CODE = MISSING_ID_CODE$1;
 const MISSING_LABEL_CODE = "E_GML_MISSING_LABEL";
 const MISSING_ENDPOINT_CODE = MISSING_ENDPOINT_CODE$1;
 const ID_TYPE_CODE = "E_GML_ID_TYPE";
+const STRING_ID_CODE = "W_GML_STRING_ID";
 const DUPLICATE_NODE_CODE = DUPLICATE_NODE_CODE$1;
 const REPEATED_KEY_CODE = "E_GML_REPEATED_KEY";
 const ELEMENT_TYPE_CODE = "E_GML_ELEMENT_TYPE";
@@ -1933,7 +1935,7 @@ class GmlImport {
       if (idTok < 0) {
         throw new GraphFormatError("E_INVALID_ID", "node has no id", { reason: "missing id" });
       }
-      const fileId = this.integerOf(idTok, "id");
+      const fileId = this.coerceFileId(idTok, this.fileIdOf(idTok, "id"));
       if (originalTok >= 0) {
         sinkId = this.restoredId(originalTok);
       } else {
@@ -1950,7 +1952,7 @@ class GmlImport {
             sinkId = ordinal;
             break;
           default:
-            sinkId = this.coerceInteger(idTok, fileId);
+            sinkId = fileId;
         }
       }
       if (this.idMap !== null) {
@@ -2080,23 +2082,46 @@ class GmlImport {
     return p + 1;
   }
   /**
-   * The integer value of an id / source / target token (the GML grammar's integer ids; a string
-   * id is refused, as the malformed corpus pins, although NetworkX would accept it).
+   * The value of an id / source / target token: an integer (the GML spec's type) as a number, a
+   * string (NetworkX and Gephi write them) as its text with one warning per file.
    * @param v - the value token
    * @param key - the key name, for the error
-   * @returns the number
+   * @returns the number or the string
    */
-  integerOf(v, key) {
+  fileIdOf(v, key) {
     const t = this.requireTokens();
+    if (t.kind[v] === TOKEN_STRING) {
+      this.report.warnOnce(
+        "validation-error",
+        STRING_ID_CODE,
+        `${key} is the string "${t.textOf(v)}"; GML ids are integers, string ids are kept under the ids rule`,
+        { line: t.line[v], element: t.stringOf(v) }
+      );
+      return t.stringOf(v);
+    }
     if (t.kind[v] !== TOKEN_INT) {
-      throw new GraphFormatError("E_INVALID_ID", `${key} must be an integer, found ${describeValue(t, v)}`, {
-        reason: "not an integer",
-        key,
-        value: t.kind[v] === TOKEN_OPEN ? "[...]" : t.textOf(v)
-      });
+      throw new GraphFormatError(
+        "E_INVALID_ID",
+        `${key} must be an integer or a string, found ${describeValue(t, v)}`,
+        {
+          reason: "not an integer",
+          key,
+          value: t.kind[v] === TOKEN_OPEN ? "[...]" : t.textOf(v)
+        }
+      );
     }
     return Number(t.textOf(v));
   }
+  /**
+   * Coerce an id / source / target value under the `ids` rule: a string by its text, an integer
+   * through coerceInteger().
+   * @param v - the value token
+   * @param id - its value (fileIdOf())
+   * @returns the id
+   */
+  coerceFileId(v, id) {
+    return typeof id === "string" ? this.coercer.text(id) : this.coerceInteger(v, id);
+  }
   /**
    * Coerce an integer id token under the `ids` rule: a safe integer passes as a typed number
    * (so `01` is 1 and `-0` is 0), a larger one goes through the text rule (a string under
@@ -2156,14 +2181,8 @@ class GmlImport {
    * @returns the id
    */
   endpoint(v, key) {
-    const n = this.integerOf(v, key);
-    if (this.idMap !== null) {
-      const mapped = this.idMap.get(n);
-      if (mapped !== void 0) {
-        return mapped;
-      }
-    }
-    return this.coerceInteger(v, n);
+    const id = this.coerceFileId(v, this.fileIdOf(v, key));
+    return this.idMap?.get(id) ?? id;
   }
   /**
    * The weight of an edge from its weight token.
@@ -2644,8 +2663,10 @@ const GML_ISSUE = Object.freeze({
   MISSING_LABEL: MISSING_LABEL_CODE,
   /** An edge without `source` or `target`. */
   MISSING_ENDPOINT: MISSING_ENDPOINT_CODE,
-  /** A node id, source or target that is not an integer. */
+  /** A node id, source or target that is neither an integer nor a string. */
   ID_TYPE: ID_TYPE_CODE,
+  /** String node ids, sources or targets (outside the spec's integers), kept under the ids rule; warned once. */
+  STRING_ID: STRING_ID_CODE,
   /** A node id declared twice (later keys overwrite). */
   DUPLICATE_NODE: DUPLICATE_NODE_CODE,
   /** A structural key repeated in one element. */