Skip to main content

Module graph

Module graph 

Source
Expand description

Graph data structures for the spatial browser.

Core structures:

  • Graph: Main graph container backed by petgraph::StableGraph
  • Node: Webpage node with a transient projected position and metadata
  • EdgePayload: Edge semantics and traversal events between nodes

This module is WASM-clean: it must compile to wasm32-unknown-unknown.

Re-exports§

pub use cross_graph::ComponentCopy;
pub use identity::EdgeKey;
pub use identity::GraphDirection;
pub use identity::GraphIndex;
pub use identity::GraphViewId;
pub use identity::NodeKey;
pub use node::Node;
pub use node_facets::NodeFacetStore;
pub use node_facets::VisitHistoryFacet;
pub use history::NodeHistoryBranchAlternative;
pub use history::NodeHistoryBranchProjection;
pub use history::NodeHistoryBranchVisit;
pub use history::NodeHistoryOwner;
pub use history::NodeHistoryProjection;
pub use history::NodeHistorySemanticSummary;
pub use history::RecentVisit;
pub use history::SharedNavigationMemory;
pub use capture::CapturedDelta;
pub use capture::GraphTableStats;
pub use capture::replay_captured_deltas;
pub use capture::replay_captured_deltas_onto;
pub use capture::set_captured_delta_hook;
pub use journal::AttributedDelta;
pub use journal::GraphJournal;
pub use journal::USER_AUTHOR;
pub use journal::journal_capture_hook;
pub use source_time::SourceExtent;
pub use source_time::SourceTime;
pub use edge_data::ArrangementData;
pub use edge_data::ContainmentData;
pub use edge_data::EdgeMetrics;
pub use edge_data::ImportedData;
pub use edge_data::ProvenanceData;
pub use edge_data::REL_VOCAB;
pub use edge_data::SemanticData;
pub use edge_data::SemanticStatement;
pub use edge_data::SemanticStatementSpec;
pub use edge_data::StatementAssert;
pub use edge_data::Traversal;
pub use edge_data::TraversalData;
pub use edge_data::all_semantic_sub_kinds;
pub use edge_data::predicate_iri;
pub use edge_data::sub_kind_from_iri;
pub use edge_payload::EdgePayload;
pub use edge_taxonomy::ArrangementSubKind;
pub use edge_taxonomy::ContainmentSubKind;
pub use edge_taxonomy::EdgeAssertion;
pub use edge_taxonomy::EdgeFamily;
pub use edge_taxonomy::ImportedSubKind;
pub use edge_taxonomy::NavigationTrigger;
pub use edge_taxonomy::ProvenanceSubKind;
pub use edge_taxonomy::RelationDurability;
pub use edge_taxonomy::RelationKind;
pub use edge_taxonomy::RelationSelector;
pub use edge_taxonomy::SemanticSubKind;

Modules§

apply
capture
Stable-id graph-delta capture/replay helpers.
cross_graph
Cross-graph node copy (tear-out fork): mints a node in this graph from a donor node in another graph, recording cross-graph derivation provenance. Cross-graph node copy — the kernel half of the tear-out “fork” / cross-graph composability gesture (tear-out brief §7.5; tearout-composability plan C4).
display
A human-meaningful display label for a node.
edge_data
Per-family edge runtime data structs and semantic IRI mapping. Extracted from edge_taxonomy.rs per the 600-LOC ceiling.
edge_ops
Edge operations — assert, replay, dissolve, retract, traversal recording.
edge_payload
EdgePayload — the structural + temporal payload carried on every graph edge. Composes the taxonomy types from super::edge_taxonomy into a single payload struct whose typed sidecars are authoritative: EdgeFamily is derived from which sidecars are populated, not from a parallel index set.
edge_taxonomy
Edge taxonomy types — families, kinds, and sub-kinds.
facet_projection
PMEST facet projection — computes a queryable facet map from a node + graph context.
filter
Faceted filter expression engine.
history
Navigation history — one shared visit space for the whole graph.
identity
Graph identity types and rkyv archive helpers.
import_records
Import-record operations.
journal
The edit spine: mere’s captured-delta stream as a codicil log, replayed into the graph (the substrate’s append-only-log primitive over mere’s own edit vocabulary). See graph/journal.rs. The edit spine: mere’s captured-delta stream over the substrate log.
node
The kernel’s physical node wrapper around chartulary’s neutral Container.
node_facets
Typed projections over the graph’s atomic per-node facet store.
node_props
Node-property setters and per-node query accessors.
query
Graph query + traversal — node / edge lookups, neighbor iteration, BFS / shortest-path / connected-components / SCC, and the derived-edge views (semantic / arrangement / containment).
snapshot
Graph snapshot serialization.
source_time
Source-time selection, distinct from projected-scene delivery revisions.

Structs§

ArchivedDissolvedTraversalRecord
An archived DissolvedTraversalRecord
ArrangementEdgeView
ContainmentEdgeView
Coupling
One coupling rule: identity + target field + selector + response + strength.
CouplingId
Stable identity for a coupling rule.
DissolvedTraversalRecord
Traversal archive payload emitted when dissolving a node.
DissolvedTraversalRecordResolver
The resolver for an archived DissolvedTraversalRecord
EdgePathRule
Per edge-kind path-generation rule.
Field
A field as kernel truth: identity + portable definition + extent + lifecycle.
FieldId
Stable, federatable field identity. UUID-backed (vs quint’s original registry-local FieldId(u64)); this is the canonical id for kernel truth.
Graph
Main graph structure backed by petgraph::StableGraph
LogId
A stable identity for a log. Caller-chosen (a name, a URN, a hash you already hold), so identity is deterministic and needs no randomness source.
RelationView
Canonical read-side relation view. One row per (from, to, RelationKind) — a multi-relation node pair yields multiple rows. Replaces the EdgeType-flavoured EdgeView removed in stage 4 of the 2026-05-11 relation-taxonomy plan.
SemanticEdgeView
Seq
The position of an entry in a Codicil. Zero-based: the first appended entry is Seq(0).

Enums§

CouplingResponse
How a node responds to a field at its position.
EdgePath
How an edge’s path is generated between its two endpoints.
Falloff
Falloff shape for spatially-bounded scalar kernels (e.g. ScalarField::Disk).
FieldDefinition
A field’s portable definition: scalar- or vector-valued. The AST is data; quint evaluates it.
FieldExtent
Where a field applies. (Region is an axis-aligned world-space box, kept as four scalars to stay rkyv-friendly at the DTO layer without a Box2D archive helper.)
FieldLifecycle
Field lifecycle state. Mirrors the spirit of NodeLifecycle: a field is authored (Active) and can be retired without losing its definition for history/federation. Richer states (Warm/Cold equivalents) are deferred.
NodeHistoryTransitionKind
How an owner moved to a visit: navigation vocabulary.
NodeSelector
Selects which nodes a coupling applies to. Tag and kind names are opaque here — they resolve against the node’s tags / classifications.
ScalarField
A scalar field expression. Recursive cases use Box to keep the enum sized.
VectorField
A vector field expression.

Constants§

COUPLING_VOCAB
Base IRI for Mere’s coupling-response vocabulary (the statements-over-schema substrate applied to responses). The recognized force core maps to {COUPLING_VOCAB}{slug} via CouplingResponse::recognized_iri; the families beyond force name themselves under sub-namespaces, e.g. …/coupling#visual/highlight, nav/focus, selection/member, semantic/assert, trigger/fire. Provisional base; mirrors [crate::graph::edge_taxonomy]’s REL_VOCAB.