OperationalStatus

Data states

The application supplies state, source, updatedAt, and optional detail. There is no wall-clock timer or freshness inference. Connected transport alone does not make data current, and missing values do not imply health or zero.

Data quality, Source, and Updated use DescriptionList's details layout: muted labels on the left and right-aligned values in wrapping 40/60 columns. The report state is a text-only badge. EntityPreview reuses OperationalStatus for the same presentation.

All timestamps use epoch milliseconds and render as UTC to the second, YYYY-MM-DD HH:MM:SS UTC, the same rendering every OPERATOR status display uses. Zero is a valid timestamp. The date and time can wrap separately, and UTC stays with the time. Milliseconds are not shown, and a time is never rounded up; the time element keeps the exact ISO value for machines. Missing, null, and invalid timestamps display Time unknown in the Updated row. Use detail to explain stale thresholds, missing coverage, degraded quality, or last-known values.

Props

Accessibility

• Each presentation is a named Data quality group with native label/value relationships.
• Every state includes readable text alongside semantic color.
• The component does not announce high-frequency report updates automatically.
• Application descriptions preserve their supplied casing, and a long source or description wraps.
• The forwarded ref targets the root div; ordinary div attributes are supported.

Manifest entry

<OperationalStatus state="partial" source="Supplied report" updatedAt={lastReport} detail="One source has not reported." />

{
  "description": "Application-asserted data quality, source, and UTC update time in shared label/value detail rows.",
  "props": {
    "state": {
      "type": "enum",
      "values": [
        "current",
        "stale",
        "partial",
        "unavailable",
        "unknown"
      ],
      "default": "unknown",
      "description": "Application assertion rendered as a text-only badge; never inferred from connection or the wall clock."
    },
    "source": {
      "type": "string",
      "description": "Provenance label; defaults to Unknown."
    },
    "updatedAt": {
      "type": "number",
      "description": "Epoch milliseconds, including zero. Shown as UTC to the second, 'YYYY-MM-DD HH:MM:SS UTC', with the date and the time wrapping separately; the machine-readable time element keeps the exact instant. Null, missing, or invalid renders Time unknown in the Updated row."
    },
    "detail": {
      "type": "string",
      "description": "Missing coverage, stale threshold, quality, or last-known context."
    }
  },
  "composable_with": [
    "AppShell",
    "Inspector",
    "DataGrid",
    "EntityPreview",
    "DescriptionList",
    "Badge"
  ],
  "never_inside": [
    "Button"
  ],
  "example": "<OperationalStatus state=\"partial\" source=\"Supplied report\" updatedAt={lastReport} detail=\"One source has not reported.\" />"
}