sequoia_core/

paint.rs

use std::sync::Arc;

use crate::geometry::{Rect, Size, Transform, Vec2};

#[derive(Clone, Copy, Debug, PartialEq)]
pub struct Color {
    pub r: f32,

    pub g: f32,

    pub b: f32,

    pub a: f32,
}

impl Color {
    pub const WHITE: Self = Self {
        r: 1.0,
        g: 1.0,
        b: 1.0,
        a: 1.0,
    };

    pub const BLACK: Self = Self {
        r: 0.0,
        g: 0.0,
        b: 0.0,
        a: 1.0,
    };

    pub const RED: Self = Self {
        r: 1.0,
        g: 0.0,
        b: 0.0,
        a: 1.0,
    };

    pub const GREEN: Self = Self {
        r: 0.0,
        g: 1.0,
        b: 0.0,
        a: 1.0,
    };

    pub const BLUE: Self = Self {
        r: 0.0,
        g: 0.0,
        b: 1.0,
        a: 1.0,
    };

    pub const TRANSPARENT: Self = Self {
        r: 0.0,
        g: 0.0,
        b: 0.0,
        a: 0.0,
    };

    pub const ALICEBLUE: Self = Self::hex(0xF0F8FF);

    pub const ANTIQUEWHITE: Self = Self::hex(0xFAEBD7);

    pub const AQUA: Self = Self::hex(0x00FFFF);

    pub const AQUAMARINE: Self = Self::hex(0x7FFFD4);

    pub const AZURE: Self = Self::hex(0xF0FFFF);

    pub const BEIGE: Self = Self::hex(0xF5F5DC);

    pub const BISQUE: Self = Self::hex(0xFFE4C4);

    pub const BLANCHEDALMOND: Self = Self::hex(0xFFEBCD);

    pub const BLUEVIOLET: Self = Self::hex(0x8A2BE2);

    pub const BROWN: Self = Self::hex(0xA52A2A);

    pub const BURLYWOOD: Self = Self::hex(0xDEB887);

    pub const CADETBLUE: Self = Self::hex(0x5F9EA0);

    pub const CHARTREUSE: Self = Self::hex(0x7FFF00);

    pub const CHOCOLATE: Self = Self::hex(0xD2691E);

    pub const CORAL: Self = Self::hex(0xFF7F50);

    pub const CORNFLOWERBLUE: Self = Self::hex(0x6495ED);

    pub const CORNSILK: Self = Self::hex(0xFFF8DC);

    pub const CRIMSON: Self = Self::hex(0xDC143C);

    pub const CYAN: Self = Self::hex(0x00FFFF);

    pub const DARKBLUE: Self = Self::hex(0x00008B);

    pub const DARKCYAN: Self = Self::hex(0x008B8B);

    pub const DARKGOLDENROD: Self = Self::hex(0xB8860B);

    pub const DARKGRAY: Self = Self::hex(0xA9A9A9);

    pub const DARKGREEN: Self = Self::hex(0x006400);

    pub const DARKGREY: Self = Self::hex(0xA9A9A9);

    pub const DARKKHAKI: Self = Self::hex(0xBDB76B);

    pub const DARKMAGENTA: Self = Self::hex(0x8B008B);

    pub const DARKOLIVEGREEN: Self = Self::hex(0x556B2F);

    pub const DARKORANGE: Self = Self::hex(0xFF8C00);

    pub const DARKORCHID: Self = Self::hex(0x9932CC);

    pub const DARKRED: Self = Self::hex(0x8B0000);

    pub const DARKSALMON: Self = Self::hex(0xE9967A);

    pub const DARKSEAGREEN: Self = Self::hex(0x8FBC8F);

    pub const DARKSLATEBLUE: Self = Self::hex(0x483D8B);

    pub const DARKSLATEGRAY: Self = Self::hex(0x2F4F4F);

    pub const DARKSLATEGREY: Self = Self::hex(0x2F4F4F);

    pub const DARKTURQUOISE: Self = Self::hex(0x00CED1);

    pub const DARKVIOLET: Self = Self::hex(0x9400D3);

    pub const DEEPPINK: Self = Self::hex(0xFF1493);

    pub const DEEPSKYBLUE: Self = Self::hex(0x00BFFF);

    pub const DIMGRAY: Self = Self::hex(0x696969);

    pub const DIMGREY: Self = Self::hex(0x696969);

    pub const DODGERBLUE: Self = Self::hex(0x1E90FF);

    pub const FIREBRICK: Self = Self::hex(0xB22222);

    pub const FLORALWHITE: Self = Self::hex(0xFFFAF0);

    pub const FORESTGREEN: Self = Self::hex(0x228B22);

    pub const FUCHSIA: Self = Self::hex(0xFF00FF);

    pub const GAINSBORO: Self = Self::hex(0xDCDCDC);

    pub const GHOSTWHITE: Self = Self::hex(0xF8F8FF);

    pub const GOLD: Self = Self::hex(0xFFD700);

    pub const GOLDENROD: Self = Self::hex(0xDAA520);

    pub const GRAY: Self = Self::hex(0x808080);

    pub const GREENYELLOW: Self = Self::hex(0xADFF2F);

    pub const GREY: Self = Self::hex(0x808080);

    pub const HONEYDEW: Self = Self::hex(0xF0FFF0);

    pub const HOTPINK: Self = Self::hex(0xFF69B4);

    pub const INDIANRED: Self = Self::hex(0xCD5C5C);

    pub const INDIGO: Self = Self::hex(0x4B0082);

    pub const IVORY: Self = Self::hex(0xFFFFF0);

    pub const KHAKI: Self = Self::hex(0xF0E68C);

    pub const LAVENDER: Self = Self::hex(0xE6E6FA);

    pub const LAVENDERBLUSH: Self = Self::hex(0xFFF0F5);

    pub const LAWNGREEN: Self = Self::hex(0x7CFC00);

    pub const LEMONCHIFFON: Self = Self::hex(0xFFFACD);

    pub const LIGHTBLUE: Self = Self::hex(0xADD8E6);

    pub const LIGHTCORAL: Self = Self::hex(0xF08080);

    pub const LIGHTCYAN: Self = Self::hex(0xE0FFFF);

    pub const LIGHTGOLDENRODYELLOW: Self = Self::hex(0xFAFAD2);

    pub const LIGHTGRAY: Self = Self::hex(0xD3D3D3);

    pub const LIGHTGREEN: Self = Self::hex(0x90EE90);

    pub const LIGHTGREY: Self = Self::hex(0xD3D3D3);

    pub const LIGHTPINK: Self = Self::hex(0xFFB6C1);

    pub const LIGHTSALMON: Self = Self::hex(0xFFA07A);

    pub const LIGHTSEAGREEN: Self = Self::hex(0x20B2AA);

    pub const LIGHTSKYBLUE: Self = Self::hex(0x87CEFA);

    pub const LIGHTSLATEGRAY: Self = Self::hex(0x778899);

    pub const LIGHTSLATEGREY: Self = Self::hex(0x778899);

    pub const LIGHTSTEELBLUE: Self = Self::hex(0xB0C4DE);

    pub const LIGHTYELLOW: Self = Self::hex(0xFFFFE0);

    pub const LIME: Self = Self::hex(0x00FF00);

    pub const LIMEGREEN: Self = Self::hex(0x32CD32);

    pub const LINEN: Self = Self::hex(0xFAF0E6);

    pub const MAGENTA: Self = Self::hex(0xFF00FF);

    pub const MAROON: Self = Self::hex(0x800000);

    pub const MEDIUMAQUAMARINE: Self = Self::hex(0x66CDAA);

    pub const MEDIUMBLUE: Self = Self::hex(0x0000CD);

    pub const MEDIUMORCHID: Self = Self::hex(0xBA55D3);

    pub const MEDIUMPURPLE: Self = Self::hex(0x9370DB);

    pub const MEDIUMSEAGREEN: Self = Self::hex(0x3CB371);

    pub const MEDIUMSLATEBLUE: Self = Self::hex(0x7B68EE);

    pub const MEDIUMSPRINGGREEN: Self = Self::hex(0x00FA9A);

    pub const MEDIUMTURQUOISE: Self = Self::hex(0x48D1CC);

    pub const MEDIUMVIOLETRED: Self = Self::hex(0xC71585);

    pub const MIDNIGHTBLUE: Self = Self::hex(0x191970);

    pub const MINTCREAM: Self = Self::hex(0xF5FFFA);

    pub const MISTYROSE: Self = Self::hex(0xFFE4E1);

    pub const MOCCASIN: Self = Self::hex(0xFFE4B5);

    pub const NAVAJOWHITE: Self = Self::hex(0xFFDEAD);

    pub const NAVY: Self = Self::hex(0x000080);

    pub const OLDLACE: Self = Self::hex(0xFDF5E6);

    pub const OLIVE: Self = Self::hex(0x808000);

    pub const OLIVEDRAB: Self = Self::hex(0x6B8E23);

    pub const ORANGE: Self = Self::hex(0xFFA500);

    pub const ORANGERED: Self = Self::hex(0xFF4500);

    pub const ORCHID: Self = Self::hex(0xDA70D6);

    pub const PALEGOLDENROD: Self = Self::hex(0xEEE8AA);

    pub const PALEGREEN: Self = Self::hex(0x98FB98);

    pub const PALETURQUOISE: Self = Self::hex(0xAFEEEE);

    pub const PALEVIOLETRED: Self = Self::hex(0xDB7093);

    pub const PAPAYAWHIP: Self = Self::hex(0xFFEFD5);

    pub const PEACHPUFF: Self = Self::hex(0xFFDAB9);

    pub const PERU: Self = Self::hex(0xCD853F);

    pub const PINK: Self = Self::hex(0xFFC0CB);

    pub const PLUM: Self = Self::hex(0xDDA0DD);

    pub const POWDERBLUE: Self = Self::hex(0xB0E0E6);

    pub const PURPLE: Self = Self::hex(0x800080);

    pub const REBECCAPURPLE: Self = Self::hex(0x663399);

    pub const ROSYBROWN: Self = Self::hex(0xBC8F8F);

    pub const ROYALBLUE: Self = Self::hex(0x4169E1);

    pub const SADDLEBROWN: Self = Self::hex(0x8B4513);

    pub const SALMON: Self = Self::hex(0xFA8072);

    pub const SANDYBROWN: Self = Self::hex(0xF4A460);

    pub const SEAGREEN: Self = Self::hex(0x2E8B57);

    pub const SEASHELL: Self = Self::hex(0xFFF5EE);

    pub const SIENNA: Self = Self::hex(0xA0522D);

    pub const SILVER: Self = Self::hex(0xC0C0C0);

    pub const SKYBLUE: Self = Self::hex(0x87CEEB);

    pub const SLATEBLUE: Self = Self::hex(0x6A5ACD);

    pub const SLATEGRAY: Self = Self::hex(0x708090);

    pub const SLATEGREY: Self = Self::hex(0x708090);

    pub const SNOW: Self = Self::hex(0xFFFAFA);

    pub const SPRINGGREEN: Self = Self::hex(0x00FF7F);

    pub const STEELBLUE: Self = Self::hex(0x4682B4);

    pub const TAN: Self = Self::hex(0xD2B48C);

    pub const TEAL: Self = Self::hex(0x008080);

    pub const THISTLE: Self = Self::hex(0xD8BFD8);

    pub const TOMATO: Self = Self::hex(0xFF6347);

    pub const TURQUOISE: Self = Self::hex(0x40E0D0);

    pub const VIOLET: Self = Self::hex(0xEE82EE);

    pub const WHEAT: Self = Self::hex(0xF5DEB3);

    pub const WHITESMOKE: Self = Self::hex(0xF5F5F5);

    pub const YELLOW: Self = Self::hex(0xFFFF00);

    pub const YELLOWGREEN: Self = Self::hex(0x9ACD32);

    pub const fn rgb(r: f32, g: f32, b: f32) -> Self {
        Self { r, g, b, a: 1.0 }
    }

    pub const fn rgba(r: f32, g: f32, b: f32, a: f32) -> Self {
        Self { r, g, b, a }
    }

    pub const fn rgb8(r: u8, g: u8, b: u8) -> Self {
        Self {
            r: r as f32 / 255.0,
            g: g as f32 / 255.0,
            b: b as f32 / 255.0,
            a: 1.0,
        }
    }

    pub const fn hex(hex: u32) -> Self {
        Self::rgb8((hex >> 16) as u8, (hex >> 8) as u8, hex as u8)
    }

    pub const fn hexa(hex: u32) -> Self {
        let mut c = Self::hex(hex >> 8);
        c.a = (hex as u8) as f32 / 255.0;
        c
    }

    pub fn to_linear(self) -> Self {
        fn channel(c: f32) -> f32 {
            if c <= 0.040_45 {
                c / 12.92
            } else {
                ((c + 0.055) / 1.055).powf(2.4)
            }
        }
        Self {
            r: channel(self.r),
            g: channel(self.g),
            b: channel(self.b),
            a: self.a,
        }
    }

    pub fn from_linear(self) -> Self {
        fn channel(c: f32) -> f32 {
            if c <= 0.003_130_8 {
                c * 12.92
            } else {
                1.055 * c.powf(1.0 / 2.4) - 0.055
            }
        }
        Self {
            r: channel(self.r),
            g: channel(self.g),
            b: channel(self.b),
            a: self.a,
        }
    }

    pub fn parse_hex(s: &str) -> Option<Self> {
        let h = s.strip_prefix('#').unwrap_or(s);
        let h = h.strip_prefix("0x").unwrap_or(h);
        let d = |c: u8| (c as char).to_digit(16);
        let bytes: [u8; 4] = match h.len() {
            3 | 4 => {
                let mut out = [0u8; 4];
                let mut it = h.bytes();
                for slot in out.iter_mut().take(h.len()) {
                    let v = d(it.next()?)? as u8;
                    *slot = v * 16 + v;
                }
                if h.len() == 3 {
                    out[3] = 0xFF;
                }
                out
            }
            6 | 8 => {
                let b = h.as_bytes();
                let pair =
                    |i: usize| d(b[i]).and_then(|hi| d(b[i + 1]).map(|lo| (hi * 16 + lo) as u8));
                let mut out = [pair(0)?, pair(2)?, pair(4)?, 0xFF];
                if h.len() == 8 {
                    out[3] = pair(6)?;
                }
                out
            }
            _ => return None,
        };
        Some(Self {
            r: bytes[0] as f32 / 255.0,
            g: bytes[1] as f32 / 255.0,
            b: bytes[2] as f32 / 255.0,
            a: bytes[3] as f32 / 255.0,
        })
    }

    pub fn to_rgb8(self) -> (u8, u8, u8) {
        let q = |c: f32| (c.clamp(0.0, 1.0) * 255.0).round() as u8;
        (q(self.r), q(self.g), q(self.b))
    }

    pub fn to_rgba8(self) -> (u8, u8, u8, u8) {
        let q = |c: f32| (c.clamp(0.0, 1.0) * 255.0).round() as u8;
        (q(self.r), q(self.g), q(self.b), q(self.a))
    }

    pub fn to_hex_string(self) -> String {
        let (r, g, b) = self.to_rgb8();
        format!("#{r:02X}{g:02X}{b:02X}")
    }

    pub fn to_hex8_string(self) -> String {
        let (r, g, b, a) = self.to_rgba8();
        format!("#{r:02X}{g:02X}{b:02X}{a:02X}")
    }

    pub fn with_alpha(self, alpha: f32) -> Self {
        Self {
            a: alpha.clamp(0.0, 1.0),
            ..self
        }
    }

    pub fn to_hsva(self) -> (f32, f32, f32, f32) {
        let (r, g, b) = (
            self.r.clamp(0.0, 1.0),
            self.g.clamp(0.0, 1.0),
            self.b.clamp(0.0, 1.0),
        );
        let max = r.max(g).max(b);
        let min = r.min(g).min(b);
        let d = max - min;
        let v = max;
        let s = if max <= f32::EPSILON { 0.0 } else { d / max };
        let h = if d <= f32::EPSILON {
            0.0
        } else if max == r {
            (((g - b) / d) % 6.0 + 6.0) % 6.0 / 6.0
        } else if max == g {
            ((b - r) / d + 2.0) / 6.0
        } else {
            ((r - g) / d + 4.0) / 6.0
        };
        (h, s, v, self.a.clamp(0.0, 1.0))
    }

    pub fn from_hsva(h: f32, s: f32, v: f32, a: f32) -> Self {
        let h = if h.is_finite() {
            h.rem_euclid(1.0)
        } else {
            0.0
        };
        let (s, v, a) = (s.clamp(0.0, 1.0), v.clamp(0.0, 1.0), a.clamp(0.0, 1.0));
        if s <= f32::EPSILON {
            return Self {
                r: v,
                g: v,
                b: v,
                a,
            };
        }
        let sector = h * 6.0;
        let i = sector.floor() as i32;
        let f = sector - sector.floor();
        let p = v * (1.0 - s);
        let q = v * (1.0 - s * f);
        let t = v * (1.0 - s * (1.0 - f));
        let (r, g, b) = match i.rem_euclid(6) {
            0 => (v, t, p),
            1 => (q, v, p),
            2 => (p, v, t),
            3 => (p, q, v),
            4 => (t, p, v),
            _ => (v, p, q),
        };
        Self { r, g, b, a }
    }

    pub fn from_hsl(h_deg: f32, s: f32, l: f32) -> Self {
        let h = if h_deg.is_finite() {
            h_deg.rem_euclid(360.0)
        } else {
            0.0
        };
        let (s, l) = (s.clamp(0.0, 1.0), l.clamp(0.0, 1.0));
        let a = s * l.min(1.0 - l);
        let f = |n: f32| {
            let k = (n + h / 30.0) % 12.0;
            l - a * (-1.0f32).max((k - 3.0).min(9.0 - k).min(1.0))
        };
        Self {
            r: f(0.0).clamp(0.0, 1.0),
            g: f(8.0).clamp(0.0, 1.0),
            b: f(4.0).clamp(0.0, 1.0),
            a: 1.0,
        }
    }

    pub fn to_hsl(self) -> (f32, f32, f32) {
        let (r, g, b) = (
            self.r.clamp(0.0, 1.0),
            self.g.clamp(0.0, 1.0),
            self.b.clamp(0.0, 1.0),
        );
        let mx = r.max(g).max(b);
        let mn = r.min(g).min(b);
        let d = mx - mn;
        let l = ((mx + mn) * 0.5).clamp(0.0, 1.0);
        if d <= f32::EPSILON {
            return (0.0, 0.0, l);
        }
        let s = (d / (1.0 - (2.0 * l - 1.0).abs())).clamp(0.0, 1.0);
        let h = if mx == r {
            ((g - b) / d) % 6.0
        } else if mx == g {
            (b - r) / d + 2.0
        } else {
            (r - g) / d + 4.0
        } * 60.0;
        (h.rem_euclid(360.0), s, l)
    }

    pub fn to_hex6(self) -> String {
        let (r, g, b) = self.to_rgb8();
        format!("{r:02X}{g:02X}{b:02X}")
    }
}

impl Default for Color {
    fn default() -> Self {
        Self::TRANSPARENT
    }
}

#[derive(Clone, Copy, Debug, PartialEq)]
pub struct Quad {
    pub rect: Rect,

    pub color: Color,

    pub radius: f32,

    pub border_color: Color,

    pub border_width: f32,
}

impl Quad {
    pub fn has_border(self) -> bool {
        self.border_width > 0.0 && self.border_color.a > 0.0
    }
}

#[derive(Clone, Copy, Debug, PartialEq)]
pub struct Shadow {
    pub rect: Rect,

    pub color: Color,

    pub radius: f32,

    pub blur: f32,

    pub spread: f32,

    pub offset: Vec2,

    pub inset: bool,
}

impl Shadow {
    pub fn is_visible(&self) -> bool {
        !self.rect.is_empty()
            && self.color.a > 0.0
            && self.blur >= 0.0
            && self.blur.is_finite()
            && (!self.inset || self.blur > 0.0)
    }

    pub fn bounds(&self) -> Rect {
        if self.inset {
            return self.rect;
        }
        let margin = self.blur * 0.5 + self.spread.max(0.0);
        Rect::from_xywh(
            self.rect.left() + self.offset.x - margin,
            self.rect.top() + self.offset.y - margin,
            self.rect.size.width + margin * 2.0,
            self.rect.size.height + margin * 2.0,
        )
    }
}

#[derive(Clone, Copy, Debug, PartialEq)]
pub struct GlyphQuad {
    pub rect: Rect,

    pub uv: [f32; 4],

    pub color_glyph: bool,
}

#[derive(Clone, Debug, Default, PartialEq)]
pub struct TextDraw {
    pub color: Color,

    pub glyphs: Vec<GlyphQuad>,
}

#[derive(Clone, Debug, PartialEq)]
#[non_exhaustive]
pub enum ImageSource {
    File(String),

    Rgba {
        id: u64,

        width: u32,

        height: u32,

        data: Arc<Vec<u8>>,
    },

    Dynamic {
        id: u64,

        width: u32,

        height: u32,

        data: Arc<Vec<u8>>,

        version: u64,
    },
}

impl ImageSource {
    pub fn cache_key(&self) -> u64 {
        match self {
            Self::File(path) => {
                let mut hash: u64 = 0xcbf2_9ce4_8422_2325;
                for byte in path.as_bytes() {
                    hash ^= u64::from(*byte);
                    hash = hash.wrapping_mul(0x0000_0100_0000_01b3);
                }
                hash ^ 0x9e37_79b9_7f4a_7c15
            }
            Self::Rgba { id, .. } => *id,
            Self::Dynamic { id, .. } => *id,
        }
    }

    pub fn dynamic_version(&self) -> Option<u64> {
        match self {
            Self::Dynamic { version, .. } => Some(*version),
            Self::File(_) | Self::Rgba { .. } => None,
        }
    }

    pub fn extent(&self) -> Option<(u32, u32)> {
        match self {
            Self::File(_) => None,
            Self::Rgba { width, height, .. } | Self::Dynamic { width, height, .. } => {
                Some((*width, *height))
            }
        }
    }
}

#[derive(Clone, Copy, Debug, Default, PartialEq, Eq)]
#[non_exhaustive]
pub enum ImageSampling {
    #[default]
    Linear,

    Nearest,
}

#[derive(Clone, Debug, PartialEq)]
pub struct ImageDraw {
    pub rect: Rect,

    pub uv: [f32; 4],

    pub source: ImageSource,

    pub sampling: ImageSampling,
}

#[derive(Clone, Debug, PartialEq)]
pub struct WaveformDraw {
    pub bars: Vec<Rect>,

    pub color: Color,
}

#[derive(Clone, Copy, Debug, PartialEq)]
pub struct BackdropDraw {
    pub rect: Rect,

    pub radius: f32,

    pub blur: f32,

    pub dim: Color,

    pub noise: f32,

    pub mask: SpanMask,
}

impl BackdropDraw {
    pub fn is_visible(self) -> bool {
        !self.rect.is_empty()
            && (self.blur > 0.0 && self.blur.is_finite() || self.dim.a > 0.0 || self.noise > 0.0)
    }
}

#[derive(Clone, Copy, Debug, PartialEq)]
#[non_exhaustive]
#[derive(Default)]
pub enum SpanMask {
    #[default]
    None,

    Linear {
        from: f32,
        to: f32,
        angle_rad: f32,
    },

    Uniform(f32),
}

impl SpanMask {
    pub fn mask_vec(self) -> [f32; 4] {
        match self {
            SpanMask::None => [0.0, 0.0, 0.0, 0.0],
            SpanMask::Linear {
                from,
                to,
                angle_rad,
            } => {
                let angle = if angle_rad.is_finite() {
                    angle_rad
                } else {
                    0.0
                };
                [1.0, from.clamp(0.0, 1.0), to.clamp(0.0, 1.0), angle]
            }
            SpanMask::Uniform(v) => [2.0, v.clamp(0.0, 1.0), 0.0, 0.0],
        }
    }

    pub fn is_none(self) -> bool {
        matches!(self, SpanMask::None)
    }
}

#[derive(Clone, Copy, Debug, PartialEq)]
pub struct BackdropSpan {
    pub at: usize,

    pub draw: BackdropDraw,

    pub clip: Option<RoundedClip>,
}

#[derive(Clone, Copy, Debug, PartialEq)]
pub struct FilterDraw {
    pub rect: Rect,

    pub radius: f32,

    pub blur: f32,

    pub mask: SpanMask,
}

impl FilterDraw {
    pub fn is_visible(self) -> bool {
        !self.rect.is_empty() && self.blur > 0.0 && self.blur.is_finite()
    }
}

#[derive(Clone, Copy, Debug, PartialEq)]
pub struct FilterSpan {
    pub start: usize,

    pub end: usize,

    pub draw: FilterDraw,

    pub clip: Option<RoundedClip>,
}

/// A contiguous range of paint items that share one group opacity.
///
/// Items keep their own alpha; the compositor applies `opacity` to the
/// already-composited range so overlapping children do not accumulate alpha.
#[derive(Clone, Copy, Debug, PartialEq)]
pub struct OpacitySpan {
    pub start: usize,

    pub end: usize,

    pub opacity: f32,

    pub depth: usize,
}

/// A flattened opacity-group tree derived from [`RenderList::opacity_plan`].
#[derive(Clone, Debug, PartialEq)]
#[non_exhaustive]
pub enum OpacityNode {
    /// A range of paint items drawn directly into the current target.
    Segment { start: usize, end: usize },

    /// A range that is composited into an offscreen layer at `opacity`.
    Group {
        opacity: f32,
        children: Vec<OpacityNode>,
    },
}

#[derive(Clone, Debug, PartialEq)]
pub struct GradientDraw {
    pub rect: Rect,

    pub radius: f32,

    pub kind: crate::brush::GradientKind,

    pub stops: crate::brush::GradientStops,
}

impl GradientDraw {
    pub fn is_visible(&self) -> bool {
        !self.rect.is_empty() && !self.stops.is_empty()
    }
}

/// Stable handle for a shader registered with the renderer.
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash, PartialOrd, Ord)]
pub struct ShaderId(pub u32);

impl ShaderId {
    /// Wraps a raw shader index.
    ///
    /// Handles returned by shader registration are the only valid values.
    #[must_use]
    pub const fn new(raw: u32) -> Self {
        Self(raw)
    }

    /// Returns the raw numeric handle.
    #[must_use]
    pub const fn get(self) -> u32 {
        self.0
    }
}

/// Identifier for an offscreen render target created by [`RenderList::begin_target`].
#[derive(Clone, Copy, Debug, PartialEq, Eq, Hash, PartialOrd, Ord)]
pub struct RenderTargetId(pub u64);

impl RenderTargetId {
    /// Wraps a raw target identifier.
    #[must_use]
    pub const fn new(raw: u64) -> Self {
        Self(raw)
    }

    /// Returns the raw target identifier.
    #[must_use]
    pub const fn get(self) -> u64 {
        self.0
    }
}

/// How a shader draw is composited with the destination.
#[derive(Clone, Copy, Debug, Default, PartialEq, Eq, Hash)]
#[non_exhaustive]
pub enum BlendMode {
    /// Standard source-over compositing (premultiplied alpha).
    #[default]
    Normal,

    /// Adds source and destination.
    Add,

    /// Multiplies source and destination.
    Multiply,

    /// Inverts the product of inverted source and destination.
    Screen,

    /// Subtracts the source from the destination.
    Subtract,

    /// Combines Multiply and Screen using the destination as the mask.
    Overlay,

    /// Keeps the darker of source and destination.
    Darken,

    /// Keeps the lighter of source and destination.
    Lighten,

    /// Brightens the destination to reflect the source.
    ColorDodge,

    /// Darkens the destination to reflect the source.
    ColorBurn,

    /// Combines Multiply and Screen using the source as the mask.
    HardLight,

    /// Softens the contrast between source and destination.
    SoftLight,

    /// Absolute difference between source and destination.
    Difference,

    /// Inverted difference with lower contrast.
    Exclusion,

    /// Takes hue from the source and saturation/lightness from the destination.
    Hue,

    /// Takes saturation from the source and hue/lightness from the destination.
    Saturation,

    /// Takes hue and saturation from the source and lightness from the destination.
    Color,

    /// Takes lightness from the source and hue/saturation from the destination.
    Luminosity,

    /// Selects the source where the destination is opaque.
    AlphaMask,
}

impl BlendMode {
    /// Stable GPU representation used by shader pipelines.
    #[must_use]
    pub const fn as_u32(self) -> u32 {
        match self {
            Self::Normal => 0,
            Self::Add => 1,
            Self::Multiply => 2,
            Self::Screen => 3,
            Self::Subtract => 4,
            Self::Overlay => 5,
            Self::Darken => 6,
            Self::Lighten => 7,
            Self::ColorDodge => 8,
            Self::ColorBurn => 9,
            Self::HardLight => 10,
            Self::SoftLight => 11,
            Self::Difference => 12,
            Self::Exclusion => 13,
            Self::Hue => 14,
            Self::Saturation => 15,
            Self::Color => 16,
            Self::Luminosity => 17,
            Self::AlphaMask => 18,
        }
    }
}

/// Texture made available to a shader draw.
#[derive(Clone, Debug, PartialEq)]
#[non_exhaustive]
pub enum TexInput {
    /// Output of an earlier offscreen target.
    Target(RenderTargetId),

    /// Bitmap image source. The renderer uploads and caches it by cache key.
    Image(ImageSource),
}

impl From<RenderTargetId> for TexInput {
    fn from(target: RenderTargetId) -> Self {
        Self::Target(target)
    }
}

/// A custom-shader rectangle.
#[derive(Clone, Debug, PartialEq)]
pub struct ShaderDraw {
    /// Destination rectangle in logical coordinates.
    pub rect: Rect,

    /// Texture coordinates as `[u0, v0, u1, v1]`.
    pub uv: [f32; 4],

    /// Registered shader to execute.
    pub shader: ShaderId,

    /// Raw uniform bytes exposed to the shader as `uniforms.values`.
    ///
    /// The renderer truncates payloads to [`MAX_SHADER_UNIFORM_BYTES`] and
    /// zero-fills the remainder.
    pub uniforms: Arc<[u8]>,

    /// Binding index and texture source pairs.
    pub textures: Arc<[(u32, TexInput)]>,

    /// Compositing mode applied to the shader output.
    pub blend: BlendMode,

    /// Additional opacity in the range `0..=1`.
    pub opacity: f32,
}

/// One pass of a render-target plan built by [`RenderList::target_plan`].
#[derive(Clone, Debug, PartialEq)]
#[non_exhaustive]
pub enum PassNode {
    /// Renders a range of items into an offscreen target.
    Render {
        /// Target that receives the items.
        target: RenderTargetId,

        /// Target size in logical coordinates.
        size: Size,

        /// Blend mode used when the target is composited.
        blend: BlendMode,

        /// Items to render, as indices into the render list.
        items: std::ops::Range<usize>,
    },

    /// Renders a range of items into the destination surface.
    Present {
        /// Items to render, as indices into the render list.
        items: std::ops::Range<usize>,
    },
}

/// Copy of an offscreen target into the current paint target.
#[derive(Clone, Copy, Debug, PartialEq)]
pub struct BlitDraw {
    /// Destination rectangle in logical coordinates.
    pub rect: Rect,

    /// Texture coordinates as `[u0, v0, u1, v1]`.
    pub uv: [f32; 4],

    /// Offscreen target to copy.
    pub target: RenderTargetId,

    /// Additional opacity in the range `0..=1`.
    pub opacity: f32,
}

/// Maximum number of uniform bytes available to one shader draw.
pub const MAX_SHADER_UNIFORM_BYTES: usize = 16 * 4 * 4;

/// Marker that starts drawing into an offscreen target.
#[derive(Clone, Copy, Debug, PartialEq)]
pub struct TargetBegin {
    /// Target being started.
    pub target: RenderTargetId,

    /// Target size in logical coordinates.
    pub size: Size,
}

/// Marker that finishes drawing into an offscreen target.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub struct TargetEnd {
    /// Target being finished.
    pub target: RenderTargetId,
}

#[derive(Clone, Debug, PartialEq)]
#[non_exhaustive]
pub enum RenderItem {
    Quad(Quad),

    Text(TextDraw),

    Image(ImageDraw),

    Shadow(Shadow),

    Waveform(WaveformDraw),

    Gradient(GradientDraw),

    /// Custom GPU shader draw.
    Shader(ShaderDraw),

    /// Offscreen target copy.
    Blit {
        rect: Rect,
        uv: [f32; 4],
        target: RenderTargetId,
        blend: BlendMode,
    },

    /// Starts an offscreen pass.
    TargetBegin {
        id: RenderTargetId,
        size: Size,
        blend: BlendMode,
    },

    /// Ends an offscreen pass.
    TargetEnd {
        id: RenderTargetId,
    },
}

pub const MAX_WAVEFORM_BARS: usize = 8192;

fn clip_uv(rect: Rect, uv: [f32; 4], clipped: Rect) -> [f32; 4] {
    let (w, h) = (rect.size.width, rect.size.height);
    if w <= 0.0 || h <= 0.0 {
        return uv;
    }
    let [u0, v0, u1, v1] = uv;
    let fx0 = (clipped.left() - rect.left()) / w;
    let fx1 = (clipped.right() - rect.left()) / w;
    let fy0 = (clipped.top() - rect.top()) / h;
    let fy1 = (clipped.bottom() - rect.top()) / h;
    [
        u0 + fx0 * (u1 - u0),
        v0 + fy0 * (v1 - v0),
        u0 + fx1 * (u1 - u0),
        v0 + fy1 * (v1 - v0),
    ]
}

#[derive(Clone, Copy, Debug, PartialEq)]
pub struct RoundedClip {
    pub rect: Rect,

    pub radius: f32,
}

#[derive(Clone, Copy, Debug, PartialEq)]
struct ClipEntry {
    clip: RoundedClip,

    under: Transform,
}

impl RoundedClip {
    pub fn new(rect: Rect, radius: f32) -> Self {
        let radius = if radius.is_finite() && radius > 0.0 {
            radius
        } else {
            0.0
        };
        Self { rect, radius }
    }

    pub fn is_rounded(self) -> bool {
        self.radius > 0.0 && !self.rect.is_empty()
    }
}

fn push_opacity_segment(nodes: &mut Vec<OpacityNode>, start: usize, end: usize) {
    if start >= end {
        return;
    }
    if let Some(OpacityNode::Segment { end: prev_end, .. }) = nodes.last_mut()
        && *prev_end == start
    {
        *prev_end = end;
        return;
    }
    nodes.push(OpacityNode::Segment { start, end });
}

fn build_opacity_nodes(
    spans: &[&OpacitySpan],
    mut index: usize,
    lo: usize,
    hi: usize,
) -> (Vec<OpacityNode>, usize) {
    let mut nodes = Vec::new();
    let mut cursor = lo;
    while index < spans.len() {
        let span = spans[index];
        if span.start >= hi {
            break;
        }
        if span.start < cursor || span.end > hi || span.end <= span.start {
            index += 1;
            continue;
        }
        if span.start > cursor {
            push_opacity_segment(&mut nodes, cursor, span.start);
        }
        let (children, next) = build_opacity_nodes(spans, index + 1, span.start, span.end);
        nodes.push(OpacityNode::Group {
            opacity: span.opacity,
            children,
        });
        cursor = span.end;
        index = next;
        if cursor >= hi {
            break;
        }
    }
    if cursor < hi {
        push_opacity_segment(&mut nodes, cursor, hi);
    }
    (nodes, index)
}

#[derive(Clone, Copy, Debug, PartialEq)]
struct OpacityEntry {
    opacity: f32,

    start: usize,

    depth: usize,
}

#[derive(Clone, Debug, Default)]
pub struct RenderList {
    items: Vec<RenderItem>,
    clip_stack: Vec<ClipEntry>,
    opacity_stack: Vec<OpacityEntry>,
    opacity_spans: Vec<OpacitySpan>,
    transform_stack: Vec<Transform>,

    item_clips: Vec<Option<RoundedClip>>,
    item_transforms: Vec<Transform>,

    backdrops: Vec<BackdropSpan>,

    filters: Vec<FilterSpan>,

    next_target: u64,

    target_count: u32,

    shader_count: u32,
}

/// Snapshot of a `RenderList` used to capture a suffix for layer caching.
#[derive(Clone, Copy, Debug, PartialEq, Eq)]
pub struct RenderMark {
    items: usize,
    item_clips: usize,
    item_transforms: usize,
    backdrops: usize,
    filters: usize,
    opacity_spans: usize,
    clip_depth: usize,
    opacity_depth: usize,
    transform_depth: usize,
    target_count: u32,
    shader_count: u32,
}

impl RenderList {
    pub fn new() -> Self {
        Self::default()
    }

    pub fn clear(&mut self) {
        self.items.clear();
        self.clip_stack.clear();
        self.opacity_stack.clear();
        self.opacity_spans.clear();
        self.transform_stack.clear();
        self.item_clips.clear();
        self.item_transforms.clear();
        self.backdrops.clear();
        self.filters.clear();
        self.next_target = 0;
        self.target_count = 0;
        self.shader_count = 0;
    }

    pub fn push_opacity(&mut self, opacity: f32) {
        let o = if opacity.is_finite() {
            opacity.clamp(0.0, 1.0)
        } else {
            1.0
        };
        self.opacity_stack.push(OpacityEntry {
            opacity: o,
            start: self.items.len(),
            depth: self.opacity_stack.len(),
        });
    }

    fn close_opacity(&mut self) {
        let Some(entry) = self.opacity_stack.pop() else {
            return;
        };
        if entry.opacity < 1.0 - f32::EPSILON && entry.start < self.items.len() {
            self.opacity_spans.push(OpacitySpan {
                start: entry.start,
                end: self.items.len(),
                opacity: entry.opacity,
                depth: entry.depth,
            });
        }
    }

    pub fn pop_opacity(&mut self) {
        self.close_opacity();
    }

    pub fn opacity_depth(&self) -> usize {
        self.opacity_stack.len()
    }

    pub fn truncate_opacity(&mut self, depth: usize) {
        while self.opacity_stack.len() > depth {
            self.close_opacity();
        }
    }

    pub fn active_opacity(&self) -> f32 {
        self.opacity_stack
            .iter()
            .map(|e| e.opacity)
            .fold(1.0, |a, b| a * b)
    }

    fn opacity_visible(&self) -> bool {
        self.active_opacity() > 0.0
    }

    pub fn opacity_spans(&self) -> &[OpacitySpan] {
        &self.opacity_spans
    }

    pub fn has_opacity_groups(&self) -> bool {
        !self.opacity_spans.is_empty()
    }

    /// Returns the product of all group opacities covering `index`.
    ///
    /// Includes groups that are still open, so it is usable while painting.
    pub fn opacity_at(&self, index: usize) -> f32 {
        let mut opacity = self
            .opacity_spans
            .iter()
            .filter(|span| span.start <= index && index < span.end)
            .map(|span| span.opacity)
            .fold(1.0, |a, b| a * b);
        for entry in &self.opacity_stack {
            if entry.start <= index {
                opacity *= entry.opacity;
            }
        }
        opacity
    }

    /// Builds a nested plan of item segments and opacity groups.
    ///
    /// Spans are emitted when a group closes, so they arrive inner-first.
    /// Sorting by range and stack depth reconstructs the original nesting.
    pub fn opacity_plan(&self) -> Vec<OpacityNode> {
        let mut spans: Vec<&OpacitySpan> = self.opacity_spans.iter().collect();
        spans.sort_by(|a, b| {
            a.start
                .cmp(&b.start)
                .then_with(|| b.end.cmp(&a.end))
                .then_with(|| a.depth.cmp(&b.depth))
        });
        let (nodes, _) = build_opacity_nodes(&spans, 0, 0, self.items.len());
        nodes
    }

    /// Returns `true` when the list contains any offscreen target pass.
    pub fn has_targets(&self) -> bool {
        self.target_count > 0
    }

    /// Returns `true` when the list contains any custom-shader draw.
    pub fn has_shaders(&self) -> bool {
        self.shader_count > 0
    }

    /// Builds the execution plan for offscreen targets.
    ///
    /// Target passes are emitted when they close, so a target that feeds another
    /// target appears earlier in the plan than its consumer. Everything painted
    /// outside a target - including [`RenderItem::Blit`] items, which stay in the
    /// pass that contains them so painting order is preserved - becomes a
    /// [`PassNode::Present`] segment. Segments and passes cover the whole list in
    /// wiring order.
    ///
    /// Nested targets are not supported: an inner target is still emitted as its
    /// own pass, but its items also stay inside the enclosing target's range.
    pub fn target_plan(&self) -> Vec<PassNode> {
        let mut nodes = Vec::new();
        let mut open: Vec<(RenderTargetId, Size, BlendMode, usize)> = Vec::new();
        let mut segment = 0usize;
        for (index, item) in self.items.iter().enumerate() {
            match item {
                RenderItem::TargetBegin { id, size, blend } => {
                    if open.is_empty() && segment < index {
                        nodes.push(PassNode::Present {
                            items: segment..index,
                        });
                    }
                    open.push((*id, *size, *blend, index + 1));
                }
                RenderItem::TargetEnd { id } => {
                    let Some(position) = open.iter().rposition(|(open_id, ..)| open_id == id)
                    else {
                        continue;
                    };
                    let (target, size, blend, start) = open.remove(position);
                    if start <= index {
                        nodes.push(PassNode::Render {
                            target,
                            size,
                            blend,
                            items: start..index,
                        });
                    }
                    if open.is_empty() {
                        segment = index + 1;
                    }
                }
                _ => {}
            }
        }
        if segment < self.items.len() {
            nodes.push(PassNode::Present {
                items: segment..self.items.len(),
            });
        }
        nodes
    }

    pub fn push_transform(&mut self, t: Transform) {
        let active = self.active_transform().then(t);
        self.transform_stack.push(active);
    }

    pub fn pop_transform(&mut self) {
        self.transform_stack.pop();
    }

    pub fn transform_depth(&self) -> usize {
        self.transform_stack.len()
    }

    pub fn truncate_transforms(&mut self, depth: usize) {
        while self.transform_stack.len() > depth {
            self.transform_stack.pop();
        }
    }

    pub fn active_transform(&self) -> Transform {
        self.transform_stack.last().copied().unwrap_or_default()
    }

    pub fn item_transform(&self, index: usize) -> Transform {
        self.item_transforms.get(index).copied().unwrap_or_default()
    }

    pub fn item_transforms(&self) -> &[Transform] {
        &self.item_transforms
    }

    pub fn push_clip(&mut self, rect: Rect) {
        self.clip_stack.push(ClipEntry {
            clip: RoundedClip::new(rect, 0.0),
            under: self.active_transform(),
        });
    }

    pub fn push_rounded_clip(&mut self, rect: Rect, radius: f32) {
        self.clip_stack.push(ClipEntry {
            clip: RoundedClip::new(rect, radius),
            under: self.active_transform(),
        });
    }

    pub fn clip_depth(&self) -> usize {
        self.clip_stack.len()
    }

    pub fn active_clip(&self) -> Option<Rect> {
        let mut acc: Option<Rect> = None;
        for c in &self.clip_stack {
            acc = Some(match acc {
                Some(a) => a.intersect(c.clip.rect),
                None => c.clip.rect,
            });
        }
        acc
    }

    pub fn active_clip_for(&self, t_item: Transform) -> Option<Rect> {
        if self.clip_stack.is_empty() {
            return None;
        }
        let inv = t_item.inverse()?;
        let mut acc: Option<Rect> = None;
        for c in &self.clip_stack {
            let mapped = c.under.then(inv).apply_rect_aabb(c.clip.rect);
            acc = Some(match acc {
                Some(a) => a.intersect(mapped),
                None => mapped,
            });
        }
        acc
    }

    pub fn active_rounded_clip(&self) -> Option<RoundedClip> {
        self.clip_stack
            .iter()
            .rev()
            .find(|c| c.clip.is_rounded())
            .map(|c| c.clip)
    }

    pub fn item_rounded_clip(&self, index: usize) -> Option<RoundedClip> {
        self.item_clips.get(index).copied().flatten()
    }

    pub fn truncate_clips(&mut self, depth: usize) {
        while self.clip_stack.len() > depth {
            self.clip_stack.pop();
        }
    }

    pub fn pop_clip(&mut self) {
        self.clip_stack.pop();
    }

    fn clip_rect(&self, mut r: Rect) -> Option<Rect> {
        for c in &self.clip_stack {
            r = r.intersect(c.clip.rect);
            if r.is_empty() {
                return None;
            }
        }
        Some(r)
    }

    pub fn push_quad(&mut self, rect: Rect, color: Color, radius: f32) {
        self.push_bordered_quad(rect, color, radius, 0.0, Color::TRANSPARENT);
    }

    pub fn push_bordered_quad(
        &mut self,
        rect: Rect,
        color: Color,
        radius: f32,
        border_width: f32,
        border_color: Color,
    ) {
        if !self.opacity_visible() {
            return;
        }
        let t = self.active_transform();

        if !t.is_identity() {
            if let Some(local) = self.active_clip_for(t)
                && !rect.intersects(local)
            {
                return;
            }
            let has_border = border_width > 0.0 && border_color.a > 0.0;
            if rect.is_empty() || (color.a <= 0.0 && !has_border) {
                return;
            }
            let rounded = self.active_rounded_clip();
            self.items.push(RenderItem::Quad(Quad {
                rect,
                color,
                radius,
                border_color,
                border_width: if has_border { border_width } else { 0.0 },
            }));
            self.item_clips.push(rounded);
            self.item_transforms.push(t);
            return;
        }
        let has_border = border_width > 0.0 && border_color.a > 0.0;
        // Cropping the quad to the clip rect saves fill for plain boxes, but it
        // also moves the geometry: the radius and the border are derived from
        // `rect`, so a rounded or bordered quad would draw its corners and edge
        // along the clip boundary instead of being cut off by it. Only crop
        // when that cannot change pixels.
        let plain = radius <= 0.0 && !has_border;
        let rect = if plain {
            match self.clip_rect(rect) {
                Some(cropped) => cropped,
                None => return,
            }
        } else {
            if let Some(clip) = self.active_clip()
                && !rect.intersects(clip)
            {
                return;
            }
            rect
        };
        if rect.is_empty() || (color.a <= 0.0 && !has_border) {
            return;
        }
        // Plain fills were cropped above, so the shader needs no clip for them.
        // Rounded or bordered quads keep their real geometry instead and carry
        // the clip as item state, so corners and edges are cut off by the clip
        // rather than redrawn along it.
        let rounded = if plain {
            self.active_rounded_clip()
        } else {
            self.active_clip().map(|clip| {
                let radius = self.active_rounded_clip().map(|c| c.radius).unwrap_or(0.0);
                RoundedClip::new(clip, radius)
            })
        };
        self.items.push(RenderItem::Quad(Quad {
            rect,
            color,
            radius,
            border_color,
            border_width: if has_border { border_width } else { 0.0 },
        }));
        self.item_clips.push(rounded);
        self.item_transforms.push(t);
    }

    pub fn push_shadow(&mut self, shadow: Shadow) {
        if !self.opacity_visible() {
            return;
        }
        let t = self.active_transform();
        if !shadow.is_visible() {
            return;
        }
        if !t.is_identity() {
            if let Some(local) = self.active_clip_for(t)
                && !shadow.bounds().intersects(local)
            {
                return;
            }
            let radius = self.active_rounded_clip().map(|c| c.radius).unwrap_or(0.0);
            let clip = self
                .active_clip()
                .map(|clip_rect| RoundedClip::new(clip_rect, radius));
            self.items.push(RenderItem::Shadow(shadow));
            self.item_clips.push(clip);
            self.item_transforms.push(t);
            return;
        }
        let Some(clip_rect) = self.active_clip() else {
            self.items.push(RenderItem::Shadow(shadow));
            self.item_clips.push(None);
            self.item_transforms.push(t);
            return;
        };
        if clip_rect.is_empty() {
            return;
        }

        if !shadow.bounds().intersects(clip_rect) {
            return;
        }

        let radius = self.active_rounded_clip().map(|c| c.radius).unwrap_or(0.0);
        self.items.push(RenderItem::Shadow(shadow));
        self.item_clips
            .push(Some(RoundedClip::new(clip_rect, radius)));
        self.item_transforms.push(self.active_transform());
    }

    pub fn push_text(&mut self, mut draw: TextDraw) {
        if !self.opacity_visible() {
            return;
        }
        let t = self.active_transform();
        if draw.color.a <= 0.0 {
            return;
        }
        if !t.is_identity() {
            if let Some(local) = self.active_clip_for(t) {
                let keep = draw.glyphs.iter().any(|g| g.rect.intersects(local));
                if !keep {
                    return;
                }
            }
            draw.glyphs.retain(|g| !g.rect.is_empty());
            if !draw.glyphs.is_empty() {
                let rounded = self.active_rounded_clip();
                self.items.push(RenderItem::Text(draw));
                self.item_clips.push(rounded);
                self.item_transforms.push(t);
            }
            return;
        }
        draw.glyphs.retain_mut(|g| {
            let Some(cr) = self.clip_rect(g.rect) else {
                return false;
            };
            g.uv = clip_uv(g.rect, g.uv, cr);
            g.rect = cr;
            true
        });
        if !draw.glyphs.is_empty() {
            let rounded = self.active_rounded_clip();
            self.items.push(RenderItem::Text(draw));
            self.item_clips.push(rounded);
            self.item_transforms.push(t);
        }
    }

    pub fn push_image(&mut self, rect: Rect, uv: [f32; 4], source: ImageSource) {
        self.push_image_sampled(rect, uv, source, ImageSampling::Linear);
    }

    pub fn push_image_sampled(
        &mut self,
        rect: Rect,
        uv: [f32; 4],
        source: ImageSource,
        sampling: ImageSampling,
    ) {
        if !self.opacity_visible() {
            return;
        }
        let t = self.active_transform();
        if !t.is_identity() {
            if let Some(local) = self.active_clip_for(t)
                && !rect.intersects(local)
            {
                return;
            }
            if rect.is_empty() {
                return;
            }
            let rounded = self.active_rounded_clip();
            self.items.push(RenderItem::Image(ImageDraw {
                rect,
                uv,
                source,
                sampling,
            }));
            self.item_clips.push(rounded);
            self.item_transforms.push(t);
            return;
        }
        let Some(cr) = self.clip_rect(rect) else {
            return;
        };
        if cr.is_empty() {
            return;
        }
        let uv = clip_uv(rect, uv, cr);
        let rounded = self.active_rounded_clip();
        self.items.push(RenderItem::Image(ImageDraw {
            rect: cr,
            uv,
            source,
            sampling,
        }));
        self.item_clips.push(rounded);
        self.item_transforms.push(self.active_transform());
    }

    pub fn push_waveform(&mut self, bars: &[Rect], color: Color) {
        if !self.opacity_visible() {
            return;
        }
        let t = self.active_transform();
        if bars.is_empty() || color.a <= 0.0 {
            return;
        }
        if !t.is_identity() {
            if let Some(local) = self.active_clip_for(t) {
                let keep = bars.iter().any(|r| !r.is_empty() && r.intersects(local));
                if !keep {
                    return;
                }
            }
            let clipped: Vec<Rect> = bars
                .iter()
                .copied()
                .filter(|r| !r.is_empty())
                .take(MAX_WAVEFORM_BARS)
                .collect();
            if clipped.is_empty() {
                return;
            }
            let rounded = self.active_rounded_clip();
            self.items.push(RenderItem::Waveform(WaveformDraw {
                bars: clipped,
                color,
            }));
            self.item_clips.push(rounded);
            self.item_transforms.push(t);
            return;
        }
        let clipped: Vec<Rect> = match self.active_clip() {
            None => bars
                .iter()
                .copied()
                .filter(|r| !r.is_empty())
                .take(MAX_WAVEFORM_BARS)
                .collect(),
            Some(clip) if clip.is_empty() => return,
            Some(clip) => bars
                .iter()
                .filter_map(|r| {
                    let c = r.intersect(clip);
                    if c.is_empty() { None } else { Some(c) }
                })
                .take(MAX_WAVEFORM_BARS)
                .collect(),
        };
        if clipped.is_empty() {
            return;
        }
        let rounded = self.active_rounded_clip();
        self.items.push(RenderItem::Waveform(WaveformDraw {
            bars: clipped,
            color,
        }));
        self.item_clips.push(rounded);
        self.item_transforms.push(self.active_transform());
    }

    pub fn items(&self) -> &[RenderItem] {
        &self.items
    }

    /// Pushes a custom-shader rectangle.
    ///
    /// The draw's uniform payload is truncated to [`MAX_SHADER_UNIFORM_BYTES`].
    /// Duplicate texture bindings keep the last source for each index.
    pub fn push_shader(&mut self, mut draw: ShaderDraw) {
        if !self.opacity_visible() || draw.rect.is_empty() {
            return;
        }
        draw.opacity = if draw.opacity.is_finite() {
            draw.opacity.clamp(0.0, 1.0)
        } else {
            0.0
        };
        if draw.opacity <= 0.0 {
            return;
        }
        if draw.uniforms.len() > MAX_SHADER_UNIFORM_BYTES {
            draw.uniforms = Arc::from(&draw.uniforms[..MAX_SHADER_UNIFORM_BYTES]);
        }
        if !draw.textures.is_empty() {
            let mut textures = draw.textures.to_vec();
            textures.sort_by_key(|(binding, _)| *binding);
            let mut deduped: Vec<(u32, TexInput)> = Vec::with_capacity(textures.len());
            for pair in textures {
                if let Some(last) = deduped.last_mut()
                    && last.0 == pair.0
                {
                    *last = pair;
                } else {
                    deduped.push(pair);
                }
            }
            draw.textures = Arc::from(deduped);
        }
        let t = self.active_transform();
        if let Some(local) = self.active_clip_for(t)
            && !draw.rect.intersects(local)
        {
            return;
        }
        let rounded = self.active_rounded_clip();
        self.items.push(RenderItem::Shader(draw));
        self.item_clips.push(rounded);
        self.item_transforms.push(t);
        self.shader_count += 1;
    }

    /// Pushes a copy of an offscreen target into the current target.
    pub fn push_blit(
        &mut self,
        rect: Rect,
        uv: [f32; 4],
        target: RenderTargetId,
        blend: BlendMode,
    ) {
        if !self.opacity_visible() || rect.is_empty() {
            return;
        }
        let t = self.active_transform();
        let (rect, uv) = if t.is_identity() {
            let Some(cropped) = self.clip_rect(rect) else {
                return;
            };
            if cropped.is_empty() {
                return;
            }
            let uv = clip_uv(rect, uv, cropped);
            (cropped, uv)
        } else {
            if let Some(local) = self.active_clip_for(t)
                && !rect.intersects(local)
            {
                return;
            }
            (rect, uv)
        };
        let rounded = self.active_rounded_clip();
        self.items.push(RenderItem::Blit {
            rect,
            uv,
            target,
            blend,
        });
        self.item_clips.push(rounded);
        self.item_transforms.push(t);
    }

    /// Starts an offscreen pass and returns its handle.
    ///
    /// Rendering into targets is not implemented yet; the renderer records the
    /// marker and warns during a frame. The handle can be referenced by
    /// [`TexInput::Target`] in later stages.
    #[must_use]
    pub fn begin_target(&mut self, size: Size, blend: BlendMode) -> RenderTargetId {
        let id = RenderTargetId::new(self.next_target);
        self.next_target += 1;
        self.items.push(RenderItem::TargetBegin { id, size, blend });
        self.item_clips.push(None);
        self.item_transforms.push(Transform::default());
        self.target_count += 1;
        id
    }

    /// Ends an offscreen pass started with [`RenderList::begin_target`].
    ///
    /// The marker is recorded but ignored by the stage 1 renderer.
    pub fn end_target(&mut self, id: RenderTargetId) {
        self.items.push(RenderItem::TargetEnd { id });
        self.item_clips.push(None);
        self.item_transforms.push(Transform::default());
    }

    /// Iterates over custom shader draws in recording order.
    pub fn shaders(&self) -> impl Iterator<Item = &ShaderDraw> {
        self.items.iter().filter_map(|i| match i {
            RenderItem::Shader(s) => Some(s),
            _ => None,
        })
    }

    pub fn push_gradient(
        &mut self,
        rect: Rect,
        radius: f32,
        kind: crate::brush::GradientKind,
        stops: crate::brush::GradientStops,
    ) {
        if !self.opacity_visible() {
            return;
        }
        if rect.is_empty() || stops.is_empty() {
            return;
        }
        let t = self.active_transform();

        if !t.is_identity() {
            if let Some(local) = self.active_clip_for(t)
                && !rect.intersects(local)
            {
                return;
            }
        } else {
            let Some(clipped) = self.clip_rect(rect) else {
                return;
            };
            if clipped.is_empty() {
                return;
            }

            return self.push_gradient_inner(clipped, radius, kind, stops, t);
        }
        self.push_gradient_inner(rect, radius, kind, stops, t)
    }

    fn push_gradient_inner(
        &mut self,
        rect: Rect,
        radius: f32,
        kind: crate::brush::GradientKind,
        stops: crate::brush::GradientStops,
        t: Transform,
    ) {
        if rect.is_empty() || stops.is_empty() {
            return;
        }

        if stops.stops().iter().all(|s| s.color.a <= 0.0) {
            return;
        }
        let radius = if radius.is_finite() {
            radius
                .clamp(0.0, rect.size.width.min(rect.size.height) * 0.5)
                .max(0.0)
        } else {
            0.0
        };
        let rounded = self.active_rounded_clip();
        self.items.push(RenderItem::Gradient(GradientDraw {
            rect,
            radius,
            kind,
            stops,
        }));
        self.item_clips.push(rounded);
        self.item_transforms.push(t);
    }

    pub fn push_backdrop(
        &mut self,
        rect: Rect,
        radius: f32,
        blur: f32,
        dim: Color,
        noise: f32,
        mask: SpanMask,
    ) {
        if !self.opacity_visible() {
            return;
        }
        let blur = if blur.is_finite() { blur.max(0.0) } else { 0.0 };
        let noise = if noise.is_finite() {
            noise.clamp(0.0, 1.0)
        } else {
            0.0
        };
        let opacity = self.active_opacity();
        let dim = Color {
            a: dim.a * opacity,
            ..dim
        };
        if !(blur > 0.0 || dim.a > 0.0 || noise > 0.0) {
            return;
        }
        let Some(rect) = self.clip_rect(rect) else {
            return;
        };
        if rect.is_empty() {
            return;
        }
        let radius = if radius.is_finite() {
            radius.max(0.0)
        } else {
            0.0
        };
        let draw = BackdropDraw {
            rect,
            radius,
            blur,
            dim,
            noise: noise * opacity,
            mask,
        };
        if !draw.is_visible() {
            return;
        }
        self.backdrops.push(BackdropSpan {
            at: self.items.len(),
            draw,
            clip: self.active_rounded_clip(),
        });
    }

    pub fn backdrops(&self) -> &[BackdropSpan] {
        &self.backdrops
    }

    pub fn has_backdrops(&self) -> bool {
        !self.backdrops.is_empty()
    }

    pub fn push_filter_begin(
        &mut self,
        rect: Rect,
        radius: f32,
        blur: f32,
        mask: SpanMask,
    ) -> Option<usize> {
        if !self.opacity_visible() {
            return None;
        }
        let blur = if blur.is_finite() { blur.max(0.0) } else { 0.0 };
        if !(blur > 0.0) {
            return None;
        }
        let rect = self.clip_rect(rect)?;
        if rect.is_empty() {
            return None;
        }
        let radius = if radius.is_finite() {
            radius.max(0.0)
        } else {
            0.0
        };
        let draw = FilterDraw {
            rect,
            radius,
            blur,
            mask,
        };
        if !draw.is_visible() {
            return None;
        }
        let start = self.items.len();
        self.filters.push(FilterSpan {
            start,
            end: start,
            draw,
            clip: self.active_rounded_clip(),
        });
        Some(self.filters.len() - 1)
    }

    pub fn push_filter_end(&mut self, handle: usize) {
        let end = self.items.len();
        let Some(span) = self.filters.get_mut(handle) else {
            return;
        };
        span.end = end;
        if span.end <= span.start {
            self.filters.remove(handle);
        }
    }

    pub fn filter_spans(&self) -> &[FilterSpan] {
        &self.filters
    }

    pub fn has_filters(&self) -> bool {
        !self.filters.is_empty()
    }

    pub fn item_clips(&self) -> &[Option<RoundedClip>] {
        &self.item_clips
    }

    pub fn quads(&self) -> impl Iterator<Item = &Quad> {
        self.items.iter().filter_map(|i| match i {
            RenderItem::Quad(q) => Some(q),
            _ => None,
        })
    }

    pub fn images(&self) -> impl Iterator<Item = &ImageDraw> {
        self.items.iter().filter_map(|i| match i {
            RenderItem::Image(d) => Some(d),
            _ => None,
        })
    }

    pub fn shadows(&self) -> impl Iterator<Item = &Shadow> {
        self.items.iter().filter_map(|i| match i {
            RenderItem::Shadow(s) => Some(s),
            _ => None,
        })
    }

    pub fn waveforms(&self) -> impl Iterator<Item = &WaveformDraw> {
        self.items.iter().filter_map(|i| match i {
            RenderItem::Waveform(w) => Some(w),
            _ => None,
        })
    }

    pub fn gradients(&self) -> impl Iterator<Item = &GradientDraw> {
        self.items.iter().filter_map(|i| match i {
            RenderItem::Gradient(g) => Some(g),
            _ => None,
        })
    }

    pub fn gradient_count(&self) -> usize {
        self.items
            .iter()
            .filter(|i| matches!(i, RenderItem::Gradient(_)))
            .count()
    }

    pub fn waveform_bar_count(&self) -> usize {
        self.items
            .iter()
            .map(|i| match i {
                RenderItem::Waveform(w) => w.bars.len(),
                _ => 0,
            })
            .sum()
    }

    pub fn len(&self) -> usize {
        self.items.len()
    }

    pub fn is_empty(&self) -> bool {
        self.items.is_empty()
    }

    /// Records the current end of the list for [`RenderList::suffix`].
    pub fn mark(&self) -> RenderMark {
        RenderMark {
            items: self.items.len(),
            item_clips: self.item_clips.len(),
            item_transforms: self.item_transforms.len(),
            backdrops: self.backdrops.len(),
            filters: self.filters.len(),
            opacity_spans: self.opacity_spans.len(),
            clip_depth: self.clip_stack.len(),
            opacity_depth: self.opacity_stack.len(),
            transform_depth: self.transform_stack.len(),
            target_count: self.target_count,
            shader_count: self.shader_count,
        }
    }

    /// Captures everything added since `mark`.
    ///
    /// Backdrop, filter, and opacity spans are rebased to the start of the
    /// suffix so [`RenderList::append`] can replay them. Returns `None` if the
    /// clip/transform/opacity stacks are left open or the mark is out of
    /// bounds.
    pub fn suffix(&self, mark: RenderMark) -> Option<Self> {
        if mark.items > self.items.len()
            || mark.item_clips > self.item_clips.len()
            || mark.item_transforms > self.item_transforms.len()
            || mark.backdrops > self.backdrops.len()
            || mark.filters > self.filters.len()
            || mark.opacity_spans > self.opacity_spans.len()
            || mark.clip_depth != self.clip_stack.len()
            || mark.opacity_depth != self.opacity_stack.len()
            || mark.transform_depth != self.transform_stack.len()
        {
            return None;
        }
        let base = mark.items;
        Some(Self {
            items: self.items[mark.items..].to_vec(),
            clip_stack: Vec::new(),
            opacity_stack: Vec::new(),
            opacity_spans: self.opacity_spans[mark.opacity_spans..]
                .iter()
                .map(|span| OpacitySpan {
                    start: span.start.saturating_sub(base),
                    end: span.end.saturating_sub(base),
                    ..*span
                })
                .collect(),
            transform_stack: Vec::new(),
            item_clips: self.item_clips[mark.item_clips..].to_vec(),
            item_transforms: self.item_transforms[mark.item_transforms..].to_vec(),
            backdrops: self.backdrops[mark.backdrops..]
                .iter()
                .map(|span| BackdropSpan {
                    at: span.at.saturating_sub(base),
                    ..*span
                })
                .collect(),
            filters: self.filters[mark.filters..]
                .iter()
                .map(|span| FilterSpan {
                    start: span.start.saturating_sub(base),
                    end: span.end.saturating_sub(base),
                    ..*span
                })
                .collect(),
            next_target: self.next_target,
            target_count: self.target_count.saturating_sub(mark.target_count),
            shader_count: self.shader_count.saturating_sub(mark.shader_count),
        })
    }

    /// Appends a cached suffix produced by [`RenderList::suffix`].
    ///
    /// Parent clip/transform/opacity state is not replayed: the captured items
    /// already contain their resolved clips and transforms. Backdrop, filter,
    /// and opacity spans are shifted by the current item count.
    pub fn append(&mut self, other: &Self) {
        debug_assert!(
            other.clip_stack.is_empty()
                && other.transform_stack.is_empty()
                && other.opacity_stack.is_empty(),
            "append expects a replayable layer suffix"
        );
        let base = self.items.len();
        self.items.extend_from_slice(&other.items);
        self.item_clips.extend_from_slice(&other.item_clips);
        self.item_transforms
            .extend_from_slice(&other.item_transforms);
        self.backdrops
            .extend(other.backdrops.iter().map(|span| BackdropSpan {
                at: span.at + base,
                ..*span
            }));
        self.filters
            .extend(other.filters.iter().map(|span| FilterSpan {
                start: span.start + base,
                end: span.end + base,
                ..*span
            }));
        self.opacity_spans
            .extend(other.opacity_spans.iter().map(|span| OpacitySpan {
                start: span.start + base,
                end: span.end + base,
                ..*span
            }));
        self.target_count = self.target_count.saturating_add(other.target_count);
        self.shader_count = self.shader_count.saturating_add(other.shader_count);
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    fn tex(id: u64) -> TexInput {
        TexInput::Image(ImageSource::Rgba {
            id,
            width: 1,
            height: 1,
            data: Arc::new(vec![255; 4]),
        })
    }

    #[test]
    fn color_construction() {
        assert_eq!(Color::rgb8(255, 0, 0), Color::RED);
        assert_eq!(Color::rgb(0.0, 1.0, 0.0).a, 1.0);
        assert_eq!(Color::TRANSPARENT.a, 0.0);
    }

    #[test]
    fn hsl_roundtrips_through_rgb() {
        for (r, g, b) in [
            (255, 0, 0),
            (0, 255, 0),
            (0, 0, 255),
            (112, 143, 234),
            (185, 185, 185),
        ] {
            let c = Color::rgb8(r, g, b);
            let (h, s, l) = c.to_hsl();
            let back = Color::from_hsl(h, s, l).to_rgb8();
            assert!(
                (r as i16 - back.0 as i16).abs() <= 1
                    && (g as i16 - back.1 as i16).abs() <= 1
                    && (b as i16 - back.2 as i16).abs() <= 1,
                "#{r:02X}{g:02X}{b:02X} -> ({h:.1},{s:.3},{l:.3}) -> #{:02X}{:02X}{:02X}",
                back.0,
                back.1,
                back.2,
            );
        }
        assert_eq!(Color::from_hsl(0.0, 0.0, 0.5).to_rgb8(), (128, 128, 128));

        assert_eq!(
            Color::from_hsl(720.0, 1.0, 0.5),
            Color::from_hsl(0.0, 1.0, 0.5)
        );
        assert_eq!(Color::from_hsl(0.0, 0.5, 0.5).to_hex6(), "BF4040");
    }

    #[test]
    fn hex6_string_is_uppercase_without_hash() {
        assert_eq!(Color::rgb8(0x70, 0x8F, 0xEA).to_hex6(), "708FEA");
    }

    #[test]
    fn hex_number_forms() {
        assert_eq!(Color::hex(0x0FA4FA), Color::rgb8(15, 164, 250));
        assert_eq!(Color::hex(0xFF0000), Color::RED);
        assert_eq!(Color::hex(0x000000), Color::BLACK);

        assert_eq!(Color::hex(0x1_FF0000), Color::RED);
        let half = Color::hexa(0x0FA4FA80);
        assert_eq!(half.r, Color::hex(0x0FA4FA).r);
        assert_eq!(half.a, 128.0 / 255.0);
        assert_eq!(Color::hexa(0xFFFFFFFF).a, 1.0);
    }

    #[test]
    fn parse_hex_forms() {
        assert_eq!(Color::parse_hex("#0FA4FA"), Some(Color::rgb8(15, 164, 250)));
        assert_eq!(Color::parse_hex("0fa4fa"), Some(Color::rgb8(15, 164, 250)));
        assert_eq!(
            Color::parse_hex("0x0FA4FA"),
            Some(Color::rgb8(15, 164, 250))
        );
        assert_eq!(Color::parse_hex("#fff"), Some(Color::WHITE));
        assert_eq!(Color::parse_hex("#0000"), Some(Color::TRANSPARENT));
        assert_eq!(Color::parse_hex("#0FA4FA80"), Some(Color::hexa(0x0FA4FA80)));

        assert_eq!(Color::parse_hex("#0af"), Color::parse_hex("#00aaff"));
    }

    #[test]
    fn parse_hex_rejects_garbage() {
        assert_eq!(Color::parse_hex(""), None);
        assert_eq!(Color::parse_hex("#"), None);
        assert_eq!(Color::parse_hex("bogus"), None);
        assert_eq!(Color::parse_hex("#12"), None);
        assert_eq!(Color::parse_hex("#12345"), None);
        assert_eq!(Color::parse_hex("#123456789"), None);
        assert_eq!(Color::parse_hex("#gggggg"), None);
        assert_eq!(Color::parse_hex("  #fff"), None, "no trimming");
    }

    #[test]
    fn clip_balance_helpers() {
        let mut list = RenderList::new();
        assert_eq!(list.clip_depth(), 0);
        list.push_clip(Rect::from_xywh(0.0, 0.0, 10.0, 10.0));
        list.push_clip(Rect::from_xywh(0.0, 0.0, 5.0, 5.0));
        assert_eq!(list.clip_depth(), 2);
        list.truncate_clips(1);
        assert_eq!(list.clip_depth(), 1);
        list.truncate_clips(0);
        assert_eq!(list.clip_depth(), 0);
    }

    #[test]
    fn opacity_stack_tracks_group_alpha() {
        let mut list = RenderList::new();
        assert_eq!(list.active_opacity(), 1.0);
        list.push_opacity(0.5);
        list.push_opacity(0.5);
        assert_eq!(list.active_opacity(), 0.25, "nestings multiply");
        list.push_quad(Rect::from_xywh(0.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        let q = list.quads().next().expect("quad po push");
        assert_eq!(q.color.a, 1.0, "items keep their own alpha");
        assert!((list.opacity_at(0) - 0.25).abs() < 1e-6);
        list.pop_opacity();
        list.push_quad(Rect::from_xywh(20.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        assert_eq!(list.opacity_at(1), 0.5);

        list.push_opacity(0.0);
        list.push_quad(Rect::from_xywh(40.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        assert_eq!(list.quads().count(), 2, "quad przy opacity 0 nie wchodzi");
        list.truncate_opacity(0);
        assert_eq!(list.opacity_depth(), 0);
        assert_eq!(list.active_opacity(), 1.0);
        assert_eq!(list.opacity_spans().len(), 2, "outer and inner span");
        assert_eq!(list.opacity_at(0), 0.25);
        assert_eq!(list.opacity_at(1), 0.5);
        assert_eq!(list.opacity_at(2), 1.0, "poza grupami");

        list.push_opacity(f32::NAN);
        list.push_quad(Rect::from_xywh(60.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        let qs: Vec<_> = list.quads().collect();
        assert_eq!(qs[2].color.a, 1.0);
        assert_eq!(list.opacity_at(2), 1.0);
        list.clear();
        assert_eq!(list.opacity_depth(), 0, "clear also resets opacity");
        assert!(list.opacity_spans().is_empty());
    }

    #[test]
    fn render_list_suffix_and_append_replay_items() {
        let mut list = RenderList::new();
        list.push_quad(Rect::from_xywh(0.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        let mark = list.mark();
        list.push_clip(Rect::from_xywh(0.0, 0.0, 20.0, 20.0));
        list.push_quad(Rect::from_xywh(5.0, 5.0, 10.0, 10.0), Color::GREEN, 2.0);
        list.pop_clip();

        let suffix = list.suffix(mark).expect("plain items are replayable");
        assert_eq!(suffix.len(), 1);
        assert_eq!(suffix.item_clips().len(), 1);
        assert_eq!(suffix.item_transforms().len(), 1);

        let mut out = RenderList::new();
        out.append(&suffix);
        assert_eq!(out.len(), 1);
        assert_eq!(out.item_clips().len(), 1);
        assert_eq!(out.item_transforms().len(), 1);
        assert_eq!(
            out.quads().next().unwrap().rect,
            suffix.quads().next().unwrap().rect
        );
    }

    #[test]
    fn render_list_suffix_rebases_composited_spans() {
        let mut list = RenderList::new();
        list.push_quad(Rect::from_xywh(0.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        let mark = list.mark();

        list.push_backdrop(
            Rect::from_xywh(0.0, 0.0, 10.0, 10.0),
            0.0,
            4.0,
            Color::BLACK,
            0.0,
            SpanMask::None,
        );
        let filter = list
            .push_filter_begin(
                Rect::from_xywh(0.0, 0.0, 10.0, 10.0),
                0.0,
                4.0,
                SpanMask::None,
            )
            .expect("visible filter opens a span");
        list.push_opacity(0.5);
        list.push_quad(Rect::from_xywh(0.0, 0.0, 10.0, 10.0), Color::GREEN, 0.0);
        list.pop_opacity();
        list.push_filter_end(filter);

        let suffix = list.suffix(mark).expect("closed spans are replayable");
        assert_eq!(suffix.backdrops().len(), 1);
        assert_eq!(suffix.backdrops()[0].at, 0, "backdrop rebased to suffix");
        assert_eq!(suffix.filter_spans().len(), 1);
        assert_eq!(
            (suffix.filter_spans()[0].start, suffix.filter_spans()[0].end),
            (0, 1)
        );
        assert_eq!(suffix.opacity_spans().len(), 1);
        assert_eq!(
            (
                suffix.opacity_spans()[0].start,
                suffix.opacity_spans()[0].end
            ),
            (0, 1)
        );

        let mut out = RenderList::new();
        out.push_quad(Rect::from_xywh(0.0, 0.0, 1.0, 1.0), Color::BLUE, 0.0);
        out.push_quad(Rect::from_xywh(0.0, 0.0, 1.0, 1.0), Color::BLUE, 0.0);
        out.append(&suffix);
        assert_eq!(out.backdrops()[0].at, 2);
        assert_eq!(out.filter_spans()[0].start, 2);
        assert_eq!(out.filter_spans()[0].end, 3);
        assert_eq!(out.opacity_spans()[0].start, 2);
        assert_eq!(out.opacity_spans()[0].end, 3);
    }

    #[test]
    fn render_list_suffix_rejects_open_groups() {
        let mut list = RenderList::new();
        let mark = list.mark();
        list.push_opacity(0.5);
        list.push_quad(Rect::from_xywh(0.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        assert!(
            list.suffix(mark).is_none(),
            "an open opacity group cannot be replayed"
        );
        list.pop_opacity();

        let mark = list.mark();
        list.push_clip(Rect::from_xywh(0.0, 0.0, 10.0, 10.0));
        list.push_quad(Rect::from_xywh(0.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        assert!(
            list.suffix(mark).is_none(),
            "an open clip cannot be replayed"
        );
    }

    #[test]
    fn opacity_plan_nests_groups_and_merges_segments() {
        let mut list = RenderList::new();
        list.push_quad(Rect::from_xywh(0.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        list.push_opacity(0.5);
        list.push_quad(Rect::from_xywh(10.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        list.push_opacity(0.5);
        list.push_quad(Rect::from_xywh(20.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        list.pop_opacity();
        list.push_quad(Rect::from_xywh(30.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        list.pop_opacity();
        list.push_quad(Rect::from_xywh(40.0, 0.0, 10.0, 10.0), Color::RED, 0.0);

        assert_eq!(list.opacity_at(0), 1.0);
        assert_eq!(list.opacity_at(1), 0.5);
        assert_eq!(list.opacity_at(2), 0.25);
        assert_eq!(list.opacity_at(3), 0.5);
        assert_eq!(list.opacity_at(4), 1.0);

        let plan = list.opacity_plan();
        assert_eq!(plan.len(), 3);
        assert_eq!(plan[0], OpacityNode::Segment { start: 0, end: 1 });
        assert_eq!(plan[2], OpacityNode::Segment { start: 4, end: 5 });
        let OpacityNode::Group { opacity, children } = &plan[1] else {
            panic!("expected outer group, got {:?}", plan[1]);
        };
        assert_eq!(*opacity, 0.5);
        assert_eq!(children.len(), 3);
        assert_eq!(children[0], OpacityNode::Segment { start: 1, end: 2 });
        assert_eq!(
            children[1],
            OpacityNode::Group {
                opacity: 0.5,
                children: vec![OpacityNode::Segment { start: 2, end: 3 }],
            }
        );
        assert_eq!(children[2], OpacityNode::Segment { start: 3, end: 4 });
    }

    #[test]
    fn list_push_and_clear() {
        let mut list = RenderList::new();
        assert!(list.is_empty());
        list.push_quad(Rect::from_xywh(0.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        assert_eq!(list.len(), 1);
        list.push_quad(Rect::ZERO, Color::RED, 0.0);
        list.push_quad(
            Rect::from_xywh(0.0, 0.0, 10.0, 10.0),
            Color::TRANSPARENT,
            0.0,
        );
        assert_eq!(list.len(), 1, "empty-value filters");

        list.push_text(TextDraw::default());
        assert_eq!(list.len(), 1, "empty TextDraw skipped");

        list.push_text(TextDraw {
            color: Color::WHITE,
            glyphs: vec![GlyphQuad {
                rect: Rect::ZERO,
                uv: [0.0; 4],
                color_glyph: false,
            }],
        });
        assert_eq!(list.len(), 2);
        assert_eq!(list.quads().count(), 1);

        list.clear();
        assert!(list.is_empty());
    }

    #[test]
    fn bordered_quad_filters_and_flags() {
        let r = Rect::from_xywh(0.0, 0.0, 100.0, 60.0);
        let mut list = RenderList::new();

        list.push_quad(r, Color::BLUE, 8.0);
        let q = list.quads().next().unwrap();
        assert!(!q.has_border());
        assert_eq!(q.border_width, 0.0);

        let bg = Color::rgba(154.0 / 255.0, 214.0 / 255.0, 248.0 / 255.0, 24.0 / 255.0);
        list.push_bordered_quad(r, bg, 8.0, 1.0, Color::RED);
        let qs: Vec<_> = list.quads().collect();
        assert_eq!(qs.len(), 2, "background + border is one quad, not two");
        assert_eq!(qs[1].color, bg);
        assert_eq!(qs[1].border_color, Color::RED);
        assert_eq!(qs[1].border_width, 1.0);
        assert!(qs[1].has_border());

        let mut list = RenderList::new();
        list.push_bordered_quad(r, Color::TRANSPARENT, 8.0, 2.0, Color::GREEN);
        assert_eq!(list.len(), 1);

        let mut list = RenderList::new();
        list.push_bordered_quad(r, Color::TRANSPARENT, 0.0, 0.0, Color::RED);
        list.push_bordered_quad(r, Color::TRANSPARENT, 0.0, 2.0, Color::TRANSPARENT);
        list.push_bordered_quad(Rect::ZERO, Color::RED, 0.0, 1.0, Color::RED);
        assert!(list.is_empty());
    }

    #[test]
    fn clip_intersects_and_filters() {
        let mut list = RenderList::new();
        list.push_clip(Rect::from_xywh(0.0, 0.0, 100.0, 100.0));
        list.push_quad(Rect::from_xywh(50.0, 50.0, 100.0, 100.0), Color::RED, 0.0);
        list.push_quad(Rect::from_xywh(200.0, 200.0, 10.0, 10.0), Color::RED, 0.0);
        assert_eq!(list.len(), 1);
        let q = list.quads().next().unwrap();
        assert_eq!(q.rect, Rect::from_xywh(50.0, 50.0, 50.0, 50.0));

        list.pop_clip();
        list.push_quad(Rect::from_xywh(200.0, 200.0, 10.0, 10.0), Color::RED, 0.0);
        assert_eq!(list.len(), 2, "unclipped after pop_clip");
    }

    #[test]
    fn clipped_rounded_quad_keeps_its_geometry() {
        let clip = Rect::from_xywh(0.0, 0.0, 100.0, 100.0);
        let object = Rect::from_xywh(60.0, 20.0, 100.0, 80.0);

        let mut list = RenderList::new();
        list.push_clip(clip);
        list.push_bordered_quad(object, Color::RED, 12.0, 2.0, Color::WHITE);
        assert_eq!(list.len(), 1);
        let q = list.quads().next().unwrap();
        assert_eq!(
            q.rect, object,
            "rounded geometry is cut by the clip, not resized to it"
        );
        assert_eq!(q.radius, 12.0, "corner radius survives the clip");
        assert_eq!(q.border_width, 2.0, "border stays on the real edge");
        let item_clip = list
            .item_rounded_clip(0)
            .expect("clip stored for the shader");
        assert_eq!(item_clip.rect, clip);

        let mut outside = RenderList::new();
        outside.push_clip(clip);
        outside.push_bordered_quad(
            Rect::from_xywh(200.0, 200.0, 50.0, 50.0),
            Color::RED,
            8.0,
            1.0,
            Color::WHITE,
        );
        assert!(
            outside.is_empty(),
            "rounded quad fully outside the clip is still culled"
        );

        let mut plain = RenderList::new();
        plain.push_clip(clip);
        plain.push_quad(Rect::from_xywh(50.0, 50.0, 100.0, 100.0), Color::RED, 0.0);
        assert_eq!(
            plain.quads().next().unwrap().rect,
            Rect::from_xywh(50.0, 50.0, 50.0, 50.0),
            "plain fills keep the cheap crop"
        );
    }

    #[test]
    fn nested_clip_intersects() {
        let mut list = RenderList::new();
        list.push_clip(Rect::from_xywh(0.0, 0.0, 100.0, 100.0));
        list.push_clip(Rect::from_xywh(50.0, 50.0, 100.0, 100.0));
        list.push_quad(Rect::from_xywh(0.0, 0.0, 200.0, 200.0), Color::RED, 0.0);
        assert_eq!(list.len(), 1);
        let q = list.quads().next().unwrap();
        assert_eq!(q.rect, Rect::from_xywh(50.0, 50.0, 50.0, 50.0));
    }

    #[test]
    fn rounded_clip_stored_per_item_for_shader() {
        let mut list = RenderList::new();
        let card = Rect::from_xywh(0.0, 0.0, 240.0, 280.0);
        list.push_rounded_clip(card, 8.0);
        list.push_quad(Rect::from_xywh(0.0, 0.0, 240.0, 20.0), Color::GREEN, 0.0);
        assert_eq!(list.len(), 1);
        let clip = list.item_rounded_clip(0).expect("rounded clip stored");
        assert_eq!(clip.rect, card);
        assert_eq!(clip.radius, 8.0);

        let mut list = RenderList::new();
        list.push_clip(Rect::from_xywh(0.0, 0.0, 100.0, 100.0));
        list.push_quad(Rect::from_xywh(10.0, 10.0, 20.0, 20.0), Color::RED, 0.0);
        assert_eq!(list.item_rounded_clip(0), None);
    }

    #[test]
    fn rounded_clip_survives_rectangular_child_clip() {
        let mut list = RenderList::new();
        list.push_rounded_clip(Rect::from_xywh(0.0, 0.0, 240.0, 280.0), 8.0);
        list.push_clip(Rect::from_xywh(0.0, 0.0, 240.0, 280.0));
        list.push_quad(Rect::from_xywh(0.0, 0.0, 240.0, 20.0), Color::GREEN, 0.0);
        let clip = list.item_rounded_clip(0).expect("outer rounding kept");
        assert_eq!(clip.radius, 8.0);
        list.pop_clip();
        list.pop_clip();
        list.push_quad(Rect::from_xywh(0.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        assert_eq!(list.item_rounded_clip(1), None, "no clip after pops");
    }

    fn glyph(x: f32, y: f32, w: f32, h: f32) -> GlyphQuad {
        GlyphQuad {
            rect: Rect::from_xywh(x, y, w, h),
            uv: [0.0, 0.0, 1.0, 1.0],
            color_glyph: false,
        }
    }

    fn pushed_glyphs(clip: Rect, g: GlyphQuad) -> Vec<GlyphQuad> {
        let mut list = RenderList::new();
        list.push_clip(clip);
        list.push_text(TextDraw {
            color: Color::WHITE,
            glyphs: vec![g],
        });
        match list.items() {
            [RenderItem::Text(t)] => t.glyphs.clone(),
            _ => panic!("expected a single TextDraw"),
        }
    }

    #[test]
    fn clipped_glyph_keeps_proportional_uv() {
        let out = pushed_glyphs(
            Rect::from_xywh(0.0, 0.0, 100.0, 100.0),
            glyph(90.0, 10.0, 20.0, 10.0),
        );
        assert_eq!(out.len(), 1);
        assert_eq!(out[0].rect, Rect::from_xywh(90.0, 10.0, 10.0, 10.0));
        assert_eq!(out[0].uv, [0.0, 0.0, 0.5, 1.0]);
    }

    #[test]
    fn fully_visible_glyph_keeps_uv() {
        let out = pushed_glyphs(
            Rect::from_xywh(0.0, 0.0, 100.0, 100.0),
            glyph(10.0, 10.0, 20.0, 10.0),
        );
        assert_eq!(out.len(), 1);
        assert_eq!(out[0].rect, Rect::from_xywh(10.0, 10.0, 20.0, 10.0));
        assert_eq!(out[0].uv, [0.0, 0.0, 1.0, 1.0]);
    }

    #[test]
    fn clipped_glyph_uv_scales_with_atlas_subrect() {
        let mut g = glyph(0.0, 0.0, 20.0, 20.0);
        g.uv = [0.25, 0.5, 0.75, 1.0];
        let out = pushed_glyphs(Rect::from_xywh(10.0, 0.0, 100.0, 100.0), g);
        assert_eq!(out.len(), 1);
        assert_eq!(out[0].rect, Rect::from_xywh(10.0, 0.0, 10.0, 20.0));
        assert_eq!(out[0].uv, [0.5, 0.5, 0.75, 1.0]);
    }

    fn file_image() -> ImageSource {
        ImageSource::File("foto.png".into())
    }

    #[test]
    fn image_push_clip_and_uv() {
        let mut list = RenderList::new();
        list.push_clip(Rect::from_xywh(0.0, 0.0, 100.0, 100.0));
        list.push_image(
            Rect::from_xywh(90.0, 10.0, 20.0, 10.0),
            [0.0, 0.0, 1.0, 1.0],
            file_image(),
        );
        list.push_image(
            Rect::from_xywh(200.0, 200.0, 10.0, 10.0),
            [0.0, 0.0, 1.0, 1.0],
            file_image(),
        );
        let images: Vec<_> = list.images().collect();
        assert_eq!(images.len(), 1, "outside the clip is dropped");
        assert_eq!(images[0].rect, Rect::from_xywh(90.0, 10.0, 10.0, 10.0));
        assert_eq!(
            images[0].uv,
            [0.0, 0.0, 0.5, 1.0],
            "proportional UV, as for glyphs"
        );
    }

    #[test]
    fn image_cache_keys() {
        assert_eq!(file_image().cache_key(), file_image().cache_key());
        assert_ne!(
            file_image().cache_key(),
            ImageSource::File("inne.png".into()).cache_key()
        );
        let rgba = |id| ImageSource::Rgba {
            id,
            width: 2,
            height: 2,
            data: Arc::new(vec![0u8; 16]),
        };
        assert_eq!(rgba(7).cache_key(), 7);
        assert_ne!(rgba(7).cache_key(), rgba(8).cache_key());
    }

    fn shadow_spec() -> Shadow {
        Shadow {
            rect: Rect::from_xywh(10.0, 10.0, 100.0, 60.0),
            color: Color::BLACK,
            radius: 6.0,
            blur: 8.0,
            spread: 0.0,
            offset: Vec2::new(0.0, 2.0),
            inset: false,
        }
    }

    #[test]
    fn shadow_push_allows_hard_outer_but_not_hard_inset_shadows() {
        let mut list = RenderList::new();
        list.push_shadow(Shadow {
            blur: 0.0,
            ..shadow_spec()
        });
        list.push_shadow(Shadow {
            blur: 0.0,
            inset: true,
            ..shadow_spec()
        });
        list.push_shadow(Shadow {
            blur: f32::NAN,
            ..shadow_spec()
        });
        list.push_shadow(Shadow {
            color: Color::TRANSPARENT,
            ..shadow_spec()
        });
        list.push_shadow(Shadow {
            rect: Rect::ZERO,
            ..shadow_spec()
        });
        assert_eq!(list.items().len(), 1, "only the hard outer shadow is kept");
    }

    #[test]
    fn shadow_keeps_shape_rect_and_rides_the_clip() {
        let mut list = RenderList::new();
        list.push_clip(Rect::from_xywh(0.0, 0.0, 50.0, 50.0));
        list.push_rounded_clip(Rect::from_xywh(0.0, 0.0, 200.0, 200.0), 12.0);
        list.push_shadow(shadow_spec());
        assert_eq!(list.len(), 1);
        assert_eq!(list.shadows().next().unwrap().rect, shadow_spec().rect);
        let clip = list.item_rounded_clip(0).expect("ancestor clip");
        assert_eq!(
            clip.rect,
            Rect::from_xywh(0.0, 0.0, 50.0, 50.0),
            "przeciecie stosu clipow"
        );
        assert_eq!(clip.radius, 12.0, "rounding from inner clip");
    }

    #[test]
    fn shadow_dropped_when_fully_clipped_out() {
        let mut list = RenderList::new();
        list.push_clip(Rect::from_xywh(500.0, 500.0, 10.0, 10.0));
        list.push_shadow(shadow_spec());
        assert!(list.is_empty(), "fully outside clip");
    }

    #[test]
    fn shadow_bounds_grow_with_blur_spread_and_offset() {
        let s = Shadow {
            blur: 10.0,
            spread: 4.0,
            offset: Vec2::new(2.0, -3.0),
            ..shadow_spec()
        };
        let b = s.bounds();
        assert!((b.left() - 3.0).abs() < 1e-4, "{b:?}");
        assert!((b.top() - (-2.0)).abs() < 1e-4, "{b:?}");
        assert!((b.size.width - 118.0).abs() < 1e-4, "{b:?}");
        let inset = Shadow { inset: true, ..s };
        assert_eq!(inset.bounds(), inset.rect, "inset stays inside the shape");
    }

    #[test]
    fn waveform_push_is_one_item_not_n() {
        let mut list = RenderList::new();
        let bars: Vec<Rect> = (0..100)
            .map(|i| Rect::from_xywh(i as f32 * 2.0, 0.0, 1.5, 20.0))
            .collect();
        list.push_waveform(&bars, Color::WHITE);
        assert_eq!(list.len(), 1, "whole waveform is 1 item");
        assert_eq!(list.waveform_bar_count(), 100);
        assert_eq!(list.waveforms().next().unwrap().bars.len(), 100);
    }

    #[test]
    fn waveform_push_clips_and_filters() {
        let mut list = RenderList::new();
        list.push_clip(Rect::from_xywh(0.0, 0.0, 10.0, 10.0));
        let bars = vec![
            Rect::from_xywh(0.0, 0.0, 5.0, 5.0),
            Rect::from_xywh(200.0, 200.0, 5.0, 5.0),
            Rect::ZERO,
        ];
        list.push_waveform(&bars, Color::WHITE);
        assert_eq!(list.len(), 1);
        assert_eq!(list.waveform_bar_count(), 1, "outside clip dropped");

        let mut list = RenderList::new();
        list.push_waveform(&[], Color::WHITE);
        list.push_waveform(&[Rect::from_xywh(0.0, 0.0, 5.0, 5.0)], Color::TRANSPARENT);
        assert!(list.is_empty());
    }

    #[test]
    fn dynamic_image_cache_key_is_id_and_versioned() {
        let a = ImageSource::Dynamic {
            id: 7,
            width: 4,
            height: 1,
            data: Arc::new(vec![0u8; 16]),
            version: 1,
        };
        let b = ImageSource::Dynamic {
            id: 7,
            width: 4,
            height: 1,
            data: Arc::new(vec![255u8; 16]),
            version: 2,
        };
        assert_eq!(a.cache_key(), 7);
        assert_eq!(a.cache_key(), b.cache_key(), "same texture slot");
        assert_ne!(a, b, "other version means other data");
        assert_eq!(a.dynamic_version(), Some(1));
        assert_eq!(
            ImageSource::Rgba {
                id: 7,
                width: 1,
                height: 1,
                data: Arc::new(vec![0u8; 4]),
            }
            .dynamic_version(),
            None
        );
    }

    #[test]
    fn backdrop_side_channel_keeps_item_indices() {
        let mut list = RenderList::new();
        list.push_quad(Rect::from_xywh(0.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        list.push_quad(Rect::from_xywh(10.0, 0.0, 10.0, 10.0), Color::GREEN, 0.0);
        assert!(!list.has_backdrops());
        list.push_backdrop(
            Rect::from_xywh(0.0, 0.0, 100.0, 100.0),
            8.0,
            16.0,
            Color::TRANSPARENT,
            0.0,
            SpanMask::None,
        );
        assert!(list.has_backdrops());
        assert_eq!(list.len(), 2, "marker does not add items");
        let span = list.backdrops()[0];
        assert_eq!(span.at, 2, "rozmywa dwa quady spod spodu");
        assert_eq!(span.draw.rect, Rect::from_xywh(0.0, 0.0, 100.0, 100.0));
        assert_eq!(span.draw.blur, 16.0);
        list.push_quad(Rect::from_xywh(0.0, 0.0, 5.0, 5.0), Color::BLUE, 0.0);
        assert_eq!(list.backdrops()[0].at, 2, "at frozen in push");
    }

    #[test]
    fn filter_span_covers_subtree_range() {
        let mut list = RenderList::new();
        list.push_quad(Rect::from_xywh(0.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        let h = list
            .push_filter_begin(
                Rect::from_xywh(0.0, 0.0, 100.0, 100.0),
                8.0,
                16.0,
                SpanMask::None,
            )
            .expect("widoczny filtr otwiera zakres");
        assert_eq!(list.len(), 1, "begin does not add items");
        list.push_quad(Rect::from_xywh(0.0, 0.0, 5.0, 5.0), Color::BLUE, 0.0);
        list.push_quad(Rect::from_xywh(5.0, 5.0, 5.0, 5.0), Color::GREEN, 0.0);
        list.push_filter_end(h);
        assert!(list.has_filters());
        let span = list.filter_spans()[0];
        assert_eq!((span.start, span.end), (1, 3), "tylko poddrzewo");
        assert_eq!(span.draw.blur, 16.0);
        assert_eq!(span.draw.radius, 8.0);
        list.clear();
        assert!(!list.has_filters(), "clear also drops filters");
    }

    #[test]
    fn filter_begin_rejects_invisible_and_end_drops_empty() {
        let mut list = RenderList::new();

        assert!(
            list.push_filter_begin(
                Rect::from_xywh(0.0, 0.0, 10.0, 10.0),
                0.0,
                0.0,
                SpanMask::None
            )
            .is_none()
        );
        assert!(
            list.push_filter_begin(
                Rect::from_xywh(0.0, 0.0, 10.0, 10.0),
                0.0,
                f32::NAN,
                SpanMask::None
            )
            .is_none()
        );
        assert!(
            list.push_filter_begin(
                Rect::from_xywh(0.0, 0.0, 0.0, 0.0),
                0.0,
                8.0,
                SpanMask::None
            )
            .is_none()
        );
        assert!(!list.has_filters());

        let h = list
            .push_filter_begin(
                Rect::from_xywh(0.0, 0.0, 10.0, 10.0),
                0.0,
                8.0,
                SpanMask::None,
            )
            .expect("otwiera");
        list.push_filter_end(h);
        assert!(!list.has_filters(), "pusty zakres bez contentu");

        let mut clipped = RenderList::new();
        clipped.push_clip(Rect::from_xywh(0.0, 0.0, 100.0, 100.0));
        let h = clipped
            .push_filter_begin(
                Rect::from_xywh(50.0, 50.0, 100.0, 100.0),
                4.0,
                12.0,
                SpanMask::None,
            )
            .expect("otwiera");
        clipped.push_quad(Rect::from_xywh(60.0, 60.0, 10.0, 10.0), Color::RED, 0.0);
        clipped.push_filter_end(h);
        assert_eq!(
            clipped.filter_spans()[0].draw.rect,
            Rect::from_xywh(50.0, 50.0, 50.0, 50.0)
        );
    }

    #[test]
    fn filter_spans_nest_like_subtrees() {
        let mut list = RenderList::new();
        let outer = list
            .push_filter_begin(
                Rect::from_xywh(0.0, 0.0, 100.0, 100.0),
                0.0,
                8.0,
                SpanMask::None,
            )
            .expect("outer");
        list.push_quad(Rect::from_xywh(0.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        let inner = list
            .push_filter_begin(
                Rect::from_xywh(0.0, 0.0, 50.0, 50.0),
                0.0,
                4.0,
                SpanMask::None,
            )
            .expect("inner");
        list.push_quad(Rect::from_xywh(0.0, 0.0, 5.0, 5.0), Color::BLUE, 0.0);
        list.push_filter_end(inner);
        list.push_filter_end(outer);
        assert_eq!(list.filter_spans().len(), 2);
        assert_eq!(
            (list.filter_spans()[0].start, list.filter_spans()[0].end),
            (0, 2)
        );
        assert_eq!(
            (list.filter_spans()[1].start, list.filter_spans()[1].end),
            (1, 2)
        );
    }

    #[test]
    fn backdrop_filters_and_clips() {
        let mut list = RenderList::new();

        list.push_backdrop(
            Rect::from_xywh(0.0, 0.0, 50.0, 50.0),
            0.0,
            0.0,
            Color::TRANSPARENT,
            0.0,
            SpanMask::None,
        );
        assert!(!list.has_backdrops());

        list.push_backdrop(
            Rect::from_xywh(0.0, 0.0, 50.0, 50.0),
            0.0,
            0.0,
            Color::BLACK.with_alpha(0.25),
            0.0,
            SpanMask::None,
        );
        assert_eq!(list.backdrops().len(), 1);

        let mut clipped = RenderList::new();
        clipped.push_clip(Rect::from_xywh(0.0, 0.0, 100.0, 100.0));
        clipped.push_backdrop(
            Rect::from_xywh(50.0, 50.0, 100.0, 100.0),
            4.0,
            12.0,
            Color::TRANSPARENT,
            0.0,
            SpanMask::None,
        );
        assert_eq!(
            clipped.backdrops()[0].draw.rect,
            Rect::from_xywh(50.0, 50.0, 50.0, 50.0)
        );

        let mut outside = RenderList::new();
        outside.push_clip(Rect::from_xywh(500.0, 500.0, 10.0, 10.0));
        outside.push_backdrop(
            Rect::from_xywh(0.0, 0.0, 10.0, 10.0),
            0.0,
            12.0,
            Color::TRANSPARENT,
            0.0,
            SpanMask::None,
        );
        assert!(!outside.has_backdrops());

        let mut faded = RenderList::new();
        faded.push_opacity(0.5);
        faded.push_backdrop(
            Rect::from_xywh(0.0, 0.0, 10.0, 10.0),
            0.0,
            0.0,
            Color::BLACK.with_alpha(0.4),
            0.5,
            SpanMask::None,
        );
        let d = faded.backdrops()[0].draw;
        assert!((d.dim.a - 0.2).abs() < 1e-6, "dim.a 0.4 * 0.5: {}", d.dim.a);
        assert!(
            (d.noise - 0.25).abs() < 1e-6,
            "noise 0.5 * 0.5: {}",
            d.noise
        );

        faded.clear();
        assert!(!faded.has_backdrops());
    }

    #[test]
    fn span_mask_encodes_for_gpu() {
        assert_eq!(SpanMask::None.mask_vec(), [0.0, 0.0, 0.0, 0.0]);
        assert_eq!(
            SpanMask::Linear {
                from: 1.0,
                to: 0.0,
                angle_rad: std::f32::consts::FRAC_PI_2,
            }
            .mask_vec(),
            [1.0, 1.0, 0.0, std::f32::consts::FRAC_PI_2]
        );
        assert_eq!(SpanMask::Uniform(0.5).mask_vec(), [2.0, 0.5, 0.0, 0.0]);

        assert_eq!(
            SpanMask::Linear {
                from: 2.0,
                to: -1.0,
                angle_rad: f32::NAN,
            }
            .mask_vec()[1..3],
            [1.0, 0.0]
        );
        assert!(SpanMask::None.is_none());
        assert!(!SpanMask::Uniform(0.0).is_none());
    }

    #[test]
    fn filter_span_carries_mask() {
        let mut list = RenderList::new();
        let mask = SpanMask::Linear {
            from: 1.0,
            to: 0.0,
            angle_rad: std::f32::consts::FRAC_PI_2,
        };
        let h = list
            .push_filter_begin(Rect::from_xywh(0.0, 0.0, 100.0, 100.0), 0.0, 8.0, mask)
            .expect("otwiera");
        list.push_quad(Rect::from_xywh(0.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        list.push_filter_end(h);
        assert_eq!(list.filter_spans()[0].draw.mask, mask);
        assert_eq!(
            list.filter_spans()[0].draw.mask.mask_vec(),
            [1.0, 1.0, 0.0, std::f32::consts::FRAC_PI_2]
        );
    }

    #[test]
    fn backdrop_marker_carries_mask() {
        let mut list = RenderList::new();
        list.push_quad(Rect::from_xywh(0.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        list.push_backdrop(
            Rect::from_xywh(0.0, 0.0, 100.0, 100.0),
            0.0,
            8.0,
            Color::TRANSPARENT,
            0.0,
            SpanMask::Uniform(0.5),
        );
        assert_eq!(
            list.backdrops()[0].draw.mask,
            SpanMask::Uniform(0.5),
            "mask in the marker layer"
        );
    }

    #[test]
    fn transform_stack_composes_and_snapshots() {
        use crate::geometry::Point;
        let mut list = RenderList::new();
        assert!(list.active_transform().is_identity());

        list.push_quad(Rect::from_xywh(0.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        assert!(list.item_transform(0).is_identity());

        list.push_transform(Transform::rotate_around_degrees(90.0, Point::new(5.0, 5.0)));
        list.push_quad(Rect::from_xywh(0.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        assert!(!list.item_transform(1).is_identity());
        assert_eq!(list.item_transforms().len(), list.items().len());
        list.pop_transform();
        assert!(list.active_transform().is_identity());
        list.push_quad(Rect::from_xywh(0.0, 0.0, 10.0, 10.0), Color::RED, 0.0);
        assert!(list.item_transform(2).is_identity());
    }

    #[test]
    fn transform_aabb_covers_rotation() {
        use crate::geometry::Point;
        let r = Rect::from_xywh(0.0, 0.0, 10.0, 20.0);
        let t = Transform::rotate_around_degrees(90.0, Point::new(5.0, 10.0));
        let aabb = t.apply_rect_aabb(r);
        assert!(
            (aabb.size.width - 20.0).abs() < 0.01,
            "w={}",
            aabb.size.width
        );
        assert!(
            (aabb.size.height - 10.0).abs() < 0.01,
            "h={}",
            aabb.size.height
        );
        assert!(Transform::IDENTITY.apply_rect_aabb(r) == r);
    }

    #[test]
    fn rotated_text_survives_own_self_clip() {
        let tile = Rect::from_xywh(0.0, 0.0, 60.0, 40.0);
        let mut list = RenderList::new();
        list.push_transform(Transform::rotate_around_degrees(45.0, tile.center()));
        list.push_clip(tile);
        list.push_text(TextDraw {
            color: Color::WHITE,
            glyphs: vec![GlyphQuad {
                rect: Rect::from_xywh(4.0, 4.0, 12.0, 10.0),
                uv: [0.0, 0.0, 1.0, 1.0],
                color_glyph: false,
            }],
        });
        assert_eq!(list.len(), 1, "rotated glyph in custom clip remains");
    }

    #[test]
    fn shader_draw_truncates_uniforms_and_keeps_last_binding() {
        let mut list = RenderList::new();
        let uniforms = vec![7u8; MAX_SHADER_UNIFORM_BYTES + 9];
        list.push_shader(ShaderDraw {
            rect: Rect::from_xywh(0.0, 0.0, 10.0, 10.0),
            uv: [0.0, 0.0, 1.0, 1.0],
            shader: ShaderId::new(4),
            uniforms: Arc::from(uniforms),
            textures: Arc::from(vec![(2, tex(10)), (1, tex(11)), (2, tex(12))]),
            blend: BlendMode::Normal,
            opacity: 1.0,
        });

        let draw = list.shaders().next().expect("shader draw");
        assert_eq!(draw.uniforms.len(), MAX_SHADER_UNIFORM_BYTES);
        assert_eq!(
            draw.textures.as_ref(),
            &[(1, tex(11)), (2, tex(12))],
            "duplicate bindings keep the last source"
        );
        assert_eq!(list.items().len(), 1);
        assert_eq!(list.item_clips().len(), 1);
        assert_eq!(list.item_transforms().len(), 1);
    }

    #[test]
    fn target_markers_and_blit_round_trip_through_the_list() {
        let mut list = RenderList::new();
        let target = list.begin_target(Size::new(32.0, 16.0), BlendMode::Multiply);
        list.end_target(target);
        list.push_blit(
            Rect::from_xywh(0.0, 0.0, 32.0, 16.0),
            [0.0, 0.0, 1.0, 1.0],
            target,
            BlendMode::Screen,
        );

        assert_eq!(target.get(), 0);
        assert!(matches!(
            list.items()[0],
            RenderItem::TargetBegin { id, size, blend }
                if id == target && size.width == 32.0 && blend == BlendMode::Multiply
        ));
        assert!(matches!(
            list.items()[1],
            RenderItem::TargetEnd { id } if id == target
        ));
        assert!(matches!(
            list.items()[2],
            RenderItem::Blit { target: id, blend: BlendMode::Screen, .. } if id == target
        ));
        assert_eq!(list.len(), 3);
    }

    #[test]
    fn fast_flags_track_targets_shaders_and_cached_suffixes() {
        let mut list = RenderList::new();
        assert!(!list.has_targets());
        assert!(!list.has_shaders());

        let target = list.begin_target(Size::new(32.0, 16.0), BlendMode::Normal);
        list.push_shader(ShaderDraw {
            rect: Rect::from_xywh(0.0, 0.0, 10.0, 10.0),
            uv: [0.0, 0.0, 1.0, 1.0],
            shader: ShaderId::new(1),
            uniforms: Arc::from(Vec::new()),
            textures: Arc::from(Vec::new()),
            blend: BlendMode::Normal,
            opacity: 1.0,
        });
        assert!(list.has_targets());
        assert!(list.has_shaders());

        let mark = list.mark();
        list.end_target(target);
        let suffix = list.suffix(mark).expect("suffix");
        assert!(!suffix.has_targets(), "TargetEnd adds no target");
        assert!(!suffix.has_shaders());

        let mark = list.mark();
        let _ = list.begin_target(Size::new(8.0, 8.0), BlendMode::Normal);
        let suffix = list.suffix(mark).expect("suffix");
        assert!(suffix.has_targets());
        let mut replay = RenderList::new();
        replay.append(&suffix);
        assert!(replay.has_targets());
        replay.clear();
        assert!(!replay.has_targets());
        assert!(!replay.has_shaders());
    }

    #[test]
    fn ancestor_clip_still_culls_rotated_content() {
        let tile = Rect::from_xywh(0.0, 0.0, 60.0, 40.0);
        let mut list = RenderList::new();
        list.push_clip(Rect::from_xywh(0.0, 0.0, 100.0, 100.0));
        list.push_transform(Transform::rotate_around_degrees(45.0, tile.center()));
        list.push_text(TextDraw {
            color: Color::WHITE,
            glyphs: vec![GlyphQuad {
                rect: Rect::from_xywh(4.0, 4.0, 12.0, 10.0),
                uv: [0.0, 0.0, 1.0, 1.0],
                color_glyph: false,
            }],
        });

        assert_eq!(list.len(), 1, "clip przodka nie zjada widocznego");

        let mut list2 = RenderList::new();
        list2.push_clip(Rect::from_xywh(0.0, 0.0, 100.0, 100.0));
        list2.push_transform(Transform::translate(500.0, 500.0));
        list2.push_text(TextDraw {
            color: Color::WHITE,
            glyphs: vec![GlyphQuad {
                rect: Rect::from_xywh(4.0, 4.0, 12.0, 10.0),
                uv: [0.0, 0.0, 1.0, 1.0],
                color_glyph: false,
            }],
        });
        assert_eq!(list2.len(), 0, "clip przodka obcina poza ekranem");
    }
}