chore: Release v2.0.0 - Major refactor with breaking changes, dynamic opacity, and enhanced styling

Author: fabiocarneiro

CHANGELOG.md

@@ -1,3 +1,11 @@
+## 2.0.0
+
+* **Breaking Change:** Refactored `CircleNode` data model. Renamed `upperLabel` to `displayValue` and reordered constructor arguments (`value` now comes before `displayValue`).
+* **New Feature:** Added `showValue` and `showLabels` flags to `FlutterCirclePackChart` for granular display control.
+* **New Feature:** Implemented **Dynamic Opacity**: Circles now automatically scale their opacity (0.85 - 1.0) based on their relative values to highlight data importance.
+* **Typographic Refinement:** Implemented independent "anti-scaling" for value and label lines, ensuring perfect sharpness and a balanced visual hierarchy.
+* Refactored example app with three distinct demo categories: Countries, Budget, and Stress Tests.
+
 ## 1.0.4
 
 * Implemented "Deck of Cards" drawing order: larger circles now stay on top of smaller ones during all transitions.

example/lib/main.dart

@@ -257,6 +257,8 @@ class WorldPopulationExample extends StatelessWidget {
       children: [
         CircleNode(
           label: 'Asia',
+          value: 4700.0,
+          displayValue: '4.7B',
           color: Colors.red,
           children: [
             CircleNode(label: 'China', value: 1400.0, displayValue: '1.4B'),
@@ -268,6 +270,8 @@ class WorldPopulationExample extends StatelessWidget {
         ),
         CircleNode(
           label: 'Europe',
+          value: 745.0,
+          displayValue: '745M',
           color: Colors.blue,
           children: [
             CircleNode(label: 'Germany', value: 83.0, displayValue: '83M'),
@@ -278,13 +282,26 @@ class WorldPopulationExample extends StatelessWidget {
         ),
         CircleNode(
           label: 'Americas',
+          value: 1000.0,
+          displayValue: '1.0B',
           color: Colors.green,
           children: [
             CircleNode(label: 'USA', value: 330.0, displayValue: '330M'),
             CircleNode(label: 'Brazil', value: 210.0, displayValue: '210M'),
             CircleNode(label: 'Canada', value: 38.0, displayValue: '38M'),
           ],
         ),
+        CircleNode(
+          label: 'Africa',
+          value: 1400.0,
+          displayValue: '1.4B',
+          color: Colors.orange,
+          children: [
+            CircleNode(label: 'Nigeria', value: 200.0, displayValue: '200M'),
+            CircleNode(label: 'Ethiopia', value: 110.0, displayValue: '110M'),
+            CircleNode(label: 'Egypt', value: 100.0, displayValue: '100M'),
+          ],
+        ),
       ],
     );
 

lib/flutter_circle_pack_chart_painter.dart

@@ -65,9 +65,7 @@ class FlutterCirclePackChartPainter extends CustomPainter {
       final double minValue = node.children.isEmpty ? 0.0 : node.children.map((c) => c.node.value).reduce((a, b) => a < b ? a : b);
 
       for (final child in sortedChildren) {
-        // Dynamic opacity only applies when we are drilled in deeper than root.
-        // If focusedNode is root, everything at level 1 is 100% opaque.
-        // We use a tight range (0.85 - 1.0) to keep boxes looking solid.
+        // Dynamic opacity with a tight range (0.85 - 1.0)
         final double importance = (focusedNode == root.node)
             ? 1.0
             : (maxValue == minValue
@@ -166,37 +164,29 @@ class FlutterCirclePackChartPainter extends CustomPainter {
   ) {
     if (!showValue && !showLabels) return;
 
-    // Use "Anti-Scaling": divide baseFontSize by cameraScale to keep it constant on screen.
-    final double fontSize = (baseFontSize / cameraScale).clamp(0.1, 100.0);
+    // Use two distinct, anti-scaled font sizes for perfect sharpness.
+    final double valueFontSize = (baseFontSize / cameraScale).clamp(0.1, 100.0);
+    // Label is exactly 25% smaller than the base/value size, but using a whole number where possible
+    final double labelFontSize = ((baseFontSize * 0.75) / cameraScale).clamp(0.1, 100.0);
 
     final TextSpan span = TextSpan(
       children: [
         if (showValue) ...[
-          if (node.displayValue != null)
-            TextSpan(
-              text: '${node.displayValue}${showLabels ? '\n' : ''}',
-              style: TextStyle(
-                color: Colors.white.withValues(alpha: opacity),
-                fontSize: fontSize * 1.2,
-                fontWeight: FontWeight.bold,
-              ),
-            )
-          else
-            TextSpan(
-              text: '${node.value.toStringAsFixed(0)}${showLabels ? '\n' : ''}',
-              style: TextStyle(
-                color: Colors.white.withValues(alpha: opacity),
-                fontSize: fontSize * 1.2,
-                fontWeight: FontWeight.bold,
-              ),
+          TextSpan(
+            text: '${node.displayValue ?? node.value.toStringAsFixed(0)}${showLabels ? '\n' : ''}',
+            style: TextStyle(
+              color: Colors.white.withValues(alpha: opacity),
+              fontSize: valueFontSize,
+              fontWeight: FontWeight.bold,
             ),
+          ),
         ],
         if (showLabels)
           TextSpan(
             text: node.label,
             style: TextStyle(
               color: Colors.white.withValues(alpha: opacity),
-              fontSize: fontSize,
+              fontSize: labelFontSize,
               fontWeight: FontWeight.normal,
             ),
           ),
@@ -211,7 +201,6 @@ class FlutterCirclePackChartPainter extends CustomPainter {
       ellipsis: '...',
     );
 
-    // Allow some overflow for tiny circles but keep it tighter than before to avoid edges.
     textPainter.layout(maxWidth: radius * 2.5);
 
     textPainter.paint(

pubspec.yaml

@@ -1,6 +1,6 @@
 name: flutter_circle_pack_chart
 description: A powerful and interactive circle pack chart (circular treemap) library for Flutter.
-version: 1.0.4
+version: 2.0.0
 homepage: https://fabiocarneiro.github.io/FlutterCirclePackChart/
 repository: https://github.com/fabiocarneiro/FlutterCirclePackChart
 issue_tracker: https://github.com/fabiocarneiro/FlutterCirclePackChart/issues