Fix Phalcon 5.15 runtime compatibility

Author: jturbide

src/Dispatcher/AbstractDispatcher.php

@@ -13,7 +13,50 @@
 
 namespace PhalconKit\Dispatcher;
 
+use Phalcon\Dispatcher\Exception as DispatcherException;
+
+/**
+ * Generic PhalconKit dispatcher helper.
+ *
+ * Native Phalcon 5.15 requires concrete dispatchers to implement the internal
+ * exception hooks used by the dispatch loop. MVC and CLI dispatchers keep their
+ * native specialized behavior; this generic wrapper provides a minimal
+ * concrete implementation so shared helper behavior can still be tested and
+ * used where no namespace-specific dispatcher is required.
+ */
 class AbstractDispatcher extends \Phalcon\Dispatcher\AbstractDispatcher implements DispatcherInterface
 {
     use DispatcherTrait;
+
+    /**
+     * Bubble user exceptions unchanged for the generic dispatcher wrapper.
+     *
+     * Namespace-specific dispatchers can route exceptions through their
+     * `dispatch:beforeException` event flow, but this base helper has no
+     * controller/task domain to recover through.
+     *
+     * @param \Exception $exception Exception raised during dispatch.
+     *
+     * @throws \Exception Always rethrows the original exception.
+     */
+    #[\Override]
+    protected function handleException(\Exception $exception): never
+    {
+        throw $exception;
+    }
+
+    /**
+     * Raise a generic dispatcher exception for base-wrapper dispatch failures.
+     *
+     * @param string $message Diagnostic failure message.
+     * @param int $exceptionCode Native dispatcher exception code.
+     *
+     * @throws DispatcherException Always throws the generated dispatcher
+     *     exception.
+     */
+    #[\Override]
+    protected function throwDispatchException(string $message, int $exceptionCode = 0): never
+    {
+        throw new DispatcherException($message, $exceptionCode);
+    }
 }

src/Translate/Adapter/NestedNativeArray.php

@@ -72,11 +72,6 @@ class NestedNativeArray extends AbstractAdapter implements \ArrayAccess
      */
     private array $translate = [];
 
-    /**
-     * Whether missing keys should throw instead of returning the original key.
-     */
-    private bool $triggerError = false;
-    
     /**
      * Delimiter used when resolving nested translation paths.
      *
@@ -100,7 +95,7 @@ public function __construct(InterpolatorFactory $interpolator, array $options)
     {
         parent::__construct($interpolator, $options);
         $this->delimiter = $options['delimiter'] ?? $this->delimiter ?: '.';
-        $this->triggerError = $options['triggerError'] ?? $this->triggerError;
+        $this->triggerError = (bool)($options['triggerError'] ?? $this->triggerError);
         $this->translate = $options['content'] ?? $this->translate;
     }
 
@@ -164,6 +159,7 @@ public function has(string $index): bool
      *
      * @throws RuntimeException When `triggerError` is true.
      */
+    #[\Override]
     public function notFound(string $index): string
     {
         if ($this->triggerError) {