Skip to main content

Component · Inputs

Multi Select

A searchable multi-choice selector with chip summary, select-all, max selection, and highlight≠checked.

Kind
widget
Input
interactive
Canvas
120×40

Live preview

Loading terminal preview.

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

Ghosttymulti-select/basic
Loading terminal poster…
○ loading posterNo input — rendered state only
Multi Select · exact mounted Rust story

01 · Purpose

What it is for

A searchable multi-choice selector with chip summary, select-all, max selection, and highlight≠checked.

Best fit: Inputs · input · widget

02 · Behavior

What the mounted story proves

  1. 01

    MultiSelect

    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

    4 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 multi-select/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

MultiSelectOpen source ↗

Tokens

DesignSystemInspect exact story code for roles and capability projection.

Accessibility

Input contract mountedNo input claim in the representative story.

Contract

Evidence in progress4/23 axes covered

06 · Go deeper

Advanced guidance

Authored implementation guidance

Purpose. Filters, permissions, task pickers — multi membership with a compact closed summary and an open checklist.

Check vs highlight

Meaning
selected() / is_checkedOrdered membership
highlight()Keyboard cursor in open list

Space toggles check; reverse video is highlight only.

Keys (open)

  • Space — toggle · Enter — done/close · Esc — close keep checks
  • Ctrl+A — select all visible · Ctrl+D — clear
  • Shift+↑/↓ — range check · type — search
Ownership boundary

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

Evidence status

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