@graphty/graph-io 0.3.25 → 0.3.27

package/dist/src/formats/dot/index.js

@@ -1,6 +1,7 @@
 /**
- * The DOT / Graphviz subpath entry (`@graphty/graph-io/dot`, design section 8.2): the importer and
+ * The DOT / Graphviz subpath entry (`@graphty/graph-io/dot`): the importer and
  * exporter plugins with their option types and issue / loss codes.
+ * @module @graphty/graph-io/dot
  */
 export { DOT_LOSS, dotExporter } from "./exporter.js";
 export { DOT_ISSUE, dotImporter } from "./importer.js";

package/dist/src/formats/dot/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/formats/dot/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAyB,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,WAAW,EAAyB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/formats/dot/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAyB,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,SAAS,EAAE,WAAW,EAAyB,MAAM,eAAe,CAAC"}

package/dist/src/formats/dot/names.d.ts

@@ -4,26 +4,59 @@
  * gives a fixed meaning to.
  */
 import { type ColumnOriginInput } from "@graphty/graph-format";
-/** The format name. */
+/**
+ * The format name.
+ * @category Plugin helpers
+ */
 export declare const DOT_FORMAT = "dot";
-/** The origin recorded on every column the importer declares. */
+/**
+ * The origin recorded on every column the importer declares.
+ * @category Plugin helpers
+ */
 export declare const DOT_ORIGIN: ColumnOriginInput;
-/** The bool node column marking a cluster's container node. */
+/**
+ * The bool node column marking a cluster's container node.
+ * @category Plugin helpers
+ */
 export declare const CLUSTER_COLUMN = "graphty.cluster";
-/** The u32 node column (role parent, refersTo node) holding a member's cluster. */
+/**
+ * The u32 node column (role parent, refersTo node) holding a member's cluster.
+ * @category Plugin helpers
+ */
 export declare const PARENT_COLUMN = "graphty.parent";
-/** The string edge column (role sourcePort) holding an edge's tail port. */
+/**
+ * The string edge column (role sourcePort) holding an edge's tail port.
+ * @category Plugin helpers
+ */
 export declare const SOURCE_PORT_COLUMN = "graphty.sourcePort";
-/** The string edge column (role targetPort) holding an edge's head port. */
+/**
+ * The string edge column (role targetPort) holding an edge's head port.
+ * @category Plugin helpers
+ */
 export declare const TARGET_PORT_COLUMN = "graphty.targetPort";
-/** The attribute that is the display label (kept as text with role label). */
+/**
+ * The attribute that is the display label (kept as text with role label).
+ * @category Plugin helpers
+ */
 export declare const LABEL_ATTRIBUTE = "label";
-/** The node attribute holding a position, mapped to the position role column (design section 5.2). */
+/**
+ * The node attribute holding a position, mapped to the position role column (design section 5.2).
+ * @category Plugin helpers
+ */
 export declare const POS_ATTRIBUTE = "pos";
-/** The edge attribute cgraph uses as an edge's identity within its endpoints, mapped to the edge id role. */
+/**
+ * The edge attribute cgraph uses as an edge's identity within its endpoints, mapped to the edge id role.
+ * @category Plugin helpers
+ */
 export declare const KEY_ATTRIBUTE = "key";
-/** The node attribute a `!` suffix of `pos` sets (Graphviz's own spelling of a pinned position). */
+/**
+ * The node attribute a `!` suffix of `pos` sets (Graphviz's own spelling of a pinned position).
+ * @category Plugin helpers
+ */
 export declare const PIN_ATTRIBUTE = "pin";
-/** The key under meta.extra holding the format's graph flags (`{ strict: true }`). */
+/**
+ * The key under meta.extra holding the format's graph flags (`{ strict: true }`).
+ * @category Plugin helpers
+ */
 export declare const DOT_META_KEY = "dot";
 //# sourceMappingURL=names.d.ts.map

package/dist/src/formats/dot/names.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../../../src/formats/dot/names.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,uBAAuB;AACvB,eAAO,MAAM,UAAU,QAAQ,CAAC;AAEhC,iEAAiE;AACjE,eAAO,MAAM,UAAU,EAAE,iBAAyD,CAAC;AAEnF,+DAA+D;AAC/D,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAEhD,mFAAmF;AACnF,eAAO,MAAM,aAAa,mBAAmB,CAAC;AAE9C,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD,4EAA4E;AAC5E,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD,8EAA8E;AAC9E,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC,sGAAsG;AACtG,eAAO,MAAM,aAAa,QAAQ,CAAC;AAEnC,6GAA6G;AAC7G,eAAO,MAAM,aAAa,QAAQ,CAAC;AAEnC,oGAAoG;AACpG,eAAO,MAAM,aAAa,QAAQ,CAAC;AAEnC,sFAAsF;AACtF,eAAO,MAAM,YAAY,QAAQ,CAAC"}
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../../../../src/formats/dot/names.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,UAAU,QAAQ,CAAC;AAEhC;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,iBAAyD,CAAC;AAEnF;;;GAGG;AACH,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAEhD;;;GAGG;AACH,eAAO,MAAM,aAAa,mBAAmB,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,eAAe,UAAU,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAQ,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAQ,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,aAAa,QAAQ,CAAC;AAEnC;;;GAGG;AACH,eAAO,MAAM,YAAY,QAAQ,CAAC"}

package/dist/src/formats/dot/names.js

@@ -3,26 +3,59 @@
  * format-owned columns (design section 5.6: `graphty.` prefix) and the attribute names the format
  * gives a fixed meaning to.
  */
-/** The format name. */
+/**
+ * The format name.
+ * @category Plugin helpers
+ */
 export const DOT_FORMAT = "dot";
-/** The origin recorded on every column the importer declares. */
+/**
+ * The origin recorded on every column the importer declares.
+ * @category Plugin helpers
+ */
 export const DOT_ORIGIN = Object.freeze({ format: DOT_FORMAT });
-/** The bool node column marking a cluster's container node. */
+/**
+ * The bool node column marking a cluster's container node.
+ * @category Plugin helpers
+ */
 export const CLUSTER_COLUMN = "graphty.cluster";
-/** The u32 node column (role parent, refersTo node) holding a member's cluster. */
+/**
+ * The u32 node column (role parent, refersTo node) holding a member's cluster.
+ * @category Plugin helpers
+ */
 export const PARENT_COLUMN = "graphty.parent";
-/** The string edge column (role sourcePort) holding an edge's tail port. */
+/**
+ * The string edge column (role sourcePort) holding an edge's tail port.
+ * @category Plugin helpers
+ */
 export const SOURCE_PORT_COLUMN = "graphty.sourcePort";
-/** The string edge column (role targetPort) holding an edge's head port. */
+/**
+ * The string edge column (role targetPort) holding an edge's head port.
+ * @category Plugin helpers
+ */
 export const TARGET_PORT_COLUMN = "graphty.targetPort";
-/** The attribute that is the display label (kept as text with role label). */
+/**
+ * The attribute that is the display label (kept as text with role label).
+ * @category Plugin helpers
+ */
 export const LABEL_ATTRIBUTE = "label";
-/** The node attribute holding a position, mapped to the position role column (design section 5.2). */
+/**
+ * The node attribute holding a position, mapped to the position role column (design section 5.2).
+ * @category Plugin helpers
+ */
 export const POS_ATTRIBUTE = "pos";
-/** The edge attribute cgraph uses as an edge's identity within its endpoints, mapped to the edge id role. */
+/**
+ * The edge attribute cgraph uses as an edge's identity within its endpoints, mapped to the edge id role.
+ * @category Plugin helpers
+ */
 export const KEY_ATTRIBUTE = "key";
-/** The node attribute a `!` suffix of `pos` sets (Graphviz's own spelling of a pinned position). */
+/**
+ * The node attribute a `!` suffix of `pos` sets (Graphviz's own spelling of a pinned position).
+ * @category Plugin helpers
+ */
 export const PIN_ATTRIBUTE = "pin";
-/** The key under meta.extra holding the format's graph flags (`{ strict: true }`). */
+/**
+ * The key under meta.extra holding the format's graph flags (`{ strict: true }`).
+ * @category Plugin helpers
+ */
 export const DOT_META_KEY = "dot";
 //# sourceMappingURL=names.js.map

package/dist/src/formats/dot/names.js.map

@@ -1 +1 @@
-{"version":3,"file":"names.js","sourceRoot":"","sources":["../../../../src/formats/dot/names.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,uBAAuB;AACvB,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC;AAEhC,iEAAiE;AACjE,MAAM,CAAC,MAAM,UAAU,GAAsB,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AAEnF,+DAA+D;AAC/D,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAEhD,mFAAmF;AACnF,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAE9C,4EAA4E;AAC5E,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEvD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEvD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAEvC,sGAAsG;AACtG,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AAEnC,6GAA6G;AAC7G,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AAEnC,oGAAoG;AACpG,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AAEnC,sFAAsF;AACtF,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC"}
+{"version":3,"file":"names.js","sourceRoot":"","sources":["../../../../src/formats/dot/names.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,CAAC;AAEhC;;;GAGG;AACH,MAAM,CAAC,MAAM,UAAU,GAAsB,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;AAEnF;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAEhD;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAE9C;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEvD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEvD;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AAEvC;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AAEnC;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AAEnC;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC;AAEnC;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,CAAC"}

package/dist/src/formats/dot/tokenizer.d.ts

@@ -10,7 +10,10 @@
  */
 /** The kinds of token. */
 type DotTokenKind = "id" | "punct" | "eof";
-/** One token of a DOT document. */
+/**
+ * One token of a DOT document.
+ * @category Plugin helpers
+ */
 export interface DotToken {
     /** The kind. */
     readonly kind: DotTokenKind;
@@ -26,7 +29,10 @@ export interface DotToken {
     /** The 1-based line the token starts on. */
     readonly line: number;
 }
-/** The error the lexer and parser throw for a grammar violation; the importer turns it into a fatal parse-error. */
+/**
+ * The error the lexer and parser throw for a grammar violation; the importer turns it into a fatal parse-error.
+ * @category Plugin helpers
+ */
 export declare class DotSyntaxError extends Error {
     /** The 1-based line of the violation. */
     readonly line: number;
@@ -39,6 +45,7 @@ export declare class DotSyntaxError extends Error {
 }
 /**
  * A pull lexer over one DOT document with arbitrary lookahead.
+ * @category Plugin helpers
  */
 export declare class DotTokenizer {
     private readonly text;

package/dist/src/formats/dot/tokenizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../../../src/formats/dot/tokenizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0BAA0B;AAC1B,KAAK,YAAY,GAAG,IAAI,GAAG,OAAO,GAAG,KAAK,CAAC;AAE3C,mCAAmC;AACnC,MAAM,WAAW,QAAQ;IACrB,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED,oHAAoH;AACpH,qBAAa,cAAe,SAAQ,KAAK;IACrC,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;gBACS,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAK5C;AAgCD;;GAEG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAE9B,OAAO,CAAC,GAAG,CAAK;IAEhB,OAAO,CAAC,IAAI,CAAK;IAEjB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAE5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmD;IAE/E;;;;;OAKG;gBACS,IAAI,EAAE,MAAM,EAAE,WAAW,GAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAW;IAK9F;;;;OAIG;IACH,IAAI,CAAC,CAAC,SAAI,GAAG,QAAQ;IAOrB;;;OAGG;IACH,IAAI,IAAI,QAAQ;IAKhB;;;OAGG;IACH,OAAO,CAAC,GAAG;IAsDX;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IAwBf;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM;IAiDd;;;;;;OAMG;IACH,OAAO,CAAC,IAAI;IAoBZ;;OAEG;IACH,OAAO,CAAC,UAAU;IA0ClB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAgB3B"}
+{"version":3,"file":"tokenizer.d.ts","sourceRoot":"","sources":["../../../../src/formats/dot/tokenizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,0BAA0B;AAC1B,KAAK,YAAY,GAAG,IAAI,GAAG,OAAO,GAAG,KAAK,CAAC;AAE3C;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACrB,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,wCAAwC;IACxC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACrC,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;gBACS,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;CAK5C;AAqCD;;;GAGG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAE9B,OAAO,CAAC,GAAG,CAAK;IAEhB,OAAO,CAAC,IAAI,CAAK;IAEjB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAE5C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmD;IAE/E;;;;;OAKG;gBACS,IAAI,EAAE,MAAM,EAAE,WAAW,GAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAW;IAK9F;;;;OAIG;IACH,IAAI,CAAC,CAAC,SAAI,GAAG,QAAQ;IAOrB;;;OAGG;IACH,IAAI,IAAI,QAAQ;IAKhB;;;OAGG;IACH,OAAO,CAAC,GAAG;IAsDX;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IA0Bf;;;;;;;OAOG;IACH,OAAO,CAAC,MAAM;IAiDd;;;;;;OAMG;IACH,OAAO,CAAC,IAAI;IAoBZ;;OAEG;IACH,OAAO,CAAC,UAAU;IA+ClB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAM5B;;OAEG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAgB3B"}

package/dist/src/formats/dot/tokenizer.js

@@ -8,7 +8,10 @@
  * distinguished here: the parser matches a bare id case-insensitively, since a quoted `"node"` is
  * an ordinary id. Line numbers are 1-based and attached to every token for the report.
  */
-/** The error the lexer and parser throw for a grammar violation; the importer turns it into a fatal parse-error. */
+/**
+ * The error the lexer and parser throw for a grammar violation; the importer turns it into a fatal parse-error.
+ * @category Plugin helpers
+ */
 export class DotSyntaxError extends Error {
     /**
      * Create a syntax error.
@@ -29,15 +32,19 @@ const EOF_TOKEN_TEXT = "";
  * @returns true for an identifier start
  */
 function isIdentifierStart(c) {
-    return (c >= 65 && c <= 90) || (c >= 97 && c <= 122) || c === 95 || c >= 128;
+    return (c >= 65 && c <= 90) || (c >= 97 && c <= 122) || c === 95 || (c >= 128 && c !== BOM_CODE);
 }
+/** U+FEFF: a byte order mark, which only the decoder strips from the very start of the input. */
+const BOM_CODE = 0xfeff;
 /**
- * Whether a UTF-16 code unit may continue a bare DOT identifier.
+ * Whether a UTF-16 code unit may continue a bare DOT identifier. A U+FEFF inside an identifier
+ * run stays part of it, as Graphviz keeps its bytes (in its `\200-\377` range); only a U+FEFF
+ * between tokens is skipped as a stray BOM.
  * @param c - the code unit
  * @returns true for an identifier character
  */
 function isIdentifierPart(c) {
-    return isIdentifierStart(c) || isDigit(c);
+    return isIdentifierStart(c) || isDigit(c) || c === BOM_CODE;
 }
 /**
  * Whether a code unit is an ASCII digit.
@@ -49,6 +56,7 @@ function isDigit(c) {
 }
 /**
  * A pull lexer over one DOT document with arbitrary lookahead.
+ * @category Plugin helpers
  */
 export class DotTokenizer {
     /**
@@ -163,7 +171,9 @@ export class DotTokenizer {
         }
         this.pos = end;
         const numeral = text.slice(start, end);
-        if (end < text.length && isIdentifierStart(text.charCodeAt(end)) && this.onAmbiguity !== null) {
+        const after = text.charCodeAt(end); // NOSONAR(S7758): reads UTF-16 code units on purpose
+        // a letter (`1e3`) or a second dot (`1.2.3`) right after the numeral: Graphviz splits there
+        if (end < text.length && (isIdentifierStart(after) || after === 0x2e) && this.onAmbiguity !== null) {
             // Graphviz: "syntax ambiguity - badly delimited number '1e' ... splits into two tokens"
             this.onAmbiguity(numeral, line);
         }
@@ -279,6 +289,11 @@ export class DotTokenizer {
                 this.pos++;
                 continue;
             }
+            if (c === BOM_CODE) {
+                // a U+FEFF after the start (concatenated files) is whitespace; the shared text check reports it
+                this.pos++;
+                continue;
+            }
             if (c === 0x2f) {
                 const d = text.charCodeAt(this.pos + 1);
                 if (d === 0x2f) {

package/dist/src/formats/dot/tokenizer.js.map

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

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

@@ -13,14 +13,23 @@
  * timestamps and no typed lists; role columns of an unexpected shape; roles the format cannot
  * carry; attribute titles the importer would rename).
  */
-import { type ExportCapabilities, type GraphExporter } from "../../types.js";
+import { type CommonExportOptions, type ExportCapabilities, type GraphExporter } from "../../types.js";
 import { type GexfVersion } from "./schema.js";
-/** The format-specific options of the GEXF exporter. */
-export interface GexfExportOptions {
-    /** The GEXF version to write: "1.3" (default) or "1.2". */
+/**
+ * The format-specific options of the GEXF exporter.
+ * @category Built-in formats
+ */
+export interface GexfExportOptions extends CommonExportOptions {
+    /**
+     * The GEXF version to write.
+     * @defaultValue "1.3"
+     */
     version?: GexfVersion | undefined;
 }
-/** LossNote codes specific to the GEXF exporter, next to the shared LOSS codes. */
+/**
+ * LossNote codes specific to the GEXF exporter, next to the shared LOSS codes.
+ * @category Built-in formats
+ */
 export declare const GEXF_LOSS: Readonly<{
     /** GEXF 1.2 has no parallel-edge `kind`; the kind column is dropped. */
     KIND_DROPPED: "W_GEXF_KIND_DROPPED";
@@ -30,29 +39,51 @@ export declare const GEXF_LOSS: Readonly<{
     LIST_SEPARATOR: "W_LIST_SEPARATOR";
     /** A role column of a shape GEXF cannot map (a string `start`, a 2-component color); written as a plain attribute. */
     ROLE_SHAPE: "W_ROLE_SHAPE";
-    /** A temporal extension table without the element / start / end / value columns of design section 5.10. */
+    /** A temporal extension table without the element / start / end / value columns. */
     TEMPORAL_TABLE_SHAPE: "W_TEMPORAL_TABLE_SHAPE";
-    /** An attribute whose title the importer would rename on re-import (a reserved name). */
+    /** An attribute's name is one GEXF reserves, so a GEXF import would give it another name. */
     ATTRIBUTE_RENAMED: "W_ATTRIBUTE_RENAMED";
     /** A cell, default or option the declared type cannot express (skipped). */
     VALUE_UNWRITABLE: "W_VALUE_UNWRITABLE";
-    /** A declared type the target version lacks (1.2: date, dateTime, typed lists...); the canonical type is written. */
+    /**
+     * An attribute type that this GEXF version does not have (GEXF 1.2 has no date, dateTime or typed lists) is
+     * written as the nearest type it has.
+     */
     DECLARED_TYPE: "W_DECLARED_TYPE";
-    /** A node id whose text reads back as the other type under the canonical rule (design section 4.1): a non-integer number, a string of integer text. */
+    /**
+     * A node id that reads back as a different type: a number that is not an integer comes back as text, and text that
+     * looks like an integer ("42") comes back as a number, unless you read the file with `ids: "string"` or `ids:
+     * "keep"`.
+     */
     ID_TEXT_TYPE: "W_ID_TEXT_TYPE";
     /** A numeric edge id column: GEXF edge ids read back as strings. */
     EDGE_ID_TEXT: "W_GEXF_EDGE_ID_TEXT";
-    /** A viz role column (position, color, size, thickness) that is not f32; the importer reads viz values as f32. */
+    /**
+     * A visual attribute (position, color, size, thickness) is stored at more precision than GEXF keeps; it reads back
+     * as a 32-bit float.
+     */
     VIZ_DTYPE: "W_GEXF_VIZ_DTYPE";
-    /** A plain `weight` edge column reads back as THE weight (the importer's weightFrom default). */
+    /**
+     * An attribute named `weight` without the weight role reads back as the edge weight, because GEXF reads weights
+     * from `weight` by default.
+     */
     WEIGHT_KEY_CLASH: "W_WEIGHT_KEY_CLASH";
-    /** A dict column without declared options gains one from its dictionary on re-import. */
+    /**
+     * A text attribute stored as a dictionary, without a declared list of allowed values, reads back with its distinct
+     * values as that list.
+     */
     OPTIONS_GAINED: "W_OPTIONS_GAINED";
-    /** A string cell holding a character XML 1.0 forbids; export() throws E_COLUMN_TYPE. */
+    /** A text value holds a character XML 1.0 forbids (most control characters); the save fails with E_COLUMN_TYPE. */
     XML_ILLEGAL_CHAR: "E_XML_ILLEGAL_CHAR";
 }>;
-/** The GEXF exporter (design section 8.5); `capabilities` describes the default 1.3 output. */
+/**
+ * The GEXF exporter; `capabilities` describes the default 1.3 output.
+ * @category Built-in formats
+ */
 export declare const gexfExporter: GraphExporter<GexfExportOptions>;
-/** The capabilities of a 1.2 export, for callers that pass `version: "1.2"`. */
+/**
+ * The capabilities of a 1.2 export, for callers that pass `version: "1.2"`.
+ * @category Built-in formats
+ */
 export declare const GEXF_1_2_CAPABILITIES: ExportCapabilities;
 //# sourceMappingURL=exporter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../../../../src/formats/gexf/exporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAgBH,OAAO,EAA4B,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAiB,MAAM,gBAAgB,CAAC;AACtH,OAAO,EAKH,KAAK,WAAW,EAWnB,MAAM,aAAa,CAAC;AAErB,wDAAwD;AACxD,MAAM,WAAW,iBAAiB;IAC9B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CACrC;AAED,mFAAmF;AACnF,eAAO,MAAM,SAAS;IAClB,wEAAwE;;IAExE,gFAAgF;;IAEhF,mGAAmG;;IAEnG,sHAAsH;;IAEtH,2GAA2G;;IAE3G,yFAAyF;;IAEzF,4EAA4E;;IAE5E,qHAAqH;;IAErH,uJAAuJ;;IAEvJ,oEAAoE;;IAEpE,kHAAkH;;IAElH,iGAAiG;;IAEjG,yFAAyF;;IAEzF,wFAAwF;;EAE1F,CAAC;AA+mDH,+FAA+F;AAC/F,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,iBAAiB,CA8BxD,CAAC;AAEH,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,EAAE,kBAAqC,CAAC"}
+{"version":3,"file":"exporter.d.ts","sourceRoot":"","sources":["../../../../src/formats/gexf/exporter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAiBH,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,kBAAkB,EAAE,KAAK,aAAa,EAAiB,MAAM,gBAAgB,CAAC;AACtH,OAAO,EAKH,KAAK,WAAW,EAWnB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,MAAM,WAAW,iBAAkB,SAAQ,mBAAmB;IAC1D;;;OAGG;IACH,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CACrC;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS;IAClB,wEAAwE;;IAExE,gFAAgF;;IAEhF,mGAAmG;;IAEnG,sHAAsH;;IAEtH,oFAAoF;;IAEpF,6FAA6F;;IAE7F,4EAA4E;;IAE5E;;;OAGG;;IAEH;;;;OAIG;;IAEH,oEAAoE;;IAEpE;;;OAGG;;IAEH;;;OAGG;;IAEH;;;OAGG;;IAEH,mHAAmH;;EAErH,CAAC;AAqnDH;;;GAGG;AACH,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,iBAAiB,CA+BxD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,qBAAqB,EAAE,kBAAqC,CAAC"}

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

@@ -22,12 +22,16 @@ import { formatF32, formatF64, formatInteger } from "../../common/format.js";
 import { isCanonicalIntegerText } from "../../common/ids.js";
 import { joinListText } from "../../common/lists.js";
 import { resolveExportOptions } from "../../common/options.js";
+import { agree, plural } from "../../common/plural.js";
 import { formatTemporal, formatTimeValue } from "../../common/temporal.js";
 import { explicitWeights } from "../../common/weights.js";
 import { encodeChunks, joinText } from "../../common/writer.js";
 import { xmlIllegalTextNotes } from "../../common/xml.js";
 import { canonicalScalarType, GEXF_FORMAT, GEXF_NAMESPACES, isListType, isScalarType, NODE_COLUMNS, OPEN_END, OPEN_START, parseTemporalTableName, RESERVED_EDGE_NAMES, RESERVED_NODE_NAMES, TEMPORAL_COLUMNS, VIZ_NAMESPACE, } from "./schema.js";
-/** LossNote codes specific to the GEXF exporter, next to the shared LOSS codes. */
+/**
+ * LossNote codes specific to the GEXF exporter, next to the shared LOSS codes.
+ * @category Built-in formats
+ */
 export const GEXF_LOSS = Object.freeze({
     /** GEXF 1.2 has no parallel-edge `kind`; the kind column is dropped. */
     KIND_DROPPED: "W_GEXF_KIND_DROPPED",
@@ -37,25 +41,41 @@ export const GEXF_LOSS = Object.freeze({
     LIST_SEPARATOR: "W_LIST_SEPARATOR",
     /** A role column of a shape GEXF cannot map (a string `start`, a 2-component color); written as a plain attribute. */
     ROLE_SHAPE: "W_ROLE_SHAPE",
-    /** A temporal extension table without the element / start / end / value columns of design section 5.10. */
+    /** A temporal extension table without the element / start / end / value columns. */
     TEMPORAL_TABLE_SHAPE: "W_TEMPORAL_TABLE_SHAPE",
-    /** An attribute whose title the importer would rename on re-import (a reserved name). */
+    /** An attribute's name is one GEXF reserves, so a GEXF import would give it another name. */
     ATTRIBUTE_RENAMED: "W_ATTRIBUTE_RENAMED",
     /** A cell, default or option the declared type cannot express (skipped). */
     VALUE_UNWRITABLE: "W_VALUE_UNWRITABLE",
-    /** A declared type the target version lacks (1.2: date, dateTime, typed lists...); the canonical type is written. */
+    /**
+     * An attribute type that this GEXF version does not have (GEXF 1.2 has no date, dateTime or typed lists) is
+     * written as the nearest type it has.
+     */
     DECLARED_TYPE: "W_DECLARED_TYPE",
-    /** A node id whose text reads back as the other type under the canonical rule (design section 4.1): a non-integer number, a string of integer text. */
+    /**
+     * A node id that reads back as a different type: a number that is not an integer comes back as text, and text that
+     * looks like an integer ("42") comes back as a number, unless you read the file with `ids: "string"` or `ids:
+     * "keep"`.
+     */
     ID_TEXT_TYPE: LOSS.ID_TEXT_TYPE,
     /** A numeric edge id column: GEXF edge ids read back as strings. */
     EDGE_ID_TEXT: "W_GEXF_EDGE_ID_TEXT",
-    /** A viz role column (position, color, size, thickness) that is not f32; the importer reads viz values as f32. */
+    /**
+     * A visual attribute (position, color, size, thickness) is stored at more precision than GEXF keeps; it reads back
+     * as a 32-bit float.
+     */
     VIZ_DTYPE: "W_GEXF_VIZ_DTYPE",
-    /** A plain `weight` edge column reads back as THE weight (the importer's weightFrom default). */
+    /**
+     * An attribute named `weight` without the weight role reads back as the edge weight, because GEXF reads weights
+     * from `weight` by default.
+     */
     WEIGHT_KEY_CLASH: LOSS.WEIGHT_KEY_CLASH,
-    /** A dict column without declared options gains one from its dictionary on re-import. */
+    /**
+     * A text attribute stored as a dictionary, without a declared list of allowed values, reads back with its distinct
+     * values as that list.
+     */
     OPTIONS_GAINED: LOSS.OPTIONS_GAINED,
-    /** A string cell holding a character XML 1.0 forbids; export() throws E_COLUMN_TYPE. */
+    /** A text value holds a character XML 1.0 forbids (most control characters); the save fails with E_COLUMN_TYPE. */
     XML_ILLEGAL_CHAR: LOSS.XML_ILLEGAL_CHAR,
 });
 const DTYPES_KEPT = ["f32", "f64", "i32", "bool", "dict", "string"];
@@ -122,7 +142,8 @@ function planExport(snapshot, options) {
             temporalText: true,
             positionDtype: "f32",
             roles: MAPPED_ROLES,
-            roleNames: ROLE_NAMES,
+            // GEXF 1.2 has no edge kind: the kind column is dropped (W_GEXF_KIND_DROPPED), not renamed
+            roleNames: version === "1.2" ? ROLE_NAMES_1_2 : ROLE_NAMES,
         }),
     ];
     const note = (code, message, column = null, count = null) => {
@@ -137,7 +158,7 @@ function planExport(snapshot, options) {
         }
     }
     if (typeChanges > 0) {
-        note(GEXF_LOSS.ID_TEXT_TYPE, `${typeChanges} node id(s) change type when read back under ids: "canonical" (string ids that are integer text, non-integer numbers); the file's idtype is not honoured by the importer`, null, typeChanges);
+        note(GEXF_LOSS.ID_TEXT_TYPE, `${typeChanges} node id${plural(typeChanges)} ${agree(typeChanges, "changes", "change")} type when read back under ids: "canonical" (string ids that are integer text, non-integer numbers); the file's idtype is not honored by the importer`, null, typeChanges);
     }
     const edgeIds = snapshot.edges.byRole("id");
     if (edgeIds !== null && edgeIds.dtype !== "string" && edgeIds.dtype !== "dict") {
@@ -323,6 +344,8 @@ const ROLE_NAMES = Object.freeze({
     parent: NODE_COLUMNS.parent,
     parents: NODE_COLUMNS.parents,
 });
+/** ROLE_NAMES without the edge kind, which GEXF 1.2 cannot write. */
+const ROLE_NAMES_1_2 = Object.freeze(Object.fromEntries(Object.entries(ROLE_NAMES).filter(([role]) => role !== "kind")));
 /**
  * Find the role columns of a table; a role column of the wrong shape is noted and left to the
  * attribute pass.
@@ -707,7 +730,7 @@ function collectAttributes(snapshot, domain, roles, tables, version, note) {
             note(GEXF_LOSS.DECLARED_TYPE, `${domain} column "${name}" is declared ${typed.dropped}, which GEXF ${version} lacks; written as ${typed.type}`, name, null);
         }
         if (domain === "edge" && column !== null && column.meta.role === null && title === DEFAULT_WEIGHT_TITLE) {
-            note(GEXF_LOSS.WEIGHT_KEY_CLASH, `edge column "${name}" is written as an attribute titled "${title}", which the importer reads as THE weight (weightFrom); it reads back as the weight, not as a column`, name, column.length - column.nullCount);
+            note(GEXF_LOSS.WEIGHT_KEY_CLASH, `edge column "${name}" is written as an attribute titled "${title}", which the importer reads as the edge weight (weightFrom); it reads back as the weight, not as a column`, name, column.length - column.nullCount);
         }
         const reimportName = reserved.has(title) ? `${title}#${id}` : title;
         if (reimportName !== name) {
@@ -816,7 +839,7 @@ function declaredTexts(column, domain, typed, version, note) {
             }
         }
         if (count > 0) {
-            note(GEXF_LOSS.LIST_SEPARATOR, `${domain} column "${name}": ${count} row(s) hold an item containing "|", the 1.2 list separator`, name, count);
+            note(GEXF_LOSS.LIST_SEPARATOR, `${domain} column "${name}": ${count} row${plural(count)} ${agree(count, "holds", "hold")} an item containing "|", the 1.2 list separator`, name, count);
         }
     }
     return { defaultText, optionsText };
@@ -1415,9 +1438,13 @@ function graphExtraText(snapshot, key) {
     const value = gexfExtra[key];
     return typeof value === "string" ? value : null;
 }
-/** The GEXF exporter (design section 8.5); `capabilities` describes the default 1.3 output. */
+/**
+ * The GEXF exporter; `capabilities` describes the default 1.3 output.
+ * @category Built-in formats
+ */
 export const gexfExporter = Object.freeze({
     format: GEXF_FORMAT,
+    options: Object.freeze(["version"]),
     capabilities: CAPABILITIES_1_3,
     /**
      * Pre-flight: what export() would lose.
@@ -1447,6 +1474,9 @@ export const gexfExporter = Object.freeze({
         return joinText(writeGexf(snapshot, options));
     },
 });
-/** The capabilities of a 1.2 export, for callers that pass `version: "1.2"`. */
+/**
+ * The capabilities of a 1.2 export, for callers that pass `version: "1.2"`.
+ * @category Built-in formats
+ */
 export const GEXF_1_2_CAPABILITIES = CAPABILITIES_1_2;
 //# sourceMappingURL=exporter.js.map