@graphty/graph-io 0.3.42 → 0.3.44

package/src/formats/gexf/index.ts

@@ -42,6 +42,7 @@ import {
     UNKNOWN_ENCODING_CODE,
     UNKNOWN_PARENT_CODE,
     UNKNOWN_XML_ATTRIBUTE_CODE,
+    XML_NESTING_CODE,
     XML_SYNTAX_CODE,
 } from "../../common/codes.js";
 import {
@@ -58,6 +59,7 @@ import {
     TIMED_STATIC_CODE,
     TIMESTAMP_CONFLICT_CODE,
     UNKNOWN_ATTRIBUTE_CODE,
+    UNKNOWN_PID_CODE,
     VALUE_OUTSIDE_OPTIONS_CODE,
     VIZ_DYNAMIC_CODE,
     VIZ_SKIPPED_CODE,
@@ -68,6 +70,7 @@ import {
 export { GEXF_1_2_CAPABILITIES, GEXF_LOSS, gexfExporter, type GexfExportOptions } from "./exporter.js";
 export { gexfImporter, type GexfImportOptions } from "./importer.js";
 export { type GexfVersion } from "./schema.js";
+export { GEXF_STYLE_CAPABILITIES, GRAPHTY_XML_NAMESPACE } from "./styles.js";
 
 /**
  * The issue codes the GEXF importer records, by name: the codes shared with
@@ -85,6 +88,8 @@ export const GEXF_ISSUE = Object.freeze({
     COLUMN_TYPE: COLUMN_TYPE_CODE,
     /** The XML is not well-formed. The import stops. */
     XML_SYNTAX: XML_SYNTAX_CODE,
+    /** Elements are nested more than 100,000 deep. The import stops. */
+    XML_NESTING: XML_NESTING_CODE,
     /** The input is not valid UTF-8. The import stops. */
     INVALID_UTF8: INVALID_UTF8_CODE,
     /**
@@ -121,6 +126,11 @@ export const GEXF_ISSUE = Object.freeze({
     EDGE_TYPE: EDGE_TYPE_CODE,
     /** A `pid` / `<parent for>` naming an unknown node, a `<parent>` without for, or the children of a skipped node. */
     UNKNOWN_PARENT: UNKNOWN_PARENT_CODE,
+    /**
+     * GEXF 1.0 only: a `pid` naming no node. Gephi 0.6 wrote `pid="0"` on its top-level nodes; the node stays
+     * top-level.
+     */
+    UNKNOWN_PID: UNKNOWN_PID_CODE,
     /** A `pid` / nested containment that would close a parent cycle; that link is dropped. */
     PARENT_CYCLE: PARENT_CYCLE_CODE,
     /** An inverted interval (start after end) of an element, a spell or a value; it is not kept. */

package/src/formats/gexf/schema.ts

@@ -71,6 +71,11 @@ const VIZ_ORIGIN = { format: GEXF_FORMAT, namespace: VIZ_NAMESPACE };
 /**
  * The fixed node column names the importer owns (design section 5.6): a declared attribute with
  * one of these titles is renamed `<title>#<id>` so the XML-derived column keeps its name and role.
+ *
+ * Deprecated, unchanged until the next major version: the viz role columns (`color`, `size`,
+ * `shape`, `shape.uri`, and on edges `color`, `thickness`, `shape`) and the rename of an attribute
+ * titled like one. The GEXF style reader (styles.ts) is the only code that turns them into
+ * drawing; in the next major they leave the import result.
  * @category Plugin helpers
  */
 export const NODE_COLUMNS = Object.freeze({