@spec beam_color(variant(), float(), boolean()) :: color()

Returns the beam head color at the given animation progress.

progress is 0.0-1.0 through the animation cycle. When static_colors is true, always returns the first palette color.

@spec bloom_color(variant()) :: color()

Returns the dim outer bloom color for a variant.

@spec css_bloom_hex(variant()) :: String.t()

Returns CSS hex for the bloom color of a variant.

@spec css_glow_hex(variant()) :: String.t()

Returns CSS hex for the glow color of a variant.

@spec css_gradient_stops(variant()) :: String.t()

Returns CSS gradient stops string for the conic-gradient beam stroke.

@spec css_palette(variant()) :: [String.t()]

Returns the CSS hex palette for a variant.

@spec glow_color(variant()) :: color()

Returns the muted inner glow color for a variant.

@spec palette(variant()) :: [color()]

Returns the terminal color palette for a variant.

@spec palette_tuple(variant()) :: tuple()

Returns the palette as a tuple for O(1) elem/2 access. Use this in per-cell hot loops to avoid the O(n) cost of Enum.at(list, idx).

@spec palette_tuple_with_len(variant()) :: {tuple(), non_neg_integer()}

Returns {palette_tuple, length} for a variant in one call. Convenience for per-cell hot loops that need both the O(1)-access tuple and its size, avoiding a separate tuple_size/1 at each call site.

@spec trail_color(variant(), float()) :: color()

Returns the trail color for a cell at distance_normalized (0.0-1.0) behind the beam head.