Add SelectQueryFindListReturnTypeExtension for find('list')->toArray()

[dereuromark]

Summary

This PR adds a PHPStan dynamic return type extension that provides proper type inference for find('list')->toArray().

Problem

Currently, when using find('list'), PHPStan infers the return type as array<array|EntityInterface>, but find('list') actually returns array<int|string, string>. This causes developers to need @var annotations:

/** @var array<int, string> $roles */
$roles = $this->Roles->find('list', fields: ['uuid'])->toArray();

Without the annotation, PHPStan reports varTag.type errors.

Solution

The SelectQueryFindListReturnTypeExtension detects find('list') in the method call chain before toArray() and returns the correct type array<int|string, string>.

Features:

• Detects find('list') anywhere in the method chain
• Works with chained queries: find('list')->where([...])->orderBy([...])->toArray()
• Returns null for non-list finders to preserve default behavior

Tests

Added test cases for:

• Basic find('list')->toArray() usage
• Chained method calls (where, orderBy, limit)
• Verification that values are correctly typed as strings

Example

Before (with annotation):

/** @var array<int, string> $list */
$list = $table->find('list')->toArray();

After (no annotation needed):

$list = $table->find('list')->toArray();
// PHPStan knows this is array<int|string, string>

[dereuromark]

"The job was not started because your account is locked due to a billing issue"

[steinkel]

let me check that...

[rochamarcelo]

It looks good.

Have you checked what happens when groupField is used $table->find('list', groupField: 'category_id'); ? We probably should handle that too.

[steinkel]

let me check that...

fixed

[dereuromark]

The phpstan fail is not mine, and fixing it would require 5.3+ bump or silencing.
I opened a ticket for now: #65

[dereuromark]

@rochamarcelo Both ways are now supported.