State vocabulary
One vocabulary for every page (gate-checked like brand-005, PL-066): empty, filtered-empty, loading, not available to your role, the API error taxonomy (403 · 404 · 409 · 422 · 429 · 5xx with a request id), offline, stale, partial data, needs-backend. Hide what a role can't do; use the denied state only where hiding would confuse.
Covers: alert primitive, alert designer, error-state primitive, error-states designer, not-wired primitive. Exports: EmptyState, ErrorState, Banner, NotAvailable.
Anatomy
The component as it sits in the product: English, compact, real data shapes.
Something went wrong on our side
The server answered 500. Your work on this page is kept.
request id 9f3c2a71-4e0b · 06:41:12 UTCStates
15 states, left to right, top to bottom. A mock poll never finishes, so each state is drawn on purpose.
Something went wrong on our side
The server answered 500. Your work on this page is kept.
request id 9f3c2a71-4e0b · 06:41:12 UTCNo tickets yet
Retailers open tickets from their app; staff can open one for a shop.
Nothing matches these filters
Brand: Atelier North · Status: On Hold
Not available to your role
This page needs view pricing. The menu never links here for your role; you arrived by a pasted link.
You can't do that
The server refused (403): your role lost edit orders since the page loaded. Nothing changed.
Order 4419 doesn't exist
It may have been a draft that was deleted, or a typo.
Density
Compact (2b ultra, the default) and comfortable, side by side. Same markup, only the density tokens change.
Something went wrong on our side
The server answered 500. Your work on this page is kept.
request id 9f3c2a71-4e0b · 06:41:12 UTCSomething went wrong on our side
The server answered 500. Your work on this page is kept.
request id 9f3c2a71-4e0b · 06:41:12 UTCEnglish · 中文
Staff pick en or cn (T001 Q25). Labels arrive localised; CJK falls back to PingFang SC / Noto Sans SC.
Something went wrong on our side
The server answered 500. Your work on this page is kept.
request id 9f3c2a71-4e0b · 06:41:12 UTC服务器出错了
服务器返回 500，本页内容已保留。
request id 9f3c2a71-4e0b · 06:41:12 UTCLong string · permission denied
The long-string case (PL-063) and what a role without the permission sees (the server decides; T003).
Something went wrong on our side
The server answered 500. Your work on this page is kept.
request id 9f3c2a71-4e0b-4d0c-a7a1-2b6f0c1d9e33 · POST /api/v1/admin/orders/4521/cloud-print · 06:41:12 UTCNot available to your role
This page needs view pricing. The menu never links here for your role; you arrived by a pasted link.
Both apps
One @rj/admin-kit component, two themes: the Laravel admin (navy pinned) and the DTC admin (kit v4 Midnight green), by token swap only.
Something went wrong on our side
The server answered 500. Your work on this page is kept.
request id 9f3c2a71-4e0b · 06:41:12 UTCSomething went wrong on our side
The server answered 500. Your work on this page is kept.
request id 9f3c2a71-4e0b · 06:41:12 UTCContract
The @rj/admin-kit API for this family. Mirrored in CONTRACT.md.
- Export
EmptyState·@rj/admin-kit- Props
icon·title·body·action- Variants
- first-use · filtered · zero
- shadcn / Radix
- none
- Accessibility
- h2-level title
- Export
ErrorState·@rj/admin-kit- Props
status403|404|409|422|429|5xx|offline ·requestId·retry- States
- per status
- Package underneath
- react-error-boundary (per panel)
- Accessibility
- role=alert for blocking errors
- Export
Banner·@rj/admin-kit- Props
kindinfo|warn|bad|ok|lock ·title·body·actions·thin- Variants
- stale · offline · partial · conflict · needs-backend
- Package underneath
- react-query onlineManager + dataUpdatedAt (stale / offline)
- Export
NotAvailable·@rj/admin-kit- Props
permissions[]- States
- page · inline · chip
- Accessibility
- names the missing permission; never a dead button
- API operations
- admin.me.show (permissions[])