feat: polish homepage catalog stats

This commit is contained in:
ginnoir
2026-06-09 03:54:26 -05:00
parent e566ef4a51
commit 759d4a6b86
4 changed files with 495 additions and 20 deletions
+275 -12
View File
@@ -159,35 +159,130 @@ h1 {
line-height: 1.6;
}
.hero-stats {
display: grid;
grid-template-columns: repeat(3, minmax(6rem, 1fr));
gap: 0.75rem;
min-width: 25rem;
.hero-stats-panel {
width: min(52rem, 100%);
}
.hero-stats div {
.hero-stats-panel summary {
display: none;
}
.hero-stats {
display: grid;
grid-template-columns: repeat(4, minmax(0, 1fr));
gap: 0.75rem;
width: 100%;
}
.stat-card {
min-width: 0;
padding: 1rem;
border: 1px solid var(--border);
border-radius: 6px;
background: rgba(18, 27, 32, 0.82);
}
.hero-stats strong {
.stat-card-total {
display: grid;
place-content: center;
text-align: center;
}
.stat-card-total strong {
display: block;
font-size: 2rem;
font-size: 3rem;
line-height: 1;
font-variant-numeric: tabular-nums;
}
.hero-stats span {
.stat-card-total span,
.stat-heading {
color: var(--muted);
font-size: 0.8rem;
text-transform: uppercase;
}
.stat-heading {
display: block;
margin-bottom: 0.75rem;
color: var(--text);
font-weight: 700;
}
.stat-card-group {
container-type: inline-size;
}
.stat-list {
display: grid;
gap: 0.45rem;
margin: 0;
padding: 0;
list-style: none;
}
.stat-list li {
display: grid;
grid-template-columns: auto minmax(0, 1fr) auto;
align-items: center;
gap: 0.5rem;
color: var(--muted);
font-size: clamp(0.68rem, 4.5cqw, 0.84rem);
line-height: 1.25;
}
.stat-icon {
position: relative;
display: inline-block;
width: 0.85em;
height: 0.85em;
flex: 0 0 auto;
}
.stat-icon-platform {
border: 1px solid rgba(33, 198, 183, 0.82);
border-radius: 2px;
box-shadow: 0.18em 0.18em 0 rgba(33, 198, 183, 0.24);
}
.stat-icon-type {
border: 1px solid rgba(167, 120, 255, 0.86);
background: rgba(167, 120, 255, 0.22);
transform: rotate(45deg) scale(0.82);
}
.stat-icon-status {
border-radius: 50%;
border: 1px solid rgba(98, 217, 107, 0.9);
}
.stat-icon-status::after {
content: "";
position: absolute;
left: 0.22em;
top: 0.16em;
width: 0.28em;
height: 0.46em;
border: solid rgba(98, 217, 107, 0.95);
border-width: 0 0.12em 0.12em 0;
transform: rotate(45deg);
}
.stat-label {
min-width: 0;
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.stat-list strong {
color: var(--text);
font-variant-numeric: tabular-nums;
}
.flagships,
.related {
.related,
.browse-summary {
margin-bottom: clamp(2rem, 5vw, 4rem);
}
@@ -212,6 +307,66 @@ h1 {
gap: 1rem;
}
.browse-summary {
scroll-margin-top: 5.5rem;
}
.browse-summary-grid {
display: grid;
grid-template-columns: repeat(3, minmax(0, 1fr));
gap: 1rem;
}
.browse-facet {
min-width: 0;
padding: 1rem;
border: 1px solid var(--border);
border-radius: 6px;
background: rgba(18, 27, 32, 0.64);
}
.browse-facet h3 {
font-size: 1.2rem;
}
.browse-link-list {
display: grid;
gap: 0.45rem;
margin-top: 0.8rem;
}
.browse-link-list a {
display: flex;
align-items: center;
justify-content: space-between;
gap: 0.75rem;
min-height: 2.15rem;
padding: 0.45rem 0.55rem;
border: 1px solid rgba(255, 255, 255, 0.08);
border-radius: 4px;
background: rgba(4, 8, 10, 0.38);
color: var(--muted);
font-size: 0.88rem;
text-decoration: none;
}
.browse-link-list a:hover {
border-color: rgba(33, 198, 183, 0.28);
color: var(--text);
}
.browse-link-list span {
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
.browse-link-list em {
color: #c8d8d3;
font-style: normal;
font-variant-numeric: tabular-nums;
}
.catalog-shell {
display: grid;
grid-template-columns: 18rem minmax(0, 1fr);
@@ -224,6 +379,38 @@ h1 {
top: 5.5rem;
display: grid;
gap: 0.9rem;
max-height: calc(100vh - 6.5rem);
overflow-y: auto;
overscroll-behavior: contain;
scrollbar-gutter: stable;
}
.filter-rail,
.filter-list {
scrollbar-color: rgba(7, 11, 13, 0.82) transparent;
scrollbar-width: thin;
}
.filter-rail::-webkit-scrollbar,
.filter-list::-webkit-scrollbar {
width: 6px;
height: 6px;
}
.filter-rail::-webkit-scrollbar-track,
.filter-list::-webkit-scrollbar-track {
background: transparent;
}
.filter-rail::-webkit-scrollbar-thumb,
.filter-list::-webkit-scrollbar-thumb {
border-radius: 999px;
background: rgba(7, 11, 13, 0.72);
}
.filter-rail::-webkit-scrollbar-thumb:hover,
.filter-list::-webkit-scrollbar-thumb:hover {
background: rgba(38, 51, 55, 0.82);
}
.filter-panel {
@@ -553,18 +740,30 @@ a:focus-visible {
grid-template-columns: 1fr;
}
.hero-stats {
.hero-stats-panel {
min-width: 0;
}
.hero-stats {
grid-template-columns: repeat(2, minmax(0, 1fr));
}
.filter-rail {
position: static;
grid-template-columns: repeat(2, minmax(0, 1fr));
max-height: none;
overflow-y: visible;
overscroll-behavior: auto;
scrollbar-gutter: auto;
}
.flagship-grid {
grid-template-columns: repeat(2, minmax(0, 1fr));
}
.browse-summary-grid {
grid-template-columns: 1fr;
}
}
@media (max-width: 640px) {
@@ -581,12 +780,76 @@ a:focus-visible {
font-size: 3.1rem;
}
.hero-stats,
.filter-rail,
.flagship-grid {
grid-template-columns: 1fr;
}
.hero-stats-panel summary {
display: flex;
align-items: center;
justify-content: space-between;
gap: 0.75rem;
min-height: 2.7rem;
margin-bottom: 0.75rem;
padding: 0.7rem 0.85rem;
border: 1px solid var(--border);
border-radius: 6px;
background: rgba(18, 27, 32, 0.82);
color: var(--muted);
cursor: pointer;
font-size: 0.82rem;
font-weight: 700;
list-style: none;
text-transform: uppercase;
}
.hero-stats-panel summary::-webkit-details-marker {
display: none;
}
.hero-stats-panel summary::after {
content: "+";
color: var(--text);
font-size: 1.2rem;
line-height: 1;
}
.hero-stats-panel[open] summary::after {
content: "-";
}
.hero-stats {
grid-auto-columns: minmax(10.5rem, 72vw);
grid-auto-flow: column;
grid-template-columns: none;
overflow-x: auto;
overflow-y: hidden;
padding-bottom: 0.45rem;
scroll-snap-type: x proximity;
scrollbar-color: rgba(7, 11, 13, 0.82) transparent;
scrollbar-width: thin;
-webkit-overflow-scrolling: touch;
}
.hero-stats::-webkit-scrollbar {
height: 5px;
}
.hero-stats::-webkit-scrollbar-track {
background: transparent;
}
.hero-stats::-webkit-scrollbar-thumb {
border-radius: 999px;
background: rgba(7, 11, 13, 0.72);
}
.stat-card {
min-height: 10.25rem;
scroll-snap-align: start;
}
.hack-grid {
grid-template-columns: 1fr;
}
+1 -2
View File
@@ -28,8 +28,7 @@ const {
</a>
<nav aria-label="Primary navigation">
<a href="/">Catalog</a>
<a href="/browse/type/difficulty/">Difficulty</a>
<a href="/browse/platform/gba/">GBA</a>
<a href="/#browse">Browse</a>
<a href="/queue/">Play Queue</a>
</nav>
</header>
+104 -6
View File
@@ -2,12 +2,73 @@
import HackCard from '../components/HackCard.astro';
import FilterGroup from '../components/FilterGroup.astro';
import Layout from '../components/Layout.astro';
import { catalog, flagshipHacks, getFacetEntries, hacks } from '../lib/site-data';
import { catalog, facetValueSlug, flagshipHacks, getFacetEntries, hacks } from '../lib/site-data';
import type { FacetName } from '../lib/types';
const platforms = getFacetEntries('platform');
const bases = getFacetEntries('base').slice(0, 12);
const types = getFacetEntries('type');
const statuses = getFacetEntries('status');
type StatItem = {
label: string;
count: number;
};
type StatGroup = {
label: string;
icon: string;
items: StatItem[];
};
type BrowseGroup = {
label: string;
facet: Extract<FacetName, 'platform' | 'type' | 'status'>;
entries: [string, number][];
};
function facetCount(facet: FacetName, value: string): number {
return catalog.facets[facet]?.[value] ?? 0;
}
function displayFacetValue(value: string): string {
return value === 'Unknown' ? 'Unclassified' : value;
}
function selectedItems(facet: FacetName, values: string[]): StatItem[] {
return values
.map((value) => ({ label: displayFacetValue(value), count: facetCount(facet, value) }))
.filter((item) => item.count > 0);
}
function otherItem(facet: FacetName, selectedValues: string[]): StatItem | undefined {
const selected = new Set([...selectedValues, 'Unknown']);
const count = getFacetEntries(facet)
.filter(([value]) => !selected.has(value))
.reduce((total, [, entryCount]) => total + entryCount, 0);
return count > 0 ? { label: 'Other', count } : undefined;
}
function summaryItems(facet: FacetName, values: string[]): StatItem[] {
const items = selectedItems(facet, values);
const other = otherItem(facet, values);
const unknown = facetCount(facet, 'Unknown');
if (other) items.push(other);
if (unknown > 0) items.push({ label: 'Unclassified', count: unknown });
return items;
}
const statGroups: StatGroup[] = [
{ label: 'Platforms', icon: 'platform', items: summaryItems('platform', ['GBA', 'NDS', 'PC', 'GBC']) },
{ label: 'Types', icon: 'type', items: summaryItems('type', ['Expansion', 'New Experience', 'Difficulty', 'QoL']) },
{ label: 'Status', icon: 'status', items: summaryItems('status', ['Complete', 'Ongoing', 'Beta']) },
];
const browseGroups: BrowseGroup[] = [
{ label: 'Platforms', facet: 'platform', entries: platforms },
{ label: 'Types', facet: 'type', entries: types },
{ label: 'Status', facet: 'status', entries: statuses },
];
---
<Layout title="ROM Hack Archive">
@@ -16,11 +77,26 @@ const statuses = getFacetEntries('status');
<h1>ROM Hack Archive</h1>
<p>A private catalog of {catalog.count} Pokémon ROM hacks, fan-games, patches, notes, guides, and files.</p>
</div>
<div class="hero-stats" aria-label="Catalog totals">
<div><strong>{catalog.count}</strong><span>hacks</span></div>
<div><strong>{catalog.facets.platform.GBA ?? 0}</strong><span>GBA</span></div>
<div><strong>{catalog.facets.type.Expansion ?? 0}</strong><span>expansions</span></div>
</div>
<details class="hero-stats-panel" open>
<summary>Catalog breakdown</summary>
<div class="hero-stats" aria-label="Catalog totals">
<div class="stat-card stat-card-total"><strong>{catalog.count}</strong><span>hacks</span></div>
{statGroups.map((group) => (
<div class="stat-card stat-card-group">
<span class="stat-heading">{group.label}</span>
<ul class="stat-list">
{group.items.map((item) => (
<li>
<span class={`stat-icon stat-icon-${group.icon}`} aria-hidden="true"></span>
<span class="stat-label">{item.label}</span>
<strong>{item.count}</strong>
</li>
))}
</ul>
</div>
))}
</div>
</details>
</section>
<section class="flagships" aria-labelledby="flagships-heading">
@@ -33,6 +109,28 @@ const statuses = getFacetEntries('status');
</div>
</section>
<section id="browse" class="browse-summary" aria-label="Browse by catalog facets">
<div class="section-heading">
<h2>Browse the archive</h2>
<p>Jump into grouped catalog views without privileging a single platform or play style.</p>
</div>
<div class="browse-summary-grid">
{browseGroups.map((group) => (
<section class="browse-facet" aria-labelledby={`browse-${group.facet}`}>
<h3 id={`browse-${group.facet}`}>{group.label}</h3>
<div class="browse-link-list">
{group.entries.map(([value, count]) => (
<a href={`/browse/${group.facet}/${facetValueSlug(value)}/`}>
<span>{displayFacetValue(value)}</span>{' '}
<em>{count}</em>
</a>
))}
</div>
</section>
))}
</div>
</section>
<section class="catalog-shell" aria-label="Hack catalog">
<aside class="filter-rail">
<div class="filter-panel">
+115
View File
@@ -1,5 +1,88 @@
import { expect, test } from '@playwright/test';
test('homepage presents balanced navigation and facet summaries', async ({ page }) => {
await page.goto('/');
const primaryNav = page.getByRole('navigation', { name: 'Primary navigation' });
await expect(primaryNav.getByRole('link', { name: 'Catalog' })).toHaveAttribute('href', '/');
await expect(primaryNav.getByRole('link', { name: 'Browse' })).toHaveAttribute('href', '/#browse');
await expect(primaryNav.getByRole('link', { name: 'Play Queue' })).toHaveAttribute('href', '/queue/');
await expect(primaryNav.getByRole('link', { name: 'GBA' })).toHaveCount(0);
await expect(primaryNav.getByRole('link', { name: 'Difficulty' })).toHaveCount(0);
const heroStats = page.locator('.hero-stats');
await expect(heroStats).toContainText('368');
await expect(heroStats).toContainText('hacks');
await expect(heroStats).toContainText('Platforms');
await expect(heroStats).toContainText('GBA 188');
await expect(heroStats).toContainText('NDS 47');
await expect(heroStats).toContainText('PC 40');
await expect(heroStats).toContainText('GBC 22');
await expect(heroStats).toContainText('Types');
await expect(heroStats).toContainText('Expansion 143');
await expect(heroStats).toContainText('New Experience 129');
await expect(heroStats).toContainText('Difficulty 105');
await expect(heroStats).toContainText('QoL 50');
await expect(heroStats).toContainText('Status');
await expect(heroStats).toContainText('Complete 168');
await expect(heroStats).toContainText('Ongoing 28');
await expect(heroStats).toContainText('Beta 10');
await expect(heroStats).toContainText('Unclassified 161');
});
test('homepage stat cards are polished and responsive', async ({ page }) => {
await page.goto('/');
const totalCard = page.locator('.stat-card-total');
await expect(totalCard).toHaveCSS('text-align', 'center');
await expect(totalCard.locator('strong')).toHaveCSS('font-size', /^(4[0-9]|5[0-9])px$/);
const firstStatItem = page.locator('.stat-list li').first();
await expect(firstStatItem.locator('.stat-icon')).toBeVisible();
await expect(firstStatItem.locator('.stat-label')).toHaveCSS('white-space', 'nowrap');
await page.setViewportSize({ width: 390, height: 844 });
await page.goto('/');
const statsPanel = page.locator('.hero-stats-panel');
await expect(statsPanel.locator('summary')).toBeVisible();
await expect(statsPanel).toHaveAttribute('open', '');
const mobileMetrics = await page.locator('.hero-stats').evaluate((element) => {
const styles = window.getComputedStyle(element);
const cards = Array.from(element.querySelectorAll('.stat-card')).map((card) => card.getBoundingClientRect());
return {
columns: styles.gridAutoFlow,
overflowX: styles.overflowX,
firstTop: cards[0]?.top,
allSameRow: cards.every((card) => Math.abs(card.top - cards[0].top) < 2),
scrollWidth: element.scrollWidth,
clientWidth: element.clientWidth,
};
});
expect(mobileMetrics.columns).toBe('column');
expect(mobileMetrics.overflowX).toBe('auto');
expect(mobileMetrics.allSameRow).toBe(true);
expect(mobileMetrics.scrollWidth).toBeGreaterThan(mobileMetrics.clientWidth);
});
test('homepage browse summary links to grouped facet pages', async ({ page }) => {
await page.goto('/');
const browse = page.getByRole('region', { name: 'Browse by catalog facets' });
await expect(browse.getByRole('heading', { name: 'Browse the archive' })).toBeVisible();
await expect(browse.getByRole('link', { name: /GBA\s+188/ })).toHaveAttribute('href', '/browse/platform/gba/');
await expect(browse.getByRole('link', { name: /Difficulty\s+105/ })).toHaveAttribute(
'href',
'/browse/type/difficulty/',
);
await expect(browse.getByRole('link', { name: /Complete\s+168/ })).toHaveAttribute(
'href',
'/browse/status/complete/',
);
});
test('catalog search and filters update visible card count', async ({ page }) => {
await page.goto('/');
@@ -21,6 +104,38 @@ test('catalog search and filters update visible card count', async ({ page }) =>
await expect(page.locator('[data-result-count]')).toContainText('shown');
});
test('desktop filter rail scrolls independently from the catalog page', async ({ page }) => {
await page.setViewportSize({ width: 1280, height: 720 });
await page.goto('/');
const rail = page.locator('.filter-rail');
await expect(rail).toBeVisible();
const metrics = await rail.evaluate((element) => {
const styles = window.getComputedStyle(element);
const firstList = element.querySelector('.filter-list');
const listStyles = firstList ? window.getComputedStyle(firstList) : null;
return {
clientHeight: element.clientHeight,
overflowY: styles.overflowY,
scrollHeight: element.scrollHeight,
railScrollbarColor: styles.scrollbarColor,
railScrollbarWidth: styles.scrollbarWidth,
listScrollbarColor: listStyles?.scrollbarColor,
listScrollbarWidth: listStyles?.scrollbarWidth,
viewportHeight: window.innerHeight,
};
});
expect(metrics.overflowY).toBe('auto');
expect(metrics.scrollHeight).toBeGreaterThan(metrics.clientHeight);
expect(metrics.clientHeight).toBeLessThan(metrics.viewportHeight);
expect(metrics.railScrollbarWidth).toBe('thin');
expect(metrics.listScrollbarWidth).toBe('thin');
expect(metrics.railScrollbarColor).not.toBe('auto');
expect(metrics.listScrollbarColor).not.toBe('auto');
});
test('detail page renders metadata and private file links', async ({ page }) => {
await page.goto('/hack/radical-red/');