📝 Update docs.

Author: SaadArdati

docs/flutter_controller.mdx

@@ -8,12 +8,13 @@ title: Using a controller
 transformable box externally with proper state management.
 
 To create a controller, you can use the `TransformableBoxController` class. It mirrors a lot of the observed parameters
-in the constructor excluding `contentBuilder`, `handleBuilder`, and `handleTapSize` since these are accessibility and
-rendering features.
+in the constructor excluding `contentBuilder`, `handleBuilder`, `handleTapSize`, `allowFlippingWhileResizing`,
+`movable`, `resizable`, `handleAlignment`, `hideHandlesWhenNotResizable`, and `allowContentFlipping` since these are
+accessibility and rendering features that are controlled at the Widget level.
 
 <Warning>When using a controller, you should move these parameters from your `TransformableBox` to the constructor of
 the `TransformableBoxController`: **_box_**, **_flip_**, **_clampingBox_**, **_constraints_**, and
-**_resolveResizeModeCallback_**. These are all intrinsically managed by the controller.
+**_resizeModeResolver_**. These are all intrinsically managed by the controller.
 
 There must always be only one source of truth, either the `TransformableBox` or the `TransformableBoxController`, not both.</Warning>
 
@@ -100,9 +101,6 @@ controller.setConstraints(constraints);
 // Change clamping rect
 controller.setClampingRect(clampingRect);
 
-// Disable content/child flipping
-controller.setFlipChild(false);
-
 // Disable flipping the rect while resizing
-controller.setFlipRectWhileResizing(false);
+controller.setAllowFlippingWhileResizing(false);
 ```

docs/flutter_resizing.mdx

@@ -42,11 +42,11 @@ Resizing is freeform by default, meaning that the user can resize the box in any
 
 ## Controlling Resize Modes
 
-The `resolveResizeModeCallback` is a callback that is called whenever a resize operation is about to be performed on a
+The `resizeModeResolver` is a callback that is called whenever a resize operation is about to be performed on a
 given [Transformable Box][transformableBox]. This allows you to define the resize behavior at the time of the resize
 operation. This is useful when you want to change the resize behavior based on the state of the application.
 
-The most common use case for this is **keyboard shortcuts**. A `defaultResolveResizeModeCallback` function is used by
+The most common use case for this is **keyboard shortcuts**. A `defaultResizeModeResolver` function is used by
 default when resizing, and it's job is to listen to keyboard meta keys to change the `ResizeMode`.
 
 ### Default Resize Mode:
@@ -58,14 +58,14 @@ default when resizing, and it's job is to listen to keyboard meta keys to change
 
 See [ResizeModes](/resize_modes) page for more information on the different resize modes.
 
-Override this default behavior by providing `resolveResizeModeCallback` in `TransformableBox` constructor to customize
+Override this default behavior by providing `resizeModeResolver` in `TransformableBox` constructor to customize
 resizing to your liking. This can also be used to allow only certain resize modes.
 
 ```dart title="Resizing with preseving aspect ratio"
   TransformableBox(
     rect: rect,
     flip: flip,
-    resolveResizeModeCallback: () => ResizeMode.scale,
+    resizeModeResolver: () => ResizeMode.scale,
     onChanged: (event) {...},
     contentBuilder: (context, rect, flip) {...},
   );

docs/handles.mdx

@@ -26,14 +26,14 @@ You can customize the default handles or build your own handles using the `corne
 properties in the `TransformableBox` constructor. They both provide access to the `BuildContext` and `HandlePosition`
 of the appropriate handle.
 
-You can use `handleAlign` on `TransformableBox` to change the position of the handle's interactive area. By default,
+You can use `HandleAlignment` on `TransformableBox` to change the position of the handle's interactive area. By default,
 the interactive area is aligned to the center of box corner/side.
 
 ```dart title="Putting handle completely inside the box area"
   TransformableBox(
     rect: rect,
     flip: flip,
-    handleAlign: HandleAlign.inside,
+    handleAlignment: HandleAlignment.inside,
     onChanged: (event) {...},
     contentBuilder: (context, rect, flip) {...},
   );
@@ -121,7 +121,7 @@ You can use `AngularHandle` to build angular handles that look like corner brack
   TransformableBox(
     rect: rect,
     flip: flip,
-    handleAlign: HandleAlign.inside,
+    handleAlignment: HandleAlignment.inside,
     cornerHandleBuilder: (context, handle) {
       return AngularCornerHandle(
         handle: handle,
@@ -131,14 +131,14 @@ You can use `AngularHandle` to build angular handles that look like corner brack
     sideHandleBuilder: (context, handle) {
       return AngularSideHandle(
         handle: handle,
-        handleAlign: HandleAlign.inside,
+        handleAlignment: HandleAlignment.inside,
       );
     },
     onChanged: (event) {...},
     contentBuilder: (context, rect, flip) {...},
   );
 ```
 
-Use `handleAlign` to align `AngularHandle` to the inside, outside or in the center of the box.
+Use `handleAlignment` to align `AngularHandle` to the inside, outside or in the center of the box.
 
 <Image alt="Angular Handle Alignements" src="assets/angular_handle_alignments.png"/>

packages/flutter_box_transform/lib/src/handle.dart

@@ -165,11 +165,11 @@ class AngularHandle extends StatelessWidget {
   /// The thickness of the handle.
   final double thickness;
 
-  //// Whether the handle has a shadow.
+  /// Whether the handle has a shadow.
   final bool hasShadow;
 
   /// The alignment of the handle.
-  final HandleAlignment handleAlign;
+  final HandleAlignment handleAlignment;
 
   /// Creates a new angular corner handle.
   const AngularHandle({
@@ -179,7 +179,7 @@ class AngularHandle extends StatelessWidget {
     this.thickness = 5,
     this.color,
     this.hasShadow = true,
-    this.handleAlign = HandleAlignment.inside,
+    this.handleAlignment = HandleAlignment.inside,
   });
 
   @override
@@ -197,7 +197,7 @@ class AngularHandle extends StatelessWidget {
               thickness: thickness,
               handle: handle,
               hasShadow: hasShadow,
-              handleAlign: handleAlign,
+              handleAlign: handleAlignment,
               length: min(
                 length,
                 handle.isHorizontal

packages/flutter_box_transform/lib/src/transformable_box.dart

@@ -439,14 +439,6 @@ class _TransformableBoxState extends State<TransformableBox> {
       controller.setResizable(widget.resizable, notify: false);
     }
 
-    if (oldWidget.hideHandlesWhenNotResizable !=
-        widget.hideHandlesWhenNotResizable) {
-      controller.setHideHandlesWhenNotResizable(
-        widget.hideHandlesWhenNotResizable,
-        notify: false,
-      );
-    }
-
     if (oldWidget.movable != widget.movable) {
       controller.setMovable(widget.movable, notify: false);
     }
@@ -592,7 +584,7 @@ class _TransformableBoxState extends State<TransformableBox> {
             height: box.height,
             child: content,
           ),
-          if (controller.resizable || !controller.hideHandlesWhenNotResizable)
+          if (controller.resizable || !widget.hideHandlesWhenNotResizable)
             for (final handle in HandlePosition.corners)
               _CornerHandleWidget(
                 key: ValueKey(handle),
@@ -606,7 +598,7 @@ class _TransformableBoxState extends State<TransformableBox> {
                 onPointerCancel: (event) => onHandlePointerDone(event, handle),
                 builder: widget.cornerHandleBuilder,
               ),
-          if (controller.resizable || !controller.hideHandlesWhenNotResizable)
+          if (controller.resizable || !widget.hideHandlesWhenNotResizable)
             for (final handle in HandlePosition.sides)
               _SideHandleWidget(
                 key: ValueKey(handle),

packages/flutter_box_transform/lib/src/transformable_box_controller.dart

@@ -117,14 +117,6 @@ class TransformableBoxController extends ChangeNotifier {
   /// all resizing operations.
   bool get resizable => _resizable;
 
-  /// Whether the box should hide the corner/side resize controls when [resizable] is
-  /// false.
-  bool _hideHandlesWhenNotResizable = true;
-
-  /// Whether the box should hide the corner/side resize controls when [resizable] is
-  /// false.
-  bool get hideHandlesWhenNotResizable => _hideHandlesWhenNotResizable;
-
   /// Whether to allow flipping of the box while resizing. If this is set to
   /// true, the box will flip when the user drags the handles to opposite
   /// corners of the rect.
@@ -217,15 +209,6 @@ class TransformableBoxController extends ChangeNotifier {
     if (notify) notifyListeners();
   }
 
-  /// Whether the box should hide the corner/side resize controls when [resizable] is
-  /// false.
-  void setHideHandlesWhenNotResizable(bool hideHandlesWhenNotResizable,
-      {bool notify = true}) {
-    _hideHandlesWhenNotResizable = hideHandlesWhenNotResizable;
-
-    if (notify) notifyListeners();
-  }
-
   /// Whether to allow flipping of the box while resizing. If this is set to
   /// true, the box will flip when the user drags the handles to opposite
   /// corners of the rect.

packages/flutter_box_transform/playground/lib/main.dart

@@ -764,13 +764,13 @@ class _ClampingRectState extends State<ClampingRect> {
         handle: handle,
         color: mainColor,
         hasShadow: false,
-        handleAlign: HandleAlignment.inside,
+        handleAlignment: HandleAlignment.inside,
       ),
       sideHandleBuilder: (context, handle) => AngularHandle(
         handle: handle,
         color: mainColor,
         hasShadow: false,
-        handleAlign: HandleAlignment.inside,
+        handleAlignment: HandleAlignment.inside,
       ),
       contentBuilder: (context, _, flip) => Container(
         width: model.clampingRect.width,