Add trap()->context() method with context mapping

src/Client/TrapHandle.php

@@ -133,6 +133,35 @@ public function return(int|string $key = 0): mixed
         return $this->values[$k];
     }
 
+    /**
+     * Add dynamic context to the dumped data.
+     * The method merges new values with the existing ones using the {@see \array_merge()} function.
+     *
+     * There are two ways to add context:
+     *
+     * 1. Use named arguments:
+     * ```php
+     * trap($phpCode)->context(language: 'php');
+     * ```
+     *
+     * 2. Use array:
+     * ```php
+     * trap()->context(['foo bar', => 42, 'baz' => 69]);
+     * ```
+     *
+     * @param mixed ...$values
+     */
+    public function context(mixed ...$values): self
+    {
+        if (\array_keys($values) === [0] && \is_array($values[0])) {
+            $this->staticState->dataContext = \array_merge($this->staticState->dataContext, $values[0]);
+            return $this;
+        }
+
+        $this->staticState->dataContext = \array_merge($this->staticState->dataContext, $values);
+        return $this;
+    }
+
     public function __destruct()
     {
         $this->haveToSend() and $this->sendDump();

src/Client/TrapHandle/Dumper.php

@@ -9,7 +9,6 @@
 use Symfony\Component\HttpFoundation\RequestStack;
 use Symfony\Component\HttpKernel\Debug\FileLinkFormatter;
 use Symfony\Component\VarDumper\Caster\ReflectionCaster;
-use Symfony\Component\VarDumper\Cloner\DumperInterface;
 use Symfony\Component\VarDumper\Cloner\VarCloner;
 use Symfony\Component\VarDumper\Dumper\CliDumper;
 use Symfony\Component\VarDumper\Dumper\ContextProvider\CliContextProvider;
@@ -62,7 +61,10 @@ public static function setDumper(?DataDumperInterface $dumper = null): Closure
             use ($cloner, $dumper): ?string {
                 $var = $cloner->cloneVar($var);
 
-                $label === null or $var = $var->withContext(['label' => $label]);
+                $context = StaticState::getValue()->dataContext;
+
+                $label === null or $context['label'] ??= $label;
+                $label === [] or $var = $var->withContext($context);
                 $depth > 0 and $var = $var->withMaxDepth($depth);
 
                 return $dumper->dump($var);

src/Client/TrapHandle/StaticState.php

@@ -12,6 +12,8 @@
  */
 final class StaticState
 {
+    public array $dataContext = [];
+
     /**
      * @param SimpleStackTrace $stackTrace Simple stack trace without arguments and objects.
      * @param StackTraceWithObjects $stackTraceWithObjects Stack trace without arguments but with objects.

tests/Unit/Client/TrapTest.php

@@ -4,9 +4,7 @@
 
 namespace Buggregator\Trap\Tests\Unit\Client;
 
-use Buggregator\Trap\Client\TrapHandle\Counter;
 use Buggregator\Trap\Client\TrapHandle\Dumper;
-use Symfony\Component\VarDumper\Cloner\Data;
 use Symfony\Component\VarDumper\Dumper\DataDumperInterface;
 
 final class TrapTest extends Base
@@ -17,6 +15,30 @@ public function testLabel(): void
         $this->assertSame('FooName', static::$lastData->getContext()['label']);
     }
 
+    public function testSimpleContext(): void
+    {
+        trap('test-value')->context(foo: 'test-context');
+
+        self::assertSame(['foo' => 'test-context'], static::$lastData->getContext());
+    }
+
+    public function testArrayContext(): void
+    {
+        trap('test-value')->context(['foo' => 'test-context']);
+
+        self::assertSame(['foo' => 'test-context'], static::$lastData->getContext());
+    }
+
+    public function testContextMultiple(): void
+    {
+        trap('test-value')
+            ->context(['foo' => 'test-context'])
+            ->context(['bar' => 'bar-context'])
+            ->context(foo: 'new');
+
+        self::assertSame(['foo' => 'new', 'bar' => 'bar-context'], static::$lastData->getContext());
+    }
+
     /**
      * Check the first line of dumped stacktrace string contains right file and line.
      */