TierMoveList
The Tiers screen's two lists (v3 mock UPG and the manual log): an automatic move is the creator's photo, name and "Rising → Established · 2 days ago · score 62" with a "Change" button; a manual move is the tiers icon, "Farida moved **Ali Tarek** Established → Rising" and "Reason: … · 28 Oct · 11:05". The arrow turns with the reading direction.
import { TierMoveList } from '@ergasti/bricks';Examples
Tier moves
Automatic moves (the score moved them) with a "Change" button, and manual ones with who, why and when.
Code
import { Card, TierMoveList } from '@ergasti/bricks';
function Moves() {
return (
<div style={{ display: 'grid', gap: 16, maxWidth: 620 }}>
<Card>
<TierMoveList label="Recent automatic moves" onChange={() => {}} moves={[
{ id: 1, creator: { name: 'Sara Ali', seed: 1 }, from: 'rising', to: 'established', when: '2 days ago', score: 62 },
{ id: 2, creator: { name: 'Nour Hassan', seed: 2 }, from: 'influential', to: 'elite', when: '1 week ago', score: 91 },
]} />
</Card>
<Card>
<TierMoveList label="Manual changes by PR" moves={[{ id: 3, creator: { name: 'Ali Tarek', seed: 4 }, from: 'established', to: 'rising', when: '28 Oct · 11:05', by: 'Farida', reason: 'fake engagement found on his TikTok' }]} />
</Card>
</div>
);
}Props
Prop
Type
Labels
Every word this component draws, in both languages. Override one per component and language with BricksProvider labels under the key prTierMoves, or with the component's own prop where it has one. A {name} is a value the component fills in.
| Key | English | Arabic |
|---|---|---|
moved | moved | نقل |
score | score {n} | التقييم {n} |
reason | Reason: {r} | السبب: {r} |
sep | · | · |
change | Change | غيّر |
changeName | Change {n}’s tier | غيّر مستوى {n} |
from | from | من |
to | to | لـ |
Design guidance
How the BRICKS design system uses TierMoveList. Written in docs/content/components/TierMoveList.md; the props above are read from the code, which wins where the two disagree.
The Tiers screen's lists of tier moves: automatic moves (photo, name, "Rising → Established · 2 days ago · score 62", Change) and manual ones by PR ("Farida moved Ali Tarek Established → Rising", reason, when); use it on the PR Tiers page.
TierMoveList is the v3 mock's UPG list and the manual log. An automatic move happened because the score moved the creator; PR can override it with "Change" (open a TierChangeDialog). A manual move shows who moved whom, the reason the creator saw and when. The arrow turns with the reading direction.
Anatomy
- List:
<ul class="kit-pr-moves" aria-label>. - Automatic row:
Avatar; bold name (one line); muted "Rising → Established · 2 days ago · score 62"; "Change" button (withonChange). - Manual row:
IconSquare name="tiers" tone="lilac" size="sm"; "Farida moved Ali Tarek Established → Rising"; muted "Reason: … · 28 Oct · 11:05".
Variants
| Move | Detected by | Row |
|---|---|---|
| Automatic | no by | Photo, tiers, when, score, Change |
| Manual | by set | Tiers icon, who moved whom, reason, when |
States
Static; "Change" is focusable; long names truncate.
Types
TierMove (moves): { id, creator: PrPerson, from, to, when, score?, by?, reason? }.
Usage
import { Card, TierMoveList } from '@ergasti/bricks';
export function Moves() {
return (
<div style={{ display: 'grid', gap: 16, maxWidth: 620 }}>
<Card>
<TierMoveList label="Recent automatic moves" onChange={() => {}} moves={[
{ id: 1, creator: { name: 'Sara Ali', seed: 1 }, from: 'rising', to: 'established', when: '2 days ago', score: 62 },
{ id: 2, creator: { name: 'Nour Hassan', seed: 2 }, from: 'influential', to: 'elite', when: '1 week ago', score: 91 },
]} />
</Card>
<Card>
<TierMoveList label="Manual changes by PR" moves={[{ id: 3, creator: { name: 'Ali Tarek', seed: 4 }, from: 'established', to: 'rising', when: '28 Oct · 11:05', by: 'Farida', reason: 'fake engagement found on his TikTok' }]} />
</Card>
</div>
);
}// Tiers page: the ladder, then both lists; Change opens the dialog
<TierLadder basis="score" tiers={ladder} onScoreInfo={() => setExplainer(true)} />
<Card title="Recent automatic moves"><TierMoveList label="Recent automatic moves" moves={auto} onChange={setChanging} /></Card>
<Card title="Manual changes by PR"><TierMoveList label="Manual changes by PR" moves={manual} /></Card>
<TierChangeDialog open={changing != null} onClose={() => setChanging(null)} onSave={saveTier}
name={changing?.creator.name ?? ''} tier={changing?.to ?? 'rising'} source="score" score={changing?.score ?? null}
tiers={['rising', 'established', 'influential', 'elite']} />Where it appears
- PR Portal › Tiers › "Recent automatic moves" and "Manual changes by PR".
- Dashboard screen: PrTiers.
Guidelines
Do
- Keep the reason for manual moves; it is the audit trail.
- Show the score on automatic moves so PR sees why.
Don't
- Don't offer Change on manual moves (it isn't drawn).
RTL and Arabic
Mirrors; the arrow flips; names in <bdi>. Arabic: "نقل", "التقييم 62", "السبب: …".
Tokens
--ink-3, --line, IconSquare lilac tokens.
Accessibility
A labelled list; the arrow is decorative with hidden "from" / "to"; "Change" is named "Change Sara Ali's tier".
Found in the source
- ARIA attributes set:
aria-hidden,aria-label.
Read from the component's source and tests. See Accessibility for the patterns the library follows.
Related
TierChangeDialog,TierLadder.AuditLogList: the wider activity log.
See also: Avatar · Button · useBricks · useLanguage · IconSquare · PrIcon · Card
Source
src/pr/tiers/TierMoveList.tsx (line 62) on GitHub.