easy-svg

Typed Rust SVG builders generated at compile time from the offline MDN reference in SVG/. Elements, attributes, permitted children, value helpers, and hover documentation update when the reference is replaced.

use easy_svg::elements::{Circle, Svg};
use easy_svg::types::Color;

let svg = Svg::new()
    .view_box((0., 0., 100., 100.))
    .add_child(Circle::new().cx(50.).cy(50.).r(40.).fill(Color::GOLD));

assert_eq!(
    svg.to_string(),
    r#"<svg viewBox="0 0 100 100"><circle cx="50" cy="50" fill="gold" r="40"/></svg>"#
);

Colors are typed: pass a named constant (Color::GOLD, Color::DARK_ORANGE, Color::CURRENT_COLOR), build one with Color::rgb(...) / Color::rgba(...) / Color::hex(...), or use Paint::NONE / Paint::url(...). A misspelled color such as "fakecolor" is a compile error rather than an invalid SVG.

Lengths are typed too: pick the unit by constructor (Length::pixels(600), Length::percent(50), Length::em(1.5), Length::unitless(10)) instead of hand-writing a unit suffix. A bare "600px" no longer compiles; use Length::raw(...) for genuinely dynamic values like calc(...).

Parents expose typed .add_child(...) and .add_children(...) methods, so an element can only contain children the spec permits. Genuinely open-ended values accept strings; Paint::raw(...), .attr(...) and .add_child_unchecked(...) are explicit escape hatches for deliberately building invalid SVGs. Use .to_string_pretty() for copy-friendly output.

To regenerate after replacing SVG/:

cargo test --all-targets