prepare for 4.2.0

Author: steinkel

.semver

@@ -1,5 +1,5 @@
 ---
 :major: 4
-:minor: 0
+:minor: 2
 :patch: 0
 :special: ''

CHANGELOG.md

@@ -0,0 +1,35 @@
+# Changelog
+
+## 4.2.0 (2026-04-10)
+
+### New Features
+
+- **`SelectQueryFindListReturnTypeExtension`**: Provides proper return type inference for `find('list')->toArray()`, returning `array<int|string, string>` instead of the generic entity array type. Works with chained queries (`where()`, `orderBy()`, `limit()`, etc.).
+- **`groupField` support for `find('list')`**: When `groupField` is provided to `find('list')`, the return type is correctly inferred as `array<int|string, array<int|string, string>>`.
+- **Custom application namespace**: Support for defining a custom application namespace via the `cakeDC.appNamespace` configuration parameter (defaults to `App`).
+
+### Improvements
+
+- Made constructor dependency in rules/extensions optional to preserve backwards compatibility; instances self-instantiate if none is provided.
+
+## 4.1.1 (2025-11-13)
+
+### Improvements
+
+- `DisallowEntityArrayAccessRule`: ignore custom (non-integer) array access keys, allowing legitimate use cases.
+
+## 4.1.0
+
+### New Features
+
+- Added `ControllerMethodMustBeUsedRule`: enforces that `render()` and `redirect()` must be used (returned or assigned) to prevent unreachable code.
+
+## 4.0.0
+
+### Breaking Changes
+
+- Requires CakePHP 5.x and PHPStan 2.x.
+
+## 3.x
+
+See git history for older changes.

README.md

@@ -46,6 +46,27 @@ Features included:
 1. Provide correct return type for `Cake\Console\ConsoleIo::helper()`
 
 # Table class return type extensions
+### SelectQueryFindListReturnTypeExtension
+Provides proper return type for `find('list')->toArray()`:
+1. Returns `array<int|string, string>` for `find('list')->toArray()` instead of the generic entity array
+1. Returns `array<int|string, array<int|string, string>>` when `groupField` is provided
+1. Works with chained queries: `find('list')->where([...])->orderBy([...])->toArray()`
+
+<details>
+      <summary>Examples:</summary>
+
+```php
+  // PHPStan now knows the return type is array<int|string, string>
+  $roles = $this->Roles->find('list')->toArray();
+
+  // PHPStan now knows the return type is array<int|string, string> (chained)
+  $roles = $this->Roles->find('list')->where(['active' => true])->orderBy(['name' => 'ASC'])->toArray();
+
+  // PHPStan now knows the return type is array<int|string, array<int|string, string>> (grouped)
+  $roles = $this->Roles->find('list', groupField: 'category_id')->toArray();
+```
+</details>
+
 ### TableEntityDynamicReturnTypeExtension
 1. Provide correct return type for `Cake\ORM\Table::get` based on your table class name
 1. Provide correct return type for `Cake\ORM\Table::newEntity` based on your table class name
@@ -216,6 +237,20 @@ parameters:
 	 	addAssociationExistsTableClassRule: false
 ```
 
+# Configuration
+
+### Custom application namespace
+
+By default, this extension assumes your application uses the `App` namespace. If your application uses a custom namespace, configure it with the `appNamespace` parameter:
+
+```
+parameters:
+    cakeDC:
+        appNamespace: MyApp
+```
+
+This affects class resolution in rules and type extensions (e.g. `MyApp\Model\Table\UsersTable` instead of `App\Model\Table\UsersTable`).
+
 # PHPDoc Extensions
 ### TableAssociationTypeNodeResolverExtension
 Fix intersection association phpDoc to correct generic object type, ex: