feat(view): add the shared comparison captions to ViewMessage and the capture guidance to DbMessage, so adapters stop carrying those literals. (#56)

Author: terabytesoftw

composer.json

@@ -24,7 +24,7 @@
         "ext-intl": "*",
         "ext-mbstring": "*",
         "ui-awesome/html": "^0.6",
-        "ui-awesome/html-core-component": "^0.4",
+        "ui-awesome/html-core-component": "^0.5@dev",
         "ui-awesome/html-helper": "^0.7",
         "ui-awesome/html-interop": "^0.4",
         "ui-awesome/html-mixin": "^0.8.2",

src/Collector/CollectorCoordinator.php

@@ -87,11 +87,7 @@ public function capture(RequestSummary $summary): DebugSnapshot
             }
         }
 
-        return new DebugSnapshot(
-            $summary,
-            $panels,
-            $failures,
-        );
+        return new DebugSnapshot($summary, $panels, $failures);
     }
 
     /**

src/Comparison/SummaryMetricComparison.php

@@ -133,21 +133,9 @@ private static function formatNumber(float|int $value, string $unit, int $precis
      *
      * @return self Metric comparison for the two counters.
      */
-    private static function integerMetric(
-        string $label,
-        int $baseline,
-        int $target,
-        string|null $panelId = null,
-    ): self {
-        return self::numericMetric(
-            $label,
-            $baseline,
-            $target,
-            1,
-            '',
-            $panelId,
-            0,
-        );
+    private static function integerMetric(string $label, int $baseline, int $target, string|null $panelId = null): self
+    {
+        return self::numericMetric($label, $baseline, $target, 1, '', $panelId, 0);
     }
 
     /**
@@ -181,15 +169,7 @@ private static function nullableFloatMetric(
             );
         }
 
-        return self::numericMetric(
-            $label,
-            $baseline,
-            $target,
-            $scale,
-            $unit,
-            $panelId,
-            2,
-        );
+        return self::numericMetric($label, $baseline, $target, $scale, $unit, $panelId, 2);
     }
 
     /**

src/Helper/SensitiveDataRedactor.php

@@ -155,14 +155,7 @@ public static function redact(
 
         [$keyMap, $prefixes, $patterns] = self::rules($sensitiveKeys, $sensitiveKeyPrefixes, $sensitiveKeyPatterns);
 
-        return self::walk(
-            $value,
-            $keyMap,
-            $prefixes,
-            $patterns,
-            0,
-            $nodes,
-        );
+        return self::walk($value, $keyMap, $prefixes, $patterns, 0, $nodes);
     }
 
     /**

src/Helper/Trace.php

@@ -37,10 +37,7 @@ private function __construct(private Closure|string|false $template, private arr
      */
     public static function create(): self
     {
-        return new self(
-            self::DEFAULT_TEMPLATE,
-            [],
-        );
+        return new self(self::DEFAULT_TEMPLATE, []);
     }
 
     /**
@@ -69,6 +66,7 @@ public function render(array $frame): string
         }
 
         $file = $this->mapPath(str_replace('\\', '/', $file));
+
         $template = $this->template;
 
         if ($template === false) {
@@ -122,10 +120,7 @@ public function withPathMappings(array $pathMappings): self
             $normalized[self::normalizePrefix((string) $remote)] = self::normalizePrefix($target);
         }
 
-        return new self(
-            template: $this->template,
-            pathMappings: $normalized,
-        );
+        return new self(template: $this->template, pathMappings: $normalized);
     }
 
     /**
@@ -140,10 +135,7 @@ public function withPathMappings(array $pathMappings): self
      */
     public function withTemplate(Closure|string|false $template): self
     {
-        return new self(
-            template: $template,
-            pathMappings: $this->pathMappings,
-        );
+        return new self(template: $template, pathMappings: $this->pathMappings);
     }
 
     /**

src/Panel/Asset/AssetPanel.php

@@ -39,10 +39,7 @@ final class AssetPanel extends Panel
      */
     public function present(array $data): PanelView
     {
-        $snapshot = AssetSnapshot::fromArray(
-            $data,
-            '$.asset',
-        );
+        $snapshot = AssetSnapshot::fromArray($data, '$.asset');
 
         $bundles = $snapshot->bundles();
         $vite = $snapshot->vite();

src/Panel/Config/ConfigSnapshot.php

@@ -23,6 +23,11 @@ public function data(): array
         return $this->values();
     }
 
+    /**
+     * Returns the key under which the configuration payload is stored.
+     *
+     * @return string Payload key.
+     */
     protected static function payloadKey(): string
     {
         return 'data';

src/Panel/Db/DbMessage.php

@@ -9,6 +9,14 @@
  */
 enum DbMessage: string
 {
+    /**
+     * Guidance of the empty state, naming the profiler the adapter must wire so statements are captured.
+     *
+     * Format: "Configure the development connection with %s. ..."
+     */
+    case CAPTURE_GUIDANCE = 'Configure the development connection with %s. Rows are shown only when the driver '
+        . 'reports them. After a redirect, open the previous request from History.';
+
     /**
      * Header of the column counting how many times the exact same statement ran.
      */

src/Panel/Event/EventInspection.php

@@ -57,7 +57,10 @@ public static function fromArray(mixed $data, string $path): self
 
         foreach ($payload->map('context') as $key => $value) {
             if (!is_string($value) || strlen($value) > 2048 || strlen($key) > 128) {
-                throw HydrationException::at("{$path}.context.{$key}", 'bounded text');
+                throw HydrationException::at(
+                    "{$path}.context.{$key}",
+                    'bounded text',
+                );
             }
 
             $context[$key] = $value;
@@ -67,7 +70,10 @@ public static function fromArray(mixed $data, string $path): self
 
         foreach ($payload->list('trace') as $index => $value) {
             if (!is_string($value) || strlen($value) > 2048) {
-                throw HydrationException::at("{$path}.trace[{$index}]", 'bounded text');
+                throw HydrationException::at(
+                    "{$path}.trace[{$index}]",
+                    'bounded text',
+                );
             }
 
             $trace[] = $value;

src/Panel/Mail/MailEntry.php

@@ -79,12 +79,7 @@ private function __construct(
      */
     public static function create(string $from, array $to, string $subject, bool $isSuccessful): self
     {
-        return new self(
-            $from,
-            $to,
-            $subject,
-            $isSuccessful,
-        );
+        return new self($from, $to, $subject, $isSuccessful);
     }
 
     /**