Merge remote-tracking branch 'origin/master' into claude/awesome-gates-nj49yn

Author: claude

lib/src/api/mixins.dart

@@ -289,6 +289,16 @@ mixin BlendMixin on BaseNode {
   late bool isMask;
 
   /// List of effects applied to the node.
+  @FlutterProp(
+    'effects',
+    type: 'array',
+    group: 'Effects',
+    control: 'list',
+    flutterParam: false,
+    a2ui: false,
+    note:
+        'Serialized node effects; individual shadow fields live in list items.',
+  )
   late List<Effect> effects;
 
   /// Whether to use ink well on this node, along with its properties.
@@ -664,13 +674,40 @@ mixin GeometryMixin on BaseNode {
   /// A list of fills applied to the node. This can be a solid color or a
   /// gradient or an image. Refer [PaintModel.type] for more info on supported
   /// types of fill.
+  @FlutterProp(
+    'fills',
+    type: 'array',
+    group: 'Fill',
+    control: 'list',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Serialized paints; image crop/transform fields live in list items.',
+  )
   late List<PaintModel> fills;
 
   /// A list of strokes applied to the node. Only solid color type of fill is
   /// supported at the moment.
+  @FlutterProp(
+    'strokes',
+    type: 'array',
+    group: 'Stroke',
+    control: 'list',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Serialized stroke paints; item color is not a top-level field.',
+  )
   List<PaintModel> strokes = [];
 
   /// Thickness/weight of the stroke.
+  @FlutterProp(
+    'strokeWeight',
+    type: 'number',
+    group: 'Stroke',
+    control: 'number',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Codelessly node stroke width, not a Flutter constructor argument.',
+  )
   double strokeWeight = 0;
 
   /// The limit for miters to be drawn on segments for given stroke join.
@@ -685,6 +722,15 @@ mixin GeometryMixin on BaseNode {
 
   /// The pattern of dashes and gaps to apply to the stroke in case of dashed
   /// stroke.
+  @FlutterProp(
+    'dashPattern',
+    type: 'array',
+    group: 'Stroke',
+    control: 'list',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Codelessly stroke dash/gap sequence, serialized as a number array.',
+  )
   late List<double> dashPattern;
 
   /// Side of the shape to apply the stroke to.
@@ -852,12 +898,42 @@ mixin ShapeBorderMixin {
   late CShapeBorder shape;
 
   /// Radius of the corners of the border.
+  @FlutterProp(
+    'cornerRadius',
+    type: 'object',
+    group: 'Appearance',
+    control: 'radius',
+    field: 'properties.cornerRadius',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Persisted property border corner-radius object.',
+  )
   late CornerRadius cornerRadius;
 
   /// Thickness of the border.
+  @FlutterProp(
+    'borderWidth',
+    type: 'number',
+    group: 'Appearance',
+    control: 'number',
+    field: 'properties.borderWidth',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Optional persisted property border width.',
+  )
   double? borderWidth;
 
   /// Color of the border.
+  @FlutterProp(
+    'borderColor',
+    type: 'object',
+    group: 'Appearance',
+    control: 'color',
+    field: 'properties.borderColor',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Optional persisted property border color.',
+  )
   ColorRGBA? borderColor;
 
   /// Sets the properties of this mixin.
@@ -913,9 +989,28 @@ mixin ShapeBorderMixin {
 /// rounded corners.
 mixin CornerMixin on BaseNode {
   /// Level of pixel smoothing applied to the corners.
+  @FlutterProp(
+    'cornerSmoothing',
+    type: 'number',
+    group: 'Corners',
+    control: 'number',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Codelessly corner smoothing of the serialized node.',
+  )
   late double cornerSmoothing;
 
   /// Radius of the corners of the node.
+  @FlutterProp(
+    'cornerRadius',
+    type: 'object',
+    group: 'Corners',
+    control: 'radius',
+    flutterParam: false,
+    a2ui: false,
+    note:
+        'Node corner-radius object; corner subfields are not top-level fields.',
+  )
   late CornerRadius cornerRadius;
 
   /// Sets the properties of this mixin.

lib/src/api/models/paint.dart

@@ -4,6 +4,7 @@ import 'package:json_annotation/json_annotation.dart';
 import 'package:equatable/equatable.dart';
 
 import '../../../codelessly_api.dart';
+import '../../schema/flutter_prop.dart';
 
 part 'paint.g.dart';
 
@@ -130,6 +131,15 @@ class PaintModel with Equatable, SerializableMixin, FieldsHolder {
   /// translation, rotation, and skew.
   ///
   /// The identity transform is [[1, 0, 0], [0, 1, 0]].
+  @FlutterProp(
+    'imageTransform',
+    type: 'array',
+    group: 'Image Fill',
+    control: 'matrix',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Optional persisted affine image transform in a paint item.',
+  )
   final List<List<num>>? imageTransform;
 
   /// Memory bytes to load the image.
@@ -153,17 +163,55 @@ class PaintModel with Equatable, SerializableMixin, FieldsHolder {
 
   /// The sizing behavior the image will use to fit inside its view.
   /// This is 1-1 with Flutter's [BoxFit].
+  @FlutterProp(
+    'fit',
+    type: 'string',
+    group: 'Image Fill',
+    control: 'select',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Persisted image fill fit mode in a paint item.',
+  )
   final Fit fit;
 
   /// The alignment positioning of the image relative to its view.
   /// [-1, -1] being the top left corner of the view and [1, 1] being the bottom
   /// right corner of the view, and [0, 0] being the center of the view.
   ///
   /// This corresponds to Flutter's [Alignment].
+  @FlutterProp(
+    'alignment',
+    type: 'object',
+    group: 'Image Fill',
+    control: 'alignment',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Persisted image alignment object in a paint item.',
+  )
   final AlignmentModel alignment;
 
   /// The image scale per-axis.
-  final double scaleX, scaleY;
+  @FlutterProp(
+    'scaleX',
+    type: 'number',
+    group: 'Image Fill',
+    control: 'number',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Persisted horizontal image scale or flip sign in a paint item.',
+  )
+  final double scaleX;
+
+  @FlutterProp(
+    'scaleY',
+    type: 'number',
+    group: 'Image Fill',
+    control: 'number',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Persisted vertical image scale or flip sign in a paint item.',
+  )
+  final double scaleY;
 
   /// Image scale.
   double get scale => min(scaleX, scaleY);
@@ -184,6 +232,15 @@ class PaintModel with Equatable, SerializableMixin, FieldsHolder {
   bool get isNonUniformScale => scaleX.abs() != scaleY.abs();
 
   /// Stores information about the crop of an image.
+  @FlutterProp(
+    'cropData',
+    type: 'object',
+    group: 'Image Fill',
+    control: 'crop',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Optional persisted crop object in a paint item.',
+  )
   final CropData? cropData;
 
   /// URL of the cropped image.
@@ -199,6 +256,15 @@ class PaintModel with Equatable, SerializableMixin, FieldsHolder {
   final double? sourceHeight;
 
   /// Tile mode for image fill.
+  @FlutterProp(
+    'imageRepeat',
+    type: 'string',
+    group: 'Image Fill',
+    control: 'select',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Persisted repeat mode for an image paint item.',
+  )
   final ImageRepeatEnum imageRepeat;
 
   /// Color saturation of an image fill: 1 keeps the image's colors, 0 makes

lib/src/api/models/pins_model.dart

@@ -2,6 +2,7 @@ import 'package:json_annotation/json_annotation.dart';
 import 'package:equatable/equatable.dart';
 
 import '../../../codelessly_api.dart';
+import '../../schema/flutter_prop.dart';
 
 part 'pins_model.g.dart';
 
@@ -71,18 +72,54 @@ enum EdgePin {
 class EdgePinsModel with Equatable, SerializableMixin {
   /// Distance between node's left edge and its parent's left edge. Setting a
   /// non-null value pins the node to the left edge of its parent.
+  @FlutterProp(
+    'left',
+    type: 'number',
+    group: 'Position',
+    control: 'number',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Nullable distance from the parent left edge.',
+  )
   final double? left;
 
   /// Distance between node's top edge and its parent's top edge. Setting a
   /// non-null value pins the node to the top edge of its parent.
+  @FlutterProp(
+    'top',
+    type: 'number',
+    group: 'Position',
+    control: 'number',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Nullable distance from the parent top edge.',
+  )
   final double? top;
 
   /// Distance between node's right edge and its parent's right edge. Setting a
   /// non-null value pins the node to the right edge of its parent.
+  @FlutterProp(
+    'right',
+    type: 'number',
+    group: 'Position',
+    control: 'number',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Nullable distance from the parent right edge.',
+  )
   final double? right;
 
   /// Distance between node's bottom edge and its parent's bottom edge. Setting a
   /// non-null value pins the node to the bottom edge of its parent.
+  @FlutterProp(
+    'bottom',
+    type: 'number',
+    group: 'Position',
+    control: 'number',
+    flutterParam: false,
+    a2ui: false,
+    note: 'Nullable distance from the parent bottom edge.',
+  )
   final double? bottom;
 
   /// Creates a new [EdgePinsModel] with the given [left], [top], [right], and