From 788d7bc306b7e8f0cc1a84c586982e136e9a4215 Mon Sep 17 00:00:00 2001
From: Wilmer Arambula <terabytesoftw@gmail.com>
Date: Tue, 18 Aug 2026 20:33:26 -0400
Subject: [PATCH 1/2] feat: add shared UI parity contracts, Asset composition,
 and cross-adapter acceptance documentation.

---
 CHANGELOG.md                                  |   1 +
 README.md                                     |   8 +
 src/Data/FilterEngine.php                     | 172 ++++++++++++++++
 src/Data/FilterPrefix.php                     |  33 +++
 src/Data/PageSize.php                         | 104 ++++++++++
 src/Data/QueryInput.php                       |  75 +++++++
 src/Panel/Asset/AssetSectionRenderer.php      |  82 ++++++++
 src/Panel/PanelRenderContext.php              |  64 ++++++
 src/Routing/DebugUrlGeneratorInterface.php    |  36 ++++
 tests/Data/FilterEngineTest.php               | 194 ++++++++++++++++++
 tests/Data/FilterPrefixTest.php               |  50 +++++
 tests/Data/PageSizeTest.php                   | 117 +++++++++++
 tests/Data/QueryInputTest.php                 |  76 +++++++
 .../Panel/Asset/AssetSectionRendererTest.php  | 107 ++++++++++
 tests/Panel/PanelRenderContextTest.php        | 102 +++++++++
 15 files changed, 1221 insertions(+)
 create mode 100644 src/Data/FilterEngine.php
 create mode 100644 src/Data/FilterPrefix.php
 create mode 100644 src/Data/PageSize.php
 create mode 100644 src/Data/QueryInput.php
 create mode 100644 src/Panel/Asset/AssetSectionRenderer.php
 create mode 100644 src/Panel/PanelRenderContext.php
 create mode 100644 src/Routing/DebugUrlGeneratorInterface.php
 create mode 100644 tests/Data/FilterEngineTest.php
 create mode 100644 tests/Data/FilterPrefixTest.php
 create mode 100644 tests/Data/PageSizeTest.php
 create mode 100644 tests/Data/QueryInputTest.php
 create mode 100644 tests/Panel/Asset/AssetSectionRendererTest.php
 create mode 100644 tests/Panel/PanelRenderContextTest.php

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3c3a266..3eef982 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -16,3 +16,4 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - feat(router): implement Router panel with Current Route and Rules sections.
 - fix(toolbar): follow debug tags through adapter query URLs and enforce complete JavaScript mutation coverage.
 - feat(panel): add `UserRbacRow` typed view-model so adapters render RBAC role and permission rows from a single normalized shape.
+- feat: add shared UI parity contracts, Asset composition, and cross-adapter acceptance documentation.
diff --git a/README.md b/README.md
index eebf6d1..9e13ffe 100644
--- a/README.md
+++ b/README.md
@@ -22,12 +22,20 @@ the toolbar data contract, and framework-neutral PHP templates composed with the
 does not register assets, render responses, inject toolbar markup, or depend on Yii2, Yii3, an application container, a
 view implementation, or a framework request lifecycle.
 
+Shared adapter UI contracts include `PHPForge\Debug\Data\FilterEngine`, `FilterPrefix`, `PageSize`, and `QueryInput`,
+plus `PHPForge\Debug\Panel\PanelRenderContext`. Adapters provide a
+`PHPForge\Debug\Routing\DebugUrlGeneratorInterface` implementation so portable panel renderers can build history,
+panel, and action links without importing a framework URL manager.
+
 Adapters collect framework data, convert it into immutable snapshots, expose toolbar data endpoints, define and
 publish assets through their framework, and render the shared templates with their framework view component. They also
 own toolbar response injection. Routes, controllers or actions, URL generation, panel metadata, and framework-specific
 panel views remain in each adapter. Yii adapters resolve the packaged frontend at
 `@vendor/php-forge/debug-core/resources/assets` and configure their own alias for `resources/views`.
 
+The visual and behavioral synchronization contract for the Yii adapters is documented in the
+[Yii Debug UI parity baseline](docs/ui-parity-baseline.md).
+
 Current adapters:
 
 - `yii2-extensions/debug`
diff --git a/src/Data/FilterEngine.php b/src/Data/FilterEngine.php
new file mode 100644
index 0000000..5101b58
--- /dev/null
+++ b/src/Data/FilterEngine.php
@@ -0,0 +1,172 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPForge\Debug\Data;
+
+use PHPForge\Debug\Helper\Dump;
+
+use function array_filter;
+use function array_key_exists;
+use function array_values;
+use function get_object_vars;
+use function is_float;
+use function is_int;
+use function is_numeric;
+use function is_object;
+use function is_scalar;
+use function is_string;
+use function mb_stripos;
+use function mb_strtolower;
+use function preg_match;
+
+/**
+ * Filters typed rows against exact, partial, and leading numeric comparison conditions.
+ */
+final class FilterEngine
+{
+    private const string CHARSET = 'UTF-8';
+
+    /**
+     * @var list<
+     *   array{attribute: string, operator: '>'|'<'|'>=', value: float}
+     *   |array{attribute: string, operator: 'contains'|'same', value: string}
+     * >
+     */
+    private array $conditions = [];
+
+    /**
+     * Registers an exact, partial, or leading numeric comparison condition.
+     *
+     * Empty and non-scalar raw values register nothing, so unfiltered attributes can be passed through unconditionally.
+     *
+     * @param string $attribute Row attribute (public property or array key) the condition applies to.
+     * @param mixed $rawValue Raw filter value as read from the request; scalars are compared as strings.
+     * @param bool $partial Whether a non-numeric value matches as a case-insensitive substring instead of whole-value.
+     */
+    public function addCondition(string $attribute, mixed $rawValue, bool $partial = false): void
+    {
+        $value = is_scalar($rawValue) ? (string) $rawValue : '';
+
+        if ($value === '') {
+            return;
+        }
+
+        if (preg_match('/^\s*([<>])\s*(-?(?:\d+(?:\.\d+)?|\.\d+))\s*$/D', $value, $matches) === 1) {
+            $this->conditions[] = [
+                'attribute' => $attribute,
+                'operator' => $matches[1],
+                'value' => (float) $matches[2],
+            ];
+
+            return;
+        }
+
+        $this->conditions[] = [
+            'attribute' => $attribute,
+            'operator' => $partial ? 'contains' : 'same',
+            'value' => $value,
+        ];
+    }
+
+    /**
+     * Registers a numeric greater-than-or-equal condition.
+     *
+     * @param string $attribute Row attribute (public property or array key) the condition applies to.
+     * @param float $value Inclusive lower bound the attribute value must reach.
+     */
+    public function addMinimumCondition(string $attribute, float $value): void
+    {
+        $this->conditions[] = ['attribute' => $attribute, 'operator' => '>=', 'value' => $value];
+    }
+
+    /**
+     * Applies all registered conditions and resets the engine for the next run.
+     *
+     * @template TRow of array<string, mixed>|object
+     *
+     * @param array<int, TRow> $rows Rows to filter; typed row objects or string-keyed arrays.
+     *
+     * @return list<TRow> Rows matching every registered condition, reindexed.
+     */
+    public function filter(array $rows): array
+    {
+        $filtered = array_values(array_filter($rows, $this->matches(...)));
+
+        $this->conditions = [];
+
+        return $filtered;
+    }
+
+    /**
+     * @param array<string, mixed>|object $row Typed row object or string-keyed array.
+     */
+    private function matches(array|object $row): bool
+    {
+        foreach ($this->conditions as $condition) {
+            $attribute = $condition['attribute'];
+
+            $values = is_object($row) ? get_object_vars($row) : $row;
+
+            if (!array_key_exists($attribute, $values)) {
+                return false;
+            }
+
+            $candidate = $values[$attribute];
+            $operator = $condition['operator'];
+
+            if ($operator === '>' || $operator === '<' || $operator === '>=') {
+                $expected = $condition['value'];
+
+                if (
+                    !is_float($expected)
+                    || !is_int($candidate) && !is_float($candidate) && !is_string($candidate)
+                    || !is_numeric($candidate)
+                ) {
+                    return false;
+                }
+
+                $candidate = (float) $candidate;
+
+                $matched = match ($operator) {
+                    '>' => $candidate > $expected,
+                    '<' => $candidate < $expected,
+                    default => $candidate >= $expected,
+                };
+
+                if (!$matched) {
+                    return false;
+                }
+
+                continue;
+            }
+
+            $candidate = is_scalar($candidate)
+                ? (string) $candidate
+                : Dump::export($candidate);
+
+            $expected = $condition['value'];
+
+            if (!is_string($expected)) {
+                return false;
+            }
+
+            if ($operator === 'contains') {
+                if (mb_stripos($candidate, $expected, 0, self::CHARSET) === false) {
+                    return false;
+                }
+
+                continue;
+            }
+
+            if (
+                mb_strtolower($candidate, self::CHARSET)
+                !== mb_strtolower($expected, self::CHARSET)
+            ) {
+                return false;
+            }
+        }
+
+        return true;
+    }
+}
diff --git a/src/Data/FilterPrefix.php b/src/Data/FilterPrefix.php
new file mode 100644
index 0000000..8e10080
--- /dev/null
+++ b/src/Data/FilterPrefix.php
@@ -0,0 +1,33 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPForge\Debug\Data;
+
+/**
+ * Freezes the `Prefix[attribute]` query-parameter vocabulary shared by every debug-panel filter form.
+ */
+final class FilterPrefix
+{
+    public const string ASSET = 'Asset';
+
+    public const string DB = 'Db';
+
+    public const string DEBUG = 'Debug';
+
+    public const string EVENT = 'Event';
+
+    public const string LOG = 'Log';
+
+    public const string MAIL = 'Mail';
+
+    public const string PROFILE = 'Profile';
+
+    public const string QUEUE = 'Queue';
+
+    public const string ROUTER = 'Router';
+
+    public const string TIMELINE = 'Timeline';
+
+    public const string USER = 'User';
+}
diff --git a/src/Data/PageSize.php b/src/Data/PageSize.php
new file mode 100644
index 0000000..6f87318
--- /dev/null
+++ b/src/Data/PageSize.php
@@ -0,0 +1,104 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPForge\Debug\Data;
+
+use UIAwesome\Html\Form\{Option, Select};
+use UIAwesome\Html\Phrasing\{Label, Span};
+
+use function is_numeric;
+use function min;
+use function strcasecmp;
+
+/**
+ * Resolves the `per-page` grid page size and renders the shared page-size selector.
+ */
+final class PageSize
+{
+    /**
+     * Default page size applied when no `per-page` parameter is supplied or the value is invalid.
+     */
+    public const int DEFAULT = 50;
+
+    /**
+     * Hard cap on the number of rows per page.
+     */
+    public const int MAX = 1000;
+
+    /**
+     * Selector options in display order; the literal `all` disables pagination.
+     */
+    public const array OPTIONS = ['10', '25', '50', '100', 'all'];
+
+    /**
+     * Returns the raw `per-page` value for the selector's selected state, falling back to the default.
+     *
+     * @param string|null $raw Raw `per-page` query-parameter value, or `null` when absent.
+     * @param int $default Page size used when no value is supplied.
+     */
+    public static function current(string|null $raw, int $default = self::DEFAULT): string
+    {
+        return $raw ?? (string) $default;
+    }
+
+    /**
+     * Resolves the raw `per-page` value into an effective page size.
+     *
+     * @param string|null $raw Raw `per-page` query-parameter value, or `null` when absent.
+     * @param positive-int $default Page size used when no value is supplied or the value is invalid.
+     *
+     * @return positive-int|null Effective page size capped at {@see MAX}, or `null` when `all` disables pagination.
+     */
+    public static function resolve(string|null $raw, int $default = self::DEFAULT): int|null
+    {
+        if ($raw !== null && strcasecmp($raw, 'all') === 0) {
+            return null;
+        }
+
+        $size = $raw !== null && is_numeric($raw) ? (int) $raw : $default;
+
+        if ($size <= 0) {
+            $size = $default;
+        }
+
+        return min($size, self::MAX);
+    }
+
+    /**
+     * Renders the inline page-size selector shown in the grid summary header.
+     *
+     * Usage example:
+     * ```php
+     * $html = \PHPForge\Debug\Data\PageSize::selectorHtml('50');
+     * ```
+     *
+     * @param string $current Currently selected raw value (one of {@see OPTIONS} for a highlighted option).
+     */
+    public static function selectorHtml(string $current): string
+    {
+        $select = Select::tag()
+            ->addDataAttribute('yii-debug-pagesize', true)
+            ->class('yii-debug-grid-pagesize-select')
+            ->name('per-page');
+
+        foreach (self::OPTIONS as $row) {
+            $select = $select->option(
+                Option::tag()
+                    ->value($row)
+                    ->content($row === 'all' ? 'All' : $row)
+                    ->selected($row === $current),
+            );
+        }
+
+        return Label::tag()
+            ->class('yii-debug-grid-pagesize')
+            ->html(
+                Span::tag()
+                    ->class('yii-debug-grid-pagesize-label')
+                    ->content('Rows'),
+                $select,
+            )
+            ->render();
+    }
+}
diff --git a/src/Data/QueryInput.php b/src/Data/QueryInput.php
new file mode 100644
index 0000000..44eb007
--- /dev/null
+++ b/src/Data/QueryInput.php
@@ -0,0 +1,75 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPForge\Debug\Data;
+
+use function is_array;
+use function is_float;
+use function is_int;
+use function is_string;
+
+/**
+ * Reads `Prefix[attribute]` filter groups and scalar values from a parsed query-parameter array.
+ */
+final class QueryInput
+{
+    /**
+     * Returns the active `Prefix[attribute]` filter map from the query parameters.
+     *
+     * @param array<array-key, mixed> $query Parsed query parameters.
+     * @param string $prefix Filter-group prefix (for example, `Debug` matches `Debug[statusCode]`).
+     *
+     * @return array<string, string> Attribute-to-value map with empty and non-scalar entries removed.
+     */
+    public static function group(array $query, string $prefix): array
+    {
+        $group = $query[$prefix] ?? null;
+
+        if (!is_array($group)) {
+            return [];
+        }
+
+        $filters = [];
+
+        foreach ($group as $attribute => $value) {
+            if (!is_string($attribute)) {
+                continue;
+            }
+
+            $normalized = self::stringValue($value);
+
+            if ($normalized === null || $normalized === '') {
+                continue;
+            }
+
+            $filters[$attribute] = $normalized;
+        }
+
+        return $filters;
+    }
+
+    /**
+     * Returns a top-level query parameter as a string, or `null` when absent or non-scalar.
+     *
+     * @param array<array-key, mixed> $query Parsed query parameters.
+     * @param string $name Parameter name to read.
+     */
+    public static function scalar(array $query, string $name): string|null
+    {
+        return self::stringValue($query[$name] ?? null);
+    }
+
+    private static function stringValue(mixed $value): string|null
+    {
+        if (is_string($value)) {
+            return $value;
+        }
+
+        if (is_int($value) || is_float($value)) {
+            return (string) $value;
+        }
+
+        return null;
+    }
+}
diff --git a/src/Panel/Asset/AssetSectionRenderer.php b/src/Panel/Asset/AssetSectionRenderer.php
new file mode 100644
index 0000000..e6736f3
--- /dev/null
+++ b/src/Panel/Asset/AssetSectionRenderer.php
@@ -0,0 +1,82 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPForge\Debug\Panel\Asset;
+
+use PHPForge\Debug\Helper\Icon;
+use UIAwesome\Html\Flow\Div;
+use UIAwesome\Html\Heading\H1;
+use UIAwesome\Html\List\{Li, Ol};
+use UIAwesome\Html\Phrasing\{Span, Strong};
+use UIAwesome\Html\Root\Header;
+
+/**
+ * Renders the shared Asset Bundles heading, aggregate statistics, and normalized bundle inventory.
+ */
+final class AssetSectionRenderer
+{
+    /**
+     * Renders the accessible panel heading and aggregate bundle, CSS, JavaScript, and dependency statistics.
+     */
+    public static function renderHeader(AssetSummary $summary): string
+    {
+        $stats = [
+            ['bundles', 'asset', $summary->totalBundles, 'bundle' . ($summary->totalBundles === 1 ? '' : 's')],
+            ['css', 'brand-css3', $summary->totalCss, 'css'],
+            ['js', 'brand-javascript', $summary->totalJs, 'js'],
+            ['deps', 'link', $summary->totalDeps, 'link' . ($summary->totalDeps === 1 ? '' : 's')],
+        ];
+        $blocks = [];
+
+        foreach ($stats as [$kind, $icon, $value, $label]) {
+            $blocks[] = Div::tag()
+                ->addDataAttribute('kind', $kind)
+                ->class('yii-debug-asset-stat')
+                ->html(
+                    Span::tag()
+                        ->addAriaAttribute('hidden', 'true')
+                        ->class('yii-debug-asset-stat-icon')
+                        ->html(Icon::render($icon)),
+                    Strong::tag()
+                        ->class('yii-debug-asset-stat-value')
+                        ->content((string) $value),
+                    Span::tag()
+                        ->class('yii-debug-asset-stat-label')
+                        ->content($label),
+                );
+        }
+
+        return H1::tag()
+            ->class('yii-debug-sr-only')
+            ->content('Asset Bundles')
+            ->render()
+            . Header::tag()
+                ->class('yii-debug-asset-stats')
+                ->html(...$blocks)
+                ->render();
+    }
+
+    /**
+     * Renders the normalized bundle inventory as an ordered list of shared bundle cards.
+     */
+    public static function renderInventory(AssetSummary $summary): string
+    {
+        if ($summary->isEmpty()) {
+            return '';
+        }
+
+        $items = [];
+
+        foreach ($summary->bundles as $bundle) {
+            $items[] = Li::tag()
+                ->class('yii-debug-asset-list-item')
+                ->html(AssetCardRenderer::renderCard($bundle, $summary));
+        }
+
+        return Ol::tag()
+            ->class('yii-debug-asset-list')
+            ->html(...$items)
+            ->render();
+    }
+}
diff --git a/src/Panel/PanelRenderContext.php b/src/Panel/PanelRenderContext.php
new file mode 100644
index 0000000..db73a82
--- /dev/null
+++ b/src/Panel/PanelRenderContext.php
@@ -0,0 +1,64 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPForge\Debug\Panel;
+
+use PHPForge\Debug\Routing\DebugUrlGeneratorInterface;
+
+/**
+ * Supplies request, theme, and adapter-owned URL state to a framework-neutral panel renderer.
+ */
+final readonly class PanelRenderContext
+{
+    /**
+     * @param string $tag Captured request tag.
+     * @param string $panel Stable identifier of the panel being rendered.
+     * @param array<array-key, mixed> $queryParams Parsed query parameters of the current debugger request.
+     * @param string $theme Resolved debugger theme.
+     * @param DebugUrlGeneratorInterface $urls Adapter-owned URL generator.
+     */
+    public function __construct(
+        public string $tag,
+        public string $panel,
+        public array $queryParams,
+        public string $theme,
+        private DebugUrlGeneratorInterface $urls,
+    ) {}
+
+    /**
+     * Builds an adapter action URL for this captured request.
+     *
+     * @param string $action Adapter-defined action identifier.
+     * @param array<array-key, mixed>|null $queryParams Additional parameters, or `null` to reuse the current query.
+     */
+    public function actionUrl(string $action, array|null $queryParams = null): string
+    {
+        return $this->urls->action($action, $this->tag, $queryParams ?? $this->queryParams);
+    }
+
+    /**
+     * Builds the request-history URL.
+     *
+     * @param array<array-key, mixed>|null $queryParams History parameters, or `null` to reuse the current query.
+     */
+    public function historyUrl(array|null $queryParams = null): string
+    {
+        return $this->urls->history($queryParams ?? $this->queryParams);
+    }
+
+    /**
+     * Builds a panel URL for this captured request.
+     *
+     * @param string|null $panel Target panel, or `null` to keep the current panel.
+     * @param array<array-key, mixed>|null $queryParams Panel parameters, or `null` to reuse the current query.
+     */
+    public function panelUrl(string|null $panel = null, array|null $queryParams = null): string
+    {
+        return $this->urls->panel(
+            $this->tag,
+            $panel ?? $this->panel,
+            $queryParams ?? $this->queryParams,
+        );
+    }
+}
diff --git a/src/Routing/DebugUrlGeneratorInterface.php b/src/Routing/DebugUrlGeneratorInterface.php
new file mode 100644
index 0000000..cc8e0ae
--- /dev/null
+++ b/src/Routing/DebugUrlGeneratorInterface.php
@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPForge\Debug\Routing;
+
+/**
+ * Builds adapter-owned debugger URLs for framework-neutral panel renderers.
+ */
+interface DebugUrlGeneratorInterface
+{
+    /**
+     * Builds a debugger action URL scoped to a captured request.
+     *
+     * @param string $action Adapter-defined action identifier.
+     * @param string $tag Captured request tag.
+     * @param array<array-key, mixed> $queryParams Additional query parameters.
+     */
+    public function action(string $action, string $tag, array $queryParams = []): string;
+
+    /**
+     * Builds the request-history URL.
+     *
+     * @param array<array-key, mixed> $queryParams History filter, sort, or cursor parameters.
+     */
+    public function history(array $queryParams = []): string;
+
+    /**
+     * Builds a captured-request panel URL.
+     *
+     * @param string $tag Captured request tag.
+     * @param string $panel Stable panel identifier.
+     * @param array<array-key, mixed> $queryParams Panel filter, sort, or pagination parameters.
+     */
+    public function panel(string $tag, string $panel, array $queryParams = []): string;
+}
diff --git a/tests/Data/FilterEngineTest.php b/tests/Data/FilterEngineTest.php
new file mode 100644
index 0000000..5b6a272
--- /dev/null
+++ b/tests/Data/FilterEngineTest.php
@@ -0,0 +1,194 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPForge\Debug\Tests\Data;
+
+use PHPForge\Debug\Data\FilterEngine;
+use PHPUnit\Framework\Attributes\Group;
+use PHPUnit\Framework\TestCase;
+use ReflectionProperty;
+
+/**
+ * Unit tests for {@see FilterEngine} covering the exact/partial/numeric operator grammar shared by every debug-panel
+ * search model.
+ */
+#[Group('data')]
+#[Group('filter')]
+final class FilterEngineTest extends TestCase
+{
+    public function testAddConditionIgnoresEmptyAndNonScalarValues(): void
+    {
+        $engine = new FilterEngine();
+
+        $engine->addCondition('level', '');
+        $engine->addCondition('level', null);
+        $engine->addCondition('level', ['error']);
+
+        $rows = [['level' => 'info'], ['level' => 'error']];
+
+        self::assertSame(
+            $engine->filter($rows),
+            $rows,
+            'Empty and non-scalar values must register no condition.',
+        );
+    }
+
+    public function testAddMinimumConditionKeepsRowsAtOrAboveTheBound(): void
+    {
+        $engine = new FilterEngine();
+
+        $engine->addMinimumCondition('duration', 0.5);
+
+        self::assertSame(
+            [['duration' => 0.5], ['duration' => 2]],
+            $engine->filter([['duration' => 0.1], ['duration' => 0.5], ['duration' => 2]]),
+            'Inclusive lower bound must keep the boundary row.',
+        );
+    }
+
+    public function testFilterComparesNonScalarCandidatesThroughDumpExport(): void
+    {
+        $engine = new FilterEngine();
+
+        $engine->addCondition('payload', 'alpha', partial: true);
+
+        self::assertCount(
+            1,
+            $engine->filter([['payload' => ['alpha' => 1]], ['payload' => ['beta' => 2]]]),
+            'Array candidates must match through their exported representation.',
+        );
+    }
+
+    public function testFilterDropsRowsMissingTheAttribute(): void
+    {
+        $engine = new FilterEngine();
+
+        $engine->addCondition('level', 'error');
+
+        self::assertSame(
+            [],
+            $engine->filter([['category' => 'app']]),
+            'Rows without the filtered attribute must be dropped.',
+        );
+    }
+
+    public function testFilterMatchesCaseInsensitiveSubstringWhenPartial(): void
+    {
+        $engine = new FilterEngine();
+
+        $engine->addCondition('message', 'SESSION', partial: true);
+
+        self::assertSame(
+            [['message' => 'Session started']],
+            $engine->filter([['message' => 'Session started'], ['message' => 'Connection opened']]),
+            'Partial conditions must match case-insensitive substrings.',
+        );
+    }
+
+    public function testFilterMatchesCaseInsensitiveWholeValueByDefault(): void
+    {
+        $engine = new FilterEngine();
+
+        $engine->addCondition('level', 'ERROR');
+
+        self::assertSame(
+            [['level' => 'error']],
+            $engine->filter([['level' => 'error'], ['level' => 'error-handler']]),
+            'Default conditions must match the whole value case-insensitively.',
+        );
+    }
+
+    public function testFilterParsesLeadingComparisonOperators(): void
+    {
+        $engine = new FilterEngine();
+
+        $engine->addCondition('sqlCount', '> 5');
+
+        self::assertSame(
+            [['sqlCount' => 9]],
+            $engine->filter([['sqlCount' => 3], ['sqlCount' => 9]]),
+            'A leading `>` must compare numerically.',
+        );
+
+        $engine->addCondition('duration', '<0.5');
+
+        self::assertSame(
+            [['duration' => '0.25']],
+            $engine->filter([['duration' => '0.25'], ['duration' => '0.75']]),
+            'A leading `<` must compare numeric strings numerically.',
+        );
+    }
+
+    public function testFilterReadsPublicPropertiesFromObjectRows(): void
+    {
+        $engine = new FilterEngine();
+
+        $engine->addCondition('method', 'get');
+
+        $match = new class {
+            public string $method = 'GET';
+        };
+        $miss = new class {
+            public string $method = 'POST';
+        };
+
+        self::assertSame(
+            [$match],
+            $engine->filter([$match, $miss]),
+            'Object rows must be matched through their public properties.',
+        );
+    }
+
+    public function testFilterRejectsMalformedInternalConditions(): void
+    {
+        $engine = new FilterEngine();
+
+        $property = new ReflectionProperty($engine, 'conditions');
+
+        $property->setValue($engine, [['attribute' => 'value', 'operator' => '>', 'value' => '5']]);
+
+        self::assertSame(
+            [],
+            $engine->filter([['value' => 6]]),
+            'Numeric conditions with a non-float boundary must reject the row.',
+        );
+
+        $property->setValue($engine, [['attribute' => 'value', 'operator' => 'same', 'value' => 5.0]]);
+
+        self::assertSame(
+            [],
+            $engine->filter([['value' => '5']]),
+            'Text conditions with a non-string boundary must reject the row.',
+        );
+    }
+
+    public function testFilterRejectsNonNumericCandidatesForNumericOperators(): void
+    {
+        $engine = new FilterEngine();
+
+        $engine->addCondition('sqlCount', '>5');
+
+        self::assertSame(
+            [],
+            $engine->filter([['sqlCount' => 'many'], ['sqlCount' => null]]),
+            'Numeric operators must drop rows whose candidate is not numeric.',
+        );
+    }
+
+    public function testFilterResetsConditionsAfterEachRun(): void
+    {
+        $engine = new FilterEngine();
+
+        $engine->addCondition('level', 'error');
+        $engine->filter([['level' => 'info']]);
+
+        $rows = [['level' => 'info']];
+
+        self::assertSame(
+            $rows,
+            $engine->filter($rows),
+            'Conditions must reset after each filter run.',
+        );
+    }
+}
diff --git a/tests/Data/FilterPrefixTest.php b/tests/Data/FilterPrefixTest.php
new file mode 100644
index 0000000..eff44eb
--- /dev/null
+++ b/tests/Data/FilterPrefixTest.php
@@ -0,0 +1,50 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPForge\Debug\Tests\Data;
+
+use PHPForge\Debug\Data\FilterPrefix;
+use PHPUnit\Framework\Attributes\Group;
+use PHPUnit\Framework\TestCase;
+
+/**
+ * Unit tests for {@see FilterPrefix} covering the cross-adapter query-group vocabulary.
+ */
+#[Group('data')]
+#[Group('filter')]
+final class FilterPrefixTest extends TestCase
+{
+    public function testConstantsExposeTheSharedFilterGroups(): void
+    {
+        self::assertSame(
+            [
+                'Asset',
+                'Db',
+                'Debug',
+                'Event',
+                'Log',
+                'Mail',
+                'Profile',
+                'Queue',
+                'Router',
+                'Timeline',
+                'User',
+            ],
+            [
+                FilterPrefix::ASSET,
+                FilterPrefix::DB,
+                FilterPrefix::DEBUG,
+                FilterPrefix::EVENT,
+                FilterPrefix::LOG,
+                FilterPrefix::MAIL,
+                FilterPrefix::PROFILE,
+                FilterPrefix::QUEUE,
+                FilterPrefix::ROUTER,
+                FilterPrefix::TIMELINE,
+                FilterPrefix::USER,
+            ],
+            'Adapters must share one stable query-group vocabulary.',
+        );
+    }
+}
diff --git a/tests/Data/PageSizeTest.php b/tests/Data/PageSizeTest.php
new file mode 100644
index 0000000..109c49d
--- /dev/null
+++ b/tests/Data/PageSizeTest.php
@@ -0,0 +1,117 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPForge\Debug\Tests\Data;
+
+use PHPForge\Debug\Data\PageSize;
+use PHPUnit\Framework\Attributes\Group;
+use PHPUnit\Framework\TestCase;
+
+/**
+ * Unit tests for {@see PageSize} covering the `per-page` resolution semantics and the shared selector markup.
+ */
+#[Group('data')]
+#[Group('pagination')]
+final class PageSizeTest extends TestCase
+{
+    public function testCurrentFallsBackToTheDefaultWhenNoValueIsSupplied(): void
+    {
+        self::assertSame(
+            '50',
+            PageSize::current(null),
+            'Missing values must fall back to the default.',
+        );
+        self::assertSame(
+            'all',
+            PageSize::current('all'),
+            'Raw values must pass through untouched.',
+        );
+        self::assertSame(
+            '25',
+            PageSize::current(null, 25),
+            'A custom default must surface as a string.',
+        );
+    }
+
+    public function testResolveCapsNumericValuesAtTheMaximum(): void
+    {
+        self::assertSame(
+            1000,
+            PageSize::resolve('5000'),
+            'Values above the cap must clamp to `1000`.',
+        );
+        self::assertSame(
+            25,
+            PageSize::resolve('25'),
+            'Valid numeric values must pass through.',
+        );
+    }
+
+    public function testResolveFallsBackToTheDefaultForMissingOrInvalidValues(): void
+    {
+        self::assertSame(
+            50,
+            PageSize::resolve(null),
+            'Missing values must resolve to the default.',
+        );
+        self::assertSame(
+            50,
+            PageSize::resolve('abc'),
+            'Non-numeric values must resolve to the default.',
+        );
+        self::assertSame(
+            50,
+            PageSize::resolve('-5'),
+            'Non-positive values must resolve to the default.',
+        );
+        self::assertSame(
+            20,
+            PageSize::resolve(null, 20),
+            'A custom default must be honored.',
+        );
+    }
+
+    public function testResolveReturnsNullForTheAllKeyword(): void
+    {
+        self::assertNull(
+            PageSize::resolve('all'),
+            "The literal 'all' must disable pagination.",
+        );
+        self::assertNull(
+            PageSize::resolve('ALL'),
+            'The keyword must match case-insensitively.',
+        );
+    }
+
+    public function testSelectorHtmlMarksTheCurrentOptionSelected(): void
+    {
+        $html = PageSize::selectorHtml('25');
+
+        self::assertStringContainsString(
+            'data-yii-debug-pagesize',
+            $html,
+            'Selector must carry the JS hook.',
+        );
+        self::assertStringContainsString(
+            'name="per-page"',
+            $html,
+            'Selector must submit as `per-page`.',
+        );
+        self::assertStringContainsString(
+            '<option value="25" selected>',
+            $html,
+            'The current value must render selected.',
+        );
+        self::assertMatchesRegularExpression(
+            '/<option value="all">\s*All\s*<\/option>/',
+            $html,
+            "The 'all' option must render with its display label.",
+        );
+        self::assertStringContainsString(
+            'yii-debug-grid-pagesize-label',
+            $html,
+            'Label span must carry its class.',
+        );
+    }
+}
diff --git a/tests/Data/QueryInputTest.php b/tests/Data/QueryInputTest.php
new file mode 100644
index 0000000..6695a91
--- /dev/null
+++ b/tests/Data/QueryInputTest.php
@@ -0,0 +1,76 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPForge\Debug\Tests\Data;
+
+use PHPForge\Debug\Data\QueryInput;
+use PHPUnit\Framework\Attributes\Group;
+use PHPUnit\Framework\TestCase;
+
+/**
+ * Unit tests for {@see QueryInput} covering `Prefix[attribute]` group extraction and scalar top-level reads from
+ * parsed query parameters.
+ */
+#[Group('data')]
+#[Group('filter')]
+final class QueryInputTest extends TestCase
+{
+    public function testGroupDropsEmptyNonScalarAndNonStringKeyedEntries(): void
+    {
+        $filters = QueryInput::group(
+            [
+                'Debug' => [
+                    'statusCode' => '404',
+                    'url' => '',
+                    'nested' => ['x' => '1'],
+                    0 => 'indexed',
+                    'count' => 7,
+                ],
+            ],
+            'Debug',
+        );
+
+        self::assertSame(
+            ['statusCode' => '404', 'count' => '7'],
+            $filters,
+            'Empty strings, arrays, and integer keys must be dropped; numeric values must stringify.',
+        );
+    }
+
+    public function testGroupReturnsEmptyArrayWhenPrefixIsAbsentOrNotAnArray(): void
+    {
+        self::assertSame(
+            [],
+            QueryInput::group([], 'Debug'),
+            'A missing prefix must yield no filters.',
+        );
+        self::assertSame(
+            [],
+            QueryInput::group(['Debug' => 'scalar'], 'Debug'),
+            'A scalar under the prefix must yield no filters.',
+        );
+    }
+
+    public function testScalarReadsTopLevelStringsAndNumbers(): void
+    {
+        self::assertSame(
+            'all',
+            QueryInput::scalar(['per-page' => 'all'], 'per-page'),
+            'Strings must pass through.',
+        );
+        self::assertSame(
+            '25',
+            QueryInput::scalar(['per-page' => 25], 'per-page'),
+            'Integers must stringify.',
+        );
+        self::assertNull(
+            QueryInput::scalar([], 'per-page'),
+            "Missing parameters must yield 'null'.",
+        );
+        self::assertNull(
+            QueryInput::scalar(['per-page' => ['25']], 'per-page'),
+            "Array parameters must yield 'null'.",
+        );
+    }
+}
diff --git a/tests/Panel/Asset/AssetSectionRendererTest.php b/tests/Panel/Asset/AssetSectionRendererTest.php
new file mode 100644
index 0000000..359be5c
--- /dev/null
+++ b/tests/Panel/Asset/AssetSectionRendererTest.php
@@ -0,0 +1,107 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPForge\Debug\Tests\Panel\Asset;
+
+use PHPForge\Debug\Panel\Asset\{AssetBundleNormalizer, AssetBundleRow, AssetSectionRenderer};
+use PHPUnit\Framework\Attributes\Group;
+use PHPUnit\Framework\TestCase;
+
+/**
+ * Unit tests for {@see AssetSectionRenderer} covering shared statistics and inventory structure.
+ */
+#[Group('asset')]
+#[Group('panel')]
+final class AssetSectionRendererTest extends TestCase
+{
+    public function testRenderHeaderIncludesAccessibleTitleAndAllStatistics(): void
+    {
+        $summary = (new AssetBundleNormalizer())->normalize(self::rows());
+
+        $html = AssetSectionRenderer::renderHeader($summary);
+
+        self::assertStringContainsString(
+            'yii-debug-sr-only',
+            $html,
+            'The panel title must remain accessible.',
+        );
+        self::assertStringContainsString(
+            'yii-debug-asset-stats',
+            $html,
+            'The statistics strip must render.',
+        );
+        self::assertStringContainsString(
+            'data-kind="bundles"',
+            $html,
+            'Bundle count must render.',
+        );
+        self::assertStringContainsString(
+            'data-kind="css"',
+            $html,
+            'CSS count must render.',
+        );
+        self::assertStringContainsString(
+            'data-kind="js"',
+            $html,
+            'JavaScript count must render.',
+        );
+        self::assertStringContainsString(
+            'data-kind="deps"',
+            $html,
+            'Dependency count must render.',
+        );
+    }
+
+    public function testRenderInventoryReturnsEmptyStringWithoutBundles(): void
+    {
+        $summary = (new AssetBundleNormalizer())->normalize([]);
+
+        self::assertSame(
+            '',
+            AssetSectionRenderer::renderInventory($summary),
+            'Empty inventories render no list.',
+        );
+    }
+
+    public function testRenderInventoryUsesOrderedListAndSharedCards(): void
+    {
+        $summary = (new AssetBundleNormalizer())->normalize(self::rows());
+
+        $html = AssetSectionRenderer::renderInventory($summary);
+
+        self::assertStringContainsString(
+            'yii-debug-asset-list',
+            $html,
+            'Inventory must use the shared list class.',
+        );
+        self::assertStringContainsString(
+            'yii-debug-asset-list-item',
+            $html,
+            'Each bundle must use a list item.',
+        );
+        self::assertStringContainsString(
+            'yii-debug-asset-card',
+            $html,
+            'Each bundle must render as a shared card.',
+        );
+    }
+
+    /**
+     * @return list<AssetBundleRow>
+     */
+    private static function rows(): array
+    {
+        return [
+            new AssetBundleRow(
+                'app\\assets\\AppAsset',
+                '',
+                '/assets',
+                '/assets',
+                ['site.css'],
+                ['site.js'],
+                ['yii\\web\\YiiAsset'],
+            ),
+        ];
+    }
+}
diff --git a/tests/Panel/PanelRenderContextTest.php b/tests/Panel/PanelRenderContextTest.php
new file mode 100644
index 0000000..f1ec69b
--- /dev/null
+++ b/tests/Panel/PanelRenderContextTest.php
@@ -0,0 +1,102 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PHPForge\Debug\Tests\Panel;
+
+use PHPForge\Debug\Panel\PanelRenderContext;
+use PHPForge\Debug\Routing\DebugUrlGeneratorInterface;
+use PHPUnit\Framework\Attributes\Group;
+use PHPUnit\Framework\TestCase;
+
+use function http_build_query;
+
+/**
+ * Unit tests for {@see PanelRenderContext} delegating portable panel links to the active adapter.
+ */
+#[Group('panel')]
+#[Group('routing')]
+final class PanelRenderContextTest extends TestCase
+{
+    public function testBuildsUrlsWithCurrentContextByDefault(): void
+    {
+        $context = new PanelRenderContext(
+            'request-1',
+            'log',
+            ['Log' => ['level' => 'error']],
+            'dark',
+            self::urlGenerator(),
+        );
+
+        self::assertSame(
+            '/history?Log%5Blevel%5D=error',
+            $context->historyUrl(),
+            'History links must receive the current query parameters.',
+        );
+        self::assertSame(
+            '/panel/request-1/log?Log%5Blevel%5D=error',
+            $context->panelUrl(),
+            'Panel links must receive the current tag, panel, and query parameters.',
+        );
+        self::assertSame(
+            '/action/download/request-1?Log%5Blevel%5D=error',
+            $context->actionUrl('download'),
+            'Action links must receive the current tag and query parameters.',
+        );
+    }
+
+    public function testBuildsUrlsWithExplicitTargetsAndParameters(): void
+    {
+        $context = new PanelRenderContext(
+            'request-1',
+            'log',
+            ['page' => 2],
+            'light',
+            self::urlGenerator(),
+        );
+
+        self::assertSame(
+            '/history',
+            $context->historyUrl([]),
+            'An explicit empty query must clear history state.',
+        );
+        self::assertSame(
+            '/panel/request-1/db?Db%5Btype%5D=SELECT',
+            $context->panelUrl('db', ['Db' => ['type' => 'SELECT']]),
+            'Panel links must accept a different panel and query.',
+        );
+        self::assertSame(
+            '/action/explain/request-1?seq=3',
+            $context->actionUrl('explain', ['seq' => 3]),
+            'Action links must accept an explicit query.',
+        );
+    }
+
+    private static function urlGenerator(): DebugUrlGeneratorInterface
+    {
+        return new class implements DebugUrlGeneratorInterface {
+            public function action(string $action, string $tag, array $queryParams = []): string
+            {
+                return self::url("/action/{$action}/{$tag}", $queryParams);
+            }
+
+            public function history(array $queryParams = []): string
+            {
+                return self::url('/history', $queryParams);
+            }
+
+            public function panel(string $tag, string $panel, array $queryParams = []): string
+            {
+                return self::url("/panel/{$tag}/{$panel}", $queryParams);
+            }
+
+            /**
+             * @param array<array-key, mixed> $queryParams
+             */
+            private static function url(string $path, array $queryParams): string
+            {
+                return $queryParams === [] ? $path : $path . '?' . http_build_query($queryParams);
+            }
+        };
+    }
+}

From 7d88ebffbaeb91d413b5d05d41535c0a7835c87f Mon Sep 17 00:00:00 2001
From: Wilmer Arambula <terabytesoftw@gmail.com>
Date: Tue, 18 Aug 2026 20:52:21 -0400
Subject: [PATCH 2/2] Apply fixed Coderabbitai review.

---
 src/Data/PageSize.php                         |   8 +-
 tests/Data/PageSizeTest.php                   |  16 +++
 .../Panel/Asset/AssetSectionRendererTest.php  | 133 +++++++++++-------
 3 files changed, 104 insertions(+), 53 deletions(-)

diff --git a/src/Data/PageSize.php b/src/Data/PageSize.php
index 6f87318..ae5565c 100644
--- a/src/Data/PageSize.php
+++ b/src/Data/PageSize.php
@@ -32,14 +32,18 @@ final class PageSize
     public const array OPTIONS = ['10', '25', '50', '100', 'all'];
 
     /**
-     * Returns the raw `per-page` value for the selector's selected state, falling back to the default.
+     * Returns the `per-page` selector state, canonicalizing `all` and falling back to the default.
      *
      * @param string|null $raw Raw `per-page` query-parameter value, or `null` when absent.
      * @param int $default Page size used when no value is supplied.
      */
     public static function current(string|null $raw, int $default = self::DEFAULT): string
     {
-        return $raw ?? (string) $default;
+        if ($raw === null) {
+            return (string) $default;
+        }
+
+        return strcasecmp($raw, 'all') === 0 ? 'all' : $raw;
     }
 
     /**
diff --git a/tests/Data/PageSizeTest.php b/tests/Data/PageSizeTest.php
index 109c49d..124a332 100644
--- a/tests/Data/PageSizeTest.php
+++ b/tests/Data/PageSizeTest.php
@@ -27,6 +27,11 @@ public function testCurrentFallsBackToTheDefaultWhenNoValueIsSupplied(): void
             PageSize::current('all'),
             'Raw values must pass through untouched.',
         );
+        self::assertSame(
+            'all',
+            PageSize::current('ALL'),
+            "The 'all' keyword must canonicalize to lowercase.",
+        );
         self::assertSame(
             '25',
             PageSize::current(null, 25),
@@ -114,4 +119,15 @@ public function testSelectorHtmlMarksTheCurrentOptionSelected(): void
             'Label span must carry its class.',
         );
     }
+
+    public function testSelectorHtmlSelectsCanonicalizedAllKeyword(): void
+    {
+        $html = PageSize::selectorHtml(PageSize::current('ALL'));
+
+        self::assertStringContainsString(
+            '<option value="all" selected>',
+            $html,
+            "The canonicalized 'all' keyword must select the matching option.",
+        );
+    }
 }
diff --git a/tests/Panel/Asset/AssetSectionRendererTest.php b/tests/Panel/Asset/AssetSectionRendererTest.php
index 359be5c..99b147f 100644
--- a/tests/Panel/Asset/AssetSectionRendererTest.php
+++ b/tests/Panel/Asset/AssetSectionRendererTest.php
@@ -4,6 +4,7 @@
 
 namespace PHPForge\Debug\Tests\Panel\Asset;
 
+use PHPForge\Debug\Helper\Icon;
 use PHPForge\Debug\Panel\Asset\{AssetBundleNormalizer, AssetBundleRow, AssetSectionRenderer};
 use PHPUnit\Framework\Attributes\Group;
 use PHPUnit\Framework\TestCase;
@@ -17,45 +18,39 @@ final class AssetSectionRendererTest extends TestCase
 {
     public function testRenderHeaderIncludesAccessibleTitleAndAllStatistics(): void
     {
-        $summary = (new AssetBundleNormalizer())->normalize(self::rows());
+        $summary = (new AssetBundleNormalizer())
+            ->normalize(self::headerRows());
 
-        $html = AssetSectionRenderer::renderHeader($summary);
+        $assetIcon = Icon::render('asset');
+        $cssIcon = Icon::render('brand-css3');
+        $jsIcon = Icon::render('brand-javascript');
+        $depsIcon = Icon::render('link');
 
-        self::assertStringContainsString(
-            'yii-debug-sr-only',
-            $html,
-            'The panel title must remain accessible.',
-        );
-        self::assertStringContainsString(
-            'yii-debug-asset-stats',
-            $html,
-            'The statistics strip must render.',
-        );
-        self::assertStringContainsString(
-            'data-kind="bundles"',
-            $html,
-            'Bundle count must render.',
-        );
-        self::assertStringContainsString(
-            'data-kind="css"',
-            $html,
-            'CSS count must render.',
-        );
-        self::assertStringContainsString(
-            'data-kind="js"',
-            $html,
-            'JavaScript count must render.',
-        );
-        self::assertStringContainsString(
-            'data-kind="deps"',
-            $html,
-            'Dependency count must render.',
+        self::assertSame(
+            <<<HTML
+            <h1 class="yii-debug-sr-only">
+            Asset Bundles
+            </h1><header class="yii-debug-asset-stats">
+            <div class="yii-debug-asset-stat" data-kind="bundles">
+            <span class="yii-debug-asset-stat-icon" aria-hidden="true">{$assetIcon}</span><strong class="yii-debug-asset-stat-value">2</strong><span class="yii-debug-asset-stat-label">bundles</span>
+            </div><div class="yii-debug-asset-stat" data-kind="css">
+            <span class="yii-debug-asset-stat-icon" aria-hidden="true">{$cssIcon}</span><strong class="yii-debug-asset-stat-value">3</strong><span class="yii-debug-asset-stat-label">css</span>
+            </div><div class="yii-debug-asset-stat" data-kind="js">
+            <span class="yii-debug-asset-stat-icon" aria-hidden="true">{$jsIcon}</span><strong class="yii-debug-asset-stat-value">2</strong><span class="yii-debug-asset-stat-label">js</span>
+            </div><div class="yii-debug-asset-stat" data-kind="deps">
+            <span class="yii-debug-asset-stat-icon" aria-hidden="true">{$depsIcon}</span><strong class="yii-debug-asset-stat-value">2</strong><span class="yii-debug-asset-stat-label">links</span>
+            </div>
+            </header>
+            HTML,
+            AssetSectionRenderer::renderHeader($summary),
+            'The header must render the accessible title and exact aggregate statistics.',
         );
     }
 
     public function testRenderInventoryReturnsEmptyStringWithoutBundles(): void
     {
-        $summary = (new AssetBundleNormalizer())->normalize([]);
+        $summary = (new AssetBundleNormalizer())
+            ->normalize([]);
 
         self::assertSame(
             '',
@@ -66,42 +61,78 @@ public function testRenderInventoryReturnsEmptyStringWithoutBundles(): void
 
     public function testRenderInventoryUsesOrderedListAndSharedCards(): void
     {
-        $summary = (new AssetBundleNormalizer())->normalize(self::rows());
+        $summary = (new AssetBundleNormalizer())->normalize(self::inventoryRows());
 
-        $html = AssetSectionRenderer::renderInventory($summary);
+        $assetIcon = Icon::render('asset');
 
-        self::assertStringContainsString(
-            'yii-debug-asset-list',
-            $html,
-            'Inventory must use the shared list class.',
-        );
-        self::assertStringContainsString(
-            'yii-debug-asset-list-item',
-            $html,
-            'Each bundle must use a list item.',
-        );
-        self::assertStringContainsString(
-            'yii-debug-asset-card',
-            $html,
-            'Each bundle must render as a shared card.',
+        self::assertSame(
+            <<<HTML
+            <ol class="yii-debug-asset-list">
+            <li class="yii-debug-asset-list-item">
+            <article class="yii-debug-asset-card" id="app\assets\-app-asset">
+            <header class="yii-debug-asset-card-head">
+            <span class="yii-debug-asset-card-icon" aria-hidden="true">{$assetIcon}</span><div class="yii-debug-asset-card-title">
+            <h2 class="yii-debug-asset-card-name">
+            AppAsset
+            </h2><span class="yii-debug-asset-card-fqcn">app\assets\</span>
+            </div><div class="yii-debug-asset-card-meta">
+            </div>
+            </header>
+            </article>
+            </li><li class="yii-debug-asset-list-item">
+            <article class="yii-debug-asset-card" id="vendor\assets\-vendor-asset">
+            <header class="yii-debug-asset-card-head">
+            <span class="yii-debug-asset-card-icon" aria-hidden="true">{$assetIcon}</span><div class="yii-debug-asset-card-title">
+            <h2 class="yii-debug-asset-card-name">
+            VendorAsset
+            </h2><span class="yii-debug-asset-card-fqcn">vendor\assets\</span>
+            </div><div class="yii-debug-asset-card-meta">
+            </div>
+            </header>
+            </article>
+            </li>
+            </ol>
+            HTML,
+            AssetSectionRenderer::renderInventory($summary),
+            'Inventory must render exactly two cards in registration order inside an ordered list.',
         );
     }
 
     /**
      * @return list<AssetBundleRow>
      */
-    private static function rows(): array
+    private static function headerRows(): array
     {
         return [
             new AssetBundleRow(
                 'app\\assets\\AppAsset',
                 '',
-                '/assets',
-                '/assets',
+                '',
+                '',
                 ['site.css'],
                 ['site.js'],
                 ['yii\\web\\YiiAsset'],
             ),
+            new AssetBundleRow(
+                'vendor\\assets\\VendorAsset',
+                '',
+                '',
+                '',
+                ['vendor.css', 'theme.css'],
+                ['vendor.js'],
+                ['vendor\\base\\BaseAsset'],
+            ),
+        ];
+    }
+
+    /**
+     * @return list<AssetBundleRow>
+     */
+    private static function inventoryRows(): array
+    {
+        return [
+            new AssetBundleRow('app\\assets\\AppAsset', '', '', '', [], [], []),
+            new AssetBundleRow('vendor\\assets\\VendorAsset', '', '', '', [], [], []),
         ];
     }
 }