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 byembedand 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.Overlayvariants — 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
LayoutStrategyadapters over thescenographsolvers.- 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.