Struct TableTheme 

pub struct TableTheme {
    pub border: Style,
    pub header: Style,
    pub row: Style,
    pub row_alt: Style,
    pub row_selected: Style,
    pub row_hover: Style,
    pub divider: Style,
    pub padding: u8,
    pub column_gap: u8,
    pub row_height: u8,
    pub effects: Vec<TableEffectRule>,
    pub preset_id: Option<TablePresetId>,
}

Shared theme for all table render paths.

This controls base styles (border/header/rows), spacing, and optional effect rules that can animate or accent specific rows/columns.

Determinism guidance: always supply an explicit phase from the caller (e.g., tick count or frame index). Avoid implicit clocks inside themes.

Examples

Apply a preset and add an animated row highlight:

use ftui_style::{
    TableEffect, TableEffectRule, TableEffectScope, TableEffectTarget, TableSection, TableTheme,
    Style,
};
use ftui_render::cell::PackedRgba;

let theme = TableTheme::aurora().with_effect(TableEffectRule::new(
    TableEffectTarget::Row(0),
    TableEffect::Pulse {
        fg_a: PackedRgba::rgb(240, 245, 255),
        fg_b: PackedRgba::rgb(255, 255, 255),
        bg_a: PackedRgba::rgb(28, 36, 54),
        bg_b: PackedRgba::rgb(60, 90, 140),
        speed: 1.0,
        phase_offset: 0.0,
    },
));

let resolver = theme.effect_resolver();
let phase = 0.25; // caller-supplied (e.g., tick * 0.02)
let scope = TableEffectScope::row(TableSection::Body, 0);
let _animated = resolver.resolve(theme.row, scope, phase);

Override a preset for custom header + zebra rows:

use ftui_style::{TableTheme, Style};
use ftui_render::cell::PackedRgba;

let theme = TableTheme::terminal_classic()
    .with_header(Style::new().fg(PackedRgba::rgb(240, 240, 240)).bold())
    .with_row_alt(Style::new().bg(PackedRgba::rgb(20, 20, 20)))
    .with_divider(Style::new().fg(PackedRgba::rgb(60, 60, 60)))
    .with_padding(1)
    .with_column_gap(2);

Fields

border: Style

Border style (table outline).

header: Style

Header row style.

row: Style

Base body row style.

row_alt: Style

Alternate row style for zebra striping.

row_selected: Style

Selected row style.

row_hover: Style

Hover row style.

divider: Style

Divider/column separator style.

padding: u8

Cell padding inside each column (in cells).

column_gap: u8

Gap between columns (in cells).

row_height: u8

Row height in terminal lines.

effects: Vec<TableEffectRule>

Effect rules resolved per row/column/section.

preset_id: Option<TablePresetId>

Optional preset identifier for diagnostics.

Implementations

impl TableTheme

pub const fn effect_resolver(&self) -> TableEffectResolver<'_>

Create a resolver that applies this theme’s effects.

pub fn preset(preset: TablePresetId) -> Self

Build a theme from a preset identifier.

pub fn with_border(self, border: Style) -> Self

Set the border style.

pub fn with_header(self, header: Style) -> Self

Set the header style.

pub fn with_row(self, row: Style) -> Self

Set the base row style.

pub fn with_row_alt(self, row_alt: Style) -> Self

Set the alternate row style.

pub fn with_row_selected(self, row_selected: Style) -> Self

Set the selected row style.

pub fn with_row_hover(self, row_hover: Style) -> Self

Set the hover row style.

pub fn with_divider(self, divider: Style) -> Self

Set the divider style.

pub fn with_padding(self, padding: u8) -> Self

Set table padding (cells inset).

pub fn with_column_gap(self, column_gap: u8) -> Self

Set column gap in cells.

pub fn with_row_height(self, row_height: u8) -> Self

Set row height in lines.

pub fn with_effects(self, effects: Vec<TableEffectRule>) -> Self

Replace effect rules.

pub fn with_effect(self, effect: TableEffectRule) -> Self

Append a single effect rule.

pub fn clear_effects(self) -> Self

Remove all effect rules.

pub fn with_preset_id(self, preset_id: Option<TablePresetId>) -> Self

Override the preset identifier (used for diagnostics).

pub fn aurora() -> Self

Luminous header with cool zebra rows.

pub fn graphite() -> Self

Monochrome, maximum legibility at dense data.

pub fn neon() -> Self

Neon accent header with vivid highlights.

pub fn slate() -> Self

Subtle slate tones for neutral dashboards.

pub fn solar() -> Self

Warm, sunlight-forward palette.

pub fn orchard() -> Self

Orchard greens with soft depth.

pub fn paper() -> Self

Light, paper-like styling for documentation tables.

pub fn midnight() -> Self

Deep, nocturnal palette with high contrast accents.

pub fn terminal_classic() -> Self

ANSI-16 baseline with richer palettes on 256/truecolor terminals.

pub fn terminal_classic_for(profile: ColorProfile) -> Self

ANSI-16 baseline with richer palettes on 256/truecolor terminals.

pub fn diagnostics(&self) -> TableThemeDiagnostics

Produce a deterministic diagnostics summary for logging or tests.

pub fn style_hash(&self) -> u64

Stable hash of base styles + layout parameters.

pub fn effects_hash(&self) -> u64

Stable hash of effect rules (target + effect + blend + mask).

Trait Implementations

impl Clone for TableTheme

fn clone(&self) -> TableTheme

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TableTheme

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for TableTheme

fn default() -> Self

Returns the “default value” for a type.