01
Overview
Separator entry inside a feed marking a stream discontinuity such as a reconnect or a sequence gap.
Usage
FeedBoundary is a compose-only leaf of Feed.
The idiomatic API is Feed.Boundary, reached through the parent
namespace — see the feed README for the composed
snippet. The flat @lostgradient/cinder/feed-boundary subpath remains exported
for à-la-carte builds that import the leaf directly.
The consumer owns the wording (label); the boundary owns the
role="separator" semantics and the horizontal-rule treatment.
- 09:14:02 — Job nightly-sync started
- 09:14:20 — 4,182 records fetched
- Connection lost — retrying
- 09:15:31 — Resumed from checkpoint 4,182
- 09:16:05 — Job completed
02
When to use
Use when
- Marking a reconnect, replay, or gap between entries in a feed's log arm.
Avoid when
- Standing alone outside a feed — it expects the feed list semantics around it. Use Feed instead
- Separating generic page content — use divider instead. Use Divider instead
03
Examples
Standalone boundary
FeedBoundary imported from its standalone entry: a role="separator" list item marking a discontinuity in a consumer-owned stream list. Inside a Feed, prefer the Feed.Boundary namespace form.
04
Props
| Name | Type | Default | Description |
|---|---|---|---|
label required | text | Accessible and visible label for the boundary, e.g.
"Reconnected — 3 events replayed" or "Sequence gap — expected 12,
received 15". The consumer owns the wording; the boundary owns the
role="separator" semantics and the rule treatment. | |
datetime | text | Optional machine-readable ISO 8601 datetime for the boundary moment.
Rendered as <time datetime> when provided. | |
timestamp | text | Optional human-readable timestamp label. Falls back to datetime when
omitted while datetime is set. |