Skip to main content

Module render

Module render 

Source
Expand description

Optional rendering layer for debug output and TUI visualization.

Contains AsciiRenderable, Renderer (via the ascii sub-module), styled color primitives (styled / palette), and environment payload types (payload).

Rendering abstractions for environment visualization.

§Module layout

SubmoduleWhat it provides
asciiAsciiRenderable trait and AsciiRenderer — optional text dump helper (ADR-0013).
styledStyledFrame / StyledLine / StyledSpan / SpanStyle / Color / Modifier — colour-aware projection consumed by the ratatui TUI and the static-HTML report tier.
paletteProject-wide semantic colour constants (AGENT_FG, GOAL_FG, HAZARD_FG, …). Every styled-output implementor should reach for these rather than raw Color values to satisfy the accessibility contract.
payloadPer-family structured snapshot types (Landscape2DSnapshot, Box2dSnapshot, Locomotion2DSnapshot, …) and the corresponding opt-in payload-source traits consumed by the report tier.

§Renderer trait

Renderer is generic over frame type, so ASCII, image, and no-op renderers all share the same interface. Use NullRenderer when rendering is not required — Frame = () means no allocation occurs and the compiler eliminates every call site.

Re-exports§

pub use ascii::AsciiRenderable;
pub use ascii::AsciiRenderer;
pub use payload::Box2dPayloadSource;
pub use payload::Box2dSnapshot;
pub use payload::BodyKind;
pub use payload::CardTable;
pub use payload::Classic2DBody;
pub use payload::Classic2DPayloadSource;
pub use payload::Classic2DRole;
pub use payload::Classic2DSnapshot;
pub use payload::GridAgentMarker;
pub use payload::GridColor;
pub use payload::GridDir;
pub use payload::GridDoorState;
pub use payload::GridPayloadSource;
pub use payload::GridSnapshot;
pub use payload::GridTile;
pub use payload::Landscape2DPayloadSource;
pub use payload::Landscape2DSnapshot;
pub use payload::Locomotion2DPayloadSource;
pub use payload::Locomotion2DSnapshot;
pub use payload::Point2;
pub use payload::RigidBody2D;
pub use payload::TabularCell;
pub use payload::TabularGrid;
pub use payload::TabularLayout;
pub use payload::TabularMarker;
pub use payload::TabularMarkerKind;
pub use payload::TabularPayloadSource;
pub use payload::TabularSnapshot;
pub use styled::Color;
pub use styled::Modifier;
pub use styled::SpanStyle;
pub use styled::StyledFrame;
pub use styled::StyledLine;
pub use styled::StyledSpan;

Modules§

ascii
Optional plain-text rendering surface for environments.
palette
Project-wide semantic palette for styled environment renderings.
payload
Per-family structured-rendering surfaces for the rich report tier.
styled
Styled-output primitives consumed by the live TUI and report tiers.

Structs§

NullRenderer
A no-op renderer with Frame = ().

Traits§

Renderer
A renderer for environment E.