~',
+ $html,
+ "{$label} must remain a compact metric.",
+ );
+ }
+ self::assertMatchesRegularExpression(
+ '~
\s*
\s*Path\s* ~',
+ $html,
+ 'Path tiles must remain wide regardless of their short value.',
+ );
+ }
+
public function testRenderViaNormalizerSnapshotProducesExpectedAnchors(): void
{
$body = <<<'HTML'
diff --git a/tests/Storage/DebugValueTest.php b/tests/Storage/DebugValueTest.php
index b153740..07930de 100644
--- a/tests/Storage/DebugValueTest.php
+++ b/tests/Storage/DebugValueTest.php
@@ -224,6 +224,25 @@ public function testCaptureNormalizesInvalidUtf8ThrowableMessage(): void
'A binary throwable message must remain JSON-safe.',
);
}
+ public function testCapturePreservesNullAsItsOwnTaggedValue(): void
+ {
+ $value = DebugValue::capture(null);
+
+ self::assertSame(
+ 'null',
+ $value->type,
+ 'Null must retain its dedicated type tag.',
+ );
+ self::assertSame(
+ ['type' => 'null'],
+ $value->jsonSerialize(),
+ 'Serialized null must not fall through to another scalar or unsupported type.',
+ );
+ self::assertNull(
+ $value->toDisplayValue(),
+ 'The display value for the null tag must remain null.',
+ );
+ }
public function testCapturePreservesTheArrayDepthBoundary(): void
{
diff --git a/tests/Support/MockerExtension.php b/tests/Support/MockerExtension.php
index f31a2d2..a7147ef 100644
--- a/tests/Support/MockerExtension.php
+++ b/tests/Support/MockerExtension.php
@@ -59,7 +59,9 @@ public static function load(): void
{
$mocks = [];
- foreach (['function_exists', 'ob_get_clean', 'ob_start', 'phpinfo'] as $name) {
+ foreach (
+ ['function_exists', 'ob_get_clean', 'ob_start', 'phpinfo', 'posix_getpwuid', 'posix_getuid'] as $name
+ ) {
$mocks[] = [
'namespace' => 'PHPForge\Debug\PhpInfo',
'name' => $name,
@@ -73,6 +75,13 @@ public static function load(): void
];
}
+ foreach (['PHPForge\\Debug\\Panel\\Mail', 'PHPForge\\Debug\\Panel\\User'] as $namespace) {
+ $mocks[] = [
+ 'namespace' => $namespace,
+ 'name' => 'time',
+ ];
+ }
+
(new Mocker(stubPath: __DIR__ . '/mocker-stubs.php'))->load($mocks);
MockerState::saveState();
diff --git a/tests/Theme/ThemeResolverTest.php b/tests/Theme/ThemeResolverTest.php
new file mode 100644
index 0000000..c09a20b
--- /dev/null
+++ b/tests/Theme/ThemeResolverTest.php
@@ -0,0 +1,64 @@
+ ['dark']], []),
+ 'Non-string cookie values must resolve to light.',
+ );
+ self::assertSame(
+ 'light',
+ ThemeResolver::resolve([], ['yii_debug_theme' => 'solarized']),
+ 'Unknown theme names must resolve to light.',
+ );
+ }
+
+ public function testResolveMatchesDarkCaseInsensitively(): void
+ {
+ self::assertSame(
+ 'dark',
+ ThemeResolver::resolve(['yii-debug-toolbar-theme' => 'DARK'], []),
+ 'The dark keyword must match case-insensitively.',
+ );
+ }
+
+ public function testResolvePrefersTheCookieOverTheQueryParameter(): void
+ {
+ self::assertSame(
+ 'light',
+ ThemeResolver::resolve(['yii-debug-toolbar-theme' => 'light'], ['yii_debug_theme' => 'dark']),
+ 'The persisted cookie must outrank the link-time query parameter.',
+ );
+ }
+
+ public function testResolveReadsTheQueryParameterWhenNoCookieIsSet(): void
+ {
+ self::assertSame(
+ 'dark',
+ ThemeResolver::resolve([], ['yii_debug_theme' => 'dark']),
+ 'The query parameter must apply when no cookie is present.',
+ );
+ }
+}
diff --git a/tests/View/Grid/ActiveFilterBannerTest.php b/tests/View/Grid/ActiveFilterBannerTest.php
new file mode 100644
index 0000000..8149c60
--- /dev/null
+++ b/tests/View/Grid/ActiveFilterBannerTest.php
@@ -0,0 +1,75 @@
+ '404', 'url' => 'admin'],
+ static fn(array $without): string => '/debug?without=' . implode(',', $without),
+ );
+
+ self::assertStringContainsString(
+ 'href="/debug?without=statusCode"',
+ $html,
+ 'Pill link must drop only its own attribute.',
+ );
+ self::assertStringContainsString(
+ 'href="/debug?without=statusCode,url"',
+ $html,
+ 'Clear-all link must drop every active attribute.',
+ );
+ }
+
+ public function testRenderEmitsOnePillPerActiveFilter(): void
+ {
+ $html = ActiveFilterBanner::render(
+ ['statusCode' => '404', 'url' => 'admin'],
+ static fn(array $without): string => '/debug',
+ );
+
+ self::assertSame(2, substr_count($html, 'yii-debug-active-filter-pill'), 'One pill per active filter.');
+ self::assertStringContainsString('2 filters active', $html, 'Plural count label must surface.');
+ self::assertStringContainsString('statusCode', $html, 'Attribute names must surface inside the pills.');
+ self::assertStringContainsString('404', $html, 'Filter values must surface inside the pills.');
+ self::assertStringContainsString('Clear all', $html, 'The clear-all action must render.');
+ self::assertStringContainsString('aria-label="Active filters"', $html, 'Group must carry its accessible name.');
+ }
+
+ public function testRenderReturnsEmptyStringWhenNoFiltersAreActive(): void
+ {
+ self::assertSame(
+ '',
+ ActiveFilterBanner::render([], static fn(array $without): string => '/debug'),
+ 'No active filters must render no banner.',
+ );
+ }
+
+ public function testRenderUsesSingularLabelForOneFilter(): void
+ {
+ self::assertStringContainsString(
+ '1 filter active',
+ ActiveFilterBanner::render(['url' => 'admin'], static fn(array $without): string => '/debug'),
+ 'Single filter must use the singular label.',
+ );
+ }
+}
diff --git a/tests/View/Grid/RowClassTest.php b/tests/View/Grid/RowClassTest.php
new file mode 100644
index 0000000..be1a965
--- /dev/null
+++ b/tests/View/Grid/RowClassTest.php
@@ -0,0 +1,43 @@
+ 'yii-debug-row-danger'],
+ RowClass::for('error'),
+ "The 'error' level must alias to the danger class.",
+ );
+ }
+
+ public function testForMapsKnownLevelsToRowClasses(): void
+ {
+ self::assertSame(['class' => 'yii-debug-row-success'], RowClass::for('success'), 'Success must map.');
+ self::assertSame(['class' => 'yii-debug-row-info'], RowClass::for('info'), 'Info must map.');
+ self::assertSame(['class' => 'yii-debug-row-warning'], RowClass::for('warning'), 'Warning must map.');
+ self::assertSame(['class' => 'yii-debug-row-danger'], RowClass::for('danger'), 'Danger must map.');
+ }
+
+ public function testForReturnsEmptyArrayForUnknownOrNullLevels(): void
+ {
+ self::assertSame([], RowClass::for(null), '`null` must yield no class.');
+ self::assertSame([], RowClass::for(''), 'Empty string must yield no class.');
+ self::assertSame([], RowClass::for('primary'), 'Unknown levels must yield no class.');
+ }
+}
diff --git a/tests/View/History/HistoryCellRendererTest.php b/tests/View/History/HistoryCellRendererTest.php
new file mode 100644
index 0000000..5769083
--- /dev/null
+++ b/tests/View/History/HistoryCellRendererTest.php
@@ -0,0 +1,399 @@
+ 'abc',
+ 'method' => 'GET',
+ 'url' => '/path',
+ 'statusCode' => 200,
+ 'time' => 1_700_000_000,
+ 'ajax' => true,
+ ]);
+
+ $options = HistoryCellRenderer::buildRowAttributes($row, false);
+
+ self::assertSame(
+ [
+ 'tag' => 'abc',
+ 'method' => 'GET',
+ 'url' => '/path',
+ 'status' => '200',
+ 'time' => date('H:i:s', 1_700_000_000),
+ 'ajax' => '1',
+ ],
+ [
+ 'tag' => $options['data-yii-debug-tag'] ?? null,
+ 'method' => $options['data-yii-debug-method'] ?? null,
+ 'url' => $options['data-yii-debug-url'] ?? null,
+ 'status' => $options['data-yii-debug-status'] ?? null,
+ 'time' => $options['data-yii-debug-time'] ?? null,
+ 'ajax' => $options['data-yii-debug-ajax'] ?? null,
+ ],
+ 'Row data-yii-debug-* attributes must mirror the typed row.',
+ );
+ self::assertArrayNotHasKey('class', $options, 'Non-critical rows must not carry a row class.');
+ }
+
+ public function testBuildRowAttributesFlagsCriticalStatusCodesWithDangerHighlight(): void
+ {
+ $options = HistoryCellRenderer::buildRowAttributes(self::row(['statusCode' => 500]), true);
+
+ self::assertIsString($options['class'] ?? null, 'class entry must be a string.');
+ self::assertStringContainsString(
+ 'yii-debug-row-danger',
+ $options['class'],
+ 'Critical status codes must surface the danger highlight class.',
+ );
+ }
+
+ public function testRenderAjaxCellMapsBoolToYesOrNo(): void
+ {
+ self::assertSame(
+ 'Yes',
+ HistoryCellRenderer::renderAjaxCell(self::row(['ajax' => true])),
+ "Boolean ajax value must map to 'Yes'.",
+ );
+ self::assertSame(
+ 'No',
+ HistoryCellRenderer::renderAjaxCell(self::row(['ajax' => false])),
+ "Boolean ajax value must map to 'No'.",
+ );
+ }
+
+ public function testRenderDurationCellFormatsMilliseconds(): void
+ {
+ self::assertSame(
+ '125 ms',
+ HistoryCellRenderer::renderDurationCell(self::row(['processingTime' => 0.125]), 0.0),
+ "Seconds must format as 'X ms'.",
+ );
+ self::assertSame(
+ '2,000 ms',
+ HistoryCellRenderer::renderDurationCell(self::row(['processingTime' => 2.0]), 0.0),
+ 'Second-scale durations must keep the thousands separator.',
+ );
+ }
+
+ public function testRenderDurationCellScalesGaugeAgainstPageMaximum(): void
+ {
+ $html = HistoryCellRenderer::renderDurationCell(self::row(['processingTime' => 0.125]), 0.25);
+
+ self::assertSame(
+ '
'
+ . '125 ms '
+ . ' ',
+ $html,
+ 'Rail must sit at half the page maximum.',
+ );
+ self::assertStringContainsString(
+ '--yii-debug-gauge: 100%;',
+ HistoryCellRenderer::renderDurationCell(self::row(['processingTime' => 0.25]), 0.25),
+ 'The slowest row must fill its rail.',
+ );
+ self::assertStringContainsString(
+ '--yii-debug-gauge: 0%;',
+ HistoryCellRenderer::renderDurationCell(self::row(['processingTime' => 0.0]), 0.25),
+ 'A zero measurement must show an empty rail.',
+ );
+ }
+
+ public function testRenderDurationCellShowsNotSetWhenMissing(): void
+ {
+ $html = HistoryCellRenderer::renderDurationCell(self::row([]), 0.25);
+
+ self::assertStringContainsString('(not set)', $html, 'Missing duration must surface the muted placeholder.');
+ self::assertStringNotContainsString('yii-debug-gauge', $html, 'Missing duration must not draw a rail.');
+ }
+
+ public function testRenderMemoryCellFormatsMb(): void
+ {
+ self::assertSame(
+ '2.000 MB',
+ HistoryCellRenderer::renderMemoryCell(self::row(['peakMemory' => 2097152]), 0),
+ "Bytes must format as 'X.XXX MB'.",
+ );
+ }
+
+ public function testRenderMemoryCellScalesGaugeAgainstPageMaximum(): void
+ {
+ $html = HistoryCellRenderer::renderMemoryCell(self::row(['peakMemory' => 2097152]), 4194304);
+
+ self::assertStringContainsString('--yii-debug-gauge: 50%;', $html, 'Rail must sit at half the page maximum.');
+ self::assertStringContainsString('2.000 MB', $html, 'Readout must keep its formatted value.');
+ }
+
+ public function testRenderMemoryCellShowsNotSetWhenMissing(): void
+ {
+ $html = HistoryCellRenderer::renderMemoryCell(self::row([]), 4194304);
+
+ self::assertStringContainsString('(not set)', $html, 'Missing peak memory must surface the muted placeholder.');
+ self::assertStringNotContainsString('yii-debug-gauge', $html, 'Missing peak memory must not draw a rail.');
+ }
+
+ public function testRenderMethodCellRendersVocabularyColoredText(): void
+ {
+ self::assertSame(
+ '
GET ',
+ HistoryCellRenderer::renderMethodCell(self::row(['method' => 'GET'])),
+ "GET must wear the 'get' verb class.",
+ );
+ self::assertStringContainsString(
+ 'yii-debug-verb-put',
+ HistoryCellRenderer::renderMethodCell(self::row(['method' => 'PATCH'])),
+ "PATCH must share the 'put' verb hue.",
+ );
+ self::assertStringContainsString(
+ 'yii-debug-verb-other',
+ HistoryCellRenderer::renderMethodCell(self::row(['method' => 'COMMAND'])),
+ "COMMAND must fall back to the 'other' verb.",
+ );
+ }
+
+ public function testRenderMethodCellReturnsEmptyStringForUncapturedMethod(): void
+ {
+ self::assertSame(
+ '',
+ HistoryCellRenderer::renderMethodCell(self::row(['method' => ''])),
+ 'An uncaptured method must render nothing.',
+ );
+ }
+
+ public function testRenderSqlCountCellEmitsWarningGlyphWhenCountIsCritical(): void
+ {
+ $row = self::row(['tag' => 'flood', 'sqlCount' => 500, 'excessiveCallersCount' => 0]);
+
+ $html = HistoryCellRenderer::renderSqlCountCell($row, '/debug/view?panel=db&tag=flood', true, 100);
+
+ self::assertStringContainsString('⚠', $html, 'Critical counts must surface the warning glyph.');
+ self::assertStringContainsString('Too many queries', $html, 'Warning tooltip must explain the breach.');
+ self::assertStringContainsString(
+ 'panel=db&tag=flood',
+ $html,
+ 'SQL count must link to the request database panel.',
+ );
+ }
+
+ public function testRenderSqlCountCellPluralizesExcessiveCallersCount(): void
+ {
+ $row = self::row(['tag' => 'flood', 'sqlCount' => 10, 'excessiveCallersCount' => 4]);
+
+ self::assertStringContainsString(
+ '4 callers are making too many calls.',
+ HistoryCellRenderer::renderSqlCountCell($row, '/db', false, 100),
+ 'Multiple excessive callers must surface the plural tooltip form.',
+ );
+ }
+
+ public function testRenderSqlCountCellRendersPlainCountWhenNotCritical(): void
+ {
+ $row = self::row(['tag' => 'low', 'sqlCount' => 3, 'excessiveCallersCount' => 0]);
+
+ $html = HistoryCellRenderer::renderSqlCountCell($row, '/db', false, 100);
+
+ self::assertStringContainsString('>3<', $html, 'Plain SQL count must surface as the bare integer.');
+ self::assertStringNotContainsString('⚠', $html, 'Non-critical counts must NOT carry the warning glyph.');
+ }
+
+ public function testRenderSqlCountCellSingularizesSingleExcessiveCaller(): void
+ {
+ $row = self::row(['tag' => 'flood', 'sqlCount' => 10, 'excessiveCallersCount' => 1]);
+
+ self::assertStringContainsString(
+ '1 caller is making too many calls.',
+ HistoryCellRenderer::renderSqlCountCell($row, '/db', false, 100),
+ 'A single excessive caller must surface the singular tooltip form.',
+ );
+ }
+
+ public function testRenderStatusCellMapsCommandWithZeroToSuccess(): void
+ {
+ self::assertSame(
+ '
200 ',
+ HistoryCellRenderer::renderStatusCell(self::row(['method' => 'COMMAND', 'statusCode' => 0])),
+ "COMMAND with status '0' must display as status '200'.",
+ );
+ }
+
+ public function testRenderStatusCellMapsRangeToStatusClass(): void
+ {
+ self::assertStringContainsString(
+ 'yii-debug-badge yii-debug-status-2xx',
+ HistoryCellRenderer::renderStatusCell(self::row(['statusCode' => 200])),
+ "Status code '200' must map to '2xx'.",
+ );
+ self::assertStringContainsString(
+ 'yii-debug-status-3xx',
+ HistoryCellRenderer::renderStatusCell(self::row(['statusCode' => 301])),
+ "Status code '301' must map to '3xx'.",
+ );
+ self::assertStringContainsString(
+ 'yii-debug-status-4xx',
+ HistoryCellRenderer::renderStatusCell(self::row(['statusCode' => 404])),
+ "Status code '404' must map to '4xx'.",
+ );
+ self::assertStringContainsString(
+ 'yii-debug-status-5xx',
+ HistoryCellRenderer::renderStatusCell(self::row(['statusCode' => 500])),
+ "Status code '500' must map to '5xx'.",
+ );
+ }
+
+ public function testRenderSummaryEchoesBucketPills(): void
+ {
+ $summary = new HistorySummary(
+ totalRequests: 5,
+ statusBuckets: [
+ new HistoryStatusBucket(label: '2xx', count: 4, sampleCode: 200, variant: '2xx'),
+ new HistoryStatusBucket(label: '4xx', count: 1, sampleCode: 404, variant: '4xx'),
+ ],
+ statusCodeFilter: null,
+ );
+
+ $html = HistoryCellRenderer::renderSummary(
+ $summary,
+ ['2xx' => '/debug?Debug%5BstatusCode%5D=200', '4xx' => '/debug?Debug%5BstatusCode%5D=404'],
+ '
',
+ );
+
+ self::assertStringContainsString('captured requests', $html, 'Multiple requests must use the plural label.');
+ self::assertStringContainsString(
+ 'yii-debug-grid-summary-stat-2xx',
+ $html,
+ "'2xx' pill must carry the '2xx' status class.",
+ );
+ self::assertStringContainsString(
+ 'yii-debug-grid-summary-stat-4xx',
+ $html,
+ "'4xx' pill must carry the '4xx' status class.",
+ );
+ self::assertStringContainsString(
+ 'Debug%5BstatusCode%5D=200',
+ $html,
+ "The '2xx' bucket must link to its sample status filter.",
+ );
+ self::assertStringContainsString(
+ 'Debug%5BstatusCode%5D=404',
+ $html,
+ "The '4xx' bucket must link to its sample status filter.",
+ );
+ self::assertStringContainsString(
+ 'yii-debug-grid-pagesize',
+ $html,
+ 'History summary must include the shared page-size selector.',
+ );
+ }
+
+ public function testRenderSummaryReturnsEmptyWhenNoRequestsCaptured(): void
+ {
+ $summary = new HistorySummary(totalRequests: 0, statusBuckets: [], statusCodeFilter: null);
+
+ self::assertSame(
+ '',
+ HistoryCellRenderer::renderSummary($summary, [], ''),
+ 'Empty manifest must skip the header entirely.',
+ );
+ }
+
+ public function testRenderSummaryUsesSingularLabelForOneRequest(): void
+ {
+ $summary = new HistorySummary(totalRequests: 1, statusBuckets: [], statusCodeFilter: null);
+
+ $html = HistoryCellRenderer::renderSummary($summary, [], '');
+
+ self::assertStringContainsString('captured request', $html, 'One request must use the singular label.');
+ self::assertStringNotContainsString('captured requests', $html, 'One request must not use the plural label.');
+ }
+
+ public function testRenderTagCellLinksToPanelView(): void
+ {
+ $html = HistoryCellRenderer::renderTagCell(self::row(['tag' => 'abc']), '/debug/view?tag=abc');
+
+ self::assertStringContainsString('yii-debug-tag-link', $html, 'Tag link must carry the tag-link CSS class.');
+ self::assertStringContainsString('abc', $html, 'Tag value must surface inside the link.');
+ self::assertStringContainsString('tag=abc', $html, 'Tag cell must link to the matching request view.');
+ }
+
+ public function testRenderTimeCellRendersCompactClockWithFullTooltip(): void
+ {
+ $html = HistoryCellRenderer::renderTimeCell(self::row(['time' => 1_700_000_000]));
+
+ self::assertStringContainsString('yii-debug-nowrap', $html, 'Time cell must carry the nowrap CSS class.');
+ self::assertStringContainsString(
+ 'title="' . date('Y-m-d H:i:s', 1_700_000_000) . '"',
+ $html,
+ 'Time cell must carry the full datetime tooltip.',
+ );
+ self::assertStringContainsString(
+ '>' . date('H:i:s', 1_700_000_000) . '<',
+ $html,
+ 'Time cell must render the compact clock string.',
+ );
+ }
+
+ public function testRenderTimeCellShowsNotSetForZeroTimestamp(): void
+ {
+ self::assertStringContainsString(
+ '(not set)',
+ HistoryCellRenderer::renderTimeCell(self::row(['time' => 0])),
+ 'Zero timestamps must surface the muted placeholder.',
+ );
+ }
+
+ public function testRenderUrlCellWrapsUrlInTitleSpan(): void
+ {
+ $html = HistoryCellRenderer::renderUrlCell(self::row(['url' => 'http://example.test/path']));
+
+ self::assertStringContainsString('yii-debug-url-cell', $html, 'URL cell must carry the dedicated class.');
+ self::assertStringContainsString('http://example.test/path', $html, 'URL value must render inside the cell.');
+ }
+
+ /**
+ * @param array
$overrides
+ */
+ private static function row(array $overrides = []): HistoryRow
+ {
+ return HistoryRow::fromSummary(
+ RequestSummary::fromArray(
+ [
+ 'tag' => 'tag-1',
+ 'url' => 'https://example.test/',
+ 'ajax' => false,
+ 'method' => 'GET',
+ 'ip' => '127.0.0.1',
+ 'time' => 1_700_000_000.0,
+ 'statusCode' => 200,
+ 'sqlCount' => 0,
+ 'excessiveCallersCount' => 0,
+ 'mailCount' => 0,
+ 'mailFiles' => [],
+ 'processingTime' => null,
+ 'peakMemory' => null,
+ ...$overrides,
+ ],
+ ),
+ );
+ }
+}
diff --git a/tests/View/History/HistoryRowTest.php b/tests/View/History/HistoryRowTest.php
new file mode 100644
index 0000000..2b9437d
--- /dev/null
+++ b/tests/View/History/HistoryRowTest.php
@@ -0,0 +1,101 @@
+ 1_700_000_000.0]));
+
+ self::assertSame(
+ date('H:i:s', 1_700_000_000),
+ $row->timeCompact,
+ 'A positive capture time must render as a clock string.',
+ );
+ }
+
+ public function testFromSummaryLeavesTimeCompactEmptyWhenTimeIsZero(): void
+ {
+ self::assertSame(
+ '',
+ HistoryRow::fromSummary(self::summary(['time' => 0.0]))->timeCompact,
+ 'A zero capture time must render no clock string.',
+ );
+ }
+
+ public function testFromSummaryPassesEveryFieldThroughUntouched(): void
+ {
+ $row = HistoryRow::fromSummary(
+ self::summary(
+ [
+ 'tag' => 'tag-9',
+ 'url' => 'https://example.test/orders',
+ 'ajax' => true,
+ 'method' => 'POST',
+ 'ip' => '10.0.0.1',
+ 'statusCode' => 404,
+ 'sqlCount' => 7,
+ 'excessiveCallersCount' => 2,
+ 'mailCount' => 1,
+ 'processingTime' => 0.125,
+ 'peakMemory' => 1_048_576,
+ ],
+ ),
+ );
+
+ self::assertSame('tag-9', $row->tag, 'Tag must pass through.');
+ self::assertSame('https://example.test/orders', $row->url, 'URL must pass through.');
+ self::assertTrue($row->ajax, 'AJAX flag must pass through.');
+ self::assertSame('POST', $row->method, 'Method must pass through.');
+ self::assertSame('10.0.0.1', $row->ip, 'IP must pass through.');
+ self::assertSame(404, $row->statusCode, 'Status code must pass through.');
+ self::assertSame(7, $row->sqlCount, 'SQL count must pass through.');
+ self::assertSame(2, $row->excessiveCallersCount, 'Excessive-caller count must pass through.');
+ self::assertSame(1, $row->mailCount, 'Mail count must pass through.');
+ self::assertSame(0.125, $row->processingTime, 'Processing time must pass through.');
+ self::assertSame(1_048_576, $row->peakMemory, 'Peak memory must pass through.');
+ }
+
+ /**
+ * @param array $overrides
+ */
+ private static function summary(array $overrides = []): RequestSummary
+ {
+ return RequestSummary::fromArray(
+ [
+ 'tag' => 'tag-1',
+ 'url' => 'https://example.test/',
+ 'ajax' => false,
+ 'method' => 'GET',
+ 'ip' => '127.0.0.1',
+ 'time' => 1_700_000_000.0,
+ 'statusCode' => 200,
+ 'sqlCount' => 0,
+ 'excessiveCallersCount' => 0,
+ 'mailCount' => 0,
+ 'mailFiles' => [],
+ 'processingTime' => null,
+ 'peakMemory' => null,
+ ...$overrides,
+ ],
+ );
+ }
+}
diff --git a/tests/View/History/HistoryScaleTest.php b/tests/View/History/HistoryScaleTest.php
new file mode 100644
index 0000000..8f55e3f
--- /dev/null
+++ b/tests/View/History/HistoryScaleTest.php
@@ -0,0 +1,76 @@
+maxProcessingTime, 'Largest captured duration must win.');
+ self::assertSame(2_097_152, $scale->maxPeakMemory, 'Largest captured memory must win.');
+ }
+
+ public function testFromModelsReturnsZeroMaximaForEmptyList(): void
+ {
+ $scale = HistoryScale::fromModels([]);
+
+ self::assertSame(0.0, $scale->maxProcessingTime, 'Empty pages must report a `0.0` duration scale.');
+ self::assertSame(0, $scale->maxPeakMemory, 'Empty pages must report a `0` memory scale.');
+ }
+
+ public function testFromModelsReturnsZeroMaximaWhenNoRowCarriesValues(): void
+ {
+ $scale = HistoryScale::fromModels(
+ [self::row(null, null), self::row(null, null)],
+ );
+
+ self::assertSame(0.0, $scale->maxProcessingTime, 'All-`null` durations must collapse the scale to `0.0`.');
+ self::assertSame(0, $scale->maxPeakMemory, 'All-`null` memory must collapse the scale to `0`.');
+ }
+
+ private static function row(float|null $processingTime, int|null $peakMemory): HistoryRow
+ {
+ return HistoryRow::fromSummary(
+ RequestSummary::fromArray(
+ [
+ 'tag' => 'tag-1',
+ 'url' => 'https://example.test/',
+ 'ajax' => false,
+ 'method' => 'GET',
+ 'ip' => '127.0.0.1',
+ 'time' => 1_700_000_000.0,
+ 'statusCode' => 200,
+ 'sqlCount' => 0,
+ 'excessiveCallersCount' => 0,
+ 'mailCount' => 0,
+ 'mailFiles' => [],
+ 'processingTime' => $processingTime,
+ 'peakMemory' => $peakMemory,
+ ],
+ ),
+ );
+ }
+}
diff --git a/tests/View/History/HistorySummaryTest.php b/tests/View/History/HistorySummaryTest.php
new file mode 100644
index 0000000..f4575a7
--- /dev/null
+++ b/tests/View/History/HistorySummaryTest.php
@@ -0,0 +1,235 @@
+summary(200),
+ $this->summary(201),
+ $this->summary(304),
+ $this->summary(404),
+ $this->summary(500),
+ ],
+ );
+
+ $counts = [];
+
+ foreach ($summary->statusBuckets as $bucket) {
+ $counts[$bucket->label] = $bucket->count;
+ }
+
+ self::assertSame(
+ [
+ '2xx' => 2,
+ '3xx' => 1,
+ '4xx' => 1,
+ '5xx' => 1,
+ ],
+ $counts,
+ 'Bucket counts must reflect the manifest distribution.',
+ );
+ }
+
+ public function testFromManifestCountsTypedEntries(): void
+ {
+ $summary = HistorySummary::fromManifest(
+ [
+ $this->summary(200),
+ $this->summary(404),
+ ],
+ );
+
+ self::assertSame(2, $summary->totalRequests, 'Total count must reflect every typed manifest entry.');
+ self::assertCount(2, $summary->statusBuckets, 'Each status family must contribute one bucket.');
+ }
+
+ public function testFromManifestExposesEmptyFilterWhenNoStatusCaptured(): void
+ {
+ $summary = HistorySummary::fromManifest([]);
+
+ self::assertNull(
+ $summary->statusCodeFilter,
+ 'Manifest without captured statuses must yield a null filter dropdown.',
+ );
+ }
+
+ public function testFromManifestExposesFirstSeenSampleCode(): void
+ {
+ $summary = HistorySummary::fromManifest(
+ [
+ $this->summary(201),
+ $this->summary(200),
+ ],
+ );
+
+ $first = $summary->statusBuckets[0] ?? null;
+
+ self::assertNotNull($first, 'Bucket list must be non-empty.');
+ self::assertSame(201, $first->sampleCode, 'Sample code must be the first observed in the bucket.');
+ }
+
+ public function testFromManifestKeepsStatusFamilyBoundariesExclusive(): void
+ {
+ $summary = HistorySummary::fromManifest(
+ [
+ $this->summary(0),
+ $this->summary(199),
+ $this->summary(200),
+ $this->summary(299),
+ $this->summary(300),
+ $this->summary(399),
+ $this->summary(400),
+ $this->summary(499),
+ $this->summary(500),
+ $this->summary(599),
+ $this->summary(600),
+ ],
+ );
+
+ $counts = [];
+
+ foreach ($summary->statusBuckets as $bucket) {
+ $counts[$bucket->label] = $bucket->count;
+ }
+
+ self::assertSame(
+ [
+ '2xx' => 2,
+ '3xx' => 2,
+ '4xx' => 2,
+ '5xx' => 2,
+ ],
+ $counts,
+ 'Each status family must include its lower boundary and exclude the next family boundary.',
+ );
+ self::assertSame(
+ [
+ 199 => 199,
+ 200 => 200,
+ 299 => 299,
+ 300 => 300,
+ 399 => 399,
+ 400 => 400,
+ 499 => 499,
+ 500 => 500,
+ 599 => 599,
+ 600 => 600,
+ ],
+ $summary->statusCodeFilter,
+ 'Status filter must keep positive codes while excluding an uncaptured zero status.',
+ );
+ }
+
+ public function testFromManifestMapsBucketsToVocabularyStatusClasses(): void
+ {
+ $summary = HistorySummary::fromManifest(
+ [
+ $this->summary(200),
+ $this->summary(301),
+ $this->summary(404),
+ $this->summary(500),
+ ],
+ );
+
+ $variants = [];
+
+ foreach ($summary->statusBuckets as $bucket) {
+ $variants[$bucket->label] = $bucket->variant;
+ }
+
+ self::assertSame(
+ [
+ '2xx' => '2xx',
+ '3xx' => '3xx',
+ '4xx' => '4xx',
+ '5xx' => '5xx',
+ ],
+ $variants,
+ 'Bucket variants must equal their status-class labels.',
+ );
+ }
+
+ public function testFromManifestReturnsEmptyForEmptyManifest(): void
+ {
+ $summary = HistorySummary::fromManifest([]);
+
+ self::assertSame(0, $summary->totalRequests, 'Empty manifest must yield zero total requests.');
+ self::assertSame([], $summary->statusBuckets, 'Empty manifest must yield no buckets.');
+ self::assertNull($summary->statusCodeFilter, 'Empty manifest must yield a null filter dropdown.');
+ }
+
+ public function testFromManifestSkipsRequestsWithStatusBelow200(): void
+ {
+ $summary = HistorySummary::fromManifest(
+ [
+ $this->summary(100),
+ $this->summary(200),
+ ],
+ );
+
+ $first = $summary->statusBuckets[0] ?? null;
+
+ self::assertNotNull($first, "Bucket list must surface the '200' entry.");
+ self::assertSame(1, $first->count, "Status '100' must not contribute to any bucket.");
+ }
+
+ public function testFromManifestSortsUniqueStatusCodes(): void
+ {
+ $summary = HistorySummary::fromManifest(
+ [
+ $this->summary(404),
+ $this->summary(200),
+ $this->summary(200),
+ $this->summary(302),
+ ],
+ );
+
+ self::assertSame(
+ [
+ 200 => 200,
+ 302 => 302,
+ 404 => 404,
+ ],
+ $summary->statusCodeFilter,
+ 'Filter map must list unique status codes in ascending order.',
+ );
+ }
+
+ private function summary(int $statusCode): RequestSummary
+ {
+ return new RequestSummary(
+ tag: 'tag-' . $statusCode,
+ url: 'https://example.test',
+ ajax: false,
+ method: 'GET',
+ ip: '127.0.0.1',
+ time: 1_700_000_000.0,
+ statusCode: $statusCode,
+ sqlCount: 0,
+ excessiveCallersCount: 0,
+ mailCount: 0,
+ mailFiles: [],
+ processingTime: null,
+ peakMemory: null,
+ );
+ }
+}
diff --git a/tests/View/Sidebar/SidebarRendererTest.php b/tests/View/Sidebar/SidebarRendererTest.php
new file mode 100644
index 0000000..51c306c
--- /dev/null
+++ b/tests/View/Sidebar/SidebarRendererTest.php
@@ -0,0 +1,255 @@
+]*title="History"[^>]*aria-current="page">/',
+ $html,
+ 'The active link must preserve its base class, tooltip, and current-page marker.',
+ );
+ }
+
+ public function testRenderEmitsCursorButtonsWhenSnapshotIsCursor(): void
+ {
+ $view = new SidebarView(snapshot: $this->snapshot(isCursor: true), navItems: []);
+
+ $html = SidebarRenderer::render($view);
+
+ self::assertStringContainsString(
+ 'data-yii-debug-cursor="newest"',
+ $html,
+ 'Cursor mode must emit the Newest cursor button.',
+ );
+ self::assertStringContainsString(
+ 'data-yii-debug-cursor="older"',
+ $html,
+ 'Cursor mode must emit the Older cursor button.',
+ );
+ self::assertStringContainsString('snapshot(isCursor: true, cursorInitTag: 'init-tag'), navItems: []);
+
+ $html = SidebarRenderer::render($view);
+
+ self::assertStringContainsString(
+ 'data-yii-debug-history-cursor="true"',
+ $html,
+ 'Cursor mode must emit a true history-cursor marker.',
+ );
+ self::assertStringContainsString(
+ 'data-yii-debug-cursor-init="init-tag"',
+ $html,
+ 'Cursor init tag must surface as data attribute.',
+ );
+ }
+
+ public function testRenderEmitsIconSpanWhenNavItemDeclaresIconSvg(): void
+ {
+ $view = new SidebarView(
+ snapshot: null,
+ navItems: [
+ new SidebarNavItem(
+ label: 'Request',
+ iconSvg: ']*aria-label="Newer captured request">/',
+ $html,
+ 'A missing newer capture must render a disabled button.',
+ );
+ self::assertMatchesRegularExpression(
+ '/]*href="[^"]*tag=older"[^>]*aria-label="Older captured request">/',
+ $html,
+ 'An available older capture must render an anchor to its tag.',
+ );
+ self::assertStringNotContainsString(
+ 'data-yii-debug-cursor=',
+ $html,
+ 'Navigation mode must NOT emit cursor buttons.',
+ );
+ }
+
+ private function snapshot(
+ bool $isCursor = false,
+ bool $isAjax = true,
+ int $statusCode = 200,
+ string $time = '12:34:56',
+ string $cursorInitTag = '',
+ ): SidebarSnapshot {
+ return new SidebarSnapshot(
+ title: $isCursor ? 'Newest request' : 'Current request',
+ ariaLabel: $isCursor ? 'Newest captured request' : 'Current request',
+ method: 'GET',
+ path: '/index.php',
+ fullUrl: 'http://example.test/index.php',
+ statusCode: $statusCode,
+ statusVariant: $statusCode >= 500 ? '5xx' : '2xx',
+ time: $time,
+ isAjax: $isAjax,
+ isCursor: $isCursor,
+ cursorInitTag: $cursorInitTag,
+ newestUrl: '/debug/view',
+ oldestUrl: '/debug/view?tag=oldest',
+ newerUrl: '',
+ olderUrl: '/debug/view?tag=older',
+ isNewest: true,
+ isOldest: false,
+ hasNewer: false,
+ hasOlder: true,
+ );
+ }
+}