@graphty/graph-io 0.3.48 → 0.3.49

package/dist/chunks/{export-CZ7VRm4I.js → export-Cha4dRFz.js}

@@ -1,7 +1,7 @@
 import { GraphFormatError, INVALID_INDEX } from "@graphty/graph-format";
-import { ai as withArticle, C as COLUMN_RENAMED_CODE, R as ROLE_TAKEN_CODE, U as UNKNOWN_ATTR_TYPE_CODE, B as BAD_DEFAULT_CODE, ac as BAD_OPTIONS_CODE, D as DIRECTION_FORCED_CODE, b as DIRECTION_REFUSED_CODE, M as MIXED_DIRECTION_CODE, O as OPTION_IGNORED_CODE, S as SINK_OPTION_CODE, N as NO_GRAPH_CODE, W as AMBIGUOUS_GRAPH_NAME_CODE, Y as GRAPH_NOT_FOUND_CODE, p as plural, P as PRECISION_CODE, aL as WEIGHTS_DROPPED_CODE, aG as NONFINITE_AS_NULL_CODE, aH as OPTIONS_GAINED_CODE, ab as XML_ILLEGAL_CHAR_CODE, aK as TEXT_INFERRED_CODE, aE as INTEGRAL_F64_CODE, ap as STORAGE_CLASS_CODE, aD as EMPTY_COLUMN_DROPPED_CODE, aq as COLUMN_RENAMED_LOSS_CODE, a9 as ROLE_ASSUMED_CODE, ak as WEIGHT_KEY_CLASH_CODE, aj as ID_TEXT_COLLISION_CODE, A as ID_TEXT_TYPE_CODE, J as MUTUAL_AS_UNDIRECTED_CODE, al as MUTUAL_EXPANDED_CODE, G as PARENTS_DROPPED_CODE, F as ROLE_DROPPED_CODE, ar as TEMPORAL_TEXT_DROPPED_CODE, as as TEMPORAL_DROPPED_CODE, aA as COLUMN_DROPPED_CODE, a as agree } from "./report-CgdsL9Hb.js";
-import { d as canonicalEncoding } from "./input-Ccg9I22A.js";
-import { c as formatInteger, f as formatF32, a as formatF64 } from "./format-BMS-1Nxb.js";
+import { ai as withArticle, C as COLUMN_RENAMED_CODE, R as ROLE_TAKEN_CODE, U as UNKNOWN_ATTR_TYPE_CODE, B as BAD_DEFAULT_CODE, ac as BAD_OPTIONS_CODE, O as OPTION_IGNORED_CODE, S as SINK_OPTION_CODE, N as NO_GRAPH_CODE, W as AMBIGUOUS_GRAPH_NAME_CODE, Y as GRAPH_NOT_FOUND_CODE, p as plural, P as PRECISION_CODE, aL as WEIGHTS_DROPPED_CODE, aD as NONFINITE_AS_NULL_CODE, aE as OPTIONS_GAINED_CODE, ab as XML_ILLEGAL_CHAR_CODE, aK as TEXT_INFERRED_CODE, aB as INTEGRAL_F64_CODE, aH as STORAGE_CLASS_CODE, az as EMPTY_COLUMN_DROPPED_CODE, aw as COLUMN_RENAMED_LOSS_CODE, a9 as ROLE_ASSUMED_CODE, ak as WEIGHT_KEY_CLASH_CODE, aj as ID_TEXT_COLLISION_CODE, A as ID_TEXT_TYPE_CODE, J as MUTUAL_AS_UNDIRECTED_CODE, al as MUTUAL_EXPANDED_CODE, G as PARENTS_DROPPED_CODE, F as ROLE_DROPPED_CODE, aJ as TEMPORAL_TEXT_DROPPED_CODE, aI as TEMPORAL_DROPPED_CODE, M as MIXED_DIRECTION_CODE, av as COLUMN_DROPPED_CODE, a as agree } from "./report-CwMfYa9J.js";
+import { c as canonicalEncoding } from "./input-CAxt_aV-.js";
+import { c as formatInteger, f as formatF32, a as formatF64 } from "./format-BXiAb-1h.js";
 const TIME_TEXT_ROLE = "timeText";
 const TIME_TEXT_SUFFIX = ".text";
 const DATE_TIME$1 = /^(-?\d{4,})-(\d{2})-(\d{2})(?:[T ](\d{2}):(\d{2})(?::(\d{2})(?:\.(\d{1,9}))?)?)?(Z|z|[+-]\d{2}(?::?\d{2})?)?$/;
@@ -821,343 +821,6 @@ function parseItem(text, spec) {
 function messageOf(err) {
   return err instanceof Error ? err.message : String(err);
 }
-const DIRECTED_COLUMN = "graphty.directed";
-const PAIR_COLUMN = "graphty.pair";
-const MUTUAL_COLUMN = "graphty.mutual";
-const DIRECTED_DECL = { name: DIRECTED_COLUMN, dtype: "bool", role: "directed" };
-const PAIR_DECL = { name: PAIR_COLUMN, dtype: "u32", role: "pair", refersTo: "edge" };
-const MUTUAL_DECL = { name: MUTUAL_COLUMN, dtype: "bool", role: "mutual" };
-class DirectionResolver {
-  /**
-   * Create a resolver.
-   * @param sink - the sink edges are pushed into
-   * @param report - the report issues are recorded in
-   * @param policy - the resolved onMixedDirection option
-   */
-  constructor(sink, report, policy) {
-    this.directedHandle = INVALID_INDEX;
-    this.pairHandle = INVALID_INDEX;
-    this.mutualHandle = INVALID_INDEX;
-    this.firstEdge = -1;
-    this.nextEdge = -1;
-    this.forcedCount = 0;
-    this.headerSet = false;
-    this.mirrorOfLast = INVALID_INDEX;
-    this.sink = sink;
-    this.report = report;
-    this.policy = policy;
-  }
-  /**
-   * The sink's current direction.
-   * @returns true when directed
-   */
-  get directed() {
-    return this.sink.directed;
-  }
-  /**
-   * Whether the graph holds undirected edges stored as two edges.
-   * @returns true once the first such edge was added
-   */
-  get expanded() {
-    return this.pairHandle !== INVALID_INDEX;
-  }
-  /**
-   * Set the graph's direction before the first edge: the direction the file declares, or the
-   * `defaultDirected` option for a file that declares none. Under `onMixedDirection` "directed" or
-   * "undirected" that direction is used instead, with a warning when it differs. When the sink
-   * cannot change direction (a caller's builder that already holds edges or was locked), the
-   * sink's direction stands and a warning is recorded.
-   * @param headerDirected - the direction the file declares (or the default)
-   * @param where - the line of the header, when known
-   */
-  setHeader(headerDirected, where) {
-    this.headerSet = true;
-    let wanted = headerDirected;
-    if (this.policy === "directed" || this.policy === "undirected") {
-      wanted = this.policy === "directed";
-      if (wanted !== headerDirected) {
-        this.report.warnOnce(
-          "coercion",
-          DIRECTION_FORCED_CODE,
-          `the file declares ${direction(headerDirected)} edges; read as ${direction(wanted)} per onMixedDirection`,
-          { line: where?.line ?? null },
-          `${DIRECTION_FORCED_CODE}:${direction(headerDirected)}`
-        );
-      }
-    }
-    const { sink } = this;
-    if (sink.directed === wanted) {
-      this.adoptExisting();
-      return;
-    }
-    try {
-      if (wanted && sink.edgeCount > 0 && !sink.directedLocked) {
-        const before = sink.edgeCount;
-        sink.setDirected(true, { expand: true });
-        this.adoptExpansionColumns();
-        this.report.counts.expandedMixed += before;
-      } else {
-        sink.setDirected(wanted);
-      }
-    } catch (err) {
-      if (!(err instanceof GraphFormatError) || err.code !== "E_DIRECTED") {
-        throw err;
-      }
-      this.report.warning(
-        "coercion",
-        DIRECTION_REFUSED_CODE,
-        `the file is ${direction(wanted)} but the sink is ${direction(sink.directed)} (${reasonOf(err)}); read as ${direction(sink.directed)}`,
-        { line: where?.line ?? null }
-      );
-    }
-    this.adoptExisting();
-  }
-  /**
-   * Pick up reserved columns a caller's sink already holds (an earlier expansion), so every edge
-   * pushed from now on gets its graphty.directed value.
-   */
-  adoptExisting() {
-    if (this.pairHandle === INVALID_INDEX && this.sink.edgeColumn(PAIR_COLUMN) !== INVALID_INDEX) {
-      this.adoptExpansionColumns();
-    }
-  }
-  /**
-   * The second edge of the edge the last addEdge() call added, when that edge was stored as two;
-   * otherwise INVALID_INDEX (4294967295). An edge attribute or weight you set after addEdge()
-   * belongs on both: set it on the index addEdge() returned and, when this is not INVALID_INDEX,
-   * on this index too.
-   * @returns the second edge's index, or INVALID_INDEX
-   */
-  get lastMirror() {
-    return this.mirrorOfLast;
-  }
-  /**
-   * Add one edge. An edge with the graph's direction is added as it is; one with the other
-   * direction is stored as two edges, given the graph's direction, or refused, as
-   * `onMixedDirection` says. When it is stored as two, the return value is the first and
-   * `lastMirror` the second.
-   * @param source - the source id
-   * @param target - the target id
-   * @param kind - the edge's direction in the file
-   * @param weight - the weight, or undefined when the file gives none
-   * @param where - the line and element, for issues
-   * @returns the index of the edge added (the first one, when it was stored as two)
-   */
-  addEdge(source, target, kind, weight, where) {
-    if (!this.headerSet) {
-      throw new GraphFormatError("E_DIRECTED", "DirectionResolver.setHeader() must run before the first edge", {
-        reason: "header not set"
-      });
-    }
-    const { sink } = this;
-    this.mirrorOfLast = INVALID_INDEX;
-    const edgeDirected = kind !== "undirected";
-    if (edgeDirected === sink.directed && kind !== "mutual") {
-      const e = sink.addEdge(source, target, weight);
-      this.track(e);
-      if (this.directedHandle !== INVALID_INDEX) {
-        sink.setEdgeValue(this.directedHandle, e, edgeDirected);
-      }
-      return e;
-    }
-    switch (this.policy) {
-      case "directed":
-      case "undirected": {
-        this.forcedCount++;
-        this.report.warnOnce(
-          "coercion",
-          DIRECTION_FORCED_CODE,
-          `${kind} edges read as ${direction(sink.directed)} per onMixedDirection`,
-          where,
-          `${DIRECTION_FORCED_CODE}:${kind}`
-        );
-        const e = sink.addEdge(source, target, weight);
-        this.track(e);
-        if (this.directedHandle !== INVALID_INDEX) {
-          sink.setEdgeValue(this.directedHandle, e, sink.directed);
-        }
-        return e;
-      }
-      case "error":
-        this.report.error(
-          "validation-error",
-          MIXED_DIRECTION_CODE,
-          `${kind} edge in a ${direction(sink.directed)} graph (onMixedDirection: "error")`,
-          where
-        );
-        throw this.report.abort("mixed direction refused", { code: MIXED_DIRECTION_CODE });
-      case "expand":
-        return this.expand(source, target, kind, weight, where);
-      default: {
-        const name = this.policy;
-        throw new GraphFormatError("E_UNSUPPORTED", `unknown onMixedDirection ${name}`, {
-          option: "onMixedDirection",
-          found: name
-        });
-      }
-    }
-  }
-  /**
-   * How many edges were given a direction other than their own, under `onMixedDirection`
-   * "directed" or "undirected".
-   * @returns the count
-   */
-  get forced() {
-    return this.forcedCount;
-  }
-  /**
-   * Expand one edge that differs from the sink's direction.
-   * @param source - the source id
-   * @param target - the target id
-   * @param kind - the edge's direction in the file
-   * @param weight - the weight, or undefined
-   * @param where - the line and element, for issues
-   * @returns the primary edge index
-   */
-  expand(source, target, kind, weight, where) {
-    const { sink } = this;
-    if (!sink.directed) {
-      try {
-        const before = sink.edgeCount;
-        sink.setDirected(true, { expand: true });
-        this.adoptExpansionColumns();
-        this.report.counts.expandedMixed += before;
-      } catch (err) {
-        if (!(err instanceof GraphFormatError) || err.code !== "E_DIRECTED") {
-          throw err;
-        }
-        this.report.error(
-          "coercion",
-          DIRECTION_REFUSED_CODE,
-          `${direction(true)} edge in a locked ${direction(false)} sink cannot be expanded`,
-          where
-        );
-        throw this.report.abort("the sink refused the expansion to directed", {
-          code: DIRECTION_REFUSED_CODE,
-          reason: err.details.reason
-        });
-      }
-      if (kind === "directed") {
-        const e = sink.addEdge(source, target, weight);
-        this.track(e);
-        sink.setEdgeValue(this.directedHandle, e, true);
-        return e;
-      }
-    }
-    this.ensureExpansionColumns();
-    const first = sink.addEdge(source, target, weight);
-    this.track(first);
-    const mutual = kind === "mutual";
-    sink.setEdgeValue(this.directedHandle, first, mutual);
-    this.report.counts.expandedMixed++;
-    if (mutual) {
-      this.ensureMutualColumn();
-      sink.setEdgeValue(this.mutualHandle, first, true);
-    }
-    const u = sink.indexOf(source);
-    const v = sink.indexOf(target);
-    if (u === v) {
-      return first;
-    }
-    const mirror = sink.addEdge(target, source, weight);
-    this.track(mirror);
-    this.mirrorOfLast = mirror;
-    sink.setEdgeValue(this.directedHandle, mirror, mutual);
-    sink.setEdgeValue(this.pairHandle, first, mirror);
-    sink.setEdgeValue(this.pairHandle, mirror, first);
-    return first;
-  }
-  /**
-   * Note an edge index this resolver pushed, for the backfill of graphty.directed.
-   * @param e - the edge index
-   */
-  track(e) {
-    if (this.firstEdge < 0) {
-      this.firstEdge = e;
-    }
-    this.nextEdge = e + 1;
-  }
-  /**
-   * Pick up the reserved columns the builder wrote during its own expansion.
-   */
-  adoptExpansionColumns() {
-    this.directedHandle = this.sink.declareEdgeColumn(DIRECTED_DECL);
-    this.pairHandle = this.sink.declareEdgeColumn(PAIR_DECL);
-  }
-  /**
-   * Declare the reserved columns on first use in a directed sink and backfill graphty.directed
-   * = true for every edge this resolver pushed so far (they were directed in the source).
-   */
-  ensureExpansionColumns() {
-    if (this.pairHandle !== INVALID_INDEX) {
-      return;
-    }
-    this.directedHandle = this.sink.declareEdgeColumn(DIRECTED_DECL);
-    this.pairHandle = this.sink.declareEdgeColumn(PAIR_DECL);
-    if (this.firstEdge >= 0) {
-      for (let e = this.firstEdge; e < this.nextEdge; e++) {
-        this.sink.setEdgeValue(this.directedHandle, e, true);
-      }
-    }
-  }
-  /** Declare graphty.mutual on first use. */
-  ensureMutualColumn() {
-    if (this.mutualHandle === INVALID_INDEX) {
-      this.mutualHandle = this.sink.declareEdgeColumn(MUTUAL_DECL);
-    }
-  }
-}
-function reasonOf(err) {
-  const { reason } = err.details;
-  return typeof reason === "string" ? reason : "refused";
-}
-function direction(directed) {
-  return directed ? "directed" : "undirected";
-}
-function pairFolding(snapshot, options = {}) {
-  const foldMutual = options.foldMutual ?? false;
-  const directedColumn = roleColumn(snapshot.edges.byRole("directed"), "bool");
-  const pairColumn = roleColumn(snapshot.edges.byRole("pair"), "u32");
-  const mutualColumn = roleColumn(snapshot.edges.byRole("mutual"), "bool");
-  const { edgeCount } = snapshot;
-  const mateOf = (e) => {
-    if (!pairColumn?.isSet(e)) {
-      return INVALID_INDEX;
-    }
-    const mate = pairColumn.value(e);
-    return typeof mate === "number" && mate !== INVALID_INDEX ? mate : INVALID_INDEX;
-  };
-  const sourceDirected = (e) => directedColumn === null || !directedColumn.isSet(e) || directedColumn.value(e) === true;
-  const isMutual = (e) => {
-    if (mutualColumn === null) {
-      return false;
-    }
-    if (mutualColumn.isSet(e) && mutualColumn.value(e) === true) {
-      return true;
-    }
-    const mate = mateOf(e);
-    return mate !== INVALID_INDEX && mutualColumn.isSet(mate) && mutualColumn.value(mate) === true;
-  };
-  const folded = (e) => {
-    const mate = mateOf(e);
-    if (mate === INVALID_INDEX || mate >= e) {
-      return false;
-    }
-    return !sourceDirected(e) || foldMutual && isMutual(e);
-  };
-  let mutualCount = 0;
-  if (mutualColumn !== null) {
-    for (let e = 0; e < edgeCount; e++) {
-      if (mutualColumn.isSet(e) && mutualColumn.value(e) === true && mateOf(e) > e) {
-        mutualCount++;
-      }
-    }
-  }
-  return { expanded: pairColumn !== null, mutualCount, folded, mateOf, sourceDirected, isMutual };
-}
-function roleColumn(column, dtype) {
-  return column !== null && column.dtype === dtype ? column : null;
-}
 const CANONICAL_INTEGER = /^-?(0|[1-9]\d*)$/;
 function canonicalId(text) {
   if (text !== "-0" && CANONICAL_INTEGER.test(text)) {
@@ -2481,66 +2144,61 @@ function mangleNmtoken(text) {
   return out.length === 0 ? "_" : out;
 }
 export {
-  MUTUAL_COLUMN as $,
-  timeTextCompanion as A,
-  parseDecimalText as B,
-  sanitizeIds as C,
+  edgeWeights as $,
+  formatTimeValue as A,
+  mapDeclaredType as B,
+  joinListText as C,
   DictHeuristic as D,
-  formatTimeValue as E,
-  mapDeclaredType as F,
-  joinListText as G,
-  formatTemporal as H,
+  formatTemporal as E,
+  isCanonicalIntegerText as F,
+  countMixedEdges as G,
+  canonicalId as H,
   IdCoercer as I,
-  isCanonicalIntegerText as J,
+  TIME_TEXT_SUFFIX as J,
   declareOn as K,
   LOSS as L,
   takenIn as M,
   parseTemporal as N,
-  canonicalId as O,
-  coerceIdText as P,
-  DICT_SAMPLE_ROWS as Q,
+  DICT_SAMPLE_ROWS as O,
+  otherFormatDialect as P,
+  coerceIdText as Q,
   RENAMED_CODE as R,
-  otherFormatDialect as S,
+  reportWeightPrecision as S,
   TIME_TEXT_ROLE as T,
-  countMixedEdges as U,
-  reportWeightPrecision as V,
-  isNmtoken as W,
-  mangleNmtoken as X,
-  describe as Y,
-  DEFAULT_ERROR_LIMIT as Z,
-  DIRECTED_COLUMN as _,
+  isNmtoken as U,
+  mangleNmtoken as V,
+  describe as W,
+  DEFAULT_ERROR_LIMIT as X,
+  NO_CAPABILITIES as Y,
+  UNKNOWN_TYPE_CODE as Z,
+  coerceId as _,
   checkCapabilities as a,
-  NO_CAPABILITIES as a0,
-  PAIR_COLUMN as a1,
-  UNKNOWN_TYPE_CODE as a2,
-  coerceId as a3,
-  edgeWeights as a4,
-  forDecodedText as a5,
-  refusedSave as a6,
-  chooseGraph as b,
+  forDecodedText as a0,
+  refusedSave as a1,
+  resolveImportOptions as b,
   capabilities as c,
-  resolveImportOptions as d,
+  reportUnusedOptions as d,
   explicitWeights as e,
-  reportUnusedOptions as f,
-  reportSinkOptions as g,
+  reportSinkOptions as f,
+  chooseGraph as g,
   graphChosen as h,
-  DirectionResolver as i,
-  declareResolved as j,
-  TIME_TEXT_SUFFIX as k,
-  isNameChar as l,
-  isWeightField as m,
-  declareAttribute as n,
-  parseWeightText as o,
-  pairFolding as p,
-  overflowsToInfinity as q,
+  declareResolved as i,
+  isNameChar as j,
+  isWeightField as k,
+  declareAttribute as l,
+  parseDeclaredTemporal as m,
+  declareCompanion as n,
+  overflowsToInfinity as o,
+  parseWeightText as p,
+  parseDeclaredValue as q,
   resolveExportOptions as r,
-  parseDeclaredTemporal as s,
-  declareCompanion as t,
+  losesPrecision as s,
+  parseTimeText as t,
   uniqueColumnName as u,
-  parseDeclaredValue as v,
+  splitListText as v,
   weightFromValue as w,
-  losesPrecision as x,
-  parseTimeText as y,
-  splitListText as z
+  timeTextCompanion as x,
+  parseDecimalText as y,
+  sanitizeIds as z
 };
-//# sourceMappingURL=export-CZ7VRm4I.js.map
+//# sourceMappingURL=export-Cha4dRFz.js.map