graph-format-conv.

graph-format-converter is a small TypeScript/JavaScript library, published to npm and authored by the developer known as MrWormsy, that converts a graph between several client-side interchange formats. It targets four representations: a plain JSON node/edge structure, GEXF (following the Gephi 1.2 draft, see GEXF), GraphML as described in the GraphML primer (GraphML, GraphML 1.0), and the JSON produced by the export routine of the Graphology graph library. Its purpose is narrow and practical: read one of these formats into an in-memory model and re-serialize it as another, so the same graph can move between browser visualization stacks and file-based exchange without a server round-trip.

The API follows a fluent factory pattern. Static constructors GraphFormatConverter.fromJson(), fromGexf(), fromGraphml(), and fromGraphology() parse a source into a single converter instance, and instance methods toJson(), toGexf(), toGraphml(), and (per its Graphology support) an equivalent export emit the target format. Internally the model is the familiar separated-collection shape, an object holding a nodes array and an edges array, with per-element attributes carried through the conversion. GEXF and GraphML are parsed and produced as XML strings; the library depends on fast-xml-parser for XML handling and tinycolor2 for normalizing color attributes, and it is distributed under the ISC license.

In the broader graph-data ecosystem it occupies the space between visualization-oriented formats and generic tooling. It pairs naturally with Gephi and graphology (whose native JSON it round-trips), and overlaps in intent with converters and toolkits such as NetworkX, igraph, and the wider GraphInOut project, which cover far more formats. Compared with those, its scope is deliberately limited to the GEXF/GraphML/JSON/Graphology quartet common in web front ends.

Its main strengths are simplicity, TypeScript typings, zero server dependency, and correct handling of the visual attributes (color, size, position) that Gephi-style formats carry, which many generic converters drop. The limitations are equally clear: only four formats, inputs must be valid GEXF or GraphML, there is no streaming for very large graphs, and the project is effectively dormant, with version 1.6.2 dating to late 2022, a single maintainer, and negligible download and star counts. It is best viewed as a lightweight, self-contained utility for a specific web-graph workflow rather than a general-purpose conversion engine.