docs(design): specify download progress treatment

Document and mock the redesigned downloading state for the launcher. The
reference now replaces the action button slot with a dedicated progress
primitive, covers both card and detail-modal layouts, and records the sizing,
number formatting, container-query fallback, and sample-data expectations that
implementation work should follow.

This commit keeps the design package separate from application code so the
next UI/backend changes can be reviewed against a stable reference.

Test Plan:
- git diff --cached --check

Refs: local design reference update
This commit is contained in:
2026-05-20 23:09:46 +02:00
parent 51216b7281
commit e308009a08
5 changed files with 438 additions and 18 deletions
+195
View File
@@ -630,6 +630,201 @@
}
.act-download:hover { background: rgba(255,255,255,0.12); border-color: var(--bd-3); }
/* ─── Download progress (in place of action button when state === 'downloading') ─── */
.dl {
position: relative;
overflow: hidden;
border-radius: 7px;
border: 1px solid color-mix(in srgb, var(--accent) 45%, var(--bd-2));
background: rgba(255,255,255,0.04);
color: var(--t-1);
font: inherit;
font-variant-numeric: tabular-nums;
container-type: inline-size;
isolation: isolate;
box-shadow: inset 0 1px 0 rgba(255,255,255,0.04),
0 0 0 1px color-mix(in srgb, var(--accent) 16%, transparent);
}
.dl-full { width: 100%; }
.dl-fill {
position: absolute; inset: 0 auto 0 0;
width: 0%;
background:
linear-gradient(180deg,
color-mix(in srgb, var(--accent) 38%, transparent) 0%,
color-mix(in srgb, var(--accent) 26%, transparent) 100%);
border-right: 1px solid color-mix(in srgb, var(--accent) 75%, transparent);
box-shadow: 2px 0 8px color-mix(in srgb, var(--accent) 35%, transparent);
transition: width 480ms cubic-bezier(.4,0,.2,1);
z-index: 0;
}
/* shimmering scanline on top of the fill so it reads as 'live' */
.dl-fill::after {
content: '';
position: absolute; inset: 0;
background:
repeating-linear-gradient(115deg,
transparent 0 14px,
rgba(255,255,255,0.05) 14px 22px);
background-size: 200% 100%;
animation: dl-stripe 1.4s linear infinite;
mix-blend-mode: screen;
opacity: 0.85;
}
@keyframes dl-stripe {
from { background-position: 0% 0%; }
to { background-position: -36px 0%; }
}
/* live pulse dot */
.dl-pulse {
width: 7px; height: 7px; border-radius: 99px;
background: var(--accent);
box-shadow: 0 0 0 0 color-mix(in srgb, var(--accent) 70%, transparent);
animation: dl-pulse 1.4s ease-out infinite;
flex: 0 0 auto;
}
@keyframes dl-pulse {
0% { box-shadow: 0 0 0 0 color-mix(in srgb, var(--accent) 70%, transparent); }
70% { box-shadow: 0 0 0 6px color-mix(in srgb, var(--accent) 0%, transparent); }
100% { box-shadow: 0 0 0 0 color-mix(in srgb, var(--accent) 0%, transparent); }
}
/* ── md (card tile) ── */
.dl-md {
height: 32px;
padding: 0 10px;
}
.dl-md-row {
position: relative; z-index: 1;
display: flex; align-items: center; justify-content: space-between;
width: 100%; height: 100%;
gap: 8px;
font-size: 12px;
font-weight: 600;
letter-spacing: 0.005em;
}
.dl-md .dl-pct {
display: inline-flex; align-items: center;
color: var(--t-1);
}
.dl-md .dl-pulse { margin-right: 6px; }
.dl-md .dl-pct-sym { opacity: 0.55; font-weight: 600; margin-left: 1px; }
.dl-md .dl-speed {
color: var(--t-2);
font-size: 11px;
font-weight: 500;
font-variant-numeric: tabular-nums;
}
/* Container-query graceful degradation: when the tile is narrow,
drop the speed and centre the percentage so nothing truncates. */
@container (max-width: 132px) {
.dl-md .dl-speed { display: none; }
.dl-md-row { justify-content: center; gap: 6px; }
}
@container (max-width: 96px) {
.dl-md .dl-pulse { display: none; }
}
/* Density tuning — match the existing button heights */
.density-compact .dl-md { height: 30px; padding: 0 9px; }
.density-compact .dl-md-row { font-size: 11.5px; }
.density-compact .dl-md .dl-speed { font-size: 10.5px; }
.density-large .dl-md { height: 34px; padding: 0 12px; }
.density-large .dl-md-row { font-size: 13px; }
.density-large .dl-md .dl-speed { font-size: 11.5px; }
/* ── lg (detail overlay) ── */
.dl-lg {
height: 56px;
padding: 0;
border-radius: 9px;
flex: 1 1 auto;
min-width: 260px;
}
.dl-lg-grid {
position: relative; z-index: 1;
display: grid;
grid-template-columns: minmax(0, 1fr) auto auto;
grid-template-rows: auto auto;
grid-template-areas:
"primary pct cancel"
"secondary pct cancel";
align-items: center;
height: 100%;
padding: 0 14px 0 16px;
column-gap: 14px;
row-gap: 2px;
}
.dl-lg-primary {
grid-area: primary;
display: flex; align-items: center; gap: 8px;
font-size: 13px;
font-weight: 600;
letter-spacing: 0.02em;
text-transform: uppercase;
color: color-mix(in srgb, var(--accent) 80%, white);
min-width: 0;
}
.dl-lg-primary .dl-label { white-space: nowrap; }
.dl-lg-secondary {
grid-area: secondary;
display: flex; align-items: center; gap: 7px;
font-size: 12px;
font-weight: 500;
color: var(--t-2);
min-width: 0;
overflow: hidden;
}
.dl-lg-secondary .dl-bytes {
color: var(--t-1);
font-weight: 600;
white-space: nowrap;
}
.dl-lg-secondary .dl-bytes .dl-of { color: var(--t-2); font-weight: 500; }
.dl-lg-secondary .dl-speed { color: var(--t-1); font-weight: 600; white-space: nowrap; }
.dl-lg-secondary .dl-eta { white-space: nowrap; min-width: 0; overflow: hidden; text-overflow: ellipsis; }
.dl-sep { opacity: 0.45; }
/* Gracefully drop the ETA when the modal is narrow */
@container (max-width: 380px) {
.dl-lg-secondary .dl-eta,
.dl-lg-secondary .dl-sep-eta { display: none; }
}
.dl-lg-pct {
grid-area: pct;
font-size: 20px;
font-weight: 700;
letter-spacing: -0.01em;
color: var(--t-1);
font-variant-numeric: tabular-nums;
line-height: 1;
}
.dl-lg-pct .dl-pct-sym {
font-size: 12px;
font-weight: 600;
opacity: 0.55;
margin-left: 1px;
}
.dl-cancel {
grid-area: cancel;
display: inline-flex; align-items: center; justify-content: center;
width: 28px; height: 28px;
border-radius: 6px;
border: 1px solid var(--bd-2);
background: rgba(255,255,255,0.04);
color: var(--t-2);
cursor: pointer;
transition: background .15s, border-color .15s, color .15s;
}
.dl-cancel:hover {
background: rgba(239,68,68,0.12);
border-color: rgba(239,68,68,0.40);
color: #fca5a5;
}
/* Ghost / secondary */
.ghost-btn {
display: inline-flex; align-items: center; gap: 7px;