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
| Submodule | What it provides |
|---|---|
ascii | AsciiRenderable trait and AsciiRenderer — optional text dump helper (ADR-0013). |
styled | StyledFrame / StyledLine / StyledSpan / SpanStyle / Color / Modifier — colour-aware projection consumed by the ratatui TUI and the static-HTML report tier. |
palette | Project-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. |
payload | Per-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§
- Null
Renderer - A no-op renderer with
Frame = ().
Traits§
- Renderer
- A renderer for environment
E.