Skip to main content

SystemTrailList

packages/core/components/organisms/SystemTrailList.js · Tier: organism · Module: core · Rendering: Server Component

Purpose​

Wraps the system-trail (audit) results in a single bordered container (used by the Records page and the per-user activity panel). Events are stacked full width and separated by dividers. It renders an error banner when the fetch failed and an empty message when there are no matching events. An optional title is shown as the container header (for the detail view, where "System events" is a sub-section).

Props​

PropTypeRequiredDefaultDescription
eventsArray<object>yes—The trail events to render.
langstringyes—Locale for row timestamps.
fetchErrorbooleannofalseRenders the error banner instead of the list.
titlestringno—Optional container heading.
titleIconstringno'receipt_long'Icon for the heading.
labelsobjectyes—Localized labels (forwarded to each SystemTrailRow, plus loadError/empty).

Composition​

  • Uses: atoms/core/Icon, molecules/core/SystemTrailRow.
  • Used by: organisms/core/UserActivityPanel, the Records page.

Internationalisation​

All copy via labels.

Accessibility​

The error state uses role="alert"; the optional heading is an <h2>.

Styling & tokens​

bg-surface-container-lowest, border-outline-variant, rounded-md, bg-error-container error banner.

molecules/core/SystemTrailRow, molecules/core/SystemTrailFilters, organisms/core/UserActivityPanel.