full_svg_flutter

Percentage lengths, objectBoundingBox effects, and per-instance paced timing

Fixed

• Percentage lengths resolve against the correct viewport everywhere: basic
  shapes, <use> geometry and instance viewports, nested <svg> and
  <foreignObject>, text coordinates, mask regions, and hit testing, including
  a dimensionless root whose viewport is the embedding widget size.
• SMIL animations between mixed percentage and absolute values keep both units
  through interpolation, additive composition, and calcMode="paced" timing;
  gradient, pattern, text, stroke, and opacity consumers resolve the deferred
  value at render time, including calcMode="discrete" and <set> values.
• clipPathUnits, maskUnits, and maskContentUnits objectBoundingBox
  coordinate systems use the unpainted object bounds: stroke and other paint
  effects no longer inflate the bounding box, group children are mapped through
  their own transforms, <use> targets keep their x/y offset, and <text> /
  <tspan> targets contribute layout-derived bounds instead of being clipped
  out. Hit testing shares the same bounds for container, use, image, and text
  targets.
• Animated percentages on <mask> region attributes are bounding-box fractions
  under maskUnits="objectBoundingBox" and no longer ignore the animation in
  favor of the static attribute. Percentages inside clipPath and mask content
  stay viewport-relative, matching browsers, and keep their unit through
  interpolation instead of being stripped to a number.
• Animated percentages on the <filter> region (x, y, width, height)
  now take effect: bounding-box fractions under filterUnits="objectBoundingBox"
  and viewport lengths under userSpaceOnUse. The region was previously
  parsed once from the source and never re-read during animation.
• Animated percentages on a <mask maskUnits="userSpaceOnUse"> region resolve
  against the viewport instead of being stripped to bare numbers.
• Percentage-aware paced animations inside shared <symbol> and <svg>
  content are evaluated per <use> instance viewport in painting and hit
  testing, with a per-viewport key-time cache that invalidates when the
  instance viewport changes.
• <tref> painted text is hit-testable at its painted glyph positions.
• The QuickJS engine asset path uses packages/quickjs_engine after the
  package rename.

Maintenance

• Hit testing refreshes viewport-dependent animation values before resolving
  geometry instead of reading the last painted state.
• Thanks to @oierxjn for the percentage-length
  stack (#33,
  #39,
  #41,
  #43), the
  tref hit-testing fix
  (#48), and
  the text object-bounds fix
  (#49), and
  to @remtrik for the QuickJS asset path fix
  (#45).

FullSVG DevTools Inspector

New

• Added an official Flutter DevTools companion extension that discovers every live FullSVG renderer in a connected debug application.
• Added scalable, lazy SVG DOM inspection with stable per-document node IDs, raw and resolved attributes, animation descriptors, and runtime statistics.
• Added live animation controls for play, pause, restart, seeking, and playback rate using the renderer's existing deterministic timeline.
• Added transformed geometry highlighting for selected SVG nodes inside the running application without modifying document attributes.

Developer tooling

• Added a versioned, structured VM service-extension protocol with validated commands and machine-readable errors.
• Added weak-reference instance tracking with deterministic lifecycle cleanup and debug-only registration, preserving release behavior.
• Added reconnect handling for hot reload, hot restart, main-isolate changes, disposed instances, and applications without the runtime bridge.
• Added a four-renderer manual verification screen, runtime and extension test coverage, publishing documentation, and repeatable build/validation tooling.

What changed

• Fixed macOS QuickJS support by shipping a universal arm64 + x86_64 bridge through quickjs_engine 0.1.5.
• Set explicit macOS deployment targets for reproducible native builds.
• Added macOS CI that verifies both architectures in the shipped library, rebuilt library, and release app bundle.

Thanks @OrPudding for the contribution in #40.

Full changelog: v1.4.3...v1.4.4

Windows build compatibility

• Updates quickjs_engine to ^0.1.4.
• Fixes Windows generated plugin registrant compile/link failures.
• Refreshes installation examples and public guides.
• Includes clean Windows release-build coverage and preserves Android 16 KB alignment checks.

Thanks to @dariyooo for contributing the core manifest fix in #36.

Published package: https://pub.dev/packages/full_svg_flutter/versions/1.4.3
Changelog: https://github.com/denisnadey/flutter_full_svg_support/blob/v1.4.3/CHANGELOG.md

Fixed

• Source-based diffuse lighting, specular lighting, and displacement filters now keep separate precomputed rasters for each rendered use instance.
• SourceGraphic precomputation now stays in the filter target's local coordinate space, fixing scaled, rotated, nested, and positioned use chains.

Maintenance

• Centralized supported use targets and recursion limits across painting, hit testing, and filter precomputation.
• Added regression coverage for inherited styles, transforms, lighting, displacement, and id-less filter targets.

Published on pub.dev: https://pub.dev/packages/full_svg_flutter/versions/1.4.2

Android 16 KB page-size compatibility.

• Releases quickjs_engine 0.1.3 with 16 KB ELF LOAD segment alignment on Android.
• Requires quickjs_engine ^0.1.3 from full_svg_flutter.
• Adds CI checks for ELF segment and APK ZIP alignment.
• Preserves support for CMake 3.10 host toolchains.

Fixes #31.

Highlights

• Complete ordered SVG filter-pass execution for groups and leaf elements.
• Correct objectBoundingBox sizing for paths, text, containers, and referenced use/symbol/svg geometry.
• Geometry-accurate transform-box: fill-box and percentage transform-origin rotation/scaling.
• Correct filter + mask/opacity/clip composition, paint-channel isolation, and identity filter-region clipping.
• Stable per-node source-filter precompute caching.
• New public documentation in English, Simplified Chinese, and Hindi, plus refreshed migration, feature, and limitations guides.
• Android arm64 release CI support for current GitHub-hosted Ubuntu runners.

Install

dependencies:
  full_svg_flutter: ^1.4.0

Published on pub.dev: https://pub.dev/packages/full_svg_flutter/versions/1.4.0

See CHANGELOG.md for the complete release notes.

Fixed

• Updated quickjs_engine to ^0.1.2, which fixes Android clean CI release builds failing at native CMake linking because the QuickJS bridge used __android_log_print without linking Android liblog.
• The quickjs_engine update also aligns Android plugin Java/Kotlin JVM target settings for clean release builds on modern Flutter/Gradle toolchains.

Android packaging + dependency refresh

This release folds in the Android CMakeLists.txt fix that explicitly links the log library on Android, which resolves NDK 27+ builds for the native QuickJS bridge.

Changed

• Added Android-specific log library linking in packages/quickjs_engine/native/CMakeLists.txt.
• Updated the package metadata to the new minor release.
• Refreshed the public-facing README install examples to ^1.3.0.

Fixed

• Android builds with newer NDK versions no longer fail on __android_log_print symbol resolution in the native bridge.

One self-contained rendering engine 🎉

Static SVG rendering no longer depends on the vector_graphics package family. Both static (SvgPicture) and animated (FSvgPicture / AnimatedSvgPicture) SVGs are now rendered by this package's own DOM-preserving engine — one consistent code path, fewer transitive dependencies, and the full feature set (filters, masks, gradients, text) available to static SVGs too. The public SvgPicture / FSvgPicture API is unchanged, so this is a drop-in upgrade for the common case.

Changed

• Removed the dependencies on vector_graphics, vector_graphics_compiler, and vector_graphics_codec. They are no longer pulled into your app.
• SvgPicture is now rendered by the built-in engine instead of vector_graphics' createCompatVectorGraphic. The public SvgPicture API — every constructor, SvgTheme, ColorMapper, and all loaders — is unchanged.
• Types previously re-exported from vector_graphics are now owned by this package:
  • BytesLoader resolves the raw UTF-8 SVG source rather than a compiled binary vector format.
  • PictureInfo is now this package's own class (picture + size), produced by the new renderSvgToPicture helper.
  • RenderingStrategy is retained for source compatibility but is now a no-op hint.
• Removed precompiled .vec asset support (AssetBytesLoader) — it was a vector_graphics_compiler feature. SVGs are parsed directly at runtime and the decoded source is cached.
• vg / VectorGraphicUtilities are no longer exported. Use renderSvgToPicture to render an SVG to a ui.Picture / ui.Image.
• WOFF/WOFF2 font decoding for SVG @font-face rules now lives in the new standalone woff2 package (added as a dependency). Same code, lifted out so apps that don't render SVGs but do need WOFF/WOFF2 font loading can use it directly. es_compression moved from a direct dependency to a dev_dependencies entry used only by the test config. The SvgFontLoader typedef (re-exported from lib/src/animation.dart) is now an alias for WoffSrcResolver with the same signature — no source changes required for callers.

New

• renderSvgToPicture(String svg, {Size?, SvgTheme?, ColorMapper?}) renders an SVG to a PictureInfo outside the widget tree.
• SvgTheme (currentColor, font-size) and ColorMapper (per-attribute color substitution) are now honored by the engine for both static and animated SVGs.
• AnimatedSvgPicture accepts theme and colorMapper.
• BoxFit / alignment are now honored for non-contain fits.
• SvgPicture without an explicit width/height lays out at its intrinsic size in unbounded contexts (rows, columns, scroll views).
• New demo assets: an animated Flutter logo (assets/flutter_logo_animated.svg) and a CSS @keyframes loader (assets/demo_css.svg).

Fixed

• Relaxed the meta dependency constraint from ^1.17.0 to ^1.16.0 so it no longer conflicts with the meta version pinned by the SDK's flutter_test (Flutter 3.32 ships meta 1.16.0), which previously made version resolution fail for projects that also use flutter_test.

Migration

For static SVGs no code change is required — SvgPicture.asset / .network / .string / .memory / .file work exactly as before. If you imported vector_graphics types directly, switch to the package's own (BytesLoader, PictureInfo, renderSvgToPicture) exported from package:full_svg_flutter/full_svg_flutter.dart.

Documentation fixes for the 1.1.0 release — no code changes.

• Updated supported-features table: JavaScript inside SVG row now reads ✅ Supported (linking to the JavaScript runtime section) instead of the stale ❌ from previous versions.
• Updated FAQ entry on SVGator: both SMIL/CSS and JS-export modes are documented as working now.
• Added a Native dependencies + Building the native library from source section to the README covering macOS / Linux / Windows toolchain prerequisites and when end users actually need to recompile.
• Rewrote doc/limitations.md JavaScript section: spelled out which DOM APIs the polyfill covers and which still aren't supported (full HTML DOM, inline onclick= handlers, browser frameworks).
• Updated doc/supported_features.md: JavaScript runtime is its own table now with the polyfill surface; removed the obsolete row from "Not supported".
• Quick-start version pins refreshed from 1.0.3 → 1.1.0.

JavaScript runtime + SVGator support 🎉

This release ships an embedded JavaScript engine and a polyfilled SVG DOM, so animated SVGs that drive their animation through inline <script> blocks now render natively — no WebView, no conversion to SMIL.

• SVGator JS-export files now render correctly. Coffee Match Cut, Glowing Gummies, Basketball Boy, Skating Girls, Dog Character, Ramen Raccoon and similar SVGator-exported scenes play with their original player script attached. SMIL/CSS export is no longer required.
• Embedded JavaScript engine. QuickJS-NG 0.14.0 (May 2026 release) ships inside the app on every platform — Android, iOS, macOS, Linux, Windows — via the new quickjs_engine runtime package. The same JS engine on every target eliminates the JSC-vs-old-QuickJS divergence that plagued cross-platform JS-in-SVG.
• SVG DOM polyfill. document.getElementById, Element.setAttribute/setAttributeNS, style property proxy, virtual createElementNS('svg', 'path') with real getTotalLength() and getPointAtLength(distance) for arc-length-parameterized bezier interpolation, requestAnimationFrame, addEventListener, timers, fetch/XHR via Dart http, plus the rest of the surface SVGator and similar players touch.
• Cubic-bezier path arc-length math. Virtual <path> elements compute real arc length via 100-sample subdivision + cumulative table; getPointAtLength does a binary search across the table and linearly interpolates between samples. Cached per-path keyed by the d attribute. This is the keystone fix that gets SVGator's Ft() interpolator to produce correct points instead of {x:0, y:0} mid-segment.
• Custom JS animations also work — any inline <script> that walks the SVG via getElementById + setAttribute will animate, even if it's not from SVGator.

• Fix <image> aspect ratio: when only width or height is specified, the missing dimension is now computed proportionally from the image's intrinsic size. Previously, the raw pixel dimension was used, causing images placed with a single size attribute to shift position and appear at incorrect scale.
• Fix background-color clipping with clipToViewBox=true: the SVG root background-color style was drawn before the viewBox clip was applied, causing it to fill the entire widget instead of being bounded by the SVG viewport. It is now drawn inside the transformed and clipped canvas context, matching browser behaviour.
• Add clipToViewBox toggle (default true) to the example playground, so SVG content that overflows the viewBox boundary is clipped by default — matching how browsers display SVG files opened directly.
• Fix playground SVG proportions: preview width and height are now derived from the SVG viewBox aspect ratio instead of forcing a square container, so portrait or landscape SVGs display at correct proportions.

• Add native file:// URI support for <image> elements: local files load via dart:io on all non-web platforms. Web stub returns null gracefully.
• Improve pub.dev package description and topics for animated SVG discoverability.
• Rewrite README: clear animated-SVG positioning, comparison table, migration guide, SVGator notes, FAQ, and supported-features matrix.
• Add docs/ directory: migration guide, feature compatibility matrix, limitations, and SEO notes.
• Add marketing article drafts in docs/marketing/.

• Fix filter rendering on <g> groups: filters applied to <g> elements with no opacity or blend-mode were silently discarded. Now correctly opens a saveLayer with the filter, improving fidelity for SVGs that animate filter primitives on groups.
• Fix SMIL sandwich model for multiple animations targeting the same attribute: additive animations no longer double-stack when chained via computeRawValue + applyAdditiveWithBase.
• Add clipToViewBox option to AnimatedSvgPicture and AnimatedSvgPainter: opt-in strict viewBox clipping to match browser direct-URL rendering behaviour (defaults to false for backward compatibility).
• Widen xml dependency constraint from ^6.0.0 to >=6.0.0 <8.0.0 to support xml 7.x.
• Fix deprecated FontWeight.index usage — replaced with FontWeight.value.

• Initial release of full_svg_flutter — a comprehensive SVG rendering library for Flutter.