Module token_tui 

Purpose: Render token telemetry as package-backed terminal dashboards.

Structs

AtlasLayout 🔒

Deterministic centered layout for the small resolved-relation projection.

AtlasNodePlacement 🔒

One force-settled node placement with graph-derived depth and cluster cues.

AtlasPreviewEdge 🔒

One real resolved relation retained by the bounded atlas preview.

CellAnsiStyle 🔒

Minimal style projection used by the ANSI serializer.

ModeledSourceGroup 🔒

Real modeled source bucket aggregated for display.

SavingsSourceRow 🔒

One visible aggregate row for savings-source telemetry.

ThemePalette 🔒

Semantic color palette used when serializing Ratatui cells to ANSI.

TokenAtlasPreview 🔒

Bounded, non-interactive projection of resolved relations from the active project database.

TokenMix 🔒

Signed and absolute token operands shown in the composition panel.

Enums

TokenDashboardTheme 🔒

Human token dashboard color mode.

Constants

ACTIVE_TOKEN_THEME 🔒

Active token dashboard theme for the current render pass.

ATLAS_CANVAS_X_BOUND 🔒

Horizontal Canvas bound retaining a margin inside the atlas panel.

ATLAS_CANVAS_Y_BOUND 🔒

Vertical Canvas bound retaining a margin above the atlas footer.

ATLAS_DASHBOARD_MIN_WIDTH 🔒

Width at which the human dashboard can show the atlas without crowding impact data.

ATLAS_LAYOUT_IDEAL_DISTANCE 🔒

Ideal graph-space edge length for the bounded force layout.

ATLAS_LAYOUT_INITIAL_TEMPERATURE 🔒

Maximum per-step node movement before deterministic cooling.

ATLAS_LAYOUT_ITERATIONS 🔒

Fixed force steps keep the bounded static preview deterministic and fast.

ATLAS_NODE_HALO_DEGREE 🔒

Degree at which a node receives a small depth halo instead of a single point.

ATLAS_PREVIEW_MAX_EDGES 🔒

Maximum real resolved links retained by the decorative atlas preview.

ATLAS_PREVIEW_MAX_NODES 🔒

Maximum real resolved nodes retained by the decorative atlas preview.

ATLAS_PREVIEW_MAX_NODE_DEGREE 🔒

Maximum links one visual hub may consume in the decorative preview.

DASHBOARD_HEIGHT 🔒

Fixed terminal height for the token overview dashboard snapshot.

DASHBOARD_MAX_WIDTH 🔒

Maximum human dashboard width.

LIGHT_THEME 🔒

Light terminal palette preserving the same semantic color roles.

THEME_BAR_EMPTY 🔒

Token dashboard inactive bar cells.

THEME_BG 🔒

Reserved terminal-canvas color; overview frames leave the shell background visible.

THEME_BLUE 🔒

Counterfactual/original-baseline blue.

THEME_BORDER 🔒

Token dashboard subtle warm panel border.

THEME_GREEN 🔒

Net saved/success green.

THEME_INK_WHITE 🔒

Token dashboard identity ivory.

THEME_MUTED 🔒

Token dashboard muted label text.

THEME_PANEL 🔒

Token dashboard panel background.

THEME_PURPLE 🔒

Repository-graph test and route accent.

THEME_RED 🔒

Token dashboard loss red.

THEME_TEXT 🔒

Token dashboard primary warm text.

THEME_YELLOW 🔒

Modeled/search/estimate yellow.

TOKEN_IMPACT_COLUMN_WIDTH 🔒

Stable width reserved for the token-impact column in the wide dashboard.

TREND_DASHBOARD_HEIGHT 🔒

Fixed terminal height for the token trend dashboard snapshot.

Functions

active_token_theme 🔒

Return the active token dashboard theme.

allocate_signed_total 🔒

Allocate a signed display total across real source groups and preserve the exact sum.

atlas_cluster_color 🔒

Map graph-derived first-hop branches to the stable dashboard accent palette.

atlas_layout 🔒

Settle one connected graph with the reusable force engine and center its strongest hub.

block_bar 🔒

Return a segmented bar matching the reference dashboard.

body_style 🔒

Body text style.

buffer_to_ansi_string 🔒

Convert a Ratatui buffer into ANSI-styled terminal text.

buffer_to_string 🔒

Convert a Ratatui buffer into trimmed terminal text.

center_symbol 🔒

Return a centered operator paragraph.

color_to_ansi 🔒

Convert one Ratatui color into foreground/background ANSI code.

composition_line 🔒

Return one composition row with a compact bar.

current_clock_label 🔒

Return a compact clock label for the footer status row.

dashboard_width 🔒

Return the preferred dashboard width.

file_handling_token_mix 🔒

Return the token operands that back the composition panel.

grouped_count 🔒

Format an unsigned count with thousands separators.

header_style 🔒

Header style used for panel titles.

hero_state_marker 🔒

Return the semantic marker used beside the saved-token headline.

hero_value_style 🔒

Large positive/negative hero value style.

identity_style 🔒

Identity label style.

identity_title_style 🔒

ProjectAtlas title identity style.

impact_bar_line 🔒

Return one labeled, exact ratio and its proportional block bar.

is_observed_source_bucket 🔒

Whether a bucket represents observed ProjectAtlas file handling.

label 🔒

Styled field label span.

modeled_group_index 🔒

Pick the reference-style source row for one modeled bucket.

modeled_source_groups 🔒

Return modeled source rows backed by actual telemetry buckets.

muted_bold_style 🔒

Muted bold label style.

muted_style 🔒

Muted text style.

observed_source_steps 🔒

Return observed source steps from real observed buckets, with legacy fallback.

panel 🔒

Return a screenshot-matched dashboard panel.

percentage_label 🔒

Format one part of a whole as a nearest integer percentage.

percentage_one_decimal 🔒

Format a percentage with one decimal place.

rate_label 🔒

Format an optional savings rate.

ratio 🔒

Return a stable ratio for Ratatui gauges.

reconciled_without_projectatlas 🔒

Return the screenshot hero’s reconciled conservative baseline operand.

reference_title 🔒

Return the reference-like spaced title treatment used for dominant section labels.

remap_to_light_theme 🔒

Convert one dark semantic role color into its light-theme counterpart.

render_atlas_map 🔒

Draw the bounded live repository constellation in the wide dashboard column.

render_atlas_message 🔒

Draw an explicit centered atlas state without substituting decorative data.

render_avoided_navigation_card 🔒

Draw the reference-style avoided navigation-work strip.

render_calibration_notes 🔒

Draw calibration notes without duplicating headline totals.

render_composition_and_signal 🔒

Draw the side-by-side composition and signal cards.

render_dashboard_to_ansi_string 🔒

Render one Ratatui frame into a deterministic ANSI terminal buffer.

render_dashboard_to_string 🔒

Render one Ratatui frame into a deterministic plain string buffer.

render_divider 🔒

Render a horizontal divider in a panel.

render_file_read_impact_row 🔒

Draw the source-reconciled file-read total and its observed/modeled split.

render_file_read_total 🔒

Draw the left file-read total with the reference document-icon hierarchy.

render_hero_value 🔒

Draw the saved-token headline as readable terminal text.

render_impact_metric 🔒

Draw one file-read component with its exact share of the reconciled total.

render_metric_column 🔒

Draw one metric operand in the hero equation.

render_overview_frame 🔒

Draw the full overview dashboard frame.

render_overview_frame_with_atlas 🔒

Draw the overview and, when requested and wide enough, its static live atlas.

render_overview_main 🔒

Draw the proven one-screen savings overview.

render_savings_breakdown_table 🔒

Draw the screenshot-style source table.

render_savings_composition 🔒

Draw observed-vs-modeled token composition.

render_signal_card 🔒

Draw signal metadata from the reference dashboard.

render_status_bar 🔒

Draw the compact footer/status row from the reference dashboard.

render_token_dashboard_plain_with_theme 🔒

Render the token overview as a plain terminal chart for agent payloads.

render_token_dashboard_with_atlas 🔒

Render the human token dashboard with its optional bounded live atlas.

render_token_header 🔒

Draw the title band.

render_token_hero 🔒

Draw the dominant saved-token hero panel.

render_token_trend_dashboard_plain_with_theme 🔒

Render token trends as a plain terminal chart for agent payloads.

render_token_trend_dashboard_with_theme 🔒

Render token trends as a human terminal dashboard with the selected theme.

render_trend_frame 🔒

Draw the full trend dashboard frame.

render_trend_table 🔒

Draw period rows for the trend dashboard.

render_vertical_separator 🔒

Render a vertical separator in a panel.

render_window_title_bar 🔒

Draw the reference-style app title bar and window controls.

resolve_dashboard_width 🔒

Resolve an explicit dashboard width before using the detected terminal width.

savings_source_rows_for_width 🔒

Aggregate visible accounting with screenshot-aligned labels.

section_title_style 🔒

Section title style used for dashboard chrome.

settle_atlas_layout 🔒

Settle the tiny deterministic preview with bounded Fruchterman-Reingold steps.

signed_color 🔒

Return the color for a signed value.

signed_count 🔒

Format a signed count with thousands separators.

signed_trend_color 🔒

Return a trend color that signals all-loss or mixed-sign series.

signed_trend_points 🔒

Convert trend periods into signed chart coordinates.

signed_y_bounds 🔒

Return y-axis bounds that preserve the sign of trend values and include zero.

split_signed_by_ratio 🔒

Split a signed value by a simple integer ratio.

themed_color 🔒

Remap the dark reference palette to the selected output palette.

token_atlas_network_relation 🔒

Return whether a relation belongs in the cross-entity atlas network.

token_dashboard_wants_atlas 🔒

Return whether the current terminal is wide enough for the optional atlas read.

token_title_style 🔒

Token Impact title style.

usize_to_isize_saturating 🔒

Convert a usize to isize without panicking on unusually large values.

value 🔒

Styled unsigned value span.

with_token_theme 🔒

Run one render closure with the selected token dashboard theme.