Optional structural adapter for translating Graphology-like graph instances
into Graphora RawGraph input.
Purpose
keep Graphology support outside @graphora/core
preserve Graphora's project-owned normalized graph store
let users bridge existing Graphology data into the engine-first API
Dependency Posture
This package does not depend on graphology. It accepts the small structural
surface Graphora needs: forEachNode and forEachEdge. Applications can pass
a real Graphology graph instance without making Graphology a transitive
dependency of Graphora's foundation packages.
Mapping
Default mapping:
Graphology node keys become Graphora node IDs.
Graphology edge keys become explicit Graphora edge IDs.
attributes.label becomes a Graphora label when it is a string.
numeric attributes.x and attributes.y become a Graphora node position.
serializable attributes other than label, x, and y become Graphora
attributes.
original Graphology attribute objects are preserved as data.
undirected Graphology edges map to directed: false.
Use mapping options when an application needs different labels, positions,
data, or attributes.
Non-Goals
Graphology is not a core dependency.
Graphora does not mutate the source Graphology graph.
Graphology algorithms and metrics remain outside this package.
Import/export formats such as GEXF or GraphML remain separate adapter work.