@graphty/graph-io 0.3.24 → 0.3.26

package/dist/chunks/{importer-zGLo8Dg_.js → importer-C_TEA1zJ.js}

@@ -1,10 +1,9 @@
 import { GraphFormatError, INVALID_INDEX } from "@graphty/graph-format";
-import { V as resolveExportOptions, X as pairFolding, ax as canonicalId, S as SINK_OPTION_CODE, O as OPTION_IGNORED_CODE, R as ROLE_TAKEN_CODE, at as RENAMED_CODE, I as ID_MERGED_CODE, d as DUPLICATE_NODE_CODE, t as SYNTAX_CODE, M as MULTIPLE_GRAPHS_CODE, q as UNKNOWN_ENCODING_CODE, E as ENCODING_FALLBACK_CODE, r as INVALID_ENCODING_CODE, s as INVALID_UTF8_CODE, v as resolveImportOptions, w as ImportReportBuilder, z as reportUnusedOptions, ap as LineReader, y as throwIfAborted, F as reportSinkOptions, J as DirectionResolver, K as IdCoercer, Q as uniqueColumnName, L as declareResolved, az as coerceIdText } from "./report-B1z4WT9e.js";
-import { i as isPajekLabel, q as quotePajekLabel } from "./escape-B-tkk_Cl.js";
-import { L as LOSS, s as sanitizeIds, a as checkCapabilities, c as capabilities } from "./export-Bh60Dv-n.js";
-import { e as explicitWeights, a as formatF64, b as formatDecimal, f as formatF32, d as formatInteger, i as isWeightField, p as parseWeightText } from "./weights-Dzba96G3.js";
-import { i as inferTextDtype, W as WIDENING_UNSUPPORTED_CODE, a as isNumericText, T as TextCellWriter } from "./text-Dr0Ifpag.js";
-import { j as joinText, e as encodeChunks } from "./writer-C7flM-Ih.js";
+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, 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 survivesF32, aK as isWeightField, aL as parseWeightText } from "./export-BTI4yQgy.js";
+import { i as isPajekLabel, q as quotePajekLabel } from "./escape-D0g6NNUy.js";
+import { i as inferTextDtype, W as WIDENING_UNSUPPORTED_CODE, a as isNumericText, T as TextCellWriter } from "./text-DmcUs5_Q.js";
+import { j as joinText, e as encodeChunks } from "./writer-DxjgHwSe.js";
+import { i as importChosenGraph } from "./choose-BbJI55dx.js";
 const LABEL_COLUMN = "label";
 const POSITION_COLUMN = "position";
 const SHAPE_COLUMN = "shape";
@@ -42,46 +41,103 @@ const SECTION_KINDS = /* @__PURE__ */ new Map([
 ]);
 const INTEGER_TEXT = /^[+-]?[0-9]+$/;
 const TIME_POINT = /^(\*|[+-]?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?)(?:-(\*|[+-]?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?))?$/;
-function tokenize(line) {
-  const tokens = [];
-  let current = "";
-  let started = false;
-  let quoted = false;
-  for (let i = 0; i < line.length; i++) {
-    const c = line.charCodeAt(i);
+function tokenize(line, notes) {
+  const tokens = new LineTokens(line, notes);
+  let i = 0;
+  while (i < line.length) {
+    i = tokens.step(i);
+  }
+  return tokens.finish();
+}
+class LineTokens {
+  /**
+   * Start a line.
+   * @param line - the line
+   * @param notes - set to what the line holds beyond its tokens, when given
+   */
+  constructor(line, notes) {
+    this.line = line;
+    this.notes = notes;
+    this.tokens = [];
+    this.current = "";
+    this.started = false;
+    this.quoted = false;
+  }
+  /**
+   * Read the character at `i`.
+   * @param i - its index
+   * @returns the index of the next character to read
+   */
+  step(i) {
+    const c = this.line.codePointAt(i);
     if (c === 34) {
-      quoted = !quoted;
-      started = true;
-      continue;
+      this.quote(i);
+      return i + 1;
     }
-    if (!quoted && !started && c === 91) {
-      const close = line.indexOf("]", i);
-      if (close > i && line.lastIndexOf("[", close) === i) {
-        current += line.slice(i, close + 1);
-        started = true;
-        i = close;
-        continue;
-      }
+    const close = !this.quoted && !this.started && c === 91 ? this.intervalEnd(i) : -1;
+    if (close > 0) {
+      this.current += this.line.slice(i, close + 1);
+      this.started = true;
+      return close + 1;
     }
-    if (!quoted && (c === 32 || c === 9 || c === 13 || c === 12 || c === 11)) {
-      if (started) {
-        tokens.push(current);
-        current = "";
-        started = false;
-      }
-      continue;
+    if (!this.quoted && isBlank(c)) {
+      this.endToken();
+      return i + 1;
     }
-    current += line[i];
-    started = true;
+    this.current += this.line[i];
+    this.started = true;
+    return i + 1;
   }
-  if (quoted) {
-    return null;
+  /**
+   * The tokens of the line.
+   * @returns them, or null when a quote is not closed
+   */
+  finish() {
+    if (this.quoted) {
+      return null;
+    }
+    this.endToken();
+    return this.tokens;
+  }
+  /**
+   * Open or close a quote. One that opens inside a token, or closes with more of the token after
+   * it, is noted.
+   * @param i - the quote's index
+   */
+  quote(i) {
+    const next = this.line.codePointAt(i + 1);
+    const joined = this.quoted ? i + 1 < this.line.length && !isBlank(next) : this.started;
+    if (joined && this.notes !== void 0) {
+      this.notes.oddQuote = true;
+    }
+    this.quoted = !this.quoted;
+    this.started = true;
   }
-  if (started) {
-    tokens.push(current);
+  /**
+   * Where a `[` that starts a token is closed, when no other `[` comes first.
+   * @param i - the index of the `[`
+   * @returns the index of its `]`, or -1
+   */
+  intervalEnd(i) {
+    const close = this.line.indexOf("]", i);
+    return close > i && this.line.lastIndexOf("[", close) === i ? close : -1;
   }
-  return tokens;
+  /** End the token being read, if any. */
+  endToken() {
+    if (this.started) {
+      this.tokens.push(this.current);
+      this.current = "";
+      this.started = false;
+    }
+  }
+}
+function isBlank(c) {
+  return c === 32 || c === 9 || c === 13 || c === 12 || c === 11;
+}
+function isProjectObject(keyword) {
+  return PROJECT_OBJECTS.has(keyword.toLowerCase());
 }
+const PROJECT_OBJECTS = /* @__PURE__ */ new Set(["permutation", "cluster", "hierarchy"]);
 function isCommentOrBlank(line) {
   for (let i = 0; i < line.length; i++) {
     const c = line.charCodeAt(i);
@@ -187,8 +243,11 @@ function parseIntervals(token) {
     if (match === null) {
       throw new Error(`malformed time interval ${token}: "${part}" is not a-b, a-* or a`);
     }
-    const start = match[1] === "*" ? -Infinity : Number(match[1]);
-    const endText = match[2];
+    const [, startText, endText] = match;
+    if (startText === "*" && endText === void 0) {
+      throw new Error(`malformed time interval ${token}: "*" alone is not a time point`);
+    }
+    const start = startText === "*" ? -Infinity : Number(startText);
     let end;
     if (endText === void 0) {
       end = start;
@@ -197,21 +256,28 @@ function parseIntervals(token) {
     } else {
       end = Number(endText);
     }
+    if (startText !== "*" && !Number.isFinite(start) || endText !== void 0 && endText !== "*" && !Number.isFinite(end)) {
+      throw new Error(`malformed time interval ${token}: "${part}" is beyond the number range`);
+    }
     if (start > end) {
-      throw new Error(`malformed time interval ${token}: ${match[1]} is after ${endText ?? ""}`);
+      throw new Error(`malformed time interval ${token}: ${startText} is after ${endText ?? ""}`);
     }
     spells.push([start, end]);
   }
   return spells;
 }
-const CHARACTER_REFERENCE = /&#(?:[xX]([0-9a-fA-F]{1,6})|([0-9]{1,7}));/g;
-function decodeCharacterReferences(text) {
+const CHARACTER_REFERENCE = /&#(?:[xX]([\da-fA-F]+)|(\d+));/g;
+function decodeCharacterReferences(text, onUnknown) {
   if (!text.includes("&#")) {
     return text;
   }
   return text.replace(CHARACTER_REFERENCE, (whole, hex, dec) => {
     const code = hex === void 0 ? Number(dec) : Number.parseInt(hex, 16);
-    return code <= 1114111 ? String.fromCodePoint(code) : whole;
+    if (code <= 1114111) {
+      return String.fromCodePoint(code);
+    }
+    onUnknown?.(whole);
+    return whole;
   });
 }
 function encodeCharacterReferences(text) {
@@ -233,42 +299,63 @@ function formatIntervals(spells) {
   return `[${parts.join(",")}]`;
 }
 function isParameterKey(text) {
-  if (text.length === 0 || /[\s"]/.test(text) || text.startsWith("[") || text.startsWith("*")) {
+  if (text.length === 0 || /[\s"]/.test(text) || text.startsWith("[") || text.startsWith("*") || text.startsWith("%")) {
     return false;
   }
   if (isShapeKeyword(text)) {
     return false;
   }
-  return !/^[+-]?(\.[0-9]|[0-9])/.test(text);
+  return !/^[+-]?(\.\d|\d)/.test(text) && !/^[+-]?(?:nan|inf|infinity)$/i.test(text);
 }
 const PAJEK_LOSS = Object.freeze({
-  /** A label or text value holds a double quote or a line break; export() will throw E_UNSUPPORTED. */
+  /**
+   * A label or text value holds a double quote or a line break, which Pajek cannot write; the save fails with
+   * E_UNSUPPORTED.
+   */
   TEXT: "E_PAJEK_TEXT",
   /** A column whose name cannot be a parameter key (whitespace, a quote, numeric, a shape keyword); skipped. */
   KEY_DROPPED: "W_PAJEK_KEY_DROPPED",
-  /** A label role column that is not text; its values are written as text and re-import as string. */
+  /**
+   * The node label attribute holds numbers or other values that are not text; they are written as text and read back
+   * as text.
+   */
   LABEL_AS_TEXT: "W_PAJEK_LABEL_AS_TEXT",
-  /** A non-finite f64 value; written as Infinity / NaN text, which re-imports as string. */
+  /** NaN or an infinity is written as the text Infinity or NaN, which reads back as text. */
   NONFINITE_AS_TEXT: "W_PAJEK_NONFINITE_AS_TEXT",
   /** A mutual pair; written as one undirected edge, the mark lost. */
   MUTUAL_AS_UNDIRECTED: LOSS.MUTUAL_AS_UNDIRECTED,
   /** A start / end / timestamp role column; Pajek intervals are written from the spells role only. */
   TEMPORAL_DROPPED: LOSS.TEMPORAL,
-  /** A position column with a stride other than 2 or 3. */
+  /** A position with other than 2 or 3 coordinates is not written. */
   POSITION_STRIDE: "W_PAJEK_POSITION_STRIDE",
-  /** meta.extra.pajek.firstMode is not a count within 0..N; the two-mode header is not written. */
+  /**
+   * The graph's two-mode vertex count (`meta.extra.pajek.firstMode`) is not between 0 and the number of nodes, so
+   * the file is written as a one-mode network.
+   */
   FIRST_MODE_DROPPED: "W_PAJEK_FIRST_MODE_DROPPED",
-  /** A role column Pajek has no slot for (kind, ...) written as a plain parameter; the role is lost. */
+  /** An attribute with a role the format has no place for is written as a plain attribute; the role is lost. */
   ROLE_DROPPED: LOSS.ROLE,
-  /** A `shape` column with a value outside the shape keywords is written as a parameter (a string on re-import). */
+  /**
+   * A `shape` attribute whose value is not one of Pajek's shape names is written as a parameter, and reads back as a
+   * plain text attribute.
+   */
   SHAPE_AS_PARAMETER: "W_PAJEK_SHAPE_AS_PARAMETER",
   /** A vertex line with coordinates, a shape or parameters needs a label: the id text is written and reads back as a label. */
   LABEL_GAINED: "W_PAJEK_LABEL_GAINED",
-  /** A role-less node column named `label` reads back with the label role (its values become the vertex labels). */
+  /**
+   * An attribute without a role is written where the format keeps a role (for example, a `name` column as the label), and
+   * reads back with that role.
+   */
   ROLE_ASSUMED: LOSS.ROLE_ASSUMED,
-  /** Under sanitizeIds "mangle": an original id whose text reads back as the other type under ids "canonical". */
+  /**
+   * With `sanitizeIds: "mangle"`: an original id that reads back as a different type, such as the text "7" as the
+   * number 7.
+   */
   ID_TEXT_TYPE: LOSS.ID_TEXT_TYPE,
-  /** Parameter text that looks like a number or a boolean reads back as one (parameters are untyped, design 5.1). */
+  /**
+   * A text value that reads back as a number or a boolean, because the format does not record that it was text (the
+   * text "42" reads back as the number 42).
+   */
   TEXT_INFERRED: LOSS.TEXT_INFERRED
 });
 const SLOT_ROLES = /* @__PURE__ */ new Set(["label"]);
@@ -453,7 +540,7 @@ function labelNotes(snapshot, nodePlan, notes) {
     notes.push(
       note(
         PAJEK_LOSS.LABEL_GAINED,
-        `${gained} vertex line(s) carry coordinates, a shape or parameters and need a label; the id text is written there and reads back as a label`,
+        `${gained} vertex line${plural(gained)} ${agree(gained, "carries", "carry")} coordinates, a shape or parameters and need a label; the id text is written there and reads back as a label`,
         labels === null ? LABEL_COLUMN : labels.meta.name,
         gained
       )
@@ -554,7 +641,7 @@ function checkCells(planned, domain, notes) {
       notes.push(
         note(
           PAJEK_LOSS.TEXT,
-          `${badText} value(s) of ${domain} column "${name}" hold a double quote or a line break; Pajek cannot write them`,
+          `${badText} value${plural(badText)} of ${domain} column "${name}" hold a double quote or a line break; Pajek cannot write them`,
           name,
           badText
         )
@@ -564,7 +651,7 @@ function checkCells(planned, domain, notes) {
       notes.push(
         note(
           PAJEK_LOSS.TEXT_INFERRED,
-          `${typed} value(s) of ${domain} column "${name}" look like numbers or booleans; Pajek parameters are untyped and they read back as such`,
+          `${typed} value${plural(typed)} of ${domain} column "${name}" look like numbers or booleans; Pajek parameters are untyped and they read back as such`,
           name,
           typed
         )
@@ -574,7 +661,7 @@ function checkCells(planned, domain, notes) {
       notes.push(
         note(
           PAJEK_LOSS.NONFINITE_AS_TEXT,
-          `${nonFinite} non-finite value(s) of ${domain} column "${name}" are written as text`,
+          `${nonFinite} non-finite value${plural(nonFinite)} of ${domain} column "${name}" ${agree(nonFinite, "is", "are")} written as text`,
           name,
           nonFinite
         )
@@ -605,9 +692,6 @@ function labelOf(labels, ids, i, needed) {
   }
   return null;
 }
-function idText(id) {
-  return typeof id === "number" ? formatF64(id) : id;
-}
 function spellsText(column, row) {
   if (column.dtype !== "list" || !column.isSet(row)) {
     return null;
@@ -670,8 +754,8 @@ function* writeParts(snapshot, options) {
       });
     }
   }
-  if (options.networkHeader && snapshot.meta.name !== null) {
-    yield `*Network ${snapshot.meta.name}
+  if (options.networkHeader) {
+    yield options.name === null ? "*Network\n" : `*Network ${options.name}
 `;
   }
   const firstMode = firstModeOf(snapshot);
@@ -706,7 +790,7 @@ function checkIdTexts(nodeCount, ids, mangle, notes) {
     notes.push(
       note(
         PAJEK_LOSS.TEXT,
-        `${badText} node id(s) hold a double quote or a line break; Pajek cannot write them as labels or parameters`,
+        `${badText} node id${plural(badText)} ${agree(badText, "holds", "hold")} a double quote or a line break; Pajek cannot write them as labels or parameters`,
         null,
         badText
       )
@@ -716,7 +800,7 @@ function checkIdTexts(nodeCount, ids, mangle, notes) {
     notes.push(
       note(
         PAJEK_LOSS.ID_TEXT_TYPE,
-        `${typeChanged} original id(s) read back from ${ORIGINAL_ID_KEY} as the other type under ids: "canonical" (a string "1" becomes 1, a number 1.5 becomes "1.5")`,
+        `${typeChanged} original id${plural(typeChanged)} ${agree(typeChanged, "reads", "read")} back from ${ORIGINAL_ID_KEY} as the other type under ids: "canonical" (a string "1" becomes 1, a number 1.5 becomes "1.5")`,
         null,
         typeChanged
       )
@@ -879,7 +963,7 @@ function* writeLines(snapshot, edgePlan) {
     yield snapshot.directed ? "*Arcs\n" : "*Edges\n";
   }
 }
-function resolvePajekOptions(options) {
+function resolvePajekOptions(snapshot, options) {
   const common = resolveExportOptions(options);
   const value = options?.networkHeader;
   if (value !== void 0 && typeof value !== "boolean") {
@@ -888,10 +972,22 @@ function resolvePajekOptions(options) {
       found: typeof value
     });
   }
-  return { networkHeader: value ?? false, mangle: common.sanitizeIds === "mangle" };
+  const name = options?.name;
+  if (name !== void 0 && (typeof name !== "string" || /[\r\n]/.test(name))) {
+    throw new GraphFormatError("E_UNSUPPORTED", "option name: not a one-line string", {
+      option: "name",
+      found: typeof name
+    });
+  }
+  return {
+    networkHeader: value ?? name !== void 0,
+    name: name ?? snapshot.meta.name,
+    mangle: common.sanitizeIds === "mangle"
+  };
 }
 const pajekExporter = Object.freeze({
   format: "pajek",
+  options: Object.freeze(["name", "networkHeader"]),
   capabilities: CAPABILITIES,
   /**
    * Pre-flight: the generic capability gaps plus the Pajek-specific ones.
@@ -901,7 +997,7 @@ const pajekExporter = Object.freeze({
    */
   check(snapshot, options) {
     const resolved = resolveExportOptions(options);
-    const { mangle } = resolvePajekOptions(options);
+    const { mangle } = resolvePajekOptions(snapshot, options);
     const notes = [];
     const planned = plan(snapshot.nodes, "node", notes);
     const nodePlan = withoutReservedKey(planned, mangle);
@@ -971,7 +1067,7 @@ const pajekExporter = Object.freeze({
       notes.push(
         note(
           PAJEK_LOSS.MUTUAL_AS_UNDIRECTED,
-          `${folding.mutualCount} mutual pair(s) are written as undirected edges; the mutual mark is lost`,
+          `${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
         )
@@ -994,7 +1090,7 @@ const pajekExporter = Object.freeze({
    * @returns the chunks
    */
   export(snapshot, options) {
-    const resolved = resolvePajekOptions(options);
+    const resolved = resolvePajekOptions(snapshot, options);
     return encodeChunks(writeParts(snapshot, resolved));
   },
   /**
@@ -1004,32 +1100,47 @@ const pajekExporter = Object.freeze({
    * @returns the document
    */
   exportToString(snapshot, options) {
-    const resolved = resolvePajekOptions(options);
+    const resolved = resolvePajekOptions(snapshot, options);
     return joinText(writeParts(snapshot, resolved));
   }
 });
 const PAJEK_ISSUE = Object.freeze({
-  /** The input holds invalid UTF-8 (fatal). */
+  ...INPUT_ISSUE,
+  ...ELEMENT_ISSUE,
+  /** The input is not valid UTF-8. The import stops. */
   INVALID_UTF8: INVALID_UTF8_CODE,
-  /** Invalid bytes in the encoding a BOM, a declaration or the encoding option chose (fatal). */
+  /**
+   * Some bytes are not valid in the encoding that was chosen (by a byte order mark, the file's declaration or the
+   * `encoding` option). The import stops.
+   */
   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,
-  /** Fatal: no `*Vertices` section (an empty file, or not a Pajek network). */
+  /** There is no `*Vertices` section: the file is empty or not a Pajek network. The import stops. */
   NO_VERTICES: "E_PAJEK_NO_VERTICES",
-  /** Fatal: `*Vertices` without a vertex count, one the sink cannot hold, or a first-mode count outside 0..N. */
+  /**
+   * `*Vertices` without a vertex count, with a count too large to hold, or with a first-mode count outside 0 to N;
+   * the import stops.
+   */
   VERTICES_COUNT: "E_PAJEK_VERTICES_COUNT",
-  /** A project file holds several networks; import() reads the first, importAll() reads every one. */
+  /**
+   * The file holds several graphs and only the first was read. It is not added when `graphIndex` or `graphName` chose the graph.
+   * `importAllGraphs()` reads every one.
+   */
   MULTIPLE_GRAPHS: MULTIPLE_GRAPHS_CODE,
+  /** `graphIndex` or `graphName` names no graph of the file; the message lists the graphs it holds. The import stops. */
+  GRAPH_NOT_FOUND: GRAPH_NOT_FOUND_CODE,
+  /** `graphName` matches more than one graph; pass `graphIndex`. The import stops. */
+  AMBIGUOUS_GRAPH_NAME: AMBIGUOUS_GRAPH_NAME_CODE,
   /** A data line before the first section header. */
   OUTSIDE_SECTION: "E_PAJEK_OUTSIDE_SECTION",
   /** A section header the importer cannot parse. */
   SYNTAX: SYNTAX_CODE,
   /** A double quote not closed before the end of the line. */
   UNTERMINATED_QUOTE: "E_PAJEK_UNTERMINATED_QUOTE",
-  /** A vertex line the grammar does not accept. */
+  /** A vertex line that is not in Pajek's vertex syntax; the vertex is skipped. */
   VERTEX_LINE: "E_PAJEK_VERTEX_LINE",
   /** A vertex number outside the declared range. */
   VERTEX_RANGE: "E_PAJEK_VERTEX_RANGE",
@@ -1037,9 +1148,12 @@ const PAJEK_ISSUE = Object.freeze({
   VERTEX_COUNT: "W_PAJEK_VERTEX_COUNT",
   /** A second line for the same vertex; the later values overwrite. */
   DUPLICATE_NODE: DUPLICATE_NODE_CODE,
-  /** A line (arc, edge, list, matrix row, partition or vector value) the grammar does not accept. */
+  /**
+   * A line that is not in Pajek's syntax for its section (an arc, edge, list, matrix row, partition or vector
+   * value); it is skipped.
+   */
   LINE: "E_PAJEK_LINE",
-  /** A line endpoint outside the declared vertex range (the core's code, forwarded). */
+  /** An edge names a vertex number outside the range `*Vertices` declared; the edge is skipped. */
   UNKNOWN_NODE: "E_UNKNOWN_NODE",
   /** A malformed time interval token. */
   INTERVAL: "E_PAJEK_INTERVAL",
@@ -1051,32 +1165,57 @@ const PAJEK_ISSUE = Object.freeze({
   OBJECT_COUNT: "E_PAJEK_OBJECT_COUNT",
   /** A project-file section (`*Events`, `*Permutation`, ...) the importer does not read; its lines are skipped. */
   UNSUPPORTED_SECTION: "W_PAJEK_UNSUPPORTED_SECTION",
-  /** Tokens after a section header the grammar does not account for. */
+  /** A section header has extra words Pajek does not define; they are ignored. */
   HEADER_EXTRA: "W_PAJEK_HEADER_EXTRA",
   /** The file declares vertices but no line section. */
   NO_LINES: "W_PAJEK_NO_LINES",
-  /** Vertex numbering starts at 0 rather than 1. */
+  /** Vertex numbering starts at 0 rather than 1, found by `firstVertex: "auto"` (passing `firstVertex: 0` says so and gives no warning). */
   ZERO_BASED: "W_PAJEK_ZERO_BASED",
   /** Vertex lines mix two and three coordinates. */
   COORD_DIMS: "W_PAJEK_COORD_DIMS",
   /** Two vertices share a label under nodeIdFrom "label" and became one node. */
   LABEL_MERGED: "W_PAJEK_LABEL_MERGED",
-  /** Two distinct label texts became one numeric id under ids "number". */
+  /** Two different labels became the same number because `ids` is "number", so their vertices were merged. */
   ID_MERGED: ID_MERGED_CODE,
-  /** A parameter column of `2.0`-style text kept at the value-inferred dtype (the sink cannot widen). */
+  /**
+   * Your graph builder cannot change an attribute's type after its first value, so a text column keeps the type of
+   * its first values.
+   */
   WIDENING_UNSUPPORTED: WIDENING_UNSUPPORTED_CODE,
-  /** A structural column (label, position, shape, spells, relation) renamed `<name>#<id>` because the name was taken (design section 5.6). */
+  /** A structural column (label, position, shape, spells, relation) renamed `<name>#<id>` because the name was taken. */
   COLUMN_RENAMED: RENAMED_CODE,
-  /** A structural column declared without its role because the sink already holds it. */
+  /**
+   * You read into a graph builder that already has an id, label or position attribute, so this file's one is kept as
+   * a plain attribute.
+   */
   ROLE_TAKEN: ROLE_TAKEN_CODE,
   /** Two vertices carry the same `graphty_originalId` under restoreMangledIds and became one node. */
   ORIGINAL_ID_MERGED: "W_PAJEK_ORIGINAL_ID_MERGED",
   /** A vertex line's `graphty_originalId` came after a later vertex's line had created it under its number. */
   ORIGINAL_ID_UNRESTORED: "W_PAJEK_ORIGINAL_ID_UNRESTORED",
-  /** A common option the importer has no use for (weightFrom naming a parameter and restoreMangledIds are honoured; long, hyperedges are not). */
+  /** You set an option this format does not use; it had no effect. The message names the option. */
   OPTION_IGNORED: OPTION_IGNORED_CODE,
-  /** A builder-policy option the caller passed that the caller's sink does not use (the shared W_SINK_OPTION). */
-  SINK_OPTION: SINK_OPTION_CODE
+  /**
+   * You read into your own graph builder, which was created with a different `addMissingNodes`, `duplicateEdges`,
+   * `selfLoops` or `weightDtype` than the option you passed; the builder's setting applies.
+   */
+  SINK_OPTION: SINK_OPTION_CODE,
+  /** A double quote inside a token (a CSV-style doubled quote, a quote mid-word): removed and the parts joined. */
+  QUOTE_IN_TOKEN: "W_PAJEK_QUOTE_IN_TOKEN",
+  /** The same parameter twice on one line; the later value stands. */
+  DUPLICATE_ATTRIBUTE: DUPLICATE_ATTRIBUTE_CODE,
+  /** A character reference beyond U+10FFFF in a label; kept as written. */
+  REFERENCE_RANGE: "W_PAJEK_REFERENCE_RANGE",
+  /** A line of a two-mode network whose endpoints are both in one mode. */
+  TWO_MODE_LINE: "W_PAJEK_TWO_MODE_LINE",
+  /** A bare non-integer number read as a vertex label before two coordinates (`1 0.1 0.2 0.3`); it may be an x y z line without a label. */
+  NUMERIC_LABEL: "W_PAJEK_NUMERIC_LABEL",
+  /** A relation number given a second name by a later `*Arcs :k "name"` header. */
+  RELATION_RENAMED: "W_PAJEK_RELATION_RENAMED",
+  /** 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
 });
 const USED_OPTIONS = /* @__PURE__ */ new Set([
   "ids",
@@ -1096,6 +1235,8 @@ const USED_OPTIONS = /* @__PURE__ */ new Set([
 const DEFAULTS = { ids: "canonical", defaultDirected: true, weightFrom: VALUE_FIELD };
 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 LABEL_DECL = {
   name: LABEL_COLUMN,
   dtype: "string",
@@ -1169,6 +1310,7 @@ class PajekParser {
     this.kind = "directed";
     this.relation = null;
     this.vertexCount = -1;
+    this.verticesLine = 0;
     this.firstMode = null;
     this.networkName = null;
     this.base = 1;
@@ -1181,6 +1323,8 @@ class PajekParser {
     this.relationNames = /* @__PURE__ */ new Map();
     this.objects = [];
     this.objectHeader = false;
+    this.firstUnsupported = null;
+    this.outOfRange = 0;
     this.indexOfPos = new Uint32Array(0);
     this.idOfPos = null;
     this.seen = new Uint8Array(0);
@@ -1241,7 +1385,7 @@ class PajekParser {
           this.matrixLine(text, line);
           return false;
         case "object":
-          this.objectLine(text);
+          this.objectLine(text, line);
           return false;
         case "skip":
           return false;
@@ -1265,7 +1409,8 @@ class PajekParser {
    */
   finish() {
     if (this.vertexCount < 0) {
-      this.report.fail(PAJEK_ISSUE.NO_VERTICES, "not a Pajek network: no *Vertices section found");
+      const seen = this.firstUnsupported === null ? "" : ` (the file has the unrecognised section *${this.firstUnsupported})`;
+      this.report.fail(PAJEK_ISSUE.NO_VERTICES, `not a Pajek network: no *Vertices section found${seen}`);
     }
     this.endSection();
     this.finishVertices();
@@ -1284,7 +1429,7 @@ class PajekParser {
       this.report.warning(
         "coercion",
         PAJEK_ISSUE.ID_MERGED,
-        `${this.coercer.mergeCount} label(s) merged into an id another label already produced under ids "number"`
+        `${this.coercer.mergeCount} label${plural(this.coercer.mergeCount)} merged into an id another label already produced under ids "number"`
       );
     }
     const pajek = {
@@ -1336,7 +1481,7 @@ class PajekParser {
         this.report.error(
           "validation-error",
           PAJEK_ISSUE.OBJECT_COUNT,
-          `*${partition ? "Partition" : "Vector"} "${object.name}" declares ${declared} vertices and holds ${object.values.length} value(s); the network has ${this.vertexCount}`,
+          `*${partition ? "Partition" : "Vector"} "${object.name}" declares ${declared} vertices and holds ${object.values.length} value${plural(object.values.length)}; the network has ${this.vertexCount}`,
           where
         );
       }
@@ -1363,7 +1508,7 @@ class PajekParser {
       this.report.warning(
         "validation-error",
         PAJEK_ISSUE.HEADER_EXTRA,
-        `ignored ${h.extra.length} unexpected token(s) after *${h.keyword}: ${h.extra.join(" ")}`,
+        `ignored ${h.extra.length} unexpected token${plural(h.extra.length)} after *${h.keyword}: ${h.extra.join(" ")}`,
         { line }
       );
     }
@@ -1410,7 +1555,8 @@ class PajekParser {
         return;
       case "unsupported":
         this.section = "skip";
-        this.objectHeader = true;
+        this.objectHeader = isProjectObject(h.keyword);
+        this.firstUnsupported ??= h.keyword;
         this.report.warning(
           "unsupported",
           PAJEK_ISSUE.UNSUPPORTED_SECTION,
@@ -1456,6 +1602,7 @@ class PajekParser {
       );
     }
     this.vertexCount = h.count;
+    this.verticesLine = line;
     if (h.secondCount !== null) {
       this.firstMode = h.secondCount;
     }
@@ -1496,7 +1643,17 @@ class PajekParser {
     this.kind = kind;
     this.relation = h.relation === null ? null : h.name ?? String(h.relation);
     if (h.relation !== null) {
-      this.relationNames.set(h.relation, this.relation ?? String(h.relation));
+      const name = this.relation ?? String(h.relation);
+      const before = this.relationNames.get(h.relation);
+      if (before !== void 0 && before !== name) {
+        this.report.warning(
+          "validation-error",
+          PAJEK_ISSUE.RELATION_RENAMED,
+          `relation ${h.relation} was named ${JSON.stringify(before)} and is now named ${JSON.stringify(name)}; its lines carry the name of their own section`,
+          { line, element: String(h.relation) }
+        );
+      }
+      this.relationNames.set(h.relation, name);
     }
   }
   /**
@@ -1508,7 +1665,7 @@ class PajekParser {
       this.report.error(
         "validation-error",
         PAJEK_ISSUE.MATRIX_ROWS,
-        `*Matrix has ${this.matrixRows} row(s); *Vertices declares ${rows}`
+        `*Matrix has ${this.matrixRows} row${plural(this.matrixRows)}; *Vertices declares ${rows}`
       );
     }
     this.section = "none";
@@ -1523,7 +1680,7 @@ class PajekParser {
   setBase(base, line) {
     this.base = base;
     this.baseKnown = true;
-    if (base === 0) {
+    if (base === 0 && this.firstVertex === "auto") {
       this.report.warning(
         "coercion",
         PAJEK_ISSUE.ZERO_BASED,
@@ -1543,12 +1700,32 @@ class PajekParser {
     }
     this.nodesCreated = true;
     const n = this.vertexCount;
-    const { sink } = this;
     for (let pos = 0; pos < n; pos++) {
-      this.indexOfPos[pos] = sink.addNode(this.idOfNumber(pos + this.base));
+      this.indexOfPos[pos] = this.addNode(this.idOfNumber(pos + this.base));
     }
     this.report.counts.nodes += n;
   }
+  /**
+   * Add a vertex to the sink. A sink that cannot hold the declared vertex set (the builder's
+   * E_TOO_LARGE id map limit) makes the file unreadable, so its refusal is fatal; any other
+   * error passes to the caller.
+   * @param id - the vertex id
+   * @returns the node index
+   */
+  addNode(id) {
+    try {
+      return this.sink.addNode(id);
+    } catch (err) {
+      if (!(err instanceof GraphFormatError) || err.code !== "E_TOO_LARGE") {
+        throw err;
+      }
+      return this.report.fail(
+        PAJEK_ISSUE.VERTICES_COUNT,
+        `*Vertices ${this.vertexCount}: the sink cannot hold that many (${err.message})`,
+        { line: this.verticesLine }
+      );
+    }
+  }
   /**
    * The id of a vertex number under nodeIdFrom "id" (the number coerced by the ids rule) or
    * "index" (the position).
@@ -1603,12 +1780,12 @@ class PajekParser {
         }
       }
     }
-    const lines = this.seenCount + this.report.counts.skippedNodes;
+    const lines = this.seenCount + this.report.counts.skippedNodes - this.outOfRange;
     if (this.seenCount > 0 && lines < n) {
       this.report.warning(
         "validation-error",
         PAJEK_ISSUE.VERTEX_COUNT,
-        `*Vertices declares ${n} vertices but ${lines} vertex line(s) were read; the others have no label`
+        `*Vertices declares ${n} vertices but ${lines} vertex line${plural(lines)} ${agree(lines, "was", "were")} read; the others have no label`
       );
     }
   }
@@ -1618,7 +1795,7 @@ class PajekParser {
    * @param line - the line number
    */
   vertexLine(text, line) {
-    const tokens = this.tokens(text, "node");
+    const tokens = this.tokens(text, "node", line);
     if (!isVertexNumber(tokens[0])) {
       this.report.counts.skippedNodes++;
       throw new LineError(
@@ -1634,6 +1811,7 @@ class PajekParser {
     const pos = k - this.base;
     if (pos < 0 || pos >= this.vertexCount) {
       this.report.counts.skippedNodes++;
+      this.outOfRange++;
       throw new LineError(
         "validation-error",
         PAJEK_ISSUE.VERTEX_RANGE,
@@ -1643,7 +1821,7 @@ class PajekParser {
     let i = 1;
     let label = null;
     if (tokens.length > 1 && !startsWithCoordinates(text, tokens)) {
-      label = decodeCharacterReferences(tokens[1]);
+      label = this.labelOf(tokens[1], k, line);
       i = 2;
     }
     let x = 0;
@@ -1668,12 +1846,13 @@ class PajekParser {
         `vertex ${k}: a single coordinate "${tokens[i]}"; coordinates are x y [z]`
       );
     }
+    this.checkCoordinates(text, tokens, i, dims === 2 && label !== null, k, line);
     let shape = null;
     if (i < tokens.length && isShapeKeyword(tokens[i])) {
       shape = tokens[i].toLowerCase();
       i++;
     }
-    const extras = this.extras(tokens, i, "node");
+    const extras = this.extras(tokens, i, "node", line);
     const restored = this.restoredId(extras);
     this.createNodes();
     const repeated = this.seen[pos] !== 0;
@@ -1720,18 +1899,7 @@ class PajekParser {
       sink.setNodeValue(this.labelHandle, index, label);
     }
     if (dims > 0) {
-      if (this.positionHandle === INVALID_INDEX) {
-        this.coordDims = dims;
-        this.positionHandle = declareResolved(sink, "node", positionDecl(dims), this.report, { line }).handle;
-      } else if (dims !== this.coordDims) {
-        this.report.warnOnce(
-          "validation-error",
-          PAJEK_ISSUE.COORD_DIMS,
-          `vertex lines mix ${this.coordDims} and ${dims} coordinates; the position column records sourceDims ${this.coordDims}`,
-          { line, element: String(k) }
-        );
-      }
-      sink.setNodeValue(this.positionHandle, index, [x, y, z]);
+      this.writePosition(index, dims, [x, y, z], k, line);
     }
     if (shape !== null) {
       if (this.shapeHandle === INVALID_INDEX && this.nodeParams.has(SHAPE_COLUMN)) {
@@ -1753,6 +1921,85 @@ class PajekParser {
       sink.setNodeValue(this.nodeSpellsHandle, index, extras.spells);
     }
   }
+  /**
+   * A vertex label as written, its character references decoded.
+   * @param token - the label token
+   * @param k - the vertex number
+   * @param line - the line number
+   * @returns the label
+   */
+  labelOf(token, k, line) {
+    return decodeCharacterReferences(token, (reference) => {
+      this.report.warnOnce(
+        "validation-error",
+        PAJEK_ISSUE.REFERENCE_RANGE,
+        `character reference ${reference} is beyond U+10FFFF; it is kept as written`,
+        { line, element: String(k) },
+        `${PAJEK_ISSUE.REFERENCE_RANGE}:${reference}`
+      );
+    });
+  }
+  /**
+   * Check the token after a vertex line's coordinates (or where they would stand): a numeral the
+   * number range cannot hold is a broken coordinate, never a parameter named "1e999" or "NaN";
+   * and a bare non-integer label before two coordinates may be the x of an x y z line.
+   * @param text - the line
+   * @param tokens - its tokens
+   * @param i - the index after the coordinates
+   * @param labelAndXy - whether the line was read as a label and two coordinates
+   * @param k - the vertex number
+   * @param line - the line number
+   */
+  checkCoordinates(text, tokens, i, labelAndXy, k, line) {
+    if (i < tokens.length && (NUMERAL.test(tokens[i]) || NON_FINITE_WORD.test(tokens[i])) && !isNumericText(tokens[i])) {
+      this.report.counts.skippedNodes++;
+      throw new LineError(
+        "parse-error",
+        PAJEK_ISSUE.VERTEX_LINE,
+        `vertex ${k}: coordinate "${tokens[i]}" is not a finite number`
+      );
+    }
+    const label = tokens[1];
+    if (labelAndXy && isNumericText(label) && !Number.isInteger(Number(label)) && !quotedAfterNumber(text, tokens)) {
+      this.report.warnOnce(
+        "validation-error",
+        PAJEK_ISSUE.NUMERIC_LABEL,
+        `vertex ${k}: "${label} ${tokens[2]} ${tokens[3]}" is read as the label ${label} and x y; quote the label, or it may be meant as x y z`,
+        { line, element: String(k) }
+      );
+    }
+  }
+  /**
+   * Write a vertex's coordinates into the position column (f32 x 3), declared on first use.
+   * @param index - the node index
+   * @param dims - 2 or 3, the coordinates the line gave
+   * @param point - x, y, z (0 when absent)
+   * @param k - the vertex number
+   * @param line - the line number
+   */
+  writePosition(index, dims, point, k, line) {
+    if (this.positionHandle === INVALID_INDEX) {
+      this.coordDims = dims;
+      this.positionHandle = declareResolved(this.sink, "node", positionDecl(dims), this.report, { line }).handle;
+    } else if (dims !== this.coordDims) {
+      this.report.warnOnce(
+        "validation-error",
+        PAJEK_ISSUE.COORD_DIMS,
+        `vertex lines mix ${this.coordDims} and ${dims} coordinates; the position column records sourceDims ${this.coordDims}`,
+        { line, element: String(k) }
+      );
+    }
+    if (!point.every(survivesF32)) {
+      this.report.warnOnce(
+        "precision",
+        PAJEK_ISSUE.PRECISION,
+        `vertex ${k} has a coordinate the f32 position column rounds (warned once)`,
+        { line, element: String(k) },
+        `${PAJEK_ISSUE.PRECISION}:position`
+      );
+    }
+    this.sink.setNodeValue(this.positionHandle, index, point);
+  }
   /**
    * Whether a `graphty_originalId` parameter is restored as the vertex id: restoreMangledIds
    * under nodeIdFrom "id" (under "label" / "index" the parameter stays an ordinary column).
@@ -1770,7 +2017,7 @@ class PajekParser {
   numberedNode(ids, pos) {
     const id = this.idOfNumber(pos + this.base);
     ids[pos] = id;
-    this.indexOfPos[pos] = this.sink.addNode(id);
+    this.indexOfPos[pos] = this.addNode(id);
     this.report.counts.nodes++;
   }
   /**
@@ -1807,7 +2054,7 @@ class PajekParser {
   deferredNode(ids, pos, k, text, line, from) {
     const id = text === null ? this.idOfNumber(k) : this.coercer.text(text);
     const before = this.sink.indexOf(id);
-    const index = this.sink.addNode(id);
+    const index = this.addNode(id);
     ids[pos] = id;
     this.indexOfPos[pos] = index;
     this.report.counts.nodes++;
@@ -1828,7 +2075,7 @@ class PajekParser {
    * @param line - the line number
    */
   edgeLine(text, line) {
-    let tokens = this.tokens(text, "edge");
+    let tokens = this.tokens(text, "edge", line);
     let { relation } = this;
     const prefix = RELATION_PREFIX.exec(tokens[0]);
     if (prefix !== null) {
@@ -1852,7 +2099,7 @@ class PajekParser {
       valueText = tokens[i];
       i++;
     }
-    const extras = this.extras(tokens, i, "edge");
+    const extras = this.extras(tokens, i, "edge", line);
     const { weightFrom } = this.options;
     let weight;
     let valueIsWeight = false;
@@ -1882,7 +2129,7 @@ class PajekParser {
    * @param line - the line number
    */
   listLine(text, line) {
-    const tokens = this.tokens(text, "edge");
+    const tokens = this.tokens(text, "edge", line);
     for (const token of tokens) {
       if (!LIST_VERTEX.test(token)) {
         this.report.counts.skippedEdges++;
@@ -1893,6 +2140,14 @@ class PajekParser {
         );
       }
     }
+    if (tokens.some((token) => token.startsWith("-"))) {
+      this.report.warnOnce(
+        "coercion",
+        PAJEK_ISSUE.NEGATIVE_LIST_ENTRY,
+        "an adjacency list holds a negative vertex number; it is read as its absolute value and the sign is dropped",
+        { line }
+      );
+    }
     const u = this.endpoint(Math.abs(Number(tokens[0])));
     for (let i = 1; i < tokens.length; i++) {
       const v = this.endpoint(Math.abs(Number(tokens[i])));
@@ -1908,7 +2163,7 @@ class PajekParser {
    * @param line - the line number
    */
   matrixLine(text, line) {
-    const tokens = this.tokens(text, "edge");
+    const tokens = this.tokens(text, "edge", line);
     const row = this.matrixRows;
     this.matrixRows++;
     const offset = this.firstMode ?? 0;
@@ -1918,14 +2173,14 @@ class PajekParser {
       throw new LineError(
         "validation-error",
         PAJEK_ISSUE.MATRIX_ROWS,
-        `*Matrix row ${row + 1} is beyond the ${rows} declared row(s)`
+        `*Matrix row ${row + 1} is beyond the ${rows} declared row${plural(rows)}`
       );
     }
     if (tokens.length < columns) {
       throw new LineError(
         "parse-error",
         PAJEK_ISSUE.LINE,
-        `*Matrix row ${row + 1} has ${tokens.length} value(s); the matrix has ${columns} column(s)`
+        `*Matrix row ${row + 1} has ${tokens.length} value${plural(tokens.length)}; the matrix has ${columns} column${plural(columns)}`
       );
     }
     for (let j = 0; j < columns; j++) {
@@ -1941,7 +2196,7 @@ class PajekParser {
       this.report.warnOnce(
         "validation-error",
         PAJEK_ISSUE.MATRIX_EXTRA,
-        `*Matrix row ${row + 1} has ${tokens.length} value(s) for ${columns} column(s); the extra values are ignored`,
+        `*Matrix row ${row + 1} has ${tokens.length} value${plural(tokens.length)} for ${columns} column${plural(columns)}; the extra values are ignored`,
         { line }
       );
     }
@@ -1958,10 +2213,11 @@ class PajekParser {
    * A value line of a `*Partition` (integers) or `*Vector` (numbers): the values of the next
    * vertices, usually one per line.
    * @param text - the line
+   * @param line - the line number
    */
-  objectLine(text) {
+  objectLine(text, line) {
     const object = this.objects[this.objects.length - 1];
-    const tokens = this.tokens(text, "node");
+    const tokens = this.tokens(text, "node", line);
     for (const token of tokens) {
       if (!isNumericText(token) || object.kind === "partition" && !isI32(Number(token))) {
         object.values.push(null);
@@ -1990,6 +2246,14 @@ class PajekParser {
       this.directionSet = true;
       this.resolver.setHeader(this.kind === "directed", { line });
     }
+    if (this.firstMode !== null && u < this.firstMode === v < this.firstMode) {
+      this.report.warnOnce(
+        "validation-error",
+        PAJEK_ISSUE.TWO_MODE_LINE,
+        `a line of the two-mode network joins two vertices of the ${u < this.firstMode ? "first" : "second"} mode`,
+        { line }
+      );
+    }
     const before = sink.edgeCount;
     const e = this.resolver.addEdge(this.idAt(u), this.idAt(v), this.kind, weight, { line });
     this.report.counts.edges += sink.edgeCount - before;
@@ -2054,7 +2318,7 @@ class PajekParser {
    */
   weightOf(text) {
     try {
-      return parseWeightText(text);
+      return parseWeightText(text, this.report);
     } catch (err) {
       this.report.counts.skippedEdges++;
       throw err;
@@ -2065,10 +2329,20 @@ class PajekParser {
    * Tokenize a data line.
    * @param text - the line
    * @param domain - what is skipped on an unterminated quote
+   * @param line - the line number
    * @returns the tokens (at least one: blank lines never reach here)
    */
-  tokens(text, domain) {
-    const tokens = tokenize(text);
+  tokens(text, domain, line) {
+    const notes = { oddQuote: false };
+    const tokens = tokenize(text, notes);
+    if (notes.oddQuote) {
+      this.report.warnOnce(
+        "coercion",
+        PAJEK_ISSUE.QUOTE_IN_TOKEN,
+        "a double quote inside a token is removed and the parts joined (Pajek has no escape for a quote)",
+        { line }
+      );
+    }
     if (tokens === null) {
       if (domain === "node") {
         this.report.counts.skippedNodes++;
@@ -2085,24 +2359,16 @@ class PajekParser {
    * @param tokens - the row's tokens
    * @param start - the first token to read
    * @param domain - what is skipped when the row is malformed
+   * @param line - the line number
    * @returns the parsed extras
    */
-  extras(tokens, start, domain) {
+  extras(tokens, start, domain, line) {
     const extras = { keys: [], values: [], spells: null };
+    const seen = /* @__PURE__ */ new Set();
     for (let i = start; i < tokens.length; ) {
       const token = tokens[i];
-      if (isIntervalToken(token)) {
-        try {
-          const spells = parseIntervals(token);
-          extras.spells = spells.length === 0 ? null : spells;
-        } catch (err) {
-          this.skip(domain);
-          throw new LineError(
-            "validation-error",
-            PAJEK_ISSUE.INTERVAL,
-            err instanceof Error ? err.message : String(err)
-          );
-        }
+      if (token.startsWith("[")) {
+        extras.spells = this.intervals(token, domain);
         i++;
         continue;
       }
@@ -2114,12 +2380,48 @@ class PajekParser {
           `parameter "${token}" has no value`
         );
       }
+      if (seen.has(token)) {
+        this.report.warning(
+          "merged",
+          PAJEK_ISSUE.DUPLICATE_ATTRIBUTE,
+          `parameter ${JSON.stringify(token)} is given twice on one line; the later value ${JSON.stringify(tokens[i + 1])} stands`,
+          { line, element: token }
+        );
+      }
+      seen.add(token);
       extras.keys.push(token);
       extras.values.push(tokens[i + 1]);
       i += 2;
     }
     return extras;
   }
+  /**
+   * The spells of a row's interval token; a malformed one skips the row.
+   * @param token - the token, starting with "["
+   * @param domain - what is skipped when the token is malformed
+   * @returns the spells, or null for an empty `[]`, which is no spell at all
+   */
+  intervals(token, domain) {
+    if (!isIntervalToken(token)) {
+      this.skip(domain);
+      throw new LineError(
+        "validation-error",
+        PAJEK_ISSUE.INTERVAL,
+        `time interval ${token} is not closed by "]"`
+      );
+    }
+    try {
+      const spells = parseIntervals(token);
+      return spells.length === 0 ? null : spells;
+    } catch (err) {
+      this.skip(domain);
+      throw new LineError(
+        "validation-error",
+        PAJEK_ISSUE.INTERVAL,
+        err instanceof Error ? err.message : String(err)
+      );
+    }
+  }
   /**
    * Count a skipped element.
    * @param domain - node or edge
@@ -2156,7 +2458,7 @@ class PajekParser {
   }
 }
 function startsWithCoordinates(text, tokens) {
-  if (text.trimStart().slice(tokens[0].length).trimStart().startsWith('"')) {
+  if (quotedAfterNumber(text, tokens)) {
     return false;
   }
   let run = 0;
@@ -2165,6 +2467,9 @@ function startsWithCoordinates(text, tokens) {
   }
   return run === 2;
 }
+function quotedAfterNumber(text, tokens) {
+  return text.trimStart().slice(tokens[0].length).trimStart().startsWith('"');
+}
 function firstVertexOption(value) {
   if (value === void 0) {
     return "auto";
@@ -2181,23 +2486,32 @@ function firstVertexOption(value) {
     }
   );
 }
-const HEAD_PATTERN = /^\s*\*(vertices|network)\b/i;
+function headSection(text) {
+  let rest = text.trimStart();
+  while (rest.startsWith("%")) {
+    const end = rest.search(/[\r\n]/);
+    rest = end < 0 ? "" : rest.slice(end).trimStart();
+  }
+  return /^\*(vertices|network)\b/i.exec(rest)?.[1].toLowerCase() ?? null;
+}
 const pajekImporter = Object.freeze({
   format: "pajek",
+  options: Object.freeze(["firstVertex"]),
   extensions: Object.freeze([".net", ".paj"]),
   mimeTypes: Object.freeze(["text/x-pajek", "text/plain"]),
   /**
-   * Confidence that the input is a Pajek network: it starts with `*Vertices` (or `*Network`).
+   * Confidence that the input is a Pajek network: it starts with `*Vertices` (or `*Network`),
+   * after any `%` comment lines.
    * @param head - the first bytes
    * @returns 0.9 for a `*Vertices` start, 0.8 for `*Network`, 0 otherwise
    */
   sniff(head) {
-    const text = new TextDecoder("utf-8").decode(head.subarray(0, Math.min(head.byteLength, 512)));
-    const match = HEAD_PATTERN.exec(text.startsWith(String.fromCharCode(65279)) ? text.slice(1) : text);
-    if (match === null) {
+    const text = new TextDecoder("utf-8").decode(head);
+    const section = headSection(text.startsWith("\uFEFF") ? text.slice(1) : text);
+    if (section === null) {
       return 0;
     }
-    return match[1].toLowerCase() === "vertices" ? 0.9 : 0.8;
+    return section === "vertices" ? 0.9 : 0.8;
   },
   /**
    * Read a Pajek network into the sink.
@@ -2207,6 +2521,9 @@ const pajekImporter = Object.freeze({
    * @returns the report
    */
   async import(input, sink, options) {
+    if (graphChosen(options)) {
+      return importChosenGraph(pajekImporter, input, sink, options);
+    }
     const resolved = resolveImportOptions(options, DEFAULTS);
     const firstVertex = firstVertexOption(options?.firstVertex);
     const report = new ImportReportBuilder("pajek", resolved.errorLimit);
@@ -2217,7 +2534,8 @@ const pajekImporter = Object.freeze({
     let rest = null;
     let restLine = 0;
     let sinceCheck = 0;
-    for await (const text of reader) {
+    for await (const raw of reader) {
+      const text = withoutStrayBom(raw);
       if (rest !== null) {
         rest.line(text);
       } else if (parser.line(text, reader.line)) {
@@ -2232,10 +2550,11 @@ const pajekImporter = Object.freeze({
     }
     parser.finish();
     if (rest !== null) {
+      const objects = rest.objects > 0 ? `; ${rest.objects} *Partition / *Vector object(s) after them are not read` : "";
       report.warning(
         "unsupported",
         PAJEK_ISSUE.MULTIPLE_GRAPHS,
-        `the project file holds ${rest.count} more network(s) after the first; import() reads the first, importAll() reads every one`,
+        `the project file holds ${rest.count} more network${plural(rest.count)} after the first; the first is read (graphIndex or graphName chooses another; importAllGraphs() reads every one)${objects}`,
         { line: restLine }
       );
     }
@@ -2265,7 +2584,8 @@ const pajekImporter = Object.freeze({
     let parser = open();
     const reader = new LineReader(input, reports[0], resolved);
     let sinceCheck = 0;
-    for await (const text of reader) {
+    for await (const raw of reader) {
+      const text = withoutStrayBom(raw);
       if (parser.line(text, reader.line)) {
         parser.finish();
         reports.push(new ImportReportBuilder("pajek", resolved.errorLimit));
@@ -2282,9 +2602,13 @@ const pajekImporter = Object.freeze({
     return reports.map((r) => r.finish());
   }
 });
+function withoutStrayBom(text) {
+  return text.codePointAt(0) === 65279 ? text.slice(1) : text;
+}
 class NetworkCounter {
   constructor() {
     this.count = 0;
+    this.objects = 0;
     this.named = false;
     this.populated = false;
     this.afterObjectHeader = false;
@@ -2307,8 +2631,11 @@ class NetworkCounter {
       return;
     }
     const { kind } = h;
-    if (kind === "partition" || kind === "vector" || kind === "unsupported") {
+    if (kind === "partition" || kind === "vector") {
       this.afterObjectHeader = true;
+      this.objects++;
+    } else if (kind === "unsupported") {
+      this.afterObjectHeader = isProjectObject(h.keyword);
     } else if (kind === "network") {
       if (this.count === 0 || this.named || this.populated) {
         this.count++;
@@ -2330,4 +2657,4 @@ export {
   pajekImporter as b,
   pajekExporter as p
 };
-//# sourceMappingURL=importer-zGLo8Dg_.js.map
+//# sourceMappingURL=importer-C_TEA1zJ.js.map