v2.3.0

.pubignore

@@ -1,7 +1,19 @@
 # Pub
 DEVLOG.md
 devdoc/
-example/
+example/android
+example/ios
+example/web
+example/windows
+example/linux
+example/macos
+example/fuchsia
+example/lib
+example/test
+example/gitignore
+example/pubspec.yaml
+example/.metadata
+example/analysis_options.yaml
 
 # Miscellaneous
 *.class

CHANGELOG.md

@@ -1,3 +1,10 @@
+## 2.3.0
+
+**2024-07-09**
+
+- Add `AxisGuide.labelBackground` and `AxisGuid.labelBackgroundMapper`: https://github.com/entronad/graphic/pull/301
+- Change `LabelStyle.textScaleFactor` to `LabelStyle.textScaler` to be consist with `TextPainter`: https://github.com/entronad/graphic/pull/300. Although this is a breaking change, only minor version is upgraded for this prop is rarely used.
+
 ## 2.2.1
 
 **2023-09-26**

README.md

@@ -11,24 +11,6 @@ Graphic is a grammar of data visualization and Flutter charting library.
 - **Interaction**: With the *event* and *selection* definition, the chart is highly interactive, such as highlighting selected items, popping a tooltip, or scaling the coordinate.
 - **Animation**: Mark transition animation can be set when a chart is built or changed. The entrance animation has various forms.
 
-## What's new in v2.0
-
-- Add feature of transition animation, see details in `Mark.transition`. And thus the rendering engine is rewrited. The imperative `Figure` classes are changed to declarative `MarkElement` classes. See details in this folder: https://github.com/entronad/graphic/tree/main/lib/src/graffiti/element
-
-- Update terminology to keep same with modern mainstream data visualization libraries. Some class names have changed:
-
-  `GeomElement -> Mark`
-
-  `Attr -> Encode`
-
-  `Signal -> Event`
-
-  `Channel -> Stream`
-
-  `Figure -> MarkElement`
-
-  And thus some properties related are also changed, like `elements -> marks`.
-
 ## Documentation
 
 See in the [documentation](https://pub.dev/documentation/graphic/latest/graphic/graphic-library.html).

example/macos/Runner.xcodeproj/project.pbxproj

@@ -182,7 +182,7 @@
 			isa = PBXProject;
 			attributes = {
 				LastSwiftUpdateCheck = 0920;
-				LastUpgradeCheck = 1300;
+				LastUpgradeCheck = 1510;
 				ORGANIZATIONNAME = "";
 				TargetAttributes = {
 					33CC10EC2044A3C60003C045 = {

example/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "1300"
+   LastUpgradeVersion = "1510"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

lib/src/dataflow/tuple.dart

@@ -47,6 +47,7 @@ class Attributes {
   /// The index of the tuple in all tuples list.
   final int index;
 
+  /// The tag of the tuple.
   final String? tag;
 
   /// Position points of the tuple.

lib/src/graffiti/element/element.dart

@@ -434,6 +434,7 @@ abstract class BlockElement<S extends BlockStyle> extends MarkElement<S> {
   /// anchor position.
   painting.Alignment defaultAlign;
 
+  /// The real painting offset point of this block.
   @protected
   late final Offset paintPoint;
 

lib/src/graffiti/element/label.dart

@@ -227,7 +227,7 @@ class LabelElement extends BlockElement<LabelStyle> {
   bool operator ==(Object other) =>
       other is LabelElement && super == other && text == other.text;
 
-  Rect getTextRect() {
+  Rect getBlock() {
     const horizontalSpacing = 1;
     final left = paintPoint.dx - horizontalSpacing;
     final top = paintPoint.dy - 1;

lib/src/guide/axis/circular.dart

@@ -52,20 +52,20 @@ List<MarkElement>? renderCircularAxis(
             ) *
             flipSign;
 
-        final lineElement = LabelElement(
+        final label = LabelElement(
             text: tick.text!,
             anchor: labelAnchor,
             defaultAlign: defaultAlign,
             style: tick.label!);
 
         if (tick.haveLabelBackground) {
           rst.add(RectElement(
-            rect: lineElement.getTextRect(),
+            rect: label.getBlock(),
             style: tick.labelBackground!,
           ));
         }
 
-        rst.add(lineElement);
+        rst.add(label);
       }
     }
   }

lib/src/guide/axis/horizontal.dart

@@ -40,20 +40,20 @@ List<MarkElement>? renderHorizontalAxis(
             style: tick.tickLine!.style));
       }
       if (tick.haveLabel) {
-        final lineElement = LabelElement(
+        final babel = LabelElement(
             text: tick.text!,
             anchor: Offset(x, y),
             defaultAlign: flip ? Alignment.topCenter : Alignment.bottomCenter,
             style: tick.label!);
 
         if (tick.haveLabelBackground) {
           rst.add(RectElement(
-            rect: lineElement.getTextRect(),
+            rect: babel.getBlock(),
             style: tick.labelBackground!,
           ));
         }
 
-        rst.add(lineElement);
+        rst.add(babel);
       }
     }
   }

lib/src/guide/axis/radial.dart

@@ -92,20 +92,20 @@ List<MarkElement>? renderRadialAxis(
   final labelAlign = radialLabelAlign(featureOffset) * flipSign;
   for (var index in labelAnchors.keys) {
     final tick = ticks[index];
-    final lineElement = LabelElement(
+    final babel = LabelElement(
         text: tick.text!,
         anchor: labelAnchors[index]!,
         defaultAlign: labelAlign,
         style: tick.label!);
 
     if (tick.haveLabelBackground) {
       rst.add(RectElement(
-        rect: lineElement.getTextRect(),
+        rect: babel.getBlock(),
         style: tick.labelBackground!,
       ));
     }
 
-    rst.add(lineElement);
+    rst.add(babel);
   }
 
   return rst.isEmpty ? null : rst;

lib/src/guide/axis/vertical.dart

@@ -40,20 +40,20 @@ List<MarkElement>? renderVerticalAxis(
             style: tick.tickLine!.style));
       }
       if (tick.haveLabel) {
-        final lineElement = LabelElement(
+        final babel = LabelElement(
             text: tick.text!,
             anchor: Offset(x, y),
             defaultAlign: flip ? Alignment.centerRight : Alignment.centerLeft,
             style: tick.label!);
 
         if (tick.haveLabelBackground) {
           rst.add(RectElement(
-            rect: lineElement.getTextRect(),
+            rect: babel.getBlock(),
             style: tick.labelBackground!,
           ));
         }
 
-        rst.add(lineElement);
+        rst.add(babel);
       }
     }
   }

lib/src/shape/point.dart

@@ -30,6 +30,7 @@ abstract class PointShape extends FunctionShape {
       hollow == other.hollow &&
       strokeWidth == other.strokeWidth;
 
+  /// Draw each element of this point shape.
   MarkElement drawPoint(Attributes item, CoordConv coord);
 
   @override

pubspec.yaml

@@ -1,14 +1,21 @@
 name: graphic
 description: A grammar of data visualization and Flutter charting library.
-version: 2.2.1
+version: 2.3.0
 homepage: https://github.com/entronad/graphic
 
+topics:
+  - chart
+  - charts
+  - visualization
+  - diagram
+  - plot
+
 environment:
   sdk: '>=2.13.0 <4.0.0'
   flutter: '>=3.16.0'
 
 dependencies:
-  collection: ^1.15.0
+  collection: ^1.18.0
   flutter:
     sdk: flutter
   vector_math: ^2.1.0
@@ -17,4 +24,4 @@ dependencies:
 dev_dependencies:
   flutter_test:
     sdk: flutter
-  flutter_lints: ^2.0.1
+  flutter_lints: ^4.0.0