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

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);
     }
 
     /**

src/Panel/PanelRenderContext.php

@@ -46,10 +46,6 @@ public function panelPayload(string $panel): array|null
      */
     public function panelUrl(string|null $panel = null, array|null $queryParams = null): string
     {
-        return $this->urls->panel(
-            $this->tag,
-            $panel ?? $this->panel,
-            $queryParams ?? $this->queryParams,
-        );
+        return $this->urls->panel($this->tag, $panel ?? $this->panel, $queryParams ?? $this->queryParams);
     }
 }

src/Panel/PanelRenderer.php

@@ -264,7 +264,7 @@ private function panel(string $name, PanelView $view): string
                 ->html(...$summary)
                 ->render();
 
-        return $heading . $strip . $this->blocks($view->blocks());
+        return "{$heading}{$strip}" . $this->blocks($view->blocks());
     }
 
     /**

src/Panel/Profile/ProfilingSnapshot.php

@@ -56,12 +56,7 @@ public static function capture(int $memory, float $time, array $messages): self
             $entries[] = ProfileRow::fromTiming($timing, count($entries));
         }
 
-        return new self(
-            $memory,
-            $time,
-            $entries,
-            $samples,
-        );
+        return new self($memory, $time, $entries, $samples);
     }
 
     /**

src/Panel/Queue/QueuePanel.php

@@ -219,10 +219,7 @@ private function detail(JobRecord $record, int $index): PanelView
         $url = $this->jobUrls[$index] ?? null;
 
         if ($url !== null) {
-            $fields[QueueMessage::DETAILS->value] = PanelView::link(
-                QueueMessage::JOB_LINK->value,
-                $url,
-            );
+            $fields[QueueMessage::DETAILS->value] = PanelView::link(QueueMessage::JOB_LINK->value, $url);
         }
 
         $view = PanelView::create()->overview($fields, true);
@@ -324,9 +321,6 @@ private static function status(JobRecord $record): array
     {
         $status = self::STATUS[$record->eventType] ?? self::STATUS[JobRecord::TYPE_PUSH];
 
-        return PanelView::badge(
-            $status['label']->value,
-            $status['tone'],
-        );
+        return PanelView::badge($status['label']->value, $status['tone']);
     }
 }

src/Panel/Request/RequestHeadersRenderer.php

@@ -39,7 +39,7 @@ public static function render(array $request, array $response): string
             ->html(
                 H2::tag()
                     ->id('yii-debug-header-exchange-title')
-                    ->content(RequestMessage::HEADER_EXCHANGE->value),
+                    ->content(RequestMessage::HEADER_EXCHANGE),
                 Div::tag()
                     ->class('yii-debug-diagnostic-counts')
                     ->html(
@@ -187,9 +187,6 @@ private static function renderLedger(array $entries, bool $response): string
             );
         }
 
-        return RequestDiagnosticLedger::render(
-            'yii-debug-header-ledger',
-            ...$rows,
-        );
+        return RequestDiagnosticLedger::render('yii-debug-header-ledger', ...$rows);
     }
 }