@graphty/graph-io 0.2.4 → 0.3.0

package/dist/gml.js

@@ -1,6 +1,6 @@
-import { Z as SYNTAX_CODE, au as joinText, ah as encodeChunks, aa as checkCapabilities, L as LOSS, aw as pairFolding, a9 as capabilities, aB as resolveExportOptions, aX as DictHeuristic, an as formatInteger, aD as sanitizeIds, aG as countMixedEdges, ai as explicitWeights, aY as DICT_SAMPLE_ROWS, am as formatGmlReal, V as ROLE_TAKEN_CODE$1, R as PRECISION_CODE$1, k as DUPLICATE_NODE_CODE$1, M as MISSING_ENDPOINT_CODE$1, w as MISSING_ID_CODE$1, G as NO_GRAPH_CODE$1, aC as resolveImportOptions, I as ImportReportBuilder, az as reportSinkOptions, aA as reportUnusedOptions, ay as readText, a as throwIfAborted, s as IdCoercer, l as DirectionResolver, aI as uniqueColumnName, aH as weightFromValue, ax as parseWeightText, af as declareResolved, x as MIXED_DIRECTION_CODE, g as DIRECTION_FORCED_CODE, h as DIRECTION_REFUSED_CODE, W as SINK_OPTION_CODE, J as OPTION_IGNORED_CODE, n as ID_MERGED_CODE, C as COLUMN_RENAMED_CODE, r as INVALID_UTF8_CODE } from "./chunks/writer-DxSKC7TL.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-BdMak4_J.js";
 import { GraphFormatError, INVALID_INDEX } from "@graphty/graph-format";
-import { g as decodeGmlString, j as quoteGmlString } from "./chunks/escape-DyI8JofU.js";
+import { j as decodeGmlString, k as quoteGmlString } from "./chunks/escape-CKied3Ri.js";
 const TOKEN_WORD = 0;
 const TOKEN_INT = 1;
 const TOKEN_REAL = 2;
@@ -1336,7 +1336,7 @@ function* lazyParts(snapshot, options) {
   yield* gmlParts(contextOf(snapshot, options));
 }
 const NO_GRAPH_CODE = NO_GRAPH_CODE$1;
-const SECOND_GRAPH_CODE = "E_GML_SECOND_GRAPH";
+const SECOND_GRAPH_CODE = MULTIPLE_GRAPHS_CODE;
 const MISSING_ID_CODE = MISSING_ID_CODE$1;
 const MISSING_LABEL_CODE = "E_GML_MISSING_LABEL";
 const MISSING_ENDPOINT_CODE = MISSING_ENDPOINT_CODE$1;
@@ -1395,9 +1395,12 @@ class GmlImport {
    * @param report - the report
    * @param options - the resolved common options
    * @param format - the format-specific options
+   * @param which - which `graph [ ... ]` block to read (0: the first)
    */
-  constructor(sink, report, options, format) {
+  constructor(sink, report, options, format, which = 0) {
+    this.which = which;
     this.tokens = null;
+    this.graphCount = 0;
     this.resolver = null;
     this.nodeSchema = /* @__PURE__ */ new Map();
     this.edgeSchema = /* @__PURE__ */ new Map();
@@ -1434,19 +1437,11 @@ class GmlImport {
     this.coercer = new IdCoercer(options.ids);
   }
   /**
-   * Run the import over a text.
-   * @param text - the whole GML text
+   * Run the import over the tokens of a text.
+   * @param tokens - the whole text, tokenized (tokenize())
    */
-  run(text) {
-    const { report } = this;
-    try {
-      this.tokens = tokenizeGml(text);
-    } catch (err) {
-      if (err instanceof GmlSyntaxError) {
-        report.fail(err.code, err.message, { line: err.line });
-      }
-      throw err;
-    }
+  run(tokens) {
+    this.tokens = tokens;
     this.scan();
     this.push();
   }
@@ -1462,13 +1457,10 @@ class GmlImport {
       const v = p + 1;
       const record = t.kind[v] === TOKEN_OPEN;
       if (key === "graph" && record) {
-        if (this.graphOpen >= 0) {
-          this.report.fail(SECOND_GRAPH_CODE, "the input contains more than one graph", {
-            line: t.line[p]
-          });
+        if (this.graphCount++ === this.which) {
+          this.graphOpen = v;
+          this.scanGraph(v);
         }
-        this.graphOpen = v;
-        this.scanGraph(v);
       } else if (key === "Creator" && !record && this.creatorToken < 0) {
         this.creatorToken = v;
       } else if (key === "Version" && !record && this.versionToken < 0) {
@@ -2559,22 +2551,74 @@ const gmlImporter = Object.freeze({
     const report = new ImportReportBuilder("gml", resolved.errorLimit);
     reportSinkOptions(sink, options, report);
     reportUnusedOptions(options, report, USED_OPTIONS);
-    const text = await readText(input, report, resolved);
+    const tokens = tokenize(await readText(input, report, resolved), report);
     throwIfAborted(resolved.signal);
-    new GmlImport(sink, report, resolved, options).run(text);
+    const gml = new GmlImport(sink, report, resolved, options);
+    gml.run(tokens);
+    if (gml.graphCount > 1) {
+      report.warning(
+        "unsupported",
+        SECOND_GRAPH_CODE,
+        `the input holds ${gml.graphCount - 1} more graph block(s) after the first; import() reads the first, importAll() reads every one`
+      );
+    }
     throwIfAborted(resolved.signal);
     return report.finish();
+  },
+  /**
+   * Read every `graph [ ... ]` block of a GML text, each into its own sink; the top-level keys
+   * (Creator, Version, ...) apply to each.
+   * @param input - the text, bytes or stream
+   * @param sinkFor - the sink of the graph with this index, called before its first push
+   * @param options - format-specific and common options
+   * @returns one report per graph block
+   */
+  async importAll(input, sinkFor, options) {
+    const resolved = resolveImportOptions(options, FORMAT_DEFAULTS);
+    const first = new ImportReportBuilder("gml", resolved.errorLimit);
+    reportUnusedOptions(options, first, USED_OPTIONS);
+    const tokens = tokenize(await readText(input, first, resolved), first);
+    const reports = [];
+    let count = 1;
+    for (let i = 0; i < count; i++) {
+      throwIfAborted(resolved.signal);
+      const report = i === 0 ? first : new ImportReportBuilder("gml", resolved.errorLimit);
+      const sink = sinkFor(i);
+      reportSinkOptions(sink, options, report);
+      const gml = new GmlImport(sink, report, resolved, options, i);
+      gml.run(tokens);
+      count = gml.graphCount;
+      reports.push(report.finish());
+    }
+    throwIfAborted(resolved.signal);
+    return reports;
   }
 });
+function tokenize(text, report) {
+  try {
+    return tokenizeGml(text);
+  } catch (err) {
+    if (err instanceof GmlSyntaxError) {
+      report.fail(err.code, err.message, { line: err.line });
+    }
+    throw err;
+  }
+}
 const GML_ISSUE = Object.freeze({
   /** A grammar violation: an untokenisable bare token, an unclosed string or `[`, a stray `]`, a key without a value (fatal). */
   SYNTAX: SYNTAX_CODE,
   /** The input holds invalid UTF-8 (fatal). */
   INVALID_UTF8: INVALID_UTF8_CODE,
+  /** Invalid bytes in the encoding a BOM, a declaration or the encoding option chose (fatal). */
+  INVALID_ENCODING: INVALID_ENCODING_CODE,
+  /** Bytes that are not UTF-8 and declare no encoding were read as windows-1252. */
+  ENCODING_FALLBACK: ENCODING_FALLBACK_CODE,
+  /** A declared encoding the platform cannot decode was ignored. */
+  UNKNOWN_ENCODING: UNKNOWN_ENCODING_CODE,
   /** No `graph [` block (fatal). */
   NO_GRAPH: NO_GRAPH_CODE,
   /** More than one `graph` block (fatal). */
-  SECOND_GRAPH: SECOND_GRAPH_CODE,
+  MULTIPLE_GRAPHS: SECOND_GRAPH_CODE,
   /** A node without an `id`. */
   MISSING_ID: MISSING_ID_CODE,
   /** A node without a `label` under nodeIdFrom "label". */