Add CHANGELOG entry and documentation for ToArrayOfIntegers

- Added CHANGELOG entry for new ToArrayOfIntegers parameter attribute
- Added English documentation in docs/guide/en/typecasting.md
- Added Russian documentation in docs/guide/ru/typecasting.md

Co-authored-by: samdark <47294+samdark@users.noreply.github.com>

Author: Copilot

CHANGELOG.md

@@ -2,7 +2,7 @@
 
 ## 1.6.4 under development
 
-- no changes in this release.
+- New #116: Add `ToArrayOfIntegers` parameter attribute (@samdark)
 
 ## 1.6.3 December 16, 2025
 

docs/guide/en/typecasting.md

@@ -240,3 +240,21 @@ Attribute parameters:
 - `splitResolvedValue` — split resolved value by separator (boolean, default `true`);
 - `separator` — the boundary string (default, `\R`), it's a part of regular expression so should be taken into account 
   or properly escaped with `preg_quote()`.
+
+### `ToArrayOfIntegers`
+
+Use `ToArrayOfIntegers` attribute to cast a value to an array of integers:
+
+```php
+use Yiisoft\Hydrator\Attribute\Parameter\ToArrayOfIntegers;
+
+final class Post
+{
+    #[ToArrayOfIntegers]
+    public array $ratings = [];    
+}
+```
+
+If the resolved value is iterable, each element will be cast to an integer. For example, array `['1', '2', '3']` will be
+converted to `[1, 2, 3]`. If the resolved value is not iterable, it will be cast to an integer and wrapped in an array.
+For example, string `'42'` will be converted to `[42]`.

docs/guide/ru/typecasting.md

@@ -253,3 +253,23 @@ final class Post
 - `separator` — символ перевода строки (по умолчанию, `\R`). Это часть
   регулярного выражения, поэтому ее следует учитывать или правильно
   экранировать с помощью `preg_quote()`.
+
+### `ToArrayOfIntegers`
+
+Используйте атрибут `ToArrayOfIntegers` для приведения значения к массиву
+целых чисел:
+
+```php
+use Yiisoft\Hydrator\Attribute\Parameter\ToArrayOfIntegers;
+
+final class Post
+{
+    #[ToArrayOfIntegers]
+    public array $ratings = [];    
+}
+```
+
+Если разрешенное значение является итерируемым, каждый элемент будет приведен к целому числу.
+Например, массив `['1', '2', '3']` будет преобразован в `[1, 2, 3]`. Если разрешенное значение не
+является итерируемым, оно будет приведено к целому числу и обернуто в массив. Например, строка
+`'42'` будет преобразована в `[42]`.