svg_painter 0.2.0

A code generator that compiles SVG files into Flutter CustomPainter code.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

0.2.0 - 2026-01-31

Added

Dynamic Properties

• ID-Based Exposure: Automatically generates fields for elements with IDs (e.g. final Color? myCircleFill).
• Indexed Exposure: Generates fields for elements without IDs using index-based naming (e.g. final Color? fill1) when enabled via exposureMode: SvgExposureMode.indexed.
• Property Mapping: Allows renaming of exposed properties via propertyMapping in the annotation (e.g. {'fill1': 'primaryColor'}).
• Dynamic Style Inheritance: Overriding a group's property (e.g. g1Fill) now correctly propagates to all inheriting children.

Widget Generation

• Generates a StatelessWidget wrapper (e.g. MyIconWidget) for easier consumption.
• Exposes all dynamic properties as constructor parameters.
• Supports BoxFit, Alignment, and width/height sizing.

CurrentColor Support

• Maps SVG currentColor keyword to a primary color property on the generated Widget/Painter.
• Defaults to IconTheme.of(context).color in the generated Widget.

Changed

• Refactoring: Significant code cleanup and refactoring for better maintainability and type safety.
• Dependency: Updated svg_painter_annotation to ^0.2.0.

0.1.1 - 2026-01-26

Fixed

• Added example file for pub.dev documentation
• Fixed monorepo dependency resolution for CI

0.1.0 - 2026-01-25

Added

SVG Elements

• <svg> - Root element with viewBox support
• <circle> - Circle shapes
• <ellipse> - Ellipse/oval shapes
• <rect> - Rectangles with optional rounded corners (rx/ry)
• <line> - Line segments
• <path> - Full path data support (M, L, H, V, C, S, Q, T, A, Z commands)
• <polygon> - Closed polygon shapes
• <polyline> - Open polyline shapes
• <text> - Basic text rendering
• <g> - Group element for organizing shapes
• <defs> - Definition container for reusable elements
• <use> - Reference and reuse defined elements
• <linearGradient> - Linear gradient fills/strokes
• <radialGradient> - Radial gradient fills/strokes
• <stop> - Gradient color stops

SVG Attributes

• fill and stroke - Solid colors and gradient references
• fill-opacity and stroke-opacity - Transparency control
• opacity - Element-level opacity
• stroke-width - Stroke thickness
• stroke-linecap - Line end styles (butt, round, square)
• stroke-linejoin - Line join styles (miter, round, bevel)
• stroke-dasharray - Dashed line patterns
• transform - All transform functions (translate, scale, rotate, skewX, skewY, matrix)
• viewBox - Coordinate system definition
• style - Inline CSS style parsing

Color Formats

• Named colors (140 SVG/CSS color names)
• Hex colors (#RGB, #RRGGBB)
• RGB/RGBA (rgb(), rgba())
• HSL/HSLA (hsl(), hsla())
• none and currentColor keywords

Build System

• build_runner integration for automatic code generation
• Annotation-based SVG file selection (@SvgPainter)

Notes

• Generated painters extend Flutter's CustomPainter
• Automatic scaling to fit target dimensions while preserving aspect ratio
• Full support for nested groups and transforms