Skip to main content

Crate cartography

Crate cartography 

Source
Expand description

§Cartography

Non-destructive projection layer for the Mere browser.

Cartography sits between graph truth + intelligence signals on the input side, and canvas swatches on the output side. It owns the contracts — the LayoutStrategy trait, the Projection / Overlay / MinimapDescriptor vocabulary, and the IntelligenceSignals narrow shape that firewalls cartography from embed’ internals. The strategies themselves live in sibling crates (graph-layout, document-layout, …).

§The strategy contract

Cartography exposes the LayoutStrategy trait: one-shot, stateless analytic projection. Picks: Phyllotaxis, Penrose, Radial, Grid, Timeline, Kanban, L-system, Spectral, SemanticEmbedding. project() produces a final projection in one call. Live force physics (force-directed, the affinity force) is seiche’s domain; the old streaming-strategy contract was retired with the SemanticEdgeWeight projection once the seiche affinity force reached parity.

Strategies emit a Projection output type so canvases consume one shape uniformly. See the cartography layer brief for the full design.

§The framing

Inputs:

  • kernel::graph::Graph — read-only reference.
  • IntelligenceSignals — clusters, affinity, hot regions, bridge nodes, importance hints. Produced by embed and consumed through this narrow contract type, not a direct dependency on the crate’s internals.
  • ViewIntent — what the user is trying to see right now: scale, dimension, focus, filter, form factor (orrery root, workbench swatch, volvelle radial, astroid hub-collapse, minimap thumbnail).

Outputs:

  • Projection — positioned nodes + edges + overlays at a chosen layout, ready for a canvas swatch to render.
  • Overlay variants — semantic emphases canvases apply on top of geometry (cluster halos, edge weights, activity heat, bridge emphasis, importance scaling).
  • MinimapDescriptor — thumbnail-scale projection of any swatch.

The graph stays canonical. Cartography is representation, not truth.

§Status

Pre-1.0. v0 ships contract types only — no strategy implementations, no canvas integration.

Re-exports§

pub use minimap::MinimapDescriptor;
pub use minimap::MinimapOverlayKind;
pub use overlay::Overlay;
pub use projection::PositionedEdge;
pub use projection::PositionedNode;
pub use projection::Projection;
pub use projection::ProjectionMetadata;
pub use reading::ActorScope;
pub use reading::GRAPH_READING_REGISTRY_SCHEMA;
pub use reading::GraphReadingProfile;
pub use reading::GraphReadingRegistry;
pub use reading::ReadingEmphasis;
pub use reading::ReadingSurface;
pub use reading::default_graph_reading_registry;
pub use representation::BehaviorBinding;
pub use representation::ConditionOperation;
pub use representation::GRAPH_REPRESENTATION_REGISTRY_SCHEMA;
pub use representation::GraphRepresentationRegistry;
pub use representation::HostBehavior;
pub use representation::HostGesture;
pub use representation::PrimitiveBody;
pub use representation::PrimitiveProfile;
pub use representation::RepresentationCondition;
pub use representation::RepresentationLadder;
pub use representation::RepresentationMeasure;
pub use representation::RepresentationProfile;
pub use representation::RepresentationRung;
pub use representation::RepresentationState;
pub use representation::default_graph_representation_registry;
pub use representation::default_representation_ladder;
pub use request::AxisValue;
pub use request::FormFactor;
pub use request::NodeFilter;
pub use request::ProjectionDimension;
pub use request::ProjectionRequest;
pub use request::TargetSize;
pub use request::ViewIntent;
pub use scene_out::MERE_GRAPH_ADAPTER;
pub use scene_out::scene_from_projection;
pub use signals::AffinityScores;
pub use signals::BridgeNodes;
pub use signals::Cluster;
pub use signals::ClusterSet;
pub use signals::ImportanceWeights;
pub use signals::IntelligenceSignals;
pub use signals::NodeEmbeddings;
pub use spiral_score::MereSpiralProjection;
pub use spiral_score::project_spiral_score;
pub use spiral_score::project_spiral_score_for_view;
pub use strategy::LayoutStrategy;

Modules§

adapters
LayoutStrategy adapters over the scenograph solvers.
minimap
Minimap descriptor — how to render a thumbnail of a projection.
overlay
Overlay vocabulary — semantic emphases canvases apply over geometry.
projection
Projection: the output handed to canvas swatches.
reading
Portable ways to read one graph authority.
representation
Portable node-primitive and host-behavior vocabulary.
request
Request side: graph + signals + intent → projection request.
scene_out
The sceno scene output path — cartography as mere’s graph adapter.
signals
Narrow contract for signals from intelligence layers.
spiral_score
Mere’s graph-to-Scenograph Spiral adapter.
strategy
The analytic strategy contract.

Constants§

STAGE
Lifecycle stage marker.
VERSION
Crate version.