Kanshō/Session search

Session search

The large search field anchored at the top of the launcher. A thin wrapper over SearchInput pinned to the taller size with a launcher placeholder and shortcut hint.

Included in the single kansho full pack. Components are not offered as separate installs.

Default

⌘K

Loading

while fetching results

Usage

Guidance
Do
  • Sit it at the top of a session launcher or list.
  • Wire onClear so the clear control resets the query.
Don't
  • Use it for global command search — that is the command palette.
When to use
Filtering a launcher's session list by title or id.
When not to
Cross-app search or command execution.

Accessibility

Keyboard & screen reader

Keyboard

Tab
Move focus to the field, then the clear control when a value is present.
EnterSpace
Trigger the clear control.

Announces

  • The field remains a native text input unless a consumer overrides type.
  • The clear control carries aria-label "Clear search".

Props

Extends SearchInput
PropTypeDefaultDescription
loadingbooleanfalseShow a spinner in place of the search glyph.
onClear() => voidFires when the clear control is activated.
shortcutHintstringKeyboard-hint chip rendered inside the field.
statusFieldStatusValidation tone forwarded to the field styling.
...InputHTMLAttributesinput propsAll native input props except size.

Component documentation

Session Search

components/workspace/session-search.tsx

Purpose

Applies the large Session Overview treatment to SearchInput.

Appropriate use

Use for filtering session launchers while retaining the shared search behavior.

Example

components/workspace/session-search.tsx has a representative live example in the "Loading" section on /components/session-search.

States

It inherits SearchInput states and props while fixing size to md and defaulting the shortcut hint to Command-K.

API and props

SessionSearch extends SearchInputProps except size and adds className and ref.

Dependencies

Direct imports are React, SearchInput, and cn.

Accessibility

It inherits SearchInput label, clear control, keyboard, loading announcement, and native input behavior.

Limitations

It only renders the input; the host must implement Command-K focus, filtering, debouncing, and result announcements.

Source

Source: components/workspace/session-search.tsx.

Full pack

components/workspace/session-search.tsx is documented at /components/session-search and installs only through the single Kansho full pack; no individual component install is offered.