RecordProvenanceView is a headless read-only display of where a record came from: who wrote it, its source, when the thing it records happened and when it was recorded, its version, and whether it is signed or still only on this device. It renders as a <span> of parts, each in the consumer's words, with the states as data-* attributes.
Status: experimental — new, implemented and unit-tested in every headless library; not yet exercised in a composed flow.
Example
Awaiting signatureFrom a blood pressure monitorDr A Patel
Show demo markup
<span class="record-provenance-view" data-attestation="pending" data-source="device"><span class="record-provenance-view-attestation">Awaiting signature</span> <span class="record-provenance-view-source">From a blood pressure monitor</span> <span class="record-provenance-view-author">Dr A Patel</span> <time class="record-provenance-view-recorded" datetime="2026-11-03T09:00">Recorded 09:00</time></span>
Usage example
<RecordProvenanceView
attestation="pending"
attestationLabel="Awaiting signature"
authorLabel="Dr A Patel"
/>
Show Svelte source
// In your Svelte component:
import RecordProvenanceView from "lily-design-system-svelte-headless/components/RecordProvenanceView/RecordProvenanceView.svelte";
<RecordProvenanceView>
<!-- content -->
</RecordProvenanceView>
Usage
<RecordProvenanceView
attestation="pending"
attestationLabel="Awaiting signature"
source="device"
sourceLabel="From a blood pressure monitor"
authorLabel="Dr A Patel"
recorded="2026-11-03T09:00"
recordedLabel="Recorded 09:00"
/>
Props
attestation: "signed" | "pending" | "unsigned" | "amended" | "deleted" (optional) — whether the record is signed; rendered as data-attestation
attestationLabel: string (required with attestation) — that state in words ("Awaiting signature")
sync: "pending" | "failed" (optional) — "pending" is saved on this device and not yet sent, "failed" could not be sent; rendered as data-sync
syncLabel: string (required with sync) — that state in words
source: string (optional) — where the record came from, as the consumer's code ("clinic", "device", "patient-reported", "external", "extracted"); rendered as data-source
sourceLabel: string (optional) — that source in words ("From a blood pressure monitor")
authorLabel: string (optional) — who wrote or recorded it ("Dr A Patel")
observed, observedLabel: string (optional) — when the thing recorded happened (ISO 8601, as datetime) and the consumer's words for it
recorded, recordedLabel: string (optional) — when it was recorded, the same way
versionLabel: string (optional) — the version in words ("Version 3")
label: string (optional) — hidden text naming the provenance
...restProps: any — additional HTML attributes spread onto the root
Keyboard Interactions
None. This is not an interactive component.
ARIA
No role and no aria-label; label renders as hidden text
When to Use
Use beside a note, result or record whose signature state matters: a draft, a note awaiting a countersignature, an amended entry.
Use for imported, device or patient-reported values, so a reader knows where they came from.
Use in offline-capable apps for work saved on the device and not yet sent.
When Not to Use
Do not use for a record's review date alone — use review-date.
Do not use for a list of versions — use timeline-list with a diff.
Do not use for a person's identity — use the patient banner composition.
Headless
This headless component ships zero CSS and decides nothing visual. The consumer provides all styling targeting the .record-provenance-view class hook and its parts, and every word and every state.
Styles
.record-provenance-view, its parts, and [data-attestation], [data-sync], [data-source].
Testing
The parts render in order, states first, each in the consumer's words
An unsigned record shows its own state and words
A state without words warns in development
Advice
Say plainly what is not yet true: "Awaiting signature", "Not sent: saved on this device".
Keep the observed and recorded times apart; a value entered today about last week is last week's value.
Mark machine-extracted values as such (source="extracted") until a person has reviewed them.
Implementation Notes
Renders <span class="record-provenance-view"> with one part per fact given, signature and sync states first: -attestation, -sync, -source, -author, -observed, -recorded, -version
attestation, sync and source render as data-attestation, data-sync and data-source; a state without words raises a development warning
Observed-at and recorded-at are separate <time> parts, so a document's date is never read as the observation's
A part with no words is left out
Related components
review-date — when a record was last reviewed
timeline-list — a sequence of events, such as a record's versions
Generated from this component's canonical metadata — the machine-checked source the implementations are held to.
Metadata
Component: record-provenance-view
PascalCase: RecordProvenanceView
Description: who recorded a record, where it came from and whether it is signed, in the consumer's words
Status: experimental — new, implemented and unit-tested in every headless library; not yet exercised in a composed flow
HTML tag: <span>
CSS class: .record-provenance-view
Interactive: no
ARIA
No role and no aria-label; label renders as hidden text
Keyboard
Not interactive
Props
attestation: "signed" | "pending" | "unsigned" | "amended" | "deleted" (optional) — whether the record is signed; rendered as data-attestation
attestationLabel: string (required with attestation) — that state in words ("Awaiting signature")
sync: "pending" | "failed" (optional) — "pending" is saved on this device and not yet sent, "failed" could not be sent; rendered as data-sync
syncLabel: string (required with sync) — that state in words
source: string (optional) — where the record came from, as the consumer's code ("clinic", "device", "patient-reported", "external", "extracted"); rendered as data-source
sourceLabel: string (optional) — that source in words ("From a blood pressure monitor")
authorLabel: string (optional) — who wrote or recorded it ("Dr A Patel")
observed, observedLabel: string (optional) — when the thing recorded happened (ISO 8601, as datetime) and the consumer's words for it
recorded, recordedLabel: string (optional) — when it was recorded, the same way
versionLabel: string (optional) — the version in words ("Version 3")
label: string (optional) — hidden text naming the provenance
...restProps: any — additional HTML attributes spread onto the root