tyrsson · Oct 10, 2026 · Oct 8, 2026 · Oct 8, 2026 · Oct 8, 2026 · Oct 8, 2026
diff --git a/analysis-baseline.toml b/analysis-baseline.toml
@@ -6,12 +6,6 @@ code = "falsable-return-statement"
 message = '''Function `PhpDb\Mysql\AdapterPlatform::quoteViaDriver` is declared to return `null|string` but possibly returns 'false' (inferred as `false|string`).'''
 count = 1
 
-[[issues]]
-file = "src/AdapterPlatform.php"
-code = "impossible-condition"
-message = "This condition (type `false`) will always evaluate to false."
-count = 1
-
 [[issues]]
 file = "src/AdapterPlatform.php"
 code = "invalid-return-statement"
@@ -30,12 +24,6 @@ code = "possibly-invalid-argument"
 message = 'Possible argument type mismatch for argument #1 of `PhpDb\Mysql\AdapterPlatform::quoteViaDriver`: expected `string`, but possibly received `bool|float|int|string`.'
 count = 1
 
-[[issues]]
-file = "src/Connection.php"
-code = "incompatible-property-type"
-message = 'Property `PhpDb\Mysql\Connection::$resource` has an incompatible type declaration from docblock.'
-count = 1
-
 [[issues]]
 file = "src/Connection.php"
 code = "invalid-iterator"
@@ -135,7 +123,7 @@ count = 1
 [[issues]]
 file = "src/Connection.php"
 code = "mixed-return-statement"
-message = "Could not infer a precise return type for function `{closure:src/Connection.php:118:31}`. Saw type `nonnull`."
+message = "Could not infer a precise return type for function `{closure:src/Connection.php:119:31}`. Saw type `nonnull`."
 count = 1
 
 [[issues]]
@@ -258,12 +246,6 @@ code = "mixed-argument"
 message = 'Invalid argument type for argument #1 of `PhpDb\Mysql\Statement::__construct`: expected `bool`, but found `nonnull`.'
 count = 1
 
-[[issues]]
-file = "src/Driver.php"
-code = "docblock-type-mismatch"
-message = "Docblock type mismatch for variable `$resource`."
-count = 1
-
 [[issues]]
 file = "src/Driver.php"
 code = "incompatible-parameter-type"
@@ -456,42 +438,6 @@ code = "unused-property"
 message = "Property `$numberOfRows` is never used."
 count = 1
 
-[[issues]]
-file = "src/Sql/SelectDecorator.php"
-code = "invalid-property-assignment-value"
-message = "Invalid type for property `$specifications`: expected `array<array-key, array<array-key, mixed>>|array<array-key, string>`, but got `array{'limit': string('LIMIT 18446744073709551615'), ...<array-key, array<array-key, mixed>>}|array{'limit': string('LIMIT 18446744073709551615'), ...<array-key, string>}`."
-count = 1
-
-[[issues]]
-file = "src/Sql/SelectDecorator.php"
-code = "invalid-return-statement"
-message = 'Invalid return type for function `PhpDb\Mysql\Sql\SelectDecorator::processLimit`: expected `array<array-key, string>|null`, but found `list{int|string}`.'
-count = 1
-
-[[issues]]
-file = "src/Sql/SelectDecorator.php"
-code = "invalid-return-statement"
-message = 'Invalid return type for function `PhpDb\Mysql\Sql\SelectDecorator::processOffset`: expected `array<array-key, string>|null`, but found `list{int|string}`.'
-count = 1
-
-[[issues]]
-file = "src/Sql/SelectDecorator.php"
-code = "less-specific-nested-return-statement"
-message = '''Returned type `list{mixed}` is less specific than the declared return type `array<array-key, string>|null` for function `PhpDb\Mysql\Sql\SelectDecorator::processLimit` due to nested 'mixed'.'''
-count = 1
-
-[[issues]]
-file = "src/Sql/SelectDecorator.php"
-code = "less-specific-nested-return-statement"
-message = '''Returned type `list{mixed}` is less specific than the declared return type `array<array-key, string>|null` for function `PhpDb\Mysql\Sql\SelectDecorator::processOffset` due to nested 'mixed'.'''
-count = 1
-
-[[issues]]
-file = "src/Sql/SelectDecorator.php"
-code = "possible-method-access-on-null"
-message = "Attempting to call a method on `null`."
-count = 2
-
 [[issues]]
 file = "src/Sql/SelectDecorator.php"
 code = "write-only-property"

diff --git a/composer.lock b/composer.lock
diff --git a/src/Connection.php b/src/Connection.php
@@ -15,6 +15,7 @@
 use PhpDb\Adapter\Driver\ResultInterface;
 use PhpDb\Adapter\Exception;
 use PhpDb\Adapter\Exception\InvalidArgumentException;
+use PhpDb\Exception\ExceptionInterface as PhpDbExceptionInterface;
 
 use function constant;
 use function defined;
@@ -64,7 +65,7 @@ public function __construct(
     /**
      * @inheritDoc
      *
-     * @throws Exception\ExceptionInterface
+     * @throws PhpDbExceptionInterface
      */
     #[Override]
     public function beginTransaction(): ConnectionInterface
@@ -82,7 +83,7 @@ public function beginTransaction(): ConnectionInterface
     /**
      * @inheritDoc
      *
-     * @throws Exception\ExceptionInterface
+     * @throws PhpDbExceptionInterface
      */
     #[Override]
     public function commit(): ConnectionInterface
@@ -101,7 +102,7 @@ public function commit(): ConnectionInterface
     /**
      * @inheritDoc
      *
-     * @throws Exception\ExceptionInterface
+     * @throws PhpDbExceptionInterface
      */
     // @mago-expect lint:halstead
     #[Override]
@@ -207,7 +208,7 @@ public function disconnect(): ConnectionInterface
     /**
      * {@inheritDoc}
      *
-     * @throws Exception\ExceptionInterface
+     * @throws PhpDbExceptionInterface
      */
     #[Override]
     public function execute(string $sql): ?ResultInterface
@@ -241,7 +242,7 @@ public function execute(string $sql): ?ResultInterface
     /**
      * @inheritDoc
      *
-     * @throws Exception\ExceptionInterface
+     * @throws PhpDbExceptionInterface
      */
     #[Override]
     public function getCurrentSchema(): string|false
@@ -287,7 +288,7 @@ public function isConnected(): bool
     /**
      * @inheritDoc
      *
-     * @throws Exception\ExceptionInterface
+     * @throws PhpDbExceptionInterface
      */
     #[Override]
     public function rollback(): ConnectionInterface

diff --git a/src/Container/ConnectionInterfaceFactory.php b/src/Container/ConnectionInterfaceFactory.php
@@ -6,6 +6,7 @@
 
 use PhpDb\Adapter\Driver\ConnectionInterface;
 use PhpDb\Adapter\Exception\InvalidConnectionParametersException;
+use PhpDb\Exception\ExceptionInterface as PhpDbExceptionInterface;
 use PhpDb\Mysql\Connection;
 use Psr\Container\ContainerInterface;
 
@@ -16,7 +17,7 @@ final class ConnectionInterfaceFactory
     /**
      * @param array<string, mixed>|null $options
      *
-     * @throws \PhpDb\Adapter\Exception\ExceptionInterface
+     * @throws PhpDbExceptionInterface
      *
      * @mago-expect analysis:unused-parameter
      */

diff --git a/src/Container/DriverInterfaceFactory.php b/src/Container/DriverInterfaceFactory.php
@@ -8,6 +8,7 @@
 use PhpDb\Adapter\Driver\DriverInterface;
 use PhpDb\Adapter\Driver\ResultInterface;
 use PhpDb\Exception\ContainerException;
+use PhpDb\Exception\ExceptionInterface as PhpDbExceptionInterface;
 use PhpDb\Mysql\Connection;
 use PhpDb\Mysql\Driver;
 use PhpDb\Mysql\Result;
@@ -24,7 +25,7 @@
      * @throws \Laminas\ServiceManager\Exception\ExceptionInterface
      * @throws \Psr\Container\ContainerExceptionInterface
      * @throws \Psr\Container\NotFoundExceptionInterface
-     * @throws \PhpDb\Exception\ExceptionInterface
+     * @throws PhpDbExceptionInterface
      *
      * @mago-expect analysis:unused-parameter
      */
@@ -45,7 +46,7 @@

        $statementInstance = $container->build(
            Statement::class,
            $options['options'] ?? [],
        );

        /** @var ResultInterface&Result $resultInstance */

diff --git a/src/Container/PdoConnectionInterfaceFactory.php b/src/Container/PdoConnectionInterfaceFactory.php
@@ -6,6 +6,7 @@
 
 use PhpDb\Adapter\Driver\PdoConnectionInterface;
 use PhpDb\Adapter\Exception\InvalidConnectionParametersException;
+use PhpDb\Exception\ExceptionInterface as PhpDbExceptionInterface;
 use PhpDb\Mysql\Pdo\Connection;
 use Psr\Container\ContainerInterface;
 
@@ -16,7 +17,7 @@ final class PdoConnectionInterfaceFactory
     /**
      * @param array<string, mixed>|null $options
      *
-     * @throws \PhpDb\Adapter\Exception\ExceptionInterface
+     * @throws PhpDbExceptionInterface
      *
      * @mago-expect analysis:unused-parameter
      */

diff --git a/src/Driver.php b/src/Driver.php
@@ -15,6 +15,7 @@
 use PhpDb\Adapter\Exception;
 use PhpDb\Adapter\Profiler\ProfilerAwareInterface;
 use PhpDb\Adapter\Profiler\ProfilerInterface;
+use PhpDb\Exception\ExceptionInterface as PhpDbExceptionInterface;
 
 use function array_intersect_key;
 use function extension_loaded;
@@ -32,7 +33,7 @@ final class Driver implements DriverInterface, ProfilerAwareInterface
     /**
      * @param array<string, mixed> $options
      *
-     * @throws \PhpDb\Exception\ExceptionInterface
+     * @throws PhpDbExceptionInterface
      */
     public function __construct(
         protected readonly ConnectionInterface&Connection $connection,
@@ -79,7 +80,7 @@ public function createResult($resource, ?bool $isBuffered = null): ResultInterfa
      *
      * @param mysqli|mysqli_stmt|string $sqlOrResource
      *
-     * @throws Exception\ExceptionInterface
+     * @throws PhpDbExceptionInterface
      */
     #[Override]
     public function createStatement($sqlOrResource = null): StatementInterface&Statement

diff --git a/src/Pdo/Connection.php b/src/Pdo/Connection.php
@@ -11,6 +11,7 @@
 use PhpDb\Adapter\Driver\ConnectionInterface;
 use PhpDb\Adapter\Driver\Pdo\AbstractPdoConnection;
 use PhpDb\Adapter\Exception;
+use PhpDb\Exception\ExceptionInterface as PhpDbExceptionInterface;
 
 use function array_diff_key;
 use function implode;
@@ -143,7 +144,7 @@ public function connect(): ConnectionInterface
     /**
      * {@inheritDoc}
      *
-     * @throws Exception\ExceptionInterface
+     * @throws PhpDbExceptionInterface
      * @throws PDOException
      */
     #[Override]
@@ -187,7 +188,7 @@ public function getLastGeneratedValue(?string $name = null): string|int|false|nu
      * Return a value that is safe to interpolate into a generated DSN.
      *
      * @todo Promote to AbstractPdoConnection in php-db/phpdb as a protected method once a second
-     *       PDO driver package needs it — the validation is generic to all semicolon-delimited
+     *       PDO driver package needs it; the validation is generic to all semicolon-delimited
      *       PDO DSN formats and has no MySQL-specific dependencies.
      *
      * @throws Exception\InvalidConnectionParametersException If the value contains DSN control characters.

diff --git a/src/Result.php b/src/Result.php
@@ -11,6 +11,7 @@
 use Override;
 use PhpDb\Adapter\Driver\ResultInterface;
 use PhpDb\Adapter\Exception;
+use PhpDb\Exception\ExceptionInterface as PhpDbExceptionInterface;
 use PhpDb\ResultSet\ResultSet;
 use PhpDb\ResultSet\ResultSetInterface;
 // phpcs:ignore SlevomatCodingStandard.Namespaces.UnusedUses.UnusedUse
@@ -91,7 +92,7 @@ public function count()
     /**
      * Current
      *
-     * @throws Exception\ExceptionInterface
+     * @throws PhpDbExceptionInterface
      *
      * @return array<array-key, mixed>|null
      */
@@ -277,7 +278,7 @@ public function rewind()
     /**
      * Valid
      *
-     * @throws Exception\ExceptionInterface
+     * @throws PhpDbExceptionInterface
      *
      * @return bool
      */

diff --git a/src/Sql/Ddl/AlterTableDecorator.php b/src/Sql/Ddl/AlterTableDecorator.php
@@ -30,7 +30,7 @@ public function setSubject(
     }
 
     /**
-     * @return array<int, array<int|string, string>>
+     * @return array{0: list<string>}
      */
     #[Override]
     protected function processAddColumns(?PlatformInterface $adapterPlatform = null): array
@@ -43,11 +43,10 @@ protected function processAddColumns(?PlatformInterface $adapterPlatform = null)
         /** @var array<array-key, ColumnInterface> $addColumns */
         $addColumns = $this->addColumns;
 
-        foreach ($addColumns as $i => $column) {
-            /** @var array<string, mixed> $options */
+        foreach ($addColumns as $column) {
             $options = $column->getOptions();
 
-            $sqls[$i] = $this->processColumnOptions(
+            $sqls[] = $this->processColumnOptions(
                 $this->processExpression($column, $platform),
                 $options,
                 $platform,
@@ -69,11 +68,9 @@ protected function processChangeColumns(?PlatformInterface $adapterPlatform = nu
 
         $sqls = [];
 
-        /** @var array<string, ColumnInterface> $changeColumns */
         $changeColumns = $this->changeColumns;
 
         foreach ($changeColumns as $name => $column) {
-            /** @var array<string, mixed> $options */
             $options = $column->getOptions();
 
             $sqls[] = [

diff --git a/src/Sql/Ddl/CreateTableDecorator.php b/src/Sql/Ddl/CreateTableDecorator.php
@@ -48,7 +48,6 @@ protected function processColumns(?PlatformInterface $adapterPlatform = null): ?
         $columns = $this->columns;
 
         foreach ($columns as $i => $column) {
-            /** @var array<string, mixed> $options */
             $options = $column->getOptions();
 
             $sqls[$i] = $this->processColumnOptions(