📝 Update docs & bump version to 0.4.0

Author: SaadArdati

docs/flutter_controller.mdx

@@ -9,11 +9,11 @@ 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`, `handleTapSize`, `allowFlippingWhileResizing`,
-`movable`, `resizable`, `handleAlignment`, `hideHandlesWhenNotResizable`, and `allowContentFlipping` since these are
-accessibility and rendering features that are controlled at the Widget level.
+`movable`, `resizable`, `handleAlignment`, `enabledHandles`, `visibleHandles`, 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
+the `TransformableBoxController`: **_box_**, **_flip_**, **_clampingRect_**, **_constraints_**, and
 **_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>
 

docs/flutter_resizing.mdx

@@ -174,11 +174,11 @@ events respectively.
   );
 ```
 
-## Disable Resizing
+## Handle visibility
 
 Resizing can be disabled completely by setting the `resizable` property to `false`.
 
-```dart title="Resizable widget without resizing"
+```dart title="Disable resizing with the resizable bool"
   TransformableBox(
     rect: rect,
     flip: flip,
@@ -188,5 +188,34 @@ Resizing can be disabled completely by setting the `resizable` property to `fals
   );
 ```
 
+You can alternatively selectively hide handles by providing your own `visibleHandles` set.
+
+```dart title="Using the visibleHandles set to hide handles"
+  TransformableBox(
+    rect: rect,
+    flip: flip,
+    visibleHandles: {HandlePosition.right, HandlePosition.bottom, HandlePosition.bottomRight},
+    onChanged: (event) {...},
+    contentBuilder: (context, rect, flip) {...},
+  );
+```
+
+## Handle Interaction
+
+You can selectively disable handles but keep them visible at the same time by providing your own `enabledHandles` set.
+
+```dart title="Using the enabledHandles set to disable handles"
+  TransformableBox(
+    rect: rect,
+    flip: flip,
+    enabledHandles: {HandlePosition.right, HandlePosition.bottom, HandlePosition.bottomRight},
+    onChanged: (event) {...},
+    contentBuilder: (context, rect, flip) {...},
+  );
+```
+
+<Info>You can provide an empty set to disable all the handles but keep them visible and vice versa.</Info>
+
+
 [boxTransform]: https://github.com/hyper-designed/box_transform/tree/main/packages/box_transform
 [transformableBox]: https://github.com/hyper-designed/box_transform/blob/main/packages/flutter_box_transform/lib/src/transformable_box.dart

docs/handles.mdx

@@ -41,20 +41,46 @@ the interactive area is aligned to the center of box corner/side.
 
 ## Handle visibility
 
-By default, handles will be hidden when `resizable` is set to `false`. This can be changed by setting
-`hideHandlesWhenNotResizable` to `false`.
+By default, handles will be hidden when `resizable` is set to `false`.
 
-```dart title="Showing handles when box is not resizable"
+```dart title="Using the resizable boolean to hide handles"
   TransformableBox(
     rect: rect,
     flip: flip,
     resizable: false,
-    hideHandlesWhenNotResizable: false,
     onChanged: (event) {...},
     contentBuilder: (context, rect, flip) {...},
   );
 ```
 
+You can alternatively selectively hide handles by providing your own `visibleHandles` set.
+
+```dart title="Using the visibleHandles set to hide handles"
+  TransformableBox(
+    rect: rect,
+    flip: flip,
+    visibleHandles: {HandlePosition.right, HandlePosition.bottom, HandlePosition.bottomRight},
+    onChanged: (event) {...},
+    contentBuilder: (context, rect, flip) {...},
+  );
+```
+
+## Handle Interaction
+
+You can selectively disable handles but keep them visible at the same time by providing your own `enabledHandles` set.
+
+```dart title="Using the enabledHandles set to disable handles"
+  TransformableBox(
+    rect: rect,
+    flip: flip,
+    enabledHandles: {HandlePosition.right, HandlePosition.bottom, HandlePosition.bottomRight},
+    onChanged: (event) {...},
+    contentBuilder: (context, rect, flip) {...},
+  );
+```
+
+<Info>You can provide an empty set to disable all the handles but keep them visible and vice versa.</Info>
+
 ## Customizing the default handles
 
 By default, `TransformableBox` uses `DefaultCornerHandle` and `DefaultSideHandle` to build the handles. You can

packages/box_transform/CHANGELOG.md

@@ -1,3 +1,6 @@
+## 0.4.0
+- Fix stack overflow error when the clamping rect is smaller than the box rect.
+
 ## 0.3.0
 
 - Refactored the core logic to make it more readable, cleaner and easier to maintain.

packages/box_transform/pubspec.yaml

@@ -1,7 +1,7 @@
 name: box_transform
 description: A pure dart implementation of advanced 2D box transformation with easy and simple API.
 
-version: 0.3.0
+version: 0.4.0
 
 repository: https://github.com/hyper-designed/box_transform
 homepage: https://github.com/hyper-designed/box_transform

packages/flutter_box_transform/CHANGELOG.md

@@ -1,3 +1,8 @@
+## 0.4.0
+- [BREAKING]: Replace `hideHandlesWhenNotResizable` with `enabledHandles` and `visibleHandles`.
+- Replace the usage of Listener widgets with GestureDetectors in the TransformableBox.
+- Add new controls to the playground to reflect the new handle parameters.
+
 ## 0.3.2
 
 - Fix controller pattern not updating the UI when the controller is updated.

packages/flutter_box_transform/pubspec.yaml

@@ -1,7 +1,7 @@
 name: flutter_box_transform
 description: A Flutter implementation of box_transform package that provides easy 2D box transform operations with advanced resizing of rect in UI.
 
-version: 0.3.2
+version: 0.4.0
 
 repository: https://github.com/hyper-designed/box_transform
 homepage: https://github.com/hyper-designed/box_transform