Files
craft-libs/crates/svg

Simple stylesheet compatibility subset

simple_css preserves EffectCraft's compound tag/class/id stylesheet grammar and indexed matching budget, rather than substituting the richer selector semantics of paths. Property values remain text; color precision, path-prefix behavior and geometry policy stay with the importer. Call parse for each sheet, then StyleSheet::index; discard the sheet after a parse error and reject the import when its matching-work callback refuses.

The parser/matcher and structural tests were ported from EffectCraft 60e2cbbbe3d73c0a9074c25a1a615ccfec18721c, originally by FredApps. Nested at-rule skipping and its regression test preserve NetterSilver's 10e173c0e49696ad335e3da8a069889c089b09a6; both contributors retain primary Git authorship for their respective port commits. Source and destination use MIT OR Apache-2.0. The shared adapter adds an aggregate 64 MiB stylesheet-text limit and idempotent indexing.

Transform compatibility

transform_compat::parse_transform preserves EffectCraft transform-list recovery and exact composition. It retains six numeric arguments per operation; scanning is not time/byte capped and matrix overflow behavior is unchanged. The strict geometry reader is unchanged. Source: Brandon Thomas, EffectCraft94e1c86d89a866771f80ad1610afda9aa12e85d8; bounded safe argument matching by Altynzhan Karybai,4035d181329e847d7a57bf3d059502ea2c91b560.

Opt-in validated embedded images

With tree-render, tree::ValidatedImageResolver owns one drawing's immutable Limits, original child-source work, data-URL normalization and renderer-specific raster validation. Existing ImageResolver::new/resolver and legacy parse entry points retain their behavior. Opt in explicitly:

fn example() -> Result<(), craft_svg::tree::Error> {
    use craft_svg::tree::{self, Limits, ValidatedImageResolver, usvg};
    let images = ValidatedImageResolver::new(Limits::default());
    let checked = tree::preflight(
        "<svg xmlns='http://www.w3.org/2000/svg' width='1' height='1'/>",
        &images.limits(),
    )?;
    let drawing = images.parse_preflight(checked, usvg::Options::default())?;
    let usage = images.usage();
    // Importers disclose usage's invalid_* and *_limit_images; strict consumers refuse them.
    let _ = (drawing, usage);
    Ok(())
}

The caller supplies fonts and a sufficient stack/worker for its depth policy. parse_preflight accepts only an opaque preflight made with exactly this context's limits. It consumes options and installs its own data-only resolver, including for all children; unrelated callbacks cannot fetch a linked file or bypass admission. Expanded root ancestor frames (checked height minus the callback leaf) and each child's complete expanded height share one depth allowance. The callback leaf is not counted twice; source nesting alone cannot hide expanded reference chains. An overlapping root conversion on the same context is refused.

Unchanged XML converts from its original checked DOM. A modified data URL requires one checked replacement DOM. Invalid URLs become bounded resolver-visible image failures. The normal path counts only resolved images. If a repair cannot fit, the checked original can still convert when all its MIME headers meet the work limit. In that case malformed image declarations are counted conservatively. Original UTF-8 child bytes are charged before XML conversion or shorter repairs, with per-document and aggregate bounds. A malformed plain encoding spends its input bytes and leaves the remaining work for siblings. Failed inflation can exhaust its attempted allowance, and the separate bounded retry classification never admits another child. Encoded raster callbacks spend at most limits.bytes + limits.embedded_bytes cumulatively, without retaining their sources. Pixel work and decoder allocation are admitted before decoding; attempted failures keep their charge. An oversized unattempted image does not prevent a later smaller image from fitting.

resolve_text accepts an already-decoded child SVG through the same admission context, rather than an unchecked DOM or a precharged-budget override. usage() reports omissions and work after conversion. The context is for one drawing, not a global rendering cache.

The validator uses the existing JPEG backend in craft-image-codecs. The lockfile test checks that it and the other validation backends match the selected resvg dependency edges. resvg decodes the image again when it paints.