Skip to main content
TermRock
GitHub
ComponentsInputs

Component · Inputs

Search Input

A search field with query, status, clear, history, filter chips, and host-polled debounce signals.

Kind
widget
Input
interactive
Canvas
120×40

Live preview

Loading terminal preview.

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

Ghosttysearch-input/basic
Loading terminal poster…
○ loading posterNo input — rendered state only
Search Input · exact mounted Rust story
01 · Purpose
What it is for
A search field with query, status, clear, history, filter chips, and host-polled debounce signals.
Best fit: Inputs · input · widget
02 · Behavior
What the mounted story proves
  1. 01
    SearchInput
    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
    3 covered · 8 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 search-input/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
Inputs · input · widget
05 · Reference
API, tokens, accessibility
API
SearchInputOpen source ↗
Tokens
DesignSystemInspect exact story code for roles and capability projection.
Accessibility
Input contract mountedNo input claim in the representative story.
Contract
Evidence in progress3/23 axes covered
06 · Go deeper
Advanced guidance
Authored implementation guidance
Purpose. Query chrome for tables, logs, quick-open, palettes, and
inspectors. TermRock owns typing, clear, history, metadata strip, and debounce
signals. Hosts own filtering, scoring, and async search.


Debounce (no async inside)


Duration::ZERO debounce + flush_debounce() for immediate apply.


Escape


    

  1. Non-empty → clear → Cleared
    2. 

  2. Empty → Cancelled (dismiss)
    3. 



Status projection


Host sets SearchStatus::{Idle,Searching,Results{count},NoResults,Error} after
its own search completes. Never computed by scanning domain data inside the widget.


Metadata before query


Leading icon + active SearchFilterChips paint left of the editable query
so filter context contracts first under narrow widths.
Ownership boundary
TermRock owns reusable terminal rendering and interaction state. The host owns domain data, policy, persistence, authorization, and side effects.
Evidence status
3 covered, 8 partial, and 5 missing contract axes. Missing evidence is not a behavior claim.
Range Slider
Dual-thumb filter range.
Select
A single-choice select with CollectionState navigation, value≠highlight, recipes, and popover/fullscreen.