@graphty/graph-io 0.3.24 → 0.3.26

package/dist/src/formats/graphml/constants.js

@@ -1,68 +1,139 @@
 /**
  * What the GraphML importer and exporter share: the namespace, the format facts, the reserved
- * column names of the XML-attribute-derived columns (design section 5.6), the `meta.extra`
+ * column names of the XML-attribute-derived columns, the `meta.extra`
  * keys the importer records for the exporter, and the issue and loss codes.
  */
-import { BAD_DEFAULT_CODE, COLUMN_RENAMED_CODE, COUNT_HINT_CODE, DIRECTION_FORCED_CODE, DIRECTION_REFUSED_CODE, DUPLICATE_EDGE_ID_CODE, DUPLICATE_KEY_CODE, DUPLICATE_NODE_CODE, ENCODING_FALLBACK_CODE, HYPEREDGE_CODE, ID_MERGED_CODE, ID_TEXT_TYPE_CODE, INVALID_ENCODING_CODE, INVALID_UTF8_CODE, MISSING_ENDPOINT_CODE, MISSING_ID_CODE, MIXED_DIRECTION_CODE, MULTIPLE_GRAPHS_CODE, MUTUAL_AS_UNDIRECTED_CODE, NO_GRAPH_CODE, OPTION_IGNORED_CODE, PARENTS_DROPPED_CODE, PRECISION_CODE, ROLE_DROPPED_CODE, ROLE_TAKEN_CODE, SINK_OPTION_CODE, STRAY_TEXT_CODE, UNKNOWN_ATTR_TYPE_CODE, UNKNOWN_ELEMENT_CODE, UNKNOWN_ENCODING_CODE, XML_SYNTAX_CODE, } from "../../common/codes.js";
-/** The GraphML namespace. */
+import { BAD_DEFAULT_CODE, COLUMN_RENAMED_CODE, COLUMN_TYPE_CODE, COUNT_HINT_CODE, COUNT_MISMATCH_CODE, DANGLING_REFERENCE_CODE, DIRECTION_FORCED_CODE, DIRECTION_REFUSED_CODE, DUPLICATE_ATTRIBUTE_CODE, DUPLICATE_EDGE_ID_CODE, DUPLICATE_KEY_CODE, DUPLICATE_NODE_CODE, ELEMENT_ISSUE, EMPTY_INPUT_CODE, ENCODING_CONFLICT_CODE, ENCODING_FALLBACK_CODE, HYPEREDGE_CODE, ID_MERGED_CODE, ID_TEXT_TYPE_CODE, INPUT_ISSUE, INVALID_ENCODING_CODE, INVALID_UTF8_CODE, MISSING_ENDPOINT_CODE, MISSING_ID_CODE, MIXED_DIRECTION_CODE, MULTIPLE_GRAPHS_CODE, MUTUAL_AS_UNDIRECTED_CODE, NO_GRAPH_CODE, OPTION_IGNORED_CODE, PARENTS_DROPPED_CODE, PRECISION_CODE, ROLE_DROPPED_CODE, ROLE_TAKEN_CODE, SINK_OPTION_CODE, STRAY_TEXT_CODE, UNKNOWN_ATTR_TYPE_CODE, UNKNOWN_ELEMENT_CODE, UNKNOWN_ENCODING_CODE, UNKNOWN_PARENT_CODE, UNKNOWN_XML_ATTRIBUTE_CODE, XML_SYNTAX_CODE, } from "../../common/codes.js";
+/**
+ * The GraphML namespace.
+ * @category Plugin helpers
+ */
 export const GRAPHML_NAMESPACE = "http://graphml.graphdrawing.org/xmlns";
-/** The yFiles extension namespace, declared as `xmlns:y` when a yfiles column is written. */
+/**
+ * The yFiles extension namespace, declared as `xmlns:y` when a yfiles column is written.
+ * @category Plugin helpers
+ */
 export const YFILES_NAMESPACE = "http://www.yworks.com/xml/graphml";
-/** The XML Schema instance namespace and the schema location the exporter writes. */
+/**
+ * The XML Schema instance namespace and the schema location the exporter writes.
+ * @category Plugin helpers
+ */
 export const XSI_NAMESPACE = "http://www.w3.org/2001/XMLSchema-instance";
-/** The GraphML schema location written by the exporter. */
+/**
+ * The GraphML schema location written by the exporter.
+ * @category Plugin helpers
+ */
 export const SCHEMA_LOCATION = "http://graphml.graphdrawing.org/xmlns http://graphml.graphdrawing.org/xmlns/1.0/graphml.xsd";
-/** The format name. */
+/**
+ * The format name.
+ * @category Plugin helpers
+ */
 export const FORMAT = "graphml";
-/** File extensions. */
+/**
+ * File extensions.
+ * @category Plugin helpers
+ */
 export const EXTENSIONS = Object.freeze([".graphml", ".xml"]);
-/** MIME types. */
+/**
+ * MIME types.
+ * @category Plugin helpers
+ */
 export const MIME_TYPES = Object.freeze(["application/graphml+xml", "application/xml", "text/xml"]);
-/** The `attr.name` of the node key that carries ids rewritten by `sanitizeIds: "mangle"` (design section 8.5). */
+/**
+ * The `attr.name` of the node key that carries ids rewritten by `sanitizeIds: "mangle"`.
+ * @category Plugin helpers
+ */
 export const ORIGINAL_ID_ATTRIBUTE = "graphty:originalId";
-/** The node column that keeps original ids when `restoreMangledIds` is off (design section 5.6). */
+/**
+ * The node column that keeps original ids when `restoreMangledIds` is off.
+ * @category Plugin helpers
+ */
 export const ORIGINAL_ID_COLUMN = "graphty.originalId";
-/** The edge column of the `id` XML attribute (role id, unique). */
+/**
+ * The edge column of the `id` XML attribute (role id, unique).
+ * @category Plugin helpers
+ */
 export const EDGE_ID_COLUMN = "id";
-/** The edge columns of the `sourceport` / `targetport` XML attributes (roles sourcePort / targetPort). */
+/**
+ * The edge columns of the `sourceport` / `targetport` XML attributes (roles sourcePort / targetPort).
+ * @category Plugin helpers
+ */
 export const SOURCE_PORT_COLUMN = "sourceport";
-/** The edge column of the `targetport` XML attribute. */
+/**
+ * The edge column of the `targetport` XML attribute.
+ * @category Plugin helpers
+ */
 export const TARGET_PORT_COLUMN = "targetport";
-/** The node column of the containing node of a nested graph (u32, role parent, refersTo node). */
+/**
+ * The node column of the containing node of a nested graph (u32, role parent, refersTo node).
+ * @category Plugin helpers
+ */
 export const PARENT_COLUMN = "parent";
-/** The bool node column marking the hub nodes synthesised for hyperedges under `hyperedges: "star"`. */
+/**
+ * The bool node column marking the hub nodes synthesized for hyperedges under `hyperedges: "star"`.
+ * @category Plugin helpers
+ */
 export const HYPEREDGE_HUB_COLUMN = "graphty.hyperedge";
-/** The column name a node key titled `label` receives the `label` role under. */
+/**
+ * The column name a node key titled `label` receives the `label` role under.
+ * @category Plugin helpers
+ */
 export const LABEL_COLUMN = "label";
-/** Edge column names reserved for the XML-attribute-derived columns; a key titled like one is renamed `<name>#<id>`. */
+/**
+ * Edge column names reserved for the XML-attribute-derived columns; a key titled like one is renamed `<name>#<id>`.
+ * @category Plugin helpers
+ */
 export const RESERVED_EDGE_NAMES = new Set([
     EDGE_ID_COLUMN,
     SOURCE_PORT_COLUMN,
     TARGET_PORT_COLUMN,
 ]);
-/** Node column names reserved for the XML-derived columns. */
+/**
+ * Node column names reserved for the XML-derived columns.
+ * @category Plugin helpers
+ */
 export const RESERVED_NODE_NAMES = new Set([PARENT_COLUMN]);
-/** The `meta.extra` key under which the importer records what the exporter needs. */
+/**
+ * The `meta.extra` key under which the importer records what the exporter needs.
+ * @category Plugin helpers
+ */
 export const META_KEY = "graphml";
 /**
- * The issue codes the GraphML importer records (design section 8.6), by name: the codes shared
- * with the other importers (src/common/codes.ts) and the GraphML-specific ones. A key is the code
+ * The issue codes the GraphML importer records, by name: the codes shared
+ * with the other importers and the GraphML-specific ones. A key is the code
  * without its severity and format prefixes.
+ * @category Built-in formats
  */
 export const GRAPHML_ISSUE = Object.freeze({
-    /** Fatal: the input is not well-formed XML. */
+    ...INPUT_ISSUE,
+    ...ELEMENT_ISSUE,
+    /**
+     * A value that does not parse as the type its attribute declares ("x" in an integer attribute). The value is
+     * left unset; the node or edge is kept.
+     */
+    COLUMN_TYPE: COLUMN_TYPE_CODE,
+    /** The input is not well-formed XML. The import stops. */
     XML_SYNTAX: XML_SYNTAX_CODE,
-    /** Fatal: the input holds invalid UTF-8. */
+    /** 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: the root element is not `<graphml>`. */
+    /** A declared encoding the byte order mark contradicts (the mark wins). */
+    ENCODING_CONFLICT: ENCODING_CONFLICT_CODE,
+    /** The input holds no XML at all: it is empty, whitespace or a byte order mark only. The import stops. */
+    EMPTY_INPUT: EMPTY_INPUT_CODE,
+    /** The root element is not `<graphml>`. The import stops. */
     NOT_GRAPHML: "E_NOT_GRAPHML",
-    /** Fatal: the document has no `<graph>`. */
+    /** The `<graphml>` root is in a namespace other than GraphML's; it is read as GraphML. */
+    NAMESPACE: "W_GRAPHML_NAMESPACE",
+    /** The document has no `<graph>`. The import stops. */
     NO_GRAPH: NO_GRAPH_CODE,
     /** A `<key>` without an id. */
     KEY_MISSING_ID: "E_GRAPHML_KEY_MISSING_ID",
@@ -74,8 +145,18 @@ export const GRAPHML_ISSUE = Object.freeze({
     MISSING_ID: MISSING_ID_CODE,
     /** An `<edge>` without a source or a target. */
     MISSING_ENDPOINT: MISSING_ENDPOINT_CODE,
+    /** An edge endpoint that names no declared node under `addMissingNodes: false`; the edge is skipped. */
+    UNKNOWN_NODE: "E_UNKNOWN_NODE",
+    /** An edge endpoint that names a nested `<graph>`, not a node; a node of that id is created. */
+    GRAPH_ENDPOINT: "W_GRAPHML_GRAPH_ENDPOINT",
+    /** The nodes of a nested graph whose container node was skipped lose their parent. */
+    UNKNOWN_PARENT: UNKNOWN_PARENT_CODE,
+    /** Two `<data>` of one key on one element, two `<default>` in one key, or two weight keys; one is kept. */
+    DUPLICATE_ATTRIBUTE: DUPLICATE_ATTRIBUTE_CODE,
     /** A `<data>` whose key was never declared. */
     UNKNOWN_KEY: "E_GRAPHML_UNKNOWN_KEY",
+    /** A `<key>` declared after `<data>` that used it; those values were already reported and dropped. */
+    KEY_DECLARED_LATE: "W_GRAPHML_KEY_DECLARED_LATE",
     /** A `<data>` whose key is declared for another domain. */
     KEY_DOMAIN: "W_GRAPHML_KEY_DOMAIN",
     /** A `<data>` without a key attribute. */
@@ -98,10 +179,20 @@ export const GRAPHML_ISSUE = Object.freeze({
     INVALID_EDGEDEFAULT: "E_GRAPHML_INVALID_EDGEDEFAULT",
     /** A `<graph>` without edgedefault; the `defaultDirected` option applies. */
     EDGEDEFAULT_MISSING: "W_GRAPHML_EDGEDEFAULT_MISSING",
-    /** A second top-level `<graph>`; its nodes and edges are merged into the first. */
+    /**
+     * The file holds more than one top-level `<graph>`; their nodes and edges are merged into one graph.
+     * `importAllGraphs()` reads every one.
+     */
     MULTIPLE_GRAPHS: MULTIPLE_GRAPHS_CODE,
-    /** A `parse.nodes` / `parse.edges` hint the sink cannot reserve (ignored). */
+    /**
+     * A node or edge count the file announces is too large to reserve room for; it is ignored and the elements are
+     * read as they come.
+     */
     COUNT_HINT: COUNT_HINT_CODE,
+    /**
+     * A `parse.nodes` or `parse.edges` count disagrees with what the graph holds. The elements are read as they are.
+     */
+    COUNT_MISMATCH: COUNT_MISMATCH_CODE,
     /** A hyperedge under `hyperedges: "error"`. */
     HYPEREDGE: HYPEREDGE_CODE,
     /** Hyperedges skipped under `hyperedges: "skip"`. */
@@ -110,10 +201,23 @@ export const GRAPHML_ISSUE = Object.freeze({
     HYPEREDGE_ENDPOINT: "E_GRAPHML_HYPEREDGE_ENDPOINT",
     /** `<port>` declarations (and their data) are not kept; sourceport / targetport edge attributes are. */
     PORT_DECLARATION: "W_GRAPHML_PORT_DECLARATION",
-    /** A GraphML `parse.*` hint on `<graph>`, `<node>` or `<edge>` the importer does not act on (parse.nodeids, parse.order, ...). */
+    /** A `sourceport` / `targetport` naming a port its node does not declare (once, with the count). */
+    DANGLING_REFERENCE: DANGLING_REFERENCE_CODE,
+    /** A `<graph>` inside an `<edge>` (legal GraphML): it and the nodes and edges it holds are dropped. */
+    EDGE_GRAPH_DROPPED: "W_GRAPHML_EDGE_GRAPH_DROPPED",
+    /** A `<node>` whose id is that of a hub `hyperedges: "star"` created; the node is merged into the hub. */
+    HUB_ID_CLASH: "W_GRAPHML_HUB_ID_CLASH",
+    /** A `graphty:originalId` value that is not text, or arrives after the node was added (after its nested graph). */
+    ORIGINAL_ID_IGNORED: "W_GRAPHML_ORIGINAL_ID_IGNORED",
+    /** A yFiles graphics value (a geometry coordinate, a width) that is not a number; it is not mapped. */
+    YFILES_VALUE: "W_GRAPHML_YFILES_VALUE",
+    /**
+     * A GraphML `parse.*` attribute (`parse.nodeids`, `parse.order`, ...) that graph-io does not act on; the file is
+     * read normally.
+     */
     PARSE_HINT_IGNORED: "W_GRAPHML_PARSE_HINT_IGNORED",
-    /** An XML attribute GraphML does not define on `<graph>`, `<node>` or `<edge>`; it is not kept. */
-    UNKNOWN_XML_ATTRIBUTE: "W_GRAPHML_UNKNOWN_XML_ATTRIBUTE",
+    /** An XML attribute GraphML does not define (or the importer does not keep) on an element; it is not kept. */
+    UNKNOWN_XML_ATTRIBUTE: UNKNOWN_XML_ATTRIBUTE_CODE,
     /** A `<locator>` element. */
     LOCATOR_DROPPED: "W_GRAPHML_LOCATOR_DROPPED",
     /** A `<desc>` of a node, an edge or a hyperedge. */
@@ -124,54 +228,71 @@ export const GRAPHML_ISSUE = Object.freeze({
     STRAY_TEXT: STRAY_TEXT_CODE,
     /** Two distinct id texts merged into one number under `ids: "number"`. */
     ID_MERGED: ID_MERGED_CODE,
-    /** An option GraphML has no use for (`nodeIdFrom`: nodes are identified by their id attribute). */
+    /** You set an option this format does not use; it had no effect. The message names the option. */
     OPTION_IGNORED: OPTION_IGNORED_CODE,
     /** A yFiles key under `yfiles: "skip"`. */
     YFILES_SKIPPED: "W_GRAPHML_YFILES_SKIPPED",
-    /** A key renamed `<name>#<id>` because the name was taken (design section 5.6). */
+    /**
+     * An attribute was renamed `<name>#<suffix>` because another attribute already has its name, for example
+     * two attributes declared with the same name.
+     */
     COLUMN_RENAMED: COLUMN_RENAMED_CODE,
-    /** A key declared without its role because the table 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,
     /** A declared type the format does not define (kept as string). */
     UNKNOWN_ATTR_TYPE: UNKNOWN_ATTR_TYPE_CODE,
     /** A default that does not parse as the declared type. */
     BAD_DEFAULT: BAD_DEFAULT_CODE,
-    /** A long value beyond 2^53 rounded. */
+    /** An integer beyond 2^53 was stored as the nearest 64-bit float; pass `long: "string"` to keep every digit. */
     PRECISION: PRECISION_CODE,
-    /** A builder-policy option the sink does not honour. */
+    /**
+     * 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,
-    /** The sink refused the file's direction. */
+    /**
+     * You read into a graph builder whose direction is already set, or which already holds edges, so the file is read
+     * with the builder's direction instead of its own.
+     */
     DIRECTION_REFUSED: DIRECTION_REFUSED_CODE,
-    /** Edges forced to the policy's direction. */
+    /** Edges of the other direction were read with the direction `onMixedDirection` chose. */
     DIRECTION_FORCED: DIRECTION_FORCED_CODE,
-    /** A mixed file under onMixedDirection "error" (fatal). */
+    /**
+     * The graph has both directed and undirected edges and `onMixedDirection` is "error". An import stops; a save to a
+     * format that holds one direction per file fails with E_DIRECTED. Pass "directed" or "undirected" to read or write
+     * it anyway.
+     */
     MIXED_DIRECTION: MIXED_DIRECTION_CODE,
 });
 /**
  * Loss note codes of the GraphML importer (report.lossy) and exporter (check()): the GraphML
  * ones; the generic ones (dtypes, lists, json text, positions, visual and temporal roles,
  * extension tables, id charsets, the weight key clash, name changes) are those of `LOSS`.
+ * @category Built-in formats
  */
 export const GRAPHML_LOSS = Object.freeze({
-    /** yFiles nested XML kept as a JSON tree: structure preserved, not byte-exact. */
+    /** YFiles nested XML kept as a JSON tree: structure preserved, not byte-exact. */
     YFILES_JSON: "W_GRAPHML_YFILES_JSON",
     /** A mutual pair written as one undirected edge; the mark is lost. */
     MUTUAL_AS_UNDIRECTED: MUTUAL_AS_UNDIRECTED_CODE,
     /** A `parents` (multi-parent) column cannot be written as nested graphs. */
     PARENTS_DROPPED: PARENTS_DROPPED_CODE,
-    /** A role column GraphML has no slot for (kind, node ids, ...) written as a plain attribute. */
+    /** An attribute with a role the format has no place for is written as a plain attribute; the role is lost. */
     ROLE_DROPPED: ROLE_DROPPED_CODE,
     /** Containment order differs from index order; node indices change after a round trip. */
     HIERARCHY_REORDERED: "W_GRAPHML_HIERARCHY_REORDERED",
     /** Nodes whose parent chain never reaches a root are written at the top level. */
     PARENT_CYCLE: "W_GRAPHML_PARENT_CYCLE",
-    /** Node ids that change type after a round trip under the canonical rule (design section 4.1). */
+    /** Node ids that read back as a different type, such as the text "7" as the number 7. */
     ID_TEXT_TYPE: ID_TEXT_TYPE_CODE,
     /** A numeric edge id column reads back as string. */
     EDGE_ID_TEXT: "W_GRAPHML_EDGE_ID_TEXT",
     /** A `yfiles.*` graphics column that no longer matches its yFiles tree: only the tree is written. */
     YFILES_GRAPHICS_STALE: "W_GRAPHML_YFILES_GRAPHICS_STALE",
-    /** A yfiles json value that is not a serialisable tree: export() will throw E_COLUMN_TYPE. */
+    /** A yEd graphics value that is not valid XML; the save fails with E_COLUMN_TYPE. */
     YFILES_TREE: "E_GRAPHML_YFILES_TREE",
 });
 //# sourceMappingURL=constants.js.map

package/dist/src/formats/graphml/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/formats/graphml/constants.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../src/formats/graphml/constants.ts"],"names":[],"mappings":"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"}

package/dist/src/formats/graphml/exporter.d.ts

@@ -13,22 +13,30 @@
  * temporal roles, extension tables) plus the GraphML-specific ones (mutual edges written as
  * undirected, json columns without a yfiles origin written as JSON text, multi-parent columns,
  * containment order, ids that change type under the canonical rule, edge ids that read back as
- * strings, roles GraphML cannot express, yfiles values that are not serialisable trees).
+ * strings, roles GraphML cannot express, yfiles values that are not serializable trees).
  */
-import { type GraphExporter } from "../../types.js";
-/** The format-specific options of the GraphML exporter. */
-export interface GraphmlExportOptions {
-    /** Indent nested elements (default true); false writes one element per line without indentation. */
+import { type CommonExportOptions, type GraphExporter } from "../../types.js";
+/**
+ * The format-specific options of the GraphML exporter.
+ * @category Built-in formats
+ */
+export interface GraphmlExportOptions extends CommonExportOptions {
+    /**
+     * Indent nested elements; false writes one element per line without indentation.
+     * @defaultValue true
+     */
     pretty?: boolean | undefined;
     /**
-     * The top-level `edgedefault`. By default the one the importer recorded in
-     * `meta.extra.graphml` (so a mixed file re-imports with the same edge layout), else the
-     * snapshot's direction, with the majority direction for a mixed snapshot.
+     * The `edgedefault` of the graph element. The default is the one a GraphML import read, so a
+     * file with both directions reads back with the same edges marked, else the graph's direction
+     * (for a graph with both, the direction most edges have).
+     * @defaultValue as read
      */
     edgedefault?: "directed" | "undirected" | undefined;
 }
 /**
- * The GraphML exporter (design section 8.5).
+ * The GraphML exporter.
+ * @category Built-in formats
  */
 export declare const graphmlExporter: GraphExporter<GraphmlExportOptions>;
 //# sourceMappingURL=exporter.d.ts.map

package/dist/src/formats/graphml/exporter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../../../../src/formats/graphml/exporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAsBH,OAAO,EAAqD,KAAK,aAAa,EAAiB,MAAM,gBAAgB,CAAC;AAsBtH,2DAA2D;AAC3D,MAAM,WAAW,oBAAoB;IACjC,oGAAoG;IACpG,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B;;;;OAIG;IACH,WAAW,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,SAAS,CAAC;CACvD;AA01CD;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,oBAAoB,CAiC9D,CAAC"}
+{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../../../../src/formats/graphml/exporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAuBH,OAAO,EAAE,KAAK,mBAAmB,EAA2B,KAAK,aAAa,EAAiB,MAAM,gBAAgB,CAAC;AAsBtH;;;GAGG;AACH,MAAM,WAAW,oBAAqB,SAAQ,mBAAmB;IAC7D;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B;;;;;OAKG;IACH,WAAW,CAAC,EAAE,UAAU,GAAG,YAAY,GAAG,SAAS,CAAC;CACvD;AAk3CD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,aAAa,CAAC,oBAAoB,CAkC9D,CAAC"}

package/dist/src/formats/graphml/exporter.js

@@ -13,7 +13,7 @@
  * temporal roles, extension tables) plus the GraphML-specific ones (mutual edges written as
  * undirected, json columns without a yfiles origin written as JSON text, multi-parent columns,
  * containment order, ids that change type under the canonical rule, edge ids that read back as
- * strings, roles GraphML cannot express, yfiles values that are not serialisable trees).
+ * strings, roles GraphML cannot express, yfiles values that are not serializable trees).
  */
 import { GraphFormatError, INVALID_INDEX } from "@graphty/graph-format";
 import { childrenCsr } from "../../children.js";
@@ -23,6 +23,7 @@ import { capabilities, checkCapabilities, isNmtoken, LOSS, mangleNmtoken, saniti
 import { formatF32, formatF64, formatInteger } from "../../common/format.js";
 import { isCanonicalIntegerText } from "../../common/ids.js";
 import { resolveExportOptions } from "../../common/options.js";
+import { agree, plural } from "../../common/plural.js";
 import { explicitWeights } from "../../common/weights.js";
 import { encodeChunks, joinText } from "../../common/writer.js";
 import { xmlIllegalTextNotes } from "../../common/xml.js";
@@ -183,7 +184,7 @@ function planExport(snapshot, options, format) {
     // ids
     const idTypeChanges = countIdTypeChanges(snapshot);
     if (idTypeChanges > 0) {
-        note(GRAPHML_LOSS.ID_TEXT_TYPE, `${idTypeChanges} node id(s) change type when read back under ids: "canonical" (string ids that are integer text, non-integer numbers)`, null, idTypeChanges);
+        note(GRAPHML_LOSS.ID_TEXT_TYPE, `${idTypeChanges} node id${plural(idTypeChanges)} ${agree(idTypeChanges, "changes", "change")} type when read back under ids: "canonical" (string ids that are integer text, non-integer numbers)`, null, idTypeChanges);
     }
     const edgeIdColumn = snapshot.edges.byRole("id");
     if (edgeIdColumn !== null) {
@@ -195,7 +196,7 @@ function planExport(snapshot, options, format) {
     // direction: an undirected pair folds to one undirected edge, a mutual pair too (the mark is lost)
     const folding = pairFolding(snapshot, { foldMutual: true });
     if (folding.mutualCount > 0) {
-        note(GRAPHML_LOSS.MUTUAL_AS_UNDIRECTED, `${folding.mutualCount} mutual pair(s) are written as undirected edges; the mutual mark is lost`, null, folding.mutualCount);
+        note(GRAPHML_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`, null, folding.mutualCount);
     }
     const edgedefault = planEdgedefault(snapshot, folding, format, meta);
     // containment
@@ -204,7 +205,7 @@ function planExport(snapshot, options, format) {
         note(GRAPHML_LOSS.HIERARCHY_REORDERED, "nodes are written in containment order (children nested under their parent); node indices change after a round trip", hierarchy.parent?.meta.name ?? null);
     }
     if (hierarchy.unreachable > 0) {
-        note(GRAPHML_LOSS.PARENT_CYCLE, `${hierarchy.unreachable} node(s) whose parent chain never reaches a root are written at the top level`, hierarchy.parent?.meta.name ?? null, hierarchy.unreachable);
+        note(GRAPHML_LOSS.PARENT_CYCLE, `${hierarchy.unreachable} node${plural(hierarchy.unreachable)} whose parent chain never reaches a root ${agree(hierarchy.unreachable, "is", "are")} written at the top level`, hierarchy.parent?.meta.name ?? null, hierarchy.unreachable);
     }
     return {
         options,
@@ -340,7 +341,7 @@ function planWeight(snapshot, edgeColumns, keyIds, keys, note) {
     const attrName = fromGraphml && origin.title !== null ? origin.title : DEFAULT_WEIGHT_NAME;
     for (const plan of edgeColumns) {
         if (plan.attrName === attrName) {
-            note(LOSS.WEIGHT_KEY_CLASH, `edge column "${plan.column.meta.name}" is written as a key titled "${attrName}", which the importer reads as THE weight (weightFrom); it reads back as the weight, not as a column`, plan.column.meta.name, plan.column.length - plan.column.nullCount);
+            note(LOSS.WEIGHT_KEY_CLASH, `edge column "${plan.column.meta.name}" is written as a key titled "${attrName}", which the importer reads as the edge weight (weightFrom); it reads back as the weight, not as a column`, plan.column.meta.name, plan.column.length - plan.column.nullCount);
         }
     }
     if (!weights.weighted) {
@@ -378,10 +379,10 @@ function planEdgeIds(snapshot, column, options, note) {
         return;
     }
     if (options.sanitizeIds === "mangle") {
-        note(LOSS.ID_MANGLED, `${bad} edge id(s) outside the nmtoken charset are rewritten`, column.meta.name, bad);
+        note(LOSS.ID_MANGLED, `${bad} edge id${plural(bad)} outside the nmtoken charset ${agree(bad, "is", "are")} rewritten`, column.meta.name, bad);
     }
     else {
-        note(LOSS.ID_CHARSET, `${bad} edge id(s) outside the nmtoken charset; export() will throw unless sanitizeIds is "mangle"`, column.meta.name, bad);
+        note(LOSS.ID_CHARSET, `${bad} edge id${plural(bad)} outside the nmtoken charset; the save fails unless sanitizeIds is "mangle"`, column.meta.name, bad);
     }
 }
 /**
@@ -457,7 +458,7 @@ function planTable(table, domain, notes, note) {
         if (isGraphicsColumn(meta)) {
             const stale = domain === "graph" ? 0 : staleGraphicsRows(column, columns, domain);
             if (stale > 0) {
-                note(GRAPHML_LOSS.YFILES_GRAPHICS_STALE, `${stale} value(s) of ${domain} column "${name}" differ from the yFiles tree it was read from; only the tree is written, so they are lost`, name, stale);
+                note(GRAPHML_LOSS.YFILES_GRAPHICS_STALE, `${stale} value${plural(stale)} of ${domain} column "${name}" differ from the yFiles tree it was read from; only the tree is written, so they are lost`, name, stale);
             }
             continue;
         }
@@ -481,7 +482,7 @@ function planTable(table, domain, notes, note) {
         if (yfiles) {
             const bad = countBadTrees(column);
             if (bad > 0) {
-                note(GRAPHML_LOSS.YFILES_TREE, `${bad} value(s) of yfiles column "${name}" are not XML trees; export() will throw E_COLUMN_TYPE`, name, bad);
+                note(GRAPHML_LOSS.YFILES_TREE, `${bad} value${plural(bad)} of yfiles column "${name}" ${agree(bad, "is", "are")} not XML trees; the save fails with E_COLUMN_TYPE`, name, bad);
             }
         }
         const { origin } = meta;
@@ -572,6 +573,10 @@ function attrTypeFor(column) {
         case "u32":
             return columnMax(column) <= I32_MAX ? "int" : "long";
         case "string":
+            if (declared !== null && declared.trim().toLowerCase() === "long" && columnIntegerText(column)) {
+                // a long column read with long: "string" keeps its declared type, for other readers
+                return "long";
+            }
             if (declared !== null && TYPE_DTYPES[declared.trim().toLowerCase()] === undefined) {
                 // an unknown declared type kept as text (W_UNKNOWN_ATTR_TYPE on import) is restored as declared
                 return declared;
@@ -587,6 +592,20 @@ function attrTypeFor(column) {
         }
     }
 }
+/**
+ * Whether every set value of a string column is integer text, as a long column read with
+ * `long: "string"` holds.
+ * @param column - a string column
+ * @returns true when all set values are integer text
+ */
+function columnIntegerText(column) {
+    for (let r = 0; r < column.length; r++) {
+        if (column.isSet(r) && !/^[+-]?\d+$/.test(String(column.value(r)))) {
+            return false;
+        }
+    }
+    return true;
+}
 /**
  * Whether every set value of a numeric column is an integer.
  * @param column - an f64 column
@@ -637,7 +656,7 @@ function weightsIntegral(snapshot, weights) {
     return true;
 }
 /**
- * How many values of a yfiles column are not serialisable trees.
+ * How many values of a yfiles column are not serializable trees.
  * @param column - a json column
  * @returns the count
  */
@@ -936,7 +955,7 @@ function sanitizeEdgeIds(column, mode, edgeCount) {
         }
     }
     if (bad.length > 0 && mode === "error") {
-        throw new GraphFormatError("E_INVALID_ID", `${bad.length} edge id(s) cannot be written as nmtoken (first: ${JSON.stringify(edgeIdText(column, bad[0]))} at edge ${bad[0]}); pass sanitizeIds: "mangle" to rewrite them`, { reason: "charset", charset: "nmtoken", count: bad.length, edge: bad[0] });
+        throw new GraphFormatError("E_INVALID_ID", `${bad.length} edge id${plural(bad.length)} ${agree(bad.length, "is", "are")} not XML name tokens (first: ${JSON.stringify(edgeIdText(column, bad[0]))} at edge ${bad[0]}); pass sanitizeIds: "mangle" to rewrite them`, { reason: "charset", charset: "nmtoken", count: bad.length, edge: bad[0] });
     }
     for (const e of bad) {
         const base = mangleNmtoken(edgeIdText(column, e));
@@ -1149,10 +1168,12 @@ function* writeNodeSubtree(root, plan, ids, indent, step, stackNode, stackCursor
     }
 }
 /**
- * The GraphML exporter (design section 8.5).
+ * The GraphML exporter.
+ * @category Built-in formats
  */
 export const graphmlExporter = Object.freeze({
     format: FORMAT,
+    options: Object.freeze(["edgedefault", "pretty"]),
     capabilities: CAPABILITIES,
     /**
      * Pre-flight: every loss the export would incur.