Update README.md

Author: andrey-helldar

README.md

@@ -143,6 +143,92 @@ ascending order:
 3 - 5 - 1 - 2 - 4
 ```
 
+### Custom Column
+
+When working with an array of objects, you can specify which value can be used for sorting.
+
+```php
+use DragonCode\SizeSorter\SizeSorter;
+
+return new SizeSorter($items)
+    ->column('foo')
+    ->sort();
+```
+
+You can also use "dotted" notation:
+
+```php
+use DragonCode\SizeSorter\SizeSorter;
+
+$items = [
+    [
+        'foo' => [
+            'bar' => [
+                'baz' => 'Some value',
+            ]
+        ]
+    ]
+];
+
+return new SizeSorter($items)
+    ->column('foo.bar.baz')
+    ->sort();
+```
+
+And you can use the callback function in the same way:
+
+```php
+use DragonCode\SizeSorter\SizeSorter;
+
+class Foo
+{
+    public function __construct(
+        public int $number,
+        public string $value1,
+        public string $value2,
+    ) {}
+}
+
+$items = [
+    new Foo(1, 'first 1', 'first 2'),
+    new Foo(2, 'second 1', 'second 2'),
+];
+
+return new SizeSorter($items)
+    ->column(function (Foo $item) {
+        return $item->number % 2 === 0
+            ? $item->value1
+            : $item->value2;
+    })
+    ->sort();
+```
+
+And this is also possible:
+
+```php
+use DragonCode\SizeSorter\SizeSorter;
+
+$items = [
+    ['foo' => 'XS'],
+    ['foo' => '2XS'],
+    ['foo' => '3XL'],
+];
+
+return new SizeSorter($items)
+    ->column(function (array $item) {
+        return match ($item['foo']) {
+            '2XS' => 'XXS',
+            '3XL' => 'XXXL',
+            default => $item['foo']
+        };
+    })
+    ->sort();
+```
+
+## Upgrade Guide
+
+You can find the upgrade documentation [here](UPGRADE.md).
+
 ## License
 
 This package is licensed under the [MIT License](LICENSE).

UPGRADE.md

@@ -0,0 +1,67 @@
+# Upgrade Guide
+
+## To 2.x from 1.0
+
+### Updating Dependencies
+
+You should update the following dependencies in your application's `composer.json` file:
+
+- `dragon-code/size-sorter` to `^2.0`
+
+### Changing Namespace
+
+Namespace should be changed:
+
+You should update the namespace and method name to call:
+
+```diff
+-DragonCode\SizeSorter\Sorter::sort()
++DragonCode\SizeSorter\SizeSorter::items()
+
+-use DragonCode\SizeSorter\Enum\Group;
++use DragonCode\SizeSorter\Enums\GroupEnum;
+```
+
+### Changing parameters and call methods
+
+```diff
+-use DragonCode\SizeSorter\Sorter;
+-use DragonCode\SizeSorter\Enum\Group;
++use DragonCode\SizeSorter\SizeSorter;
++use DragonCode\SizeSorter\Enums\GroupEnum;
+
+-$sort1 = Sorter::sort($items, 'column.name', [1, 2]);
+-$sort2 = Sorter::sort($items, 'column.name', [Group::GROUP_1, Group::GROUP_2]);
++
++$sort = SizeSorter::items($items)
++    ->column('column.name')
++    ->orderBy([
++        GroupEnum::LetterClothingSize,
++        GroupEnum::ClothesAndShoes,
++    ])
++    ->sort();
+```
+
+### Groups
+
+> [!WARNING]
+>
+> The array to sort must now consist of GroupEnum objects.
+> Integers are no longer accepted.
+
+'Group::GROUP_1' replaced by `GroupEnum::LetterClothingSize`
+'Group::GROUP_2' replaced by `GroupEnum::ClothesAndShoes`
+'Group::GROUP_3' replaced by `GroupEnum::BraSize`
+'Group::GROUP_4' replaced by `GroupEnum::OverallDimensions`
+'Group::GROUP_5' replaced by `GroupEnum::OtherSizes`
+
+```php
+enum GroupEnum: int
+{
+    case LetterClothingSize = 1;
+    case ClothesAndShoes    = 2;
+    case BraSize            = 3;
+    case OverallDimensions  = 4;
+    case OtherSizes         = 5;
+}
+```