Skip to main content
TermRock
GitHub
ComponentsVisualization

Component · Visualization

Timeline

Vertical activity timeline with active markers.

Kind
widget
Input
interactive
Canvas
120×40

Live preview

Loading terminal preview.

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

Ghosttytimeline/basic
Loading terminal poster…
○ loading posterNo input — rendered state only
Timeline · exact mounted Rust story
01 · Purpose
What it is for
Vertical activity timeline with active markers.
Best fit: Visualization · visualization · widget
02 · Behavior
What the mounted story proves
  1. 01
    Timeline
    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
    0 covered · 9 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 timeline/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
Visualization · visualization · widget
05 · Reference
API, tokens, accessibility
API
TimelineOpen source ↗
Tokens
DesignSystemInspect exact story code for roles and capability projection.
Accessibility
Input contract mountedNo input claim in the representative story.
Contract
Evidence in progress0/23 axes covered
06 · Go deeper
Advanced guidance
Authored implementation guidance
Purpose. Present time-ordered events with status, actor, and optional
grouping. Supports live streaming while preserving reading position when the
user scrolls up.


Recipes


RecipeUse
Detailed (default)Full rows: time · actor · status · text
RailCompact side-panel markers
GroupedDayDay/session headers


Live stream


    

  • TimelineState::following defaults true (stick to newest).
    • 

  • Moving up / wheel-up pauses follow.
    • 

  • f or End re-follows; call on_append(len) after host appends.
    • 



Checkpoint mode (Timeline)


TimelineState::set_checkpoint_mode(true): Enter → RestoreRequested, c →
CompareRequested on checkpoint rows.


For full session restore/rewind UX (boundaries, preview, draft preserved), use
CheckpointTimeline (migration 0229).
Ownership boundary
TermRock owns reusable terminal rendering and interaction state. The host owns domain data, policy, persistence, authorization, and side effects.
Evidence status
0 covered, 9 partial, and 5 missing contract axes. Missing evidence is not a behavior claim.
Sparkline
One-row sparkline over normalized samples.
Token Meter
Token or cost usage meter with threshold roles.