📝 Update all docs.

* Update Dart/Flutter versions.
* Rename flipRect to allowBoxFlipping.

Author: SaadArdati

README.md

@@ -5,26 +5,26 @@
 [![melos](https://img.shields.io/badge/maintained%20with-melos-f700ff.svg?style=flat-square)](https://github.com/invertase/melos) [![Codemagic build status](https://api.codemagic.io/apps/63dd4d4ae6be1d561b8f45d2/63dd4d4ae6be1d561b8f45d1/status_badge.svg)](https://codemagic.io/apps/63dd4d4ae6be1d561b8f45d2/63dd4d4ae6be1d561b8f45d1/latest_build) [![Tests](https://github.com/hyper-designed/box_transform/workflows/Tests/badge.svg?branch=main)](https://github.com/hyper-designed/box_transform/actions) [![codecov](https://codecov.io/gh/BirjuVachhani/box_transform/branch/main/graph/badge.svg?token=SX5FXDUD7A)](https://codecov.io/gh/BirjuVachhani/box_transform)
 
 [Box Transform][github] provides packages that allows you to programmatically handle box resizing and dragging. 
-It provides highly flexible, programmatically resizable and draggable boxes that can be used in any Dart or Flutter 
-project. A library for advanced resizing of rect in UI.
+It provides a highly flexible, programmatically resizable and draggable boxes that can be used in any Dart or Flutter 
+project.
 
 ## Packages
 
-| Package               | Pub                                                                                                                            | Description                                                                                                                              |
-|-----------------------|--------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|
-| box_transform         | [![Pub Version](https://img.shields.io/pub/v/box_transform?label=Pub)](https://pub.dev/packages/box_transform)                 | A pure Dart implementation of transformation operations that doesn't rely on Flutter.                                                    |
-| flutter_box_transform | [![Pub Version](https://img.shields.io/pub/v/flutter_box_transform?label=Pub)](https://pub.dev/packages/flutter_box_transform) | A Flutter implementation of Box Transform that provides flexible, customization and easy to use interface tailored for Flutter projects. |
+| Package               | Pub                                                                                                                            | Description                                                                                                              |
+|-----------------------|--------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------|
+| box_transform         | [![Pub Version](https://img.shields.io/pub/v/box_transform?label=Pub)](https://pub.dev/packages/box_transform)                 | A pure Dart implementation for box transformation operations that does not rely on Flutter.                              |
+| flutter_box_transform | [![Pub Version](https://img.shields.io/pub/v/flutter_box_transform?label=Pub)](https://pub.dev/packages/flutter_box_transform) | A Flutter implementation that provides a flexible, customizable and easy to use interface tailored for Flutter projects. |
 
 
 ## Features
 
 * 📏 **Dimension Constraining:** Set maximum and minimum constraints to keep boxes within specific boundaries while resizing.
 * 🔁 **Flipping Mechanics:** Advanced positional-flipping when resizing hits extreme values with hard constraints.
-* 🔒 **Drag Clamping:** Clamp boxes inside a parent box to contain them within a specific area.
+* 🔒 **Drag Clamping:** Specify clamping boxes to keep your transformable boxes within a specific region.
 * 🎨 **Flexible Resizing Modes:** Choose from four different resizing modes for more flexibility in how boxes are resized.
 * 📍 **Customizable Anchor Points:** Define resizing corner-handles to anchor different parts of the box when resizing.
 * 🎨 **Customizable Handles:** Use default resizing handles or define your own custom handles.
-* 🚀 **Easy Integration:** Integrate Box Transform into your dart or flutter project with ease.
+* 🚀 **Easy Integration:** Integrate Box Transform into your Dart or Flutter project with ease.
 
 ## Getting Started
 
@@ -52,6 +52,8 @@ See [DEVELOPMENT.md][development] for development setup.
   </tr>
 </table>
 
+Feel free to join our Discord server for any inquiries or support: https://discord.gg/yrahEhCqTJ
+
 ## License
 
 ```

docs/flutter_controller.mdx

@@ -4,17 +4,20 @@ title: Using a controller
 
 ## Using a controller
 
-`TransformableBox` can use a controller if provided. This is the most flexible method and allows you to
-control the transformable box externally with proper state management.
+`TransformableBox` uses a controller pattern. This is the most flexible pattern and allows you to control the
+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`, `handleGestureResponseDiameter` and
-`handleRenderedDiameter` since these are accessibility and rendering specific features.
+in the constructor excluding `contentBuilder`, `handleBuilder`, and `handleTapSize` since these are accessibility and
+rendering features.
 
-<Warning>When using a controller, you should not use the following parameters: **_box_**, **_flip_**, **_clampingBox_**, **_constraints_**,
-and **_resolveResizeModeCallback_**. These are all intrinsically managed by the controller.</Warning>
+<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.
 
-Initialize a controller and provide.
+There must always be only one source of truth, either the `TransformableBox` or the `TransformableBoxController`, not both.</Warning>
+
+Initialize a controller like so:
 
 ```dart title="Initializing a controller"
   late final TransformableBoxController controller;
@@ -57,7 +60,7 @@ Remove the listener when no longer needed.
 
 ```dart title="Removing a listener"
   controller.removeListener(onControllerChanged);
-``` 
+```
 ### Setting constraints
 
 You can set constraints on the controller using the `setConstraints` method.
@@ -81,8 +84,8 @@ You can limit the movements of the controller using the `setClampingBox` method.
 
 ### Other things you can do with a controller
 
-Controller almost mirrors the constructor parameters. You can do things like setting rect, flip, constraints, 
-clampingRect, disabling resizing or moving, etc.
+The `TransformableBoxController` almost mirrors the constructor parameters of the `TransformableBox`. You can do things
+like setting a rect, flip, constraints, clampingRect, disabling resizing or moving, etc...
 
 ```dart title="Things controller can do"
 // Change current rect
@@ -102,4 +105,4 @@ controller.setFlipChild(false);
 
 // Disable flipping the rect while resizing
 controller.setFlipRectWhileResizing(false);
-```
+```

docs/flutter_get_started.mdx

@@ -6,7 +6,7 @@ title: Getting Started
 
 ## Installation
 
-Add this package as dependency in your `pubspec.yaml` file:
+Add this package to your dependencies in your `pubspec.yaml` file:
 
 ```dart
   dependencies:
@@ -19,12 +19,12 @@ or run following command in your project directory:
 ```
 
 ## Usage
-Wrap the widget you want to resize/move with `TransformableBox`. 
+Wrap the widget you want to resize or move with `TransformableBox`.
 
-<Warning>**_TransformableBox_** internally uses **_Positioned_** to place child at given position with given size. 
-So, **_TransformableBox_** must be a child of **_Stack_** widget.</Warning>
+<Warning>**_TransformableBox_** internally uses **_Positioned_** to place its content at a given position with a given
+size. So, **_TransformableBox_** must be a child of a **_Stack_** widget.</Warning>
 
-```dart title="Using as a widget"
+```dart title="Using TransformableBox inside a Stack"
   Stack(
     children: [
       TransformableBox(
@@ -51,9 +51,9 @@ So, **_TransformableBox_** must be a child of **_Stack_** widget.</Warning>
   );
 ```
 
-`onChanged` callback is called when user resizes/moves the box. You can use this callback to update the box by calling
+`onChanged` callback is called when user resizes or moves the box. You can use this callback to update the box by calling
 `setState` method explicitly.
 
-<Info>**_TransformableBox_** follows flutter widget pattern and does not store any state. So, you must store the box and 
-flip state in your widget state and pass it to **_TransformableBox_** as parameters. Don't forget to call **_setState_** 
-method to update the state.</Info>
+<Info>**_TransformableBox_** follows flutter's widget patterns by not storing any state. You must store the box and
+flip state by yourself in your widget's state class and pass it to **_TransformableBox_** as constructor parameters.
+Be sure to call **_setState_** to refresh the UI when changes occur.</Info>

docs/flutter_moving.mdx

@@ -4,7 +4,7 @@ title: Moving
 
 # Moving/Dragging
 
-`TransformableBox` can be used to move/drag a widget by default.
+`TransformableBox` allows moving/dragging/translating a widget by default.
 
 ```dart title="Moving a widget"
   Stack(
@@ -19,13 +19,14 @@ title: Moving
     ],
   );
 ```
-`onChanged` callback is called when user moves the box. You can use this callback to update the box by calling
-`setState` method explicitly. You can also use `TransformableBox.onMoved` callback to 
+`onMoved` callback is called when the user drags the box. You can use this callback to update the box by calling
+the `setState` method explicitly. You can also use `TransformableBox.onChanged` callback for a combined event that
+includes resizing in addition to moving/dragging.
 
 ## Limiting movements
 
-You can limit the movements by setting `TransformableBox.clampingBox` property. `clampingBox` takes a `Rect` that 
-defines the boundary for the box to move within.
+You can limit the allowed space the box can be moved within by setting `TransformableBox.clampingBox` property.
+`clampingBox` takes a `Rect` that defines a legal boundary that the box must stay inside.
 
 ```dart title="Limiting movements"
   TransformableBox(
@@ -38,12 +39,12 @@ defines the boundary for the box to move within.
   );
 ```
 
-This will limit the movements to a box of size `1000x1000` and centered at origin. If your `Stack` has a size, provide
-that size to `clampingBox` to allow movements only within the `Stack` boundary.
+This will limit the space the box can be move in to be inside an area of size `1000x1000` and centered at the origin.
+If your `Stack` has a size, provide that size to `clampingBox` to allow movements only within the `Stack` boundary.
 
 ## Disable movements
 
-Setting `TransformableBox.movable` to `false` will disable movements.
+Setting `TransformableBox.movable` to `false` will completely disable moving/dragging behavior.
 
 ```dart title="Disable moving"
   TransformableBox(

docs/flutter_resizing.mdx

@@ -4,7 +4,7 @@ title: Resizing
 
 # Resizing
 
-`TransformableBox` can be used to resize a widget by default. [Transformable Box][transformableBox] utilizes 
+`TransformableBox` is used to resize its content by default. [Transformable Box][transformableBox] utilizes
 [Box Transform][boxTransform] to create a fully-featured Flutter implementation of the [Box Transform][boxTransform] API.
 
 ```dart title="Resizable widget"
@@ -30,29 +30,31 @@ title: Resizing
   );
 ```
 
-<Info>**_onChanged_** callback is a general callback that is called whenever a change is made to the box. To listen to specific
-changes, you can use **_onResized_** and **_onMoved_** callbacks for resizing and moving respectively.</Info>
+<Info>The **_onChanged_** callback is a general callback that is called whenever a change is made to the box. To listen
+to specific changes, you can use **_onResized_** and **_onMoved_** callbacks for resizing and moving respectively.
 
-By default, resizing allows flipping the rect horizontally and vertically. Flipping is done by using the 
+There are also more granular callbacks if desired.</Info>
+
+By default, resizing allows flipping the rect horizontally and vertically. Flipping is done by using the
 `Transform.scale` widget with negative scale values.
 
 Resizing is freeform by default, meaning that the user can resize the box in any direction and in any size.
 
 ## Controlling Resize Modes
 
 The `resolveResizeModeCallback` 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 
+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 `defaultResolveResizeModeCallback` 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:
 
 1. ResizeMode.freeform: **Default** mode. When no keys are pressed.
 2. ResizeMode.scale: When `Shift` key is pressed.
-3. ResizeMode.symmetric: When `Alt` key is pressed.
-4. ResizeMode.symmetricScale: When both `Shift` and `Alt` keys are pressed.
+3. ResizeMode.symmetric: When `Alt` or `Option` key is pressed.
+4. ResizeMode.symmetricScale: When both `Shift` and `Alt`/`Option` keys are pressed.
 
 See [ResizeModes](/resize_modes) page for more information on the different resize modes.
 
@@ -68,17 +70,17 @@ resizing to your liking. This can also be used to allow only certain resize mode
     contentBuilder: (context, rect, flip) {...},
   );
 ```
-This will resize the box such that the **aspect ratio** is preserved.
+This will resize the box such that the **aspect ratio** is preserved at all times.
 
 ## Flipping
 
 By default, resizing allows flipping the rect horizontally and vertically. Flipping is done by using the
 `Transform.scale` widget with negative scale values internally. There are two kinds of flipping involved in resizing:
 
 ### Flipping the rect while resizing
-While resizing, the rect can be flipped horizontally and vertically whenever the
-user drags a handle beyond the opposite side of the rect. This allows more flexibility in resizing the box. However,
-this is not responsible for flipping the content of the box.
+While resizing, the rect can be flipped horizontally and vertically whenever the user drags a handle beyond the opposite
+side of the rect. This allows more freedom when resizing a box. However, this is not responsible for flipping the
+content of the box.
 
 This behavior can be disabled by setting `flipRectWhileResizing` to `false`.
 
@@ -93,26 +95,28 @@ This behavior can be disabled by setting `flipRectWhileResizing` to `false`.
 ```
 
 ### Flipping the content of the box
-This is done by using the `Transform.scale` widget with negative scale values. This
-is done to allow the content to be flipped horizontally and vertically. 
+This is done by using the `Transform.scale` widget with negative scale values. This is done to allow the content to be
+flipped horizontally and vertically.
 
-This behavior can be disabled by setting `flipChild` to `false`.
+This behavior can be disabled by setting `allowContentFlipping` to `false`.
 
 ```dart title="Disable flipping the child/content of the box"
   TransformableBox(
     rect: rect,
     flip: flip,
-    flipChild: false,
+    allowContentFlipping: false,
     onChanged: (event) {...},
     contentBuilder: (context, rect, flip) {...},
   );
 ```
 
-You can set both `flipRectWhileResizing` and `flipChild` to `false` to disable flipping completely.
+You can set both `flipRectWhileResizing` and `allowContentFlipping` to `false` to disable flipping completely.
+The result will be a box that stops shrinking once it reaches a size of zero, as if it hit a wall.
 
 ## Constraints
 
-Resizing can be constrained by providing `minSize` and `maxSize` using `constraints` property.
+Resizing can be constrained by providing any desirable combination of `minHeight`, `minWidth`, `maxHeight` and
+`maxWidth` using the `constraints` property.
 
 ```dart title="Resizable widget with constrained resizing"
   TransformableBox(
@@ -128,19 +132,25 @@ Resizing can be constrained by providing `minSize` and `maxSize` using `constrai
     contentBuilder: (context, rect, flip) {...},
   );
 ```
-This will allow resizing the box between 100x100 and 500x500 pixels.
+This will disallow the box from growing or shrinking beyond 100x100 and 500x500 pixels.
 
 ### Constraint callbacks
 
-You can register callbacks to listen to when the box reaches the minimum or maximum size. This is useful when you want
+You can listen to callbacks to listen to when the box reaches the minimum or maximum size. This is useful when you want
 to react to these events to show some UI indication like showing a message or changing border color.
 
-You can register `onTerminalSizeReached` callback to listen to when the box reaches the terminal size. This is useful
-when you want to show a message to the user that the box has reached the maximum size.
+You can listen to the `onTerminalSizeReached` callback to listen to when the box reaches some terminal size, vertically
+or horizontally to a minimum or maximum size. This is useful when you want to show a message to the user that the box
+has reached some resizing limit.
 
-<Info>A **terminal size** is a size that is either the **minimum** or **maximum** size of the box on either axis. 
-This can happen when the user tries to resize the box beyond the given **constraints** or the size reaches the 
-`clampingRect` size.</Info>
+<Info>A **terminal size** is a size that is either the **minimum** or **maximum** size of the box on either axis.
+    This can happen when the user tries to resize the box beyond the given **constraints** or the size reaches the
+    `clampingRect` size.</Info>
+
+There are more granular terminal callback functions if desired. You can use `onMinWidthReached`, `onMaxWidthReached`,
+`onMinHeightReached` and `onMaxHeightReached` callbacks to listen to the individual terminal size events.
+You can also use `onTerminalWidthReached` and `onTerminalHeightReached` to listen to combined terminal width and height
+events respectively.
 
 ```dart title="onTerminalSizeReached callback"
   TransformableBox(
@@ -165,13 +175,9 @@ This can happen when the user tries to resize the box beyond the given **constra
   );
 ```
 
-You can also use `onMinWidthReached`, `onMaxWidthReached`, `onMinHeightReached` and `onMaxHeightReached` callbacks to 
-listen to the individual terminal size events. You can also use `onTerminalWidthReached` and `onTerminalHeightReached` to listen
-to combined terminal width and height events respectively.
-
 ## Disable Resizing
 
-Resizing can be disabled by setting the `resizable` property to `false`.
+Resizing can be disabled completely by setting the `resizable` property to `false`.
 
 ```dart title="Resizable widget without resizing"
   TransformableBox(
@@ -184,4 +190,4 @@ Resizing can be disabled by setting the `resizable` property to `false`.
 ```
 
 [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
+[transformableBox]: https://github.com/hyper-designed/box_transform/blob/main/packages/flutter_box_transform/lib/src/transformable_box.dart