Skip to main content

Component · Data

Event Stream

Structured k8s/agent events with severity and source.

Kind
widget
Input
interactive
Canvas
120×40

Live preview

Loading terminal preview.

Static terminal poster. Choose Run live to start the Rust demo.

Ghosttyevent-stream/basic
Loading terminal poster…
○ loading posterNo input — rendered state only
Event Stream · exact mounted Rust story

01 · Purpose

What it is for

Structured k8s/agent events with severity and source.

Best fit: Data · data · widget

02 · Behavior

What the mounted story proves

  1. 01

    EventStream

    Representative 120×40 terminal state.

  2. 02

    Passive paint

    No keyboard or pointer action is claimed by this representative story.

  3. 03

    Evidence stays explicit

    1 covered · 10 partial · 5 missing axes.

03 · Implement

Install, then start from exact code

Install

cargo add termrock --git https://github.com/tailrocks/termrock.git --rev 5283c2acf9154d0cfcd37b1ffe821c00faf90ea2

Add TermRock once. Keep domain effects in the host application.

Minimal implementation

Exact Rust setup used by event-stream/basic.

Open to load code.

04 · Adapt

Variants and composition

Variants

Use the preview Variant menu when alternate registered stories exist. Each selection mounts a fresh configuration.

Composition

Data · data · widget

05 · Reference

API, tokens, accessibility

API

EventStreamOpen source ↗

Tokens

DesignSystemInspect exact story code for roles and capability projection.

Accessibility

Input contract mountedNo input claim in the representative story.

Contract

Evidence in progress1/23 axes covered

06 · Go deeper

Advanced guidance

Authored implementation guidance

Purpose. Structured event consoles (k8s events, agent activity, observability) where rows are typed, not freeform log lines. Distinct from LogStream (text+level) and Timeline (presentation recipes).

When to use

Use EventStreamPrefer
Kubernetes / cloud events—
Agent tool/activity stream—
Burst-prone high-rate feeds—
Plain application logsLogStream
Deploy/history narrativeTimeline

Live + unread

  • Follow tail by default (ScrollAreaState authority).
  • Scroll/move up detaches; chip shows ↓ N new.
  • Host calls on_append(total, viewport) after each project.
  • report_backpressure(dropped, batched) for drop/batch chrome.

Pluggable summary / detail

  • summary — one-line host-formatted row body.
  • fields — optional k=v chrome (dropped when narrow).
  • detail — inspector body when selected (i / Enter).
Ownership boundary

TermRock owns reusable terminal rendering and interaction state. The host owns domain data, policy, persistence, authorization, and side effects.

Evidence status

1 covered, 10 partial, and 5 missing contract axes. Missing evidence is not a behavior claim.