From 86b9e4fa4a2dcb59a14b83749f17fa7ac25c838b Mon Sep 17 00:00:00 2001
From: Giuseppe Criscione <18699708+giuscris@users.noreply.github.com>
Date: Sun, 6 Sep 2026 21:59:32 +0200
Subject: [PATCH 1/2] Add context information to `Debug::dump()`

---
 formwork/src/Debug/Debug.php | 38 +++++++++++++++++++++++++++++++++++-
 1 file changed, 37 insertions(+), 1 deletion(-)

diff --git a/formwork/src/Debug/Debug.php b/formwork/src/Debug/Debug.php
index b40591055..3cca4d096 100644
--- a/formwork/src/Debug/Debug.php
+++ b/formwork/src/Debug/Debug.php
@@ -18,6 +18,12 @@ final class Debug
      */
     private const int INDENT_SPACES = 2;
 
+    /**
+     * Maximum number of stack frames to include in the backtrace to get context
+     * (adjust according to the maximum nesting depth of the call to `getContext()`)
+     */
+    private const int BACKTRACE_LIMIT = 3;
+
     /**
      * CSS styles for debug output
      */
@@ -35,6 +41,12 @@ final class Debug
             overflow-x: auto;
         }
 
+        .__formwork-dump-item + .__formwork-dump-item {
+            border-top: 1px dashed #ccc;
+            margin-top: 8px;
+            padding-top: 8px;
+        }
+
         .color-scheme-dark .__formwork-dump {
             background-color: #333;
             color: #f0f0f0;
@@ -231,9 +243,19 @@ public static function dump(mixed ...$data): void
             echo '<style>' . self::$css . '</style>', '<script>' . self::$js . '</script>';
             self::$stylesDumped = true;
         }
+        echo '<pre class="__formwork-dump">';
+        if ($info = self::getContext()) {
+            echo sprintf(
+                '<div class="__formwork-dump-item"><span class="__type-name" title="%s">%s</span>, line <span class="__type-number">%d</span></div>',
+                $info['file'],
+                basename($info['file']),
+                $info['line']
+            );
+        }
         foreach ($data as $d) {
-            echo self::dumpToString($d);
+            echo sprintf('<div class="__formwork-dump-item">%s</div>', self::outputData($d));
         }
+        echo '</pre>';
         echo '<script>__formwork_dump_goto(window.location.hash.slice(1))</script>';
     }
 
@@ -422,4 +444,18 @@ private static function outputData(mixed $data, int $indent = 0): string
 
         throw new UnexpectedValueException('Unexpected value for debug');
     }
+
+    /**
+     * @return ?array{file: string, line: int}
+     */
+    private static function getContext(): ?array
+    {
+        $backtrace = debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, self::BACKTRACE_LIMIT);
+        foreach ($backtrace as $frame) {
+            if (isset($frame['file'], $frame['line']) && $frame['file'] !== __FILE__) {
+                return ['file' => $frame['file'], 'line' => $frame['line']];
+            }
+        }
+        return null;
+    }
 }

From 4ea91fe54f8d0f308e434f2c258afc8ef5fd5b39 Mon Sep 17 00:00:00 2001
From: Giuseppe Criscione <18699708+giuscris@users.noreply.github.com>
Date: Sun, 6 Sep 2026 22:01:48 +0200
Subject: [PATCH 2/2] Dump data only if the client explicitly accepts HTML

---
 formwork/src/Debug/Debug.php | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/formwork/src/Debug/Debug.php b/formwork/src/Debug/Debug.php
index 3cca4d096..5ee8da242 100644
--- a/formwork/src/Debug/Debug.php
+++ b/formwork/src/Debug/Debug.php
@@ -236,6 +236,10 @@ function __formwork_dump_goto(target) {
      */
     public static function dump(mixed ...$data): void
     {
+        // Dump data only if the client explicitly accepts HTML
+        if (!str_contains($_SERVER['HTTP_ACCEPT'] ?? '*/*', 'text/html')) {
+            return;
+        }
         if (!headers_sent()) {
             ob_start();
         }