Finalized release

Author: ringunger

CHANGELOG.md

@@ -1,3 +1,24 @@
+## v1.0.4 (2025-03-22)
+### Added
+* Support for IDs: Added support for adding `id` attributes to the selectable items using the `withId` method.
+
+### Improved
+* `withDataAttribute` method: Added support for passing a Closure to the `withDataAttribute` method to generate the data attribute value dynamically.
+* `withClass` method: Added support for passing an array of classes to the `withClass` method to add multiple classes to the selectable items.
+* Performance optimization option rendering 
+
+## v1.0.3 (2024-11-09)
+### Added
+* Support for non-object (array) collections
+
+### Added
+* Support for IDs: Added support for adding IDs to the selectable items using the `withId` method.
+
+
+## v1.0.2 (2024-07-02)
+### Added
+* Introduced custom IDE helper file
+
 ## v1.0.1 (2024-05-21)
 
 ### Added

README.md

@@ -116,21 +116,22 @@ other than '`active`', and a custom class '`form-option custom`' will be applied
 
 #### Available methods
 
-- `withLabel(string|callable $label)`: This method allows you to customize the label for each option. A string will be
-  used as the collection field from which the label will be generated, while a callable will be used to generate the
+- `withLabel(string|Closure $label)`: This method allows you to customize the label for each option. A string will be
+  used as the collection field from which the label will be generated, while a Closure will be used to generate the
   label.
-- `withValue(string|callable $value)`: This method allows you to customize the value for each option. A string will be
-  used as the collection field from which the value will be generated, while a callable will be used to generate the
+- `withValue(string|Closure $value)`: This method allows you to customize the value for each option. A string will be
+  used as the collection field from which the value will be generated, while a Closure will be used to generate the
   value.
-- `withSelected(mixed|callable $selected)`: This method allows you to customize the selected options. Can be
-  a `string`, `int`, an array of `string`/`int`, a `model` or a callable that returns a boolean value.
-- `withDisabled(mixed|callable $disabled)`: This method allows you to customize the disabled options. Can be
-  a `string`, `int`, an array of `string`/`int`, a `model` or a callable that returns a boolean value.
-- `withDataAttribute(string $attribute, mixed|callable $value)`: This method allows you to add a data attribute to each
-  option.
-- `withClass(string $class)`: This method allows you to add a class to each option.
-- `toSelectItems()`: This method converts the selectable collection to an array of selectable items. Useful for Ajax
-  responses or SPA.
+- `withSelected(mixed|Closure $selected)`: This method allows you to customize the selected options. Can be
+  a `string`, `int`, an array of `string`/`int`, a `model` or a `Closure` that returns a `boolean` value.
+- `withDisabled(mixed|Closure $disabled)`: This method allows you to customize the disabled options. Can be
+  a `string`, `int`, an array of `string`/`int`, a `model` or a `Closure` that returns a `boolean` value.
+- `withDataAttribute(string|Closure $attribute, mixed|Closure $value)`: This method allows you to add a data attribute to each
+  option. The first parameter can be a `string` or a `Closure` that returns a `string` which will be attached as `data-{attribute}="{value}"` to the option. The second parameter can be any type convertable to a string or a `Closure` that returns a `string`.
+- `withId(string|Closure $id)`: This method allows you to add an `id` attribute to each option. The value can be a `Closure` that returns a unique `string` for each option.
+- `withClass(string|array|Closure $class)`: This method allows you to add a class to each option. The value can be a `string` or an `array` of `string` or a `Closure` that returns a `string`.
+- `toSelectItems()`: This method converts the selectable collection to an `array` of selectable items. Useful for Ajax
+  responses or SPAs.
 - `toSelectOptions()`: This method converts the selectable collection to an HTML select options string.
 - Some of the methods from `Illuminate\Support\Collection` are also available including `groupBy()`.
 
@@ -149,7 +150,7 @@ You can work with collections of non-object arrays both flat and associative
 ```
 
 
-##  Get Selectable Items
+##  Getting Selectable Items
 ```php
     $selectableItems = \App\Models\User::all()->toSelectable()->toSelectItems();
 ```
@@ -173,7 +174,7 @@ Single Page Applications (SPAs).
 
 
 ## Testing
-
+To run tests, run the following command:
 ```bash
 composer test
 ```