Struct CardPayload 

pub struct CardPayload {
    pub value: String,
    pub unit: Option<String>,
    pub icon: Option<String>,
    pub subtitle: Option<String>,
    pub delta_percent: Option<f64>,
    pub delta_label: Option<String>,
    pub sparkline: Option<Vec<f64>>,
}

Summary card payload. Renders as:

┌──────────────────────────────────────────┐
│ TITLE                          [icon]    │  ← title row (from Widget)
│                                          │
│ USD                       12,438.20      │  ← unit (sm, left) + value (lg, right)
│                                          │
│ This month        ↑ 12.3% vs last month  │  ← subtitle + growth
└──────────────────────────────────────────┘

Build with CardPayload::new + the chained setters; pass to WidgetPayload::Card.

Fields

value: String

Formatted primary value, e.g. “12,438.20” or “12.4K”. Use humanize_number for the K/M/B/T compaction.

unit: Option<String>

Optional unit / context label shown on the left side of the value row, e.g. “USD”, “rows”, “today”.

icon: Option<String>

Optional Lucide icon name (e.g. “dollar-sign”, “shopping-cart”). Rendered via the data-lucide attribute the wrapper already initializes.

subtitle: Option<String>

Optional caption below the value, e.g. “This month”.

delta_percent: Option<f64>

Percentage delta vs. the previous period, signed: +12.3 = up 12.3%, -4.1 = down 4.1%. The renderer picks the arrow + color from the sign.

delta_label: Option<String>

Optional comparison label, e.g. “vs last month”.

sparkline: Option<Vec<f64>>

Optional trend trail — a flat series of N points the renderer plots as a fade-right sparkline under the value. X is implicit (evenly spaced); Y autoscales between min/max. Pair with growth(...) so the pill matches the trail visually. Keep the series small (7–30 points) — anything denser turns into noise at sparkline scale.

Implementations

impl CardPayload

pub fn new(value: impl Into<String>) -> Self

New card with just a primary value. Caller picks the format — strings stay as-is, numbers should be pre-humanized with humanize_number / format_thousands.

pub fn unit(self, unit: impl Into<String>) -> Self

pub fn icon(self, icon: impl Into<String>) -> Self

pub fn subtitle(self, subtitle: impl Into<String>) -> Self

pub fn growth(self, current: f64, previous: f64) -> Self

Compute the delta automatically from current + previous raw numbers. Skips the delta when previous is zero (no baseline to grow from) or non-finite — the renderer just won’t show the growth row in that case.

pub fn delta(self, percent: f64, label: impl Into<String>) -> Self

Explicit delta percent (signed) + label. Use when you’ve computed the percentage yourself or want a custom label.

pub fn delta_label(self, label: impl Into<String>) -> Self

Standalone label for the delta — pairs with Self::growth for the common case “auto-compute the percent but customize the comparison label” (e.g. "vs prior 30d").

pub fn sparkline(self, points: impl IntoIterator<Item = f64>) -> Self

Attach a trend trail rendered as a fade-right sparkline under the value. Pass 7–30 raw numbers (daily totals, hourly counts, etc.); the renderer autoscales and colors the stroke to match Self::delta_percent’s sign.

Trait Implementations

impl Clone for CardPayload

fn clone(&self) -> CardPayload

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CardPayload

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CardPayload

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CardPayload

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.